John D. Gómez

Decisiones técnicas

Dejar una decisión que otro pueda continuar

Qué contexto conservar para que una decisión técnica pueda ejecutarse y revisarse sin depender de la memoria de una persona.

La aprobación de una opción cierra una conversación. Para que el trabajo continúe, hace falta conservar por qué esa opción era razonable, bajo qué condiciones y qué podría obligar a cambiarla. Esa información debe poder recuperarla una persona que no estuvo en la reunión.

Registrar lo necesario

Microsoft recomienda conservar el contexto, las alternativas y las consecuencias de las decisiones de arquitectura [1]. La siguiente lista añade preguntas prácticas para preparar su ejecución y revisión.

Hacer visibles los supuestos

Una estimación de volumen, una fecha de entrega o una capacidad del proveedor pueden cambiar. Es útil indicar cuáles de esas condiciones sostienen la decisión y qué señal justificaría reabrirla. Así, revisar el rumbo responde a información nueva y no a preferencias cambiantes.

Ajustar el esfuerzo a las consecuencias

Un cambio fácil de revertir puede necesitar una nota breve y una prueba. Una migración que afecta datos, contratos o personas requiere más investigación. La extensión del documento debe responder a la decisión, no a una plantilla que obliga a escribir lo mismo en todos los casos.

La prueba de transferencia

Entrega el registro a alguien del equipo y pídele que explique qué debe hacer y qué no puede comprometer. Las dudas que aparezcan permiten mejorar la decisión antes de que esas lagunas se conviertan en retrabajo.

Referencias

[1]
Microsoft, “Maintain an architecture decision record (ADR),” Microsoft Learn. Accessed: Sep. 23, 2026. [Online]. Available: https://learn.microsoft.com/en-us/azure/well-architected/architect-role/architecture-decision-record

Consultar fuenteFicha de la fuenteNotas de autor: MicrosoftVolver al texto 1

Descargar referencias: CSL JSON · BibTeX

Historial de actualización

Se precisaron las afirmaciones respaldadas y se añadieron citas y referencias normalizadas.