skills.rest
ruvnet
ruvnetCOMMUNITY
Explore all skills by this author →
Website𝕏@ruvGitHub

adr-verify

Validates ADR graph integrity by detecting dangling references, supersede cycles, and status mismatches.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#ADR#integrity check#Documentation#graph validation#CI gate#Architecture Decision Records#supersede cycle
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill adr-verify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-verify
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-adr/skills/adr-verify
Command: npx skills add https://github.com/ruvnet/claude-flow --skill adr-verify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After importing Architecture Decision Records into a memory-backed graph, data corruption such as broken references, circular supersede chains, and inconsistent statuses can silently accumulate. This Skill reads back the persisted adr-patterns and adr-edges namespaces and surfaces these integrity issues before they propagate.

Core Features & Use Cases

  • Dangling Reference Detection: Finds edges pointing at ADR IDs that no longer exist in the adr-patterns namespace.
  • Supersede Cycle Detection: Identifies circular supersedes relationships (e.g., ADR-A supersedes ADR-B and vice versa) and exits with code 1.
  • Status Mismatch Reporting: Flags ADRs that are the source of a supersedes edge but whose own status is not marked Superseded.
  • Use Case: Run it in CI with VERIFY_STRICT=1 as a fail-closed gate after adr-index to guarantee the ADR graph is healthy before publishing a release.

Quick Start

Ask the assistant to verify the ADR graph integrity by running the adr-verify check and report any dangling references, cycles, or status mismatches.

Frequently Asked Questions about adr-verify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify ADR graph integrity after importing decision records?▼

Run the verify script with node plugins/ruflo-adr/scripts/verify.mjs after adr-index completes. It reads the adr-patterns and adr-edges namespaces and reports dangling references, supersede cycles, and status mismatches.

How to fail a CI pipeline on ADR data corruption?▼

Set VERIFY_STRICT=1 when running the verify script so it exits with code 1 on any detected issue, not just supersede cycles. This makes it usable as a fail-closed gate in continuous integration.

What is the difference between adr-verify and adr-reindex?▼

adr-verify checks graph integrity of persisted data, while adr-reindex reconciles ADRs deleted from disk that have no edges referencing them. adr-verify cannot detect such orphaned rows, so use adr-reindex when counts look wrong.

Can adr-verify output results as JSON?▼

Yes, set VERIFY_FORMAT=json before running the script to receive JSON output instead of the default markdown report. This is useful for programmatic consumption in automation pipelines.

What are the limitations of ADR graph verification?▼

The check cannot detect an adr-patterns row for an ADR deleted from disk when that row has zero edges to or from it, since no check traverses it. It also only validates the persisted graph, not the source markdown files.

Related Skills

Explore More Software Engineering Skills→
AI-Foundry-CoreAI-Foundry-Core
4

architecture-decision-records

Capture and standardize architectural decisions using Architecture Decision Records (ADRs).

Official
Advanced
aaaa47080aaaa47080
4

verification-before-completion

Run a five-step verification sequence before reporting completion claims.

Community
Advanced
chaimtchaimt

architect-analyze

Detect drift and quality gaps between ADRs and Architecture Description.

Community
Advanced
NikitaDmitrieffNikitaDmitrieff
39

websh

Navigate URLs as a filesystem to query and extract cached web content.

Community
Advanced