Este ADR documenta la estructura que deben seguir todos los Architecture Decision Records del equipo. Está basada en la plantilla original de Michael Nygard, el estándar de facto para ADRs ligeros, extendida con análisis de opciones.

Contexto

Describir el problema y las fuerzas en juego: técnicas, organizacionales, restricciones. Usar lenguaje neutral y factual.

En el contexto de [caso de uso], enfrentamos [problema] y necesitamos decidir [variable de decisión] para lograr [cualidad deseada], aceptando que [trade-off].

Opciones evaluadas

Opción 1 — nombre

Ventajas:

• Ventaja 1
• Ventaja 2

Desventajas:

• Desventaja 1

Opción 2 — nombre

Ventajas:

• Ventaja 1

Desventajas:

• Desventaja 1
• Desventaja 2

Decisión

Elegimos [opción], porque [justificación vinculada al contexto].

Consecuencias

• ✅ Consecuencia positiva
• ✅ Consecuencia positiva
• ⚠️ Trade-off o riesgo a monitorear

Referencias

• Título del recurso — breve descripción de por qué es relevante
• Título del recurso