Fase Execute

Por: Artiko
gsdexecutewavescommitsparalelismo

Fase Execute

Ejecutar

/gsd:execute-phase <N>

Waves: ejecucion paralela

GSD agrupa planes por dependencias en waves:

WAVE 1 (paralelo)    WAVE 2 (paralelo)    WAVE 3
├─ Plan 01           ├─ Plan 03           ├─ Plan 05
└─ Plan 02    →      └─ Plan 04    →      (Checkout)
(User, Product)      (Orders, Cart)
  • Dentro de cada wave, los planes se ejecutan en paralelo
  • Las waves se ejecutan secuencialmente (Wave 2 espera a Wave 1)
  • Cada plan en una wave no depende de los otros de la misma wave

Contexto fresco por tarea

La innovacion clave: cada tarea recibe un contexto limpio de 200k tokens.

El contexto del orquestador principal se mantiene al 30-40% de utilizacion. El trabajo pesado ocurre en subagentes con contextos frescos. Esto elimina el context rot.

Lo que recibe cada subagente:

PROJECT.md (vision)
+ PLAN.md (instrucciones XML de la tarea)
+ Archivos relevantes del codebase
= Contexto limpio y enfocado

Lo que no recibe:

  • Historial de conversacion acumulado
  • Resultados de tareas anteriores
  • Contexto de otras fases

Commits atomicos

Cada tarea completada genera un commit inmediato:

abc123f docs(08-02): complete user registration plan
def456g feat(08-02): add email confirmation flow
hij789k feat(08-02): implement password hashing
lmn012o feat(08-02): create registration endpoint

Beneficios

  • git bisect: encuentra la tarea exacta que rompio algo
  • Revertible: deshace una tarea sin afectar las demas
  • Trazable: cada commit se asocia a un plan especifico
  • Historial limpio: futuras sesiones de Claude entienden que se hizo

Archivos generados

ArchivoContenido
{phase_num}-{N}-SUMMARY.mdQue cambio en cada plan
{phase_num}-VERIFICATION.mdResultado de verificacion por plan

SUMMARY.md

Registra lo que se implemento:

# Plan 02-01 Summary

## Changes
- Created src/app/api/auth/login/route.ts
- Added JWT utility in src/lib/jwt.ts
- Updated schema in prisma/schema.prisma

## Verification
✅ POST /api/auth/login returns 200 + Set-Cookie
✅ Invalid credentials return 401
✅ Missing fields return 400

Error durante ejecucion

Si una tarea falla:

  1. El subagente reporta el error al orquestador
  2. El orquestador registra el fallo en VERIFICATION.md
  3. Las tareas independientes en la misma wave continuan
  4. Las tareas dependientes en waves posteriores se pausan
  5. Puedes corregir y re-ejecutar la tarea fallida

Resumen

  • /gsd:execute-phase N implementa planes en waves paralelas
  • Cada tarea recibe contexto fresco de 200k tokens (sin basura)
  • El orquestador se mantiene al 30-40% de contexto
  • Commits atomicos por tarea: trazables, revertibles, bisectable
  • SUMMARY.md documenta que cambio en cada plan
  • Tareas fallidas no bloquean tareas independientes

← Fase Plan | Indice | Siguiente: Fase Verify →