Stats
Actions
Tags
From adr
This skill should be used when Claude is about to write or edit a markdown file and the content contains references to Architecture Decision Records (ADRs). Look for patterns like "ADR-0003", "ADR-3", "as decided in ADR", "per ADR", "see ADR", "according to ADR", links to NNNN-*.md files, or mentions of specific ADR titles. When detected, check whether the referenced ADRs are superseded or deprecated and present an advisory warning. Does not apply when editing ADR files themselves or when no ADR directory exists in the project.
How this skill is triggered — by the user, by Claude, or both
Slash command
/adr:adr-ref-guardThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Warn when markdown content references a superseded or deprecated ADR. Advisory only — never auto-replace.
Warn when markdown content references a superseded or deprecated ADR. Advisory only — never auto-replace.
Activate when ALL conditions are met:
.md file that is NOT an ADR file itself (not inside the ADR directory matching NNNN-*.md)Do NOT activate when:
NNNN-*.md inside the ADR directory).md filesScan the content being written/edited for:
ADR-NNNN or ADR NNNN (any digit count)[...](path/to/NNNN-*.md){docs/decisions,docs/adr,adr,decisions}/[0-9][0-9][0-9][0-9]-*.mdNNNN-*.md in the ADR directorystatus fieldstatus starts with superseded by: warn with the replacement ADRstatus is deprecated: warn about relevancestatus is proposed or accepted: no warning neededPresent warnings after the write/edit operation completes. Include the file being edited:
ADR Reference Warning (in docs/setup.md):
- ADR-0003 (Use PostgreSQL) is superseded by ADR-0007 (Use SQLite).
Consider updating the reference to ADR-0007.
- ADR-0005 (Legacy Auth) is deprecated.
Verify this reference is still relevant.
npx claudepluginhub musingfox/cc-plugins --plugin adrValidates ADR files in docs/adrs/ for reference integrity, supersedes/extends/related links, circular chains, self-references, and domain conflicts. Report-only or interactive fixes.
Reviews architecture decision records for quality and completeness, enforcing append-only immutability. Accepts, rejects, or suggests revisions. Use when a proposed ADR is ready for review or an accepted ADR needs deprecation.
Authors, indexes, and lints Architecture Decision Records (ADRs) to preserve the rationale behind system decisions. Scaffolds new ADRs, enforces format, manages supersession, and maintains an index.