blueprint-adr-validate
SolidValidate ADR relationships, domain consistency, and duplicate ADR numbers. Use when auditing ADRs before release, finding broken supersedes/extends links, cycles, or number collisions.
AI & Automation 48 stars
6 forks Updated today MIT
Install
Quality Score: 80/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# /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 . -path '*/docs/adrs' -maxdepth 2 -type d`
- ADR count: !`find . -path '*/docs/adrs/*' -name "*.md" -type f`
- Domain-tagged ADRs: !`find . -path '*/docs/adrs/*' -maxdepth 3 -name '*.md' -exec grep -l "^domain:" {} +`
- 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, tar...
Details
- Author
- laurigates
- Repository
- laurigates/claude-plugins
- Created
- 7 months ago
- Last Updated
- today
- Language
- Shell
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
Data & Documents Solid
blueprint-adr-list
List ADRs as a markdown table with title, status, date, domain. Use when generating an ADR index, auditing ADR status, or reviewing all architecture decisions.
48 Updated today
laurigates AI & Automation Solid
adr-relationships
Domain analysis, conflict detection, and relationship validation for Architecture Decision Records. Use when creating or validating ADRs to ensure consistency.
48 Updated today
laurigates Data & Documents Solid
blueprint-docs-list
List blueprint documents (ADRs, PRDs, PRPs) with frontmatter metadata. Use when listing docs, auditing statuses, or generating an index for project documentation.
48 Updated today
laurigates