6cfa0c55d2
Removes kilo, kimi, kimi-code, copilot, windsurf, augment, trae, qwen, hermes, cline, codebuddy and pi end to end: capability descriptors, installer branches and converters (bin/install.js 14.9k -> 11.2k lines), TypeScript converters, hook surfaces and runtime homes, review lanes qwen/kimi-code, the two pi migrations, Kimi payload normalization in the hook guards, dead hostBehaviors vocabulary, launcher home probes, fixtures, runtime-specific tests and the prose that presented them as supported. Installer output for the six kept runtimes is byte-identical to before the prune. The Kimi tool-vocabulary tests in workflow-guard, read-guard and read-injection-scanner are left in place pending a decision.
127 lines
6.2 KiB
Markdown
127 lines
6.2 KiB
Markdown
<div align="center">
|
|
|
|
# MSD Core
|
|
|
|
**Make Software Done.**
|
|
|
|
[English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
|
|
|
|
**Um sistema leve de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificações para Claude Code, OpenCode, Antigravity CLI, Codex, Cursor e muito mais.**
|
|
|
|
[](https://www.npmjs.com/package/@golem15/msd-core)
|
|
[](https://www.npmjs.com/package/@golem15/msd-core)
|
|
[](https://github.com/open-gsd/gsd-core/actions/workflows/test.yml)
|
|
[](https://discord.gg/mYgfVNfA2r)
|
|
[](https://git.golem15.com/golem15/msd-core)
|
|
[](LICENSE)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## O que é o MSD Core
|
|
|
|
MSD Core é um framework de engenharia de contexto e desenvolvimento orientado a especificações que conduz agentes de codificação com IA (Claude Code, Codex, Antigravity CLI, Cursor e mais) por meio de um ciclo de fases disciplinado. Ele resolve o [context rot](docs/pt-BR/explanation/context-engineering.md) — 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:
|
|
|
|
1. **Discuss** — capturar decisões de implementação antes de qualquer planejamento
|
|
2. **Plan** — pesquisar, decompor e verificar se o plano cabe em uma janela de contexto limpa
|
|
3. **Execute** — executar planos em ondas paralelas; cada executor começa com um contexto limpo de 200k tokens
|
|
4. **Verify** — percorrer o que foi construído; diagnosticar e corrigir antes de declarar conclusão
|
|
5. **Ship** — criar o PR, arquivar a fase e repetir para a próxima
|
|
|
|
---
|
|
|
|
## Início rápido
|
|
|
|
```bash
|
|
npx @golem15/msd-core@latest
|
|
```
|
|
|
|
O instalador solicita seu ambiente de execução (Claude Code, OpenCode, Antigravity CLI, Codex, Cursor 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](docs/pt-BR/how-to/install-on-your-runtime.md).
|
|
|
|
Após a instalação, inicie um projeto novo ou integre um repositório existente:
|
|
|
|
```bash
|
|
/msd-new-project # projeto greenfield
|
|
/msd-onboard # base de código existente
|
|
```
|
|
|
|
É a primeira vez? Siga [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md) 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](docs/pt-BR/tutorials/onboarding-an-existing-codebase.md).
|
|
|
|
---
|
|
|
|
## Documentação
|
|
|
|
**Tutoriais** — aprendendo na prática:
|
|
- [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md)
|
|
- [Integrar uma base de código existente](docs/pt-BR/tutorials/onboarding-an-existing-codebase.md)
|
|
|
|
**Guias práticos** — receitas orientadas a tarefas:
|
|
- [Instalar no seu runtime](docs/pt-BR/how-to/install-on-your-runtime.md)
|
|
- [Planejar uma fase](docs/pt-BR/how-to/plan-a-phase.md)
|
|
- [Verificar e entregar](docs/pt-BR/how-to/verify-and-ship.md)
|
|
- … [ver todos os guias práticos](docs/pt-BR/README.md#how-to-guides)
|
|
|
|
**Referência** — informações autoritativas:
|
|
- [Comandos](docs/pt-BR/COMMANDS.md)
|
|
- [Configuração](docs/pt-BR/CONFIGURATION.md)
|
|
- [Ferramentas CLI](docs/pt-BR/CLI-TOOLS.md)
|
|
|
|
**Explicação** — conceitos e decisões de design:
|
|
- [Engenharia de contexto](docs/pt-BR/explanation/context-engineering.md)
|
|
- [O ciclo de fases](docs/pt-BR/explanation/the-phase-loop.md)
|
|
- [Arquitetura](docs/pt-BR/ARCHITECTURE.md)
|
|
|
|
Índice completo: [docs/pt-BR/README.md](docs/pt-BR/README.md). Outros idiomas: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md).
|
|
|
|
---
|
|
|
|
## 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 MSD 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](docs/pt-BR/explanation/context-engineering.md) para o raciocínio completo.
|
|
|
|
Problemas? Consulte [docs/pt-BR/how-to/recover-and-troubleshoot.md](docs/pt-BR/how-to/recover-and-troubleshoot.md).
|
|
|
|
---
|
|
|
|
## Comunidade
|
|
|
|
| Projeto | Plataforma |
|
|
|---------|----------|
|
|
| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | Port original para OpenCode |
|
|
| [Discord](https://discord.gg/mYgfVNfA2r) | Suporte da comunidade |
|
|
|
|
---
|
|
|
|
## Histórico de estrelas
|
|
|
|
<a href="https://star-history.com/#golem15/msd-core&Date">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=golem15/msd-core&type=Date&theme=dark" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=golem15/msd-core&type=Date" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=golem15/msd-core&type=Date" />
|
|
</picture>
|
|
</a>
|
|
|
|
---
|
|
|
|
## Licença
|
|
|
|
Licença MIT. Consulte [LICENSE](LICENSE) para detalhes.
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
**Claude Code é poderoso. MSD Core o torna confiável.**
|
|
|
|
</div>
|