1e6737cd8e
* feat(plan-phase): --research-phase flag absorbs deleted /gsd-research-phase + scrub stale refs (#3042, #3044) #3042 (orphaned research-phase): /gsd-research-phase had a workflow file but no slash-command stub. Rather than restore the orphan, the research- only capability is now a flag on /gsd-plan-phase: /gsd-plan-phase --research-phase <N> When set, the workflow scopes to phase N, runs the research step (Section 5 of the existing plan-phase workflow), then early-exits before the planner/plan-checker/verifier chain. Per RCA against the deleted standalone, the flag adds two modifiers to fully cover the original surface (Option B from the RCA discussion): - --view : print existing RESEARCH.md to stdout, no spawn. Cheapest mode for the correction-without-replanning loop the issue reporter explicitly called out. Errors with a clear hint if RESEARCH.md is missing. - --research : reuse the existing "force re-research" semantics. In research-only mode this skips the existing-RESEARCH.md prompt and re-spawns unconditionally. - Neither flag, RESEARCH.md exists : prompt update/view/skip. Mirrors the deleted standalone's existing-artifact menu (#3042 RCA). #3044 (stale slash-command refs): scrubbed five deleted commands from all user-facing surfaces, including English docs, 4 localized doc sets (ja-JP, ko-KR, zh-CN, pt-BR), workflows, templates, and references. /gsd-check-todos → /gsd-capture --list /gsd-new-workspace → /gsd-workspace --new /gsd-status → /gsd-progress /gsd-plan-milestone-gaps → table rows / orphan sections removed (PR #3038 only scrubbed workflows/agent; missed the docs surfaces this PR covers) /gsd-research-phase → /gsd-plan-phase --research-phase Includes a fix to docs/issue-driven-orchestration.md (PR #3036) which itself referenced /gsd-new-workspace 4 times — self-correction. Removed: - get-shit-done/workflows/research-phase.md (orphan, capability absorbed into --research-phase flag) Tests: - tests/bug-3042-3044-research-flag-and-stale-refs.test.cjs — 46 structural-IR tests across both bugs: - argument-hint advertises --research-phase + --view - workflow parses --research-phase, sets RESEARCH_ONLY, early-exits before planner - --view prints RESEARCH.md without spawning - --research forces refresh in research-only mode - existing-RESEARCH.md prompt path with update/view/skip - workflows/research-phase.md is removed - 5 deleted slash-commands absent from 17 English user-facing surfaces + 16 localized doc surfaces (4 locales × 4 docs each) - replacement command tokens present where deleted ones lived 6950/6950 full suite pass. Lints clean. Closes #3042 Closes #3044 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix: address all 8 CR findings on PR #3045 Major (3): - get-shit-done/workflows/plan-phase.md:344 — added explicit early-exit guard at Section 5.1: "Skip if RESEARCH_ONLY=true". Without it, an LLM could fall through "use existing, skip to step 6" → planner spawn, violating the research-only contract. The guard makes the early-exit unreachable from any non-research-only branch. - get-shit-done/references/continuation-format.md (3 examples) + zh-CN/.../continuation-format.md (3 examples) — pointed to `/gsd-plan-phase --research-phase` but docs/COMMANDS.md didn't document the flag. Added a full --research-phase + --view + --research modifier section to the /gsd-plan-phase flag table in COMMANDS.md so the canonical reference matches the continuation examples. Minor (5): - docs/FEATURES.md:1632 — `/gsd-plan-phase --research-phase` → `/gsd-plan-phase --research-phase <N>` (include required arg). - get-shit-done/templates/README.md:46 — NN-VALIDATION.md producer reverted from `/gsd-plan-phase --research-phase` (Nyquist) to plain `/gsd-plan-phase` (Nyquist). VALIDATION.md is created during normal Nyquist flow, not research-only mode — the bulk replacement was wrong for that line. - get-shit-done/workflows/help.md:89 — signature line was missing `--research`; added it alongside `--research-phase` and `--view`. - tests/bug-3042-3044-...:197 — promptHasView/promptHasSkip were tautological (matched anywhere in 1700-line workflow). Tightened to a proximity check anchored on "RESEARCH.md already exists" prompt header within a 600-char window. Updated workflow to emit that literal phrase. - tests/feat-2840-...:95 — workspace assertion used `/gsd-workspace` but the documented replacement is `/gsd-workspace --new`. Tightened to require both tokens (in 3 places: requiredCommands list, regex in conceptPairs, error message). 6950/6950 full suite pass. Lint clean. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
99 lines
3.8 KiB
Markdown
99 lines
3.8 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 |
|
|
|
|
## 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
|
|
```
|