Fase Plan

Ejecutar

/gsd:plan-phase [N]

Con --auto:

/gsd:plan-phase 2 --auto

Que hace internamente

1. Investigacion

Guiada por CONTEXT.md (si existe), investiga:

• Patrones de implementacion para tu stack
• Mejores practicas actuales
• Gotchas y problemas conocidos

Resultado: {phase_num}-RESEARCH.md

2. Creacion de planes

Genera 2-3 planes atomicos con estructura XML precisa:

<task type="auto">
  <name>Create login endpoint</name>
  <files>src/app/api/auth/login/route.ts</files>
  <action>
    Use jose for JWT. Validate credentials against DB.
    Return httpOnly cookie with 24h expiration.
  </action>
  <verify>
    curl -X POST localhost:3000/api/auth/login
    -d '{"email":"[email protected]","password":"test123"}'
    returns 200 + Set-Cookie header
  </verify>
  <done>
    Valid credentials return cookie,
    invalid return 401 with error message
  </done>
</task>

Cada tarea define:

Campo	Proposito
name	Descripcion concisa
files	Archivos afectados
action	Instrucciones precisas de implementacion
verify	Comando o prueba para validar
done	Criterio de aceptacion

3. Verificacion

Un agente verificador revisa cada plan contra:

• REQUIREMENTS.md (cubre los requisitos de la fase?)
• CONTEXT.md (respeta las decisiones?)
• Coherencia entre planes (no hay conflictos?)

Si falla, el planificador corrige y el verificador revisa de nuevo. Este loop continua hasta que todos los planes pasan.

Archivos generados

Archivo	Contenido
{phase_num}-RESEARCH.md	Hallazgos de investigacion
{phase_num}-1-PLAN.md	Primer plan atomico
{phase_num}-2-PLAN.md	Segundo plan atomico
{phase_num}-3-PLAN.md	Tercer plan (si aplica)

Atomicidad de planes

Cada plan es independiente y autocontenido:

• Se puede ejecutar sin los otros
• Tiene sus propios archivos objetivo
• Incluye su propia verificacion
• Genera su propio commit al ejecutarse

Esto permite ejecucion paralela en waves.

Por que XML y no markdown

XML elimina ambiguedad:

• Los campos son explicitos (no hay forma de confundir action con verify)
• El LLM puede parsear la estructura sin interpretar
• Los agentes ejecutores reciben instrucciones precisas
• Menos probabilidad de “alucinaciones creativas”

Ver supuestos antes de planificar

Si quieres ver que asume GSD sobre una fase antes de planificarla:

/gsd:list-phase-assumptions [N]

Esto muestra el enfoque pretendido sin crear planes, dandote oportunidad de ajustar con Discuss.

Resumen

• /gsd:plan-phase N investiga, crea planes XML y los verifica
• Cada plan es atomico: independiente, con verificacion y criterio de aceptacion
• Loop de verificacion: planificador crea → verificador valida → corrige si falla
• XML elimina ambiguedad frente a markdown
• /gsd:list-phase-assumptions para ver el enfoque antes de planificar

---

← Fase Discuss | Indice | Siguiente: Fase Execute →