adr-status

Report the health of Architecture Decision Records — aged, unchallenged, supersession candidates, unresolved CONFIRM-NN. Read-only.

What it does

A read-only health scan of every recorded ADR under .codearbiter/decisions/. For each one it reports number, title, status, and date, then flags what needs attention: aged decisions, proposed ADRs that were never challenged, supersession candidates where a newer ADR or code pattern contradicts an older one, and any unresolved [CONFIRM-NN] placeholder left inside an ADR body. Nothing is modified, and no [CONFIRM-NN] found during the scan is resolved here — it’s surfaced and left for you.

Usage

/ca:adr-status [--adr N]

With no argument it scans every ADR; --adr N narrows the scan to a single ADR.

Example

> /ca:adr-status

## ADR Status — 2026-07-02

### Active
- ADR-0005 — Split the persona register — accepted (2026-06-18)
- ADR-0006 — Decline a commercial vertical — accepted (2026-06-20)
- ADR-0007 — Use PostgreSQL as the primary database — proposed (2026-07-01)

### Superseded
- ADR-0003 — Original watch-strangers onboarding — superseded by ADR-0006

### Unresolved CONFIRM-NN
- ADR-0007 — [CONFIRM-08]: connection-pool sizing not yet decided

When to reach for it

A quick health check across all ADRs. To record a new decision, use /ca:adr; to challenge or reconcile a specific ADR in depth, use /ca:reconcile.

Source

Source — plugins/ca/commands/adr-status.md (v2.9.1)

---
description: Report the health of Architecture Decision Records — aged, unchallenged, supersession candidates, unresolved CONFIRM-NN. Read-only.
argument-hint: (none) | --adr N
---

# /ca:adr-status — ADR health scan

Survey the health of recorded ADRs. Read-only — no file is modified. With `--adr N` the scan focuses
on a single ADR; with no argument it scans every ADR under
`${CLAUDE_PROJECT_DIR}/.codearbiter/decisions/`.

## Routes to

The `decision-lifecycle` skill (`${CLAUDE_PLUGIN_ROOT}/skills/decision-lifecycle/SKILL.md`) in its
health-scan mode. For each ADR it flags: aged decisions, `proposed` ADRs never challenged,
supersession candidates (a newer ADR or code pattern contradicts the decision), and unresolved
`[CONFIRM-NN]` placeholders. Findings aggregate into a structured report; nothing is changed.

## When NOT to use

- Author a new ADR → `/ca:adr`.
- Challenge or reconcile a specific ADR in depth → `/ca:reconcile`.
- Ask what a specific ADR says → `/ca:btw`.

## Hard gate

Read-only — MUST NOT modify any file. MUST NOT resolve a `[CONFIRM-NN]` found during the scan —
surface it and stop. A supersession candidate that contradicts an accepted ADR is flagged for
`/ca:conflict`.

View in repo