📄 LOG DE DECISIÓN ESTRUCTURAL¶

Ecosistema IA BKM

¿Cuándo crear un ADR?¶

Un ADR registra decisiones que afectan a la arquitectura del ecosistema de forma duradera o transversal. No toda decisión requiere un ADR — solo las que tienen impacto más allá del proyecto concreto o que serán relevantes para entender el ecosistema en el futuro.

Crear un ADR cuando:

Se elige la infraestructura o plataforma de un sistema estratégico.
Se incorpora una herramienta nueva al Core IA o al stack de referencia.
Se decide la capa donde vive un sistema con impacto transversal.
Se cambia un principio del stack o del marco del ecosistema.
Se evalúan varias opciones técnicas con consecuencias a largo plazo y se elige una.
Un sistema migra de capa y esa migración implica decisiones arquitectónicas relevantes.

No crear un ADR cuando:

La decisión es de planificación o priorización — cuándo se construye algo, en qué orden.
La decisión ya está documentada en la Plantilla de Arquitectura o en la Tarjeta de Valor.
Es una decisión operativa reversible sin impacto en la arquitectura del ecosistema.
Es el uso estándar de una herramienta ya definida en el stack — no hay alternativas evaluadas.

¿Quién lo crea?

El Responsable IA, siempre. Puede iniciarlo el Responsable Funcional, pero la validación y el registro son responsabilidad del Responsable IA.

1️⃣ Identificación¶

Nombre de la decisión: [Breve título claro]

Fecha: [Mes Año]

Responsable de la decisión: [Nombre y rol]

Proyecto afectado: [Nombre del sistema o proyecto]

2️⃣ Contexto¶

Descripción breve del problema o situación que requiere decisión. ¿Por qué se tomó esta decisión en este momento? ¿Qué condiciones del ecosistema o del negocio la motivaron?

3️⃣ Opciones Evaluadas¶

Opción A Descripción breve. Ventajas y limitaciones.
Opción B Descripción breve. Ventajas y limitaciones.
Opción C (si aplica) Descripción breve. Ventajas y limitaciones.

4️⃣ Decisión Tomada¶

Decisión final adoptada. Clara y sin ambigüedad.

5️⃣ Justificación¶

Motivos técnicos, estratégicos y económicos que sustentan la decisión. ¿Por qué esta opción y no las otras?

6️⃣ Impacto Arquitectónico¶

¿Afecta al stack de referencia? ¿Afecta a la capa de algún sistema? ¿Afecta a la gobernanza del ecosistema?

Descripción breve del impacto.

7️⃣ Señales de Revisión¶

Condiciones bajo las cuales esta decisión debería revaluarse. ¿Qué tendría que cambiar en el negocio, la tecnología o el ecosistema para que esta decisión dejara de ser válida?

8️⃣ Relación con Otras Decisiones¶

Referencias a otros ADRs o documentos del ecosistema que estén relacionados con esta decisión o que hayan influido en ella.

Estado: Activa / Superada / Revisada

Ubicación: 06_logs_decisiones/