ADR Verify

Features

• Detects dangling references in ADR graphs
• Identifies supersede cycles
• Surfaces status mismatches in ADRs
• Provides clear exit codes for success and failure
• Supports strict mode for CI integration

Use Cases

• Verify ADR graph health immediately after running `adr-index`
• Integrate into CI pipelines as a quality gate
• Confirm graph integrity before publishing ADR-related releases

Non-Goals

• Populating the ADR graph (handled by `adr-index`)
• Modifying ADR data
• Resolving detected issues automatically

Workflow

1. Execute the verification script
2. Check for dangling references
3. Check for supersede cycles
4. Check for status mismatches
5. Report findings via exit code and optional output

Practices

• Documentation integrity
• Code quality
• CI/CD integration

Prerequisites

• Node.js runtime
• The `adr-index` skill or equivalent data generation