Recursos · 84
Decisiones de arquitectura: conservar razones y saber revisar
Documentar elecciones importantes sin convertir cada reunión en un expediente interminable.
Actualizado · 3 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.
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 .
