| name | retire |
| description | Rank Accepted ADRs for retirement. Use for stale decisions, removed technology, supersession signals, or ADR cleanup. Read-only. |
| argument-hint | [ADR directory; defaults to docs/adr/] |
| disable-model-invocation | true |
| allowed-tools | ["Read","Bash"] |
adr-kit retire
Use $ARGUMENTS as the ADR directory; default to docs/adr/ when it is empty.
You are running /adr-kit:retire. This is a read-only audit of Accepted ADRs
that may no longer describe the project accurately.
Procedure
-
Resolve the ADR target from the optional argument; default to docs/adr/.
-
Run the bundled deterministic scanner from the project root:
python <adr-kit-plugin-path>/bin/adr-retire <target> \
--repo-root . --threshold 0.4 --format markdown
-
Present every returned candidate with its four signal scores:
staleness_90day, tech_removal, broken_supersession, and
policy_mismatch.
-
For any REVIEW or RETIRE result, ask the user whether the decision is
actually obsolete, then offer /adr-kit:grill --revalidate ADR-NNN.
Revalidate changed forces, remaining implementation, new evidence, and
human intent before choosing unchanged, successor, reject-candidate, or
defer. Keep this audit read-only until the user confirms a separate
lifecycle command.
Boundaries
- Do not modify ADR statuses or status histories during this audit.
- Treat
MONITOR as an observation, not as proof that an ADR is obsolete.
- A retirement recommendation is evidence for review, not permission to
remove an Accepted decision silently.
