Módulo 2.2

⚡ Execute + Verify

Execução em ondas paralelas com contextos frescos, commits atômicos por tarefa e UAT manual orientado com diagnóstico automático de falhas.

1

⚡ /gsd:execute-phase

O execute-phase executa todos os PLAN.md de uma fase usando agentes paralelos com janelas de contexto frescas. Cada executor recebe exatamente um plano — sem contaminação de contexto entre tarefas.

/gsd:execute-phase 1          # Executa todos os planos da fase 1
/gsd:execute-phase 1 --wave 2 # Executa apenas a onda 2 da fase 1

Ondas de Execução

Planos são agrupados em ondas baseadas em dependências. Planos independentes rodam em paralelo dentro de uma onda; ondas são executadas sequencialmente.

Onda 1 (paralela): [ Plan 1-1, Plan 1-2 ] # sem dependências
Onda 2 (paralela): [ Plan 1-3, Plan 1-4 ] # depende de onda 1
Onda 3 (serial): [ Plan 1-5 ] # depende de onda 2

Commits Atômicos

Cada tarefa gera seu próprio commit git com mensagem descritiva. Isso facilita git bisect, rollback seletivo e rastreabilidade de "quem introduziu o bug".

O que o execute-phase produz

{fase}-{N}-SUMMARY.md— o que foi feito, desvios do plano, decisões tomadas
{fase}-VERIFICATION.md— análise goal-backward: a fase atingiu seus objetivos?
commits git— um por tarefa, rastreável e reversível
2

🔍 /gsd:verify-work

O verify-work é o UAT (User Acceptance Testing) do GSD — validação manual orientada para confirmar que a feature realmente funciona como o usuário espera, não apenas que os testes passam.

/gsd:verify-work 1   # UAT para fase 1 (usa última fase executada se omitido)

O que o verify-work faz

Lê VERIFICATION.md da fase e os objetivos do ROADMAP.md
Guia você por um checklist de testes manuais específicos
Se algo falha, ativa gsd-debugger para diagnóstico sistemático
Gera planos de correção para itens que não passaram

O que o verify-work produz

{fase}-UAT.md— resultado dos testes manuais, itens aprovados e reprovados
planos de fix— gerados automaticamente para itens que falharam
3

🔁 Ciclo Completo

O ciclo completo por fase, do planejamento à entrega:

/gsd:discuss-phase 1    # Captura decisões
/gsd:plan-phase 1       # Pesquisa + planos + verificação
/gsd:execute-phase 1    # Executa em ondas paralelas
/gsd:verify-work 1      # UAT manual
/gsd:ship 1             # Cria PR com body gerado automaticamente

# Repetir para próxima fase:
/gsd:discuss-phase 2
...

# Ou deixar o GSD decidir:
/gsd:next

/gsd:ship — Criar o PR

Após verify-work passar, /gsd:ship N cria um PR com body rico: objetivo da fase, resumo das mudanças, requisitos atendidos e status de verificação. Requer GitHub CLI (gh) instalado e autenticado.

Resumo do Módulo

Próximo módulo:

⚡ 2.3 — Atalhos: next, fast, do