Os dois primeiros passos do ciclo GSD: capturar suas decisões de implementação antes que o plano seja criado, e gerar planos atômicos com pesquisa de domínio e verificação.
O discuss-phase captura suas preferências de implementação antes do planejamento. É a etapa onde você define decisões técnicas, escolhas de biblioteca e abordagens — para que o planer não precise adivinhar.
SINTAXE
/gsd:discuss-phase [N]
/gsd:discuss-phase 1 # Fase 1, modo interativo
/gsd:discuss-phase 3 --auto # Fase 3, seleciona defaults automaticamente
/gsd:discuss-phase --batch # Agrupa perguntas em batch
/gsd:discuss-phase 2 --analyze # Com análise de trade-offs{fase}-CONTEXT.md— suas decisões capturadas em documento estruturado{fase}-DISCUSSION-LOG.md— trilha de auditoria das decisões tomadasModo discuss (padrão)
Faz perguntas uma a uma sobre decisões de implementação. Bom para quem ainda está pensando nas escolhas.
Modo assumptions
Lê o código existente, gera suposições com níveis de confiança e pede apenas que você corrija o que está errado. Configure em workflow.discuss_mode.
Se seu PROJECT.md e REQUIREMENTS.md já capturam todas as preferências, configure workflow.skip_discuss: true. O GSD criará um CONTEXT.md mínimo automaticamente.
O plan-phase é o coração do GSD. Ele pesquisa o domínio, cria 2-3 planos atômicos em XML e verifica se os planos vão realmente atingir o objetivo da fase antes de deixar você executar.
SINTAXE
/gsd:plan-phase [N]
/gsd:plan-phase 1 # Pesquisa + plano + verificação
/gsd:plan-phase 3 --skip-research # Plano sem pesquisa (domínio familiar)
/gsd:plan-phase --auto # Sem confirmações interativas
/gsd:plan-phase --gaps # Modo lacunas (lê VERIFICATION.md){fase}-RESEARCH.md— pesquisa de domínio consolidada dos 4 agentes{fase}-{N}-PLAN.md— planos atômicos em XML (2-3 por fase){fase}-VALIDATION.md— resultado da verificação pelo plan-checkerCada plano usa XML estruturado para máxima clareza:
<task type="auto">
<name>Create login endpoint</name>
<files>src/app/api/auth/login/route.ts</files>
<action>
Use jose for JWT (not jsonwebtoken - CommonJS issues).
Validate credentials against users table.
Return httpOnly cookie on success.
</action>
<verify>curl -X POST localhost:3000/api/auth/login returns 200</verify>
<done>Valid credentials return cookie, invalid return 401</done>
</task>
Antes de liberar os planos para execução, o gsd-plan-checker verifica em 8 dimensões se os planos vão realmente atingir os objetivos da fase. Até 3 iterações de refinamento.
| # | Dimensão Verificada |
|---|---|
| 1 | Cobertura de requisitos (todos os REQs mapeados?) |
| 2 | Atomicidade das tarefas (cada plano cabe em uma janela de contexto?) |
| 3 | Ordenamento de dependências (onda correta?) |
| 4 | Escopo de arquivos (sem surpresas de escopo?) |
| 5 | Comandos de verificação (há como confirmar que funcionou?) |
| 6 | Fit de contexto (cada plano cabe num contexto fresco?) |
| 7 | Detecção de lacunas (algo foi esquecido?) |
| 8 | Conformidade Nyquist (cobertura de testes mapeada?) |
Para workflows mais rápidos, você pode encadear discuss → plan → execute em sequência automática usando a flag --chain ou configurar workflow.auto_advance: true.
# Encadear discuss → plan → execute automaticamente
/gsd:discuss-phase 1 --chain
# Ou usar /gsd:next para avançar um passo de cada vez
/gsd:next