ADR-00X: Título de la decisión¶

Fecha: YYYY-MM-DD Estado: aceptado / propuesto / reemplazado / obsoleto Decisión: qué decidimos, en una frase. Sé específico: el lector debe entender la decisión sin leer el resto. Contexto: por qué necesitamos decidir esto ahora. Qué fuerzas están en juego. Qué restricciones existen. Qué pasaría si no decidiéramos nada. Alternativas consideradas: qué otras opciones evaluamos. Para cada una: ventajas principales y por qué se descartó. Una tabla ayuda a comparar. Consecuencias: qué ganamos (✅), qué perdemos o qué limitaciones aceptamos (❌), qué facilita esta decisión, qué hace más difícil. Sé honesto con los tradeoffs. Referencias: enlaces a principios, mecanismos, fichas, ADRs relacionados o cualquier documento relevante.

Notas para quien escriba un ADR:

Brevedad: 1-2 páginas máximo. Si necesitas más, probablemente son dos ADRs.
Honestidad: documenta los tradeoffs. Un ADR que solo enumera ventajas no es un ADR, es propaganda.
Inmutabilidad: un ADR nunca se borra. Si la decisión cambia, se crea un nuevo ADR que reemplaza al anterior y se marca el antiguo como reemplazado.
Contexto histórico: dentro de 5 años, alguien leerá esto sin conocer las circunstancias. Escribe para esa persona.
No es un paper: captura racionalidad, no buscas publicar en una revista.