izanagi-ai 2.3.4 → 2.3.5

package/.manifest

@@ -1,11 +1,11 @@
 {
   "name": "izanagi-ai",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "description": "Izanagi AI - Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering",
   "author": "Pedro Henrique Sanches Leal",
   "license": "MIT",
   "homepage": "https://github.com/pedrohenriquesanchesleal4-debug/izanagi-ai#readme",
-  "generatedAt": "2026-08-03T13:34:34.864Z",
+  "generatedAt": "2026-08-04T15:04:31.097Z",
   "agents": [
     {
       "id": "animation",
@@ -1205,6 +1205,66 @@
         }
       ]
     },
+    {
+      "name": "Core",
+      "count": 9,
+      "skills": [
+        {
+          "id": "checkpoint-healing",
+          "name": "IZANAGI AI — Checkpoint & Self-Healing Swarm Engine",
+          "version": "1.0.0",
+          "path": "core/checkpoint-healing-engine.md"
+        },
+        {
+          "id": "compression-engine",
+          "name": "Core: Compression Engine",
+          "version": "1.0.0",
+          "path": "core/compression-engine.md"
+        },
+        {
+          "id": "context-engine",
+          "name": "Core: Context Engine",
+          "version": "1.0.0",
+          "path": "core/context-engine.md"
+        },
+        {
+          "id": "decision-engine",
+          "name": "Core: Decision Engine",
+          "version": "1.0.0",
+          "path": "core/decision-engine.md"
+        },
+        {
+          "id": "evolution-engine",
+          "name": "Core: Evolution Engine",
+          "version": "1.0.0",
+          "path": "core/evolution-engine.md"
+        },
+        {
+          "id": "planning-engine",
+          "name": "Core: Planning Engine",
+          "version": "1.0.0",
+          "path": "core/planning-engine.md"
+        },
+        {
+          "id": "quality-gates",
+          "name": "Core: Quality Gates",
+          "version": "1.0.0",
+          "path": "core/quality-gates.md"
+        },
+        {
+          "id": "reflection-engine",
+          "name": "Core: Reflection Engine",
+          "version": "1.0.0",
+          "path": "core/reflection-engine.md"
+        },
+        {
+          "id": "token-manager",
+          "name": "Core: Token Manager",
+          "version": "1.0.0",
+          "path": "core/token-manager.md"
+        }
+      ]
+    },
     {
       "name": "DevOps",
       "count": 8,
@@ -1319,60 +1379,6 @@
         }
       ]
     },
-    {
-      "name": "Core",
-      "count": 8,
-      "skills": [
-        {
-          "id": "compression-engine",
-          "name": "Core: Compression Engine",
-          "version": "1.0.0",
-          "path": "core/compression-engine.md"
-        },
-        {
-          "id": "context-engine",
-          "name": "Core: Context Engine",
-          "version": "1.0.0",
-          "path": "core/context-engine.md"
-        },
-        {
-          "id": "decision-engine",
-          "name": "Core: Decision Engine",
-          "version": "1.0.0",
-          "path": "core/decision-engine.md"
-        },
-        {
-          "id": "evolution-engine",
-          "name": "Core: Evolution Engine",
-          "version": "1.0.0",
-          "path": "core/evolution-engine.md"
-        },
-        {
-          "id": "planning-engine",
-          "name": "Core: Planning Engine",
-          "version": "1.0.0",
-          "path": "core/planning-engine.md"
-        },
-        {
-          "id": "quality-gates",
-          "name": "Core: Quality Gates",
-          "version": "1.0.0",
-          "path": "core/quality-gates.md"
-        },
-        {
-          "id": "reflection-engine",
-          "name": "Core: Reflection Engine",
-          "version": "1.0.0",
-          "path": "core/reflection-engine.md"
-        },
-        {
-          "id": "token-manager",
-          "name": "Core: Token Manager",
-          "version": "1.0.0",
-          "path": "core/token-manager.md"
-        }
-      ]
-    },
     {
       "name": "Optimization",
       "count": 3,

package/.opencode/agent/agents.md

@@ -27,11 +27,12 @@ Quando o usuário digitar `/agents`, você deve apresentar ou ativar o **Modo de
 - `/pm` — Project Manager (Planning, Risk Analysis, Milestones)
 - `/professor` — Professor / Mentor (Teaching adaptativo, Code Explanations)
 
-**Regras do orquestrador:**
-- **Projetos novos / ideias vagas**: sempre comece com `/discovery` (ele entrevista, pesquisa referências e gera o prompt rico) antes de arquitetar/codar.
-- **Mínimo de agentes efetivos**: combine apenas os agentes com contribuição real para a tarefa (regra anti-redundância). Ex.: projeto novo visual + dados → `Discovery + Animation + Database + Senior`; mudança simples → só `Senior`.
-- **Auto-Detection**: classifique em 1 linha o tipo (ideia/feature/arquitetura/visual/segurança/infra...) e escolha 1-3 agentes. Projeto novo sem especificação → Discovery primeiro. Explique a escolha em 1 frase.
-- **Swarm**: delegate sub-tarefas com contexto mínimo necessário e peça resultados concisos (resumo + arquivos), evitando reescrever o que outro agente já entregou.
-- Após orquestrar, **resuma a entrega** (o que cada agente fez, arquivos tocados, próximo passo) em até 5 bullets — sem repetir código.
+**Regras do orquestrador & Execução Paralela:**
+- **🚀 Execução Paralela (Multi-Agents Concorrentes):** Nunca execute agentes em série (um por vez) quando a tarefa puder ser dividida. Ative múltiplos agentes especializados simultaneamente para trabalharem em frentes distintas ao mesmo tempo (ex: Database Engineer modelando dados + Senior Engineer codando a API/UI + Security Engineer auditando auth + Animation Engineer construindo a camada visual em paralelo). Isso garante velocidade máxima sem gargalos.
+- **⚡ Zero Redundância & Zero "De Qualquer Jeito":** Velocidade no Izanagi não significa entrega descuidada ou repetitiva. Significa eliminação estrita de redundâncias (nunca fazer a mesma tarefa várias vezes ou reler arquivos inalterados) com rigor técnico impecável (High-Craft).
+- **🎯 Uso Ativo de Skills:** Cada agente ativado DEVE carregar e aplicar rigorosamente as suas skills designadas no framework, em vez de gerar respostas genéricas.
+- **Projetos novos / ideias vagas**: sempre comece com `/discovery` (ele entrevista, pesquisa referências e gera o prompt rico) antes de arquitetar/codar em paralelo.
+- **Mínimo de agentes efetivos em paralelo**: combine apenas os agentes com contribuição real e distinta para a tarefa.
+- Após orquestrar a execução paralela, **resuma a entrega unificada** (o que cada agente fez em paralelo, arquivos tocados, próximo passo) em até 5 bullets — sem repetir código.
 
 Como deseja prosseguir com a tarefa atual? Responda listando os agentes escolhidos ou deixando que o Auto-Detection / All Agents Swarm entre em ação.

package/AGENTS.md

@@ -1,76 +1,107 @@
 # AGENTS.md — Izanagi AI Framework Reference
 
-> Version 2.3.1
+> Version 2.3.4
 > Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering
 
 ---
 
 ## 1. Visão Geral do Framework
 
-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`)**.
+Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes: arquitetura em camadas (Decision → Context → Skill → Quality → Reflection → Memory), biblioteca de skills especializadas, 12 agentes pré-definidos e uma **CLI executável (`izanagi`)** publicada no npm (`izanagi-ai`). Este repositório É o framework (não um app que o usa).
 
 ---
 
-## 2. Lista Completa de Agentes & Comandos Opencode (`/`)
-
-O framework possui **12 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. |
-| `/discovery` | `agents/discovery-agent.json` | **Discovery**: Investigador de pré-produção — entrevista completa antes de codar, pesquisa referências reais na web, propõe direções com trade-offs, mostra preview "como ficaria" e gera prompt rico de implementação. ⭐ Começo de todo projeto novo. |
-| `/animation` | `agents/animation-agent.json` | **Animation Engineer**: Diretor de Experiência Cinematográfica — scrollytelling, 3D WebGL, motion signature (Apple/Red Bull/uiprompts como referência). |
-| `/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. |
+## 2. Agentes & Comandos Opencode (`/`)
+
+12 agentes em `agents/*.json` + orquestrador `/agents` (`.opencode/agent/agents.md`). Cada agente tem `chains` (nome → array de **aliases** de skill) e `skills` (array de aliases). Existe também um `.md` por agente em `.opencode/agent/` para ativação via slash.
+
+| Comando | Arquivo | Papel |
+|---|---|---|
+| `/agents` | `.opencode/agent/agents.md` | Orquestrador Multi-Agente (single/multi/auto/swarm) |
+| `/discovery` | `agents/discovery-agent.json` | Pré-produção: entrevista, pesquisa web, preview, prompt rico ⭐ começo de projeto novo |
+| `/animation` | `agents/animation-agent.json` | Scrollytelling, 3D WebGL, motion signature |
+| `/architect` | `agents/architect-agent.json` | System design, Clean Arch, DDD, CQRS, ADRs |
+| `/senior-engineer` | `agents/senior-engineer-agent.json` | Full-stack, refactoring, código limpo/testável |
+| `/techlead` | `agents/techlead-agent.json` | Code review, governança, mentoria |
+| `/security` | `agents/security-agent.json` | OWASP Top 10, auth, secure coding |
+| `/devops` | `agents/devops-agent.json` | CI/CD, Docker, K8s, IaC, observabilidade |
+| `/database` | `agents/database-agent.json` | SQL, PostgreSQL, Redis, modelagem |
+| `/bug-hunter` | `agents/bug-hunter-agent.json` | Debug, root cause analysis |
+| `/docs` | `agents/docs-agent.json` | Docs técnicos, READMEs, diagramas |
+| `/pm` | `agents/pm-agent.json` | Sprints, milestones, riscos |
+| `/professor` | `agents/professor-agent.json` | Ensino adaptativo, explicações |
 
 ---
 
-## 3. CLI Executável (`izanagi`)
+## 3. Comandos de Desenvolvimento (ordem importa)
 
-Instalação global: `npm install -g izanagi-ai` (ou uso direto via `npx izanagi <cmd>`).
+```
+npm install          # instala deps (self-dependency: package.json depende de "izanagi-ai": "^2.2.7" — não remover)
+npm run build        # tsc && node dist/scripts/generate-manifest.js
+npm run verify       # build + teste de instalação em sandbox (passa todos os pack IDs)
+npm run doctor       # node bin/izanagi.js doctor — auditoria de integridade
+npm run bump:patch   # npm version patch --no-git-tag-version (também minor/major)
+npm publish          # prepublishOnly roda build; depois: git push
+```
 
-| 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). |
+**Gotchas críticos:**
+- `dist/` é gitignored e `bin/izanagi.js` importa de `../dist/cli/index.js` — **rode `npm run build` antes de qualquer comando CLI local**, senão roda código obsoleto ou quebra.
+- `doctor` só valida: SYSTEM.md/RULES.md, JSONs de agentes e aliases do resolver → targets. Não valida chains dos agentes nem o conteúdo de `.manifest`.
+- Não há test runner (sem `npm test`). Verificação = `npm run build` + `npm run verify` + `npm run doctor`.
+- CI (`.github/workflows/publish.yml`): roda `build` + `verify` em push/PR; publica no npm em tags `v*`/release (precisa do secret `NPM_TOKEN`).
+- Padrão de commit do repo: `chore: bump to vX.Y.Z` para bumps e `feat:`/`fix:`/`docs:` descritivos em PT-BR para mudanças.
 
 ---
 
-## 4. Arquitetura em Camadas & Engines (`core/`)
+## 4. Estrutura do Framework
 
-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.
+- `core/` — 8 engines (.md) + **`skill-resolver.json`** (mapa alias → target; NÃO editar à mão sem validar targets)
+- `agents/` — 12 definições de agentes em JSON (fonte da verdade para o `/agents`)
+- `skills/` — 79+ skills em `skills/<name>/SKILL.md` (+ `references.md` opcional)
+- `architecture/ coding/ database/ devops/ memory/ optimization/ security/ teaching/ testing/` — skills legadas em arquivo único `.md`
+- `.opencode/agent/` — comandos slash do Opencode
+- `src/` — CLI TypeScript (entrypoint: `src/cli/index.ts` → `runCLI`); scripts de release em `src/scripts/`
+- `SYSTEM.md` & `RULES.md` — fundação e regras operacionais (carregados via `opencode.json` → instructions)
 
 ---
 
-## 5. Padrão Anti-Generic / High-Craft (Regra de Ouro)
+## 5. Skill Resolver — como aliases resolvem
 
-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.
+`core/skill-resolver.json` → `aliases: { alias: "categoria/nome" }` (204 aliases). A resolução de um target tenta, em ordem:
+1. arquivo direto (`skills/foo`)
+2. `skills/foo.md`
+3. `skills/foo/SKILL.md`
+
+**Ao adicionar/remover skill:** edite o resolver (ou rode `node dist/scripts/update-resolver.js` para regenerar aliases de `skills/*`), depois valide com `npm run doctor` — ele acusa alias → target inexistente como warning.
+
+---
+
+## 6. Gotcha `.agents/` (mascarador de bugs)
+
+Este repo tem uma pasta `.agents/` (gitignored) que é a instalação local do framework — o CLI (doctor/list/run) **prioriza `.agents/` do cwd** sobre a raiz do repo (`resolveFrameworkRoot`). Consequência prática:
+- Se `.agents/` ficar desatualizado em relação à raiz, o `doctor` valida contra o espelho velho e **mascara bugs reais** (ex.: aliases quebrados resolviam só porque o `.agents` tinha arquivos antigos).
+- **Sincronize manualmente** mudanças de `skills/`, `core/`, `agents/`, `SYSTEM.md`/`RULES.md` para `.agents/` (não há script de sync — apenas copie os arquivos alterados). Manter raiz e `.agents` idênticos (compare com: `Get-ChildItem -Recurse` e `Compare-Object`).
+- `my-project/` na raiz é lixo de teste do instalador (snapshot antigo) — ignorar, não editar.
+
+---
+
+## 7. `.manifest` (catálogo gerado)
+
+`.manifest` é **gerado no build** por `src/scripts/generate-manifest.ts` (versão do package.json + 12 agents + 188 skills do resolver, com validação de paths — 0 quebrados ou o build falha). **Não editar à mão**; rodar `npm run build` para regenerar. Incluído no pacote npm como catálogo de consulta.
+
+---
+
+## 8. Padrão Anti-Generic / High-Craft (Regra de Ouro)
+
+Proibido entregar código/design genérico "cara de IA" (templates óbvios, gradientes repetitivos sem propósito, boilerplate), **a menos que o usuário peça explicitamente**.
+- Padrão obrigatório: inovação, sofisticação técnica, código limpo, arquitetura refinada.
+- Design padrão (quando aplicável): estilo Apple-like futurista, glassmorphism sutil, tipografia precisa, 60fps, micro-interações intencionais.
 
 ---
 
-## 6. Estrutura de Diretórios do Framework
+## 9. Release Flow (resumo)
 
-- `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
+1. `npm run bump:patch` (ou minor/major) — bumpa `package.json`/`package-lock.json` sem tag
+2. `npm run build` — recompila + regenera `.manifest` com a nova versão
+3. Commit (`chore: bump to vX.Y.Z`) + `npm publish` (build roda de novo via prepublishOnly)
+4. `git push` (CI roda build+verify; publish automático via tag/release se configurado)

package/RULES.md

@@ -16,7 +16,7 @@
 | 6 | **Teach** | Every response should educate the user at least one thing. |
 | 7 | **Security by Default** | Security is not a layer. It is embedded in every decision. |
 | 8 | **Measurable Quality** | If it cannot be validated, it is not done. |
-| 9 | **Anti-Generic High-Craft** | Never deliver generic, obvious, or cookie-cutter "AI-generated" boilerplate unless explicitly requested. Always aim for innovative, original, and exceptional craft. |
+| 9 | **Anti-Generic High-Craft & Cinematic UI** | Never deliver generic, obvious, or cookie-cutter "AI-generated" boilerplate or gray-card layouts ("cara de IA"). Always build innovative, Apple-style / Awwwards-grade work featuring rich dark aesthetics (`bg-zinc-950`), glassmorphism, bento grids, micro-interactions, motion, and scrollytelling capabilities. |
 
 ---
 
@@ -67,9 +67,13 @@ Regras permanentes para trabalhar rápido sem perder qualidade:
 - **Limit self-review cycles.** Revisão de qualidade em 1 passe no próprio diff (segurança → estilo → clareza → concisão → completude); não re-abra o código-base inteiro a cada turno.
 - **Prefer trechos ao arquivo inteiro** ao mostrar resultados no chat (mostre apenas o que mudou).
 
----
+### 2.5 Autonomous Execution & Dependency Pre-Installation
+
+Regras obrigatórias de autonomia e execução:
 
-## 3. Skill Rules
+- **Pré-instalação de dependências:** Se o código novo exigir bibliotecas ou pacotes (ex: `framer-motion`, `lucide-react`, `gsap`, etc.), **baixe e instale as dependências primeiro** via terminal (`npm install <pkg>`) **antes** de criar ou modificar os arquivos de código. Nunca peça para o usuário fazer o que você pode executar.
+- **Autonomia de ponta a ponta:** Execute a tarefa até a conclusão total (planejamento → instalação de deps → código completo → build e verificação), sem parar pela metade ou exigir intervenção manual desnecessária.
+- **Execução proativa de comandos:** Sempre que houver comandos utilitários, de build, teste ou instalação necessários para o sucesso da tarefa, execute-os autonomamente.
 
 ### 3.1 Skill Declaration
 

package/SYSTEM.md

@@ -22,7 +22,7 @@ Every decision, every line of code, every interaction passes through a layered e
 5. **Teach continuously.** Every interaction is a learning opportunity.
 6. **Security is not optional.** It is embedded in every layer.
 7. **Quality is measured.** If it cannot be measured, it cannot be improved.
-8. **Reject generic AI boilerplate.** Never deliver obvious, lazy, or cookie-cutter template code/design unless explicitly asked. Always produce innovative, out-of-the-box, high-craft work.
+8. **Reject generic AI boilerplate & static templates.** Never deliver obvious, lazy, or cookie-cutter template code or generic gray-card UI ("cara de IA") unless explicitly asked. Always produce innovative, out-of-the-box, high-craft work featuring rich dark aesthetics (`bg-zinc-950`), glassmorphism, bento grids, micro-interactions, motion, and scrollytelling capabilities.
 9. **Speed is a feature.** Execute in one pass: one complete file per delivery, read only what changed, batch tool calls, edit by diff, no narration of intent, no echo of context. Review in one pass on the diff — same quality, fewer turns.
 
 ---

package/agents/senior-engineer-agent.json

@@ -21,7 +21,9 @@
     "Explicar o porquê em 2-3 bullets (trade-offs), sem aula sobre o básico",
     "Nunca releia arquivos já lidos e não mudados; agrupar tool reads/buscas",
     "Prefeir diffs/talhes a colar arquivos inteiros no chat",
-    "Seguir a arquitetura e convenções existentes do projeto"
+    "Seguir a arquitetura e convenções existentes do projeto",
+    "Baixar e instalar dependências necessárias (npm install) autonomamente ANTES de criar ou alterar arquivos de código",
+    "Executar a tarefa até a conclusão total (planejamento, dependências, implementação, build e verificação) sem parar pela metade"
   ],
   "never": [
     "Pular error handling ou validar entradas",

package/core/checkpoint-healing-engine.md

@@ -0,0 +1,49 @@
+# IZANAGI AI — Checkpoint & Self-Healing Swarm Engine
+
+> Version 1.0.0
+> Commercial-Grade Meta-Framework Extension (Inspirado em LangGraph + MetaGPT + CrewAI)
+
+---
+
+## 1. Visão Geral
+
+O **Checkpoint & Self-Healing Swarm Engine** é o módulo avançado que eleva o Izanagi ao padrão de frameworks comerciais de alta resiliência (como LangGraph e MetaGPT). Ele garante:
+1. **Persistent State Checkpoints**: Salvamento de estado intermediário a cada passo da execução multi-agente, permitindo retomada exata (time-travel debugging) em caso de falha.
+2. **Self-Healing Test-Fix Loops**: Se um teste falhar ou o build quebrar, o agente de correção (Bug Hunter / Senior Engineer) recebe automaticamente o log de erro exato, aplica o patch corretivo e revalida sem intervenção humana.
+3. **Autonomous Multi-Agent Swarm Collaboration**: Sincronização paralela entre agentes especializados (ex: Database + Backend + Frontend + QA) com handoffs estruturados e validação cruzada.
+
+---
+
+## 2. Arquitetura de Execução Stateful
+
+```
+Task Input → Decision Engine → Parallel Swarm Dispatch
+                                      │
+        ┌─────────────────────────────┼─────────────────────────────┐
+        ▼                             ▼                             ▼
+ [Database Agent]              [Senior Engineer]            [Security Agent]
+ (Schema & Migrations)        (API & UI Implementation)     (OWASP Audit & Auth)
+        │                             │                             │
+        └─────────────────────────────┼─────────────────────────────┘
+                                      ▼
+                            [Stateful Checkpoint]
+                                      │
+                             [Quality Gates & Tests]
+                                      │
+                          ┌───────────┴───────────┐
+                      (Passo)                  (Falhou)
+                          │                       │
+                          ▼                       ▼
+                     [Delivery]           [Self-Healing Loop]
+                                          (Auto-fix com erro)
+```
+
+---
+
+## 3. Protocolo de Auto-Cura (Self-Healing)
+
+Quando o Quality Gate ou o comando de verificação (`npm run build`, testes) falhar:
+1. **Captura do Erro**: O framework extrai o stack trace e o erro exato do terminal.
+2. **Injeção Cirúrgica**: O erro é injetado diretamente no contexto do agente especialista responsável.
+3. **Patch Automático**: O agente gera o diff corretivo.
+4. **Revalidação**: O comando de teste é reexecutado de forma autônoma até o sucesso (`0 errors`).

package/core/skill-resolver.json

@@ -204,6 +204,8 @@
     "requirement-discovery": "skills/brainstorming/SKILL",
     "research": "skills/deep-research/SKILL",
     "e2e": "skills/webapp-testing/SKILL",
-    "test-first": "skills/tdd/SKILL"
+    "test-first": "skills/tdd/SKILL",
+    "checkpoint-healing": "core/checkpoint-healing-engine",
+    "healing": "core/checkpoint-healing-engine"
   }
 }

package/package.json

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

package/skills/frontend/SKILL.md

@@ -81,20 +81,35 @@ Antes de criar qualquer estilização, **consulte os tokens abaixo**. Priorize S
 
 ---
 
-## 📐 Padrões de Design Identificados
+## 📐 Padrões de Design de Alto Craft (Anti-Generic AI Mandate)
 
-### Layout de Página Pública
+> ⛔ **PROIBIDO LAYOUT "CARA DE IA"**: Nunca gere sites monótonos com fundos cinzas chapados (`bg-gray-50`), cards brancos genéricos idênticos em grid simétrico, blocos de texto chatos sem ritmo visual ou ausência total de animações.
+> ✅ **OBRIGATÓRIO (High-Craft & Cinematic UI)**:
+> - **Estética Apple-Futurista / Awwwards**: Fundos imersivos (`bg-zinc-950`), gradientes radiais sutis (`bg-gradient-to-tr from-indigo-950/40 via-zinc-950 to-zinc-950`), e efeitos de luz/foco.
+> - **Glassmorphism & Bordas Brilhantes**: `backdrop-blur-xl bg-zinc-900/60 border border-zinc-800/80 shadow-2xl` com glow sutil no hover (`hover:border-indigo-500/50 hover:shadow-indigo-500/10`).
+> - **Layouts Dinâmicos (Bento Grids & Asimetria)**: Grids variados (Bento UI), seções com contraste visual marcante, espaçamento generoso (`py-24` ou `py-32`), tipografia precisa (`tracking-tight font-sans`).
+> - **Motion & Micro-interações**: Transições fluidas (`transition-all duration-300 hover:scale-[1.02]`), suporte a animações de scroll, stagger entry e feedback visual em cada elemento interativo.
 
-Toda page pública segue exatamente esta estrutura:
+### Layout de Página Moderna / Cinematográfica
+
+Toda página pública deve seguir um padrão imersivo e sofisticado:
 
 ```tsx
-<main>
+<main className="min-h-screen bg-zinc-950 text-zinc-100 selection:bg-indigo-500 selection:text-white">
   <Header />
-  <PageHeader title="..." subtitle="..." breadcrumb={[...]} />
   
-  <section className="py-16 bg-gray-50">
+  {/* Hero Cinematográfico com Radial Glow */}
+  <section className="relative overflow-hidden py-28 md:py-36">
+    <div className="absolute top-1/4 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[600px] h-[600px] bg-indigo-500/10 blur-[120px] rounded-full pointer-events-none" />
+    <div className="container mx-auto px-4 relative z-10">
+      {/* Título com tracking-tight e subtítulo refinado */}
+    </div>
+  </section>
+
+  {/* Seção Bento Grid / Conteúdo Dinâmico */}
+  <section className="py-20 border-t border-zinc-900/80">
     <div className="container mx-auto px-4">
-      {/* conteúdo */}
+      {/* Grid assimétrico / bento cards */}
     </div>
   </section>
 
@@ -102,17 +117,14 @@ Toda page pública segue exatamente esta estrutura:
 </main>
 ```
 
-### Cards e Containers
+### Cards e Containers de Alto Padrão
 
 ```tsx
-// Card principal
-<div className="bg-white rounded-lg shadow-lg p-8">
-
-// Card compacto
-<div className="bg-white shadow-lg rounded-2xl p-6">
-
-// Container de seção
-<div className="container mx-auto px-4">
+// Card Bento com Glassmorphism e Glow no Hover
+<div className="group relative rounded-2xl bg-zinc-900/60 p-8 backdrop-blur-xl border border-zinc-800/80 hover:border-indigo-500/50 transition-all duration-300 hover:shadow-2xl hover:shadow-indigo-500/10">
+  <div className="absolute inset-0 bg-gradient-to-b from-white/[0.03] to-transparent rounded-2xl pointer-events-none" />
+  {/* conteúdo */}
+</div>
 ```
 
 ### Formulários