// Audits Accepted Architecture Decision Records for possible retirement using deterministic staleness, technology-removal, supersession, and enforcement-policy signals. Produces ranked candidates for human review; never edits ADRs.
ADR-set health sweep for adr-kit. Runs the due health tier(s) — cheap (drift + stale + lint) and/or LLM (suggest + audit) — applies mix-by-finding-type responses, and stamps the state file when done. Invoke after seeing an [adr-guardian] ... DUE block at session start, or on demand to run a full health sweep. Accepts optional arg: cheap | llm | all. LLM tier always asks before spending.
One-shot project bootstrap for adr-kit. Hooks the kit into CLAUDE.md (via a slim stub + a copy of templates/adr-kit-guide.md → .claude/adr-kit-guide.md), runs bin/adr-audit to enumerate decision-shaped artefacts in source + documentation, walks the user through batch approval to generate Accepted ADRs via the adr-generator subagent, installs the pre-commit hook, and finally lints. Idempotent across re-runs. User-invocable only — this is a side-effecting operation.
Install or uninstall the adr-kit pre-commit hook in the current project. Copies templates/githooks/pre-commit into .githooks/pre-commit, makes it executable, and runs `git config core.hooksPath .githooks`. Idempotent. Used internally by /adr-kit:init and /adr-kit:upgrade; also exposed standalone for users who want to add or remove the hook independently.
Interactive judge of a staged git diff against the project's Accepted ADRs. Runs bin/adr-judge with the LLM pass (Claude Sonnet by default, since v0.13.0) — same engine the pre-commit hook uses, so verdicts are consistent. On violation, walks the user through three resolution paths (write a new ADR, supersede an existing ADR, fix the code). Pairs with the pre-commit hook — invoke before committing on important changes, or after the hook blocks you to drive the resolution.
Architecture Decision Record (ADR) management skill. Creates, maintains, and enforces architectural decisions with anti-rationalization guards and named verification gates. Drop into any project to give an AI coding agent a shared, enforceable ADR workflow.
Lints existing Architecture Decision Records against four verification gates plus the deterministic status-history audit. Run on a single ADR file or on the whole docs/adr/ tree. Reports pass/fail per gate per file with file:line citations for failures. Read-only.
| name | retire |
| description | Audits Accepted Architecture Decision Records for possible retirement using deterministic staleness, technology-removal, supersession, and enforcement-policy signals. Produces ranked candidates for human review; never edits ADRs. |
| argument-hint | [ADR directory; defaults to docs/adr/] |
| disable-model-invocation | true |
| allowed-tools | ["Read","Bash"] |
You are running /adr-kit:retire. This is a read-only audit of Accepted ADRs
that may no longer describe the project accurately.
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 before proposing a superseding ADR.
MONITOR as an observation, not as proof that an ADR is obsolete.