Verify ADR Graph Integrity Issues

v20260707

adr-verify

This tool verifies the consistency and integrity of the Architecture Decision Records (ADR) graph, which is populated by `adr-index`. It checks for common data corruption issues such as dangling references (broken links), supersedure cycles (circular dependencies), and status mismatches. It is ideal for post-import validation and use as a strict CI/CD gate.

ADR Graph Validation CI/CD

Get Skill

450 downloads

Overview

ADR Verify

Companion to adr-index. After import, reads the persisted graph and surfaces integrity issues:

Dangling refs — edge points at an ADR ID that doesn't exist in adr-patterns. Common cause: the referenced ADR is in a sibling repo or got deleted.
Supersede cycles — ADR-A supersedes ADR-B and ADR-B supersedes ADR-A (or longer cycles). Always data corruption.
Status mismatches — an ADR is the source of a supersedes edge but its own status isn't Superseded. Usually a missed status update during a successor ADR's promotion.

When to use

Right after adr-index to confirm the graph is healthy
In CI as a fail-closed gate (VERIFY_STRICT=1 exits 1 on any issue)
Before publishing an ADR-related release

Steps

node plugins/ruflo-adr/scripts/verify.mjs

Optional env:

VERIFY_FORMAT=json — JSON instead of markdown
VERIFY_STRICT=1 — exit 1 on ANY issue (default: only on cycles)

Exit codes

Code	Meaning
`0`	Graph healthy (or dangling refs / status mismatches present in non-strict mode)
`1`	Supersede cycle detected, OR strict mode + any issue present

Cross-references

adr-index — populates the data this skill verifies
scripts/import.mjs — has its own dry-run validation; this skill is the read-back companion

Info

Category Development

Name adr-verify

Version v20260707

Size 1.57KB

Source ruvnet/ruflo

Updated At 2026-07-09