$ca-adr-status — ADR health scan

SkillDev tools

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

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the $ca-adr-status — ADR health scan skill

What this skill tells your AI

The instructions your AI receives, as published by arbiterforge/codearbiter in plugins/ca-pi/skills/ca-adr-status/SKILL.md and read by ahel’s review.

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 <project-root>/.codearbiter/decisions/.

Routes to

The decision-lifecycle skill (routines/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.

Signals

GitHub stars
144
Forks
7
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ca-adr-status
Source
github.com/arbiterforge/codearbiter