ca-adr-status
Report the health of Architecture Decision Records — aged, unchallenged, supersession candidates, unresolved CONFIRM-NN. Read-only.
Install
npx skills add https://github.com/arbiterForge/codeArbiter/tree/main/plugins/ca-codex/skills/ca-adr-status
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install arbiterforge-codearbiter@llmmart
git clone https://github.com/arbiterForge/codeArbiter.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole arbiterforge/codearbiter collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
$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
<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.
Files (codearbiter)
-
SKILL.md 1.2 KB
--- name: ca-adr-status 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 `<project-root>/.codearbiter/decisions/`. ## Routes to The `decision-lifecycle` skill ([routines/decision-lifecycle/SKILL.md](../../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`.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.