ADR Kit Supersede
Overview
Mark an accepted decision as superseded. The CLI rewrites its front matter
to status: superseded with superseded-by: N, stamps the supersede date
on the date field, and leaves the record in adr/decisions/ as frozen
history.
Steps
- Record the replacement first (
adrkit decideoradrkit propose+adrkit accept), and make sure it validates. - Run:
adrkit supersede "<old name or number>" --by "<new name or number>"
Rules
--bymust reference an existing accepted decision that is not itself superseded; the command refuses dangling chains.- Re-run
adrkit listright before superseding to confirm the--bytarget still exists and is not itself superseded, even if you checked earlier in this conversation. - Never hand-edit a superseded record afterwards; it is history.
- Mention what it supersedes in the new decision's
## Problemsection so the causal link survives in prose.