Development record
2026-09-15 — A commit message or pull-request title or body that names an iss-N declares its relation to it, and a bare mention is refused in CI before the merge (product thinker, ruling on iss-2609100507421759, first asking whether a formal resolution trailer can be enforced and then choosing "enforce it, and also hint on the default branch"). `Resolves: iss-N` says the change fixes it and RS001 then requires the record to move in the same diff; `Refs: iss-N` says touched but not fixed and demands nothing of the ledger; the vocabulary is closed at those two words, a comma-separated list of ids is admitted on either, and a near-miss (`Ref:`, `See:`, `Related:`) reads as what it is. RS004 covers `iss-N` only, the family the trailer vocabulary owns; an id inside a record body is `prose_citation_resolves`'s question. The hint is `abcd capture mentions`, a read-only listing over the default branch of open records whose ids appear in commit history without a resolution, ranked resolves over tree over record, silent on the commit that added the record's own file; it lists and never moves a record. Rejected: any mention of the record's id as proof of a fix (a mention proves the author's attention, not a fix); a detector with no enforcement (a silent fix cannot be seen at all, so the gate has to force the mention into a declaration).
2026-09-15 — A commit message or pull-request title or body that names an iss-N declares its relation to it, and a bare mention is refused in CI before the merge (product thinker, ruling on iss-2609100507421759, first asking whether a formal resolution trailer can be enforced and then choosing "enforce it, and also hint on the default branch"). Resolves: iss-N says the change fixes it and RS001 then requires the record to move in the same diff; Refs: iss-N says touched but not fixed and demands nothing of the ledger; the vocabulary is closed at those two words, a comma-separated list of ids is admitted on either, and a near-miss (Ref:, See:, Related:) reads as what it is. RS004 covers iss-N only, the family the trailer vocabulary owns; an id inside a record body is prose_citation_resolves's question. The hint is abcd capture mentions, a read-only listing over the default branch of open records whose ids appear in commit history without a resolution, ranked resolves over tree over record, silent on the commit that added the record's own file; it lists and never moves a record. Rejected: any mention of the record's id as proof of a fix (a mention proves the author's attention, not a fix); a detector with no enforcement (a silent fix cannot be seen at all, so the gate has to force the mention into a declaration).
Frontmatter
| id | dcn-2609150000000006 |
|---|---|
| type | decision |
| date | 2026-09-15 |
.abcd/work/decisions/dcn-2609150000000006-a-commit-message-or-pull-request-title.md
open on GitHub ↗ · commit history ↗
mentions1
- iss-2609100507421759Nothing tells you an open issue is already fixed. The ledger goes stale silently, and the cost of finding out lands on whoever plans the next piece of work.