📌 Cuándo usar este template
Usar un ADR cuando:
- se toma una decisión técnica con impacto transversal
- hay trade-offs relevantes (no es obvio qué elegir)
- la decisión afecta a más de una persona o proyecto
- queremos evitar reabrir la misma discusión en el futuro
No es necesario usar un ADR cuando:
- es una decisión local o trivial
- el cambio es fácilmente reversible
- no hay impacto fuera del contexto inmediato
ADR-XXXX ·
- Estado: Propuesto | Aceptado | Rechazado | Deprecado
- Fecha: YYYY-MM-DD
- Autor(es):
Contexto
Describir el problema o situación que motiva esta decisión.
Incluir:
- contexto técnico
- contexto del equipo / proyecto
- por qué esto es un problema ahora (y no después)
El objetivo es que alguien nuevo entienda por qué esta decisión era necesaria.
Decisión
Describir claramente qué se decidió.
Debe ser:
- explícita
- accionable
- no ambigua
Motivación
Explicar por qué esta decisión es razonable.
Idealmente separar en subpuntos:
- reproducibilidad
- simplicidad
- costos
- trade-offs relevantes
Aquí vive el “criterio técnico”.
Alternativas consideradas
Listar las alternativas evaluadas y explicar brevemente por qué no se eligieron.
El objetivo no es justificar, sino dejar trazabilidad del razonamiento.
Consecuencias
Positivas
Beneficios esperados de esta decisión.
Negativas / trade-offs
Costos, riesgos o limitaciones aceptadas conscientemente.
Guía de adopción
Cómo se aplica esta decisión en la práctica:
- reglas operativas
- comandos clave
- documentos relacionados
Debe ser suficiente para usar la decisión, sin duplicar documentación detallada.
Métricas de éxito
Señales observables de que la decisión funcionó.
Ejemplos:
- reducción de errores
- mejor onboarding
- menos fricción operativa
Cuándo revisitar esta decisión
Condiciones claras bajo las cuales esta decisión debería reevaluarse.
Referencias
Links, artículos o documentación que respaldan esta decisión.