# 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](../COMMANDS.md).

---

## 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 |

```bash
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

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