858c821829
Replace 30 absorbed/deleted standalone command forms with their consolidated flag-based equivalents across 25 files (English + 4 locales + AGENTS/CLI-TOOLS/CONFIGURATION): /gsd-session-report → /gsd-pause-work --report /gsd-list-phase-assumptions → /gsd-discuss-phase --assumptions /gsd-analyze-dependencies → /gsd-manager --analyze-deps /gsd-research-phase → /gsd-plan-phase --research-phase /gsd-plan-milestone-gaps → /gsd-audit-milestone /gsd-code-review-fix → /gsd-code-review --fix /gsd-spike-wrap-up → /gsd-spike --wrap-up /gsd-sketch-wrap-up → /gsd-sketch --wrap-up /gsd-set-profile → /gsd-config --profile /gsd-check-todos → /gsd-capture --list /gsd-add-todo → /gsd-capture /gsd-add-backlog → /gsd-capture --backlog /gsd-plant-seed → /gsd-capture --seed /gsd-note → /gsd-capture --note /gsd-add-phase → /gsd-phase /gsd-insert-phase → /gsd-phase --insert /gsd-edit-phase → /gsd-phase --edit /gsd-remove-phase → /gsd-phase --remove /gsd-new-workspace → /gsd-workspace --new /gsd-list-workspaces → /gsd-workspace --list /gsd-remove-workspace → /gsd-workspace --remove /gsd-sync-skills → /gsd-update --sync /gsd-reapply-patches → /gsd-update --reapply /gsd-scan → /gsd-map-codebase --fast /gsd-intel → /gsd-map-codebase --query /gsd-next → /gsd-progress --next /gsd-do → /gsd-progress --do /gsd-status → /gsd-progress /gsd-join-discord → /gsd-help Skipped: CHANGELOG, RELEASE notes, superpowers/specs (historical) Suite: 6971/6971 pass
99 lines
3.9 KiB
Markdown
99 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-progress --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-pause-work --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-phase` | Adiciona fase no roadmap |
|
|
| `/gsd-phase --insert [N]` | Insere trabalho urgente entre fases |
|
|
| `/gsd-phase --remove [N]` | Remove fase futura e reenumera |
|
|
| `/gsd-discuss-phase --assumptions [N]` | Mostra abordagem assumida pelo Claude |
|
|
|
|
## 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-manager --analyze-deps` | 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-config --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-capture --backlog <desc>` | Adiciona item no backlog (999.x) |
|
|
| `/gsd-review-backlog` | Promove, mantém ou remove itens |
|
|
| `/gsd-capture --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
|
|
```
|