← ClaudeAtlas

adr-auditlisted

Read-only lint of the whole Architecture Decision Record corpus — dangling ADR references, numbering holes and duplicates, broken supersede pairs, template-placeholder residue, invalid statuses, unparseable files, stale index. Use when the user says "audit the ADRs", "check the decision records", "ADR health check", "lint the ADR corpus", "are the ADRs consistent?", or periodically before a release. Renders the adr tool's findings with per-class remediation guidance; changes nothing.
real-case/marvin-toolkit · ★ 0 · AI & Automation · score 68
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