100 lines
3.9 KiB
Markdown
100 lines
3.9 KiB
Markdown
# 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
|
|
```
|