# Adr Index

> Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/adr-index
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: hace 27 días
Coste de contexto: 43 tok instalada, 866 tok al activarse, 866 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: bash mcp__plugin_ruflo-core_ruflo__memory_list mcp__plugin_ruflo-core_ruflo__memory_search

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill adr-index --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill adr-index --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill adr-index --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill adr-index --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill adr-index --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill adr-index --agent cline
```

## Qué hace

- Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en una sola llamada Bash en vez de cientos de llamadas MCP.
- Reconoce ADRs en formato v3 (encabezado + Status) y formato plugin (frontmatter YAML) bajo docs/adr/ o docs/adrs/.
- Guarda cada ADR en el namespace adr-patterns y cada relación (supersedes, amends, related, depends-on) en adr-edges.

## Cuándo usarla

- Después de importar ADRs de otro proyecto.
- Cuando el grafo de AgentDB está desincronizado con los archivos ADR en disco.

## Cuándo no

- Solo añade o actualiza; no elimina filas de ADRs borrados — para eso usa adr-reindex, según el propio archivo.

## Qué la activa

- "Reconstruye el índice de ADRs del proyecto"

## Antes de instalar

- Ejecuta node plugins/ruflo-adr/scripts/import.mjs; admite las variables IMPORT_FORMAT, IMPORT_DRY_RUN y ADR_ROOT.

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

# 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__plugin_ruflo-core_ruflo__memory_search` against the populated namespace:

   ```
   memory_search --query "federation budget" --namespace adr-patterns
   ```

## Storage shape

`adr-patterns` namespace, key `<ADR-id>::<basename>`, value (text):

```
<title> — <first paragraph of Context>

file: <relative path>
status: <Proposed|Accepted|Superseded|...>
date: <ISO date>
tags: <comma-separated>
```

`adr-edges` namespace, deterministic key `<relation>:<FROM>-><TO>`, value:

```json
{ "from": "ADR-097", "to": "ADR-086", "relation": "related", "capturedAt": "<ISO>" }
```

Both ADR records and relationship edges are stored with explicit upsert
semantics. Re-running `adr-index` refreshes changed metadata in place and does
not create duplicate copies of an unchanged semantic edge.

## False-positive guard

`#1697` / `commit abc123` / `PR 1234` references inside ADR bodies are stripped before regex extraction so they don't get misread as `ADR-1697` etc. See `extractAdrRefs()` in `scripts/import.mjs`.

## What this skill cannot do

`adr-index` only ever adds/upserts. If an ADR file was deleted (or a relation line removed from a surviving file), the row it wrote stays forever — `adr-verify` won't catch it either, since an orphan has no dangling ref and forms no cycle. Use the sibling `adr-reindex` skill to reconcile a deletion (issue #2666).

## Cross-references

- `adr-create` — produces the ADR files this skill consumes
- `adr-review` — runs over `adr-patterns` for compliance checks
- `adr-verify` (sibling skill) — runs `scripts/verify.mjs` for graph-integrity gating
- `adr-reindex` (sibling skill) — drop-and-rebuild reconcile for a deleted ADR file (this skill can only add, never remove)

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.
- [Security Scan](https://skillsagentes.com/skills/ruvnet/ruflo/security-scan.md): Ejecuta escaneos de seguridad completos sobre el código con las herramientas de seguridad de Ruflo, a profundidad quick, standard o deep.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)