Flujo A - Planificar desde un epic existente
flow-aCuándo usarlo
Úsalo cuando ya hay un epic con stories definidas y quieres convertirlo en un planning ejecutable.
Resultado
Un planning activo donde cada story del epic queda representada como una story con criterios de cierre heredados.
- 1Revisar el epic y sus stories actuales.
- 2Enriquecer las stories que estén delgadas o sin Definition of Done.
- 3Detectar gaps del epic y agregar stories faltantes si corresponde.
- 4Crear el planning activo desde el container de stories.
- 5Ejecutar stories, cerrar avances y archivar al terminar.
/us-status/us-enrich/epic-enrich/plan-from-epic/plan-story/plan-done/plan-retrospective/plan-archive
planning-template/TUTORIAL/flow-01-epic.mdFlujo B - Planning desde cero
flow-bCuándo usarlo
Úsalo para trabajo transversal, técnico o de infraestructura que no pertenece a una user story de producto.
Resultado
Una idea inicial se transforma en stories ejecutables dentro de .planning/active/.
- 1Capturar la idea en modo interactivo o como plantilla en blanco.
- 2Crear el planning desde el documento de idea o desde un intent inline.
- 3Expandir la idea para producir stories, dependencias y criterios de éxito.
- 4Atomizar stories si necesitas tareas técnicas más pequeñas.
- 5Ejecutar y cerrar cada story.
/plan-template/plan-new/plan-expand/plan-atomize/plan-task/plan-story/plan-done
planning-template/TUTORIAL/flow-02-general.mdFlujo C - Refinar el backlog de producto
flow-cCuándo usarlo
Úsalo cuando no quieres ejecutar todavía; el objetivo es mejorar la calidad del backlog antes de planificar.
Resultado
Stories más claras, con DoD, notas técnicas, dependencias y cobertura de gaps antes de pasar a planning.
- 1Identificar stories incompletas dentro del container.
- 2Enriquecer stories una por una.
- 3Agregar stories nuevas cuando el epic no cubre algún comportamiento necesario.
- 4Dividir stories demasiado grandes antes de estimar o planificar.
- 5Revisar estado del container para confirmar que está listo.
/us-status/us-enrich/us-new/us-split/epic-enrich
planning-template/TUTORIAL/flow-03-backlog.mdFlujo D - Ajustar durante la ejecución
flow-dCuándo usarlo
Úsalo cuando el planning ya está activo y aparece trabajo nuevo, ambigüedad, exceso de tamaño o cambios de alcance.
Resultado
El planning activo se adapta sin perder trazabilidad ni forzar trabajo obsoleto.
- 1Determinar si el cambio es solo de ejecución o también debe quedar en backlog de producto.
- 2Agregar stories nuevas al planning activo.
- 3Profundizar stories incompletas antes de ejecutarlas.
- 4Dividir stories demasiado amplias.
- 5Registrar eventos raros y luego saltar, revertir o reintentar stories según el tipo de cambio.
/plan-enrich-epic/plan-enrich-story/plan-split-story/plan-edge-case/plan-story-skip/plan-rollback/plan-retry
planning-template/TUTORIAL/flow-04-mid-execution.mdFlujo E - Pipeline autónomo con agentes
flow-eCuándo usarlo
Úsalo cuando quieres ejecutar un planning de punta a punta con mínima intervención manual.
Resultado
Un comando detecta estado, confirma una vez y delega planificación, ejecución y validación a agentes especializados.
- 1Ejecutar desde una descripción nueva o desde un planning existente.
- 2Revisar el plan de ejecución propuesto.
- 3Confirmar una sola vez.
- 4Dejar que el agente de planificación cree o expanda.
- 5Dejar que el agente de ejecución atomice y corra stories, y que el agente de cierre valide y archive.
/plan-run/plan-agent-plan/plan-agent-execute/plan-agent-validate
planning-template/TUTORIAL/flow-05-autonomous.mdFlujo F - Revisión de estado, auditoría docs y salud del plugin
flow-fCuándo usarlo
Úsalo cuando el planning cambió documentación, podrían aplicar varios comandos o mantienes el plugin.
Resultado
Una revisión de estado clara, reporte con métricas, documentación auditada y checkout del plugin verificado.
- 1Revisar el estado actual antes de ejecutar más trabajo.
- 2Generar métricas para revisar completitud, riesgos y cobertura de issues externos.
- 3Auditar docs generadas por frescura, links, trazabilidad y referencias faltantes.
- 4Ejecutar el doctor del plugin cuando el inventario de comandos o la plantilla podrían haberse desalineado.
/plan-status/plan-report/plan-audit-docs/plan-doctor
planning-template/TUTORIAL/reference.mdFlujo G - Configurar smoke tests
flow-gCuándo usarlo
Úsalo cuando termina una tarea del proyecto y necesitas un plan de smoke tests que considere el stack antes del code review humano.
Resultado
Un archivo `.planning/SMOKE-TESTS.md` concreto con orden de arranque, checks de conectividad, validaciones de migración y criterios de revisión.
- 1Inspeccionar el stack del repositorio y los servicios de soporte.
- 2Dejar que Claude infiera o pregunte los comandos de smoke test cuando el stack sea ambiguo.
- 3Registrar el orden de ejecución y los checks de validación en `.planning/SMOKE-TESTS.md`.
- 4Revisar el archivo antes de pasar a code review humano.
/plan-smoke-config
planning-template/TUTORIAL/flow-06-smoke-config.mdReferencia rápida de comandos
referenceCuándo usarlo
Úsala cuando ya conoces el flujo y necesitas encontrar el comando correcto por capa del sistema.
Resultado
Mapa compacto de comandos para producto, puente, planning, ejecución, ajustes y pipeline autónomo.
- 1Ubicar si estás trabajando en backlog de producto o en .planning/.
- 2Elegir el comando según la fase del ciclo de vida.
- 3Verificar argumentos esperados antes de ejecutarlo.
- 4Consultar /plan-status cuando no esté claro el estado actual, o /plan-health cuando todo el sistema pueda estar inconsistente.
/us-new/us-enrich/plan-from-epic/plan-new/plan-expand/plan-status/plan-health/plan-edge-case/plan-retrospective/plan-run/plan-smoke-config
planning-template/TUTORIAL/reference.md