# ¿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.

Actualizado el 22 de octubre de 2026.

## 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](https://nodary.ai/es/docs/export)
- [Plantilla de registro de decisiones con ADR](https://nodary.ai/es/templates/decision-log)

Pruébalo con tus propios documentos. El plan Free no pide tarjeta. [Crear un espacio gratis](https://nodary.ai/sign-up)

## Fuentes

- [Documenting Architecture Decisions, Michael Nygard, Cognitect, 2011](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions)
- [Architectural Decision Records, adr.github.io](https://adr.github.io/)
- [Maintain an architecture decision record, Microsoft Azure Well-Architected Framework](https://learn.microsoft.com/en-us/azure/well-architected/architect-role/architecture-decision-record)

## Términos relacionados

- [Registro de decisiones](https://nodary.ai/es/glossary/decision-log): Un registro de decisiones es un historial continuo de las decisiones de un equipo, cada una con su fecha, quién decidió, por qué y qué opciones se descartaron.
- [Documento de requisitos de producto (PRD)](https://nodary.ai/es/glossary/product-requirements-document): Un documento de requisitos de producto (PRD) dice qué debe hacer un producto o una función y por qué: problema, usuarios, objetivos, requisitos y alcance.
- [Documento canon](https://nodary.ai/es/glossary/canon-document): Un documento canon es la versión que un equipo ha reconocido como verdadera: cuando los documentos se contradicen, él decide y los demás se ajustan.

https://nodary.ai/es/glossary/architecture-decision-record