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.5 KiB
Como isolar trabalho com workspaces
Objetivo: Criar um ambiente GSD completamente isolado — worktree git separado, raiz .planning/ independente e, opcionalmente, múltiplos repositórios — para branches de funcionalidades ou trabalho em múltiplos repositórios.
Pré-requisitos: O git está instalado e o repositório oferece suporte a worktrees. Para workspaces com múltiplos repositórios, os repositórios de destino existem em sua máquina local ou são acessíveis por caminho.
O que são workspaces
Um workspace é um ambiente autocontido que combina um ou mais worktrees git (ou clones) com seu próprio diretório raiz .planning/. Cada workspace possui:
- Seu próprio diretório
.planning/que é completamente independente do.planning/do repositório de origem — não é um subdiretório dele - Seu próprio manifesto
WORKSPACE.mdque rastreia os repositórios membros - Worktrees git (padrão) ou clones completos dos repositórios especificados, com checkout em uma branch dedicada (padrão:
workspace/<nome>)
Por padrão, os workspaces ficam em ~/gsd-workspaces/<nome>/.
~/gsd-workspaces/
└── feature-b/
├── WORKSPACE.md ← manifesto
├── .planning/ ← estado GSD totalmente independente
│ ├── PROJECT.md
│ ├── ROADMAP.md
│ └── ...
├── hr-ui/ ← worktree ou clone do repositório hr-ui
└── ZeymoAPI/ ← worktree ou clone do repositório ZeymoAPI
Como o .planning/ do workspace é separado dos repositórios de origem, não há sobreposição ou conflito com o estado de planejamento existente nos próprios repositórios de origem.
Criar um workspace para múltiplos repositórios
/gsd-workspace --new --name feature-b --repos hr-ui,ZeymoAPI
O GSD cria worktrees de hr-ui e ZeymoAPI dentro de ~/gsd-workspaces/feature-b/, faz checkout de uma branch workspace/feature-b em cada um, grava o WORKSPACE.md e cria um diretório .planning/ vazio pronto para /gsd-new-project.
Para personalizar o local:
/gsd-workspace --new --name feature-b --repos hr-ui,ZeymoAPI --path /projects/feature-b
Criar um workspace para o repositório atual
Quando você deseja isolamento por branch de funcionalidade em um único repositório — branch independente, .planning/ independente, sem vazamento de estado da branch principal:
/gsd-workspace --new --name payments-rework --repos .
O . instrui o GSD a criar um worktree do repositório atual. O worktree recebe checkout em workspace/payments-rework.
Para forçar um clone completo em vez de um worktree:
/gsd-workspace --new --name payments-rework --repos . --strategy clone
Especificar uma branch explicitamente
/gsd-workspace --new --name payments-rework --repos . --branch feature/payments-v2
O flag --branch define o nome da branch para todos os repositórios do workspace. O padrão é workspace/<nome>.
Ignorar perguntas interativas
/gsd-workspace --new --name payments-rework --repos . --auto
O GSD aceita todos os padrões sem solicitar confirmação.
Inicializar o GSD dentro do workspace
Após criar um workspace, acesse-o e inicialize um projeto GSD:
cd ~/gsd-workspaces/feature-b
/gsd-new-project
O diretório .planning/ dentro do workspace é a raiz para todos os comandos GSD subsequentes executados a partir desse diretório. Ele é completamente separado de qualquer .planning/ existente nos repositórios de origem.
Listar workspaces
/gsd-workspace --list
Exibe todos os workspaces GSD ativos e seus status.
Remover um workspace
/gsd-workspace --remove feature-b
O GSD remove os worktrees git e limpa o diretório do workspace. Isso não exclui as branches do remote de origem — apenas os worktrees locais e o diretório do workspace.
Quando usar workspaces em vez de workstreams
Escolha workspaces quando:
- Você está trabalhando em múltiplos repositórios que precisam ser coordenados sob um único projeto GSD (por exemplo, um repositório de API e um repositório de UI que fazem entregas juntos)
- Você precisa de um worktree git separado com sua própria branch, arquivos de lock e artefatos de build por funcionalidade — para que builds e instalações de dependências em um ambiente não afetem outro
- Você deseja uma raiz
.planning/completamente independente em vez de um subdiretório do.planning/do repositório principal - Você está seguindo um fluxo de trabalho orientado a issues em que cada issue do rastreador é mapeada para um workspace (consulte Conduzir o GSD a partir de uma issue do rastreador)
Escolha workstreams quando:
- Todo o trabalho está em um único repositório e compartilha o mesmo histórico git
- Você deseja executar
/gsd-plan-phaseou/gsd-discuss-phaseem diferentes áreas de interesse simultaneamente — API, UI, infra — sem vazamento de contexto entre os arquivosSTATE.md - Você não precisa de um worktree separado por área de interesse; alternar o contexto de planejamento é suficiente