Cómo redactar un registro de decisión arquitectónica a partir de una reunión
Un ADR documenta una decisión de arquitectura relevante: contexto, alternativas, opción elegida, consecuencias y estado. La transcripción ayuda a recuperar los argumentos. Los participantes confirman la precisión técnica.
Cómo redactar un Architecture Decision Record a partir de una grabación
Un ADR documenta una decisión de arquitectura relevante: contexto, alternativas, opción elegida, consecuencias y estado. La transcripción ayuda a recuperar los argumentos. Los participantes confirman la precisión técnica.
La transcripción permite comprobar las formulaciones. Conserva el contexto, los matices y el orden de los argumentos. La persona responsable decide la redacción final y pide a los participantes que la revisen.
Redacta el ADR paso a paso
Elige una decisión
Dedica un registro distinto a cada decisión arquitectónica independiente.
Describe el contexto
Anota los factores y las limitaciones que hicieron necesaria la decisión.
Compara las opciones
Conserva las ventajas y desventajas relevantes de cada opción y las razones para descartarla.
Indica las consecuencias
Enumera los beneficios, los costes, las nuevas limitaciones, los riesgos y qué obligaría a revisar la decisión.
Ejemplo didáctico: almacenamiento de archivos de audio
El siguiente ejemplo didáctico es ficticio. Los nombres, las condiciones y los resultados solo sirven para explicar el método.
«El almacenamiento de objetos es más barato para el archivo, pero necesitaremos un mecanismo independiente para los enlaces temporales».
Contexto: las grabaciones son grandes, el acceso debe caducar y hay que controlar la emisión de enlaces. La elección es el almacenamiento de objetos. Además del coste, importan la escalabilidad y el modelo de acceso.
Incluye el trabajo y los riesgos en las consecuencias: enlaces temporales, control de caducidad, registro de actividad y pruebas de fallos. Si cambia el supuesto de coste, se puede sustituir el ADR por otro y conservar el historial.
| Sección | Registro útil | Ejemplo que evitar |
|---|---|---|
| Contexto | Archivos grandes y acceso limitado | Necesitamos almacenamiento nuevo |
| Opciones | Almacenamiento de objetos / de archivos | Elegimos lo mejor |
| Decisión | De objetos por los motivos A y B | Lo decidió el arquitecto |
| Consecuencias | Enlaces temporales y supervisión | No hay desventajas |
Plantilla de ADR
Copia la plantilla y complétala a partir de una grabación concreta. Identifica las suposiciones como hipótesis.
Título y estado: Fecha y participantes: Contexto y limitaciones: Opciones estudiadas: Decisión y motivos: Consecuencias, riesgos y condición de revisión:
Cuatro comprobaciones antes de enviar
- El registro describe una decisión.
- El contexto recoge limitaciones reales.
- Se conservan las alternativas y las razones para descartarlas.
- Se indican desventajas y una condición de revisión.
Veamos los detalles
¿Puedo editar un ADR aceptado?
Puedes corregir erratas. Si la decisión cambia, redacta otro ADR y enlaza con el anterior.
¿Hay que guardar la transcripción junto al registro?
Normalmente basta un enlace a la fuente interna y una marca de tiempo para comprobar una formulación discutida.