Files

Tom Boucher eb365f7336 docs: audit and update docs/ for v1.40.0 release (#3048 )

* 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

2026-05-03 07:33:27 -04:00

3.8 KiB

Raw Blame History

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.

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

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

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

3.8 KiB Raw Blame History