Adr Verify
Reads your imported ADR graph from memory and flags three types of integrity problems: dangling references to ADRs that don't exist, supersede cycles where two ADRs point at each other, and status mismatches where an ADR supersedes another but isn't marked as superseded itself. Pairs with adr-index, which does the initial import. Run it after indexing or wire it into CI with VERIFY_STRICT=1 to fail builds on any issue. It only exits non-zero for cycles by default, which makes sense since those are always corruption, while dangling refs might just mean the target ADR lives in another repo. The distinction between validation modes is thoughtful and the exit code table is clear.
- skills.sh installs
- 688
- GitHub stars
- 81.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add ruvnet/ruflo --skill adr-verify --agent claude-codeInstalls into .claude/skills of the current project.
Files
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-BandADR-B supersedes ADR-A(or longer cycles). Always data corruption. - Status mismatches — an ADR is the source of a
supersedesedge but its own status isn'tSuperseded. 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-indexto confirm the graph is healthy - In CI as a fail-closed gate (
VERIFY_STRICT=1exits 1 on any issue) - Before publishing an ADR-related release
Steps
node plugins/ruflo-adr/scripts/verify.mjs
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/ruvnet/ruflo
- First seen
- Jun 3, 2026
More from ruvnet/ruflo
All 236- Cost Track685
- Cost Booster Route684
- Cost Federation684
- Cost Summary684
- Intelligence Transfer684
- Vector Setup684
- Cost Trend683
- Cost Conversation682
- Cost Export681
- Cost Benchmark679
- Cost Booster Edit679
- Browser674
- Witness656
- AgentDB Advanced Features
- AgentDB Learning Plugins
- AgentDB Memory Patterns
- AgentDB Performance Optimization
- AgentDB Vector Search
- Hooks Automation
- Pair Programming
- ReasoningBank Intelligence
- ReasoningBank With AgentDB
- Skill Builder
- V3 CLI Modernization
Recommended
cavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
improveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
karpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
find-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs