ruvnet/ruflo687 installs

adr-verify

Q: How do I install this agent skill?

Run npx skills add https://github.com/ruvnet/ruflo --skill adr-verify.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Read back adr-patterns + adr-edges namespaces, surface dangling refs / supersede cycles / status mismatches; exit 1 on cycles

How do I install this agent skill?

npx skills add https://github.com/ruvnet/ruflo --skill adr-verify

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill is a diagnostic utility for verifying the integrity of Architectural Decision Record (ADR) graphs. It checks for dangling references, supersede cycles, and status mismatches by executing a local Node.js script. No malicious behavior or security vulnerabilities were detected.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

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

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
adr-reindex — reconciles a deleted ADR that adr-verify cannot detect

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/ruvnet/ruflo/adr-verify">View adr-verify on skillZs</a>