adr-reindex
Reconcile the ADR index against a DELETED ADR file or relation line by dropping and rebuilding adr-patterns + adr-edges from scratch (scripts/reindex.mjs). Use when adr-index alone leaves stale rows behind.
Profile →npx skills add ruvnet/ruflo --skill adr-reindex --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 Reindex `adr-index` only ever **adds** or upserts rows — it has no way to remove one. Delete an ADR file (or a single relation line from a surviving file) and the row `adr-index` wrote for it survives every future `adr-index` run, forever, with no dangling-ref or cycle ever pointing at it. `adr-verify` then certifies the resulting graph as healthy, because an orphan row with zero edges in or out is invisible to both its checks. See issue #2666. This is a different failure mode from staleness (an ADR that changed but whose stored record didn't) — that's convergence, `adr-index`'s job. This is **reaping** — the source of truth (the ADR file) is gone, so the derived cache row for it must be gone too. The only reliable way to reap is to drop both namespaces and rebuild from what's actually on disk right now. ## When to use - After deleting an ADR file (or removing a relation line from one) - Periodically, as a scheduled reconcile (`adr-verify` can't catch what `adr-reindex` catches — see below) - If `adr-verify`'s ADR count looks higher than `find docs/adr -name '*.md' | wc -l` ## Steps ```bash node plugins/ruflo-adr/scripts/reindex.mjs ``` Optional env: - `REINDEX_FORMAT=json` —
- When to use
- Steps
- What it does
- Why not adr-index + memory delete
- Caveats
- Cross-references
node plugins/ruflo-adr/scripts/reindex.mjs
What does the adr-reindex skill do?
Reconcile the ADR index against a DELETED ADR file or relation line by dropping and rebuilding adr-patterns + adr-edges from scratch (scripts/reindex.mjs). Use when adr-index alone leaves stale rows behind.
How do I install it?
Run `npx skills add ruvnet/ruflo --skill adr-reindex --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.