Orion Protocol

¿Qué es Architecture Decision Records?

Se pueden definir como una serie de documentos que sirven para registrar las decisiones que se toman durante la elección o incluso el cambio de la arquitectura de un sistema de software. Dentro de su principal propósito está proporcionar un historial de los cambios y el razonamiento detrás de las decisiones que se toman en nuestra arquitectura, lo cual es clave.

Las partes que lo conforman

Está conformado por las siguientes partes:
Título: se aplica sobre la decisión que se está tomando.
Estado: nos muestra el “estado” de la decisión, si está aprobada, en pausa o en revisión.
Contexto: aquí se detalla la descripción de las decisiones que deben tomarse.
Decisión: se desarrolla la decisión que se tomó y se adjuntan las justificaciones que la sustentan.
Consecuencias: se describen las consecuencias y cómo estas decisiones afectarán al sistema, su funcionamiento y la arquitectura existente de nuestro sistema.

Sus principales beneficios

• Transparencia: Todos los miembros del equipo pueden entender las decisiones que se han tomado y el porqué.
• Trazabilidad: Las decisiones pueden rastrearse hasta un problema específico, lo que resulta útil en proyectos a largo plazo.
• Facilidad para la toma de decisiones futuras: Proporcionan un marco para evaluar si una decisión previa sigue siendo válida o si es necesario reconsiderarla debido a cambios en el entorno del proyecto.