{"canonical_url":"https://engineer.company/es/glossary/architecture-decision-record/","content_markdown":"# Registro de decisión técnica\n\n## Qué es\n\nUn registro de decisión técnica, conocido también como ADR por sus siglas en inglés, es una explicación breve de una elección que tiene consecuencias para el diseño. Indica qué decidió el equipo, qué circunstancias motivaron la decisión, qué otras opciones se estudiaron y qué efectos se aceptaron. Puede tratar sobre la responsabilidad de conservar ciertos datos, el límite entre servicios, una integración o la conducta prevista ante un fallo. Una persona que se incorpora después puede entender por qué existe el diseño y comprobar cuáles de sus supuestos siguen vigentes.\n\nUnos pocos campos bastan para que el registro se pueda consultar. El identificador y la fecha permiten citarlo. El estado indica si es una propuesta, una decisión vigente o una decisión sustituida. El contexto explica el problema y las restricciones. La decisión dice qué se va a hacer. Las consecuencias recogen tanto lo que se gana como el trabajo que queda por asumir. Puede que se incorpore un servicio que habrá que mantener, que la transición se alargue o que alguien tenga que ensayar una migración. Las alternativas se describen con el detalle necesario para entender por qué se eligió una opción.\n\nElija un lugar conocido por quienes deban leer el registro. Un equipo puede guardar archivos Markdown junto al código y enlazarlos desde el cambio que pone en práctica la decisión. Un proyecto repartido entre varios repositorios puede usar un índice común. Lo más útil es que el texto tenga una dirección estable y una justificación comprensible por sí sola. Desde allí se puede remitir a los informes, mediciones o pruebas que motivaron la elección.\n\n## Por qué importa\n\nEl código explica buena parte de lo que existe ahora. La historia se deduce solo en parte. Una persona puede ver dos bases de datos y pensar que hay que unificarlas. Tal vez la separación se eligió para limitar un riesgo mientras un proveedor cambiaba el formato de sus exportaciones. Un registro puede aclarar qué se protegía, por qué se tomó esa decisión y qué acontecimiento permitiría reconsiderarla. Evita repetir la investigación cada vez que cambia el equipo.\n\nEl registro también permite formular objeciones concretas. Un nuevo componente puede evitar que el equipo escriba su propio planificador. A cambio, la persona de guardia tendrá que saber cómo recuperar el estado de ese componente. Una revisora puede preguntar si existe esa capacidad y cuánto cuesta mantenerla. El razonamiento también queda al alcance del equipo de operaciones antes de que la elección se adopte. Tras la entrega, la misma explicación ayuda a situar responsabilidades.\n\nDedique el esfuerzo en proporción al coste de cambiar de idea. Un texto nuevo en un botón suele quedar suficientemente explicado en el historial. Mover la responsabilidad del registro de pedidos o cambiar la gestión de pagos duplicados tiene efectos en varias partes del sistema. Conviene registrar la decisión mientras se recuerdan las opciones y las pruebas disponibles. Una referencia fechada permite saber qué datos tenía el equipo cuando decidió.\n\n## Cómo se aplica en la práctica\n\nLa página sobre [las decisiones técnicas fundacionales de una plataforma](/es/portfolio/set-the-platforms-founding-technical-decisions/) describe la elección de tecnologías centrales mientras se definía la dirección del producto. Ese trabajo ilustra el tipo de decisión que merece conservarse. El siguiente ejercicio ficticio muestra cómo se podría registrar una decisión sobre la gestión de datos.\n\nSupongamos que un servicio de envíos tiene una base de datos de pedidos y una página pública que permite a cada cliente consultar los suyos. Algunos eventos de expedición llegan tarde. La página no puede mostrar información de otro cliente. El equipo decide servir el estado desde un modelo de lectura separado, alimentado únicamente con los campos aprobados. Consultar de forma directa la base de pedidos exigiría menos componentes y, normalmente, mostraría datos más recientes. También acercaría el tráfico público y un nuevo control de acceso al registro principal. Reutilizar una exportación nocturna sería sencillo, a costa de dejar fuera los cambios del día.\n\nLos efectos del diseño se pueden convertir en acciones. El personal de soporte necesita un indicador de antigüedad para saber cuándo recurrir a la consulta interna. Una prueba del contrato ayuda a detectar campos que se hayan añadido por error. El proceso de actualización y su alerta quedan a cargo de alguien. El acuerdo fija una revisión si el retraso supera el umbral durante dos semanas de demanda alta, o si cambia el requisito de aislamiento. Un enlace a la prueba y al análisis permite comprobar por qué se introdujo el componente adicional.\n\nCuando otro diseño sustituya el anterior, escriba una entrada que refleje la nueva información y establezca enlaces en ambos sentidos. El motivo de la primera decisión sigue siendo pertinente para quienes investigan una versión antigua. El índice debe dejar claro qué decisión se aplica hoy sin obligar a reconstruir cada discusión.\n\nAntes de mostrar un estado, el servicio público verifica que quien consulta tenga acceso a ese pedido concreto. Compruebe la denegación para un pedido ajeno y el conjunto exacto de campos de una respuesta autorizada.\n\n## Dónde surgen los problemas\n\nUn registro pierde credibilidad cuando detalla la opción elegida y reduce las demás a versiones que nadie habría defendido. Presente los mejores argumentos reales de cada alternativa. Vincule las afirmaciones importantes a la medición, norma o compromiso que influyó en la elección. Una buena plantilla deja espacio para describir las circunstancias específicas.\n\nOtro fallo es registrar las ventajas y dejar los costes sin responsable. Una nueva base de datos o una cola compartida cambia el trabajo de otras personas. Indique quién mantendrá el servicio, quién responde del límite de seguridad y cómo se entregarán esas responsabilidades. Cuando una consecuencia aún no se pueda comprobar, indique qué observación servirá y en qué momento se podrá reunir.\n\nPor último, mantenga una extensión que permita escribir el registro durante el proceso. Las instrucciones de operación pueden tener su propio lugar con enlaces. Al cambiar el rumbo, conserve las razones anteriores y señale la decisión que tiene vigencia. El registro será más útil en una revisión dentro de un año si sus referencias siguen siendo localizables.\n\n## Lecturas adicionales\n\n- [Guía de AWS sobre el proceso de decisión de arquitectura](https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/adr-process.html)\n- [Microsoft Azure Well-Architected sobre registros de decisiones](https://learn.microsoft.com/en-us/azure/well-architected/architect-role/architecture-decision-record)\n- [Marco británico para registrar decisiones de arquitectura](https://www.gov.uk/government/publications/architectural-decision-record-framework)\n\n\u003chttps://engineer.company/es/glossary/architecture-decision-record/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Documenta una decisión de arquitectura, las opciones examinadas y los hechos que podrían justificar volver a plantearla.","formats":{"gemtext":"https://engineer.company/es/glossary/architecture-decision-record/index.gmi","gopher":"https://engineer.company/es/glossary/architecture-decision-record/gophermap","html":"https://engineer.company/es/glossary/architecture-decision-record/","json":"https://engineer.company/es/glossary/architecture-decision-record/index.json","markdown":"https://engineer.company/es/glossary/architecture-decision-record/index.md","pdf":"https://engineer.company/es/glossary/architecture-decision-record/index.pdf"},"kind":"page","language":"es","title":"¿Qué es un registro de decisión técnica?","url":"https://engineer.company/es/glossary/architecture-decision-record/","version":1}