ADR Verify

功能

• 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

使用场景

• 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

非目标

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

工作流

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

实践

• Documentation integrity
• Code quality
• CI/CD integration

先决条件

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