O GSD oferece dois mecanismos de paralelização de trabalho: workspaces para isolamento completo por feature ou repo, e workstreams para áreas paralelas dentro de um mesmo projeto.
Um workspace cria um diretório isolado com cópias dos repos selecionados e um diretório .planning/ independente. Ideal para trabalhar em uma feature que toca múltiplos repos sem contaminar o estado de outros trabalhos em andamento.
Criando e gerenciando workspaces
# Feature que toca múltiplos repos
/gsd:new-workspace --name feature-auth --repos hr-ui,ZeymoAPI
# Isolamento no repo atual (worktree)
/gsd:new-workspace --name feature-b --repos . --strategy worktree
# Clones completos (mais isolamento, mais espaço)
/gsd:new-workspace --name spike --repos api,web --strategy clone
# Listar workspaces ativos
/gsd:list-workspaces
# Remover (exige confirmação + sem mudanças não commitadas)
/gsd:remove-workspace feature-auth| Flag | Descrição | Default |
|---|---|---|
| --name | Nome do workspace (obrigatório) | — |
| --repos | Paths ou nomes separados por vírgula (use . para repo atual) | — |
| --path | Diretório destino | ~/gsd-workspaces/nome |
| --strategy | worktree (default) ou clone | worktree |
| --branch | Branch a fazer checkout | workspace/nome |
| --auto | Pular perguntas interativas | false |
strategy: worktree (recomendado)
Git worktrees compartilham o histórico do repo original. Mais rápido, menos espaço em disco. Ideal para a maioria dos casos.
strategy: clone
Cópias independentes completas. Maior isolamento, maior uso de disco. Use para spikes onde você pode querer descartar tudo.
Workstreams permitem trabalhar em áreas paralelas do mesmo milestone — por exemplo, backend e frontend ao mesmo tempo — com estado GSD independente por área, mas dentro do mesmo repositório.
Gerenciamento de workstreams
/gsd:workstreams # Listar todos
/gsd:workstreams create backend-api # Criar workstream
/gsd:workstreams switch backend-api # Tornar ativo
/gsd:workstreams status backend-api # Status detalhado
/gsd:workstreams progress # Visão geral cruzada
/gsd:workstreams complete backend-api # Arquivar concluído
/gsd:workstreams resume backend-api # Retomar trabalho/gsd:new-workspace.
/gsd:workstreams.
Análise de dependências antes de paralelizar
Antes de usar workstreams ou o /gsd:manager, rode a análise de dependências para evitar conflitos de merge:
/gsd:analyze-dependencies
# → sugere "Depends on" para fases com overlap de arquivos
# → evita conflitos quando múltiplos agentes editam os mesmos arquivosO /gsd:manager é o dashboard interativo para power users que querem paralelizar trabalho em múltiplas fases a partir de um único terminal.
Dashboard visual de todas as fases
Status atual, fases bloqueadas por dependência, fases prontas para execução
Recomendações automáticas
Sugere ações ótimas baseado em dependências e progresso atual
Despacha trabalho em paralelo
discuss roda inline; plan/execute rodam como agentes em background
Fluxo típico com /gsd:manager
# 1. Analisar dependências antes
/gsd:analyze-dependencies
# 2. Abrir central de comando
/gsd:manager
# 3. O manager exibe dashboard e permite:
# - Selecionar múltiplas fases para planejamento paralelo
# - Monitorar progresso em tempo real
# - Despachar execução quando planos estiverem prontosPré-requisito importante
Execute /gsd:analyze-dependencies antes de usar o manager em projetos onde as fases têm campos Depends on vazios no ROADMAP.md. Sem isso, o manager pode despachar fases conflitantes em paralelo causando merge conflicts.