hermes
a6593cebac
- SKILL.md: skill model-agnostic (AGENTS.md), 10 invariants, 5 forms, Build/Restructure modes - docs/icm_resumo.pdf: resumo de 11 páginas em português - README.md: visão geral e instruções de uso Adaptado de RinDig/icm-architect (MIT) e Van Clief & McDermott (arXiv:2603.16021)
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# ICM Universal
|
|
|
|
Skill universal de **ICM (Interpretable Context Methodology)** — estrutura de pastas como arquitetura de agentes.
|
|
|
|
Funciona com **qualquer coding agent** que leia `AGENTS.md` (OpenCode, Cursor, Windsurf, Codex, Hermes).
|
|
|
|
## O que é ICM?
|
|
|
|
ICM substitui código de orquestração por estrutura de pastas. Pastas numeradas carregam sequenciamento, hierarquia carrega escopo de contexto, arquivos markdown carregam estado. Um agente, lendo os arquivos certos no momento certo, faz o trabalho de um multi-agent framework.
|
|
|
|
- 📄 **Paper:** [arXiv:2603.16021](https://arxiv.org/abs/2603.16021) — Van Clief & McDermott
|
|
- 🔧 **Skill original:** [RinDig/icm-architect](https://github.com/RinDig/icm-architect)
|
|
- 📖 **Resumo PDF:** [docs/icm_resumo.pdf](docs/icm_resumo.pdf) (11 páginas, PT-BR)
|
|
|
|
## Estrutura
|
|
|
|
```
|
|
icm-universal/
|
|
├── SKILL.md # A skill universal (AGENTS.md-native)
|
|
├── docs/
|
|
│ └── icm_resumo.pdf # Resumo completo em português
|
|
└── README.md
|
|
```
|
|
|
|
## Como usar com OpenCode
|
|
|
|
1. Copie `SKILL.md` para a pasta de skills do OpenCode
|
|
2. Peça: "ICM this" ou "cria um workspace ICM para X"
|
|
3. O agente vai guiar você pelo Build mode (extrair estrutura do diálogo → escolher forma → scaffold → contratos → walk test)
|
|
|
|
## 5 Formas
|
|
|
|
| Forma | Quando usar |
|
|
|-------|-------------|
|
|
| **Pipeline** | Mesma sequência roda repetidamente, produzindo um entregável |
|
|
| **Umbrella** | Vários pipelines compartilhando uma camada de referência |
|
|
| **Record Library** | Unidade é um registro (pessoa, cliente, sessão) que acumula |
|
|
| **Knowledge Bundle** | O produto é conhecimento navegável (cérebro, wiki) |
|
|
| **Context Map** | O assunto é uma organização (times, processos, dados) |
|
|
|
|
## Licença
|
|
|
|
MIT — mesmo do protocolo ICM original.
|