6.3 KiB
GSD Core
Git. Ship. Done.
English · Português · 简体中文 · 日本語 · 한국어
Um sistema leve de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificações para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e muito mais.
O que é o GSD Core
GSD Core é um framework de engenharia de contexto e desenvolvimento orientado a especificações que conduz agentes de codificação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor e mais) por meio de um ciclo de fases disciplinado. Ele resolve o context rot — a degradação de qualidade que se acumula à medida que uma IA preenche sua janela de contexto — executando todo o trabalho pesado de pesquisa, planejamento e execução em subagentes com contexto limpo, mantendo sua sessão principal enxuta.
Como funciona
Cada marco repete o mesmo ciclo de cinco etapas, uma fase por vez:
- Discuss — capturar decisões de implementação antes de qualquer planejamento
- Plan — pesquisar, decompor e verificar se o plano cabe em uma janela de contexto limpa
- Execute — executar planos em ondas paralelas; cada executor começa com um contexto limpo de 200k tokens
- Verify — percorrer o que foi construído; diagnosticar e corrigir antes de declarar conclusão
- Ship — criar o PR, arquivar a fase e repetir para a próxima
Início rápido
npx @opengsd/gsd-core@latest
O instalador solicita seu ambiente de execução (Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e mais) e se deseja instalar globalmente ou localmente. O instalador é necessário para compatibilidade entre runtimes — não copie arquivos diretamente de agents/ ou commands/.
Em outro runtime ou sem Node.js? Consulte Instalar no seu runtime.
Após a instalação, inicie um projeto novo ou integre um repositório existente:
/gsd-new-project # projeto greenfield
/gsd-onboard # base de código existente
É a primeira vez? Siga Seu primeiro projeto para um passo a passo guiado, desde a instalação até a primeira fase entregue. Para um repositório existente, consulte Integrar uma base de código existente.
Documentação
Tutoriais — aprendendo na prática:
Guias práticos — receitas orientadas a tarefas:
Referência — informações autoritativas:
Explicação — conceitos e decisões de design:
Índice completo: docs/pt-BR/README.md. Outros idiomas: 日本語 · 한국어 · Português · 简体中文.
Por que funciona
A maioria das configurações de codificação com IA falha em escala porque o inchaço de contexto degrada silenciosamente a qualidade da saída, não há memória compartilhada entre sessões e nada verifica se o código realmente funciona. O GSD Core resolve os três problemas: o trabalho pesado é executado em subagentes com contexto limpo, artefatos estruturados como STATE.md e CONTEXT.md sobrevivem às fronteiras de sessão, e a etapa de verificação percorre o que foi construído e gera planos de correção antes de uma fase ser declarada concluída. Consulte docs/pt-BR/explanation/context-engineering.md para o raciocínio completo.
Problemas? Consulte docs/pt-BR/how-to/recover-and-troubleshoot.md.
Comunidade
| Projeto | Plataforma |
|---|---|
| gsd-opencode | Port original para OpenCode |
| Discord | Suporte da comunidade |
Histórico de estrelas
Licença
Licença MIT. Consulte LICENSE para detalhes.
Claude Code é poderoso. GSD Core o torna confiável.