12ee75a509
Some checks failed
Tests / PR mergeability (push) Successful in 1m37s
Tests / Base branch health (push) Successful in 11s
Tests / Detect test scope (push) Successful in 17s
Tests / lint-tests (push) Failing after 2m16s
Tests / plugin-validate (push) Successful in 1m6s
Tests / test (ubuntu-latest, 24, shard 1/3) (push) Failing after 25s
Tests / test (ubuntu-latest, 24, shard 2/3) (push) Failing after 20s
Tests / test (ubuntu-latest, 24, shard 3/3) (push) Failing after 20s
Tests / test (ubuntu-latest, 24) (push) Failing after 19s
Tests / test (inert CI) (push) Has been skipped
Tests / QA loop walk (smell ratchet) (push) Failing after 19s
Tests / Coverage gate (merged shards) (push) Has been skipped
Tests / Publish emitted-baseline artifact (push) Has been skipped
Dismiss Unauthorized PR Approvals / dismiss-unauthorized-approval (push) Successful in 9s
Close Draft PRs (sweep) / Sweep open draft PRs (push) Successful in 8s
Tests / conformance test (macos-latest, 24) (push) Has been cancelled
Tests / conformance test (windows-latest, 24, shard 1/3) (push) Has been cancelled
Tests / conformance test (windows-latest, 24, shard 2/3) (push) Has been cancelled
Tests / conformance test (windows-latest, 24, shard 3/3) (push) Has been cancelled
Tests / Required tests (push) Has been cancelled
The fork lives on the golem15 Gitea forge, not GitHub. Package identity now parses either host and derives in-place raw URLs for Gitea; the identity-drift lint accepts the new host; README drops GitHub-only badges and the npm quickstart in favour of the checkout installer.
127 lines
6.3 KiB
Markdown
127 lines
6.3 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, Kimi CLI, Kilo, Codex, Copilot, Cursor, Windsurf 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, Kimi CLI, Copilot, 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, Kimi 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](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>
|