← ClaudeAtlas

docs-adr-writerlisted

Redacta un Architecture Decision Record en el vault de Obsidian del proyecto: ruta y numeración, formato Nygard, regla append-only con supersede, y el índice Dataview de docs/ADR/Overview.md. Úsalo en el paso 2.4 del ciclo SDD —el mismo día de la decisión, antes de /speckit-tasks— y en el 5.3 para cualquier decisión que quedara sin ADR.
DaniDSanj/Spec-Driven-Development-Template · ★ 0 · Data & Documents · score 72
Install: claude install-skill DaniDSanj/Spec-Driven-Development-Template
Tu tarea es redactar **un** ADR como borrador, listo para que el humano lo revise antes de commitearlo. No commitees tú. ## Antes de escribir: ¿esta decisión merece un ADR? Sí merece ADR: elección de tecnología, librería o framework; modelo de datos; arquitectura de módulos; estrategia de autenticación/autorización; y cualquier trade-off que un futuro mantenedor podría cuestionar razonablemente. No merece ADR: detalles de implementación de bajo nivel (por qué una función maneja un error de una forma concreta) — eso se documenta en el propio código o en el mensaje de commit. Si la decisión que te han pasado cae en el segundo grupo, dilo y no crees el fichero. ## Redacción 1. **Ruta y numeración**: `docs/ADR/records/ADR-XXXX-titulo-corto.md`, numeración correlativa de 4 dígitos. Mira qué ADR existen ya antes de elegir el número; nunca reutilices uno. 2. **Formato obligatorio** (Nygard), con la plantilla Templater de `docs/Meta/Templates/adr.md`: - Frontmatter: `tipo: adr`, `id: ADR-XXXX`, `estado`, `fecha`, `supersede:`. - Cuerpo: **Título · Contexto · Decisión · Consecuencias**. - `estado`: `Propuesto` mientras se discute, `Aceptado` una vez tomada, `Superseded` cuando otro ADR la reemplaza. 3. **Contexto** describe la fuerza que motiva la decisión, no la decisión. **Consecuencias** dice qué se gana *y qué se sacrifica* — un ADR sin coste declarado está incompleto. 4. **Un ADR = una decisión.** Si te pasan dos, redacta dos ficheros y dilo. 5. **Appen