AGENTS.md · git:20260821.7b8e05d · 2026-08-21 · sha256 89eac1fd41df5c32
AGENTS.md git:20260821.7b8e05dA
Immutable. This exact content never changes and is served at /api/v1/blob/89eac1fd41df5c32.
# Working in this repository ## Pull request descriptions — functional, not technical For the reviewer, and for whoever reads this pull request a year from now looking for when a behaviour changed. Anyone who wants *how* reads the diff. The description is about what changes for the person using this software, and why it was worth doing. Required shape: ```md ## Summary ## What you can now do ## Risk ``` | Keep | Drop | |---|---| | One line on what is different for the user | File paths, function names, constants, schema keys — grep finds these | | What someone can now see, do, or configure | Why this implementation rather than another — that is the commit message or an inline comment | | What is still wrong, and who it bites | A commit-by-commit account — git already has it | | What a person would change to get further | How the change was reviewed or verified — round counts, lens findings, test counts | `## Risk` says "nothing known" when there is nothing, rather than being dropped. The test: would someone who has never opened this codebase understand what changed? If not, it belongs in the commit message, an inline comment, or a spec. **This applies to every pull request against this repository**, whether it came out of `/tagteam:ship` or was written by hand. `commands/ship.md` step 8 says the same thing to the orchestrator, which is what makes it happen inside the train; this file is what makes it happen outside one.