O GSD oferece um conjunto completo de ferramentas para capturar ideias, gerenciar backlog, acompanhar progresso e entregar PRs documentados. Nenhuma ferramenta externa necessária.
Durante o desenvolvimento surgem ideias que não cabem na fase atual. O GSD oferece três mecanismos de captura com granularidade diferente: todos persistem no .planning/ e sobrevivem a resets de contexto.
/gsd:add-todo
tarefa estruturadaCaptura uma tarefa com contexto estruturado — prioridade, fase relacionada e descrição. Listado por /gsd:check-todos com opção de trabalhar em uma diretamente.
/gsd:add-todo "Adicionar suporte a dark mode"
/gsd:check-todos # Lista todos e permite selecionar um/gsd:note
captura zero-frictionPara captura ainda mais rápida, sem overhead de estrutura. Notas podem ser promovidas para todos quando necessário.
/gsd:note "Considerar cache para respostas da API"
/gsd:note list # Lista todas as notas
/gsd:note promote 2 # Converte nota 2 em todo estruturado/gsd:plant-seed
ideia futura com contextoPara ideias que só fazem sentido em um momento futuro específico. Seeds preservam o WHY e a condição de ativação — são surfaced automaticamente pelo /gsd:new-milestone.
/gsd:plant-seed "Real-time quando WebSocket estiver na infra"O backlog do GSD usa numeração 999.x — isso mantém itens fora da sequência ativa de fases enquanto ainda permite que sejam planejados e discutidos normalmente.
Fluxo de backlog
/gsd:add-backlog "Camada GraphQL" # Cria fase 999.1
/gsd:add-backlog "Redesign mobile" # Cria fase 999.2
/gsd:review-backlog # Promover, manter ou remover/gsd:add-backlog
Adiciona item com numeração 999.x. Cria diretório de fase imediatamente — pronto para discuss e plan.
/gsd:review-backlog
Revisa cada item: Promover (move para sequência ativa), Manter ou Remover.
/gsd:add-phase
Adiciona fase ao final do roadmap ativo (diferente de backlog — já entra na sequência).
Gerenciamento cirúrgico de fases
/gsd:insert-phase 3Insere fase urgente entre 3 e 4, usando numeração decimal (3.1)/gsd:remove-phase 7Remove fase 7 e renumera 8→7, 9→8 automaticamente/gsd:plan-milestone-gapsCria fases para fechar gaps do audit de milestone/gsd:progress
Onde estou e qual é o próximo passo. Resposta rápida, ideal para retomar contexto.
/gsd:stats
Dashboard de métricas: fases concluídas, tarefas executadas, tempo estimado, cobertura de requirements.
/gsd:session-report
Relatório pós-sessão com work summary, outcomes, estimativa de custo/tokens e próximos passos recomendados.
/gsd:milestone-summary
Resumo completo do milestone para onboarding de equipe: arquitetura, decisões, getting started guide.
Ciclo de Milestone
/gsd:audit-milestone
→
/gsd:complete-milestone
→
/gsd:new-milestone
O new-milestone aceita --reset-phase-numbers para reiniciar numeração de fases em versões major.
O comando /gsd:ship cria um Pull Request completo no GitHub com body auto-gerado a partir dos artefatos de planejamento. Nada de PR vazio ou descrição genérica.
Sintaxe
/gsd:ship 4 # Ship fase 4 (abre PR diretamente)
/gsd:ship 4 --draft # Ship como draft PR para revisão/gsd:pr-branch
Cria uma branch limpa filtrando commits de .planning/. Revisores veem apenas mudanças de código, sem artefatos de planejamento.
/gsd:pr-branch # Contra main
/gsd:pr-branch develop # Contra develop/gsd:review --phase N
Revisão cruzada dos planos por outros CLIs de IA (Gemini, Claude separado, Codex). Resultado alimenta /gsd:plan-phase --reviews.
/gsd:review --phase 3 --all
/gsd:review --phase 2 --gemini