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 GSD
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 GSD 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.

1.7 KiB Raw Blame History