El registro de decisión de arquitectura que deja rastro

Un ADR no es un acta de reunión ni un manual: es una decisión con su porqué. Lo que lo hace útil dentro de un año es lo que cuesta escribir hoy: las alternativas que se estudiaron y por qué se descartaron, y las consecuencias, incluidas las malas. Sin las alternativas, nadie sabe si la opción elegida fue una elección o la única que se miró.

Cada registro lleva además un estado (propuesta, aceptada, sustituida o rechazada) y una fecha de revisión, porque una decisión sin fecha de revisión se vuelve ley.

La plantilla de Trigal exige al menos dos alternativas con el motivo del descarte. Un ADR que no las trae no prueba que se decidió: prueba que se escribió después de decidir. Es el defecto más común y el más barato de corregir: basta con reabrir la discusión y escribir lo que se descartó.

Abre la plantilla y revisa los ADR aceptados. Uno de ellos tiene vacío el campo de alternativas.

Cada ADR tiene una fecha de revisión. Pasada esa fecha, la decisión sigue vigente pero ya no está vigilada: el contexto pudo cambiar y nadie lo comprobó. El corte del archivo de Trigal es el 2027-03-15, y esa es la fecha contra la que se mide.

Revisa los campos de fecha de revisión de los ADR aceptados.

Un ADR aceptado no se reescribe. Si la decisión cambia, se escribe otro que lo sustituye, y el antiguo se marca como sustituido con el número del nuevo. Así el historial cuenta cómo se pensó y cuándo se cambió de opinión. Si el antiguo sigue diciendo «aceptada», quien lo lea aplicará una decisión que ya no rige.

Busca un ADR cuya retención o decisión haya sido reemplazada por otro posterior y cuyo estado no lo diga.

La regla de oro del ADR es que nada se ejecuta con un registro en «propuesta». Pero los proveedores cambian cosas por su cuenta y avisan después, y a veces el cambio coincide con algo que Trigal tenía pendiente de decidir. En ese caso la arquitectura real ya decidió por Trigal, sin Trigal.

Lee el registro de cambios y la lista de ADR. Hay una decisión pendiente cuyo efecto ya está en producción.