get-shit-done/docs/pt-BR/COMMANDS.md

Referência de Comandos do GSD

Este documento descreve os comandos principais do GSD em Português.
Para detalhes completos de flags avançadas e mudanças recentes, consulte também a versão em inglês.

---

Fluxo Principal

Comando	Finalidade	Quando usar
/gsd-new-project	Inicialização completa: perguntas, pesquisa, requisitos e roadmap	Início de projeto
/gsd-discuss-phase [N]	Captura decisões de implementação (--chain, --power)	Antes do planejamento
/gsd-ui-phase [N]	Gera contrato de UI (UI-SPEC.md)	Fases com frontend
/gsd-plan-phase [N]	Pesquisa + planejamento + verificação	Antes de executar uma fase
/gsd-execute-phase <N>	Executa planos em ondas paralelas	Após planejamento aprovado
/gsd-verify-work [N]	UAT manual com diagnóstico automático	Após execução
/gsd-ship [N]	Cria PR da fase validada	Ao concluir a fase
/gsd-next	Detecta e executa o próximo passo lógico	Qualquer momento
/gsd-fast <texto>	Tarefa curta sem planejamento completo	Ajustes triviais

Navegação e Sessão

Comando	Finalidade
/gsd-progress	Mostra status atual e próximos passos
/gsd-resume-work	Retoma contexto da sessão anterior
/gsd-pause-work	Salva handoff estruturado
/gsd-session-report	Gera resumo da sessão
/gsd-autonomous	Executa todas as fases restantes de forma autônoma (--from N, --to N, --only N)
/gsd-help	Lista comandos e uso
/gsd-update	Atualiza o GSD

Gestão de Fases

Comando	Finalidade
/gsd-add-phase	Adiciona fase no roadmap
/gsd-insert-phase [N]	Insere trabalho urgente entre fases
/gsd-remove-phase [N]	Remove fase futura e reenumera
/gsd-list-phase-assumptions [N]	Mostra abordagem assumida pelo Claude
/gsd-plan-milestone-gaps	Cria fases para fechar lacunas de auditoria

Brownfield e Utilidades

Comando	Finalidade
/gsd-map-codebase	Mapeia base existente antes de novo projeto
/gsd-quick	Tarefas ad-hoc com garantias do GSD
/gsd-debug [desc]	Debug sistemático com estado persistente (--diagnose para modo diagnóstico)
/gsd-analyze-dependencies	Detecta dependências entre fases e sugere Depends on no ROADMAP.md (v1.32)
/gsd-forensics	Diagnóstico de falhas no workflow
/gsd-settings	Configuração de agentes, perfil e toggles
/gsd-set-profile <perfil>	Troca rápida de perfil de modelo

Qualidade de Código

Comando	Finalidade
/gsd-review	Peer review com múltiplas IAs
/gsd-pr-branch	Cria branch limpa sem commits de planejamento
/gsd-audit-uat	Audita dívida de validação/UAT

Backlog e Threads

Comando	Finalidade
/gsd-add-backlog <desc>	Adiciona item no backlog (999.x)
/gsd-review-backlog	Promove, mantém ou remove itens
/gsd-plant-seed <ideia>	Registra ideia com gatilho futuro
/gsd-thread [nome]	Gerencia threads persistentes

Gerenciamento de Estado

Comando	Finalidade
state validate	Detecta drift entre STATE.md e o filesystem real
state sync	Reconstrói STATE.md a partir do estado real no disco
state sync --verify	Dry-run: mostra mudanças propostas sem gravar
state planned-phase --phase N --plans N	Registra transição de estado após plan-phase

node gsd-tools.cjs state validate          # Detectar drift
node gsd-tools.cjs state sync --verify     # Prévia do que sync mudaria
node gsd-tools.cjs state sync              # Reconstruir STATE.md a partir do disco

---

Exemplo rápido

/gsd-new-project
/gsd-discuss-phase 1
/gsd-plan-phase 1
/gsd-execute-phase 1
/gsd-verify-work 1
/gsd-ship 1