| name | pr-description |
| description | The PR title and body template, and the rules for any comment drafted for a reporter or contributor. Load when writing a PR body, a release PR, or a triage response. |
PR description and comment drafts
Authority: CLAUDE.md "Output Rules" and "Sentence shapes that read as
machine-written"; "Issue + release policy" 1, 2, 3a, 3b; the spokesperson
agent for anything outward-bound.
PR title
<type>: <what changed, one line> with (#N) when it closes an issue;
release: vX.Y.Z - <thesis> for a release PR.
PR body, in this order, headings as written
- What was wrong (or missing): two to four sentences, the reporter
credited by login.
- Why: the mechanism, and whether it is a regression of a Standing
lesson or an ARCHAEOLOGY row (name it).
- What is now impossible (or possible): the property, not the
instance; the other spellings checked.
- Evidence: paste verbatim, never retype:
bench_table.md,
surface.md, surface_descriptions.md, the review verdict line.
- Definition of Done:
checklist.md verbatim.
Closes #N when applicable.
No number appears in 1-3 that is not in 4 or 5.
Comment drafts (triage, close comments)
- One issue, one verdict; propose the split, do not merge findings.
- A timebox states the deadline AND the default in the same sentence,
never longer than 24 hours, and never advertises an extension clause.
- Name the version the fix ships in; 43% of closes did not.
- Never answer a concrete pain with aggregate statistics.
- The draft goes through
spokesperson; posting is the next layer's.
