AGENTS.md@.changes · git:20261003.6c7a911 · 2026-10-03 · sha256 2db4ebb58079f250
AGENTS.md@.changes git:20261003.6c7a911A
Immutable. This exact content never changes and is served at /api/v1/blob/2db4ebb58079f250.
# Changelog fragment bodies A fragment body is one line. `changeFormat` prefixes `- ` once, so a multi-line body falls out of the list. The body writes for a user scanning the changelog for whether the upgrade affects them. - Open with an imperative verb: "Skip ...", not "Directory expansion skips ..." - Lead with the user-visible effect, not the mechanism. - Use code spans for what the user runs or names. - No implementation jargon, no internal file names. - End with a period. - A Fix names the symptom and its condition, then the corrected behavior. - An Add names the capability and its access point. - A Change names the new behavior and its escape hatch. - Ground every claim in the diff and its tests.