izanagi-ai 2.9.6 → 2.10.0

package/.manifest

@@ -1,11 +1,11 @@
 {
   "name": "izanagi-ai",
-  "version": "2.9.6",
+  "version": "2.10.0",
   "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-11T13:30:16.996Z",
+  "generatedAt": "2026-08-11T14:02:38.028Z",
   "agents": [
     {
       "id": "adversarial-critic",

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 ---
 
+## [2.10.0] — 2026-08-11
+
+### Added
+- **Agent Genome (PHASE 7)**: os 18 agentes core agora declaram os 13 campos formais do genome (purpose, capabilities, requiredSkills, optionalSkills, inputs, outputs, constraints, permissions, handoffs, memory, evaluation, tokenBudget, compatibility) — base para scoring e roteamento adaptativo.
+- **Agent Factory via CLI**: `izanagi agent create "<requisito>" [--name=slug] [--skills=a,b]` gera agentes com genome completo em `agents/generated/`, detecta lacuna vs. os 18 core (recusa lacuna já coberta) e é descoberto automaticamente por `loadAgent`/`agent list`.
+- **Skill Factory via CLI**: `izanagi skill create <nome> --gap="..." [--force]` cria skills em `skills/generated/<nome>/SKILL.md` com frontmatter de manifesto, security scan pré-escrita (persiste só com severidade LOW) e recusa de lacuna já coberta; bug de sobrescrita entre skills corrigido (subdir por skill + mkdir do parent).
+- **Tool Registry (MCP-ready)**: `src/runtime/tools/registry.ts` — tools builtin `fs.read`/`fs.write`/`fs.ls` com fluxo discover → permission → validate → execute, sandbox de zona (anti path-traversal) e permissões least-privilege.
+- **Evaluation Engine — veredito UNKNOWN**: sem métricas mensuradas o runtime agora emite **UNKNOWN** com recomendação explícita de evidência (antes: nunca retornava o veredito).
+- **Skill Scanner — DEFENSIVE_CONTEXT**: exemplos educativos/defensivos (não/evite/auditar...) deixaram de ser falsos positivos; `izanagi doctor --deep` passou a varrer as 212 skills sem falso positivo.
+- **Testes**: 14 novos (factories: 6, tools: 7, scanner defensivo) — total 136 testes de runtime passando.
+
+### Fixed
+- **DNG-001**: regex `\/\b` nunca casava comandos destrutivos → padrão corrigido.
+- **PER-001**: `Array.includes('*')` não detectava wildcards em permissões → `some(p => p.includes('*'))`.
+- **SkillFactory**: todas as skills eram gravadas no mesmo arquivo e `writeFileSync` falhava sem subdir → subdir por skill + `mkdirSync` do parent.
+- **Resolver/CLI**: `loadAgent` e `agent list` não enxergavam `agents/generated/` → agora varrem o diretório gerado.
+
+### Documentation
+- SYSTEM.md: novas seções (Execution Pipeline, Agent Factory & Skill Factory, Benchmarks & Regression, Model Router, Tool Registry, Doctor --deep) + tabela de módulos atualizada.
+- README.md: tabela de comandos da CLI reescrita (agent create, skill create --gap, workflow, eval, benchmark, trace, memory, doctor --deep).
+
+---
 ## [2.9.6] — 2026-08-11
 
 ### Fixed

package/README.md

@@ -23,11 +23,19 @@ izanagi --version
 | 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 resolve a cadeia de skills. |
+| `izanagi run [agent] --task "<task>"` | Analisa a tarefa, seleciona o agente ideal e resolve a cadeia de skills (graph + eval + trace via `--runtime`). |
+| `izanagi agent create "<requisito>" [--name=slug] [--skills=a,b]` | Agent Factory: gera agente com genome completo em `agents/generated/` (detecta lacuna vs. 18 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 list [skills\|agents]` | Lista skills e agentes registrados com aliases. |
-| `izanagi doctor` | Auditoria de integridade: SYSTEM/RULES, JSONs de agentes, aliases → targets. |
+| `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 212 skills. |
 | `izanagi export --cli <cli>` | Regenera adapters multi-CLI (claude, codex, cursor, copilot, kimi, all). |
 | `izanagi --version` | Exibe a versão da CLI. |
 
@@ -36,10 +44,12 @@ izanagi --version
 ```bash
 izanagi run "Criar uma landing page de um SaaS de analytics"
 izanagi run architect --task "Design a microservices architecture"
-izanagi create skill meu-fluxo
-izanagi compile architect prompt_arquiteto.md
-izanagi list skills
-izanagi doctor
+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
 ```
 
 ---
@@ -49,7 +59,7 @@ izanagi doctor
 ```
 izanagi-ai/
 ├── bin/             Executável da CLI (bin/izanagi.js → dist/cli)
-├── src/             Runtime real em TypeScript (orchestrator, evaluation, resolver, scanner, tracer, llm, 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/          18 definições de agentes em JSON (fonte da verdade dos comandos)
 ├── skills/          212 skills em skills/<name>/SKILL.md (+ references.md opcional)
@@ -75,7 +85,7 @@ O framework possui **18 agentes especializados** (`/discovery`, `/architect`, `/
 npm install       # instala dependências
 npm run build     # tsc && regenera .manifest
 npm run doctor    # auditoria de integridade
-node --test dist/runtime/tests/*.test.js   # 122 testes do runtime
+node --test dist/runtime/tests/*.test.js   # 136 testes do runtime
 npm run verify    # build + teste de instalação em sandbox
 ```
 

package/SYSTEM.md

@@ -75,13 +75,20 @@ User Input / Comando CLI
 | **Orchestrator** (`orchestrator.ts`) | Executa grafos por categoria (implementation, debugging, testing, database_design, etc.), batches, retry e healing. |
 | **Evaluation Engine** (`evaluation/`) | Métricas ponderadas (correctness, completeness, security, etc.), veredito derivado, relatório com regressões e recomendações. |
 | **Artifact Contracts** (`contracts/artifacts.ts`) | 10+ schemas de artefato (requirements, architecture, database-schema, test-plan...) com validação por campos obrigatórios + tamanho mínimo, em PT-BR. |
-| **Skill Resolver** (`routing/resolver.ts`) | Alias → target (248), parse de frontmatter, scoring por relevância + histórico. |
-| **Skill Scanner** (`security/skill-scanner.ts`) | 11 regras de segurança sobre skills (INJ, DNG, SCR, PER, NET, SEC) com severidade e allowlist. |
+| **Skill Resolver** (`routing/resolver.ts`) | Alias → target (248), parse de frontmatter, scoring por relevância + histórico; `loadAgent` cobre `agents/` + `agents/generated/`. |
+| **Skill Scanner** (`security/skill-scanner.ts`) | 11 regras de segurança sobre skills (INJ, DNG, SCR, PER, NET, SEC) com severidade, allowlist e `DEFENSIVE_CONTEXT` (ignora exemplos defensivos/educativos). |
+| **Agent Genome** (`agents/*.json`) | 13 campos formais por agente (purpose, capabilities, requiredSkills, optionalSkills, inputs, outputs, constraints, permissions, handoffs, memory, evaluation, tokenBudget, compatibility) — preenchidos nos 18 agentes core. |
+| **Agent Factory** (`factories/agent-factory.ts`) | Gera novos agentes com genome a partir de requisito: detecção de lacuna vs. 18 core, ID slug, skills requeridas/opcionais, validação e escrita em `agents/generated/`. |
+| **Skill Factory** (`factories/skill-factory.ts`) | Cria skills novas com frontmatter, security scan pré-escrita, recusa de lacuna já coberta e escrita em `skills/generated/<name>/SKILL.md`. |
+| **Tool Registry** (`tools/registry.ts`) | Tools builtin (fs.read, fs.write, fs.ls) com sandbox de zona (anti path-traversal), permissões least-privilege e fluxo discover → permission → validate → execute. |
+| **Model Router** (`routing/model-router.ts`) | Seleção de modelo (claude/gpt/opus...) por custo/latência/contexto com fallback e override por env. |
 | **Healing Engine** | `retry` (transitório), `skill_replacement` (artefato inválido), `fallback`, `abort` (limite de tentativas). |
+| **Failure Memory** (`memory/store.ts`) | `recordFailure` + `findRelevantFailures` por categoria: erros reais registrados são injetados como evidência em runs futuros (anti-repetição). |
 | **Memory Store** (`memory/store.ts`) | Stats por agente, learnings, histórico de runs (JSON em disco). |
 | **Trace Store** (`observability/tracer.ts`) | Traces de execução em JSONL com spans, load/close e retry de escrita. |
+| **Benchmarks** (`benchmarks/`) | 10 casos builtin (parse, scoring, scanner, genome, composer...) executáveis via `izanagi benchmark` + `compare` entre builds. |
 | **LLM Executor** (`llm/`) | Adapters reais OpenAI/Anthropic/OpenRouter com env key, timeout e propagação de erro HTTP. |
-| **CLI** (`src/cli/`) | Entrypoint `bin/izanagi.js` → `runCLI` (doctor, audit, resolve, export, init, run...). |
+| **CLI** (`src/cli/`) | Entrypoint `bin/izanagi.js` → `runCLI` (doctor --deep, audit, resolve, export, init, agent create, skill create --gap, workflow, trace, eval, benchmark, memory, diagnose...). |
 
 ## Routing — Classificação por Categoria
 
@@ -109,9 +116,9 @@ Não há "compression engine" mágico: a economia de tokens é uma **skill opera
 
 Todo output passa por gates reais antes de ser considerado entregue:
 
-1. ✅ **Security Gate** — sem segredos no código; `skill-scanner` varre skills por injeção, comandos destrutivos, exfiltração e hardcode (11 regras).
+1. ✅ **Security Gate** — sem segredos no código; `skill-scanner` varre skills por injeção, comandos destrutivos, exfiltração e hardcode (11 regras), ignorando contexto defensivo/educativo.
 2. ✅ **Validation Gate** — artefatos validados contra schema (campos obrigatórios + tamanho mínimo); inválido → healing `skill_replacement`.
-3. ✅ **Evaluation Gate** — métricas ponderadas + veredito (PASS / PASS_WITH_WARNINGS / FAIL / BLOCKED) com recomendações.
+3. ✅ **Evaluation Gate** — métricas ponderadas + veredito (PASS / PASS_WITH_WARNINGS / FAIL / BLOCKED / **UNKNOWN** quando faltam evidências mensuradas) com recomendações.
 4. ✅ **Style Gate** — segue `RULES.md`: anti-"cara de IA", design directions, high-craft.
 5. ✅ **Clarity & Conciseness Gate** — sem fluff; cada frase agrega valor.
 6. ✅ **Completeness Gate** — responde a pergunta, sem pontas soltas (Lei da Entrega Exaustiva).
@@ -148,6 +155,40 @@ Task → Executar → Avaliar (veredito) → Healing (corrigir) → Logar (stats
 
 Melhoria contínua acontece por: healing registrado (retry/replacement/abort), stats por agente, learnings persistidos e atualização da memória curada do projeto.
 
+## Execution Pipeline (Runtime Adaptativo)
+
+O ciclo completo de execução — `Task → Understanding → Planning → Execution Graph → Evaluation → Self-Healing → Reflection → Memory → Evolution` — é suportado por módulos reais:
+
+1. **Understanding & Planning** — `requirements` decomposição de requisitos (artefatos em `contracts/artifacts.ts`), classificação da tarefa em categoria.
+2. **Execution Graph** — o Orchestrator monta um grafo por categoria (11 templates: implementation, testing, debugging, database_design...) com `parallelBatches` (nós independentes em paralelo, nós dependentes em sequência) e hooks de execução (`produce`: agêntico / LLM / comando).
+3. **Adaptive Routing** — o resolver pontua skills por relevância + histórico de uso por categoria (scorer com decaimento temporal), nunca lista estática; agents são resolvidos pelo mesmo scoring.
+4. **Evaluation** — métricas ponderadas (correctness, completeness, security, performance, requirementCoverage) com thresholds e veredito derivado; sem métricas mensuradas → **UNKNOWN** com recomendação explícita de evidência.
+5. **Self-Healing & Classification** — healing classificado (retry para transitório, `skill_replacement` para artefato inválido, fallback de modelo, abort por limite); cada healing é registrado com stats por agente.
+6. **Memory & Evolution** — `recordFailure` + `findRelevantFailures` (memória de falhas por categoria), learnings e traces; a memória curada `.agents/memoria/` é atualizada ao fim do ciclo.
+
+## Agent Factory & Skill Factory
+
+Novos agentes e skills são **gerados, não escritos à mão**:
+
+- `izanagi agent create "<requisito>" [--name=slug] [--skills=a,b]` — o Agent Factory detecta lacuna vs. os 18 agentes core (recusa se o core já cobre), deriva ID slug, mapeia skills requeridas/opcionais, monta o genome completo (purpose, capabilities, inputs, outputs, handoffs, memory, evaluation, tokenBudget, compatibility), valida e escreve em `agents/generated/<id>.json` — descoberto automaticamente por `loadAgent`/`agent list`.
+- `izanagi skill create <nome> --gap="<descrição>" [--force]` — o Skill Factory recusa lacunas já cobertas, gera `skills/generated/<nome>/SKILL.md` com frontmatter de manifesto (name, description, version, compatibility, triggers, token_budget), roda o security scanner antes da escrita e só persiste com severidade LOW.
+
+## Benchmarks & Regression
+
+`izanagi benchmark` executa 10 casos builtin (resolver parse, scoring, skill scanner, genome, composer, artifact validation...); `izanagi benchmark compare` mede regressões entre builds (ex.: `2.9.6 → 2.10.0`) com delta por caso.
+
+## Model Router
+
+`src/runtime/routing/model-router.ts` seleciona o modelo por custo/latência/contexto (claude/gpt/opus...), com fallback em cadeia e override por env (`IZANAGI_MODEL`). O token budget de cada agente é declarado no genome e respeitado pelo runtime.
+
+## Tool Registry (Tools/MCP-ready)
+
+`src/runtime/tools/registry.ts` expõe tools builtin (`fs.read`, `fs.write`, `fs.ls`) atrás de um fluxo `discover → permission → validate → execute`: sandbox de zona (bloqueia path traversal via `..`), permissões least-privilege por tool, e schemas prontos para exposição a agentes externos (MCP-ready).
+
+## Doctor
+
+`izanagi doctor` audita integridade (SYSTEM.md/RULES.md, JSONs de agentes, aliases do resolver → targets); `izanagi doctor --deep` adiciona a varredura de segurança das 212 skills com `DEFENSIVE_CONTEXT` (exemplos educativos de segurança não são falsos positivos).
+
 ## Versioning
 
 Versionamento **SemVer** gerenciado pelo npm (`npm run bump:patch|minor|major` + `npm publish`; versão atual no `package.json`).

package/agents/adversarial-critic-agent.json

@@ -14,9 +14,29 @@
     "self-critique"
   ],
   "chains": {
-    "critique_code": ["memoria-projeto", "code-auditor", "security-privacy", "anti-ai-slop", "qa", "memoria-projeto"],
-    "critique_ui": ["memoria-projeto", "anti-ai-slop", "ux-reviewer", "accessibility-reviewer", "qa", "memoria-projeto"],
-    "critique_architecture": ["memoria-projeto", "architecture-patterns", "code-auditor", "qa", "memoria-projeto"]
+    "critique_code": [
+      "memoria-projeto",
+      "code-auditor",
+      "security-privacy",
+      "anti-ai-slop",
+      "qa",
+      "memoria-projeto"
+    ],
+    "critique_ui": [
+      "memoria-projeto",
+      "anti-ai-slop",
+      "ux-reviewer",
+      "accessibility-reviewer",
+      "qa",
+      "memoria-projeto"
+    ],
+    "critique_architecture": [
+      "memoria-projeto",
+      "architecture-patterns",
+      "code-auditor",
+      "qa",
+      "memoria-projeto"
+    ]
   },
   "capabilities": [
     "caça de bugs e edge cases",
@@ -25,20 +45,44 @@
     "validação de cobertura de requisitos",
     "priorização de fixes por severidade"
   ],
-  "inputs": ["implementação a criticar", "requisitos originais"],
-  "outputs": ["critique report (findings com severidade + veredicto)"],
+  "inputs": [
+    "implementação a criticar",
+    "requisitos originais"
+  ],
+  "outputs": [
+    "critique report (findings com severidade + veredicto)"
+  ],
   "constraints": [
     "Nunca implementar correções — somente apontar problemas",
     "Cada finding exige justificativa técnica, sem achismo",
     "Não inflar relatório com problemas triviais"
   ],
   "handoffs": [
-    { "to": "senior-engineer", "reason": "aplicar_fixes" },
-    { "to": "evaluator", "reason": "avaliacao_final" },
-    { "to": "security", "reason": "aprofundar_vulnerabilidades" }
+    {
+      "to": "senior-engineer",
+      "reason": "aplicar_fixes"
+    },
+    {
+      "to": "evaluator",
+      "reason": "avaliacao_final"
+    },
+    {
+      "to": "security",
+      "reason": "aprofundar_vulnerabilidades"
+    }
   ],
-  "memory": ["memoria-projeto", "handoff-sessao"],
-  "evaluation": { "metrics": ["correctness", "security", "performance"], "minScore": 0.75 },
+  "memory": [
+    "memoria-projeto",
+    "handoff-sessao"
+  ],
+  "evaluation": {
+    "metrics": [
+      "correctness",
+      "security",
+      "performance"
+    ],
+    "minScore": 0.75
+  },
   "compatibility": ">=3.0.0",
   "always": [
     "Emitir veredicto claro (READY / READY_WITH_FIXES / NOT_READY) com lista priorizada de fixes",
@@ -49,5 +93,22 @@
     "Implementar ou corrigir o código criticado",
     "Reportar problemas sem justificativa técnica",
     "Ignorar problemas de segurança por 'baixa probabilidade'"
-  ]
+  ],
+  "purpose": "Crítica adversarial de implementações: caçar bugs, falhas de segurança, problemas de arquitetura, requisitos faltantes, problemas de performance, edge cases, suposições incorretas, overengineering e AI slop",
+  "requiredSkills": [
+    "code-auditor",
+    "security-privacy",
+    "anti-ai-slop",
+    "complexity-analyzer",
+    "qa",
+    "self-critique"
+  ],
+  "optionalSkills": [
+    "memoria-projeto",
+    "ux-reviewer",
+    "accessibility-reviewer",
+    "architecture-patterns"
+  ],
+  "permissions": [],
+  "tokenBudget": 4000
 }

package/agents/animation-agent.json

@@ -15,10 +15,31 @@
     "memoria-projeto"
   ],
   "chains": {
-    "scrollytelling": ["memoria-projeto", "animation-web", "motion-design", "anti-ai-slop", "memoria-projeto"],
-    "webgl_scene": ["memoria-projeto", "webgl-3d", "anti-ai-slop", "memoria-projeto"],
-    "motion_signature": ["memoria-projeto", "motion-design", "anti-ai-slop", "memoria-projeto"],
-    "preloader": ["memoria-projeto", "animation-web", "motion-design", "memoria-projeto"]
+    "scrollytelling": [
+      "memoria-projeto",
+      "animation-web",
+      "motion-design",
+      "anti-ai-slop",
+      "memoria-projeto"
+    ],
+    "webgl_scene": [
+      "memoria-projeto",
+      "webgl-3d",
+      "anti-ai-slop",
+      "memoria-projeto"
+    ],
+    "motion_signature": [
+      "memoria-projeto",
+      "motion-design",
+      "anti-ai-slop",
+      "memoria-projeto"
+    ],
+    "preloader": [
+      "memoria-projeto",
+      "animation-web",
+      "motion-design",
+      "memoria-projeto"
+    ]
   },
   "always": [
     "Animar exclusivamente propriedades aceleradas por GPU (`transform` e `opacity`) garantindo taxa de quadros constante de 60fps",
@@ -32,6 +53,57 @@
     "Usar animações genéricas sem propósito ou temporizações robóticas lineares sem curva de easing personalizada",
     "Deixar loops de renderização WebGL ou ScrollTriggers executando em segundo plano quando os elementos estão fora da viewport",
     "Compromover a acessibilidade ou legibilidade de texto em prol de efeitos visuais excessivos"
-  ]
+  ],
+  "purpose": "Motion Engineering & Experiências Cinematográficas Web (Awwwards SOTD / Apple Grade): Scrollytelling, GSAP ScrollTrigger/SplitText, WebGL 3D (Three.js/React Three Fiber), Smooth Scroll (Lenis), Micro-interações e Motion Signature",
+  "capabilities": [
+    "scrollytelling",
+    "webgl",
+    "three.js",
+    "motion design",
+    "gsap",
+    "transições de página"
+  ],
+  "requiredSkills": [
+    "animation-web",
+    "motion-design",
+    "webgl-3d",
+    "design-directions",
+    "ui-ux-pro-max",
+    "anti-ai-slop",
+    "memoria-projeto"
+  ],
+  "optionalSkills": [],
+  "inputs": [
+    "task",
+    "design direction"
+  ],
+  "outputs": [
+    "implementação animada",
+    "motion signature"
+  ],
+  "constraints": [
+    "Animar propriedades que forçam repintura de layout (Layout Thrashing: `width`, `height`, `top`, `left`, `margin`)",
+    "Usar animações genéricas sem propósito ou temporizações robóticas lineares sem curva de easing personalizada",
+    "Deixar loops de renderização WebGL ou ScrollTriggers executando em segundo plano quando os elementos estão fora da viewport",
+    "Compromover a acessibilidade ou legibilidade de texto em prol de efeitos visuais excessivos"
+  ],
+  "permissions": [],
+  "handoffs": [
+    {
+      "to": "qa-agent",
+      "reason": "verificacao"
+    }
+  ],
+  "memory": [
+    "memoria-projeto"
+  ],
+  "evaluation": {
+    "metrics": [
+      "correctness",
+      "requirementCoverage"
+    ],
+    "minScore": 0.7
+  },
+  "tokenBudget": 8192,
+  "compatibility": ">=2.0.0"
 }
-

package/agents/architect-agent.json

@@ -16,10 +16,37 @@
     "memoria-projeto"
   ],
   "chains": {
-    "design_system": ["memoria-projeto", "requirement-analyzer", "architecture-patterns", "principal-engineer", "sequence-diagram-builder", "security-privacy", "memoria-projeto"],
-    "plan_adr": ["memoria-projeto", "architecture-patterns", "principal-engineer", "memoria-projeto"],
-    "review_architecture": ["memoria-projeto", "architecture-patterns", "security-privacy", "code-auditor", "memoria-projeto"],
-    "new_feature": ["memoria-projeto", "deep-research", "requirement-analyzer", "architecture-patterns", "sequence-diagram-builder", "security-privacy", "memoria-projeto"]
+    "design_system": [
+      "memoria-projeto",
+      "requirement-analyzer",
+      "architecture-patterns",
+      "principal-engineer",
+      "sequence-diagram-builder",
+      "security-privacy",
+      "memoria-projeto"
+    ],
+    "plan_adr": [
+      "memoria-projeto",
+      "architecture-patterns",
+      "principal-engineer",
+      "memoria-projeto"
+    ],
+    "review_architecture": [
+      "memoria-projeto",
+      "architecture-patterns",
+      "security-privacy",
+      "code-auditor",
+      "memoria-projeto"
+    ],
+    "new_feature": [
+      "memoria-projeto",
+      "deep-research",
+      "requirement-analyzer",
+      "architecture-patterns",
+      "sequence-diagram-builder",
+      "security-privacy",
+      "memoria-projeto"
+    ]
   },
   "always": [
     "Documentar formalmente decisões arquiteturais relevantes via ADRs estruturadas (Contexto, Decisão, Consequências Positivas/Negativas)",
@@ -33,6 +60,70 @@
     "Permitir que classes de entidade de domínio importem ORMs, bibliotecas de HTTP ou detalhes do banco de dados",
     "Tomar decisões arquiteturais sem analisar e explicitar os trade-offs de latência, throughput, complexidade e manutenibilidade",
     "Criar dependências circulares entre módulos ou Bounded Contexts distintos"
-  ]
+  ],
+  "purpose": "System Design de alta escala, Clean Architecture, DDD, CQRS, Hexagonal Architecture, ADRs, contratos de API e trade-offs operacionais",
+  "capabilities": [
+    "system design",
+    "clean architecture",
+    "ddd",
+    "cqrs",
+    "adrs",
+    "análise de trade-offs"
+  ],
+  "requiredSkills": [
+    "architecture-patterns",
+    "principal-engineer",
+    "requirement-analyzer",
+    "sequence-diagram-builder",
+    "security-privacy",
+    "deep-research",
+    "task-planner",
+    "memoria-projeto"
+  ],
+  "optionalSkills": [
+    "code-auditor"
+  ],
+  "inputs": [
+    "requirements",
+    "contexto do domínio"
+  ],
+  "outputs": [
+    "architecture",
+    "adr",
+    "implementation plan"
+  ],
+  "constraints": [
+    "Propor arquiteturas de microsserviços hiper-fragmentados quando um Monólito Modular atende a todos os SLAs com menor custo operacional",
+    "Permitir que classes de entidade de domínio importem ORMs, bibliotecas de HTTP ou detalhes do banco de dados",
+    "Tomar decisões arquiteturais sem analisar e explicitar os trade-offs de latência, throughput, complexidade e manutenibilidade",
+    "Criar dependências circulares entre módulos ou Bounded Contexts distintos"
+  ],
+  "permissions": [],
+  "handoffs": [
+    {
+      "to": "senior-engineer-agent",
+      "reason": "implementacao"
+    },
+    {
+      "to": "database-agent",
+      "reason": "schema_required"
+    },
+    {
+      "to": "security-agent",
+      "reason": "threat_modeling"
+    }
+  ],
+  "memory": [
+    "memoria-projeto",
+    "handoff-sessao"
+  ],
+  "evaluation": {
+    "metrics": [
+      "correctness",
+      "requirementCoverage"
+    ],
+    "minScore": 0.7
+  },
+  "tokenBudget": 8192,
+  "compatibility": ">=2.0.0"
 }
-

package/agents/automation-engineer-agent.json

@@ -96,5 +96,69 @@
     "BeautifulSoup: https://www.crummy.com/software/BeautifulSoup/bs4/doc/ · Pydantic: https://docs.pydantic.dev · SQLAlchemy: https://docs.sqlalchemy.org",
     "pytest: https://docs.pytest.org · pytest-playwright: https://playwright.dev/python/docs/test-runners",
     "12-factor config: https://12factor.net/config · python-dotenv: https://github.com/theskumar/python-dotenv"
-  ]
+  ],
+  "purpose": "Engenheiro de Automações Profissionais — decompõe o processo, pesquisa soluções existentes, escolhe a melhor stack (qualquer linguagem: Python, TypeScript, C#, Go, Bash... a escolha é consequência do problema), implementa com validação, idempotência, retries, logging estruturado, testes, dry-run e documentação completa. Nunca gera scripts: projeta sistemas de automação confiáveis, testáveis, seguros e sustentáveis.",
+  "capabilities": [
+    "automação profissional",
+    "python",
+    "etl",
+    "planilhas",
+    "browser automation",
+    "integração de apis"
+  ],
+  "requiredSkills": [
+    "automation-engineer",
+    "automation-planning",
+    "automation-research",
+    "technology-selection",
+    "spreadsheet-automation",
+    "browser-automation",
+    "api-automation",
+    "data-validation",
+    "error-recovery",
+    "testing-automation",
+    "automation-security",
+    "automation-optimization",
+    "automation-documentation"
+  ],
+  "optionalSkills": [
+    "data-engineering"
+  ],
+  "inputs": [
+    "task",
+    "fontes de dados"
+  ],
+  "outputs": [
+    "automação",
+    "readme",
+    "testes pytest"
+  ],
+  "constraints": [
+    "Gerar scripts descartáveis — toda automação é um sistema com validação, testes, logs e documentação",
+    "Escolher browser automation quando existe API oficial confiável (hierarquia: API > integração direta > HTTP > browser > UI gráfica)",
+    "Hardcodar credenciais, tokens ou dados sensíveis em qualquer lugar visível",
+    "Ignorar falhas silenciosamente ou retry infinito em erros permanentes",
+    "Entregar sem documentação (README) e sem relatório final de execução",
+    "Perguntar o que pode ser descoberto (análise de arquivos, documentação, pesquisa, testes)"
+  ],
+  "permissions": [],
+  "handoffs": [
+    {
+      "to": "qa-agent",
+      "reason": "verificacao"
+    }
+  ],
+  "memory": [
+    "memoria-projeto",
+    "handoff-sessao"
+  ],
+  "evaluation": {
+    "metrics": [
+      "correctness",
+      "requirementCoverage"
+    ],
+    "minScore": 0.7
+  },
+  "tokenBudget": 8192,
+  "compatibility": ">=2.0.0"
 }