Recursos · 84
Decisiones de arquitectura: conservar razones y saber revisar
Documentar elecciones importantes sin convertir cada reunión en un expediente interminable.
Actualizado · 4 min
Lo que esta guía ayuda a lograr
- Delimitar la decisión
- Comparar opciones plausibles
- Nombrar elección y consecuencias
- Preservar el contexto histórico
- Definir revisiones útiles
Comprobación rápida
- ¿Cada tarea necesita un ADR?
- ¿Puede cambiar una decisión aceptada?
- ¿Un registro garantiza una buena elección?
Método paso a paso
- 1
Delimitar la decisión
Elija una cuestión con efectos duraderos: alojamiento, integración, almacenamiento o límites de componentes. Un ADR conserva las razones de una elección arquitectónica significativa. Describa el problema real y las restricciones actuales, en vez de justificar comercialmente una decisión a posteriori.
Entregable: pregunta y alcance de la decisión.
- 2
Comparar opciones plausibles
Describa alternativas realmente consideradas, incluida la solución actual cuando sea viable. Aplique criterios comunes de uso, seguridad, operación, costes incluidos y salida. Separe mediciones, documentación e hipótesis pendientes.
Entregable: tabla de criterios y evidencia.
- 3
Nombrar elección y consecuencias
Registre opción, responsable, fecha y estado. Describa efectos aceptados, deuda, migración y límites. Aprobar una elección no elimina una restricción conocida. Vincule la decisión con requisitos cubiertos y comprobaciones pendientes.
Entregable: decisión aceptada y consecuencias explícitas.
- 4
Preservar el contexto histórico
Una decisión sustituida debe seguir siendo comprensible. Relaciónela con su sucesora sin reescribir el pasado. El proceso ADR distingue propuestas, aceptaciones, rechazos y decisiones reemplazadas. Mantenga vínculos a tareas y evidencia accesible al equipo.
Entregable: registro con relaciones entre versiones.
- 5
Definir revisiones útiles
Indique cambios concretos: volumen superior al probado, proveedor no disponible, necesidades de localización o costes fuera de hipótesis. Un desencadenante inicia una comparación actualizada, no un abandono automático. Compruebe si alguien nuevo puede explicar la elección sin consultar a sus autores.
Entregable: condiciones de revisión y prueba de traspaso.
Caso de aceptación reproducible
Ejemplo ficticio: estos datos no describen clientes ni resultados observados.
Ver datos del caso
{
"decision": "ADR-7",
"status": "accepted",
"assumption": {
"requests_per_day": 1000
},
"current_requests_per_day": 100000
}Decisión esperada
La carga prevista cambió por un factor 100. Revise ADR-7 conservando su historia.
Variantes ficticias para comprobar
Un ADR está aceptado, pero solo uno de tres servicios lo aplica.
Distinga decisión aceptada y despliegue terminado. Siga los servicios restantes con responsable, posible excepción y prueba de adopción.
El piloto exige p95 ≤ 200 ms; la prueba mide 350 ms.
El criterio no se cumple. Conserve carga, ventana y resultado; decida una revisión sin declarar aprobado el piloto.
Una excepción temporal alcanza su fecha de revisión.
Márquela para reevaluación. El silencio no renueva automáticamente la excepción; asigne una decisión fechada con condiciones y responsable.
Evidencias que conservar
- Estado ADR y adopción por servicio.
- Criterios del piloto, procedimiento y resultado medido.
- Responsable, plazo y decisión sobre la excepción.
Procedimiento de verificación
- Registre decisión, alternativas e hipótesis de carga.
- Compare hipótesis fallida con condiciones actuales.
- Conserve ADR anterior y enlace al reemplazo. Feche la hipótesis modificada, nombre al responsable y precise la prueba necesaria para decidir si la sustitución responde al nuevo contexto.
AWS Prescriptive Guidance — Architectural decision record process
Hoja de cálculo reutilizable
Complete con sus observaciones autorizadas. Estos campos son una plantilla de trabajo, no resultados observados.
| Campo | Información a registrar |
|---|---|
| Pregunta | Problema, alcance y restricciones al decidir |
| Opciones | Soluciones comparadas y criterios comunes |
| Elección | Estado, responsable, razones y consecuencias |
| Revisión | Desencadenante y enlace a una decisión sustituta |
Ejemplo trabajado ficticio
Situación ilustrativa
Ejemplo ficticio: un equipo elige búsqueda gestionada porque no puede ofrecer la cobertura de guardia necesaria.
Decisión y pruebas esperadas
El registro conserva esa restricción, exportación prevista y revisión si cambian localización o costes.
Distinguir los mecanismos
| Mecanismo | Propósito | Verificación o limitación |
|---|---|---|
| Acta de reunión | Conservar conversaciones | La decisión puede estar dispersa |
| ADR | Conservar elección, motivos y consecuencias | No sustituye especificaciones ni pruebas |
| Tarea de implementación | Seguir la entrega | Puede cerrarse sin conservar el razonamiento |
Indicadores de gestión
| Indicador | Qué mide | Primera acción |
|---|---|---|
| Decisiones trazables | Elecciones importantes con contexto accesible | Atender dependencias difíciles de heredar |
| Hipótesis comprobadas | Supuestos decisivos probados o medidos | Revisar criterios sin evidencia |
| Traspaso | Decisiones que una persona nueva puede explicar | Mejorar el registro en vez de añadir reuniones |
Errores comunes
- La decisión puede estar dispersa
- No sustituye especificaciones ni pruebas
- Puede cerrarse sin conservar el razonamiento
Preguntas frecuentes
¿Cada tarea necesita un ADR?
No. Resérvelo para decisiones importantes cuyas consecuencias o reversibilidad justifiquen conservar las razones.
¿Puede cambiar una decisión aceptada?
Sí. Registre la nueva decisión, contexto y relación con la sustituida sin borrar los motivos anteriores.
¿Un registro garantiza una buena elección?
No. Permite revisar criterios e hipótesis; la calidad de evidencia y pruebas sigue siendo decisiva.
Referencias oficiales
Las referencias respaldan el método. Adapte los controles a su contexto; no constituyen certificación. Los títulos de referencia originales y los documentos fuente pueden estar en otro idioma.
Referencias consultadas el .
