← ClaudeAtlas

blueprint-adr-validatelisted

Validate ADR relationships and domain consistency. Use when auditing ADRs before release, finding broken supersedes/extends links, or detecting cycles.
laurigates/claude-plugins · ★ 37 · AI & Automation · score 80
Install: claude install-skill laurigates/claude-plugins
# /blueprint:adr-validate Validate Architecture Decision Records for relationship consistency, reference integrity, and domain conflicts. **Usage**: `/blueprint:adr-validate [--report-only]` ## When to Use This Skill | Use this skill when... | Use alternative when... | |------------------------|-------------------------| | Maintaining ADR integrity before releases | Creating new ADRs (use `/blueprint:derive-plans`) | | Auditing after refactoring or changes | Quick one-time documentation review | | Regular documentation review process | General ADR reading | ## Context - ADR directory exists: !`find docs -maxdepth 1 -name 'adrs' -type d` - ADR count: !`find docs/adrs -name "*.md" -type f` - Domain-tagged ADRs: !`grep -l "^domain:" docs/adrs/*.md` - Flag: !`echo "${1:---}"` ## Parameters Parse `$ARGUMENTS`: - `--report-only`: Output validation report without prompting for fixes - Default: Interactive mode with remediation options ## Execution Execute complete ADR validation and remediation workflow: ### Step 1: Discover all ADRs 1. Check for ADR directory at `docs/adrs/` 2. If missing → Error: "No ADRs found in docs/adrs/" 3. Parse all ADR files: `ls docs/adrs/*.md` 4. Extract frontmatter for each ADR: number, date, status, domain, supersedes, superseded_by, extends, related ### Step 2: Validate reference integrity For each ADR, validate: 1. **supersedes references**: Verify target exists, target status = "Superseded", target has reciprocal superseded_by 2. **