Files
msd-core/docs/pt-BR/superpowers/specs/2026-03-20-multi-project-workspaces-design.md
Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)
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.
2026-10-06 01:47:40 +02:00

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

  1. Criar workspace com nome e repositórios alvo
  2. Inicializar/retomar fluxo MSD dentro do workspace
  3. Operar fases normalmente com estado isolado
  4. 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.