O que icm-runtime faz?
Metodologia de Contexto Interpretável (ICM) — runtime bash + habilidades reutilizáveis de agente de codificação para fluxos de trabalho estruturados de IA em múltiplas etapas.
Visão Geral
O ICM fornece uma estrutura modular para agentes de IA executarem tarefas complexas de desenvolvimento de software de forma sequencial e transparente. Cada habilidade é uma unidade atômica que:
- Executa uma etapa específica do workflow (ex.: análise de requisitos, prototipagem, testes).
- Produz saídas legíveis por humanos em diretórios de contexto.
- Pode ser combinada com outras habilidades via scripts bash simples.
Como Funciona
- Habilidades: Scripts bash autocontidos em
skills/. Cada habilidade possui um propósito único e uma interface clara. - Runtime: O motor
icmgerencia o ciclo de vida das habilidades, passando contexto entre elas via arquivos JSON no sistema de arquivos. - Interpretabilidade: Todas as decisões e dados intermediários são persistidos no diretório
.icm/, permitindo inspeção manual ou por agente.
Instalação
# Clonar o repositório
git clone https://github.com/KakkoiDev/icm-runtime.git
cd icm-runtime
# Instalar globalmente (opcional)
chmod +x icm.sh
sudo ln -s $(pwd)/icm.sh /usr/local/bin/icm
Uso
# Executar um workflow de duas etapas
icm run valida-requisitos ,, prototipa-ui
Habilidades Principais
valida-requisitos: Valida especificações de requisitos.prototipa-ui: Gera esboços de interface.executa-testes: Roda suíte de testes unitários.documenta-api: Produz documentação de API em markdown.
Plataformas Suportadas
- Claude Code: Suporte nativo a scripts bash.
- Cursor: Execução via terminal integrado.
- Codex: Chamadas de shell via sandbox.
Licença
MIT