Registrar contexto, opciones y consecuencias en un Architecture Decision Record breve y útil para el trabajo diario.
¿A quién va dirigido? Equipos de arquitectura y desarrollo que quieren entender las razones de las decisiones técnicas de forma permanente.
Casos de uso y contexto
Un Registro de Decisión de Arquitectura, o ADR para abreviar, registra una decisión relevante y su justificación. Más adelante, a menudo no es la técnica elegida lo que no está claro, sino por qué se rechazaron las alternativas y qué condiciones se aplicaban en ese momento.
Un ADR debe mantenerse lo suficientemente compacto como para ser leído realmente. Complementa los resúmenes de arquitectura y las especificaciones vinculantes, pero no los reemplaza. Las entradas sobre decisiones con efectos a largo plazo, como la responsabilidad de los datos, patrones de integración o servicios de plataforma central, son especialmente útiles.
El proceso en detalle
- Formula la pregunta de decisión. Describe el contexto, los objetivos y las limitaciones de manera que los futuros miembros del equipo puedan entender.
- Compara opciones seriamente consideradas. Registra ventajas, desventajas e incertidumbres abiertas según los criterios relevantes.
- Documenta la decisión, el estado y las consecuencias. Enlaza una nueva entrada en caso de un cambio posterior en lugar de sobrescribir la justificación antigua de una forma irreconocible.
Resultados esperados
- Pregunta de decisión comprensible
- Alternativas y compensaciones documentadas
- Consecuencias reconocibles para la implementación y el funcionamiento
- Historial vinculado de decisiones cambiadas
Preparar una decisión informada
Una plantilla corta incluye el título, estado, contexto, opciones, decisión, consecuencias y referencias. Nombra a los interesados y la fecha de la decisión si esta información es realmente conocida.
Evita la publicidad puramente de productos y declaraciones generales como "a prueba de futuro". En su lugar, describe qué requisito se cumple y qué desventaja acepta conscientemente el equipo.
Preguntas y respuestas
¿Necesita cada pequeño cambio un ADR?
No. El esfuerzo debe ajustarse al alcance. Las decisiones locales recurrentes a menudo pueden estar cubiertas por los estándares existentes.
¿Qué ocurre con un ADR renovado?
Se conserva como historia y se refiere a la decisión de reemplazo. De este modo, los requisitos previos de ese tiempo no se pierden.