izanagi-ai 2.2.6 → 2.2.7

package/AGENTS.md

@@ -1,100 +1,75 @@
-# AGENTS.md — Izanagi AI
+# AGENTS.md — Izanagi AI Framework Reference
 
-Izanagi AI é um **framework meta** para agentes de IA: instruções (markdown + JSON) que transformam qualquer LLM em um engenheiro de software autônomo, com arquitetura em camadas, skills especializadas, agentes pré-definidos e uma **CLI executável** (`izanagi`).
-
-O repositório combina **conteúdo do framework** (skills, agentes, engines) com o **código-fonte da CLI** (TypeScript → `dist/`).
+> Version 2.2.6
+> Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering
 
 ---
 
-## Arquitetura
-
-- `SYSTEM.md` — Fundação: identidade, princípios, arquitetura em camadas (Decision → Context → Skill → Quality → Reflection → Memory)
-- `RULES.md` — 9 regras operacionais + formato de declaração de skills + regras de comunicação
-- `core/` — 8 engines (decision-engine, context-engine, token-manager, compression-engine, reflection-engine, evolution-engine, quality-gates, planning-engine)
-- `agents/` — 11 agentes pré-definidos como JSONs que compõem skills (inclui o **Animation Engineer**)
-- `skills/INDEX.md` — Registro central de todas as skills. **Qualquer skill nova deve ser registrada aqui**
-- `core/skill-resolver.json` — Mapeia short IDs para paths de skills. **Qualquer skill nova deve ter alias aqui** para ser usada por agentes
-- `.opencode/agent/` — Agentes opencode (ex: `animation.md` → ativado digitando `/animation`) copiados para projetos no `izanagi init`
-- `src/` — Código-fonte da CLI (TypeScript). Build: `npm run build` → `dist/`
-
-## Regras-chave
-
-- **Toda skill precisa de entrada em dois lugares**: `skills/INDEX.md` + `core/skill-resolver.json`
-- **Formato de skill**: YAML header (name, version, priority, dependencies, triggers, token_budget, compatibility) + seções (Identity → Goals → Workflow → Decision Tree → Rules → Checklists → Metrics → Evolution)
-- **Agentes**: JSON com `skills` (array de short IDs), `chains` (mapa de tipo de task → chain de skills), `always`/`never`
-- **Task routing**: `RULES.md:86-106` — 6 classificações (new_project, bug, refactor, review, question, security_audit) + fallback genérico
-- **Output format** obrigatório (RULES.md seção 2.1): `## Context` → `## File` (com path) → `## Notes`
-- **Token budgets** (SYSTEM.md:115-120): 2048 soft / 4096 hard por resposta, 8192 contexto, compressão automática >70%
-- **Quality Gates** (SYSTEM.md:129-135): Security → Style → Clarity → Conciseness → Completeness (nesta ordem)
-- **5 proibições** (RULES.md:49-53): não adivinhar APIs, não codificar sem entender o codebase, não repetir contexto, não ignorar convenções, não hardcodear secrets
-
-## CLI (`izanagi`)
-
-Instalação: `npm install -g izanagi-ai` (ou `npx izanagi <cmd>` sem instalar).
-
-| Comando | Descrição |
-|---|---|
-| `izanagi init [dir] [--packs a,b,c]` | Cria projeto com `.agents/` (seleção interativa de packs de skills). `core` é sempre incluído. |
-| `izanagi run [agent] --task "<task>"` | Classifica a task, seleciona agente + skill chain e resolve as skills no resolver. |
-| `izanagi create <agent\|skill> <name>` | Cria scaffold de agente (JSON) ou skill (SKILL.md) no projeto atual. |
-| `izanagi compile <agent> [file]` | Compila System Prompt completo (agente + SYSTEM.md + RULES.md). |
-| `izanagi list [skills\|agents]` | Lista skills do resolver e agentes disponíveis. |
-| `izanagi doctor` | Valida integridade: SYSTEM/RULES, JSONs de agentes, aliases do resolver. |
-| `izanagi --version` / `--help` | Versão / ajuda. |
+## 1. Visão Geral do Framework
 
-**Resolução de contexto**: comandos priorizam `.agents/` do projeto atual (criado por `izanagi init`); se não existir, usam a raiz do pacote instalado. Agentes custom criados com `izanagi create` (em `agents/` do projeto) são encontrados pelo `run`.
+Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes. Ele combina uma arquitetura em camadas (Decision → Context → Skill → Quality → Reflection → Memory), uma vasta biblioteca de skills especializadas, agentes pré-definidos e uma **CLI executável (`izanagi`)**.
 
-**Animation Engineer**: agente para sites cinematográficos (scrollytelling, 3D WebGL, motion design). Ative com `izanagi run animation --task "..."` ou, no opencode, digitando `/animation`. Skills: `animation-web`, `webgl-3d`, `motion-design` (referências de sites premiados em `skills/*/references.md`).
+---
 
-**Packs disponíveis** no `init`: `core` (obrigatório), `agents`, `skills`, `architecture`, `coding`, `database`, `devops`, `security`, `testing`, `memory`, `optimization`, `teaching`.
+## 2. Lista Completa de Agentes & Comandos Opencode (`/`)
+
+O framework possui **11 agentes especializados** e um **Orquestrador Multi-Agente (`/agents`)**, todos integrados nativamente para ativação instantânea via comandos de barra (`/`) no Opencode ou via CLI (`izanagi`).
+
+| Agente / Comando | ID / Arquivo | Papel & Especialidade |
+|------------------|--------------|------------------------|
+| `/agents` | `.opencode/agent/agents.md` | **Orquestrador Central**: Permite selecionar um agente, combinar múltiplos agentes, ativar auto-detecção ou modo Swarm. |
+| `/animation` | `agents/animation-agent.json` | **Animation Engineer**: Cria sites cinematográficos (scrollytelling, GSAP, 3D WebGL, motion design). |
+| `/architect` | `agents/architect-agent.json` | **Software Architect**: System design, Clean Architecture, Hexagonal, DDD, CQRS, ADRs e planos de implementação. |
+| `/senior-engineer` | `agents/senior-engineer-agent.json` | **Senior Engineer**: Desenvolvimento full-stack robusto, código limpo, testável e refatoração de sistemas. |
+| `/techlead` | `agents/techlead-agent.json` | **Tech Lead**: Liderança técnica, code reviews rigorosos, governança de arquitetura e mentoria de engenharia. |
+| `/security` | `agents/security-agent.json` | **Security Engineer**: Mitigação OWASP Top 10, pentest reviews, autenticação, criptografia e secure coding. |
+| `/devops` | `agents/devops-agent.json` | **DevOps Engineer**: Pipelines de CI/CD, Docker, Kubernetes, IaC e monitoramento/observabilidade. |
+| `/database` | `agents/database-agent.json` | **Database Engineer**: Modelagem de dados, otimização de queries SQL, PostgreSQL, MySQL e cache Redis. |
+| `/bug-hunter` | `agents/bug-hunter-agent.json` | **Bug Hunter**: Depuração sistemática, análise de causa raiz (root cause analysis) e correção de falhas complexas. |
+| `/docs` | `agents/docs-agent.json` | **Documentation Writer**: Documentação técnica de alto nível, READMEs, especificações de API e diagramas UML. |
+| `/pm` | `agents/pm-agent.json` | **Project Manager**: Planejamento de sprints, milestones, análise de riscos técnicos e gestão de entregas. |
+| `/professor` | `agents/professor-agent.json` | **Professor / Mentor**: Ensino adaptativo, explicação didática de conceitos e mentoria técnica passo a passo. |
 
-## Estrutura de diretórios
+---
 
-| Diretório | Conteúdo |
-|-----------|----------|
-| `core/` | Engines do sistema (8 skills) + skill-resolver.json |
-| `architecture/` | Padrões arquiteturais (Clean Arch, Hexagonal, DDD, CQRS, etc.) |
-| `coding/`, `backend/`, `frontend/` | Skills de engenharia |
-| `skills/` | 111 skills especializadas (quality, debugging, cloud, devops, etc.) |
-| `agents/` | Definições de agentes como JSON |
-| `memory/` | Gerenciamento de memória (6 skills) |
-| `teaching/` | Modo professor e ensino adaptativo |
-| `testing/` | Testes unitários, integração, E2E, mocking |
-| `security/` | OWASP, pentest, segurança |
-| `database/` | SQL, PostgreSQL, MySQL, Redis |
-| `devops/` | Docker, K8s, CI/CD, Linux |
-| `optimization/` | Redução de tokens, otimização de prompt, custo |
-| `src/` | Código-fonte da CLI (TypeScript) |
-| `dist/` | Build da CLI (gerado, não editar) |
+## 3. CLI Executável (`izanagi`)
 
-## Convenções
+Instalação global: `npm install -g izanagi-ai` (ou uso direto via `npx izanagi <cmd>`).
 
-- **Versão atual**: v2.1.0 (SemVer). CHANGELOG.md e ROADMAP.md mostram o plano até v3.0.0
-- **Publicação**: pacote npm `izanagi-ai` (bins `izanagi`/`izanagi-ai`). Bump: `npm run bump:<type>`; publicar: `npm publish` (prepublishOnly roda o build)
-- **Idioma**: maior parte em português (descrições de agentes, READMEs); conteúdo técnico em inglês
-- **Filosofia**: "Architecture first. Code second." — nunca pular planejamento
-- O framework é **carregado automaticamente** via `opencode.json` (`instructions: ["AGENTS.md", "SYSTEM.md"]`) ao iniciar o opencode na raiz do projeto; projetos inicializados com `izanagi init` recebem `opencode.json` apontando para `.agents/`
+| Comando | Descrição Completa |
+|---|---|
+| `izanagi init [dir]` | Inicializa o framework no projeto. Copia automaticamente `AGENTS.md`, `SYSTEM.md` e `RULES.md` para a **raiz do projeto** (para detecção nativa pelo Opencode) e estrutura `.agents/`. |
+| `izanagi run [agent] --task "<task>"` | Analisa a tarefa, classifica a categoria, seleciona o(s) agente(s) e a skill chain, resolve dependências e **gera automaticamente o arquivo `izanagi-prompt.md`** pronto para ser copiado e colado na sua IA. |
+| `izanagi compile <agent> [file]` | Compila o System Prompt completo (Agente + SYSTEM.md + RULES.md + Skills) para exportação. |
+| `izanagi list [skills\|agents]` | Lista todos os agentes disponíveis e todas as skills registradas no `core/skill-resolver.json`. |
+| `izanagi doctor` | Executa auditoria de integridade do framework (verifica SYSTEM, RULES, integridade de JSONs de agentes e aliases do resolver). |
 
-## Skills (Economia de Tokens)
+---
 
-Skills nicho foram **desativadas** por padrão para reduzir o system prompt (~50% menos skills carregadas).
+## 4. Arquitetura em Camadas & Engines (`core/`)
 
-**Ativas:** `ai-agent`, `ai-agent-dev`, `animation-web`, `architecture-patterns`, `economia-tokens`, `frontend`, `frontend-dev`, `handoff-sessao`, `memoria-projeto`, `motion-design`, `professor-modo`, `qa`, `qa-engineer`, `security-privacy`, `web-perf-seo`, `webgl-3d`
+1. **Decision Engine**: Classifica o tipo de tarefa (`new_project`, `bug`, `refactor`, `review`, `security_audit`, etc.) e define a chain de skills ideal.
+2. **Context Engine**: Constrói janela de contexto enxuta e carrega memória de projeto.
+3. **Skill Executor**: Executa o grafo direcionado acíclico (DAG) de skills com resolução de dependências.
+4. **Token Manager**: Monitora orçamento de tokens e aciona compressão quando >70% do orçamento é atingido.
+5. **Quality Gates**: Valida obrigatoriamente todas as entregas na ordem: **Security → Style → Clarity → Conciseness → Completeness**.
+6. **Reflection Engine**: Avaliação pós-tarefa e aprendizado contínuo.
 
-**Desativadas (renomeadas para `SKILL.md.disabled`):** `chaos-engineering`, `cloud-architect`, `cloud-infra`, `data-engineer`, `data-engineering`, `feature-flags`, `graphql`, `i18n-l10n`, `iac-terraform`, `legacy-migration`, `mobile-dev`, `mobile-engineer`, `privacy-engineer`, `serverless-edge`, `sre-reliability`, `wasm`, `web-perf-engineer`, `websocket-realtime`
+---
 
-**Ativação automática:** Ao receber um pedido cujo contexto indica que uma skill desativada é necessária (ex: "criar app mobile" → `mobile-dev`, "deploy na AWS" → `cloud-infra`), o agente DEVE:
-1. Renomear `SKILL.md.disabled` → `SKILL.md` na pasta correspondente
-2. Informar o usuário que a skill foi ativada e é preciso reiniciar o opencode
-3. Não prosseguir com a tarefa até o reinício — o usuário precisa reiniciar para a skill carregar
+## 5. Padrão Anti-Generic / High-Craft (Regra de Ouro)
 
-## Site de Portfólio (SiteIzanagi)
+O framework proíbe estritamente a entrega de códigos ou designs genéricos com "cara de IA" (como templates óbvios, gradientes repetitivos sem propósito, estruturas vazias ou boilerplate gerado automaticamente), **a menos que o usuário solicite explicitamente**.
+- **Padrão Obrigatório**: Inovação, sofisticação técnica, código limpo e arquitetura refinada ("High-Craft").
+- **Design Padrão (quando aplicável)**: Estilo Apple-like futurista, glassmorphism sutil, tipografia precisa, foco total em performance (60fps) e micro-interações intencionais.
 
-O repositório `site/` contém um site Next.js (portfólio do Izanagi AI) publicado em `github.com/pedrohenriquesanchesleal4-debug/SiteIzanagi`.
-**Toda vez que o framework for atualizado**, o agente DEVE também atualizar o site (i18n, estrutura, comandos, versão) no repositório do site e enviar push.
+---
 
-## Design Preference (Default)
+## 6. Estrutura de Diretórios do Framework
 
-- **Estilo visual**: Futurista Apple-like — fundo escuro, glassmorphism, gradientes suaves, partículas animadas, 3D tilt em cards, tipografia bold, animações sutis, sem excesso de "cara de IA"
-- **Stack**: a stack (React, Vue, HTML/CSS/JS, etc.) é definida pelo contexto do projeto ou pelo que o usuário pedir — o estilo visual se adapta à stack, não o contrário
-- **Exceptions**: quando o usuário pedir um estilo específico, seguir a solicitação
+- `core/` — 8 engines centrais + `skill-resolver.json`
+- `agents/` — 11 definições de agentes em JSON
+- `skills/` — Skills especializadas organizadas em pastas `skills/<name>/SKILL.md`
+- `.opencode/agent/` — Comandos slash (`/`) nativos do Opencode
+- `src/` — Código-fonte da CLI em TypeScript (`dist/` gerado no build)
+- `SYSTEM.md` & `RULES.md` — Fundação e regras operacionais obrigatórias

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "izanagi-ai",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "description": "Izanagi AI - Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering",
   "main": "./dist/index.js",
   "module": "./dist/index.js",