¿Qué hace Orquestrador de Ciclo de Desarrollo?
Orquesta el ciclo de vida completo de desarrollo: lluvia de ideas → planificar → revisar → issues → implementar → revisión de código → PR.
Desambiguación: Si el usuario solo quiere un PRD, dirígete a /write-a-prd. Si solo quiere un plan, dirígete a /prd-to-plan. Este skill es para el ciclo de vida completo de extremo a extremo.
El Pipeline de 7 Fases
Cada fase es obligatoria. Ninguna fase puede omitirse.
| # | Fase | Delega A | Condición de Puerta |
|---|---|---|---|
| 1 | Brainstorm | write-a-prd | URL del issue registrada |
| 2 | Plan | prd-to-plan | Archivo de plan existe en docs/plans/ |
| 3 | CEO Review | plan-ceo-review (recomendar MANTENER ALCANCE) | Revisión completa, usuario aprueba |
| 4 | Issues | Orquestador (plan se divide → issues de GitHub) | Todas las URLs de issues registradas |
| 5 | Implementar | Orquestador (tdd por issue, subagent-development) | Todos los issues resueltos, tests pasan |
| 6 | Code Review | daa-code-review | Revisión limpia |
| 7 | PR | commit + github-cli | URL del PR registrada |
Lógica de Reentrada
En cada invocación:
Sin argumentos (/dev-cycle)
- Escanea
docs/dev-cycle/en busca de archivos*.state.mdconstatus: in_progress - Si hay uno → pregunta: "¿Reanudar {funcionalidad} (
{rama})? Actualmente en {fase}." - Si hay varios → lista con nombres de ramas, pregunta cuál reanudar
- Si no hay ninguno → pregunta: "¿En qué funcionalidad estás trabajando?" → iniciar Fase 1
Con argumento (/dev-cycle {slug})
- Busca
docs/dev-cycle/{slug}.state.md - Encontrado → reanuda en
current_phase - No encontrado → crea archivo de estado, inicia Fase 1
Colisión de Slug
Al crear un nuevo archivo de estado, verifica docs/dev-cycle/ en busca de slugs existentes. Si el slug ya existe (abandonado o completado), añade sufijo -2, -3, etc.
Carga de Contexto al Reanudar
Antes de continuar, carga TODOS los artefactos referenciados:
- Brainstorm:
gh issue viewel issue del PRD - Plan: Lee el archivo de plan desde el disco
- CEO Review: Lee el archivo de plan (incluye revisiones de la revisión)
- Issues:
gh issue viewcada issue de implementación - Implementar: Verifica estado de git en la rama de funcionalidad, revisa issues cerrados
Presenta resumen: "Reanudando {funcionalidad} en {fase}. Aquí es donde lo dejamos: ..."
Ejecución de Fases
Fase 1: Brainstorm
Invoca write-a-prd. Confía en el flujo interno del skill (entrevista → PRD → issue de GitHub). Registra la URL del issue en el archivo de estado.
Fase 2: Plan
Pasa la URL del issue del PRD a prd-to-plan. Registra la ruta del archivo de plan (en docs/plans/{funcionalidad}.md).
Fase 3: CEO Review
Pasa la ruta del archivo de plan a plan-ceo-review. Recomienda el modo MANTENER ALCANCE pero deja que la propia selección de modo del skill (Paso 0F) se ejecute. Registra cuando la revisión está completa y el usuario aprueba.
Fase 4: Issues
Propiedad del orquestador. Lee las divisiones verticales del plan. Para cada división, crea un issue de GitHub usando gh issue create que:
- Hace referencia al issue del PRD
- Incluye criterios de aceptación del plan
- Se crea en orden de dependencias
Registra cada URL de issue en la tabla de Issues inmediatamente después de crearla. Consulta references/phase-transitions.md para la recuperación de completado parcial.
Fase 5: Implementar
Propiedad del orquestador. Crea la rama de funcionalidad feat/{slug-funcionalidad} (consulta el manejo de ramas en references/phase-transitions.md).
Despacha un subagente por cada issue de GitHub siguiendo la metodología subagent-development:
- Cada subagente invoca el skill
tdd - La revisión de código se ejecuta entre cada despacho de subagente
- El archivo de estado se actualiza después de que cada subagente completa (no por lotes)
Registra eventos por subagente:
"Subagente iniciado para issue #N: {título}""Subagente completado para issue #N: {aprobado/fallado}""Revisión de código después del issue #N: {limpio/problemas bloqueantes encontrados}"
Fase 6: Code Review
Invoca daa-code-review contra todos los archivos modificados en la rama de funcionalidad. Si se encuentran problemas bloqueantes → corregir, re-ejecutar. Bucle hasta que esté limpio.
Si hay problemas arquitectónicos que requieren reelaboración del plan → activa transición hacia atrás a la Fase 2.
Fase 7: PR
Primero verifica conflictos con la rama por defecto. Invoca commit para un commit convencional, luego github-cli para abrir el PR. Registra la URL del PR, establece status: completed. Luego ejecuta el paso de archivado (ver Archivado más abajo).
Archivo de Estado
Cada funcionalidad se rastrea en docs/dev-cycle/{slug-funcionalidad}.state.md. Consulta references/state-file-schema.md para el formato completo, definiciones de campos y reglas de transición.
Fallo y Recuperación
Consulta references/phase-transitions.md para:
- Lógica de reintento de fase (bloqueado → reintentar en la siguiente invocación)
- Transiciones hacia atrás (implementar/revisión_código → plan)
- Abandono de funcionalidad. Los archivos archivados se mueven a
docs/archive/.
Gestión de Ramas
- Fases 1–4: Ejecutar en la rama actual (solo documentación)
- Fase 5: Crea rama
feat/{slug-funcionalidad} - Fase 7: PRs a la rama por defecto (detectada mediante
gh repo view --json defaultBranchRef) - Reanudar en Fase 5+: Cambiar a la rama de funcionalidad si no se está ya en ella
Archivado
Cuando una funcionalidad alcanza un estado terminal (completed o abandoned), archiva sus artefactos:
- Crear directorios de archivo:
mkdir -p docs/archive/dev-cycle docs/archive/plans - Mover el archivo de estado:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - Mover el archivo de plan: leer la ruta del plan desde la tabla de artefactos, luego
git mv {ruta_del_plan} docs/archive/plans/ - Confirmar los movimientos con mensaje:
chore(dev-cycle): archivar {slug}
El archivado se ejecuta automáticamente:
- Al final de la Fase 7 (después de que se registra la URL del PR y el estado se establece en
completed) - Al abandono de funcionalidad (después de que el estado se establece en
abandoned)