feat: ICM universal skill + PDF resumo (PT-BR)

- 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)
This commit is contained in:
hermes
2026-08-09 20:45:07 -03:00
commit a6593cebac
3 changed files with 644 additions and 0 deletions
+43
View File
@@ -0,0 +1,43 @@
# 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.