claudegoodies
Skill

adr-index

From ruvnet

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)

Facts

Repository
ruvnet/ruflo
Status
Actively maintained
Last commit
Declared tools
Bash mcp__claude-flow__memory_list mcp__claude-flow__memory_
Source file
plugins/ruflo-adr/skills/adr-index/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# 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 integrity** (optional but recommended) via the sibling `adr-verify` skill, which runs `scripts/verify.mjs` and exits 1 on cycles.

4. **Search semantically** via `mcp__clau
View full source on GitHub →

Other skills