Issue Orchestrator

Fase 1: Inicio

get_issue(id)
update_issue(id, state: "In Progress")

VERIFICAR: ¿Estado == "In Progress"? [SI/NO]
IF NO → repetir update_issue
IF SI → continuar

Verificar antes de avanzar:

• Requisitos funcionales claros
• Dependencias resueltas o documentadas
• Contexto técnico suficiente
• Si falta información → preguntar al usuario

Fase 2: Preparación Git

IF requiere_código THEN
  git checkout -b feature/ISSUE-ID-descripcion
ELSE
  saltar a Fase 3

Fase 3: Implementación

implementar_solución()

VERIFICAR: ¿Funciona correctamente? [SI/NO]
IF NO → corregir → verificar nuevamente
IF SI → continuar

Si existen tests:

ejecutar_tests()
documentar_resultados()

Fase 4: Commit y Push (si Git)

IF se_usó_git THEN
  git add .
  git commit -m "tipo: descripción"
  git push origin branch

  VERIFICAR: ¿Push exitoso? [SI/NO]
  IF NO → resolver error → reintentar
  IF SI → continuar
ELSE
  saltar a Fase 6

Fase 5: Pull Request (si Git)

IF se_usó_git THEN
  gh pr create --title "tipo: ISSUE-ID descripción" \
               --body "Closes #ISSUE-ID" \
               --base main

  VERIFICAR: ¿PR creado? [SI/NO]
  IF NO → resolver error → reintentar gh pr create
  IF SI → guardar URL → continuar
ELSE
  saltar a Fase 6

Fase 6: Mover a In Review

update_issue(id, state: "In Review")

VERIFICAR: ¿Estado == "In Review"? [SI/NO]
IF NO → ejecutar update_issue nuevamente
IF SI → continuar

Fase 7: Documentación

create_comment(
  issueId: id,
  body: resumen + "\n\n---\n_Hecho por Cursor_"
)

VERIFICAR: ¿Comentario creado con firma? [SI/NO]
IF NO → crear comentario
IF SI → workflow completado

Fase 8: Esperar aprobación

NUNCA ejecutar update_issue(state: "Done") sin aprobación explícita del usuario

Uso de subagente issue-completer (múltiples issues)

Patrón de invocación

FOR issue IN [DNT-101, DNT-102, DNT-103]:
  subagente.issue-completer(issue)
END FOR

Coordinación de resultados

1. Esperar completación de todos los subagentes.
2. Recopilar estado individual de cada issue.
3. Identificar issues bloqueados o con errores.
4. Presentar reporte consolidado.
5. Solicitar acción del usuario para issues bloqueados.

Checklist de verificación final

- ¿Múltiples issues? → ¿Se usó subagente issue-completer?
- ¿Issue en "In Progress" al inicio?
- ¿Implementación funcional?
- ¿PR creado? (si Git)
- ¿Issue en "In Review"?
- ¿Comentario con firma creado?
- ¿NO marcado "Done"?

Formato de salida (reporte consolidado)

Issue: [ID] - [Título]

Progreso:
- In Progress: Completado
- Implementación: Completado
- Tests: Completado (X pasaron, Y fallaron)
- PR creado: Completado [URL]
- In Review: Completado
- Comentario: Completado

Cambios principales:
- [archivo/área]: [cambio]
- [archivo/área]: [cambio]

Tests:
- Comando: [comando]
- Resultado: [resultado]

Pendientes/Riesgos:
- [si aplica]