wizz-method 2.0.0 → 2.1.1

package/src/modules/lowticket/skills/{lowticket-funil → wizz-lowticket-funil}/references/copy-das-paginas.md

@@ -66,7 +66,7 @@ No lugar: linguagem falada. "do jeito certo", "na prática", "pra valer", "na re
 
 **Sem travessão longo.** Vírgula, ponto, dois pontos ou parênteses.
 
-Antes de entregar, rodar o checklist de 10 filtros de `07a-copy-humanizacao.md` (shard irmão de `07-funil-upsell.md`, na `lowticket-metodologia`): falhou em 3 ou mais, refaz. A lista de palavras banidas acima é a base; a lista ampliada e a tabela de substituição estão no shard.
+Antes de entregar, rodar o checklist de 10 filtros de `07a-copy-humanizacao.md` (shard irmão de `07-funil-upsell.md`, na `wizz-lowticket-metodologia`): falhou em 3 ou mais, refaz. A lista de palavras banidas acima é a base; a lista ampliada e a tabela de substituição estão no shard.
 
 ## Objeções
 

package/src/modules/lowticket/skills/{lowticket-metodologia → wizz-lowticket-metodologia}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: lowticket-metodologia
+name: wizz-lowticket-metodologia
 description: Routes any low ticket direct-response question to the one knowledge shard that answers it, and loads the guardrails alongside. Covers funnel diagnosis, bid-cap campaigns, creatives, offers, sales pages, Instagram, VSL players, upsell ladders, copy diagnosis (awareness, sophistication, proof), AI-copy humanisation, tracking setup (GA4, GTM, pixel, Conversions API) and market benchmarks for the BR/PT market. Use when working on a low ticket offer (roughly R$19 to R$97), a Meta Ads campaign for one, its sales page, its creatives, its upsell ladder, or when auditing why one is not converting. Do NOT use for SaaS, B2B, client websites, high ticket or mentorship funnels - the numbers here do not transfer.
 ---
 

package/src/modules/lowticket/skills/{lowticket-minerador → wizz-lowticket-minerador}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: lowticket-minerador
+name: wizz-lowticket-minerador
 description: Mines and judges competitor low ticket offers - generates the search vocabulary, reads an offer from a URL or screenshot and returns a verdict, compares two or three side by side, or diagnoses why a modeled offer never scaled. Rebuilds rather than clones. Use when hunting for a new offer to model, sizing up a competitor, or answering "this offer did not scale, what broke". Do NOT use once the offer is already defined - that is wizz-offer-forge - and do NOT use to run campaigns.
 ---
 
@@ -15,7 +15,7 @@ Someone who already runs traffic, reads metrics and has mined offers before. Do
 
 ## Source of truth
 
-Read the Cérebro state first (via the `cerebro` skill). If `lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md`, then:
+Read the Cérebro state first (via the `cerebro` skill). If `wizz-lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md`, then:
 
 - **`12-mineracao-ofertas.md`**: the price trick, the Ad Library filter checklist and keyword taxonomy, the 0-10 rubric with a cut at 6, the three safety rules
 - **`12a-mineracao-veredito.md`**: §12.5, the scoring ruler and what disqualifies
@@ -106,7 +106,7 @@ Identify the platform by clicking through to the competitor's checkout and readi
 
 ## Out of scope
 
-Advanced traffic operation → `lowticket-trafego`. Full funnel construction → `lowticket-funil`. Building the offer once it is chosen → `wizz-offer-forge`. Page work → `lowticket-pagina`. Say which part you can analyze and route the rest.
+Advanced traffic operation → `wizz-lowticket-trafego`. Full funnel construction → `wizz-lowticket-funil`. Building the offer once it is chosen → `wizz-offer-forge`. Page work → `wizz-lowticket-pagina`. Say which part you can analyze and route the rest.
 
 ## Tone
 

package/src/modules/lowticket/skills/{lowticket-minerador → wizz-lowticket-minerador}/references/rubrica.md

@@ -1,6 +1,6 @@
 # Rubrica, tabelas e réguas da mineração
 
-> A fonte canônica é `12-mineracao-ofertas.md` (§12.1-12.4) e `12a-mineracao-veredito.md` (§12.5) de `lowticket-metodologia`. Esta página é o fallback e a consulta rápida.
+> A fonte canônica é `12-mineracao-ofertas.md` (§12.1-12.4) e `12a-mineracao-veredito.md` (§12.5) de `wizz-lowticket-metodologia`. Esta página é o fallback e a consulta rápida.
 
 ## Veredito
 

package/src/modules/lowticket/skills/{lowticket-pagina → wizz-lowticket-pagina}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: lowticket-pagina
+name: wizz-lowticket-pagina
 description: Performance engineering for a low ticket direct-response sales page served to Meta traffic on mobile - fixes connect rate by cutting redirects, ordering the pixel, and hitting hard LCP, TTFB, CLS and page-weight targets, then reports before/after. Use when connect rate is below 92%, when a sales page is slow on mobile, or when building a new low ticket page. Do NOT use to write or restructure the copy, the offer or the price - this skill is the engineer, not the copywriter - and do NOT use for institutional sites or apps.
 ---
 
@@ -26,13 +26,13 @@ That creates two clocks, and both have to be optimized:
 
 ## Honest boundary, say it early
 
-Speed fixes the leak between the click and the page. It does not fix a bad offer, a bad creative or a bad checkout. **If connect rate is already above 92%, the problem is somewhere else** and this skill is the wrong tool. Route to `lowticket-trafego` (find the real bottleneck) or `lowticket-minerador` (the offer itself).
+Speed fixes the leak between the click and the page. It does not fix a bad offer, a bad creative or a bad checkout. **If connect rate is already above 92%, the problem is somewhere else** and this skill is the wrong tool. Route to `wizz-lowticket-trafego` (find the real bottleneck) or `wizz-lowticket-minerador` (the offer itself).
 
 ## Source of truth
 
-Read the Cérebro state first (via the `cerebro` skill). If `lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md` and shard `06-pagina-vendas.md`, especially §6.3-6.4. Page structure and copy blocks for a pure low-ticket page live in `12c-anatomia-low-ticket.md` (the 11-block anatomy, not `12b` anymore); VSL player behavior (autoplay, progress bar, weight) is `06b-player-vsl.md`; conversion-side reasoning is `wizz-page-cro`. Where a generic skill contradicts the shard, the shard wins and you say so.
+Read the Cérebro state first (via the `cerebro` skill). If `wizz-lowticket-metodologia` is installed, read `knowledge/INDEX.md` + `knowledge/guardrails.md` and shard `06-pagina-vendas.md`, especially §6.3-6.4. Page structure and copy blocks for a pure low-ticket page live in `12c-anatomia-low-ticket.md` (the 11-block anatomy, not `12b` anymore); VSL player behavior (autoplay, progress bar, weight) is `06b-player-vsl.md`; conversion-side reasoning is `wizz-page-cro`. Where a generic skill contradicts the shard, the shard wins and you say so.
 
-**Open conflict, do not resolve it alone.** §6.3-6.4 (this skill's rule) fires the pixel direct, first in `<head>`, no tag manager. `17-rastreamento.md` installs that same pixel *inside* GTM, as part of the full GA4 + Meta + server-container stack. This is ponto 38 of `pontos-em-aberto.md` in `lowticket-metodologia`, and it is unresolved. If the page already runs tracking through GTM, do not rip the pixel out of the container to chase the speed target: ask which rule wins before touching it.
+**Open conflict, do not resolve it alone.** §6.3-6.4 (this skill's rule) fires the pixel direct, first in `<head>`, no tag manager. `17-rastreamento.md` installs that same pixel *inside* GTM, as part of the full GA4 + Meta + server-container stack. This is ponto 38 of `pontos-em-aberto.md` in `wizz-lowticket-metodologia`, and it is unresolved. If the page already runs tracking through GTM, do not rip the pixel out of the container to chase the speed target: ask which rule wins before touching it.
 
 This skill has **no memory of its own**.
 

package/src/modules/lowticket/skills/{lowticket-trafego → wizz-lowticket-trafego}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: lowticket-trafego
+name: wizz-lowticket-trafego
 description: Diagnoses a low ticket Meta Ads operation from campaign and funnel numbers, names the single bottleneck, and prescribes one action. Applies the bid-cap ruler, the 3x validation gate, the metric hierarchy and the funnel benchmarks instead of reacting to whichever number looks worst. Use when reading a Meta Ads or Utmify screenshot, deciding whether to pause an ad, deciding whether to scale, or answering "my ROAS dropped" for a low ticket offer. Do NOT use for Google Ads, brand campaigns, B2B lead gen, or to write copy and creatives - this skill reads numbers, it does not produce ads.
 ---
 
@@ -11,12 +11,12 @@ Most campaign damage is self-inflicted. An operator sees a bad number, changes t
 
 ## Source of truth
 
-The numbers live in `lowticket-metodologia`, not here. On activation, read `knowledge/INDEX.md` and `knowledge/guardrails.md` from that skill, then the shard the request needs:
+The numbers live in `wizz-lowticket-metodologia`, not here. On activation, read `knowledge/INDEX.md` and `knowledge/guardrails.md` from that skill, then the shard the request needs:
 
 - **`03-campanha-bidcap.md`**: campaign structure, bid cap ruler, pause rule, scale levers, cadence
 - **`02-diagnostico-funil.md`**: the funnel transitions and their benchmarks
 
-Where a generic paid-media skill (`wizz-paid-ads`, `wizz-analytics-tracking`) contradicts those shards, the shard wins and you say so. If `lowticket-metodologia` is not installed, the rules in `references/reguas.md` here are the fallback, and you say that too.
+Where a generic paid-media skill (`wizz-paid-ads`, `wizz-analytics-tracking`) contradicts those shards, the shard wins and you say so. If `wizz-lowticket-metodologia` is not installed, the rules in `references/reguas.md` here are the fallback, and you say that too.
 
 Read the Cérebro state before answering (via the `cerebro` skill): the account's breakeven, ticket and current bid cap are state, not knowledge. This skill has **no memory of its own** and writes none.
 

package/src/modules/lowticket/skills/{lowticket-trafego → wizz-lowticket-trafego}/references/reguas.md

@@ -1,6 +1,6 @@
 # Réguas numéricas · diagnóstico de tráfego low ticket
 
-> Fallback. A fonte canônica é o shard `03-campanha-bidcap.md` e `02-diagnostico-funil.md` de `lowticket-metodologia`. Esta página existe para a skill continuar utilizável quando o módulo de conhecimento não está instalado, e para a consulta rápida de um número.
+> Fallback. A fonte canônica é o shard `03-campanha-bidcap.md` e `02-diagnostico-funil.md` de `wizz-lowticket-metodologia`. Esta página existe para a skill continuar utilizável quando o módulo de conhecimento não está instalado, e para a consulta rápida de um número.
 
 ## Bid cap
 

package/src/modules/wizz/_shared/communication-rules.md

@@ -1,6 +1,6 @@
 # Comunicação Wizz (fonte única)
 #
-# Este arquivo é lido pelo resolver (`resolve_customization.py`) através da
+# Este arquivo é lido pelo resolver do instalador (`wizz resolve`, Node) através da
 # chave `include` em `customize.toml`/overrides. Cada parágrafo abaixo (bloco
 # separado por linha em branco) vira um item de `activation_steps_append`.
 # Editar aqui atualiza todos os agentes de uma vez. Não copie este texto

package/src/modules/wizz/_shared/despacho-barato.md

@@ -0,0 +1,9 @@
+# Despacho de trabalho barato (fonte única)
+#
+# Este arquivo é lido pelo resolver do instalador (`wizz resolve`, Node) através da
+# chave `include` em `customize.toml`/overrides. O parágrafo abaixo vira um
+# item de `activation_steps_append`. Editar aqui atualiza todos os agentes de
+# uma vez. Não copie este texto para outro toml: referencie via `include`.
+# ---
+
+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.

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

@@ -27,6 +27,11 @@ O que é economia de token, e por isso fica aqui:
 
 Quando a tarefa exigir varrer muitos arquivos, lance um subagente Explore e fique só com a conclusão, não com o despejo de arquivos.
 
+## Contexto: soft e hard
+
+- **SOFT** (o contexto está crescendo: muitos arquivos lidos, saída longa de ferramenta, tarefa se ramificando): delegue a parte mecânica a um subagente e fique só com a conclusão.
+- **HARD** (o próximo passo vai estourar o contexto: arquivo grande, varredura ampla, saída que não cabe): pare, resuma o estado em 5 linhas (feito / em andamento / pendências / decisões / próximo comando) e só então continue ou entregue ao usuário.
+
 ## Despacho barato (regra, não sugestão)
 
 Trabalho mecânico NUNCA roda na sessão principal. Isso inclui: varredura de arquivos, lookup, diff repetitivo, mudança já 100% especificada. Sempre despache 2+ subagentes em paralelo, particionados por arquivo/módulo (nunca dois no mesmo arquivo), com model explícito:
@@ -36,6 +41,8 @@ Trabalho mecânico NUNCA roda na sessão principal. Isso inclui: varredura de ar
 - **`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.
 
+Todo despacho pode levar `max_calls` (ver handoff-protocol.md): executor que bate no teto devolve parcial, nunca escala sozinho.
+
 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

@@ -9,7 +9,7 @@ description: Wizz Method Paid Media Agent. Use when you need ad campaigns (Googl
 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`).
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-ads.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-ads`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-ads.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -12,11 +12,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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-copy/SKILL.md

@@ -9,7 +9,7 @@ description: Wizz Method Copywriter. Use when you need sales copy, headlines, pa
 Você é o Copy do Wizz. Escreve textos que vendem, humaniza o que soa robótico e entrega variações prontas. Você roteia para as skills globais de copy 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`, `{project-root}/_wizz/custom/{skill-name}.user.toml`.
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-copy.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-copy`. Se falhar, mescle base → time → pessoal: `{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-copy.toml`, `{project-root}/_wizz/custom/wizz-copy.user.toml`.
 2. Execute `{agent.activation_steps_prepend}`.
 3. Adote persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -12,11 +12,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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/SKILL.md

@@ -14,7 +14,7 @@ Você é o Designer do Wizz. Cria interfaces e landing pages de alto nível, mos
 
 ## Na ativação
 
-1. **Resolver bloco do agente:** rode `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`. Se falhar, leia e mescle base → time → pessoal: `{skill-root}/customize.toml`, `{project-root}/_wizz/custom/{skill-name}.toml`, `{project-root}/_wizz/custom/{skill-name}.user.toml`.
+1. **Resolver bloco do agente:** leia `{project-root}/_wizz/_resolved/wizz-designer.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-designer`. Se falhar, leia e mescle base → time → pessoal: `{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-designer.toml`, `{project-root}/_wizz/custom/wizz-designer.user.toml`.
 2. **Passos prepend:** execute cada item de `{agent.activation_steps_prepend}`.
 3. **Persona:** incorpore o papel `{agent.role}`, identidade `{agent.identity}`, estilo `{agent.communication_style}`, princípios `{agent.principles}`.
 4. **Fatos persistentes:** carregue `{agent.persistent_facts}` (itens `file:` são caminhos sob `{project-root}`).

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

@@ -13,11 +13,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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/SKILL.md

@@ -11,7 +11,7 @@ Você é o Growth do Wizz. Traz ideias acionáveis de marketing e conversão, pl
 **Invocação:** esta persona é uma skill (`Skill(skill="wizz-growth", args="<brief>")`), não um `subagent_type`. Uma passada de CRO contra um shard pode rodar nesta sessão ou em um executor nativo disponível (`wizz-exec-*`) que carregue esta skill e receba o shard no brief.
 
 ## 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`).
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-growth.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-growth`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-growth.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -12,11 +12,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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

@@ -19,13 +19,13 @@ Você é o **Maestro (Gerente)**, o único orquestrador do método. O **Diretor*
 
 ### Passo 1 — Resolver o bloco do agente
 
-Rode: `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`
+Rode: leia `{project-root}/_wizz/_resolved/wizz-maestro.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-maestro`
 
 Se falhar, resolva você mesmo lendo, na ordem base → time → pessoal:
 
 1. `{skill-root}/customize.toml`
-2. `{project-root}/_wizz/custom/{skill-name}.toml`
-3. `{project-root}/_wizz/custom/{skill-name}.user.toml`
+2. `{project-root}/_wizz/custom/wizz-maestro.toml`
+3. `{project-root}/_wizz/custom/wizz-maestro.user.toml`
    Escalares: override vence. Arrays: append. Arrays de tabela com `code`: substitui igual, adiciona novo.
 
 ### Passo 2 — Executar passos prepend
@@ -83,7 +83,7 @@ Em resumo: **menu escolhe o agente, registry escolhe a(s) skill(s) e os squads.*
 
 ### Sinal de complexidade (compartilhado com router e quick-dev)
 
-**Regra de dispatch:** SE 2+ áreas → maestro (você), sempre. SENÃO conte os 3 fatores restantes (multi-passo, precisa planejar, gera artefato memorável); 2+ fatores → maestro (você).
+**Regra de dispatch:** SE 2+ áreas → maestro (você), sempre. SENÃO conte os 3 fatores restantes (multi-passo, precisa planejar, gera artefato memorável); 2+ fatores → maestro (você). A cláusula de área decide sozinha, sem somar com mais nada.
 
 1. **Áreas**: 1 só, ou várias? (cláusula 1: 2+ decide sozinha, sem somar com mais nada)
 2. **Passos** — ajuste pontual, ou multi-passo?
@@ -106,7 +106,7 @@ Regra de handoff:
 
 Para trabalho isolado/paralelo, selecione um `wizz-exec-*` que esteja na lista de agentes disponíveis e passe no brief a skill de área a carregar, o shard e o escopo. O executor deve carregar a skill de entrada completa antes das referências relevantes; não herda as skills já carregadas pelo maestro. Se não houver executor adequado disponível, execute a skill na sessão atual. Se a skill também faltar, reporte a instalação ausente, sem inventar um tipo de agente nem repetir a chamada que falhou.
 
-Ao invocar o agente de área, declare o brief no formato do [protocolo de handoff compartilhado](../../../../core-skills/_shared/handoff-protocol.md): `origem` (você, para o anti-loop — o agente nunca devolve pra você o mesmo pedido), `cérebro já consultado` (o resumo de até 3 linhas que você já puxou no Passo 2, cortando a consulta duplicada do agente), decisões já tomadas na cadeia, a skill de entrada e as referências relevantes (sem carregar referências alheias à tarefa) e `model_hint` opcional. O agente de área que receber esse resumo pula o próprio passo de `/cerebro ver`.
+Ao invocar o agente de área, declare o brief no formato do [protocolo de handoff compartilhado](../../../../core-skills/_shared/handoff-protocol.md): `origem` (você, para o anti-loop — o agente nunca devolve pra você o mesmo pedido), `cérebro já consultado` (o resumo de até 3 linhas que você já puxou no Passo 2, cortando a consulta duplicada do agente), decisões já tomadas na cadeia, a skill de entrada e as referências relevantes (sem carregar referências alheias à tarefa), `model_hint` opcional e `max_calls` opcional (teto de chamadas de ferramenta do executor). O agente de área que receber esse resumo pula o próprio passo de `/cerebro ver`.
 
 **Não tem agente/skill/MCP para o pedido:** diga isso e ofereça `find-skills`. Ele cobre os dois caminhos: skill faltante → `npx skills find/add`; capacidade de ferramenta faltante → `claude mcp add` (usando o `server` do registry). Classifique antes: precisa SABER COMO = skill; precisa AGIR num sistema = MCP.
 

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

@@ -14,18 +14,14 @@ activation_steps_prepend = [
 ]
 
 # Após saudar: fixa o protocolo de comunicação/encerramento (fonte única em _shared/).
-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. 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.",
-]
+include = ["../../_shared/communication-rules.md", "../../_shared/planning-gate.md", "../../_shared/despacho-barato.md"]
 
 persistent_facts = [
   "Modo de encadeamento: AUTOMÁTICO. Anuncio a sequência completa no início e executo os agentes em ordem, sem parar entre eles. Pauso só em decisão de negócio do usuário ou risco irreversível (deploy, delete, gasto).",
   "Gate de planejamento: em pedido de EXECUÇÃO com fator 'precisa planejar' = SIM e sem PRD/story/brief correspondente, pergunto 1x se crio o artefato antes (recomendado) ou pulo; resolvido o gate, a cadeia segue automática. Detalhes em _shared/planning-gate.md.",
   "Falo PT-BR fácil, frases curtas, sem jargão. Resumo como se explicasse para um cliente.",
   "Detalhes completos da camada Wizz estão em _shared/ (communication-rules.md, encerramento.md, token-economy.md, cerebro.md) na raiz do módulo wizz.",
-  "Ao delegar para um agente, declaro o handoff no formato do protocolo compartilhado (origem, cérebro já consultado em até 3 linhas, decisões já tomadas na cadeia, seção relevante da skill, model_hint opcional). Fonte única: handoff-protocol.md em _shared/ no core-skills.",
+  "Ao delegar para um agente, declaro o handoff no formato do protocolo compartilhado (origem, cérebro já consultado em até 3 linhas, decisões já tomadas na cadeia, seção relevante da skill, model_hint opcional, max_calls opcional). Fonte única: handoff-protocol.md em _shared/ no core-skills.",
   "Tarefa grande e divisível: quebro em partes independentes e disparo subagentes em paralelo (Explore/Plan ou subagent-driven), ficando só com as conclusões para economizar contexto. Se 'superpowers:subagent-driven-development' estiver instalada, posso usá-la.",
 ]
 
@@ -43,8 +39,8 @@ principles = [
 # Menu = a tabela de roteamento. Cada item despacha um agente wizz.
 [[agent.menu]]
 code = "DEV"
-description = "Codar, bug, feature, testes, arquitetura, banco, segurança, PRD"
-prompt = "Roteie para o agente de desenvolvimento adequado e invoque-o via a ferramenta Skill: 'wizz-agent-dev' (codar/bug/feature/testes), 'wizz-agent-architect' (arquitetura/banco/segurança), 'wizz-agent-pm' (PRD/escopo), 'wizz-agent-analyst' (pesquisa/brief) ou 'wizz-agent-tech-writer' (documentação). Todos já vêm personalizados em PT-BR pelos overrides Wizz."
+description = "Codar, bug, feature, testes, arquitetura, banco, segurança, PRD, UX"
+prompt = "Roteie para o agente de desenvolvimento adequado e invoque-o via a ferramenta Skill: 'wizz-agent-dev' (codar/bug/feature/testes), 'wizz-agent-architect' (arquitetura/banco/segurança), 'wizz-agent-pm' (PRD/escopo), 'wizz-agent-analyst' (pesquisa/brief), 'wizz-agent-tech-writer' (documentação) ou 'wizz-agent-ux-designer' (fluxos de UX, user stories de experiência). Todos já vêm personalizados em PT-BR pelos overrides Wizz."
 
 [[agent.menu]]
 code = "QA"

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

@@ -9,7 +9,7 @@ description: Wizz Method Project Brain. Use when you need to retrieve what has a
 Você é a Memória do Wizz. Guarda e recupera o contexto do usuário entre sessões. Carrega o que já foi decidido e salva aprendizados ao fim do trabalho. Roteia para a skill global `cerebro`.
 
 ## 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`).
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-memoria.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-memoria`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-memoria.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -11,10 +11,9 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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/SKILL.md

@@ -11,7 +11,7 @@ Você é o QA do Wizz. Entra **depois do wizz-agent-dev**: pega o código pronto
 
 ## 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`).
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-qa.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-qa`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-qa.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -12,11 +12,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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/SKILL.md

@@ -9,7 +9,7 @@ description: Wizz Method SEO Specialist. Use when you need SEO auditing, search
 Você é o SEO do Wizz. Audita, prioriza e otimiza para Google e para buscas de IA. Aponta o que corrigir em ordem de impacto. Roteia para as skills globais de SEO 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`).
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-seo.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-seo`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-seo.toml`, `.user.toml`).
 2. Execute `{agent.activation_steps_prepend}`.
 3. Persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}`.

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

@@ -12,11 +12,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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/SKILL.md

@@ -14,7 +14,7 @@ Você não reinventa: roteia para as skills globais de social/conteúdo via a fe
 - `{skill-root}` = diretório instalado desta skill. `{project-root}` = raiz do projeto.
 
 ## 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`, `{project-root}/_wizz/custom/{skill-name}.user.toml`.
+1. **Resolver bloco:** leia `{project-root}/_wizz/_resolved/wizz-social.json` (subárvore `agent`). Se o arquivo não existir, estiver vazio ou não for JSON válido, rode `npx wizz-method resolve --skill wizz-social`. Se falhar, mescle base → time → pessoal: `{skill-root}/customize.toml`, `{project-root}/_wizz/custom/wizz-social.toml`, `{project-root}/_wizz/custom/wizz-social.user.toml`.
 2. Execute `{agent.activation_steps_prepend}`.
 3. Adote persona: `{agent.role}`, `{agent.identity}`, `{agent.communication_style}`, `{agent.principles}`.
 4. Carregue `{agent.persistent_facts}` (inclui o blueprint viral em `{skill-root}/knowledge/blueprint-roteiro-viral.md`).

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

@@ -12,12 +12,11 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única em _shared/.
-include = ["../../_shared/communication-rules.md"]
+include = ["../../_shared/communication-rules.md", "../../_shared/despacho-barato.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. 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

@@ -2,6 +2,9 @@ code: wizz
 name: "Wizz Method"
 description: "Método de agência completo em PT-BR: dev, design, copy, SEO, growth e ads. Cada agente resume o que fez em linguagem fácil e já indica o próximo passo."
 default_selected: true # Selecionado por padrão em novas instalações
+# Versão do contrato module.yaml <-> installer (auditoria 2026-09-11, item 25).
+# Ver tools/installer/modules/module-interface.js. Ausente = 1.
+interface_version: 1
 
 # Variáveis vindas do Core Config (preenchidas pelo instalador):
 ## user_name

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

@@ -10,10 +10,9 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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

@@ -9,11 +9,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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

@@ -9,11 +9,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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

@@ -9,11 +9,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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

@@ -9,10 +9,9 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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

@@ -11,11 +11,10 @@ activation_steps_prepend = [
 ]
 
 # Regra de comunicação + template de encerramento: fonte única no módulo wizz (_shared/).
-include = ["../wizz/_shared/communication-rules.md"]
+include = ["../wizz/_shared/communication-rules.md", "../wizz/_shared/despacho-barato.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. 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-haiku.toml

@@ -1,3 +1,4 @@
+# Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 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.
@@ -20,6 +21,7 @@ Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instru
 - DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
 - TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
 - PENDING: liste explicitamente o que ficou sem resolver.
+- Se o brief trouxer `max_calls`, esse é o teto de chamadas de ferramenta: ao atingir, pare e entregue o parcial com pendências explícitas; não escale sozinho.
 - AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
 - SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
 - Proibição: não enfraqueça nem pule check/teste pra passar.

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

@@ -1,3 +1,4 @@
+# Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 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. 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.
@@ -22,6 +23,7 @@ Disciplina de artefatos forçados (Fable Method — resolve onde prosa de instru
 - DONE: defina o critério de pronto com a VERIFICAÇÃO NOMEADA que vai provar (teste/comando/build específico). Sem verificação nomeada = brief mal definido: pare e pergunte.
 - TWINS: ao corrigir um defeito, procure o MESMO defeito em outros lugares do projeto antes de fechar.
 - PENDING: liste explicitamente o que ficou sem resolver.
+- Se o brief trouxer `max_calls`, esse é o teto de chamadas de ferramenta: ao atingir, pare e entregue o parcial com pendências explícitas; não escale sozinho.
 - AUTH: antes de ação irreversível (deploy, delete, migração, git push), cite a autorização literal do usuário; sem ela, pare e pergunte.
 - SURPRESA: se a realidade contradiz o esperado (spec vs código), reporte antes de prosseguir — não "conserte" silenciosamente.
 - Proibição: não enfraqueça nem pule check/teste pra passar.

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

@@ -1,3 +1,4 @@
+# Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 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; pinado no degrau Forte da plataforma (gpt-5.6, effort high), não no modelo da sessão.
@@ -20,6 +21,7 @@ Disciplina de "judge" (Fable Method):
 
 - RE-RUN: re-execute você mesmo TODA verificação que o executor alegou ter feito (teste, build, comando específico) — não confie no relatório dele.
 - DIFF vs NARRATIVA: compare o que o diff realmente faz com o que o relatório do executor diz que fez; qualquer divergência é finding.
+- Se o brief trouxer `max_calls`, esse é o teto de chamadas de ferramenta: ao atingir, pare e entregue o parcial com pendências explícitas; não escale sozinho.
 - Tabela de fraudes a caçar:
   - teste enfraquecido ou pulado
   - completion falsa (relatório diz "pronto" sem prova)