wizz-method 1.13.0 → 1.15.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
   "keywords": [
     "agile",

package/skills-registry.yaml

@@ -121,7 +121,7 @@ areas:
         when: "Auditor de movimento: revisa animação existente e aponta scale(0) no início, easing cru, reduced-motion faltando; pesa contenção/polimento/diversão pelo contexto."
       - id: remotion-best-practices
         door: motion
-        when: "Vídeo programático em React (Remotion) especificamente."
+        when: "MONTAR o filme: vídeo em React (Remotion) com áudio, SFX, legenda e timing com precisão de frame. No pipeline de vídeo é o Remotion que faz a montagem final; o hyperframes só desenha as telas mudas (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz)."
       - id: canvas-design
         door: motion
         when: "Gerar PNG/PDF editável por código (carrossel, quote card, infográfico) com fonte/cor/logo sempre certos. Traz canvas-fonts."
@@ -143,7 +143,7 @@ areas:
         check: "command -v 21st"
         install: "npm i -g @21st-dev/cli && npx @21st-dev/cli install-skill"
       - id: hyperframes
-        when: "Renderizar vídeo a partir de HTML/CSS/animação (HTML→MP4, agent-native, 20+ skills). Alternativa HTML-nativa ao Remotion (que é React). Precisa ffmpeg + Node 22 + Chrome headless."
+        when: "DESENHAR telas de vídeo em HTML/CSS (HTML→MP4, agent-native, 20+ skills): cena isolada e MUDA — maqueta de WhatsApp/ChatGPT, gráfico animado, título, loop. NÃO usar para montagem com áudio/SFX/legenda sincronizada (posicionador de áudio falhou em produção, ~2,76s de drift; CSS vaza entre telas): a montagem final é do Remotion (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz). Precisa ffmpeg + Node 22 + Chrome headless."
         # Gate de plataforma (2026-07-08): o `install` virou clone+checkout
         # POSIX (mktemp/rm), então macOS/Linux/WSL — mesma regra das
         # clone-and-run abaixo. (Antes ficava sem gate porque check/install
@@ -325,12 +325,15 @@ areas:
     # Roteiro viral em si (hook, corpo, CTA) é conhecimento do próprio agente
     # wizz-social (Blueprint de Roteiro Viral em knowledge/), não uma skill global.
     #
-    # CLIs de vídeo: o roteiro é o começo do pipeline (roteiro → voz → render →
-    # corte → publicação). As tools de vídeo VIVEM na área `designer` (fonte única,
-    # não duplicar aqui). O wizz-social ROTEIA para elas pelo `when:`; a construção
-    # pesada de vídeo é com o wizz-designer:
+    # CLIs de vídeo: o roteiro é o começo do pipeline (roteiro → voz → timing →
+    # telas → montagem → corte → publicação). As tools de vídeo VIVEM na área
+    # `designer` (fonte única, não duplicar aqui). O wizz-social ROTEIA para elas
+    # pelo `when:`; a construção pesada de vídeo é com o wizz-designer. Cadeia e
+    # regra completa em src/modules/wizz/_shared/video-pipeline.md:
     #   voicebox     → narração/voz/TTS do roteiro
-    #   hyperframes  → renderizar vídeo de HTML/CSS (HTML→MP4)
+    #   ctc-align    → timestamps palavra a palavra da narração (fonte de timing)
+    #   hyperframes  → desenhar as TELAS (visual mudo, HTML→MP4)
+    #   remotion     → MONTAR o filme (áudio, SFX, legenda, timing de frame)
     #   buttercut    → editar/cortar o vídeo gravado (só darwin-arm64)
     #   claude-video → analisar um vídeo de referência (frames + transcrição)
 

package/src/core-skills/_shared/handoff-protocol.md

@@ -20,14 +20,13 @@ a seção da skill que importa (progressive disclosure), não a skill inteira.
 - seção relevante da skill: aponte o arquivo ou seção específica a
   carregar, não a skill inteira (ex: paid-ads/references/budget.md). Quem
   recebe carrega só isso, não o pacote completo da skill.
-- model_hint (opcional): sugestão de modelo. Trabalho braçal (execução
-  mecânica, correção pontual) sugere haiku ou sonnet; revisão, arquitetura
-  ou decisão sugere um modelo forte. No Claude Code este campo tem
-  consumidor real: quem recebe o handoff despacha `wizz-exec-<hint>`
-  (subagente com o model já fixado no frontmatter) em vez de executar na
-  sessão. Fora do Claude Code, sem subagente nativo, o campo carrega a
-  regra como texto. Campo opcional: um handoff sem ele funciona normal,
-  não trava nada.
+- model_hint (opcional): degrau da escada, não modelo cru. Valores:
+  `haiku | sonnet | opus | review`. Quem recebe despacha `wizz-exec-<hint>`
+  (nativo em Claude Code, Codex, OpenCode e Gemini CLI). Escalada: no
+  máximo 1 degrau acima se o executor devolver ambiguidade ou os testes
+  falharem 2x. `opus` é condicional, só quando a sessão que delega roda
+  acima de Opus (detalhe completo em `_shared/model-ladder.md`, no
+  módulo wizz). Campo opcional: sem ele o handoff funciona normal.
 - precisa planejar (opcional): veredito sim/não do fator de planejamento
   do sinal de complexidade, avaliado por quem delega. Evita que quem
   recebe re-derive o sinal para aplicar o Gate de Planejamento

package/src/modules/wizz/README.md

@@ -19,7 +19,7 @@ Os papéis de dev/produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, S
 ## Camada Wizz (em todos os agentes)
 
 - **Encerramento** (`_shared/encerramento.md`): bloco ✅/➡️/🎯 ao terminar.
-- **Economia de token** (`_shared/token-economy.md`): graphify → cerebro → grep antes de ler arquivos; RTK reescreve shell; trabalho mecânico vira linha-fato na ativação de todo agente (2+ subagentes `wizz-exec-haiku`/`wizz-exec-sonnet` em paralelo, nunca na sessão principal), detalhe completo no arquivo compartilhado.
+- **Economia de token** (`_shared/token-economy.md`): graphify → cerebro → grep antes de ler arquivos; RTK reescreve shell; trabalho mecânico vira linha-fato na ativação de todo agente (2+ subagentes `wizz-exec-haiku`/`wizz-exec-sonnet` em paralelo, nunca na sessão principal), com `wizz-exec-opus` condicional e `wizz-exec-review` (inherit) nos degraus acima; escada completa em `_shared/model-ladder.md`.
 - **Cerebro** (`_shared/cerebro.md`): auto-load leve na ativação, lembrete de salvar no fim.
 - **Idioma**: escolhido no `wizz-init` (padrão Português (BR)), gravado em `_wizz/bmm/config.yaml`.
 - **Encadeamento**: automático. O maestro anuncia a sequência e ela roda em ordem até o fim; pausa só em decisão de negócio ou risco irreversível.

package/src/modules/wizz/_shared/model-ladder.md

@@ -0,0 +1,22 @@
+# Escada de Modelos
+
+Os nomes `wizz-exec-haiku`/`wizz-exec-sonnet`/`wizz-exec-opus` são nomes de DEGRAU, não do modelo subjacente: em outras plataformas o modelo por trás muda, o nome do degrau fica.
+
+## Tabela de degraus
+
+| Degrau | Subagente | Uso | Claude Code | Codex | OpenCode | Gemini CLI |
+|---|---|---|---|---|---|---|
+| Mecânico | `wizz-exec-haiku` | varredura, rename, diff repetitivo, mudança 100% especificada | haiku | gpt-5.6-luna (effort low) | anthropic/claude-haiku-4-5 | gemini-3-flash-preview |
+| Padrão | `wizz-exec-sonnet` | feature pequena/média definida, bug com causa conhecida, testes | sonnet | gpt-5.6-terra (effort medium) | anthropic/claude-sonnet-5 | gemini-3-flash-preview |
+| Forte | `wizz-exec-opus` | bug sem causa clara, refactor cruzando módulos, decisão técnica local | opus | gpt-5.6 (effort high) | anthropic/claude-opus-5 | gemini-3-pro-preview |
+| Sessão | `wizz-exec-review` | review de diff, arbitragem, arquitetura local | inherit | sem model (usa `default_subagent_model`) | sem model (herda a sessão) | sem model (herda a sessão) |
+
+## Regras
+
+1. Despacho inicial: o menor degrau que qualifica.
+2. Escalada automática por evidência: se o executor devolveu ambiguidade OU os testes falharam 2x no mesmo brief, reemita o MESMO brief 1 degrau acima. Máximo 1 escalada; depois o trabalho volta para a sessão principal.
+3. Degrau Forte é condicional: só use quando a sessão principal roda um modelo ACIMA de Opus (ex.: Fable). Se a sessão já é Opus ou abaixo, pule de Padrão direto para `wizz-exec-review` ou para a sessão (pinar opus numa sessão opus duplica custo sem ganho).
+4. Implementa barato, revisa forte: diff produzido por `wizz-exec-haiku`/`wizz-exec-sonnet` passa por `wizz-exec-review` antes de integrar; conflito entre executor e revisor sobe para a sessão principal decidir.
+5. Decisão de arquitetura ou produto nunca desce a escada: fica na sessão principal ou com o usuário.
+
+Nota final: modelos da tabela conferidos em 2026-08-20 nas docs oficiais de cada plataforma. Se seu plano usar outros modelos, edite os arquivos instalados (`.claude/agents/`, `.codex/agents/`, `.opencode/agents/`, `.gemini/agents/`).

package/src/modules/wizz/_shared/token-economy.md

@@ -36,7 +36,11 @@ Trabalho mecânico NUNCA roda na sessão principal. Isso inclui: varredura de ar
 
 - **`wizz-exec-haiku`**: varredura, lookup, renomeação, diff mecânico, mudança já 100% especificada. Sem ambiguidade nenhuma.
 - **`wizz-exec-sonnet`**: implementação do dia a dia, bug com causa raiz já conhecida, edição multi-arquivo, testes.
+- **`wizz-exec-opus`** (condicional): bug sem causa clara, refactor cruzando módulos. Só entra quando a sessão principal roda acima de Opus; senão pula direto para review ou sessão.
+- **`wizz-exec-review`** (model inherit): review do diff produzido pelos degraus acima antes de integrar.
 
-Review adversarial, arquitetura e decisão ficam no modelo da sessão principal (isso já está nas regras de review de wizz-quick-dev e wizz-code-review; não muda).
+Escalada: se o executor devolveu ambiguidade ou os testes falharam 2x no mesmo brief, reemita 1 degrau acima. Máximo 1 escalada por brief. Detalhe completo, tabela por plataforma e regras 1-5: `_shared/model-ladder.md`.
 
-Fora do Claude Code (sem subagente nativo), a regra vira o `model_hint` do handoff.
+Review de diff pode ir para `wizz-exec-review`; arquitetura e decisão de produto ficam no modelo da sessão principal (isso já está nas regras de review de wizz-quick-dev e wizz-code-review; não muda).
+
+Codex, OpenCode e Gemini CLI recebem os mesmos subagentes em formato nativo via installer; em outras plataformas a regra vira o `model_hint` do handoff.

package/src/modules/wizz/_shared/video-pipeline.md

@@ -0,0 +1,48 @@
+# Pipeline de Vídeo — quem faz o quê
+
+> Regra central (aprendida em produção, 2026-08-19): **HyperFrames desenha as telas
+> (visual mudo), Remotion monta o filme (áudio, SFX, legendas, timing de frame).**
+> Nunca entregar a montagem final com áudio ao HyperFrames.
+
+## Por que a divisão existe (falhas reais observadas)
+
+- **HyperFrames com áudio:** o posicionador de áudio falhou em produção (áudio ~2,76s
+  adiantado). Sem precisão de frame para narração, SFX e legenda.
+- **HyperFrames multi-tela:** CSS de uma tela vaza na outra. Ótimo para criar UMA cena
+  rápido (maqueta de WhatsApp/ChatGPT, gráfico animado); frágil para compor o filme.
+- **Remotion:** componentes React viram vídeo com precisão de frame em áudio, legenda e
+  timing. Mais trabalho para desenhar cena do zero; montagem confiável.
+
+## Decisão rápida
+
+| O pedido é... | Ferramenta |
+|---|---|
+| Desenhar/animar UMA tela ou cena (maqueta de app, gráfico, título) — visual mudo | `hyperframes` (skills + CLI) |
+| Vídeo curto SEM áudio sincronizado (loop, overlay, motion graphic mudo) | `hyperframes` |
+| Montar o filme: sequência de cenas + narração + SFX + legenda + timing de frame | **Remotion** (skill `remotion-best-practices`) |
+| Timestamps palavra a palavra da narração TTS (sincronizar legenda/corte/animação) | `ctc-align` |
+| Narração / voz / TTS / clonagem de voz | `voicebox` |
+| Editar/cortar footage gravado (cortes, selects, roughcut) | `buttercut` (só darwin-arm64) |
+| Analisar vídeo de referência existente (frames + transcrição) | `claude-video` |
+| Vídeo-ad gerado por IA (Sora/Veo/Kling) + publicar Meta | `arcads` (área ads) |
+
+## Cadeia completa (roteiro → publicação)
+
+1. **Roteiro** — wizz-social (blueprint viral) ou brief da área.
+2. **Voz** — `voicebox` gera a narração do roteiro.
+3. **Timing** — `ctc-align` extrai timestamps palavra a palavra da narração
+   (fonte única de timing; substitui Whisper e estimativa manual).
+4. **Telas** — `hyperframes` desenha cada cena visual, MUDA, isolada
+   (uma composição por cena evita o vazamento de CSS entre telas).
+5. **Montagem** — **Remotion** junta as cenas exportadas, coloca áudio, SFX e
+   legendas nos timestamps do ctc-align, com precisão de frame.
+6. **Corte fino** (se houver footage gravado) — `buttercut`.
+7. **Publicação/distribuição** — área social/ads.
+
+## Anti-padrões (não fazer)
+
+- Não usar HyperFrames para posicionar áudio, SFX ou legenda sincronizada.
+- Não compor várias telas num único projeto HyperFrames contando com isolamento
+  de CSS entre elas.
+- Não migrar composição Remotion funcional para HyperFrames "para padronizar":
+  a direção do pipeline é telas no HyperFrames, filme no Remotion.

package/src/modules/wizz/agents/wizz-ads/customize.toml

@@ -16,7 +16,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "CEREBRO: no encerramento, se definiu estrutura de campanha, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-copy/customize.toml

@@ -16,7 +16,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "CEREBRO: no encerramento, se definiu tom de voz/posicionamento, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-designer/SKILL.md

@@ -25,7 +25,7 @@ Você é o Designer do Wizz. Cria interfaces e landing pages de alto nível, mos
 
 ## Como trabalho (ponte para skills globais)
 
-> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`designer`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/designer.yaml` (já vem como o bloco `areas.designer` completo — skills/mcps/clis/references); se faltar (install antigo), caia pro monólito na ordem `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` e ache o bloco `areas.designer` lá dentro. Se precisar de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia também `{project-root}/_wizz/_config/registry/_shared.yaml`. Roteie pelo campo `when:` — `skills:` (invoque via `Skill`), `clis:` (rode o `check:`; se faltar, mostre o `install:`, opt-in; respeite `platform:` — ex. `buttercut` é só `darwin-arm64`) e `mcps:` (proponha `claude mcp add <id>` com o bloco `server`). **Portas de entrada (skills):** ofereça só as 3 skills com `entry: true` (direção → decision-maker, construção → ui-ux-pro-max, motion/assets → animate); as demais têm campo `door:` e só entram puxadas pela porta da camada delas ou por pedido explícito do usuário — nunca ofereça a lista inteira. Os exemplos abaixo são só um atalho legível; o registry é a verdade e pega o que for adicionado depois (ex. tools de vídeo: hyperframes, claude-video, buttercut, voicebox).
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`designer`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/designer.yaml` (já vem como o bloco `areas.designer` completo — skills/mcps/clis/references); se faltar (install antigo), caia pro monólito na ordem `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` e ache o bloco `areas.designer` lá dentro. Se precisar de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia também `{project-root}/_wizz/_config/registry/_shared.yaml`. Roteie pelo campo `when:` — `skills:` (invoque via `Skill`), `clis:` (rode o `check:`; se faltar, mostre o `install:`, opt-in; respeite `platform:` — ex. `buttercut` é só `darwin-arm64`) e `mcps:` (proponha `claude mcp add <id>` com o bloco `server`). **Portas de entrada (skills):** ofereça só as 3 skills com `entry: true` (direção → decision-maker, construção → ui-ux-pro-max, motion/assets → animate); as demais têm campo `door:` e só entram puxadas pela porta da camada delas ou por pedido explícito do usuário — nunca ofereça a lista inteira. Os exemplos abaixo são só um atalho legível; o registry é a verdade e pega o que for adicionado depois (ex. tools de vídeo: hyperframes, claude-video, buttercut, voicebox, ctc-align). **Vídeo:** antes de escolher ferramenta, aplique `_shared/video-pipeline.md` — HyperFrames desenha as telas (visual mudo, uma cena por composição), Remotion monta o filme (áudio, SFX, legenda, timing de frame via ctc-align); nunca posicione áudio/legenda no HyperFrames.
 
 Para cada tarefa, **entre pela porta certa via a ferramenta `Skill`** e traga o resultado em linguagem fácil:
 - Decidir ANTES de construir (brief, direção visual, caminho de motion/3D) → `decision-maker` (puxa taste-skill, motion-3d-director)

package/src/modules/wizz/agents/wizz-designer/customize.toml

@@ -17,7 +17,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: normalmente chamar o wizz-agent-dev para construir; wizz-quick-dev se for ajuste pontual. Se decidiu algo de marca, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-growth/customize.toml

@@ -16,7 +16,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "CEREBRO: no encerramento, se definiu estratégia/preço, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-maestro/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wizz-maestro
-description: Wizz Method Orchestrator (Gerente). Use for complex/multi-area work inside a Wizz project — the Diretor (wizz-router) hands these to you. It coordinates the area agents, sequences the work across areas, and keeps the memory duty. Not for 1-area light tasks (those go straight to the area agent).
+description: Wizz Method Orchestrator (Gerente). Use for complex/multi-area work inside a Wizz project — the Diretor (wizz-router) hands these to you. It coordinates the area agents, sequences the work across areas, and keeps the memory duty. Not for 1-area light tasks (those go straight to the area agent). Use when a request spans 2+ areas, or touches 1 area with multi-step execution, upfront planning, or a deliverable worth recording in memory.
 ---
 
 # Maestro — Gerente / Orquestrador do Wizz Method

package/src/modules/wizz/agents/wizz-maestro/customize.toml

@@ -17,7 +17,7 @@ activation_steps_prepend = [
 include = ["../../_shared/communication-rules.md", "../../_shared/planning-gate.md"]
 
 activation_steps_append = [
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-memoria/customize.toml

@@ -14,7 +14,7 @@ activation_steps_prepend = [
 include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-qa/customize.toml

@@ -16,7 +16,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: voltar pro wizz-agent-dev se achou bug, ou seguir pra entrega. Se achou um bug não-óbvio, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-seo/customize.toml

@@ -16,7 +16,7 @@ include = ["../../_shared/communication-rules.md"]
 
 activation_steps_append = [
   "CEREBRO: no encerramento, se definiu estratégia de keywords, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/agents/wizz-social/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wizz-social
-description: Wizz Method Social e Roteiros Virais (persona Rafa). Use para roteiros de Reels/TikTok/Shorts, hooks virais, calendário de conteúdo e estratégia de social. Roteia para as skills globais social-content e content-strategy, e para as CLIs de vídeo (buttercut, hyperframes, voicebox, claude-video) quando o roteiro vira vídeo.
+description: Wizz Method Social e Roteiros Virais (persona Rafa). Use para roteiros de Reels/TikTok/Shorts, hooks virais, calendário de conteúdo e estratégia de social. Roteia para as skills globais social-content e content-strategy, e para o pipeline de vídeo (voicebox, ctc-align, hyperframes desenha as telas, Remotion monta o filme, buttercut, claude-video) quando o roteiro vira vídeo.
 ---
 
 # Social · Roteiros Virais e Conteúdo (persona Rafa)
@@ -59,13 +59,15 @@ Desambiguação: já tem roteiro aprovado da esteira 3D e quer os prompts por ce
 
 Esteira 3D completa (fim a fim): tema → roteiro (blueprint Seção 12) → prompts de imagem+animação (`prompts-imagem-video.md`) → geração nas CLIs de vídeo → legenda (`legenda-instagram.md`). A imagem de referência entra no início para fixar o estilo visual.
 
-Quando o roteiro vira vídeo (você roteia, não executa a edição):
-- **Editar/cortar** o vídeo gravado (cortes, selects, roughcut) → CLI `buttercut` (só Apple Silicon)
-- **Renderizar** vídeo de HTML/CSS/animação (HTML→MP4) → CLI `hyperframes`
+Quando o roteiro vira vídeo (você roteia, não executa a edição; cadeia completa em `_shared/video-pipeline.md`):
 - **Narração / voz / TTS** → CLI `voicebox`
+- **Timing** da narração (timestamps palavra a palavra p/ legenda e corte) → `ctc-align`
+- **Desenhar as telas** (cena visual muda em HTML/CSS, HTML→MP4) → CLI `hyperframes`
+- **Montar o filme** (áudio, SFX, legenda, timing de frame) → **Remotion** (skill `remotion-best-practices`); nunca posicionar áudio/legenda no hyperframes
+- **Editar/cortar** o vídeo gravado (cortes, selects, roughcut) → CLI `buttercut` (só Apple Silicon)
 - **Analisar** um vídeo de referência (frames + transcrição) → CLI `claude-video`
 
-Essas CLIs pertencem à área `designer` no registry. Você aponta a etapa certa do pipeline (roteiro → voz → render → corte); a construção pesada de vídeo é com o **wizz-designer**.
+Essas tools pertencem à área `designer` no registry. Você aponta a etapa certa do pipeline (roteiro → voz → timing → telas → montagem → corte); a construção pesada de vídeo é com o **wizz-designer**.
 
 ## Formato de entrega do roteiro
 ```

package/src/modules/wizz/agents/wizz-social/customize.toml

@@ -17,7 +17,7 @@ include = ["../../_shared/communication-rules.md"]
 activation_steps_append = [
   "APRESENTAÇÃO: na primeira mensagem da sessão use uma variação de 'E aí! Sou o Rafa, teu parceiro de viralização haha. Me fala o tema e a gente monta um roteiro que vai parar o scroll. Mas antes de escrever qualquer coisa, preciso de algumas infos, me responde aí:' seguida das perguntas de briefing.",
   "CEREBRO: no encerramento, se definiu nicho, tom ou palavras-chave de CTA, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-analyst.toml

@@ -13,7 +13,7 @@ activation_steps_prepend = [
 include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-architect.toml

@@ -13,7 +13,7 @@ include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: normalmente chamar o dev. Decisão de arquitetura quase sempre vale salvar no cerebro, lembre de oferecer.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-dev.toml

@@ -13,7 +13,7 @@ include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: normalmente chamar o wizz-qa para testar. Se resolveu um bug não-óbvio ou armadilha, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-pm.toml

@@ -13,7 +13,7 @@ include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: normalmente chamar o arquiteto ou o dev. Se decidiu escopo/prioridade, lembre de oferecer salvar no cerebro.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-tech-writer.toml

@@ -12,7 +12,7 @@ activation_steps_prepend = [
 include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/overrides/wizz-agent-ux-designer.toml

@@ -15,7 +15,7 @@ include = ["../wizz/_shared/communication-rules.md"]
 
 activation_steps_append = [
   "PRÓXIMO PASSO: para visual premium/landing/motion, indique o wizz-designer.",
-  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo; regra completa em _shared/token-economy.md do módulo wizz.",
+  "Trabalho mecânico (varredura, lookup, diff repetitivo, mudança já especificada): não execute na sessão; dispare 2+ subagentes wizz-exec-haiku/wizz-exec-sonnet em paralelo, um por arquivo/módulo. Trabalho difícil escala pra wizz-exec-opus (só se a sessão roda acima de Opus) e review de diff vai pro wizz-exec-review (modelo da sessão); escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/subagents/codex/wizz-exec-haiku.toml

@@ -0,0 +1,16 @@
+name = "wizz-exec-haiku"
+description = """
+Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). Atenção: "haiku" aqui é o DEGRAU da escada Wizz (mais barato), não o modelo Claude Haiku; o modelo real deste subagente é gpt-5.6-luna.
+"""
+model = "gpt-5.6-luna"
+model_reasoning_effort = "low"
+developer_instructions = """
+Você é um executor mecânico do Wizz Method. Recebe um brief fechado e executa à risca.
+
+Regras:
+
+- Não tome decisão de arquitetura, design ou produto. Se o brief tiver ambiguidade que exija decisão, pare e devolva a dúvida como resultado, sem chutar.
+- Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.
+"""

package/src/modules/wizz/subagents/codex/wizz-exec-opus.toml

@@ -0,0 +1,18 @@
+name = "wizz-exec-opus"
+description = """
+Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Degrau condicional: despachar só quando a sessão principal roda um modelo acima deste degrau; se a sessão já é o topo, pule e use wizz-exec-review. Atenção: "opus" aqui é o DEGRAU mais forte da escada Wizz, não o modelo Claude Opus; o modelo real deste subagente é gpt-5.6.
+"""
+model = "gpt-5.6"
+model_reasoning_effort = "high"
+developer_instructions = """
+Você é um executor sênior do Wizz Method. Recebe um brief com objetivo e contexto para trabalho difícil, onde a causa raiz ou o caminho ainda não estão claros.
+
+Regras:
+
+- Investigue a causa raiz antes de mexer em qualquer arquivo. Não aplique correção superficial em cima de sintoma.
+- Decisão técnica LOCAL (nome de abstração, estrutura interna do módulo) é sua. Decisão de arquitetura ampla ou de produto não é: devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.
+"""

package/src/modules/wizz/subagents/codex/wizz-exec-review.toml

@@ -0,0 +1,17 @@
+name = "wizz-exec-review"
+description = """
+Revisor do Wizz Method. Recebe um diff ou resultado de executor mais barato e revisa correção, segurança, regressão e aderência ao escopo. Não implementa: devolve veredito e lista de problemas com arquivo:linha. Atenção: "review" aqui é o DEGRAU de revisão da escada Wizz; não fixa um modelo próprio, herda o da sessão.
+"""
+# sem model: usa o default_subagent_model da sessão
+sandbox_mode = "read-only"
+developer_instructions = """
+Você é um revisor adversarial do Wizz Method. Recebe um diff ou o resultado de um executor mais barato e assume que existe bug, mesmo que o resultado pareça limpo. Procure ativamente.
+
+Regras:
+
+- Verifique correção, segurança e regressão, arquivo por arquivo.
+- Verifique aderência ao escopo: qualquer mudança fora do brief original é finding, não elogio.
+- Não edite nenhum arquivo. Sua função é avaliar, não implementar.
+- Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
+- Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.
+"""

package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.toml

@@ -0,0 +1,17 @@
+name = "wizz-exec-sonnet"
+description = """
+Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). Atenção: "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo Claude Sonnet; o modelo real deste subagente é gpt-5.6-terra.
+"""
+model = "gpt-5.6-terra"
+model_reasoning_effort = "medium"
+developer_instructions = """
+Você é um executor de implementação do Wizz Method. Recebe um brief com objetivo e contexto e implementa.
+
+Regras:
+
+- Detalhe de implementação é seu; decisão de arquitetura ou produto não é. Se aparecer uma, devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.
+"""

package/src/modules/wizz/subagents/gemini/wizz-exec-haiku.md

@@ -0,0 +1,15 @@
+---
+name: wizz-exec-haiku
+description: Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
+kind: local
+model: gemini-3-flash-preview
+---
+
+Você é um executor mecânico do Wizz Method. Recebe um brief fechado e executa à risca.
+
+Regras:
+
+- Não tome decisão de arquitetura, design ou produto. Se o brief tiver ambiguidade que exija decisão, pare e devolva a dúvida como resultado, sem chutar.
+- Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.

package/src/modules/wizz/subagents/gemini/wizz-exec-opus.md

@@ -0,0 +1,17 @@
+---
+name: wizz-exec-opus
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Degrau condicional: despachar só quando a sessão principal roda um modelo acima deste degrau; se a sessão já é o topo, pule e use wizz-exec-review. "opus" aqui é o DEGRAU mais forte da escada Wizz, não o modelo subjacente.
+kind: local
+model: gemini-3-pro-preview
+---
+
+Você é um executor sênior do Wizz Method. Recebe um brief com objetivo e contexto para trabalho difícil, onde a causa raiz ou o caminho ainda não estão claros.
+
+Regras:
+
+- Investigue a causa raiz antes de mexer em qualquer arquivo. Não aplique correção superficial em cima de sintoma.
+- Decisão técnica LOCAL (nome de abstração, estrutura interna do módulo) é sua. Decisão de arquitetura ampla ou de produto não é: devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.

package/src/modules/wizz/subagents/gemini/wizz-exec-review.md

@@ -0,0 +1,15 @@
+---
+name: wizz-exec-review
+description: Revisor do Wizz Method, herda o modelo da sessão por default. Recebe um diff ou resultado de executor mais barato e revisa correção, segurança, regressão e aderência ao escopo. Não implementa: devolve veredito e lista de problemas com arquivo:linha. "review" aqui é o DEGRAU de revisão da escada Wizz.
+kind: local
+---
+
+Você é um revisor adversarial do Wizz Method. Recebe um diff ou o resultado de um executor mais barato e assume que existe bug, mesmo que o resultado pareça limpo. Procure ativamente.
+
+Regras:
+
+- Verifique correção, segurança e regressão, arquivo por arquivo.
+- Verifique aderência ao escopo: qualquer mudança fora do brief original é finding, não elogio.
+- Não edite nenhum arquivo. Sua função é avaliar, não implementar.
+- Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
+- Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.

package/src/modules/wizz/subagents/gemini/wizz-exec-sonnet.md

@@ -0,0 +1,16 @@
+---
+name: wizz-exec-sonnet
+description: Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
+kind: local
+model: gemini-3-flash-preview
+---
+
+Você é um executor de implementação do Wizz Method. Recebe um brief com objetivo e contexto e implementa.
+
+Regras:
+
+- Detalhe de implementação é seu; decisão de arquitetura ou produto não é. Se aparecer uma, devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.

package/src/modules/wizz/subagents/opencode/wizz-exec-haiku.md

@@ -0,0 +1,14 @@
+---
+description: Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
+mode: subagent
+model: anthropic/claude-haiku-4-5
+---
+
+Você é um executor mecânico do Wizz Method. Recebe um brief fechado e executa à risca.
+
+Regras:
+
+- Não tome decisão de arquitetura, design ou produto. Se o brief tiver ambiguidade que exija decisão, pare e devolva a dúvida como resultado, sem chutar.
+- Toque apenas os arquivos listados no brief. Nada de melhoria extra fora do escopo.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Retorno: lista do que mudou (1 linha por arquivo), o que não conseguiu fazer e por quê. Sem narração, sem introdução.

package/src/modules/wizz/subagents/opencode/wizz-exec-opus.md

@@ -0,0 +1,16 @@
+---
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Degrau condicional: despachar só quando a sessão principal roda um modelo acima deste degrau; se a sessão já é o topo, pule e use wizz-exec-review. "opus" aqui é o DEGRAU mais forte da escada Wizz, não o modelo subjacente.
+mode: subagent
+model: anthropic/claude-opus-5
+---
+
+Você é um executor sênior do Wizz Method. Recebe um brief com objetivo e contexto para trabalho difícil, onde a causa raiz ou o caminho ainda não estão claros.
+
+Regras:
+
+- Investigue a causa raiz antes de mexer em qualquer arquivo. Não aplique correção superficial em cima de sintoma.
+- Decisão técnica LOCAL (nome de abstração, estrutura interna do módulo) é sua. Decisão de arquitetura ampla ou de produto não é: devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.

package/src/modules/wizz/subagents/opencode/wizz-exec-review.md

@@ -0,0 +1,16 @@
+---
+description: Revisor do Wizz Method no modelo herdado da sessão pai. Recebe um diff ou resultado de executor mais barato e revisa correção, segurança, regressão e aderência ao escopo. Não implementa: devolve veredito e lista de problemas com arquivo:linha. "review" aqui é o DEGRAU de revisão da escada Wizz.
+mode: subagent
+permission:
+  edit: deny
+---
+
+Você é um revisor adversarial do Wizz Method. Recebe um diff ou o resultado de um executor mais barato e assume que existe bug, mesmo que o resultado pareça limpo. Procure ativamente.
+
+Regras:
+
+- Verifique correção, segurança e regressão, arquivo por arquivo.
+- Verifique aderência ao escopo: qualquer mudança fora do brief original é finding, não elogio.
+- Não edite nenhum arquivo. Sua função é avaliar, não implementar.
+- Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
+- Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.

package/src/modules/wizz/subagents/opencode/wizz-exec-sonnet.md

@@ -0,0 +1,15 @@
+---
+description: Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
+mode: subagent
+model: anthropic/claude-sonnet-5
+---
+
+Você é um executor de implementação do Wizz Method. Recebe um brief com objetivo e contexto e implementa.
+
+Regras:
+
+- Detalhe de implementação é seu; decisão de arquitetura ou produto não é. Se aparecer uma, devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), resultado de testes, pendências. Sem narração.

package/src/modules/wizz/subagents/wizz-exec-opus.md

@@ -0,0 +1,16 @@
+---
+name: wizz-exec-opus
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Degrau condicional: despachar só quando a sessão principal roda um modelo acima de Opus (ex.: Fable); se a sessão já é Opus, pule este degrau e use wizz-exec-review.
+model: opus
+---
+
+Você é um executor sênior do Wizz Method. Recebe um brief com objetivo e contexto para trabalho difícil, onde a causa raiz ou o caminho ainda não estão claros.
+
+Regras:
+
+- Investigue a causa raiz antes de mexer em qualquer arquivo. Não aplique correção superficial em cima de sintoma.
+- Decisão técnica LOCAL (nome de abstração, estrutura interna do módulo) é sua. Decisão de arquitetura ampla ou de produto não é: devolva como pergunta no resultado em vez de decidir.
+- Respeite o escopo do brief. Refactor oportunista fora do escopo, não.
+- Siga o estilo do código ao redor (nomes, densidade de comentários, idioma).
+- Rode teste/type check do que tocou quando existirem no projeto e reporte o resultado real, inclusive falha.
+- Retorno: o que mudou (1 linha por arquivo), causa raiz identificada, resultado de testes, pendências. Sem narração.

package/src/modules/wizz/subagents/wizz-exec-review.md

@@ -0,0 +1,15 @@
+---
+name: wizz-exec-review
+description: Revisor do Wizz Method no modelo da sessão (inherit). Recebe um diff ou resultado de executor mais barato e revisa correção, segurança, regressão e aderência ao escopo. Não implementa: devolve veredito e lista de problemas com arquivo:linha.
+model: inherit
+---
+
+Você é um revisor adversarial do Wizz Method. Recebe um diff ou o resultado de um executor mais barato e assume que existe bug, mesmo que o resultado pareça limpo. Procure ativamente.
+
+Regras:
+
+- Verifique correção, segurança e regressão, arquivo por arquivo.
+- Verifique aderência ao escopo: qualquer mudança fora do brief original é finding, não elogio.
+- Não edite nenhum arquivo. Sua função é avaliar, não implementar.
+- Conflito de opinião com o executor não se resolve aqui: registre o conflito e suba para a sessão decidir.
+- Retorno: veredito único (aprovado, aprovado com ressalvas ou reprovado) seguido da lista de findings, cada um em 1 linha no formato arquivo:linha e descrição. Sem narração.

package/src/skills-lib/ai-product-design/SKILL.md

@@ -6,7 +6,9 @@ description: >
   agente/assistente/chatbot, escrever ou revisar system prompt, definir persona/tom/voz, montar few-shot,
   chain-of-thought, guardrails, recusas, escalonamento pra humano, handoff entre agentes, detecção de
   frustração, generative UI, ou medir qualidade de saída de IA. Base: Owl-Listener/ai-design-skills (MIT).
-  44 padrões em 6 categorias, cada um detalhado em references/.
+  44 padrões em 6 categorias, cada um detalhado em references/. Use quando o pedido mencionar system
+  prompt, persona de agente, guardrails, orquestração multi-agente, handoff entre agentes ou avaliação
+  de qualidade de IA.
 ---
 
 # AI Product Design — 44 padrões

package/src/skills-lib/algorithmic-art/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: algorithmic-art
-description: Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
+description: Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations. Use when the user asks for generative art, code art, p5.js sketches, flow fields, particle systems, or an interactive algorithmic-art artifact.
 license: Complete terms in LICENSE.txt
 ---
 

package/src/skills-lib/animate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: animate
-description: Animation patterns and best practices for Next.js/React applications. Use this skill when implementing animations, transitions, hover effects, page transitions, modals, or any motion in React components. Based on Emil Kowalski's "Animations on the Web" course.
+description: Animation patterns and best practices for Next.js/React applications. Use this skill when implementing animations, transitions, hover effects, page transitions, modals, or any motion in React components. Based on Emil Kowalski's "Animations on the Web" course. Use when the user asks to add hover effects, transitions, page transitions, modals, or any motion to a Next.js or React component.
 ---
 
 # Next.js Animations

package/src/skills-lib/auth-and-secrets/SKILL.md

@@ -4,7 +4,8 @@ description: >
   Segurança de autenticação e gestão de secrets. Usar quando: implementar auth, lidar com JWT/OAuth/SSO,
   token no header vs URL, revogação de token no logout, enumeração de usuário/mensagem genérica,
   guardar API keys ou credenciais, configurar Clerk/Supabase auth, revisar onde secrets estão armazenados,
-  rotação de credenciais, checar se .env está seguro.
+  rotação de credenciais, checar se .env está seguro. Use quando o usuário mencionar login, cadastro,
+  senha, JWT, OAuth, SSO, 2FA, sessão, logout, API key ou variável de ambiente/.env.
 ---
 
 # Auth and Secrets

package/src/skills-lib/canvas-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: canvas-design
-description: Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
+description: Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. Use when the user asks for a poster, art piece, print design, or other static visual output as a .png or .pdf.
 license: Complete terms in LICENSE.txt
 ---
 

package/src/skills-lib/cerebro/SKILL.md

@@ -9,6 +9,8 @@ description: >
   usuário entre Claude Code, Codex e qualquer outro agente.
   CONTEXT.md no repo é o espelho do vault para agentes cloud (Codex). Fluxo: Codex atualiza
   CONTEXT.md → usuário roda /sync no Claude Code → vault atualizado.
+  Use quando o usuário digitar um desses comandos de barra ou mencionar memória, sessão,
+  decisão, ideia de conteúdo, prospect ou sincronização do cérebro.
 ---
 
 # Cérebro — Sistema de Memória Persistente

package/src/skills-lib/copywriting/references/copy-frameworks.md

@@ -326,9 +326,12 @@ Each step should be:
 - **Outcome-oriented**: What they get from this step
 
 Example:
+
+```text
 1. Connect your tools (takes 2 minutes)
 2. Set your preferences
 3. Get automated reports every Monday
+```
 
 ### Testimonial Selection
 

package/src/skills-lib/ctc-align/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ctc-align
-description: Timestamps palavra a palavra confiáveis para narração TTS via alinhamento forçado (ctc-forced-aligner + âncora nos silêncios reais). Usar SEMPRE antes de definir tempo de legenda, corte de cena, animação ou elemento sincronizado com fala em qualquer vídeo (HyperFrames ou outro editor). Substitui o Whisper como fonte de timing quando o texto do roteiro é conhecido. Gatilhos - sincronizar legenda, timing de cena, alinhar áudio e texto, palavra a palavra, forced alignment, legenda karaokê, corrigir sync de vídeo.
+description: Timestamps palavra a palavra confiáveis para narração TTS via alinhamento forçado (ctc-forced-aligner + âncora nos silêncios reais). Usar SEMPRE antes de definir tempo de legenda, corte de cena, animação ou elemento sincronizado com fala em qualquer vídeo (HyperFrames ou outro editor). Substitui o Whisper como fonte de timing quando o texto do roteiro é conhecido. Gatilhos - sincronizar legenda, timing de cena, alinhar áudio e texto, palavra a palavra, forced alignment, legenda karaokê, corrigir sync de vídeo. Use quando o roteiro exato da narração for conhecido e for preciso decidir timing de legenda, corte de cena ou animação sincronizada com a fala.
 ---
 
 # ctc-align — timing de fala como fonte única de verdade

package/src/skills-lib/database-and-deps/SKILL.md

@@ -3,7 +3,8 @@ name: database-and-deps
 description: >
   Segurança de banco de dados e dependências. Usar quando: revisar queries de banco, checar SQL injection,
   auditar permissões de banco, criptografar PII, revisar pacotes vulneráveis, configurar Dependabot/Renovate,
-  auditar RPCs Supabase, verificar menor privilégio no banco.
+  auditar RPCs Supabase, verificar menor privilégio no banco. Use quando o usuário mencionar SQL,
+  query builder, RPC do Supabase, npm/pnpm audit, Dependabot, pacotes vulneráveis, PII no banco ou lock file.
 ---
 
 # Database and Dependencies Security

package/src/skills-lib/decision-maker/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: decision-maker
-description: Walk a founder or designer through building a sharp visual brief for a website project, then output four ready-to-use prompts for downstream AI tools (Copywriter, 3D/Illustration, Design, Developer) plus GitHub + Vercel launch instructions. Use this skill whenever a user wants to brief a website, build a landing page with AI, create a visual direction, define a brand brief, or says anything like "I want to build a site with Claude," "help me write a brief," "I want to make a premium website," "guide me through a website project," or starts a slash command like `/start`, `/decision`, `/references`, `/extract`, or `/output`. Trigger even when the user just describes a project they want to build without explicitly asking for a brief — the skill turns vague intent into a structured, executable visual direction.
+description: Walk a founder or designer through building a sharp visual brief for a website project, then output four ready-to-use prompts for downstream AI tools (Copywriter, 3D/Illustration, Design, Developer) plus GitHub + Vercel launch instructions. Use this skill whenever a user wants to brief a website, build a landing page with AI, create a visual direction, define a brand brief, or says anything like "I want to build a site with Claude," "help me write a brief," "I want to make a premium website," "guide me through a website project," or starts a slash command like `/start`, `/decision`, `/references`, `/extract`, or `/output`. Trigger even when the user just describes a project they want to build without explicitly asking for a brief — the skill turns vague intent into a structured, executable visual direction. Use when the user wants to brief a website, define a visual direction, or plan a landing page before building it with AI.
 ---
 
 # Decision Maker

package/src/skills-lib/desktop-security/SKILL.md

@@ -3,7 +3,8 @@ name: desktop-security
 description: >
   Segurança para apps desktop e Electron. Usar quando: desenvolver app Electron, configurar contextIsolation/IPC,
   implementar code signing, armazenar tokens/credenciais localmente, configurar auto-update seguro,
-  distribuir app para macOS/Windows.
+  distribuir app para macOS/Windows. Use quando o usuário mencionar Electron, IPC, contextBridge,
+  preload script, safeStorage, code signing, notarização ou auto-update.
 ---
 
 # Desktop Security

package/src/skills-lib/enhance-prompt/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: enhance-prompt
-description: Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results.
+description: Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results. Use when the user wants to polish a UI prompt before sending it to Stitch, improve a prompt that produced poor results, or turn a vague UI idea into a structured, design-system-aware prompt.
 allowed-tools:
   - "Read"
   - "Write"

package/src/skills-lib/graphify/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: graphify
-description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report
+description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when the user runs /graphify, wants to turn a codebase or folder into a knowledge graph, or needs to query, explore, or visualize relationships across files.
 trigger: /graphify
 ---
 

package/src/skills-lib/huashu-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: huashu-design
-description: 花叔Design——用HTML做高保真原型、交互Demo、幻灯片、动画、设计变体探索+设计方向顾问+专家评审。根据任务embody对应专家（UX/动画师/幻灯片设计师/原型师），避免web design tropes。触发词：做原型、交互原型、HTML演示、动画Demo、设计变体、hi-fi设计、UI mockup、prototype、做个HTML页面、做个可视化、app原型、iOS原型、导出MP4/GIF、60fps视频、设计风格、设计方向、配色方案、推荐风格、选个风格、做个好看的、评审、好不好看、review this design、带解说的动画、解说视频、长视频科普、voiceover、narration、5分钟讲清楚什么是XX。需求模糊时进设计方向顾问（三套逻辑并行出3版真实视觉，HTML原生40种风格库网页20+PPT20为弹药）；另含品牌资产协议、反AI slop、Junior工作流、Tweaks变体、动画→MP4/GIF导出、带解说长视频pipeline、5维评审。
+description: 花叔Design——用HTML做高保真原型、交互Demo、幻灯片、动画、设计变体探索+设计方向顾问+专家评审。根据任务embody对应专家（UX/动画师/幻灯片设计师/原型师），避免web design tropes。触发词：做原型、交互原型、HTML演示、动画Demo、设计变体、hi-fi设计、UI mockup、prototype、做个HTML页面、做个可视化、app原型、iOS原型、导出MP4/GIF、60fps视频、设计风格、设计方向、配色方案、推荐风格、选个风格、做个好看的、评审、好不好看、review this design、带解说的动画、解说视频、长视频科普、voiceover、narration、5分钟讲清楚什么是XX。需求模糊时进设计方向顾问（三套逻辑并行出3版真实视觉，HTML原生40种风格库网页20+PPT20为弹药）；另含品牌资产协议、反AI slop、Junior工作流、Tweaks变体、动画→MP4/GIF导出、带解说长视频pipeline、5维评审。Use when 用户提到做HTML原型、交互Demo、幻灯片设计、动画Demo、设计变体探索或设计评审。
 ---
 
 # 花叔Design · Huashu-Design

package/src/skills-lib/inicio-de-projeto/SKILL.md

@@ -5,6 +5,8 @@ description: >
   precisar de padrões de arquitetura, definir estrutura de pastas, estabelecer regras de código, começar um app SaaS/produto,
   onboarding de desenvolvedor no projeto. Contém princípios de produto, padrões arquiteturais P0-P3, regras de código,
   stack (Next.js + Supabase + Clerk + Zod), estrutura de pastas e checklist de início.
+  Use quando o pedido for começar um projeto novo, criar um módulo/feature do zero, ou definir
+  arquitetura, stack e estrutura de pastas antes de codar.
 ---
 
 # Início de Projeto — Padrões de Engenharia

package/src/skills-lib/premium-landing-ui-researcher/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: premium-landing-ui-researcher
-description: Pesquisar animações, componentes, referências visuais e padrões de conversão para criar landing pages premium em React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js e React Three Fiber. Use esta skill quando o usuário pedir para analisar um projeto existente, classificar o nível de complexidade do site (básico, intermediário, avançado, 3D high-end com modo Signature), escolher componentes ou animações adequados, melhorar uma UI genérica, criar uma landing page completa, transformar uma oferta em página estratégica, projetar também um dashboard SaaS junto da landing, criar um site de autoridade/portfolio para agência, estúdio, consultoria, marca pessoal ou lead passivo, criar case studies e selected work editoriais, criar uma experiência 3D cinematográfica para marcas premium, buscar referências em React Bits, Cult UI, Componentry, Animmaster Lib, Ali Imam, Watermelon UI, StyleUI, Bklit UI, Refero, Impeccable, Taste Skill, Design Motion Principles, MotionSites, Vibe Code Components, Landing Love, Godly, Design Spells, Mobbin, ScreensDesign, DesignVault, Spline, Unicorn Studio, Skiper UI, 21st.dev (Magic MCP ou 21st CLI), escolher entre GSAP, anime.js e Framer Motion para animações e scroll storytelling, ou implementar uma experiência visual sofisticada orientada à conversão ou à autoridade.
+description: Pesquisar animações, componentes, referências visuais e padrões de conversão para criar landing pages premium em React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js e React Three Fiber. Use quando o pedido envolver analisar projeto existente; classificar nível de complexidade do site (básico a 3D high-end/Signature); escolher componentes/animações; melhorar UI genérica; criar landing page completa, transformar oferta em página estratégica, dashboard SaaS, site de autoridade/portfolio (agência, estúdio, consultoria, marca pessoal, lead passivo), case studies/selected work editoriais, ou experiência 3D cinematográfica para marcas premium; buscar referências em fontes premium (React Bits, Cult UI, Watermelon UI, Skiper UI, 21st.dev via Magic MCP/CLI, outras em references/component-sources.md); ou escolher motion engine (GSAP, anime.js, Framer Motion, Three.js/R3F) para scroll storytelling.
 ---
 
 # Premium Landing UI Researcher

package/src/skills-lib/react-components/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: react-components
-description: Converts Stitch designs into modular Vite and React components using system-level networking and AST-based validation.
+description: Converts Stitch designs into modular Vite and React components using system-level networking and AST-based validation. Use when the user wants to turn a Stitch design/screen into React components, or mentions the Stitch MCP, Vite scaffolding, or AST-based component validation.
 allowed-tools:
   - "stitch*:*"
   - "Bash"

package/src/skills-lib/remotion-best-practices/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: remotion-best-practices
-description: Best practices for Remotion - Video creation in React
+description: Best practices for Remotion - Video creation in React. Use when assembling the final video with audio, SFX, captions, or frame-accurate timing, or for any Remotion (React) code.
 metadata:
   tags: remotion, video, react, animation, composition
 ---

package/src/skills-lib/supabase-postgres-best-practices/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: supabase-postgres-best-practices
-description: Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
+description: Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations. Use when the user asks about missing indexes, connection pooling, RLS performance, N+1 queries, or Postgres/Supabase schema design.
 license: MIT
 metadata:
   author: supabase

package/src/skills-lib/taste-redesign/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: taste-redesign
-description: Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS.
+description: Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS. Use when the user asks to redesign, upgrade, or audit an existing site or app that looks generic or AI-generated, without rewriting it from scratch.
 ---
 
 # Redesign Skill

package/src/skills-lib/ui-ux-pro-max/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ui-ux-pro-max
-description: "UI/UX design intelligence. 67 styles, 96 palettes, 57 font pairings, 25 charts, 13 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples."
+description: "UI/UX design intelligence. 67 styles, 96 palettes, 57 font pairings, 25 charts, 13 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples. Use when the user asks to design, build, or review UI/UX, pick a color palette or font pairing, or style a component like a button, modal, navbar, or card."
 ---
 # UI/UX Pro Max - Design Intelligence
 

package/src/skills-lib/web-security/SKILL.md

@@ -5,6 +5,7 @@ description: >
   adicionar endpoint de API, lidar com input de usuário, configurar headers, CSP, rate limiting, CORS, clickjacking,
   IDOR, SQL injection, vazamento de PII/dados na resposta, enumeração de usuário, OWASP Top 10.
   Inclui triagem de falhas recorrentes de pentest + checklist das 8 vulnerabilidades e exemplos para Next.js + Supabase + Clerk.
+  Use quando o usuário pedir auditoria de segurança ou revisão pré-deploy, ou mencionar CORS, CSP, rate limiting, IDOR ou OWASP.
 ---
 
 # Web Security (OWASP Top 10)

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -44,7 +44,9 @@ Use esta tabela **só fora de projeto Wizz** (sem `_wizz/`), quando o router map
 | Animação, motion, vídeo programático em código, Remotion, Three.js, 3D, WebGL | `motion-3d-director` + `remotion-best-practices` | 1 |
 | Craft de animação/micro-interação, easing, timing, reduced-motion, "essa animação travou/tá ruim" | `animate` + `design-motion-principles` | 2 |
 | Gerar imagem por código: carrossel, quote card, infográfico (PNG/PDF editável), fundo/textura generativa de hero | `canvas-design` + `algorithmic-art` | 2 |
-| Renderizar vídeo de HTML/CSS (HTML→MP4, agent-native) | CLI `hyperframes` (registry designer; `npx skills add heygen-com/hyperframes`) | 2 |
+| **Vídeo com áudio, narração, SFX ou legenda sincronizada** (montagem do filme) | `remotion-best-practices` (Remotion monta; timing de frame). Regra do pipeline: HyperFrames desenha as telas mudas, Remotion monta o filme — não usar hyperframes para posicionar áudio/legenda (drift de ~2,76s e CSS vazando entre telas em produção) | 1 |
+| Desenhar TELA/cena de vídeo em HTML/CSS, visual mudo (maqueta de app, gráfico animado, título, loop; HTML→MP4) | CLI `hyperframes` (registry designer; `npx skills add heygen-com/hyperframes`) — só telas mudas; montagem com áudio vai pro Remotion (linha acima) | 2 |
+| Timestamps palavra a palavra de narração TTS (sincronizar legenda/corte/animação com a fala) | `ctc-align` (registry designer; fonte única de timing, substitui Whisper) | 2 |
 | **Editar/cortar vídeo** (cortes, selects, roughcut) | CLI `buttercut` (registry designer; **só Apple Silicon**, clone-and-run no projeto, deps pesadas) | 1 |
 | Gerar vídeo-ad/imagem por IA (Sora/Veo/Kling) + publicar Meta | CLI `arcads` (registry `ads`; git clone + Arcads API key) | 1 |
 | Analisar/entender vídeo existente (frames + transcrição) | CLI `claude-video` (registry designer; `npx skills add bradautomates/claude-video`) | 2 |

package/tools/installer/ide/_config-driven.js

@@ -476,37 +476,49 @@ class ConfigDrivenIdeSetup {
 
   /**
    * Install WIZZ-authored native subagents (e.g. wizz-exec-haiku.md,
-   * wizz-exec-sonnet.md) into the platform's subagent directory.
+   * wizz-exec-sonnet.md, or a platform-specific wizz-exec-haiku.toml) into
+   * the platform's subagent directory.
    *
-   * Only Claude Code declares `agents_target_dir` today — it's the only
-   * platform whose native subagent files honor a `model:` frontmatter field.
-   * The source lives inside the installed wizz module at
-   * `{wizzDir}/wizz/subagents/`, mirroring how `installVerbatimSkills`
-   * resolves module-relative source paths.
+   * Claude Code, Codex, OpenCode, and Gemini CLI declare `agents_target_dir`.
+   * Each platform reads its own native subagent file format, so the source
+   * files live in a per-platform subdirectory declared via
+   * `agents_source_subdir`: `{wizzDir}/wizz/subagents/<subdir>/`. Claude
+   * Code has no subdir — its files sit directly in `{wizzDir}/wizz/subagents/`
+   * as *.md with a `model:` frontmatter field, which is the only native
+   * format that field means anything to. This mirrors how
+   * `installVerbatimSkills` resolves module-relative source paths.
    *
-   * Ownership is scoped to the `wizz-exec-*.md` naming convention — only
-   * files matching that pattern are ever written here, so a user's own
-   * hand-authored subagents in the same directory are never touched.
+   * Ownership is scoped to the `wizz-exec-*` naming convention (`.md` or
+   * `.toml` extension) — only files matching that pattern are ever written
+   * here, so a user's own hand-authored subagents in the same directory are
+   * never touched. Directory entries (including the per-platform subdirs
+   * that live alongside Claude Code's root-level files) are skipped
+   * explicitly rather than relying on the extension filter to exclude them.
    * Silently no-ops when the source directory doesn't exist (e.g. install
    * without the wizz module).
    *
    * @param {string} projectDir - Project directory
    * @param {string} wizzDir - WIZZ installation directory
    * @param {Object} config - Installation configuration; reads agents_target_dir
+   *   and the optional agents_source_subdir
    * @returns {Promise<number>} Count of subagent files installed
    */
   async installSubagents(projectDir, wizzDir, config) {
-    const sourceDir = path.join(wizzDir, 'wizz', 'subagents');
+    const sourceDir = config.agents_source_subdir
+      ? path.join(wizzDir, 'wizz', 'subagents', config.agents_source_subdir)
+      : path.join(wizzDir, 'wizz', 'subagents');
     if (!(await fs.pathExists(sourceDir))) return 0;
 
     let entries;
     try {
-      entries = await fs.readdir(sourceDir);
+      entries = await fs.readdir(sourceDir, { withFileTypes: true });
     } catch {
       return 0;
     }
 
-    const subagentFiles = entries.filter((entry) => entry.startsWith('wizz-exec-') && entry.endsWith('.md'));
+    const subagentFiles = entries.filter(
+      (entry) => entry.isFile() && entry.name.startsWith('wizz-exec-') && (entry.name.endsWith('.md') || entry.name.endsWith('.toml')),
+    );
     if (subagentFiles.length === 0) return 0;
 
     const targetPath = path.join(projectDir, config.agents_target_dir);
@@ -514,7 +526,7 @@ class ConfigDrivenIdeSetup {
 
     let count = 0;
     for (const entry of subagentFiles) {
-      await fs.copy(path.join(sourceDir, entry), path.join(targetPath, entry), { overwrite: true });
+      await fs.copy(path.join(sourceDir, entry.name), path.join(targetPath, entry.name), { overwrite: true });
       count++;
     }
 
@@ -617,12 +629,12 @@ class ConfigDrivenIdeSetup {
       );
     }
 
-    // Clean stale wizz-exec-*.md subagent files. Like command pointers, these
-    // live in a per-IDE directory (.claude/agents) that isn't deduped across
-    // peers, so this runs regardless of skipTarget. installSubagents always
-    // overwrites with the current source content, so unconditional removal
-    // here is safe — a routine reinstall just recreates the files moments
-    // later.
+    // Clean stale wizz-exec-* subagent files (.md or .toml). Like command
+    // pointers, these live in a per-IDE directory (e.g. .claude/agents,
+    // .codex/agents) that isn't deduped across peers, so this runs
+    // regardless of skipTarget. installSubagents always overwrites with the
+    // current source content, so unconditional removal here is safe — a
+    // routine reinstall just recreates the files moments later.
     if (this.installerConfig?.agents_target_dir) {
       await this.cleanupSubagents(projectDir, this.installerConfig.agents_target_dir);
     }
@@ -793,11 +805,12 @@ class ConfigDrivenIdeSetup {
   }
 
   /**
-   * Remove WIZZ-owned `wizz-exec-*.md` subagent files from the platform's
-   * subagent directory (e.g. .claude/agents). Symmetric counterpart to
-   * installSubagents. Only touches files matching that naming convention —
-   * a user's own hand-authored subagents in the same directory are never
-   * removed. Removes the directory entirely if it ends up empty.
+   * Remove WIZZ-owned `wizz-exec-*` subagent files (`.md` or `.toml`) from
+   * the platform's subagent directory (e.g. .claude/agents, .codex/agents).
+   * Symmetric counterpart to installSubagents. Only touches files matching
+   * that naming convention — a user's own hand-authored subagents in the
+   * same directory are never removed. Removes the directory entirely if it
+   * ends up empty.
    * @param {string} projectDir
    * @param {string} agentsTargetDir - Relative dir (e.g. .claude/agents)
    */
@@ -807,15 +820,16 @@ class ConfigDrivenIdeSetup {
 
     let entries;
     try {
-      entries = await fs.readdir(agentsPath);
+      entries = await fs.readdir(agentsPath, { withFileTypes: true });
     } catch {
       return;
     }
 
     for (const entry of entries) {
-      if (!entry.startsWith('wizz-exec-') || !entry.endsWith('.md')) continue;
+      if (!entry.isFile()) continue;
+      if (!entry.name.startsWith('wizz-exec-') || !(entry.name.endsWith('.md') || entry.name.endsWith('.toml'))) continue;
       try {
-        await fs.remove(path.join(agentsPath, entry));
+        await fs.remove(path.join(agentsPath, entry.name));
       } catch {
         // Skip files we can't remove.
       }

package/tools/installer/ide/platform-codes.yaml

@@ -8,9 +8,14 @@
 #     target_dir: Directory where skill directories are installed (project/workspace)
 #     global_target_dir: (optional) User-home directory for global install
 #     ancestor_conflict_check: (optional) Refuse install when ancestor dir has WIZZ files
-#     agents_target_dir: (optional) Directory for native Claude Code subagents
-#       (src/modules/wizz/subagents/*.md). Only claude-code supports the
-#       `model:` frontmatter field these files rely on.
+#     agents_target_dir: (optional) Directory for native WIZZ-authored subagents
+#       (src/modules/wizz/subagents/). Currently declared by claude-code, codex,
+#       opencode, and gemini.
+#     agents_source_subdir: (optional) Subdirectory under subagents/ that holds
+#       the platform's native subagent file format (e.g. codex/*.toml,
+#       opencode/*.md, gemini/*.md). Omitted for claude-code, which reads
+#       straight from the subagents/ root (its native format is *.md with a
+#       `model:` frontmatter field).
 #
 # INSTALL SCOPE — LOCAL PER PROJECT IS THE ENFORCED DEFAULT.
 # The installer only ever writes skills to the project-relative `target_dir`
@@ -82,6 +87,8 @@ platforms:
     installer:
       target_dir: .agents/skills
       global_target_dir: ~/.codex/skills
+      agents_target_dir: .codex/agents
+      agents_source_subdir: codex
 
   codewhale:
     name: "CodeWhale"
@@ -145,6 +152,8 @@ platforms:
     installer:
       target_dir: .agents/skills
       global_target_dir: ~/.agents/skills
+      agents_target_dir: .gemini/agents
+      agents_source_subdir: gemini
 
   github-copilot:
     name: "GitHub Copilot"
@@ -258,6 +267,8 @@ platforms:
       target_dir: .agents/skills
       global_target_dir: ~/.agents/skills
       commands_target_dir: .opencode/commands
+      agents_target_dir: .opencode/agents
+      agents_source_subdir: opencode
 
   openhands:
     name: "OpenHands"