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

PLAN DE 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 creación: {YYYY-MM-DD} Relacionado con: [{REQ-XXX}], [{DB-XXX}], [{BE-XXX}]

---

🔍 VERIFICACIÓN DE CATÁLOGO

┌─────────────────────────────────────────────────────────────────────────────┐
│ OBLIGATORIO: Verificar @CATALOG_INDEX antes de implementar                 │
│                                                                             │
│ Comando: grep -i "{funcionalidad}" core/catalog/CATALOG-INDEX.yml          │
└─────────────────────────────────────────────────────────────────────────────┘

Funcionalidades a verificar:

Funcionalidad	¿Aplica?	Catálogo	Acción
auth/login	Sí/No	@CATALOG_AUTH	Usar/Implementar
sesiones	Sí/No	@CATALOG_SESSION	Usar/Implementar
rate-limit	Sí/No	@CATALOG_RATELIMIT	Usar/Implementar
notificaciones	Sí/No	@CATALOG_NOTIFY	Usar/Implementar
multi-tenant	Sí/No	@CATALOG_TENANT	Usar/Implementar
feature-flags	Sí/No	@CATALOG_FLAGS	Usar/Implementar
websocket	Sí/No	@CATALOG_WS	Usar/Implementar
pagos	Sí/No	@CATALOG_PAYMENTS	Usar/Implementar

Resultado: {✅ No aplica catálogo | ✅ Usar @CATALOG_XXX | ⚠️ Pendiente verificar}

---

🎯 OBJETIVO

Descripción clara y concisa del objetivo de esta tarea.

Criterios de Aceptación:

• Criterio 1
• Criterio 2
• Criterio 3

---

📋 ANÁLISIS PREVIO

Contexto

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

Estado Actual

• Objetos existentes relacionados
• Dependencias identificadas
• Restricciones conocidas

Anti-Duplicación

# Comandos ejecutados para verificar no-duplicación
grep -rn "{objeto}" orchestration/inventarios/
find apps/ -name "*{objeto}*"

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

---

📐 DISEÑO DE SOLUCIÓN

Approach Seleccionado

Descripción del enfoque elegido.

Alternativas consideradas:

1. Alternativa 1 - Razón de descarte
2. Alternativa 2 - Razón de descarte

Componentes a Crear/Modificar

Database:

• Schema: {nombre}
• Tablas: {lista}
• Funciones: {lista}
• Triggers: {lista}
• Seeds: {lista}

Backend:

• Entities: {lista}
• Services: {lista}
• Controllers: {lista}
• DTOs: {lista}

Frontend:

• Páginas: {lista}
• Componentes: {lista}
• Stores: {lista}
• Services: {lista}

---

🔄 CICLOS DE EJECUCIÓN

Ciclo 1: {Nombre del Ciclo}

Duración estimada: {X} horas Objetivo: {descripción breve}

Tareas:

1. Tarea 1
2. Tarea 2
3. Tarea 3

Artefactos generados:

• Archivo 1: {ruta}
• Archivo 2: {ruta}

Validación:

# Comandos de validación
{comandos}

Criterios de éxito:

• Criterio 1
• Criterio 2

---

Ciclo 2: {Nombre del Ciclo}

Duración estimada: {X} horas Objetivo: {descripción breve}

[...repetir estructura del Ciclo 1]

---

Ciclo N: Validación Final

Duración estimada: {X} horas Objetivo: Validar integración completa

Validaciones:

# Database
./apps/database/create-database.sh
# Debe ejecutar sin errores

# Backend
cd apps/backend && npm run build
# Debe compilar sin errores

# Frontend
cd apps/frontend && npm run build
# Debe compilar sin errores

# Tests (si aplica)
npm test
# Todos los tests deben pasar

Checklist de Validación:

• DB ejecuta sin errores
• Backend compila sin errores
• Frontend compila sin errores
• Tests pasan (si aplica)
• Documentación actualizada
• Inventarios actualizados
• Trazas actualizadas

---

🔗 DEPENDENCIAS

Depende de:

Bloquea:

Requerimientos externos:

• Ninguno | {lista de requerimientos}

---

⚠️ 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

---

📊 ESTIMACIONES

Tiempo total estimado: {X} horas / {Y} días

Desglose:

• Análisis: {X}h
• Desarrollo: {Y}h
• Testing: {Z}h
• Documentación: {W}h
• Buffer (15%): {B}h

Recursos necesarios:

• Agentes: {lista}
• Subagentes: {lista}
• Herramientas: {lista}

---

📝 DOCUMENTACIÓN A GENERAR

Durante ejecución:

• 03-EJECUCION.md (ir documentando por ciclo)
• Comentarios inline en código
• Actualización de inventarios en tiempo real

Post-ejecución:

• 04-VALIDACION.md
• 05-DOCUMENTACION.md
• Actualización de TRAZA-{TIPO}.md
• README actualizado (si cambió estructura)
• ADR (si decisión arquitectónica importante)

---

🎯 CRITERIOS DE ÉXITO

La tarea se considera COMPLETADA cuando:

• Todos los ciclos ejecutados exitosamente
• Todas las validaciones pasan
• Documentación completa (5 archivos)
• Inventarios actualizados
• Trazas actualizadas
• Sin errores de compilación
• Tests pasan (si aplica)
• Code review aprobado (si aplica)
• Sin duplicaciones creadas
• Cumple estándares de código

---

📚 REFERENCIAS

Documentación del proyecto:

• MVP Plan: docs/00-vision-general/MVP-APP.md
• ADRs relacionados: docs/97-adr/ADR-XXX.md
• README del módulo: apps/{stack}/README.md

Archivos de referencia:

• Template: {ruta}
• Similar existente: {ruta}

Prompts y directivas:

• PROMPT-AGENTES-PRINCIPALES.md
• POLITICAS-USO-AGENTES.md

---

Versión: 1.0 Última actualización: {YYYY-MM-DD} Aprobado para ejecución: {Sí | No | Pendiente}