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:**
```bash
# 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:**
- [{TAREA-ZZZ}]: {descripción}

### 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](./TEMPLATE-PLAN.md)

---

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