wizz-method 2.2.0 → 2.3.0

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

@@ -1,73 +1,73 @@
-# Réguas numéricas · diagnóstico de tráfego low ticket
+# Numeric rulers · low-ticket traffic diagnosis
 
-> 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.
+> Fallback. The canonical source is shard `03-campanha-bidcap.md` and `02-diagnostico-funil.md` from `wizz-lowticket-metodologia`. This page exists so the skill stays usable when the knowledge module isn't installed, and for a quick number lookup.
 
 ## Bid cap
 
-**Pré-requisitos antes de recomendar bid cap:** breakeven calculado, pelo menos 1 criativo validado, Pixel funcionando, CAPI funcionando, volume de conversão suficiente.
+**Prerequisites before recommending bid cap:** calculated break-even, at least 1 validated creative, Pixel working, CAPI working, sufficient conversion volume.
 
-Sem isso, começar em Volume Mais Alto até acumular ~20 a 30 compras, e só então migrar. Não é convivência em paralelo, é sequência.
+Without that, start on Highest Volume until you accumulate ~20 to 30 purchases, and only then migrate. It's not parallel coexistence, it's a sequence.
 
-| Postura | Cálculo |
+| Posture | Calculation |
 |---|---|
-| Base | bid cap = breakeven |
-| Agressivo | breakeven × 1,30 |
-| Agressivo (recomendação operacional atual) | breakeven × 1,50 |
+| Base | bid cap = break-even |
+| Aggressive | break-even × 1.30 |
+| Aggressive (current operational recommendation) | break-even × 1.50 |
 
-Exemplo: breakeven R$163 → bid cap agressivo R$244,50.
+Example: break-even R$163 → aggressive bid cap R$244.50.
 
-Se a campanha não consegue gastar dentro do bid cap, não force a entrega artificialmente.
+If the campaign can't spend within the bid cap, don't force delivery artificially.
 
-## Régua de 3x
+## The 3x rule
 
-**Gasto acumulado abaixo de 3x o bid cap = campanha não julgada.** Nem criativo, nem página, nem checkout, nem orçamento. Informe o valor exato que falta.
+**Accumulated spend below 3x the bid cap = the campaign hasn't been judged.** Not the creative, not the page, not the checkout, not the budget. Report the exact amount still needed.
 
-Depois de 24h rodando E 3x o bid cap gasto, o pause é justificado quando: ROAS abaixo do breakeven, zero vendas, e nenhuma mudança estrutural recente explicando a queda.
+After 24h running AND 3x the bid cap spent, pausing is justified when: ROAS is below break-even, zero sales, and no recent structural change explains the drop.
 
-## Hierarquia de métricas
+## Metric hierarchy
 
-`Vendas → Iniciar Checkout → CPC → Hook Rate → Hold Rate → CPM`
+`Sales → Initiate Checkout → CPC → Hook Rate → Hold Rate → CPM`
 
-- **Hook rate** = reproduções de 3s ÷ impressões
-- **Hold rate** = reproduções de 75% ÷ impressões
-- **ROAS** = a coluna de ROAS da plataforma. Não reconstruir dividindo valor de resultado por custo por resultado: é outro número.
+- **Hook rate** = 3s plays ÷ impressions
+- **Hold rate** = 75% plays ÷ impressions
+- **ROAS** = the platform's ROAS column. Don't reconstruct it by dividing result value by cost per result: that's a different number.
 
-## Funil: as 5 transições e seus benchmarks
+## Funnel: the 5 transitions and their benchmarks
 
-Taxa real = etapa seguinte ÷ etapa anterior. **Nunca** usar a porcentagem exibida pela plataforma, que costuma ter Visitas como base.
+Real rate = next stage ÷ previous stage. **Never** use the percentage the platform displays, which usually uses Visits as its base.
 
-| Transição | Ruim | Médio | Saudável | Onde atacar |
+| Transition | Poor | Average | Healthy | Where to attack |
 |---|---|---|---|---|
-| Cliques → Visitas | < 70% | 70-90% | ≥ 95% | técnico: página lenta, redirect, SSL, mobile, PageView |
-| Visitas → Iniciar Checkout | < 10% | 10-25% | 25-40%+ | criativo, página e oferta: mismatch, CTA fraco, preço antes do valor |
-| Iniciar Checkout → Venda Iniciada | < 50% | 50-75% | 75-90% | checkout: campos, atrito, confiança, meio de pagamento, mobile |
-| Venda Iniciada → Venda Aprovada (Pix) | < 50% | 60-75% | 75-90% | pagamento: aprovação Pix, recuperação de pendente |
-| Venda Iniciada → Venda Aprovada (Cartão) | < 60% | 60-75% | 75-90% | pagamento: cartão recusado, retry |
+| Clicks → Visits | < 70% | 70-90% | ≥ 95% | technical: slow page, redirect, SSL, mobile, PageView |
+| Visits → Initiate Checkout | < 10% | 10-25% | 25-40%+ | creative, page, and offer: mismatch, weak CTA, price before value |
+| Initiate Checkout → Sale Started | < 50% | 50-75% | 75-90% | checkout: fields, friction, trust, payment method, mobile |
+| Sale Started → Sale Approved (Pix) | < 50% | 60-75% | 75-90% | payment: Pix approval, pending-sale recovery |
+| Sale Started → Sale Approved (Card) | < 60% | 60-75% | 75-90% | payment: declined card, retry |
 
-**Ordem de ataque:** de trás para frente. Checkout e pagamento primeiro, página depois, criativo por último.
+**Order of attack:** back to front. Checkout and payment first, page next, creative last.
 
-## Aprovação de Pix
+## Pix approval
 
-- **abaixo de 70% = problema grave.** Para tudo e ataca checkout/pagamento antes de qualquer outra coisa.
-- **75% = meta** de operação saudável.
+- **below 70% = a serious problem.** Stop everything and attack checkout/payment before anything else.
+- **75% = the target** for a healthy operation.
 
-Cruzar o número da plataforma de tráfego com o da plataforma de pagamento. Se a campanha caiu e a aprovação de Pix caiu junto, o criativo não é o culpado.
+Cross-check the traffic platform's number against the payment platform's. If the campaign dropped and Pix approval dropped along with it, the creative isn't the culprit.
 
-## Escala
+## Scale
 
-Alavancas, nesta ordem: (1) subir o bid cap, (2) adicionar criativos validados, (3) orçamento inflado com o bid cap segurando o gasto real.
+Levers, in this order: (1) raise the bid cap, (2) add validated creatives, (3) an inflated budget with the bid cap holding down actual spend.
 
-**Nunca** como primeira alavanca: subir o orçamento diário. O orçamento dá permissão para gastar; o bid cap é o teto real de aquisição.
+**Never** as the first lever: raising the daily budget. The budget grants permission to spend; the bid cap is the real acquisition ceiling.
 
-Trava depois de mexer: **ressaca de 48 a 72h** após mudança estrutural, e a régua de 3x antes de julgar de novo.
+Lockout after touching it: **48 to 72h hangover** after a structural change, and the 3x rule before judging again.
 
-## Cadência e saturação
+## Cadence and saturation
 
-- 1 lote novo de criativos por semana, iniciado na virada de segunda-feira.
-- ~15 dias sem lote novo = problema estrutural de cadência.
-- Frequência acima de 3 em 7 dias = início de saturação. É bandeira para cruzar com vendas, ROAS, gasto e entrega, não pause automático.
-- Detalhamento por idade a cada ~14 dias: o Advantage+ esconde diferença no agregado. Usar o histórico da própria conta, sem regra universal de faixa etária.
+- 1 new creative batch per week, started at the Monday turnover.
+- ~15 days with no new batch = a structural cadence problem.
+- Frequency above 3 in 7 days = the start of saturation. It's a flag to cross-check against sales, ROAS, spend, and delivery, not an automatic pause.
+- Age breakdown every ~14 days: Advantage+ hides differences in the aggregate. Use the account's own history, no universal age-bracket rule.
 
-## O que não recomendar como padrão
+## What not to recommend as a default
 
-ABO · interesses · segmentação excessiva · duplicação de campanha · vários conjuntos sem necessidade · aumento agressivo de orçamento diário · pause antes de 3x bid cap · decisão só por CPM · decisão só por CTR · troca simultânea de criativo, página e checkout.
+ABO · interests · over-segmentation · campaign duplication · multiple ad sets with no need · aggressive daily-budget increases · pausing before 3x bid cap · deciding by CPM alone · deciding by CTR alone · changing creative, page, and checkout at the same time.

package/src/modules/wizz/README.md

@@ -1,40 +1,40 @@
-# Módulo Wizz — método de agência em PT-BR
+# Wizz Module — PT-BR agency method
 
-Personalização do WIZZ para a Wizz: linguagem fácil e resumida, cada agente termina com **✅ o que fiz / ➡️ próximo passo / 🎯 comando**, e o `wizz-router` é a porta técnica que triageia pedidos leves para agentes de área ou casos complexos para o `wizz-maestro`.
+Wizz customization for Wizz: plain, concise language, every agent closes with **✅ o que fiz / ➡️ próximo passo / 🎯 comando**, and `wizz-router` is the technical entry point that triages light requests to area agents or complex cases to `wizz-maestro`.
 
-## Agentes
+## Agents
 
-| Agente | Ícone | Faz | Rota para (skills globais) |
+| Agent | Icon | Does | Routes to (global skills) |
 |---|---|---|---|
-| `wizz-maestro` | 🧭 | Orquestra trabalhos complexos e multi-área recebidos do router | todos os agentes wizz/wizz |
-| `wizz-designer` | 🎨 | Design visual, landing, motion, 3D | wizz-premium-landing-ui-researcher, wizz-ui-ux-pro-max, wizz-motion-3d-director, wizz-taste-skill, wizz-ui-component-curator |
-| `wizz-copy` | ✍️ | Copy, e-mail, headlines | wizz-copywriting, wizz-email-sequence, wizz-humanizer, wizz-copy-editing |
-| `wizz-seo` | 🔍 | SEO tradicional e de IA | wizz-seo-audit, wizz-ai-seo, wizz-schema-markup, wizz-programmatic-seo, wizz-site-architecture |
-| `wizz-growth` | 📈 | Marketing, CRO, lançamento, preço, churn | wizz-marketing-ideas, wizz-page-cro, wizz-launch-strategy, wizz-pricing-strategy, wizz-churn-prevention |
-| `wizz-ads` | 📢 | Mídia paga | wizz-paid-ads, wizz-ad-creative, wizz-analytics-tracking |
-| `wizz-memoria` | 🧠 | Memória do projeto | cerebro |
+| `wizz-maestro` | 🧭 | Orchestrates complex, multi-area work received from the router | all wizz/wizz agents |
+| `wizz-designer` | 🎨 | Visual design, landing pages, motion, 3D | wizz-premium-landing-ui-researcher, wizz-ui-ux-pro-max, wizz-motion-3d-director, wizz-taste-skill, wizz-ui-component-curator |
+| `wizz-copy` | ✍️ | Copy, email, headlines | wizz-copywriting, wizz-email-sequence, wizz-humanizer, wizz-copy-editing |
+| `wizz-seo` | 🔍 | Traditional and AI SEO | wizz-seo-audit, wizz-ai-seo, wizz-schema-markup, wizz-programmatic-seo, wizz-site-architecture |
+| `wizz-growth` | 📈 | Marketing, CRO, launch, pricing, churn | wizz-marketing-ideas, wizz-page-cro, wizz-launch-strategy, wizz-pricing-strategy, wizz-churn-prevention |
+| `wizz-ads` | 📢 | Paid media | wizz-paid-ads, wizz-ad-creative, wizz-analytics-tracking |
+| `wizz-memoria` | 🧠 | Project memory | cerebro |
 
-Os papéis de dev/produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `overrides/`.
+The dev/product roles reuse the WIZZ agents (Mary, John, Winston, Amelia, Sally, Paige), customized in PT-BR via the overrides in `overrides/`.
 
-## Camada Wizz (em todos os agentes)
+## Wizz Layer (on every agent)
 
-- **Encerramento** (`_shared/encerramento.md`): bloco ✅/➡️/🎯 ao terminar.
-- **Economia de token** (`_shared/token-economy.md`): cerebro → grep antes de ler arquivos; RTK reescreve shell; trabalho mecânico vira linha-fato na ativação de todo agente (2+ subagentes `wizz-exec-haiku`/`wizz-exec-sonnet` em paralelo, nunca na sessão principal), o modelo da sessão é o chefe (orquestra e decide, não executa): `wizz-exec-opus` é o destino padrão do trabalho difícil em sessão Fable e `wizz-exec-review` roda pinado no degrau Forte, nunca herda a sessão; escada completa em `_shared/model-ladder.md`.
-- **Cerebro** (`_shared/cerebro.md`): auto-load leve na ativação, lembrete de salvar no fim.
-- **Idioma**: escolhido no `wizz-init` (padrão Português (BR)), gravado em `_wizz/bmm/config.yaml`.
-- **Encadeamento**: automático. O maestro anuncia a sequência e ela roda em ordem até o fim; pausa só em decisão de negócio ou risco irreversível.
-- **Gate de planejamento** (`_shared/planning-gate.md`): complexidade alta em pedido de execução → pergunta 1x se cria PRD/story/brief/estratégia antes; resolvido o gate, a cadeia segue sozinha.
+- **Closing** (`_shared/encerramento.md`): ✅/➡️/🎯 block at the end.
+- **Token economy** (`_shared/token-economy.md`): cerebro → grep before reading files; RTK rewrites shell commands; mechanical work becomes a fact-line at every agent's activation (2+ `wizz-exec-haiku`/`wizz-exec-sonnet` subagents in parallel, never in the main session); the session's model is the boss (orchestrates and decides, doesn't execute): `wizz-exec-opus` is the default destination for hard work in a Fable session and `wizz-exec-review` always runs pinned to the Strong tier, never inheriting the session; full ladder in `_shared/model-ladder.md`.
+- **Cerebro** (`_shared/cerebro.md`): light auto-load on activation, reminder to save at the end.
+- **Language**: chosen in `wizz-init` (default Português (BR)), recorded in `_wizz/bmm/config.yaml`.
+- **Chaining**: automatic. The maestro announces the sequence and it runs in order to the end; it only pauses on a business decision or irreversible risk.
+- **Planning gate** (`_shared/planning-gate.md`): high complexity in an execution request → asks once whether to create a PRD/story/brief/strategy first; once the gate is resolved, the chain proceeds on its own.
 
-## Instalação
+## Installation
 
-1. Instale o WIZZ no projeto (o módulo `wizz` aparece como bundled em `src/modules/wizz`).
-2. Rode a personalização Wizz (escolha do idioma + overrides dos agentes WIZZ):
+1. Install WIZZ in the project (the `wizz` module appears bundled in `src/modules/wizz`).
+2. Run the Wizz customization (language choice + WIZZ agent overrides):
    ```bash
-   node <caminho-do-wizz-method>/src/modules/wizz/scripts/wizz-init.mjs .
+   node <path-to-wizz-method>/src/modules/wizz/scripts/wizz-init.mjs .
    ```
-   Ele pergunta o idioma. Para CI, use `--lang "English"` ou `WIZZ_LANG`. Idempotente: pode rodar quantas vezes quiser.
-3. Invoque o `wizz-router` e mande seu pedido. Para trabalhos claramente multi-área, o `wizz-maestro` também pode ser chamado direto.
+   It asks for the language. For CI, use `--lang "English"` or `WIZZ_LANG`. Idempotent: you can run it as many times as you want.
+3. Invoke `wizz-router` and send your request. For clearly multi-area work, `wizz-maestro` can also be called directly.
 
-## Customização pessoal
+## Personal customization
 
-Os overrides em `overrides/*.toml` são escopo **time** e vão para `_wizz/custom/`. Para ajustes só seus, crie `_wizz/custom/<skill>.user.toml` — ele vence por cima.
+The overrides in `overrides/*.toml` are **team**-scoped and go into `_wizz/custom/`. For changes just for you, create `_wizz/custom/<skill>.user.toml` — it wins on top.

package/src/modules/wizz/_shared/cerebro.md

@@ -1,58 +1,58 @@
-# Integração com o Cerebro (memória persistente)
+# Integration with the Cerebro (persistent memory)
 
-O cerebro é a memória do usuário entre sessões (Claude Code, Codex e outros). Modo configurado: **auto-load leve no início + lembrete de salvar no fim**.
+The cerebro is the user's memory across sessions (Claude Code, Codex, and others). Configured mode: **light auto-load at the start + a reminder to save at the end**.
 
-São duas camadas, e cada fato mora em uma só: o **vault** (decisão, estado, sessão) e a **auto-memória do agente** (armadilha de stack, preferência do usuário). O vault é lido igual em qualquer plataforma. A auto-memória carrega sozinha no Claude Code; nas outras (Codex, OpenCode, Gemini) o caminho é o comando `/memoria` do cerebro, que lê o mesmo diretório no disco local. Não existe cópia paralela dos fatos.
+There are two layers, and each fact lives in exactly one: the **vault** (decision, state, session) and the agent's **auto-memory** (stack gotcha, user preference). The vault reads the same on any platform. Auto-memory loads automatically in Claude Code; on the others (Codex, OpenCode, Gemini) the path is the cerebro's `/memoria` command, which reads the same local directory on disk. There's no parallel copy of the facts.
 
-## Na ativação do agente (passo prepend)
+## On agent activation (prepend step)
 
-Carregue contexto de forma **barata**:
+Load context **cheaply**:
 
-1. Rode `/cerebro ver` (ou faça um `grep` leve no vault) para puxar o estado atual do projeto e decisões recentes.
-2. Não leia o vault inteiro. Pegue só: onde parou, o que falta, decisões relevantes à área do agente.
-3. Se não houver cerebro neste projeto, siga normalmente sem travar.
+1. Run `/cerebro ver` (or a light `grep` on the vault) to pull the project's current state and recent decisions.
+2. Don't read the whole vault. Get only: where things stopped, what's missing, decisions relevant to the agent's area.
+3. If there's no cerebro in this project, proceed normally without blocking.
 
-## Ao encerrar
+## On closing
 
-- Se algo digno de memória aconteceu (decisão de arquitetura/produto, aprendizado, armadilha resolvida, correção do usuário), acrescente ao encerramento:
+- If something worth remembering happened (architecture/product decision, learning, resolved gotcha, correction from the user), add to the closing:
   `💾 Quer que eu salve isso no cerebro?`
-- Se o usuário confirmar, use o comando certo do cerebro:
-  - `/cerebro decisao` — decisão de arquitetura/produto
-  - `/cerebro salvar` — estado da sessão
-  - `/cerebro dump` — captura rápida
-  - `/cerebro memoria` — armadilha ou preferência (auto-memória), quando o agente não é o Claude Code
+- If the user confirms, use the right cerebro command:
+  - `/cerebro decisao` — architecture/product decision
+  - `/cerebro salvar` — session state
+  - `/cerebro dump` — quick capture
+  - `/cerebro memoria` — gotcha or preference (auto-memory), when the agent isn't Claude Code
 
-## Dever de memória (não-negociável)
+## Duty to remember (non-negotiable)
 
-Após bug não-óbvio resolvido, decisão importante, armadilha de stack ou correção recebida do usuário, ofereça salvar. É assim que o método aprende. Mas salve **numa camada só**.
+After a non-obvious bug is resolved, an important decision, a stack gotcha, or a correction received from the user, offer to save it. That's how the method learns. But save it **in one layer only**.
 
-## Roteamento: uma fonte por tipo de fato
+## Routing: one source per type of fact
 
-| tipo de fato | grava em |
+| type of fact | goes into |
 |---|---|
-| decisão de arquitetura ou de produto | Cérebro `_decisions/` (`/cerebro decisao`) |
-| estado do projeto (onde parou, o que falta) | Cérebro `projetos/<nome>.md`, bloco no topo (`/cerebro salvar`) |
-| narrativa de sessão (o que rolou no dia) | Cérebro `projetos/<nome>.md`: bloco `Estado` no topo (sobrescrito) + 1 linha na tabela `Sessões` |
-| armadilha de stack, bug não-óbvio, pegadinha de ambiente | auto-memória do agente (`memory/` do projeto; fora do Claude Code, via `/memoria`) |
-| preferência de trabalho, correção recebida do usuário | auto-memória do agente (idem) |
-| como-fazer, definição de produto, metodologia | o artefato ou a skill; a memória guarda só o **caminho** |
+| architecture or product decision | Cerebro `_decisions/` (`/cerebro decisao`) |
+| project state (where it stopped, what's missing) | Cerebro `projetos/<name>.md`, block at the top (`/cerebro salvar`) |
+| session narrative (what happened that day) | Cerebro `projetos/<name>.md`: `Estado` block at the top (overwritten) + 1 line in the `Sessões` table |
+| stack gotcha, non-obvious bug, environment quirk | agent auto-memory (`memory/` of the project; outside Claude Code, via `/memoria`) |
+| work preference, correction received from the user | agent auto-memory (same) |
+| how-to, product definition, methodology | the artifact or the skill; memory keeps only the **path** |
 
-Três regras que sustentam isso:
+Three rules that make this hold:
 
-1. **Um fato mora numa camada só.** As outras guardam no máximo um ponteiro. Nunca escreva o mesmo fato em duas.
-2. **Grep antes de gravar.** Busque na camada de destino primeiro. Se o fato já existe, atualize o registro existente em vez de criar um segundo.
-3. **Se está num artefato, guarde o caminho.** PRD, story, spec, doc: o conteúdo fica lá, a memória aponta.
+1. **A fact lives in one layer only.** The others keep at most a pointer. Never write the same fact in two places.
+2. **Grep before saving.** Search the destination layer first. If the fact already exists, update the existing record instead of creating a second one.
+3. **If it's in an artifact, keep the path.** PRD, story, spec, doc: the content stays there, memory just points to it.
 
-## Feature ativa = o tema da memória
+## Active feature = the theme of the memory
 
-O hook `session-rules.js` resolve a feature do branch git e injeta `FEATURE ATIVA: <slug>` no início da sessão. Quando existe, ela é o **eixo único** de organização:
+The `session-rules.js` hook resolves the feature from the git branch and injects `FEATURE ATIVA: <slug>` at the start of the session. When it exists, it's the **single axis** of organization:
 
-- decisão gravada no Cérebro leva `tema: <slug>` no frontmatter;
-- o bloco de estado do projeto registra sob qual feature o trabalho está;
-- entrada de auto-memória sobre esse trabalho cita o slug na descrição.
+- a decision saved to the Cerebro carries `tema: <slug>` in the frontmatter;
+- the project state block records which feature the work is under;
+- an auto-memory entry about that work cites the slug in its description.
 
-Assim um `grep` pelo slug acha artefato, decisão e armadilha juntos. Não crie um campo `feature:` paralelo ao `tema:`: é um eixo só. Sem feature resolvida, grave sem tema de feature; é estado válido, não problema a corrigir.
+That way a `grep` for the slug finds the artifact, decision, and gotcha together. Don't create a `feature:` field parallel to `tema:`: it's a single axis. With no feature resolved, save without a feature theme; that's a valid state, not a problem to fix.
 
-O hook é do Claude Code, e portar hooks para as outras plataformas está **fora de escopo por decisão** (2026-08-28). Em Codex, OpenCode e Gemini não há `FEATURE ATIVA` injetada: resolva o tema do branch git na hora (`git branch --show-current`) ou trabalhe sem tema. Sem hook não é degradação silenciosa; é limite conhecido e documentado.
+The hook is Claude Code's, and porting hooks to the other platforms is **out of scope by decision** (2026-08-28). In Codex, OpenCode, and Gemini there's no injected `FEATURE ATIVA`: resolve the theme from the git branch on the spot (`git branch --show-current`) or work without a theme. No hook isn't silent degradation; it's a known, documented limit.
 
-Seção "Aprendizados do projeto" no `CLAUDE.md` do projeto **não é passo padrão**. Só em repo compartilhado com outros humanos, e mesmo aí como resumo curto que aponta para a camada canônica.
+The "Aprendizados do projeto" ("Project learnings") section in the project's `CLAUDE.md` **isn't a standard step**. Only in a repo shared with other humans, and even then as a short summary that points to the canonical layer.

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

@@ -1,20 +1,20 @@
-# Comunicação Wizz (fonte única)
+# Wizz Communication (single source)
 #
-# 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
-# para outro toml: referencie via `include`.
+# This file is read by the installer's resolver (`wizz resolve`, Node) through the
+# `include` key in `customize.toml`/overrides. Each paragraph below (a block
+# separated by a blank line) becomes an item in `activation_steps_append`.
+# Editing here updates every agent at once. Don't copy this text
+# into another toml: reference it via `include`.
 # ---
-# FONTE ÚNICA. Existe exatamente uma cópia intencional deste texto fora daqui:
-# a constante RULES em `tools/hooks/session-rules.js`, que roda como hook de
-# SessionStart e precisa ser autocontida (o hook vive em ~/.claude/hooks e não
-# enxerga este arquivo). Ela é uma versão comprimida, e o teste
-# `test/test-feature-context.js` falha se as duas divergirem no conteúdo.
-# Qualquer outro arquivo que precise da regra referencia este, não copia.
+# SINGLE SOURCE. There is exactly one other intentional copy of this text:
+# the RULES constant in `tools/hooks/session-rules.js`, which runs as a
+# SessionStart hook and needs to be self-contained (the hook lives in
+# ~/.claude/hooks and can't see this file). It's a compressed version, and
+# the test `test/test-feature-context.js` fails if the two diverge in content.
+# Any other file that needs this rule should reference this one, not copy it.
 
-WIZZ COMUNICAÇÃO: não narre o passo a passo enquanto trabalha, isso gasta token e polui a conversa. Trabalhe direto. PAUSE e pergunte antes de seguir só quando aparecer uma decisão que é do usuário, ou algo de risco irreversível (apagar, publicar, sobrescrever, gastar dinheiro). Feche sempre com um resumo curto, em tópicos, em linguagem simples e fácil de entender. Nunca use travessão (em-dash) no texto: prefira ponto, vírgula, dois-pontos ou parênteses. Resposta enxuta por default, em PT-BR fácil: expanda só quando pedirem. Não repita o que o usuário já sabe, não re-explique o que já foi dito na sessão e não liste opções que você não vai seguir (recomende e aja).
+WIZZ COMMUNICATION: don't narrate the step-by-step while working, it wastes tokens and clutters the conversation. Work directly. PAUSE and ask before continuing only when a decision belongs to the user, or something carries irreversible risk (deleting, publishing, overwriting, spending money). Always close with a short summary, in bullet points, in simple, easy-to-understand language. Don't use em-dashes in text a third party reads (public page, copy, UI, email): prefer a period, comma, colon, or parentheses. Code comments, commits, internal docs, and conversation with the user are exempt from this check: don't spend tokens reviewing or swapping em-dashes there. Concise reply by default, in easy Brazilian Portuguese: expand only when asked. Don't repeat what the user already knows, don't re-explain what was already said in the session, and don't list options you won't follow (recommend and act).
 
-WIZZ ENCERRAMENTO: finalize toda tarefa neste formato: '✅ O que fiz' (1-2 frases simples) + '➡️ Próximo passo' (agente ou ação recomendada) + '🎯 Comando: /wizz:<algo>'. Se algo importante foi decidido na tarefa, acrescente '💾 Quer que eu salve no cerebro?'.
+WIZZ CLOSING: finish every task in this format: '✅ O que fiz' (1-2 simple sentences) + '➡️ Próximo passo' (recommended agent or action) + '🎯 Comando: /wizz:<something>'. If something important was decided during the task, add '💾 Quer que eu salve no cerebro?'.
 
-RTK: o RTK (Rust Token Killer) já reescreve comandos de shell automaticamente via hook. Não precisa invocar nada à parte. Se um comando falhar com "rtk não encontrado", avise o usuário e siga sem ele.
+RTK: RTK (Rust Token Killer) already rewrites shell commands automatically via hook. No need to invoke anything separately. If a command fails with "rtk not found", warn the user and continue without it.

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

@@ -1,9 +1,9 @@
-# Despacho de trabalho barato (fonte única)
+# Cheap work dispatch (single source)
 #
-# 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`.
+# This file is read by the installer's resolver (`wizz resolve`, Node) through the
+# `include` key in `customize.toml`/overrides. The paragraph below becomes an
+# item in `activation_steps_append`. Editing here updates every agent at
+# once. Don't copy this text into another toml: reference it 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.
+Mechanical work (scanning, lookup, repetitive diff, an already-specified change): don't run it in the session; dispatch 2+ wizz-exec-haiku/wizz-exec-sonnet subagents in parallel, one per file/module. The session's model is the boss: it orchestrates and decides, it doesn't execute. Hard work goes to wizz-exec-opus when the session runs above Opus (Fable); in an Opus session the boss absorbs that rung. Diff review always goes to wizz-exec-review (pinned to opus, never inherits the session). Tell the user the rung and quantity of each dispatch. Full ladder in `_shared/model-ladder.md` and the rule in `_shared/token-economy.md` of the wizz module.

package/src/modules/wizz/_shared/encerramento.md

@@ -1,31 +1,31 @@
-# Protocolo de Encerramento Wizz
+# Wizz Closing Protocol
 
-**Antes de montar o bloco:** confira o entregável contra o brief original. Faltou algo? Liste em `⚠️ Não coberto`. Se está tudo coberto, não adicione essa linha.
+**Before assembling the block:** check the deliverable against the original brief. Missing something? List it under `⚠️ Not covered`. If everything is covered, don't add that line.
 
-Toda vez que você terminar uma tarefa ou explicar um serviço, encerre **exatamente** neste formato. Linguagem fácil, frases curtas, em PT-BR. Sem jargão.
+Every time you finish a task or explain a service, close **exactly** in this format. Easy language, short sentences, in Brazilian Portuguese. No jargon.
 
 ```
 ✅ O que fiz
-<1 a 2 frases simples, como se explicasse para um cliente>
+<1 to 2 simple sentences, as if explaining to a client>
 
-⚠️ Não coberto: <itens> (só quando houver diff contra o brief original)
+⚠️ Não coberto: <items> (only when there's a diff against the original brief)
 
 ➡️ Próximo passo
-<qual agente chamar OU o que fazer agora>
+<which agent to call OR what to do now>
 
-🎯 Comando: /wizz:<agente-ou-acao>
+🎯 Comando: /wizz:<agent-or-action>
 ```
 
-## Regras
+## Rules
 
-- **Resuma em linguagem de gente.** Nada de "implementei o refactor do módulo X". Prefira "deixei o site mais rápido e organizei o código".
-- **Sempre aponte UM próximo passo claro.** Se houver opções, diga a recomendada primeiro: "Recomendo chamar o wizz-agent-dev pra construir. Se for ajuste pontual, use wizz-quick-dev. Se quiser ver o visual antes, chame o wizz-designer."
-- **Encadeamento automático.** Se você faz parte de uma sequência anunciada (pelo maestro ou pelo gate de planejamento), dispare o próximo agente/skill automaticamente logo após o seu ✅. Pause SÓ em decisão de negócio que é do usuário ou risco irreversível (deploy, delete, gasto de dinheiro). Fora de sequência anunciada, sugira o próximo passo e aguarde.
-- **Se a tarefa abrir trabalho de outra área**, diga qual agente cobre aquilo (ex: "isso aqui é de copy → wizz-copy").
-- **Cerebro:** se algo importante foi decidido, acrescente uma linha:
+- **Summarize in plain human language.** No "I implemented the refactor of module X." Prefer "I made the site faster and organized the code."
+- **Always point to ONE clear next step.** If there are options, state the recommended one first: "I recommend calling wizz-agent-dev to build it. For a quick tweak, use wizz-quick-dev. To see the visual first, call wizz-designer."
+- **Automatic chaining.** If you're part of a sequence already announced (by the maestro or by the planning gate), trigger the next agent/skill automatically right after your ✅. Pause ONLY for a business decision that belongs to the user or an irreversible risk (deploy, delete, spending money). Outside an announced sequence, suggest the next step and wait.
+- **If the task opens up work from another area**, say which agent covers it (e.g., "this one is copy → wizz-copy").
+- **Cerebro:** if something important was decided, add a line:
   `💾 Quer que eu salve isso no cerebro?`
 
-## Exemplo real
+## Real example
 
 ```
 ✅ O que fiz
@@ -39,20 +39,20 @@ Se preferir já partir pro código, chame o wizz-agent-dev.
 💾 Quer que eu salve a estrutura no cerebro?
 ```
 
-## Marcador de decisão (telemetria, opt-in)
+## Decision marker (telemetry, opt-in)
 
-Em todo pedido **roteado** (não em conversa trivial), adicione **1 linha extra** no fim da resposta, depois do bloco acima:
+On every **routed** request (not on trivial conversation), add **1 extra line** at the end of the response, after the block above:
 
 ```
 🧭 {"rota":"agent:designer","sel":["wizz-canvas-design"],"desc":[["hyperframes","carrossel é estático não vídeo"]],"gate":"ok","repetiria":true}
 ```
 
-Formato exato — objeto JSON plano numa única linha, sem quebras:
+Exact format — a flat JSON object on a single line, no line breaks:
 
-- `rota`: `"agent:<area>"`, `"maestro"` ou `"flat:<skill>"` — quem de fato tratou o pedido.
-- `sel`: array com os ids das skills/agentes selecionados.
-- `desc`: array de `[id_descartado, "motivo em até 6 palavras"]` — o que você considerou e não usou, e por quê.
-- `gate`: string curta com o resultado do gate aplicado (ex: `"ok"`, `"pulado"`, `"bloqueado"`).
-- `repetiria`: bool — self-eval mínima: se recebesse este pedido de novo, faria a mesma escolha?
+- `rota`: `"agent:<area>"`, `"maestro"`, or `"flat:<skill>"` — who actually handled the request.
+- `sel`: array with the ids of the selected skills/agents.
+- `desc`: array of `[discarded_id, "reason in up to 6 words"]` — what you considered and didn't use, and why.
+- `gate`: short string with the result of the gate applied (e.g., `"ok"`, `"pulado"`, `"bloqueado"`).
+- `repetiria`: bool — minimal self-eval: if you got this request again, would you make the same choice?
 
-Isso é telemetria de decisão: um hook de evento Stop lê o transcript e appenda o marcador num log local, opt-in via `WIZZ_TRACE=1` (sem isso, o hook nem toca em disco). Custo: ~30-60 tokens de output, 0 de input. Não emita em conversa trivial.
+This is decision telemetry: a Stop event hook reads the transcript and appends the marker to a local log, opt-in via `WIZZ_TRACE=1` (without it, the hook doesn't even touch disk). Cost: ~30-60 output tokens, 0 input. Don't emit it on trivial conversation.