eb365f7336
* docs(en): update FEATURES/USER-GUIDE/COMMANDS for v1.40.0 surface - FEATURES.md: append v1.40.0 section (#122 skill consolidation, #123 namespace meta-skills, #124 context-window guard, #125 phase-lifecycle status-line read-side); add to TOC. - USER-GUIDE.md: add slash-command form (hyphen vs colon) primer and namespace routing primer; replace deleted slash forms in walkthroughs (`/gsd-add-backlog`, `/gsd-plant-seed`, `/gsd-add-phase`, `/gsd-set-profile`, `/gsd-list-workspaces`, etc.) with consolidated forms (`/gsd-capture --backlog`, `/gsd-phase --insert`, `/gsd-config --profile`, `/gsd-workspace --list`, etc.); fix `/gsd-spike-wrap-up` and `/gsd-sketch-wrap-up` to flag form. - COMMANDS.md: clarify Command Syntax (Gemini = colon form, others = hyphen form); add Namespace Meta-Skills section with all six routers; add `--context` to /gsd-health flag table. Refs #3047 * docs(en): refresh INVENTORY/CLI-TOOLS/STATE-MD-LIFECYCLE for v1.40.0 - INVENTORY.md: workflow-row "Invoked by" column updated to point at consolidated commands (`/gsd-phase` family, `/gsd-workspace --list`, `/gsd-config --advanced/--integrations/--profile`, `/gsd-sketch --wrap-up`, `/gsd-spike --wrap-up`); CLI-modules row for `secrets.cjs` updated to `/gsd-config --integrations`. Command count and namespace meta-skills section already reflect 65 shipped (= 59 consolidated sub-skills + 6 ns-* routers). - CLI-TOOLS.md: add `validate context` row under Validation Commands with the 60 %/70 % threshold envelope used by `/gsd-health --context`. - STATE-MD-LIFECYCLE.md: flip status header from "proposed" to "shipped in v1.40.0" since `parseStateMd()` and `formatGsdState()` now read and render `active_phase`, `next_action`, `next_phases`, and `progress`. `docs/AGENTS.md` audited and verified clean — `gsd-code-fixer` row already lists the correct `/gsd-code-review --fix` spawner; no deleted-skill references found. `docs/INVENTORY-MANIFEST.json` audited and verified clean — already enumerates the 65 commands (including six ns-* routers) and contains no deleted slash forms. Refs #3047 * docs(en): cleanup ARCHITECTURE/CONFIGURATION for v1.40.0 - ARCHITECTURE.md: split Commands install-target list to call out the Gemini colon form (`/gsd:command-name`) vs hyphen form for every other runtime. Add a new subsection covering two-stage hierarchical routing via the six namespace meta-skills (#2792) and a paired note on the MCP token-budget interaction so readers see the two big per-turn cost levers in one place. - CONFIGURATION.md: rewrite three references to the deleted `/gsd-settings-advanced` and `/gsd-settings-integrations` slash forms to use the consolidated `/gsd-config --advanced` / `/gsd-config --integrations` invocations. Add a new "STATE.md Frontmatter (Phase Lifecycle)" section documenting the four optional fields (`active_phase`, `next_action`, `next_phases`, `progress`) read by the v1.40 status-line, with a pointer to STATE-MD-LIFECYCLE.md for the full reference. `docs/manual-update.md` audited and verified clean — already documents `/gsd-update --reapply` (the consolidated form), no reference to the deleted `/gsd-reapply-patches`. Refs #3047 * docs(i18n): mirror v1.40.0 slash-command rename into ja-JP/ko-KR/zh-CN/pt-BR Mechanical token-level renames only — every reference to a deleted micro-skill slash form is rewritten to the consolidated form on the matching parent skill. No prose was machine-translated; new prose sections (slash-form primer, namespace routing primer, v1.40 feature entries, STATE.md frontmatter) were left for human translator follow-up. Renames applied uniformly across all four trees: /gsd-add-todo, /gsd-add-note, /gsd-add-backlog, /gsd-plant-seed, /gsd-check-todos → /gsd-capture[ --note| --backlog|--seed|--list] /gsd-add-phase, /gsd-insert-phase, /gsd-remove-phase, /gsd-edit-phase → /gsd-phase[ --insert| --remove|--edit] /gsd-new-workspace, /gsd-list-workspaces, /gsd-remove-workspace → /gsd-workspace[ --new| --list|--remove] /gsd-settings-advanced, /gsd-settings-integrations, /gsd-set-profile → /gsd-config[ --advanced| --integrations|--profile] /gsd-sketch-wrap-up → /gsd-sketch --wrap-up /gsd-spike-wrap-up → /gsd-spike --wrap-up /gsd-reapply-patches → /gsd-update --reapply /gsd-code-review-fix → /gsd-code-review --fix /gsd-plan-milestone-gaps → /gsd-audit-milestone Refs #3047 * docs(changelog): regroup [Unreleased] under Feature/Enhancement/Fix Replace the existing Keep-a-Changelog \`Added\` / \`Changed\` / \`Performance\` / \`Removed\` / \`Fixed\` sub-headers in the [Unreleased] block with the issue/PR template taxonomy: Added → Feature Changed / Performance → Enhancement Removed → Enhancement Fixed → Fix Order within the release: Feature → Enhancement → Fix. Every bullet preserved verbatim — only headers and grouping changed; the awkward inline-versioned headers (\`### Added — 1.40.0-rc.1\`, \`### Changed — 1.40.0-rc.1\`, \`### Fixed — 1.40.0-rc.1\`) folded into the same buckets with the \`— 1.40.0-rc.1\` suffix dropped, since the [Unreleased] block IS 1.40.0-rc.1. The [1.39.2] hotfix block called out in #3047's spec does not yet exist in CHANGELOG.md (the previously released hotfix is [1.39.1]), so this commit only regroups [Unreleased]. Older release blocks ([1.39.1] and earlier) are frozen and untouched. Refs #3047 * docs(changeset): add fragment for v1.40.0 doc audit Refs #3047 * docs(en): strip leading / from deleted slash-command tokens in FEATURES REQ-CONSOLIDATE-03 and REQ-CONSOLIDATE-04 listed deleted commands by their `/gsd-foo` form for the historical record. The docs-parity tests in bug-3010, bug-3029-3034, and bug-3042-3044 use the regex `/\/gsd-[a-z0-9][a-z0-9-]*/g` to scan user-facing surfaces for any remaining mention of removed slash forms — they cannot tell prose about a deleted command from a live recommendation. Strip the leading slash from the bare-name references (preserve the historical text otherwise). Tests now require a `/` prefix to match, so `gsd-add-todo` reads identically to a human but no longer trips the parser. Verified locally: 65/65 tests pass across the three docs-parity suites that were red on CI run 25270072600. Refs #3047 * docs(en): fix CR feedback + drop literal /gsd:plan-phase from USER-GUIDE CI: tests/bug-2543-gsd-slash-namespace.test.cjs flagged docs/USER-GUIDE.md:35 for embedding the literal `/gsd:plan-phase` token in the parenthetical Gemini-form example. The test scans every .md under docs/ for `/gsd:<live-cmd>` because non-Gemini surfaces must not advertise the colon form. Replaced the literal example with a prose substitution rule. CR: docs/ARCHITECTURE.md:125 — the namespace meta-skills were listed by file-prefix (`gsd-ns-workflow`) but the invocable frontmatter `name:` is the bare form (`gsd-workflow`). Verified against the six `commands/gsd/ns-*.md` files. Replaced with the canonical names and noted the file/name disagreement in-line. CR: docs/COMMANDS.md:723 — `v1.40` aligned to canonical `v1.40.0`. CR: docs/FEATURES.md:2679 — REQ-CTX-GUARD-02 advertised the wrong invocation (`gsd-tools validate context`). The shipped handler is exposed via `gsd-sdk query validate.context` and requires explicit `--tokens-used <int>` + `--context-window <int>` flags (verified against sdk/src/query/validate.ts:849-882 and get-shit-done/bin/lib/validate-command-router.cjs:19-36). CR: docs/zh-CN/README.md:533 — added `inherit` to the profile-options parenthetical to match the canonical set (verified against model-profiles.cjs:29 `VALID_PROFILES = […MODEL_PROFILES['gsd-planner'], 'inherit']`). Verified locally: 74/74 tests pass across the four docs-parity suites that were red on CI runs 25270072600 and 25270182903. Refs #3047
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-phase` | Adiciona fase no roadmap |
|
|
| `/gsd-phase --insert [N]` | Insere trabalho urgente entre fases |
|
|
| `/gsd-phase --remove [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-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
|
|
```
|