wizz-method 1.18.1 → 1.18.3

package/README.md

@@ -21,7 +21,7 @@ O ponto de entrada técnico é o `wizz-router`: ele faz a triagem e manda pedido
 | ✍️ `wizz-copy` | Copy, e-mail, headlines | copywriting, email-sequence, humanizer, copy-editing |
 | 🔍 `wizz-seo` | SEO tradicional e de IA | seo-audit, ai-seo, schema-markup, programmatic-seo, site-architecture |
 | 📈 `wizz-growth` | Marketing, CRO, lançamento, preço, churn | marketing-ideas, page-cro, launch-strategy, pricing-strategy, churn-prevention |
-| 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking, MCP meta-ads |
+| 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking |
 | 🧠 `wizz-memoria` | Memória do projeto | cerebro |
 
 Os papéis de dev e produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `src/modules/wizz/overrides/`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "1.18.1",
+  "version": "1.18.3",
   "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

@@ -355,15 +355,6 @@ areas:
         not_when:
           - "Google Ads institucional, campanha de marca, lead gen B2B."
           - "Escrever copy ou criativo: a skill lê número, não produz anúncio."
-    mcps:
-      - id: meta-ads
-        when: "Gestão real de campanha Meta/Facebook/Instagram via API (criar/editar/medir ads)."
-        server:
-          command: npx
-          # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-          args: ["-y", "mcp-meta-ads@1.0.0"]
-          env:
-            META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
 
   architect:
     agent: wizz-agent-architect

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

@@ -26,9 +26,10 @@ o entrypoint da skill e apenas as referências necessárias (progressive disclos
   `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.
+  falharem 2x. `opus` é degrau real só quando a sessão que delega roda
+  acima de Opus (Fable); em sessão Opus quem recebe pula para `review`
+  (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

@@ -11,7 +11,7 @@ Personalização do WIZZ para a Wizz: linguagem fácil e resumida, cada agente t
 | `wizz-copy` | ✍️ | Copy, e-mail, headlines | copywriting, email-sequence, humanizer, copy-editing |
 | `wizz-seo` | 🔍 | SEO tradicional e de IA | seo-audit, ai-seo, schema-markup, programmatic-seo, site-architecture |
 | `wizz-growth` | 📈 | Marketing, CRO, lançamento, preço, churn | marketing-ideas, page-cro, launch-strategy, pricing-strategy, churn-prevention |
-| `wizz-ads` | 📢 | Mídia paga | paid-ads, ad-creative, analytics-tracking, MCP meta-ads |
+| `wizz-ads` | 📢 | Mídia paga | paid-ads, ad-creative, analytics-tracking |
 | `wizz-memoria` | 🧠 | Memória do projeto | cerebro |
 
 Os papéis de dev/produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `overrides/`.
@@ -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`): 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`.
+- **Economia de token** (`_shared/token-economy.md`): 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), o modelo da sessão é o chefe (orquestra e decide, não executa): `wizz-exec-opus` é o destino padrão do trabalho difícil em sessão Fable e `wizz-exec-review` roda pinado no degrau Forte, nunca herda a sessão; 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

@@ -2,6 +2,20 @@
 
 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.
 
+## O chefe é o modelo da sessão
+
+O modelo da sessão principal é o chefe: orquestra, arbitra conflito entre executor e revisor, decide arquitetura e produto. O chefe não executa; delega para os degraus abaixo dele. Quem é o chefe muda com o `/model` da sessão, e o que muda junto é só QUAIS degraus ficam abaixo:
+
+| Sessão (chefe) | Degraus abaixo do chefe | Onde cai trabalho difícil |
+|---|---|---|
+| Fable / Mythos (acima de Opus) | haiku, sonnet, opus, review | `wizz-exec-opus` |
+| Opus | haiku, sonnet, review | o próprio chefe (é o mesmo modelo do degrau Forte, com o contexto já carregado) |
+| Sonnet ou abaixo | haiku, review | o próprio chefe; review continua pinado no degrau Forte (revisa forte mesmo em sessão barata) |
+
+Como saber quem é o chefe em Claude Code: o system prompt declara o modelo da sessão ("You are powered by the model named ..."). Fable e Mythos ficam acima de Opus.
+
+A mesma lógica vale em toda plataforma, trocando os nomes pelos da tabela abaixo. Em Codex: sessão num modelo acima de gpt-5.6 (ex.: astra) → `wizz-exec-opus` (gpt-5.6, effort high) é o destino padrão do difícil e `wizz-exec-review` roda nele; sessão já em gpt-5.6 → o chefe absorve o degrau Forte. Em OpenCode e Gemini CLI, idem com claude-opus-5 e gemini-3-pro-preview.
+
 ## Tabela de degraus
 
 | Degrau | Subagente | Uso | Claude Code | Codex | OpenCode | Gemini CLI |
@@ -9,14 +23,16 @@ Os nomes `wizz-exec-haiku`/`wizz-exec-sonnet`/`wizz-exec-opus` são nomes de DEG
 | 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) |
+| Revisão | `wizz-exec-review` | review de diff produzido por qualquer degrau; pinado no modelo Forte, nunca herda a sessão | opus | gpt-5.6 (effort high) | anthropic/claude-opus-5 | gemini-3-pro-preview |
 
 ## 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.
+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 o chefe. Em sessão Fable, Sonnet sobe para `wizz-exec-opus`; em sessão Opus, Sonnet sobe direto para o chefe.
+3. Degrau Forte segue o chefe: em sessão acima de Opus (Fable, Mythos), `wizz-exec-opus` é o destino PADRÃO de bug sem causa clara, refactor cruzando módulos e decisão técnica local; o chefe não faz esse trabalho na própria sessão. Em sessão Opus ou abaixo, o degrau Forte coincide com o chefe ou fica acima dele: pule de Padrão direto para `wizz-exec-review` ou para o chefe (pinar opus numa sessão opus duplica custo sem ganho).
+4. Implementa barato, revisa forte: diff produzido por `wizz-exec-haiku`/`wizz-exec-sonnet`/`wizz-exec-opus` passa por `wizz-exec-review` antes de integrar. O revisor roda pinado no degrau Forte da plataforma, não no modelo da sessão: em sessão Fable o review sai do Fable e vai para Opus; em sessão Opus nada muda. Conflito entre executor e revisor sobe para o chefe decidir.
+5. Decisão de arquitetura ou produto nunca desce a escada: fica com o chefe ou com o usuário.
+6. Transparência: todo despacho diz no texto ao usuário o degrau e a quantidade ("3 × Sonnet", "1 × Opus para review"). Nunca só "executores".
+7. Quantidade sem teto: dispare quantos subagentes o trabalho pedir, um por unidade independente (arquivo, módulo, frente de verificação). O mínimo é 2 em paralelo; máximo não existe. O que limita é a partição (dois agentes nunca editam o mesmo arquivo), não um número.
 
 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

@@ -33,10 +33,10 @@ 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.
+- **`wizz-exec-opus`**: bug sem causa clara, refactor cruzando módulos, decisão técnica local. Destino padrão desse trabalho quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve o degrau e pula para review.
+- **`wizz-exec-review`** (pinado no degrau Forte, `opus` em Claude Code): review do diff produzido pelos degraus acima antes de integrar. Não herda a sessão: em sessão Fable o review vai para Opus.
 
-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`.
+Escalada: se o executor devolveu ambiguidade ou os testes falharam 2x no mesmo brief, reemita 1 degrau acima. Máximo 1 escalada por brief. O modelo da sessão é o chefe: orquestra, arbitra e decide; não executa. Todo despacho diz ao usuário degrau e quantidade. Quantidade sem teto: quantos o trabalho pedir, um por unidade independente. Detalhe completo, tabela por plataforma e regras 1-7: `_shared/model-ladder.md`.
 
 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).
 

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

@@ -1,12 +1,12 @@
 ---
 name: wizz-ads
-description: Wizz Method Paid Media Agent. Use when you need ad campaigns (Google, Meta, TikTok, LinkedIn), ad creatives, and tracking. Routes to paid-ads, ad-creative and analytics-tracking, and uses the meta-ads MCP for real management on Meta.
+description: Wizz Method Paid Media Agent. Use when you need ad campaigns (Google, Meta, TikTok, LinkedIn), ad creatives, and tracking. Routes to paid-ads, ad-creative and analytics-tracking.
 ---
 
 # Ads — Mídia Paga
 
 ## Visão geral
-Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompanha métricas. Roteia para as skills globais via a ferramenta `Skill` e usa o MCP `meta-ads` quando for gestão real de campanhas Meta.
+Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompanha métricas. Roteia para as skills globais via a ferramenta `Skill`.
 
 ## Na ativação
 1. **Resolver bloco:** rode `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/{skill-name}.toml`, `.user.toml`).
@@ -20,13 +20,10 @@ Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompa
 
 ## Como trabalho (ponte global)
 
-> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`ads`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/ads.yaml` (já vem como o bloco `areas.ads` completo); 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.ads` lá dentro. Precisando de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia `{project-root}/_wizz/_config/registry/_shared.yaml`. Ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`, ex. `meta-ads`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `arcads` p/ gerar vídeo-ad).
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`ads`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/ads.yaml` (já vem como o bloco `areas.ads` completo); 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.ads` lá dentro. Precisando de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia `{project-root}/_wizz/_config/registry/_shared.yaml`. Ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `arcads` p/ gerar vídeo-ad).
 - Estratégia de campanha, segmentação, lances, ROAS → `paid-ads`
 - Variações de criativo, headlines, copy de anúncio → `ad-creative`
 - Tracking, conversões, UTMs, pixel → `analytics-tracking`
-- Gestão real de campanha Meta (criar/editar/medir) → MCP `meta-ads`
-
-Nunca exponha o `META_ACCESS_TOKEN` em log ou código.
 
 ## Encerramento
 Termine com `✅ O que fiz` / `➡️ Próximo passo` / `🎯 Comando`.

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

@@ -16,17 +16,15 @@ 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. Escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [
   "Gate de planejamento: pedido de execução com complexidade alta e sem PRD/story/brief correspondente → pergunto 1x se crio o artefato antes (recomendado) ou pulo; nunca 2x na mesma cadeia. Regras completas: ler _shared/planning-gate.md do módulo wizz SÓ quando o gate disparar.",
-  "Nunca exponho o META_ACCESS_TOKEN em log, código ou commit.",
-  "Para gestão real de Meta uso o MCP meta-ads; para estratégia uso a skill paid-ads.",
   "Falo PT-BR fácil. Toda campanha precisa de tracking antes de subir.",
 ]
 
-role = "Planejar e gerenciar mídia paga (estratégia, criativo, tracking) roteando para as skills globais e para o MCP meta-ads."
+role = "Planejar e gerenciar mídia paga (estratégia, criativo, tracking) roteando para as skills globais."
 identity = "Gestor de tráfego orientado a ROAS: testa criativos, corta o que não performa, escala o que funciona."
 communication_style = "Direto e numérico, em PT-BR fácil. Fala em CPA, ROAS e próximos testes."
 
@@ -51,8 +49,3 @@ prompt = "Invoque a skill GLOBAL 'ad-creative' via a ferramenta Skill para gerar
 code = "TR"
 description = "Tracking, conversões, UTMs, pixel"
 prompt = "Invoque a skill GLOBAL 'analytics-tracking' via a ferramenta Skill."
-
-[[agent.menu]]
-code = "ME"
-description = "Gestão real de campanha Meta (criar/editar/medir)"
-prompt = "Use o MCP 'meta-ads' (via ToolSearch para carregar as ferramentas) para gerenciar campanhas reais no Meta. Nunca exponha o token."

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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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/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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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

@@ -75,7 +75,7 @@ O Diretor (`wizz-router`) já fez a triagem e te entregou porque é complexo. Se
 2. **Enriquecimento = o `skills-registry.yaml`**. Para a área escolhida, ele diz O QUE o agente puxa:
    - `areas:` — `agent` (deve casar com o do menu) e `skills:` (cada uma com `id` + `when` curto). Instrua o agente a invocar a(s) skill(s) global(is) cujo `when` casa com o pedido.
    - `utility:` — skills cross-cutting (find-skills, enhance-prompt, wizz-router). Ofereça quando couber.
-   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: architect→supabase, ads→meta-ads, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
+   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: architect→supabase, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
    - `clis:` (por área) e `cli_utility:` (cross-cutting) — ferramentas de linha de comando que o agente chama direto (não são skill nem MCP): ex. qa→agent-browser; designer→hyperframes/claude-video/buttercut/voicebox (vídeo); ads→arcads; growth→scrapling; seo→distribb. Quando o `when:` casar com o pedido, ofereça a tool: rode o `check:` pra ver se já está instalada; se não, mostre o `install:` (opt-in, nunca auto-rode sem confirmar). Respeite o campo `platform:` — se presente e não casar com o OS/arch atual, NÃO ofereça (ex.: `buttercut` é `darwin-arm64`, só Apple Silicon). Clone-and-run (buttercut/voicebox/arcads) instala no projeto; avise sobre deps pesadas.
    - `squads:` — painéis consultivos (rodam via `wizz-party-mode`). Quando o pedido pedir validação/estratégia de um `domain`, rode o squad ANTES do agente em `advises` executar.
 

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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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/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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. Escada completa em _shared/model-ladder.md e regra em _shared/token-economy.md do módulo wizz.",
 ]
 
 persistent_facts = [

package/src/modules/wizz/module.yaml

@@ -114,7 +114,7 @@ agents:
     title: Mídia Paga
     icon: "📢"
     team: wizz
-    description: "Gerencia anúncios pagos roteando para paid-ads, ad-creative e analytics-tracking (e o MCP meta-ads). Cria variações de criativo e acompanha métricas."
+    description: "Gerencia anúncios pagos roteando para paid-ads, ad-creative e analytics-tracking. Cria variações de criativo e acompanha métricas."
 
   - code: wizz-memoria
     name: Memória

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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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. 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.",
+  "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. O modelo da sessão é o chefe: orquestra e decide, não executa. Trabalho difícil vai pro wizz-exec-opus quando a sessão roda acima de Opus (Fable); em sessão Opus o chefe absorve esse degrau. Review de diff vai sempre pro wizz-exec-review (pinado em opus, não herda a sessão). Diga ao usuário degrau e quantidade de cada despacho. 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-opus.toml

@@ -1,6 +1,6 @@
 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.
+Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Em sessão acima deste degrau é o destino padrão desse trabalho: o chefe da sessão delega em vez de fazer. Se a sessão já é o topo, o chefe absorve este degrau: pule para 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"

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

@@ -1,8 +1,9 @@
 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.
+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; pinado no degrau Forte da plataforma (gpt-5.6, effort high), não no modelo da sessão.
 """
-# sem model: usa o default_subagent_model da sessão
+model = "gpt-5.6"
+model_reasoning_effort = "high"
 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.

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

@@ -1,6 +1,6 @@
 ---
 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.
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Em sessão acima deste degrau é o destino padrão desse trabalho: o chefe da sessão delega em vez de fazer. Se a sessão já é o topo, o chefe absorve este degrau: pule para wizz-exec-review. "opus" aqui é o DEGRAU mais forte da escada Wizz, não o modelo subjacente.
 kind: local
 model: gemini-3-pro-preview
 ---

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

@@ -1,7 +1,8 @@
 ---
 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.
+description: Revisor do Wizz Method pinado no degrau Forte da plataforma (gemini-3-pro-preview), não no modelo da sessão. 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
+model: gemini-3-pro-preview
 ---
 
 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.

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

@@ -1,5 +1,5 @@
 ---
-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.
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Em sessão acima deste degrau é o destino padrão desse trabalho: o chefe da sessão delega em vez de fazer. Se a sessão já é o topo, o chefe absorve este degrau: pule para wizz-exec-review. "opus" aqui é o DEGRAU mais forte da escada Wizz, não o modelo subjacente.
 mode: subagent
 model: anthropic/claude-opus-5
 ---

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

@@ -1,6 +1,7 @@
 ---
-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.
+description: Revisor do Wizz Method pinado no degrau Forte da plataforma (claude-opus-5), não no modelo 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
+model: anthropic/claude-opus-5
 permission:
   edit: deny
 ---

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

@@ -1,6 +1,6 @@
 ---
 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.
+description: Executor forte do Wizz Method para trabalho difícil. Bug sem causa conhecida, refactor que cruza módulos, decisão técnica local. Em sessão acima de Opus (Fable, Mythos) é o destino padrão desse trabalho: o chefe da sessão delega em vez de fazer. Em sessão Opus o chefe absorve este degrau: pule para wizz-exec-review.
 model: opus
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 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
+description: Revisor do Wizz Method pinado no degrau Forte (opus), nunca no modelo da sessão. Em sessão Fable o review sai do chefe e vai para Opus; em sessão Opus nada muda. 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: opus
 ---
 
 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.

package/src/skills-lib/ad-creative/SKILL.md

@@ -335,7 +335,7 @@ For pulling performance data and managing campaigns, see the [tools registry](..
 | Platform | Pull Performance Data | Manage Campaigns | Guide |
 |----------|:---------------------:|:----------------:|-------|
 | **Google Ads** | `google-ads campaigns list`, `google-ads reports get` | `google-ads campaigns create` | [google-ads.md](../../tools/integrations/google-ads.md) |
-| **Meta Ads** | `meta-ads insights get` | `meta-ads campaigns list` | [meta-ads.md](../../tools/integrations/meta-ads.md) |
+| **Meta Ads** | - | - | - |
 | **LinkedIn Ads** | `linkedin-ads analytics get` | `linkedin-ads campaigns list` | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
 | **TikTok Ads** | `tiktok-ads reports get` | `tiktok-ads campaigns list` | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
 

package/src/skills-lib/paid-ads/SKILL.md

@@ -298,7 +298,7 @@ For implementation, see the [tools registry](../../tools/REGISTRY.md). Key adver
 | Platform | Best For | MCP | Guide |
 |----------|----------|:---:|-------|
 | **Google Ads** | Search intent, high-intent traffic | ✓ | [google-ads.md](../../tools/integrations/google-ads.md) |
-| **Meta Ads** | Demand gen, visual products, B2C | - | [meta-ads.md](../../tools/integrations/meta-ads.md) |
+| **Meta Ads** | Demand gen, visual products, B2C | - | - |
 | **LinkedIn Ads** | B2B, job title targeting | - | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
 | **TikTok Ads** | Younger demographics, video | - | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
 

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

@@ -59,8 +59,7 @@ Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem
 | Intenção / palavras-chave | Skills a oferecer | Prioridade |
 |---|---|---|
 | Ideias de marketing, estratégia de marketing, posicionamento | `marketing-ideas` + `marketing-psychology` + `product-marketing-context` | 1 |
-| Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` + **MCP meta-ads** | 1 |
-| Gestão de campanha Meta/Facebook/Instagram via API real | **MCP meta-ads** (`mcp-meta-ads`) direto | 1 |
+| Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` | 1 |
 | Pixel/UTM/atribuição erradas, "a venda não bate com o gerenciador", "onde está furando o funil", tráfego orgânico inflado, conferir tracking antes de subir campanha | `tracking-audit` (+ `analytics-tracking` se for SaaS/produto) | 1 |
 | Lançamento de feature, lançamento de produto, go-to-market | `launch-strategy` + `social-content` + `email-sequence` | 1 |
 | Site pronto pra subir, pré-lançamento de SITE, "revisa antes do deploy", checklist de go-live, ou item pontual pré-lançamento (og:image/prévia de link, FAQ com schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
@@ -97,6 +96,4 @@ Quando nenhuma skill/MCP instalado cobrir o pedido, **classifique o que falta**
 
 **Falta um MCP:** informe → `claude mcp list` → consulte `skills-registry.yaml` (`mcps:`/`mcp_utility:`, com `server` pronto) → proponha `claude mcp add <id> [-e VAR=$VAR] -- <command> [args]`. Secrets sempre via env/placeholder, nunca token real.
 
-MCPs comuns: context7 (docs de libs), supabase (Postgres), meta-ads (Meta), exa (pesquisa). Browser/E2E é sempre via CLI `agent-browser`, nunca via MCP Playwright.
-
-Para paid ads Meta, o MCP `mcp-meta-ads` dá acesso real à API Meta Marketing (campanhas, ad sets, ads, métricas, criativos). Combine com `paid-ads` + `ad-creative` + `analytics-tracking`. O `META_ACCESS_TOKEN` vem de env local: nunca exponha em logs ou código commitado.
+MCPs comuns: context7 (docs de libs), supabase (Postgres), exa (pesquisa). Browser/E2E é sempre via CLI `agent-browser`, nunca via MCP Playwright.

package/tools/installer/core/installer.js

@@ -4,7 +4,7 @@ const { Manifest } = require('./manifest');
 const { OfficialModules } = require('../modules/official-modules');
 const { installSkillsLib } = require('../modules/skills-lib');
 const { writeMcpConfig, renderAddCommand, prepareMcps, partitionAlreadyConfigured } = require('../modules/mcp-config');
-const { promptMissingEnvVars } = require('../modules/env-vars');
+const { promptMissingEnvVars, mcpsWithMissingRequiredEnv } = require('../modules/env-vars');
 const { installClis, renderInstallCommand } = require('../modules/cli-config');
 const { writeDepsCache, readPreviousMcpPins } = require('../modules/deps-cache');
 const { IdeManager } = require('../ide/manager');
@@ -423,7 +423,7 @@ class Installer {
               // is still cheap for an already-installed binary: prepareMcp is
               // detect-first, so only a genuinely missing binary pays for the
               // network-heavy install/post_install steps.
-              const { ready: mcpsReady, failed: mcpsFailed } = await prepareMcps({ mcps: toWrite });
+              let { ready: mcpsReady, failed: mcpsFailed } = await prepareMcps({ mcps: toWrite });
               for (const f of mcpsFailed) {
                 await prompts.log.warn(
                   `MCP ${f.id} não pôde ser preparado (${f.error}). Config NÃO escrita para evitar ENOENT — instale manualmente e adicione depois com \`claude mcp add\`.`,
@@ -451,10 +451,27 @@ class Installer {
                   mcps: mcpsReady,
                 });
                 const envInteractive = !config.skipPrompts && !!process.stdin.isTTY;
-                await promptMissingEnvVars(mcpsForEnvVars, {
+                const envResult = await promptMissingEnvVars(mcpsForEnvVars, {
                   projectDir: paths.projectRoot,
                   interactive: envInteractive,
                 });
+
+                // A required (no-default) var that stayed unresolved means
+                // the server would be written with a permanently-broken
+                // literal `${VAR}` — never write it (E1: never fail the
+                // install, just drop that server and tell the user how to
+                // retry).
+                const missingEnv = mcpsWithMissingRequiredEnv(mcpsReady, envResult.skipped);
+                if (missingEnv.length > 0) {
+                  const missingIds = new Set(missingEnv.map((m) => m.id));
+                  mcpsReady = mcpsReady.filter((m) => !missingIds.has(m.id));
+                  for (const m of missingEnv) {
+                    await prompts.log.warn(
+                      `MCP ${m.id} não gravado: faltou ${m.missing.join(', ')}. Rode o installer de novo quando tiver a chave, ou adicione com \`claude mcp add\`.`,
+                    );
+                  }
+                  addResult('MCP servers', 'warn', `não gravados por falta de env var: ${missingEnv.map((m) => m.id).join(', ')}`);
+                }
               } catch (error) {
                 await prompts.log.warn(`Falha ao configurar env vars dos MCPs: ${error.message}`);
                 addResult('MCP env vars', 'warn', error.message);

package/tools/installer/modules/env-vars.js

@@ -589,9 +589,50 @@ async function promptMissingEnvVars(mcps, opts = {}) {
   };
 }
 
+/**
+ * Find which of `mcps` have at least one REQUIRED (`hasDefault: false`) env
+ * placeholder that stayed unresolved, per the `skipped` list returned by
+ * `promptMissingEnvVars`/`resolveEnvVars`. A var WITH a default
+ * (`hasDefault: true`) is fine even when skipped — the Claude Code runtime
+ * resolves `${VAR:-default}` itself — so only `hasDefault: false` entries
+ * count here.
+ *
+ * Writing a server whose required placeholder never resolved to anywhere
+ * (not `process.env`, not `.env`, not the global store, not typed
+ * interactively) would embed a literal, permanently-broken `${VAR}` into
+ * `.mcp.json`: the server sits in the config but can never actually start.
+ * Callers use this to drop such a server from the write instead. Pure: no
+ * I/O.
+ *
+ * @param {Array<{id: string}>} mcps - Resolved MCP entries to check
+ * @param {Array<{name: string, mcpIds: string[], hasDefault: boolean}>} [skipped]
+ *   - The `skipped` array from `promptMissingEnvVars`/`resolveEnvVars`
+ * @returns {Array<{id: string, missing: string[]}>} One entry per affected
+ *   MCP id, with the names of its unresolved required vars (in encounter order)
+ */
+function mcpsWithMissingRequiredEnv(mcps, skipped) {
+  const missingByMcpId = new Map();
+  for (const entry of skipped || []) {
+    if (!entry || entry.hasDefault) continue;
+    for (const id of entry.mcpIds || []) {
+      if (!missingByMcpId.has(id)) missingByMcpId.set(id, []);
+      missingByMcpId.get(id).push(entry.name);
+    }
+  }
+
+  const result = [];
+  for (const mcp of mcps || []) {
+    if (mcp && mcp.id && missingByMcpId.has(mcp.id)) {
+      result.push({ id: mcp.id, missing: missingByMcpId.get(mcp.id) });
+    }
+  }
+  return result;
+}
+
 module.exports = {
   extractEnvPlaceholders,
   resolveEnvVars,
+  mcpsWithMissingRequiredEnv,
   persistEnvValues,
   persistProjectEnv,
   persistGlobalEnv,

package/tools/installer/modules/mcp-config.js

@@ -326,25 +326,101 @@ async function partitionAlreadyConfigured({ projectDir, mcps }) {
   return { toPrepare, alreadyConfigured };
 }
 
+/**
+ * Resolve the set of MCP ids covered by an installed Claude Code plugin
+ * (`~/.claude/plugins/installed_plugins.json`). A plugin key in that file's
+ * `plugins` map is `<name>@<marketplace>` (e.g.
+ * `supabase@claude-plugins-official`); the plugin covers catalog MCP id
+ * `<name>`. If the plugin ships its own `.mcp.json`
+ * (`<installPath>/.mcp.json`, `installPath` from the plugin's install
+ * record) with an `mcpServers` block, every key in that block is ALSO
+ * covered (e.g. the `vercel` plugin ships a server named `vercel`).
+ *
+ * Read failures at the top level (missing/malformed
+ * `installed_plugins.json`) fall back to "nothing covered", same spirit as
+ * the `~/.claude.json` handling in `partitionGloballyConfigured`. A failure
+ * reading ONE plugin's own `.mcp.json` (missing `installPath`, missing
+ * file, malformed JSON) only skips that plugin's extra ids — the plugin's
+ * own name stays covered, since that didn't require reading anything past
+ * the already-parsed top-level file.
+ *
+ * @param {string} [installedPluginsPath] - Override of
+ *   `~/.claude/plugins/installed_plugins.json` (tests)
+ * @returns {Promise<Set<string>>}
+ */
+async function resolvePluginCoveredIds(installedPluginsPath) {
+  const file = installedPluginsPath || path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+  const ids = new Set();
+
+  if (!(await fs.pathExists(file))) return ids;
+
+  let data;
+  try {
+    data = JSON.parse(await fs.readFile(file, 'utf8'));
+  } catch {
+    return ids;
+  }
+
+  const plugins = data && typeof data === 'object' && data.plugins && typeof data.plugins === 'object' ? data.plugins : null;
+  if (!plugins) return ids;
+
+  for (const [key, entries] of Object.entries(plugins)) {
+    const name = String(key).split('@')[0];
+    if (name) ids.add(name);
+
+    if (!Array.isArray(entries)) continue;
+    for (const entry of entries) {
+      const installPath = entry && entry.installPath;
+      if (!installPath || typeof installPath !== 'string') continue;
+
+      const mcpJsonPath = path.join(installPath, '.mcp.json');
+      try {
+        if (!(await fs.pathExists(mcpJsonPath))) continue;
+        const mcpConfig = JSON.parse(await fs.readFile(mcpJsonPath, 'utf8'));
+        const servers =
+          mcpConfig && typeof mcpConfig === 'object' && mcpConfig.mcpServers && !Array.isArray(mcpConfig.mcpServers)
+            ? mcpConfig.mcpServers
+            : null;
+        if (servers) {
+          for (const serverKey of Object.keys(servers)) ids.add(serverKey);
+        }
+      } catch {
+        // Malformed/unreadable plugin .mcp.json: skip its extra ids, the
+        // plugin's own name (added above) stays covered.
+      }
+    }
+  }
+
+  return ids;
+}
+
 /**
  * Split resolved MCP entries into those still worth offering/installing in
- * the project and those the user already configured GLOBALLY (user scope, the
- * `mcpServers` key of `~/.claude.json`). A server configured there is live in
- * every project already — usually with the real key embedded — so writing the
- * registry's `${VAR}`-placeholder copy into the project `.mcp.json` would at
- * best duplicate it and at worst shadow a working global config with a broken
- * placeholder one, then prompt the user for a key they already provided.
+ * the project and those the user already has covered elsewhere: configured
+ * GLOBALLY (user scope, the `mcpServers` key of `~/.claude.json`), or
+ * covered by an installed Claude Code PLUGIN
+ * (`~/.claude/plugins/installed_plugins.json`, see
+ * `resolvePluginCoveredIds`). Either way, the server is already live —
+ * usually with the real key embedded — so writing the registry's
+ * `${VAR}`-placeholder copy into the project `.mcp.json` would at best
+ * duplicate it and at worst shadow a working config with a broken
+ * placeholder one, then prompt the user for a key they already have.
  *
- * Read failures (missing/malformed `~/.claude.json`) fall back to "nothing is
- * global", the safe default: worst case the user sees the old behavior.
+ * Read failures (missing/malformed `~/.claude.json` or
+ * `installed_plugins.json`) fall back to "nothing is global"/"nothing is
+ * plugin-covered", the safe default: worst case the user sees the old
+ * behavior. An id present in BOTH sources is reported once, in
+ * `globallyConfigured` only (never duplicated into `pluginCovered`).
  *
  * @param {Object} args
  * @param {Array<{id: string}>} args.mcps - Resolved MCP entries to partition
  * @param {string} [args.claudeJsonPath] - Override of `~/.claude.json` (tests)
- * @returns {Promise<{toInstall: Array<Object>, globallyConfigured: string[]}>}
+ * @param {string} [args.installedPluginsPath] - Override of
+ *   `~/.claude/plugins/installed_plugins.json` (tests)
+ * @returns {Promise<{toInstall: Array<Object>, globallyConfigured: string[], pluginCovered: string[]}>}
  */
-async function partitionGloballyConfigured({ mcps, claudeJsonPath }) {
-  if (!mcps || mcps.length === 0) return { toInstall: [], globallyConfigured: [] };
+async function partitionGloballyConfigured({ mcps, claudeJsonPath, installedPluginsPath }) {
+  if (!mcps || mcps.length === 0) return { toInstall: [], globallyConfigured: [], pluginCovered: [] };
 
   const file = claudeJsonPath || path.join(os.homedir(), '.claude.json');
   let globalIds = new Set();
@@ -359,13 +435,21 @@ async function partitionGloballyConfigured({ mcps, claudeJsonPath }) {
     }
   }
 
+  const pluginIds = await resolvePluginCoveredIds(installedPluginsPath);
+
   const toInstall = [];
   const globallyConfigured = [];
+  const pluginCovered = [];
   for (const mcp of mcps) {
-    if (mcp && mcp.id && globalIds.has(mcp.id)) globallyConfigured.push(mcp.id);
-    else toInstall.push(mcp);
+    if (mcp && mcp.id && globalIds.has(mcp.id)) {
+      globallyConfigured.push(mcp.id);
+    } else if (mcp && mcp.id && pluginIds.has(mcp.id)) {
+      pluginCovered.push(mcp.id);
+    } else {
+      toInstall.push(mcp);
+    }
   }
-  return { toInstall, globallyConfigured };
+  return { toInstall, globallyConfigured, pluginCovered };
 }
 
 /**

package/tools/installer/ui.js

@@ -629,9 +629,14 @@ class UI {
     // duplicate config and re-prompt for a key that already works. Filter it
     // out of every path below (multiselect, --mcps, --yes) with an info line
     // so nothing disappears silently.
-    const { toInstall, globallyConfigured } = await partitionGloballyConfigured({ mcps: resolved });
+    const { toInstall, globallyConfigured, pluginCovered } = await partitionGloballyConfigured({ mcps: resolved });
     if (globallyConfigured.length > 0) {
       await prompts.log.info(`MCPs já configurados no seu Claude global (~/.claude.json), pulados: ${globallyConfigured.join(', ')}`);
+    }
+    if (pluginCovered.length > 0) {
+      await prompts.log.info(`MCPs já cobertos por plugin do Claude Code (user scope), pulados: ${pluginCovered.join(', ')}`);
+    }
+    if (globallyConfigured.length > 0 || pluginCovered.length > 0) {
       resolved = toInstall;
       if (resolved.length === 0) return { toWrite: [], toRecommend: [] };
     }