adr-auditlisted
Install: claude install-skill real-case/marvin-toolkit
# ADR Audit
Corpus-wide consistency lint for the project's decision records. The checks are deterministic
and live in the **`adr` MCP tool** (ADR-0027); this skill runs them, renders the findings with
remediation guidance, and **changes nothing** — every fix is the user's move.
## Input
`$ARGUMENTS` — optional focus (e.g. a lint class like "supersede pairs", or "errors only").
The audit always runs corpus-wide; a focus narrows what you expand on.
## Workflow
### 1. Run the audit
Call the `adr` MCP tool with `{"action": "audit"}`. It checks every record in the corpus
(location resolved config → detection → default) and returns typed findings with severities:
**errors** fail the audit, **warnings** inform.
### 2. Render findings with remediation
Present the tool's report, then add a remediation note per finding class that actually
occurred — grouped, errors first:
| Class | Severity | What it means | Remediation |
|-------|----------|---------------|-------------|
| `malformed` | error | File matches `NNNN-*.md` but has no parseable title or status header | Add a `# title` heading and a status in either supported style (`\| Status \| … \|` table row or `## Status` section) |
| `invalid-status` | error | Status text is outside `proposed \| accepted \| deprecated \| superseded \| rejected` | Map it onto the closed vocabulary — e.g. "draft" → `proposed`, "done" → `accepted` |
| `duplicate-number` | error | Two files claim the same `NNNN` | Renumber the newer file to a fre