¿Qué es un registro de decisión de arquitectura (ADR)?
Un registro de decisión de arquitectura (ADR) es un documento breve que recoge una decisión técnica importante: su contexto, la opción elegida y sus consecuencias.
Cómo funciona
Michael Nygard propuso el formato en 2011: título, estado, contexto, decisión y consecuencias, numerados en orden. Un ADR no se reescribe cuando se cambia de opinión: uno nuevo lo reemplaza.
El conjunto se convierte en la memoria del proyecto. Quien llega lee por qué el sistema es como es, y nadie reabre una cuestión resuelta sin tener delante los motivos.
Un ejemplo
El ADR 14 recoge la elección de PostgreSQL frente a una base de datos documental: los datos son relacionales, el equipo sabe SQL y los informes necesitan joins. Dos años después, el ADR 31 reemplaza una parte para la búsqueda y enlaza al anterior.
Errores habituales
- Registrar las decisiones mucho después, sin el contexto que había sobre la mesa.
- Reescribir un ADR antiguo en vez de reemplazarlo.
- Guardar los ADR donde quienes los necesitan nunca miran.
En Nodary
Nodary tiene una plantilla de ADR integrada. Una decisión puede marcarse como reemplazada por el registro que la sigue, los enlaces dicen de qué depende, y el historial del documento conserva sus versiones recientes para comparar y restaurar.
Lo que Nodary no hace: no guarda los ADR en tu repositorio de código: expórtalos en Markdown si deben vivir junto al código.
Exportar desde Nodary · Plantilla de registro de decisiones con ADR
Pruébalo con tus propios documentos. El plan Free no pide tarjeta.
Crear un espacio gratis