3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
5.4 KiB
Como trabalhar em múltiplas áreas em paralelo com workstreams
Objetivo: Executar trabalho simultâneo em diferentes áreas de um milestone — API backend, painel frontend, infraestrutura ou qualquer outra preocupação — sem que o estado de planejamento de uma área vaze para outra.
Pré-requisitos: Um projeto GSD Core ativo (.planning/ROADMAP.md existe). Se não existir, execute /gsd-new-project primeiro.
O que são workstreams
Um workstream é um contexto de planejamento isolado dentro de um único repositório de código. Cada workstream possui seu próprio subárvore .planning/workstreams/<name>/ contendo diretórios independentes STATE.md, ROADMAP.md, REQUIREMENTS.md e phases/. O próprio repositório — código-fonte, histórico git e branches — é compartilhado entre todos os workstreams.
.planning/
├── PROJECT.md ← compartilhado
├── config.json ← compartilhado
├── codebase/ ← compartilhado
└── workstreams/
├── backend-api/
│ ├── STATE.md
│ ├── ROADMAP.md
│ ├── REQUIREMENTS.md
│ └── phases/
└── frontend-dash/
├── STATE.md
├── ROADMAP.md
├── REQUIREMENTS.md
└── phases/
Quando um workstream está ativo, todos os comandos GSD — /gsd-progress, /gsd-discuss-phase, /gsd-plan-phase, /gsd-execute-phase — leem e escrevem no diretório desse workstream. Alternar workstreams redireciona todos esses comandos para uma subárvore diferente sem tocar na árvore de código-fonte.
Criar um workstream
/gsd-workstreams create backend-api
O GSD cria o diretório do workstream em .planning/workstreams/backend-api/ e o inicializa com um STATE.md e ROADMAP.md esqueleto. O workstream não é ativado automaticamente — você precisa alternar para ele explicitamente.
Listar workstreams
/gsd-workstreams list
Exibe todos os workstreams e qual está atualmente ativo na sua sessão.
Alternar para um workstream
/gsd-workstreams switch backend-api
A partir deste ponto, todos os comandos de fluxo de trabalho GSD operam no contexto backend-api. A alternância é vinculada à sessão: quando múltiplos terminais do Claude Code estão abertos no mesmo repositório, cada sessão pode ter um workstream ativo diferente sem interferir nos demais.
Após alternar, execute o fluxo normal de fases:
/gsd-discuss-phase 1
/gsd-plan-phase 1
/gsd-execute-phase 1
/gsd-verify-work 1
Para trabalhar em outra área, alterne workstreams em um segundo terminal:
/gsd-workstreams switch frontend-dash
/gsd-discuss-phase 1
/gsd-plan-phase 1
Verificar o progresso em todos os workstreams
/gsd-workstreams progress
Exibe um resumo entre workstreams — status das fases, posição atual e trabalho pendente para cada workstream — sem exigir que você alterne entre eles.
Para status detalhado de um único workstream:
/gsd-workstreams status backend-api
Retomar o trabalho em um workstream
Após uma redefinição de contexto ou uma nova sessão, restaure sua posição:
/gsd-workstreams resume backend-api
Isso ativa o workstream e restaura sua última posição conhecida dentro dele, equivalente a alternar e então executar /gsd-resume-work.
Arquivar um workstream concluído
Quando o trabalho do milestone de um workstream estiver concluído:
/gsd-workstreams complete backend-api
O GSD marca o workstream como arquivado e o remove da listagem ativa. Os artefatos de planejamento são preservados em .planning/workstreams/backend-api/ para fins de auditoria.
Executar um único comando em um workstream sem alternar
Se você precisar executar um comando em um workstream específico sem alterar o contexto ativo da sua sessão, use a flag --ws:
/gsd-progress --ws frontend-dash
/gsd-plan-phase 2 --ws backend-api
--ws tem a maior prioridade na ordem de resolução e não altera o ponteiro vinculado à sessão.
Quando usar workstreams em vez de workspaces
Escolha workstreams quando:
- Todo o trabalho está no mesmo repositório e compartilha o mesmo histórico git
- Você quer planejar ou discutir diferentes áreas de preocupação (API, UI, infra) de forma simultânea sem que o
STATE.mdde um workstream sobrescreva o de outro - Você não precisa de um branch separado por workstream no momento da criação (embora possa criar branches normalmente dentro da execução de cada workstream)
- O custo de criação de worktrees git completos não é justificado pelo nível de isolamento necessário
Escolha workspaces quando:
- Você está trabalhando em múltiplos repositórios (por exemplo,
hr-uieZeymoAPI) - Você precisa do isolamento de uma worktree ou clone git separado por funcionalidade — branches, arquivos de lock e artefatos de build totalmente independentes
- Você quer executar
/gsd-new-projectindependentemente em cada workspace com uma raiz.planning/completamente separada, não um subdiretório do.planning/do repositório principal