Pull Request Description
A PR body a reviewer can act on: a summary that names the non-obvious decisions, what changed by area, a checkable test plan, and anything the reviewer should know before merging.
id template/pull-requestv1.0.0placeholders 4
Skeleton
## Summary
{{summary}}
## Changes
{{changes}}
## Test plan
{{test_plan}}
{{reviewer_notes}}
Rendered example
## Summary
- Adds `template-v1`, a document skeleton with typed placeholders and one rendered example.
- Migrates `prompt/handoff-md` and `prompt/plan-with-alternatives`, which described these shapes in prose.
- Chose a ninth class over a prompt subtype because rendering is a distinct runtime action (ADR 0004).
## Changes
- schemas: `template-v1.json`; examples for every class under `schemas/examples/`
- atoms: 8 templates; 2 prompts removed
- web: listing and detail pages for templates
## Test plan
- [x] `python3 scripts/build-exports.py` — no dangling references
- [x] `python3 -m pytest` — all passing
- [ ] After deploy: `/atoms/template/adr.json` serves JSON
## Read this first
Two prompt ids are removed; nothing in the catalog referenced them.
Placeholders
| Name | Required | What goes here | Example |
|---|---|---|---|
{{summary}} | yes | Two to five bullets: what this does and the decisions that were not obvious, with why. | - Adds template-v1… |
{{changes}} | yes | What changed, grouped by area, with counts where they help. | - schemas: template-v1.json - atoms: 8 templates |
{{test_plan}} | yes | Checkbox list of what was run and what remains to verify after merge, with the commands. | - [x] python3 -m pytest — 165 passed |
{{reviewer_notes}} | no | Optional section: deviations from a spec, risks, follow-ups, or a 'Read this first' warning. | ## Read this first Two prompt ids are removed. |
Rules for the finished document
- Explain non-obvious decisions: why this library, why this pattern, why this trade-off.
- The test plan lists commands, not intentions.
- Merge with a merge commit or rebase; never squash on non-release branches.
Produced by
- skill/pr — Pull Request
pull-requestreviewgit
Author convergent-systems-key. Source ai-atoms. License CC-BY-4.0. Rules from the AI Constitution's commit and PR discipline (§4.4.4, §4.10.2).