What problem does it solve? Architecture Decision Records drift out of sync as a project grows: numbers get duplicated, supersede links break, template placeholders survive into ratified records, and the index goes stale. This Skill runs a read-only, corpus-wide consistency lint so you can find and fix those problems before a release. ## Core Features & Use Cases - Corpus-wide lint: Detects malformed files, invalid statuses, duplicate numbers, dangling ADR references, broken supersede pairs, placeholder residue, numbering holes, and stale indexes via the adr MCP tool's audit action. - Severity-ranked findings with remediation: Errors and warnings are grouped by class, each paired with concrete fix guidance and pointers to follow-up commands like /marvin:adr-review and /marvin:adr-supersede. - Read-only by design: The audit changes nothing; the single exception is regenerating the index, and only after explicit user confirmation. - Use Case: Before cutting a release, ask for an ADR health check to confirm no record cites a nonexistent ADR, no two files share a number, and every superseded decision links to its successor. ## Quick Start Ask the assistant to audit the ADRs and report any consistency errors in the decision record corpus.
