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.

What this skill cannot catch: an adr-patterns row for an ADR that was deleted from disk and has zero edges referencing it or from it — invisible to every check above (issue #2666). If the reported ADR count looks higher than what's actually on disk, run adr-reindex, not adr-verify again.

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