wizz-method 1.19.0 → 2.1.0

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 = [
@@ -40,24 +39,24 @@ principles = [
 [[agent.menu]]
 code = "AU"
 description = "Auditoria de SEO, por que não ranqueia, problemas técnicos"
-prompt = "Invoque a skill GLOBAL 'seo-audit' via a ferramenta Skill. Entregue as correções em ordem de impacto, em PT-BR fácil."
+prompt = "Invoque a skill GLOBAL 'wizz-seo-audit' via a ferramenta Skill. Entregue as correções em ordem de impacto, em PT-BR fácil."
 
 [[agent.menu]]
 code = "AI"
 description = "Aparecer em ChatGPT, Perplexity, AI Overviews"
-prompt = "Invoque a skill GLOBAL 'ai-seo' via a ferramenta Skill."
+prompt = "Invoque a skill GLOBAL 'wizz-ai-seo' via a ferramenta Skill."
 
 [[agent.menu]]
 code = "SC"
 description = "Schema markup / dados estruturados"
-prompt = "Invoque a skill GLOBAL 'schema-markup' via a ferramenta Skill."
+prompt = "Invoque a skill GLOBAL 'wizz-schema-markup' via a ferramenta Skill."
 
 [[agent.menu]]
 code = "PR"
 description = "Criar muitas páginas para keywords em escala (SEO programático)"
-prompt = "Invoque a skill GLOBAL 'programmatic-seo' via a ferramenta Skill."
+prompt = "Invoque a skill GLOBAL 'wizz-programmatic-seo' via a ferramenta Skill."
 
 [[agent.menu]]
 code = "AR"
 description = "Estrutura/arquitetura do site para SEO"
-prompt = "Invoque a skill GLOBAL 'site-architecture' via a ferramenta Skill."
+prompt = "Invoque a skill GLOBAL 'wizz-site-architecture' via a ferramenta Skill."

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

@@ -1,6 +1,6 @@
 ---
 name: wizz-social
-description: Wizz Method Social e Roteiros Virais (persona Rafa). Use para roteiros de Reels/TikTok/Shorts, hooks virais, calendário de conteúdo e estratégia de social. Roteia para as skills globais social-content e content-strategy, e para o pipeline de vídeo (voicebox, ctc-align, hyperframes desenha as telas, Remotion monta o filme, buttercut, claude-video) quando o roteiro vira vídeo.
+description: Wizz Method Social e Roteiros Virais (persona Rafa). Use para roteiros de Reels/TikTok/Shorts, hooks virais, calendário de conteúdo e estratégia de social. Roteia para as skills globais wizz-social-content e wizz-content-strategy, e para o pipeline de vídeo (voicebox, ctc-align, hyperframes desenha as telas, Remotion monta o filme, buttercut, claude-video) quando o roteiro vira vídeo.
 ---
 
 # Social · Roteiros Virais e Conteúdo (persona Rafa)
@@ -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`).
@@ -51,20 +51,20 @@ Roteiro e conteúdo (você mesmo, com o blueprint + skills):
 - Gerar/transformar/editar uma imagem avulsa (sem roteiro em andamento) → `knowledge/biblioteca-prompts-imagem.md`.
 - Imagem de referência de estilo vira prompt para recriar → `knowledge/analise-imagem-referencia.md`.
 - Legenda otimizada do post (gancho, valor, CTA, hashtags) → `knowledge/legenda-instagram.md`.
-- Criar/agendar posts, calendário editorial → `social-content`
-- Decidir O QUE produzir (pilares, topic clusters) → `content-strategy`
-- Revisar/editar o texto do roteiro ou da legenda antes de publicar → `copy-editing`
+- Criar/agendar posts, calendário editorial → `wizz-social-content`
+- Decidir O QUE produzir (pilares, topic clusters) → `wizz-content-strategy`
+- Revisar/editar o texto do roteiro ou da legenda antes de publicar → `wizz-copy-editing`
 
 Desambiguação: já tem roteiro aprovado da esteira 3D e quer os prompts por cena → `prompts-imagem-video.md` (item PROMPT). Imagem avulsa sem roteiro → `biblioteca-prompts-imagem.md` (item IMG).
 
 Esteira 3D completa (fim a fim): tema → roteiro (blueprint Seção 12) → prompts de imagem+animação (`prompts-imagem-video.md`) → geração nas CLIs de vídeo → legenda (`legenda-instagram.md`). A imagem de referência entra no início para fixar o estilo visual.
 
 Quando o roteiro vira vídeo (você roteia, não executa a edição; cadeia completa em `_shared/video-pipeline.md`):
-- **Asset estático de post** (carrossel / quote card / infográfico, não é vídeo) → skill `canvas-design` (área designer)
+- **Asset estático de post** (carrossel / quote card / infográfico, não é vídeo) → skill `wizz-canvas-design` (área designer)
 - **Narração / voz / TTS** → CLI `voicebox`
 - **Timing** da narração (timestamps palavra a palavra p/ legenda e corte) → `ctc-align`
 - **Desenhar as telas** (cena visual muda em HTML/CSS, HTML→MP4) → CLI `hyperframes`
-- **Montar o filme** (áudio, SFX, legenda, timing de frame) → **Remotion** (skill `remotion-best-practices`); nunca posicionar áudio/legenda no hyperframes
+- **Montar o filme** (áudio, SFX, legenda, timing de frame) → **Remotion** (skill `wizz-remotion-best-practices`); nunca posicionar áudio/legenda no hyperframes
 - **Editar/cortar** o vídeo gravado (cortes, selects, roughcut) → CLI `buttercut` (só Apple Silicon)
 - **Analisar** um vídeo de referência (frames + transcrição) → CLI `claude-video`
 

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 = [
@@ -63,12 +62,12 @@ prompt = "Consulte knowledge/biblioteca-prompts-imagem.md: identifique a intenç
 [[agent.menu]]
 code = "CAL"
 description = "Calendário editorial / rotação de formatos"
-prompt = "Aplique a Seção 8-9 de knowledge/blueprint-roteiro-viral.md (mix alcance vs conversão, rotação de formatos) e invoque a skill GLOBAL 'content-strategy' via a ferramenta Skill para pilares e clusters. Entregue um plano semanal."
+prompt = "Aplique a Seção 8-9 de knowledge/blueprint-roteiro-viral.md (mix alcance vs conversão, rotação de formatos) e invoque a skill GLOBAL 'wizz-content-strategy' via a ferramenta Skill para pilares e clusters. Entregue um plano semanal."
 
 [[agent.menu]]
 code = "POST"
 description = "Criar/agendar posts de social (LinkedIn, X, TikTok, IG) + legenda otimizada"
-prompt = "Para legenda de post do Instagram, aplique knowledge/legenda-instagram.md (gancho, valor, CTA, hashtags, SEO). Para agendar ou outros canais, invoque a skill GLOBAL 'social-content' via a ferramenta Skill."
+prompt = "Para legenda de post do Instagram, aplique knowledge/legenda-instagram.md (gancho, valor, CTA, hashtags, SEO). Para agendar ou outros canais, invoque a skill GLOBAL 'wizz-social-content' via a ferramenta Skill."
 
 [[agent.menu]]
 code = "VID"

package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md

@@ -1,6 +1,6 @@
 # Legenda de Instagram · Copy + SEO de redes sociais
 
-Conhecimento de apoio do **wizz-social** (Rafa). Cria a descrição/legenda otimizada de um post a partir de um briefing. Complementa a skill global `social-content` com uma estrutura fechada e mais afiada.
+Conhecimento de apoio do **wizz-social** (Rafa). Cria a descrição/legenda otimizada de um post a partir de um briefing. Complementa a skill global `wizz-social-content` com uma estrutura fechada e mais afiada.
 
 ## Input esperado
 - **Tema do post** (obrigatório): breve descrição do assunto.

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
@@ -72,49 +75,49 @@ agents:
     title: Designer de Produto e UI
     icon: "🎨"
     team: wizz
-    description: "Cria interfaces, landing pages e motion de alto nível roteando para premium-landing-ui-researcher, ui-ux-pro-max e motion-3d-director. Mostra o visual antes do código e resume cada entrega em linguagem fácil."
+    description: "Cria interfaces, landing pages e motion de alto nível roteando para wizz-premium-landing-ui-researcher, wizz-ui-ux-pro-max e wizz-motion-3d-director. Mostra o visual antes do código e resume cada entrega em linguagem fácil."
 
   - code: wizz-qa
     name: QA
     title: Garantia de Qualidade
     icon: "✅"
     team: wizz
-    description: "Entra depois do dev: roda testes, gera E2E, revisão adversarial e confere acceptance criteria roteando para wizz-qa-generate-e2e-tests, adversarial-reviewer, agent-browser e wizz-code-review. Reporta achados por gravidade em linguagem fácil."
+    description: "Entra depois do dev: roda testes, gera E2E, revisão adversarial e confere acceptance criteria roteando para wizz-qa-generate-e2e-tests, wizz-adversarial-reviewer, wizz-agent-browser e wizz-code-review. Reporta achados por gravidade em linguagem fácil."
 
   - code: wizz-copy
     name: Copy
     title: Copywriter
     icon: "✍️"
     team: wizz
-    description: "Escreve copy de venda, e-mails e textos de página roteando para copywriting, email-sequence e humanizer. Humaniza o texto e entrega variações prontas."
+    description: "Escreve copy de venda, e-mails e textos de página roteando para wizz-copywriting, wizz-email-sequence e wizz-humanizer. Humaniza o texto e entrega variações prontas."
 
   - code: wizz-seo
     name: SEO
     title: Especialista de SEO
     icon: "🔍"
     team: wizz
-    description: "Audita e otimiza para busca tradicional e IA roteando para seo-audit, ai-seo, schema-markup e programmatic-seo. Aponta o que corrigir em ordem de impacto."
+    description: "Audita e otimiza para busca tradicional e IA roteando para wizz-seo-audit, wizz-ai-seo, wizz-schema-markup e wizz-programmatic-seo. Aponta o que corrigir em ordem de impacto."
 
   - code: wizz-growth
     name: Growth
     title: Growth e Conversão
     icon: "📈"
     team: wizz
-    description: "Pensa marketing, CRO, lançamento e preço roteando para marketing-ideas, page-cro, launch-strategy e pricing-strategy. Traz ideias acionáveis, não teoria."
+    description: "Pensa marketing, CRO, lançamento e preço roteando para wizz-marketing-ideas, wizz-page-cro, wizz-launch-strategy e wizz-pricing-strategy. Traz ideias acionáveis, não teoria."
 
   - code: wizz-social
     name: Rafa
     title: Social e Roteiros Virais
     icon: "🎥"
     team: wizz
-    description: "Escreve roteiros virais de Reels/Shorts (persona Rafa) com o Blueprint de Roteiro Viral, e cria/agenda conteúdo roteando para social-content e content-strategy. Quando o roteiro vira vídeo, aponta as CLIs de vídeo (buttercut, hyperframes, voicebox, claude-video). Faz briefing antes de escrever."
+    description: "Escreve roteiros virais de Reels/Shorts (persona Rafa) com o Blueprint de Roteiro Viral, e cria/agenda conteúdo roteando para wizz-social-content e wizz-content-strategy. Quando o roteiro vira vídeo, aponta as CLIs de vídeo (buttercut, hyperframes, voicebox, claude-video). Faz briefing antes de escrever."
 
   - code: wizz-ads
     name: Ads
     title: Mídia Paga
     icon: "📢"
     team: wizz
-    description: "Gerencia anúncios pagos roteando para paid-ads, ad-creative e analytics-tracking. Cria variações de criativo e acompanha métricas."
+    description: "Gerencia anúncios pagos roteando para wizz-paid-ads, wizz-ad-creative e wizz-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

@@ -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 = [
@@ -31,12 +30,12 @@ principles = [
 [[agent.menu]]
 code = "DB"
 description = "Revisar schema, queries, performance e RLS do banco"
-prompt = "Invoque a skill GLOBAL 'supabase-postgres-best-practices' via a ferramenta Skill para revisar schema, queries, performance e RLS. Se o problema for escala/capacidade, complemente com database-scaling; se for dependência/vulnerabilidade, complemente com database-and-deps."
+prompt = "Invoque a skill GLOBAL 'wizz-supabase-postgres-best-practices' via a ferramenta Skill para revisar schema, queries, performance e RLS. Se o problema for escala/capacidade, complemente com wizz-database-scaling; se for dependência/vulnerabilidade, complemente com wizz-database-and-deps."
 
 [[agent.menu]]
 code = "SEC"
 description = "Revisar segurança (OWASP, auth, headers, injeção)"
-prompt = "Invoque a skill GLOBAL 'web-security' via a ferramenta Skill."
+prompt = "Invoque a skill GLOBAL 'wizz-web-security' via a ferramenta Skill."
 
 [[agent.menu]]
 code = "MAP"

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)

package/src/modules/wizz/subagents/codex/wizz-exec-sonnet.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-sonnet"
 description = """
 Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). Atenção: "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo Claude Sonnet; o modelo real deste subagente é gpt-5.6-terra.
@@ -21,6 +22,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/gemini/wizz-exec-haiku.md

@@ -1,6 +1,8 @@
 ---
+# 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). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
+description: >-
+  Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
 kind: local
 model: gemini-3-flash-preview
 ---
@@ -20,6 +22,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/gemini/wizz-exec-opus.md

@@ -1,6 +1,8 @@
 ---
+# 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. "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
 ---
@@ -22,6 +24,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/gemini/wizz-exec-review.md

@@ -1,6 +1,8 @@
 ---
+# 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 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.
+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
 ---
@@ -19,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)

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

@@ -1,6 +1,8 @@
 ---
+# 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-sonnet
-description: Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
+description: >-
+  Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
 kind: local
 model: gemini-3-flash-preview
 ---
@@ -21,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/opencode/wizz-exec-haiku.md

@@ -1,5 +1,7 @@
 ---
-description: Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
+# 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`.
+description: >-
+  Executor barato do Wizz Method para trabalho mecânico. Varreduras de arquivos, lookups, renomeações, diffs repetitivos e aplicação de mudanças já 100% especificadas. Despachar SEMPRE em 2+ instâncias paralelas, particionadas por arquivo/módulo (nunca duas no mesmo arquivo). "haiku" aqui é o DEGRAU mais barato da escada Wizz, não o modelo subjacente.
 mode: subagent
 model: anthropic/claude-haiku-4-5
 ---
@@ -19,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/opencode/wizz-exec-opus.md

@@ -1,5 +1,7 @@
 ---
-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.
+# 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`.
+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
 ---
@@ -21,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/opencode/wizz-exec-review.md

@@ -1,5 +1,7 @@
 ---
-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.
+# 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`.
+description: >-
+  Revisor do Wizz Method pinado no degrau Forte da plataforma (anthropic/claude-opus-5), 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.
 mode: subagent
 model: anthropic/claude-opus-5
 permission:
@@ -20,6 +22,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)

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

@@ -1,5 +1,7 @@
 ---
-description: Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
+# 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`.
+description: >-
+  Executor padrão do Wizz Method para implementação do dia a dia. Feature pequena/média bem definida, correção de bug com causa conhecida, edição multi-arquivo, testes. Despachar em 2+ instâncias paralelas quando o trabalho for divisível por arquivo/módulo (nunca duas no mesmo arquivo). "sonnet" aqui é o DEGRAU intermediário da escada Wizz, não o modelo subjacente.
 mode: subagent
 model: anthropic/claude-sonnet-5
 ---
@@ -20,6 +22,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.