workspace-v1/orchestration/templates/TEMPLATE-ANALISIS.md

ANÁLISIS PRE-EJECUCIÓN: {TAREA-ID} - {Nombre de la Tarea}

Agente: {Database-Agent | Backend-Agent | Frontend-Agent | etc} Tipo de tarea: {Requerimiento | Bug | Feature | Corrección | Validación} Prioridad: {P0 | P1 | P2 | P3} Fecha análisis: {YYYY-MM-DD} Relacionado con: [{REQ-XXX}], [{DB-XXX}], [{BE-XXX}]

---

📋 CONTEXTO DE LA TAREA

Solicitud Original

{Descripción de lo que se solicita}

Objetivo Final

{¿Qué se debe lograr al completar esta tarea?}

Módulo Relacionado

Módulo MVP: {nombre del módulo según MVP-APP.md} Sección en MVP-APP.md: {número de sección y página}

Justificación

{¿Por qué es necesario? ¿Qué problema resuelve? ¿Qué valor aporta?}

---

🔍 INVENTARIO ACTUAL

Consultas Realizadas

Inventarios revisados:

• MASTER_INVENTORY.yml
• DATABASE_INVENTORY.yml (si aplica)
• BACKEND_INVENTORY.yml (si aplica)
• FRONTEND_INVENTORY.yml (si aplica)
• DEPENDENCY_GRAPH.yml

Comandos ejecutados:

# Búsqueda de duplicados
grep -rn "{objeto}" orchestration/inventarios/
find apps/ -name "*{objeto}*"

# Resultado:
# ✅ No existe | ❌ Ya existe en {ubicación}

Objetos Existentes Relacionados

Base de Datos:

• Schema: {nombre} → {existe | no existe}
• Tabla: {nombre} → {existe | no existe}
• Función: {nombre} → {existe | no existe}

Backend:

• Módulo: {nombre} → {existe | no existe}
• Entity: {nombre} → {existe | no existe}
• Service: {nombre} → {existe | no existe}

Frontend:

• Página: {nombre} → {existe | no existe}
• Componente: {nombre} → {existe | no existe}
• Store: {nombre} → {existe | no existe}

Objetos a Crear/Modificar

Nuevos objetos:

• Schema: {nombre} (crear)
• Tabla: {nombre} (crear)
• Entity: {nombre} (crear)
• Página: {nombre} (crear)

Objetos a modificar:

• Tabla: {nombre} (agregar columnas X, Y)
• Service: {nombre} (agregar método Z)

---

⚠️ ANÁLISIS DE RIESGOS

Riesgo de Duplicación

Verificación:

• NO existe schema similar
• NO existe tabla similar
• NO existe módulo/entity similar
• NO existe componente similar

Objetos similares encontrados: {Si existen, listar aquí con decisión de qué hacer}

Decisión:

• Crear nuevo objeto (no hay similar)
• Modificar objeto existente: {nombre}
• Reutilizar objeto existente: {nombre}

Otros Riesgos Identificados

Riesgo	Probabilidad	Impacto	Mitigación
{Riesgo 1}	Alta/Media/Baja	Alto/Medio/Bajo	{Estrategia de mitigación}
{Riesgo 2}	Alta/Media/Baja	Alto/Medio/Bajo	{Estrategia de mitigación}

---

🔗 ANÁLISIS DE IMPACTO

Archivos Afectados

A crear:

• apps/database/ddl/schemas/{schema}/{tipo}/{archivo}.sql
• apps/backend/src/modules/{modulo}/{tipo}/{archivo}.ts
• apps/frontend/web/src/apps/{rol}/pages/{Archivo}.tsx

A modificar:

• {lista de archivos existentes que se modificarán}

Total archivos:

• Crear: {N}
• Modificar: {M}

Dependencias

Esta tarea depende de:

• [{TAREA-XXX}]: {descripción} → Estado: {Completado | Pendiente | En Progreso}
• [{TAREA-YYY}]: {descripción} → Estado: {Completado | Pendiente | En Progreso}

Bloqueadores actuales:

• {Ninguno | Lista de bloqueadores}

Esta tarea bloquea:

Módulos Afectados

Impacto directo:

• Módulo: {nombre}
• Stack: {Database | Backend | Frontend | Todos}

Impacto indirecto:

• Módulos que consumen: {lista}
• Módulos relacionados: {lista}

---

🎯 DECISIÓN DE APPROACH

Approach Seleccionado

{Descripción del enfoque elegido para resolver la tarea}

Razones:

1. {Razón 1}
2. {Razón 2}

Alternativas Consideradas

Alternativa 1: {descripción}

• Pros: {lista}
• Contras: {lista}
• Razón de descarte: {descripción}

Alternativa 2: {descripción}

• Pros: {lista}
• Contras: {lista}
• Razón de descarte: {descripción}

---

🔄 NECESIDAD DE SUBAGENTES

Análisis de Complejidad

Criterios:

• Número de pasos: {N} → {Simple (<3) | Media (3-5) | Compleja (>5)}
• Módulos afectados: {M} → {Simple (1) | Media (2-3) | Compleja (>3)}
• Archivos a crear: {F} → {Simple (<5) | Media (5-10) | Compleja (>10)}
• Coordinación entre capas: {Sí | No}

Decisión:

• NO usar subagentes - Tarea simple, ejecutar directamente
• SÍ usar subagentes - Tarea compleja, usar {N} subagentes

Plan de Subagentes (si aplica)

Subagente 1: {nombre-subagente}

• Tarea: {descripción específica}
• Duración estimada: {tiempo}
• Artefactos: {lista de archivos que generará}

Subagente 2: {nombre-subagente}

• Tarea: {descripción específica}
• Duración estimada: {tiempo}
• Artefactos: {lista de archivos que generará}

---

📊 ESTIMACIÓN PRELIMINAR

Tiempo Estimado por Fase

Fase	Duración Estimada	Notas
Análisis	{tiempo}	Este documento
Planificación	{tiempo}	Crear plan detallado
Ejecución	{tiempo}	Desarrollo + tests
Validación	{tiempo}	Compilación + tests + E2E
Documentación	{tiempo}	Inventarios + trazas + README
TOTAL	{tiempo}

Recursos Necesarios

Agentes:

• Agente principal: {nombre}
• Subagentes: {lista | ninguno}

Herramientas:

• {Lista de herramientas necesarias}

Información adicional requerida:

• {Lista | Ninguna}

---

📚 REFERENCIAS CONSULTADAS

Documentación del Proyecto

• MVP-APP.md (Sección {N})
• docs/01-requerimientos/{archivo}.md
• docs/02-arquitectura/{archivo}.md
• docs/97-adr/ADR-{XXX}.md

Código Existente

Archivos de referencia (templates):

• {ruta/archivo} - Usado como template para {propósito}
• {ruta/archivo} - Referencia de patrón similar

Inventarios y Trazas

• MASTER_INVENTORY.yml
• TRAZA-REQUERIMIENTOS.md
• TRAZA-TAREAS-{GRUPO}.md

---

✅ CONCLUSIÓN DEL ANÁLISIS

Resumen

{Párrafo resumiendo el análisis completo}

Decisiones Clave

1. Approach: {decisión}
2. Subagentes: {usar | no usar}
3. Objetos a crear: {cantidad y tipo}
4. Duración estimada: {tiempo}

Recomendaciones

1. {Recomendación 1}
2. {Recomendación 2}

Aprobación para Proceder

• Análisis completo y documentado
• Sin bloqueadores identificados
• Recursos disponibles
• Estimaciones validadas
• APROBADO PARA PLANIFICACIÓN

---

🚀 PRÓXIMO PASO

Acción: Crear documento de planificación (02-PLAN.md)

Template: TEMPLATE-PLAN.md

---

Analizado por: {nombre-agente} Fecha: {YYYY-MM-DD HH:MM} Versión: 1.0 Estado: {Borrador | Revisión | Aprobado}