adr-index
Build or rebuild the ADR index + dependency graph by running scripts/import.mjs (handles v3-style and plugin-style ADR formats; one Bash call vs hundreds of MCP round-trips)
Profile →npx skills add ruvnet/ruflo --skill adr-index --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# ADR Index Persists every ADR under `*/docs/adr/` or `*/docs/adrs/` to the `adr-patterns` namespace and every relationship (supersedes / amends / related / depends-on) to `adr-edges`. Handles both ADR formats found in the Ruflo monorepo: - **v3-style**: `# ADR-097: Title` heading + `**Status**: Proposed` line - **plugin-style**: YAML frontmatter (`id: ADR-NNNN`, `status: Proposed`) Implementation is in `scripts/import.mjs` (one Bash call) rather than dozens of per-ADR MCP tool calls — same effective behavior, materially faster, dual-format-aware, and false-positive-resistant for issue numbers. ## When to use - After importing ADRs from another project - When the AgentDB graph is out of sync with the on-disk ADR files - Bootstrapping ADR tracking on an existing codebase ## Steps 1. **Run the importer**: ```bash node plugins/ruflo-adr/scripts/import.mjs ``` Optional env: - `IMPORT_FORMAT=json` — emit JSON instead of markdown - `IMPORT_DRY_RUN=1` — parse + summarize, skip persistence - `ADR_ROOT=/path` — scan a different root (default: cwd) 2. **Inspect the summary** — total ADRs, stored count, by-status breakdown, edge counts, dangling refs, status mismatches. 3. **Verify graph inte
- When to use
- Steps
- Storage shape
- False-positive guard
- What this skill cannot do
- Cross-references
node plugins/ruflo-adr/scripts/import.mjs
What does the adr-index skill do?
Build or rebuild the ADR index + dependency graph by running scripts/import.mjs (handles v3-style and plugin-style ADR formats; one Bash call vs hundreds of MCP round-trips)
How do I install it?
Run `npx skills add ruvnet/ruflo --skill adr-index --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ruvnet/ruflo, a repository with 67,015 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.