adr-status command

Command

Inspect ADR health read-only; optionally select one ADR with --adr N.

Invoke it

Claude Code/ca:adr-status

Codex$ca-adr-status

Pi/ca-adr-status

Availability is read from each shipped host catalog. Preview-only commands are marked on the page.

What it does

A read-only health scan of every recorded ADR under .codearbiter/decisions/. For each one it reports full filename stem, title, stored governance status, derived delivery state, 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 only when the number resolves to exactly one full filename stem. No match or multiple matches is reported, never guessed. The small entry selects the shared owner’s read-only mode before any authoring prerequisites. A missing directory is reported without creating it.

Example

Illustrative report, not a captured run:
> /ca:adr-status

## ADR Status — 2026-07-02

### Active
- ADR-0005-split-the-persona-register — Split the persona register — governance: accepted; delivery: Accepted/Planned (2026-06-18)
- ADR-0006-decline-a-commercial-vertical — Decline a commercial vertical — governance: accepted; delivery: Accepted/Planned (2026-06-20)
- ADR-0007-use-postgresql — Use PostgreSQL as the primary database — governance: proposed; delivery: no accepted binding (2026-07-01)

### Superseded
- ADR-0003-original-onboarding — Original onboarding — superseded by ADR-0006-decline-a-commercial-vertical

### Ambiguous supersession
None

### Unresolved CONFIRM-NN
- ADR-0007-use-postgresql — [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.

Route context

Find this entry in the workflow atlas. Compare its related teaching maps, host spelling and context inputs. The exact procedure below remains the owner.

Source

Source — plugins/ca/commands/adr-status.md (v3.7.0)

---
description: "Inspect ADR health read-only; optionally select one ADR with --adr N."
argument-hint: "(none) | --adr N"
disable-model-invocation: true
---

# /ca:adr-status — read-only mode adapter

Load `${CLAUDE_PLUGIN_ROOT}/skills/decision-lifecycle/SKILL.md` in **status only** mode,
passing the unchanged arguments. The owner validates `(none) | --adr N` before
any authoring prerequisite. Return its report; do not invoke `/ca:adr` or
continue to authoring. Read-only — MUST NOT modify any file.

View in repo