Izanagi AI

Framework meta: Adaptive Agent & Skill Runtime: para engenharia de software autônoma orientada a agentes: routing → orquestração → avaliação → healing → memória, com 22 agentes especializados, 106 skills, execution graph, evaluation engine, self-healing e CLI executável publicada no npm (izanagi-ai).

Filosofia: Arquitetura primeiro. Código depois. Qualidade medida. Evolução contínua. Zero "cara de IA".

Instalação

npm install -g izanagi-ai    # instalação global
npx izanagi <comando>        # ou execução direta sem instalar
izanagi --version

O pacote é publicado como izanagi-ai; bins: izanagi e izanagi-ai.

Comandos Principais da CLI

| Comando | Descrição | |---|---| | izanagi init [dir] [--packs a,b,c] | Cria projeto com .agents/ e seleção de packs de skills. | | izanagi run [agent] --task "<task>" | Analisa a tarefa, seleciona o agente ideal e executa via Adaptive Runtime (graph + adaptive routing + evaluation + trace + self-healing + memory): caminho único, sem modo estático paralelo. --prompt-only só compila izanagi-prompt.md para colar manualmente em outra ferramenta, sem executar nada. | | izanagi agent create "<requisito>" [--name=slug] [--skills=a,b] | Agent Factory: gera agente com genome completo em agents/generated/ (detecta lacuna vs. 22 core). | | izanagi agent list \| inspect <name> | Lista/inspeta agentes (inclui agents/generated/) com genome. | | izanagi skill create <nome> --gap="<descrição>" [--force] | Skill Factory: cria skill com frontmatter, security scan pré-escrita e recusa de lacuna já coberta. | | izanagi skill list \| search <q> \| inspect <name> | Lista, busca e detalha skills. | | izanagi create <agent\|skill> <name> | Cria scaffold de agente (JSON) ou skill (SKILL.md). | | izanagi compile <agente> [arquivo] | Compila um System Prompt completo do agente + fundação do sistema. | | izanagi workflow list \| inspect <template> | Templates de grafo de execução por categoria (11). | | izanagi eval <file.json> \| --metrics ... \| --report <run-id> | Evaluation Engine: métricas ponderadas + veredito (PASS/.../UNKNOWN). | | izanagi benchmark [compare] | 10 benchmarks builtin + comparação de regressões entre builds. | | izanagi trace [run-id] | Traces de execução (spans, healing, graph, avaliação). | | izanagi memory inspect \| search <q> | Estado da memória de execução e busca em .agents/memoria/. | | izanagi doctor [--deep] | Auditoria de integridade; --deep adiciona security scan das 106 skills. | | izanagi diagnose | Diagnóstico profundo do runtime (state, agent genome, contratos de artifact). | | izanagi resume <run-id> | Retoma execução interrompida (crash) ou pausada a partir do checkpoint: sem replanejar nem reexecutar nós concluídos. | | izanagi approve <run-id> [node-id] | Aprova uma ação de alto risco pausada (nó kind: 'approval') e retoma. | | izanagi reject <run-id> [node-id] [--reason] | Rejeita a ação pausada (o nó falha com o motivo) e retoma: self-healing/abort seguem normalmente. | | izanagi explain <run-id> | Por que o Izanagi decidiu isso: decisões (Decision Journal) + self-healing + veredito, sem chain-of-thought. | | izanagi export --cli <cli> | Regenera adapters multi-CLI (opencode, claude, codex, cursor, copilot, kimi, all). | | izanagi --version | Exibe a versão da CLI. |

Exemplos

izanagi run "Criar uma landing page de um SaaS de analytics"
izanagi run architect --task "Design a microservices architecture"
izanagi run "Deploy em produção" --verbose   # pausa em nós de aprovação (human-in-the-loop)
izanagi approve <run-id>                     # aprova e retoma
izanagi explain <run-id>                     # por que o Izanagi decidiu o que decidiu
izanagi agent create "Especialista em Laravel" --skills=php,api
izanagi skill create rabbitmq-orchestrator --gap="Orquestração de mensageria RabbitMQ"
izanagi workflow inspect fullstack
izanagi eval --metrics correctness=0.9,security=0.8
izanagi benchmark compare
izanagi doctor --deep

Estrutura do Repositório

izanagi-ai/
├── bin/             Executável da CLI (bin/izanagi.js → dist/cli)
├── src/             Runtime real em TypeScript (orchestrator, evaluation, resolver, scanner, factories, tools, tracer, llm, cli)
├── core/            Engines (.md) + skill-resolver.json (aliases → targets + compositions)
├── agents/          22 definições de agentes em JSON (fonte da verdade dos comandos)
├── skills/          106 skills em skills/<name>/SKILL.md (+ references.md opcional)
├── references/      Curadoria de referências reais por domínio (webgl-3d, scrollytelling, stack-2026...)
├── .agents/memoria/ Memória persistente anti-repetição (contexto, decisoes, erros-corrigidos, learnings)
├── .opencode/       Comandos slash do Opencode (adapters em .claude/, .codex/, .cursor/...)
├── AGENTS.md        Instruções de operação do framework
├── SYSTEM.md        Fundação do sistema (arquitetura real do runtime)
└── RULES.md         Regras operacionais (Anti-Generic High-Craft & Cinematic UI)

Agentes e Skills

O framework possui 22 agentes especializados (/discovery, /product-reasoner, /architect, /senior-engineer, /techlead, /automation-engineer, /security, /devops, /database, /qa, /bug-hunter, /docs, /pm, /professor, /researcher, /evaluator, /adversarial-critic, /form-engineer, /animation, /agent-architect, /skill-architect, /ai-engineer) e 106 skills encadeadas por domínio via compositions do core/skill-resolver.json (258 aliases, 16 composições). Ver AGENTS.md para a tabela completa.

Desenvolvimento

npm install       # instala dependências
npm run build     # tsc && regenera .manifest
npm run doctor    # auditoria de integridade
node --test dist/runtime/tests/*.test.js   # 262 testes do runtime
npm run verify    # build + teste de instalação em sandbox

Gotcha: dist/ é gitignored e bin/izanagi.js importa de ../dist/cli/index.js: rode npm run build antes de qualquer comando CLI local.

Publicando no NPM

npm run bump:patch   # ou bump:minor / bump:major
npm publish          # prepublishOnly roda o build automaticamente

Licença

MIT: Use, modifique, distribua. Apenas mantenha os créditos.