specful

Registro de un ADR con Specful

Un ADR registra por qué se tomó una decisión duradera: las fuerzas, las alternativas creíbles y las consecuencias. No es un Requisito (lo que el software debe hacer) ni un Diseño (cómo funciona el sistema); si el cambio es sobre qué o cómo, cargue specful-requirement o specful-design en su lugar. Manténgalo a nivel de decisión: sin secuencias de tareas, inventarios de archivos ni notas de progreso.

Flujo de trabajo

1. Lea docs/adr/ y su índice para conocer la numeración, los estados y las decisiones ya registradas; un nuevo ADR que contradiga una aceptada la reemplaza en lugar de discrepar en silencio.
2. Genere el esqueleto con specful new adr --title <TITLE>. Nunca asigne manualmente un identificador; el comando posee el contador.
3. Complete los marcadores de posición. Exprese la decisión en tiempo presente; represente las alternativas creíbles de manera honesta en lugar de como hombres de paja para una respuesta preferida; registre las consecuencias negativas con el mismo cuidado que las positivas. Un ADR sin alternativa creíble o sin desventaja es publicidad, no un registro de decisión.
4. El ciclo de vida pertenece al mantenedor: un nuevo registro comienza como propuesto, y solo el mantenedor lo acepta, rechaza o reemplaza.
5. Ejecute specful index, luego specful validate; comprometa las vistas regeneradas junto con el cambio. Use specful-review cuando el repositorio adoptante requiera una revisión sustancial o el usuario lo solicite.

Para el perfil completo de ADR y guía campo por campo, consulte https://unkos-dev.github.io/specful/.