Decisiones de Arquitectura (ADRs)
Esta carpeta registra las decisiones relevantes del proyecto mediante Architecture Decision Records (ADRs): documentos cortos que capturan una decisión, su contexto y sus consecuencias.
¿Qué es un ADR y cuándo crear uno?
Crea un ADR cuando tomes una decisión que sea difícil o costosa de revertir, afecte a varias partes del proyecto, o que tu yo futuro (o un nuevo colaborador) agradecerá tener documentada. Ejemplos: cambiar el formato de la plantilla, adoptar una convención de commits distinta, definir el alcance del proyecto.
No hace falta un ADR para decisiones triviales o fácilmente reversibles.
Convención de numeración y nombres
- Archivos:
NNNN-titulo-en-kebab-case.md(numeración secuencial empezando en0001). - La plantilla base es
0000-template.md— cópiala para crear uno nuevo.
Ciclo de estados
Propuesta → Aceptada → (eventualmente) Reemplazada por ADR-XXXX | Obsoleta
- Propuesta: en discusión.
- Aceptada: decisión vigente.
- Reemplazada: una decisión posterior la sustituye (enlaza al nuevo ADR).
- Obsoleta: ya no aplica.
Los ADRs son inmutables una vez aceptados: en lugar de editarlos, se crea uno nuevo que reemplace al anterior.
Índice
| ADR | Título | Estado |
|---|---|---|
| 0001 | Registrar las decisiones del proyecto | Aceptada |