Files

Tom Boucher 61d185e654 docs: promote README/branding fixes from next to main (#540 )

* fix(#526): include README assets in package

(cherry picked from commit 9bee1cab7f)

* docs(#528): correct GSD Core tagline punctuation

(cherry picked from commit 09cb6d79b2)

* docs(#530): streamline README brand header

(cherry picked from commit ec8a08f2d2)

* docs(#532): remove README continuity section

(cherry picked from commit 7eaa14f48f)

---------

Co-authored-by: Jeremy McSpadden <jeremy@fluxlabs.net>

2026-05-31 10:48:27 -04:00

2.2 KiB

Raw Blame History

Arquitetura do GSD Core

Visão arquitetural do GSD Core (Git. Ship. Done.) 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ém PROJECT.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 jornada
ROADMAP.md: visão de progresso por fase
SUMMARY.md: histórico de decisões e resultados por tarefa
VALIDATION.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.

2.2 KiB Raw Blame History