Development record
ADR frontmatter selectively gains three argument fields: related_principles (which standing principles the decision leans on), a confidence qualifier, and revisit_when — the rebuttal slot naming the conditions under which the decision no longer holds. The convention serves decision durability: an ADR that records only the choice invites re-litigation, while one that records its confidence and its expiry conditions tells a future session exactly when reopening is legitimate. Adopt the fields selectively per the 2026 template-comparison evidence rather than the full heavyweight argumentation set, which adds ceremony without proportionate recall value. Acceptance: new ADRs carry the three fields where they apply, and a revisit_when condition coming true is sufficient grounds to reopen without further debate.
ADR frontmatter selectively gains three argument fields: related_principles (which standing principles the decision leans on), a confidence qualifier, and revisit_when — the rebuttal slot naming the conditions under which the decision no longer holds. The convention serves decision durability: an ADR that records only the choice invites re-litigation, while one that records its confidence and its expiry conditions tells a future session exactly when reopening is legitimate. Adopt the fields selectively per the 2026 template-comparison evidence rather than the full heavyweight argumentation set, which adds ceremony without proportionate recall value. Acceptance: new ADRs carry the three fields where they apply, and a revisit_when condition coming true is sufficient grounds to reopen without further debate.
Remedy grounds (2026-09-29)
- Why: the record asks for three fields, not a heavier template; principles carry prn- handles (adr-2609021016270132), so related_principles is checkable.
- Sources (consulted 2026-09-29): Tyree and Akerman's decision template adds a related-principles field (IEEE Software 22(2), 2005, https://doi.org/10.1109/MS.2005.27); MADR 4.0.0 carries none of the three and puts compliance in an optional Confirmation section (https://adr.github.io/madr/).
- Rejected: MADR's decision-makers, consulted and informed keys, ceremony the record's evidence advises against.
Frontmatter
| id | iss-54 |
|---|---|
| type | issue |
| lifecycle | open |
| severity | minor |
.abcd/work/issues/open/iss-54-adr-argument-fields.md
open on GitHub ↗ · commit history ↗
mentions1
- adr-2609021016270132The principles family is a declared record store whose entries carry typed claims, and it is read cold by statement and never by citation