Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
1.7 KiB
1.7 KiB
Especificação: Design de Multi-Project Workspaces (pt-BR)
Data original: 2026-03-20
Fonte canônica: docs/superpowers/specs/2026-03-20-multi-project-workspaces-design.md
Problema
Times e desenvolvedores frequentemente precisam trabalhar em múltiplos repositórios/áreas em paralelo, mantendo isolamento de estado de planejamento sem perder fluidez operacional.
Proposta
Introduzir workspaces multi-projeto com:
- isolamento de
.planning/por workspace - suporte a múltiplos repositórios (worktree/clone)
- comandos para criação, listagem e remoção
Objetivos de design
- isolamento forte de estado
- operação simples via comandos (
new/list/remove workspace) - baixo acoplamento com o workflow padrão
- fácil observabilidade do que está ativo
Modelo conceitual
- Workspace: unidade isolada de execução MSD
- Member repos: repositórios associados ao workspace
- Manifest: arquivo de metadados com estrutura e status
Fluxo de uso
- Criar workspace com nome e repositórios alvo
- Inicializar/retomar fluxo MSD dentro do workspace
- Operar fases normalmente com estado isolado
- Finalizar e remover quando concluído
Considerações
- comandos devem deixar explícito o contexto atual
- limpeza precisa remover artefatos derivados com segurança
- comportamento deve ser previsível em ambientes monorepo
Critérios de aceitação
- workspaces independentes não colidem estado
- listagem mostra workspace ativo e metadados essenciais
- remoção limpa artefatos sem afetar repositórios externos
Note
Esta versão em Português resume a especificação de design para uso prático. O arquivo original em inglês mantém o detalhamento normativo completo.