2.2 KiB
Arquitetura do GSD
Visão arquitetural do Get Shit Done (GSD) em Português.
Para detalhes de implementação linha a linha, consulte ARCHITECTURE.md em inglês.
Princípios
- Orquestração leve no contexto principal
- Trabalho pesado em subagentes
- Artefatos persistentes em
.planning/ - Validação contínua por fase
- Rastreabilidade por commits atômicos
Componentes centrais
-
Camada de comando
Recebe entrada do usuário (/gsd-*) e roteia fluxo. -
Camada de orquestração
Coordena pesquisadores, planejadores, executores e verificadores. -
Camada de artefatos
MantémPROJECT.md,REQUIREMENTS.md,ROADMAP.md,STATE.md, planos e sumários. -
Camada de execução
Roda tarefas em ondas, respeitando dependências. -
Camada de validação
Compara entrega contra objetivos, testes e critérios de fase.
Fluxo arquitetural (alto nível)
Entrada (/gsd-comando)
-> Orquestrador
-> Subagentes especializados
-> Artefatos em .planning/
-> Execução em ondas
-> Verificação/UAT
-> Atualização de estado + commits
Estado e persistência
STATE.md: memória operacional da jornadaROADMAP.md: visão de progresso por faseSUMMARY.md: histórico de decisões e resultados por tarefaVALIDATION.md(quando aplicável): contrato de feedback automatizado
Paralelismo
- Planos independentes: mesma onda (execução paralela)
- Planos dependentes: ondas posteriores (execução sequencial)
- Conflitos de arquivo: serialização controlada
Segurança
- validação de caminhos de arquivo
- detecção de prompt injection
- hooks de guarda para escrita/edição sensível
- scanner CI para padrões de risco
Runtimes suportados (v1.32)
Claude Code, Gemini CLI, OpenCode, Kilo, Codex, Copilot, Antigravity, Trae, Cline, Augment Code.
Extensibilidade
GSD suporta evolução por:
- novos comandos
- novos tipos de agente
- novos artefatos por fase
- novos gates de qualidade/segurança
Note
Esta versão foi criada para consulta de arquitetura em Português. A especificação canônica e completa continua no documento em inglês.