izanagi-ai 2.0.7 → 2.2.0

package/.opencode/agent/animation.md

@@ -0,0 +1,44 @@
+---
+description: Cria sites cinematográficos com animações scroll-driven, scrollytelling, 3D WebGL e motion design. Use quando o pedido for "site animado", "efeito ao scroll", "site que parece vídeo", "3d", "scrollytelling", "animações" ou qualquer coisa que não deva ser um site estático.
+mode: primary
+color: green
+---
+
+You are the **Animation Engineer** agent of Izanagi AI. You build cinematic, living websites — never static ones.
+
+## Core mission
+
+Transform the user's request into a scroll-driven, animated experience. Treat **scroll as the playhead**: frames advance, cameras move, scenes unfold as the user scrolls. When the user describes "a site that is actually a video with parts that advance as you scroll", that means scroll image sequences or scroll-driven 3D (Apple product page style).
+
+## Skills you MUST activate
+
+Load and follow these skills via the skill tool (they contain the full playbooks and references):
+
+1. **animation-web** — scrollytelling, scroll image sequences (canvas frame scrub), GSAP ScrollTrigger pinning/scrubbing, Lenis smooth scroll, preloaders, parallax, horizontal scroll, hero choreography.
+2. **webgl-3d** — Three.js / React Three Fiber / WebGL: scroll-driven 3D scenes, particles, shaders, GLTF models, post-processing, performance budgets.
+3. **motion-design** — choosing the right library (GSAP vs Anime.js v4 vs Motion vs Lottie vs CSS), timing/easing/stagger rules, micro-interactions.
+
+## References
+
+The skill folders contain `references.md` with researched inspiration: uiprompts.app (cinematic prompt-built sites), Skiper UI (animated shadcn components), KokonutUI (dark-first animated components), Apple product pages, and award-winning scrollytelling/3D sites (Bruno Simon, The Monolith, DeepSee). Consult them for style and technique before designing.
+
+## Workflow
+
+1. **Storyboard first**: break the site into scenes (hero → chapters → finale). One technique + one scroll trigger per scene. Present the storyboard before coding.
+2. **Pick the stack**: Lenis + GSAP ScrollTrigger for scroll control; Three.js/R3F only where real 3D earns its place; Anime.js/Motion for interface motion.
+3. **Build scene by scene**, starting with the hero.
+4. **Validate**: 60fps, only transform/opacity on hot paths, `prefers-reduced-motion` fallback, no-JS content visible, Core Web Vitals green.
+5. **Polish**: micro-interactions (hover/tap) on key elements — magnetic buttons, tilt cards, smooth reveals.
+
+## Rules
+
+- Never deliver a static page when the request asks for animation.
+- Scroll = timeline (scrub), not just one-shot triggers.
+- Performance is part of the design: no layout thrash, DPR caps, lazy-loaded canvases.
+- Respect `prefers-reduced-motion`; provide a static fallback.
+- Don't use WebGL for what CSS 3D can do. Don't animate without purpose.
+- Mobile is not a small desktop: reassess pinning and heavy 3D on small viewports.
+
+## Output
+
+Follow Izanagi AI's output format (## Context → ## File → ## Notes) and pass the Quality Gates (Security → Style → Clarity → Conciseness → Completeness) before delivering.

package/AGENTS.md

@@ -1,15 +1,21 @@
-# AGENTS.md — NexusAI
+# AGENTS.md — Izanagi AI
 
-NexusAI é um **framework meta** (instruções para agentes de IA), não um projeto executável. O repositório inteiro é markdown + JSON — sem npm, sem build, sem testes, sem CI.
+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/`).
+
+---
 
 ## 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/` — 10 agentes pré-definidos como JSONs que compõem skills
-- `skills/INDEX.md` — Registro central de todas as 111 skills. **Qualquer skill nova deve ser registrada aqui**
+- `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
 
@@ -22,14 +28,34 @@ NexusAI é um **framework meta** (instruções para agentes de IA), não um proj
 - **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. |
+
+**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`.
+
+**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`.
+
 ## Estrutura de diretórios
 
 | Diretório | Conteúdo |
 |-----------|----------|
-| `core/` | Engines do sistema (8 skills) |
+| `core/` | Engines do sistema (8 skills) + skill-resolver.json |
 | `architecture/` | Padrões arquiteturais (Clean Arch, Hexagonal, DDD, CQRS, etc.) |
-| `coding/` | Skills de engenharia (backend, frontend, React, Laravel, etc.) |
-| `skills/` | 77+ skills especializadas (quality, debugging, cloud, devops, 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 |
@@ -38,19 +64,22 @@ NexusAI é um **framework meta** (instruções para agentes de IA), não um proj
 | `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) |
 
 ## Convenções
 
-- **Versão atual**: v2.0.0 (SemVer). CHANGELOG.md e ROADMAP.md mostram o plano até v3.0.0
+- **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
+- 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/`
 
 ## Skills (Economia de Tokens)
 
 Skills nicho foram **desativadas** por padrão para reduzir o system prompt (~50% menos skills carregadas).
 
-**Ativas:** `ai-agent`, `ai-agent-dev`, `architecture-patterns`, `economia-tokens`, `frontend`, `frontend-dev`, `handoff-sessao`, `memoria-projeto`, `professor-modo`, `qa`, `qa-engineer`, `security-privacy`, `web-perf-seo`
+**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`
 
 **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`
 
@@ -61,7 +90,7 @@ Skills nicho foram **desativadas** por padrão para reduzir o system prompt (~50
 
 ## Site de Portfólio (SiteIzanagi)
 
-O repositório `site/` contém um site Next.js (portfólio do NexusAI) publicado em `github.com/pedrohenriquesanchesleal4-debug/SiteIzanagi`.
+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)

package/CHANGELOG.md

@@ -1,23 +1,77 @@
 # Changelog
 
-> All notable changes to the Nexus AI framework.
+> All notable changes to the IZANAGI AI framework.
 
 ---
 
+## [2.2.0] — 2026-07-31
+
+### Changed
+- **Package renamed back: `nexusai` → `izanagi-ai`** — o framework volta ao nome original Izanagi AI (repo GitHub `izanagi-ai`, site `SiteIzanagi`)
+- **Bins renomeados**: `nexus`/`nexusai` → `izanagi`/`izanagi-ai` (comandos agora são `izanagi init`, `izanagi run`, etc.)
+- CLI internamente renomeada: `Izanagi AI CLI`, config do projeto em `.izanagi/izanagi.config.json` (era `.nexus/nexus.config.json`)
+- Documentação (AGENTS.md, README, CONTRIBUTING) atualizada para o novo nome/comandos
+
+### Fixed
+- `--help` imprimia "Unknown option" junto com a ajuda (caso `--help` compartilhava bloco com `default:`)
+
+## [2.1.1] — 2026-07-31
+
+### Added
+- **Animation Engineer agent** (`agents/animation-agent.json`): sites cinematográficos — scrollytelling, scroll-driven animations, 3D WebGL e motion design
+- **3 novas skills** (com `references.md` pesquisado em 2026):
+  - `animation-web` — scroll image sequences estilo Apple, GSAP ScrollTrigger, Lenis, pinned sections, preloaders (referências: uiprompts.app, Skiper UI, KokonutUI, Apple product pages)
+  - `webgl-3d` — Three.js / React Three Fiber, shaders, partículas, GLTF/Draco, perf budgets (referências: Bruno Simon, The Monolith, DeepSee, KINESIS)
+  - `motion-design` — decisão de biblioteca GSAP vs Anime.js v4 vs Motion vs Lottie vs CSS, timing/easing/stagger
+- **Agente opencode `/animation`** (`.opencode/agent/animation.md`): ativado digitando `/animation` no opencode; copiado automaticamente para projetos pelo `izanagi init`
+- Classificação de tasks de animação/3D no `izanagi run` (ex: `izanagi run "site animado com 3d"` → Animation Engineer)
+
+### Changed
+- AGENTS.md atualizado: 11 agentes, skills ativas incluem animation-web/webgl-3d/motion-design
+
+## [2.1.0] — 2026-07-31
+
+### Added
+- **Pack system** on `izanagi init`: interactive multi-select of skill packs (arrow keys, space, `a`/`n`) or `--packs a,b,c` flag. `core` is always included.
+- `izanagi init <dir>` now creates the project directory if it doesn't exist, plus `.izanagi/izanagi.config.json` and `opencode.json` (auto-loads the framework in opencode)
+- `izanagi run [agent] --task "<task>"`: run a specific agent (incl. custom ones created via `izanagi create`) with full skill chain resolution against `core/skill-resolver.json`
+- Context resolution: CLI commands now prefer the project's `.agents/` (created by init) with fallback to the installed package
+- Interactive pack selector with graceful fallback for non-TTY environments
+
+### Changed
+- **Package renamed `izanagi-ai` → `nexusai`** (bins `nexus`/`nexusai` unchanged) — reverted in 2.2.0
+- `AGENTS.md` and `README.md` rewritten with the new CLI commands and pack system
+- Commands `compile`, `list`, `doctor` now resolve agents/skills from project `.agents/`, cwd or installed package
+
+### Removed
+- **Postinstall auto-copy removed** — this was the cause of duplicated files (`.agents/` + package contents). `.agents/` is now created only by `izanagi init`
+
+### Fixed
+- `izanagi run "task"` (without `--task`) now works again alongside `run [agent] --task "..."`
+
+## [2.0.8] — 2026-07-23
+
+### Added
+- `izanagi create <agent|skill> <name>` command to scaffold new agents and skills
+- `coding/` directory (13 language/framework skills) to npm package and `izanagi init`
+
+### Fixed
+- `bin/izanagi.js` import path: changed `../src/cli/index.js` → `../dist/cli/index.js` to fix `ERR_MODULE_NOT_FOUND` on published package
+
 ## [2.0.7] — 2026-07-23
 
 ### Changed
 - Bump version to 2.0.7
 
 ### Fixed
-- `bin/nexus.js` import path: changed `../src/cli/index.js` → `../dist/cli/index.js` to fix `ERR_MODULE_NOT_FOUND` on published package
+- `bin/izanagi.js` import path fix (previously attempted, incomplete)
 
 ## [2.0.6] — 2026-07-23
 
 - Bump version to 2.0.6
 
 ### Fixed
-- `bin/nexus.js` import path: changed `../src/cli/index.js` → `../dist/cli/index.js` to fix `ERR_MODULE_NOT_FOUND` on published package
+- `bin/izanagi.js` import path: changed `../src/cli/index.js` → `../dist/cli/index.js` to fix `ERR_MODULE_NOT_FOUND` on published package
 
 ## [2.0.0] — 2026-07-22
 

package/README.md

@@ -1,4 +1,4 @@
-# NexusAI
+# Izanagi AI
 
 Framework modular, skill-oriented para agentes de IA especializados em desenvolvimento de software e automação.
 
@@ -6,46 +6,92 @@ Framework modular, skill-oriented para agentes de IA especializados em desenvolv
 
 ---
 
-## Instalação & CLI via NPM
+## Instalação
 
-O NexusAI possui uma **CLI executável** que pode ser utilizada via `npx` ou instalada globalmente.
+O Izanagi AI possui uma **CLI executável** que pode ser instalada globalmente ou usada via `npx`.
 
 ```bash
-# Execução direta via npx (sem instalação permanente)
-npx nexusai-cli run "Criar API REST com Laravel e JWT"
+# Instalação global
+npm install -g izanagi-ai
 
-# Ou instalação global
-npm install -g nexusai-cli
+# Ou execução direta via npx (sem instalar)
+npx izanagi <comando>
 
-# Agora use diretamente o comando nexus / nexusai
-nexus run "Refatorar camada de autenticação"
-nexus list skills
-nexus doctor
+# Agora use diretamente os comandos izanagi / izanagi-ai
+izanagi --version
 ```
 
+> **Nota:** o pacote é publicado como `izanagi-ai` e os bins disponíveis são `izanagi` e `izanagi-ai`.
+
+---
+
+## Iniciando um projeto
+
+```bash
+# Cria o projeto com seleção interativa de packs de skills (.agents/)
+izanagi init my-project
+
+# Ou especifique os packs diretamente (core é sempre incluído)
+izanagi init my-project --packs core,agents,coding,database
+
+# Entre no projeto e comece a usar
+cd my-project
+izanagi run "Create a login page"
+```
+
+O `init` cria:
+- `.agents/` — skills, agentes e engines selecionados
+- `.izanagi/izanagi.config.json` — configuração local do projeto
+- `opencode.json` — auto-carrega o framework quando o opencode abre o projeto
+
+**Packs disponíveis:** `core` (obrigatório), `agents`, `skills`, `architecture`, `coding`, `database`, `devops`, `security`, `testing`, `memory`, `optimization`, `teaching`.
+
 ---
 
 ## Comandos Principais da CLI
 
 | Comando | Descrição |
 |---|---|
-| `nexus run "<task>"` | Analisa a tarefa, seleciona o agente ideal e mapeia a corrente de skills. |
-| `nexus compile <agente> [arquivo]` | Compila um System Prompt completo do agente + fundação do sistema para arquivo ou stdout. |
-| `nexus init` | Inicializa regras `.nexus/` no seu projeto atual. |
-| `nexus list [skills\|agents]` | Lista todas as skills e agentes registrados com seus aliases. |
-| `nexus doctor` | Valida integridade do framework, JSONs de agentes e mapeamentos de aliases. |
+| `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 corrente de skills. |
+| `izanagi create <agent\|skill> <name>` | Cria scaffold de agente (JSON) ou skill (SKILL.md) no projeto atual. |
+| `izanagi compile <agente> [arquivo]` | Compila um System Prompt completo do agente + fundação do sistema. |
+| `izanagi list [skills\|agents]` | Lista todas as skills e agentes registrados com seus aliases. |
+| `izanagi doctor` | Valida integridade do framework, JSONs de agentes e mapeamentos de aliases. |
+| `izanagi --version` | Exibe a versão da CLI. |
+
+### Exemplos
+
+```bash
+# Task simples (auto-classificação)
+izanagi run "Create a login page"
+
+# Agente específico com task explícita
+izanagi run architect --task "Design a microservices architecture"
+
+# Agente customizado criado no projeto
+izanagi create agent my-agent
+izanagi run my-agent --task "Create a login page"
+
+# Compilar system prompt completo para um agente
+izanagi compile architect prompt_arquiteto.md
+
+# Listar e validar
+izanagi list skills
+izanagi doctor
+```
 
 ---
 
 ## Estrutura do Projeto
 
 ```
-NexusAI/
-├── bin/            Executável da CLI (bin/nexus.js)
+izanagi-ai/
+├── bin/            Executável da CLI (bin/izanagi.js)
 ├── src/cli/        Código fonte dos comandos CLI
 ├── core/           Motor central (decisão, contexto, reflexão, skill-resolver)
 ├── agents/         Definições de Agentes de IA em JSON
-├── skills/         Skill base (80+ skills especializadas em Markdown)
+├── skills/         Skill base (111 skills especializadas em Markdown)
 ├── memory/         Gerenciamento de memória e compressão
 ├── optimization/   Redução de tokens e custos
 ├── teaching/       Modo professor e aprendizado adaptativo
@@ -67,26 +113,24 @@ NexusAI/
 
 ## Agentes e Skills
 
-O framework possui **80+ skills** e **10+ agentes especializados** encadeados dinamicamente via `core/skill-resolver.json`.
-
-```bash
-# Exemplo: Compilar o System Prompt para o Arquiteto de Software
-nexus compile architect prompt_arquiteto.md
-```
+O framework possui **111+ skills** e **10 agentes especializados** encadeados dinamicamente via `core/skill-resolver.json`.
 
 ---
 
-## Publicando no NPM
+## Desenvolvimento
 
 ```bash
-# Login no NPM
-npm login
+npm install       # instala dependências
+npm run build     # compila TypeScript → dist/
+npm run doctor    # roda o doctor localmente
+npm pack          # gera o tarball do pacote
+```
 
-# Testar empacotamento em modo dry-run
-npm pack --dry-run
+### Publicando no NPM
 
-# Publicar pacote publicamente
-npm publish --access public
+```bash
+npm run bump:patch   # ou bump:minor / bump:major
+npm publish --access public   # prepublishOnly roda o build automaticamente
 ```
 
 ---

package/ROADMAP.md

@@ -126,6 +126,6 @@
 
 ## Current Focus
 
-**v2.0.0** — Consolidation, plugin system, and CLI tooling to make NexusAI extensible and operable outside of conversation.
+**v2.0.0** — Consolidation, plugin system, and CLI tooling to make Izanagi AI extensible and operable outside of conversation.
 
 > "Rome wasn't built in a day. Neither is a great agent framework."

package/RULES.md

@@ -1,4 +1,4 @@
-# NEXUS AI — Operating Rules
+# IZANAGI AI — Operating Rules
 
 > Version 1.0.0
 

package/SYSTEM.md

@@ -1,4 +1,4 @@
-# NEXUS AI — System Foundation
+# IZANAGI AI — System Foundation
 
 > Version 1.0.0
 > Codename: "The Architect's Mind"
@@ -7,7 +7,7 @@
 
 ## Identity
 
-Nexus AI is a modular, skill-oriented framework for software development agents. It is designed for **low token consumption**, **efficient memory**, **self-evaluation**, **continuous evolution**, and **user teaching**.
+IZANAGI AI is a modular, skill-oriented framework for software development agents. It is designed for **low token consumption**, **efficient memory**, **self-evaluation**, **continuous evolution**, and **user teaching**.
 
 Every decision, every line of code, every interaction passes through a layered engine that ensures quality, security, and clarity.
 

package/agents/animation-agent.json

@@ -0,0 +1,31 @@
+{
+  "name": "Animation Engineer",
+  "version": "1.0.0",
+  "role": "Cria sites cinematográficos: scrollytelling, scroll-driven animations, 3D WebGL e motion design — nunca sites estáticos",
+  "identity": "Você é um Animation Engineer. Transforma sites comuns em experiências vivas: o scroll é o playhead, cada seção é uma cena, cada elemento tem propósito de movimento. Domina scroll image sequences (estilo Apple), GSAP ScrollTrigger, Three.js/React Three Fiber, Anime.js e Motion. Performance é parte do design: 60fps, sem layout thrash, reduced motion respeitado.",
+  "model": "claude-sonnet-4-6",
+  "token_budget": 4096,
+  "skills": ["animation-web", "webgl-3d", "motion-design", "frontend", "architect", "planner", "ux", "a11y", "perf", "reviewer"],
+  "chains": {
+    "new_project": ["planner", "animation-web", "motion-design", "architect", "webgl-3d", "ux"],
+    "new_feature": ["animation-web", "motion-design", "ux"],
+    "implementation": ["motion-design", "animation-web", "webgl-3d"],
+    "frontend": ["animation-web", "motion-design", "webgl-3d", "ux"],
+    "review": ["animation-web", "ux", "a11y", "performance"]
+  },
+  "always": [
+    "Arquitetar a narrativa por cenas antes de codificar (storyboard)",
+    "Tratar o scroll como timeline (scrub), não apenas gatilho one-shot",
+    "Só animar transform + opacity; 60fps é requisito",
+    "Respeitar prefers-reduced-motion e prover fallback sem JS/WebGL",
+    "Consultar as referências de sites premiados (uiprompts, Apple, Skiper, KokonutUI) para estilo",
+    "Checar Core Web Vitals (LCP/INP/CLS) antes de entregar"
+  ],
+  "never": [
+    "Entregar site estático quando o pedido pedir animação",
+    "Usar WebGL para efeito que CSS 3D resolve",
+    "Animação sem propósito (movimento que distrai)",
+    "Ignorar mobile (pinning pesado, DPR sem cap)",
+    "Copiar código de biblioteca sem entender a versão (ex: Anime.js v3 vs v4)"
+  ]
+}