Epics
¿Qué es un epic?¶
Un epic es un cuerpo de trabajo demasiado grande para una sola story — típicamente 3 a 10 stories que juntas entregan un resultado coherente. Mientras una story es "agregar saludo al usuario," un epic es "rediseñar la experiencia de onboarding."
Los epics son contenedores lógicos, no branches. Tienen un directorio (work/epics/e{N}-{name}/) que contiene scope, design, plan y todos los artefactos de stories. Las stories hacen branch desde tu branch de desarrollo, no desde un branch de epic.
Cuándo usar epics¶
| Situación | Usa |
|---|---|
| Una feature, una sesión | Story |
| 2-3 cambios relacionados | Story (scope más amplio) |
| 3-10 stories hacia un objetivo | Epic |
| 10+ stories | Dividir en múltiples epics |
No necesitas epics para tus primeras stories. Empieza con stories individuales para aprender el ritmo. Los epics se vuelven útiles cuando te sientes cómodo con el ciclo de stories y necesitas coordinar trabajo más grande.
El ciclo de vida del epic¶
| Paso | Skill | Qué pasa | Artefacto |
|---|---|---|---|
| Start | /rai-epic-start |
Crear directorio del epic, escribir brief y scope | brief.md, scope.md |
| Design | /rai-epic-design |
Gemba walk, descomponer en stories, escribir diseño | design.md |
| Plan | /rai-epic-plan |
Secuenciar stories, identificar dependencias | plan.md |
| Work | [ciclo de story por story] | Ejecutar cada story a través de su ciclo completo | Artefactos de story |
| Close | /rai-epic-close |
Retrospectiva del epic, patrones, limpieza | Retrospectiva |
Cómo organizan el trabajo los epics¶
Un directorio de epic se ve así:
work/epics/e16310-onboarding-ux/
├── brief.md # Hipótesis, métricas de éxito, appetite
├── scope.md # In/out scope, lista de stories, criterios de done
├── design.md # Hallazgos de gemba, enfoque por story
├── plan.md # Secuencia de stories, dependencias, riesgos
└── stories/
├── s16311-story.md # Artefactos de Story 1
├── s16311-design.md
├── s16311-plan.md
├── s16311-retrospective.md
├── s16319-story.md # Artefactos de Story 2
└── ...
Cada story dentro de un epic sigue el ciclo completo de story — scope, design, plan, implement, review, close. El epic provee la dirección estratégica; las stories proveen la ejecución.
Conceptos clave¶
- Brief — la hipótesis: "Si hacemos X, entonces Y mejorará." Incluye métricas de éxito, appetite (cuánto tiempo estamos dispuestos a invertir) y rabbit holes (qué NO construir)
- Scope — qué entra, qué no, y los criterios de done. Se actualiza conforme las stories se completan
- Design — hallazgos del gemba walk y el enfoque para cada story. Aquí es donde lees el código real antes de proponer cambios
- Plan — secuenciación de stories con dependencias. ¿Cuáles pueden correr en paralelo? ¿Cuáles deben ser secuenciales?