Esta carpeta registra las decisiones de arquitectura del proyecto mediante Architecture Decision Records (ADRs): documentos cortos que capturan una decisión relevante, su contexto y sus consecuencias.
Crea un ADR cuando tomes una decisión que sea difícil o costosa de revertir, afecte a varias partes del sistema, o que tu yo futuro (o un nuevo integrante) agradecerá tener documentada. Ejemplos: elegir base de datos, definir el modelo de autenticación, adoptar un patrón arquitectónico, cambiar de proveedor.
No hace falta un ADR para decisiones triviales o fácilmente reversibles.
- 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.
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.
| ADR | Título | Estado |
|---|---|---|
| 0001 | Registrar las decisiones de arquitectura | Aceptada |