workspace/core/orchestration/templates/TEMPLATE-EPICA.md

TEMPLATE: ÉPICA

Versión: 1.1.0 Fecha: 2025-12-08 Uso: Definición de épicas del proyecto

---

VERIFICACIÓN DE CATÁLOGO (ANTES DE CREAR)

┌─────────────────────────────────────────────────────────────────────────────┐
│ OBLIGATORIO: Verificar si funcionalidades de esta épica existen en catálogo│
│                                                                             │
│ 1. Revisar historias de usuario vs keywords de @CATALOG_INDEX              │
│ 2. Si match → referenciar en "Notas Técnicas" de cada US y usar código     │
│ 3. Si NO match → proceder con implementación nueva                         │
└─────────────────────────────────────────────────────────────────────────────┘

Funcionalidades del Catálogo a Considerar:

• auth / login / registro → @CATALOG_AUTH
• sesiones / logout → @CATALOG_SESSION
• rate-limit / throttle → @CATALOG_RATELIMIT
• notificaciones / email / push → @CATALOG_NOTIFY
• multi-tenant / organización → @CATALOG_TENANT
• feature-flag / toggle → @CATALOG_FLAGS
• websocket / realtime → @CATALOG_WS
• pagos / stripe / suscripción → @CATALOG_PAYMENTS

Resultado verificación: {✅ No aplica catálogo | ✅ Usar @CATALOG_XXX para US-{NNN} | ⚠️ Pendiente verificar}

---

ÉPICA: {EPIC-ID} - {Nombre de la Épica}

Metadata

Campo	Valor
ID	{EPIC-ID} (ej: EAI-001, EXT-005)
Nombre	{nombre descriptivo}
Módulo	{módulo principal}
Fase	{Fase 1 - Alcance Inicial / Fase 2 - Robustecimiento / Fase 3 - Extensiones}
Prioridad	{P0 / P1 / P2 / P3}
Estado	{Backlog / Ready / In Progress / Done}
Story Points	{estimación total}
Sprint(s)	{sprint(s) asignados}

Descripción

{Descripción de alto nivel de la épica. Qué problema resuelve, por qué es importante para el negocio.}

Objetivo de Negocio

{Qué valor aporta esta épica al producto/negocio}

Stakeholders

Rol	Nombre/Equipo	Responsabilidad
Product Owner	{nombre}	Aprobación de criterios
Tech Lead	{nombre}	Validación técnica
Usuarios	{tipo}	Feedback

---

Historias de Usuario

ID	Historia	Prioridad	SP	Estado
US-{MOD}-001	Como {rol}, quiero {acción} para {beneficio}	P0	5	Backlog
US-{MOD}-002	Como {rol}, quiero {acción} para {beneficio}	P0	3	Backlog
US-{MOD}-003	Como {rol}, quiero {acción} para {beneficio}	P1	8	Backlog

Total Story Points: {suma}

---

Criterios de Aceptación de la Épica

Funcionales:

• {Criterio funcional 1}
• {Criterio funcional 2}
• {Criterio funcional 3}

No Funcionales:

• Performance: {criterio de rendimiento}
• Seguridad: {criterio de seguridad}
• Usabilidad: {criterio de UX}

Técnicos:

• Cobertura de tests > 80%
• Documentación completa
• Integración DB-Backend-Frontend verificada

---

Dependencias

Esta épica depende de:

Épica/Módulo	Estado	Bloqueante
{EPIC-XXX}	Done	Sí
{Módulo Y}	In Progress	No

Esta épica bloquea:

Épica/Módulo	Razón
{EPIC-YYY}	Requiere API de esta épica

---

Desglose Técnico

Database:

• Schema: {schema_name}
• Tablas: {cantidad} ({lista})
• Funciones: {cantidad}
• RLS Policies: Sí/No

Backend:

• Módulo: {module_name}
• Entities: {cantidad}
• Endpoints: {cantidad}
• Tests: {cantidad esperada}

Frontend:

• Páginas: {cantidad} ({lista})
• Componentes: {cantidad}
• Stores: {cantidad}

---

Riesgos

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

---

Definition of Ready (DoR)

• Historias de usuario definidas
• Criterios de aceptación claros
• Dependencias identificadas
• Estimación completada
• Diseño técnico aprobado
• Sin bloqueadores activos

Definition of Done (DoD)

• Código implementado y revisado
• Tests pasando (unit, integration, e2e)
• Documentación actualizada
• Inventarios actualizados
• Trazas registradas
• Demo realizada
• Product Owner aprobó

---

Documentación Relacionada

• Requerimientos: docs/03-requerimientos/RF-{modulo}/
• Especificaciones: docs/04-modelado/especificaciones-tecnicas/
• User Stories: docs/05-user-stories/US-{modulo}/
• ADR: docs/97-adr/ADR-{NNN}-{nombre}.md

---

Historial

Fecha	Cambio	Autor
{YYYY-MM-DD}	Creación de épica	{nombre}

---

Creada por: {nombre-agente} Fecha: {YYYY-MM-DD} Última actualización: {YYYY-MM-DD}