Gobernanza
Los modelos y los proveedores cambian cada pocos meses, y la razón detrás de una elección desaparece antes que el código. Un registro breve por decisión la conserva.
5 nov 2026 · 4 min de lectura
El diagrama y las fuentes están en inglés.
Seis meses después de iniciado un proyecto de agentes, alguien pregunta por qué las tareas de soporte van a un modelo de nivel medio, o por qué las aprobaciones están en la pasarela de herramientas y no en el agente. El código muestra lo que se construyó. No muestra lo que se consideró. Ese es el vacío que llena un registro de decisión de arquitectura, o ADR.
Michael Nygard propuso el formato en 2011: un documento corto por cada decisión importante, con un título, un estado, el contexto, la decisión y sus consecuencias. Los registros se numeran en secuencia, y un número nunca se reutiliza.
Si una decisión se revierte, conserva el registro antiguo y márcalo como reemplazado, con una referencia a su sustituto. Las alternativas descartadas suelen ser la parte más útil para un lector futuro, porque evitan que el equipo repita la misma discusión.
Ejemplo, inventado para ilustrar: ADR-007, Enviar la clasificación a un modelo pequeño. Estado: aceptada. Contexto: la clasificación domina el volumen y no necesita razonamiento profundo. Decisión: enviaremos la clasificación al nivel más pequeño y escalaremos cuando la confianza sea baja. Alternativas descartadas: un modelo grande para todo, por el costo. Consecuencias: debemos mantener un conjunto de evaluación para detectar regresiones cuando cambie el modelo pequeño.
Cuéntanos un proceso. Te mostramos cómo lo podría tomar un agente y qué medir para saber que está funcionando.