wizz-method 2.2.0 → 2.3.1

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

@@ -1,84 +1,85 @@
-# Protocolo de Handoff Wizz (fonte única)
+# Wizz Handoff Protocol (single source)
 
-Contrato mínimo que todo orquestrador ou spawn de subagente usa ao delegar
-trabalho: wizz-router, wizz-maestro, wizz-party-mode (subagent/agent-team)
-e swarm-orchestrator. Objetivo: cortar a dupla consulta ao cerebro (cerebro
-pago 2x na mesma cadeia), travar o loop router-maestro-router, e passar só
-o entrypoint da skill e apenas as referências necessárias (progressive disclosure), não o pacote inteiro.
+Minimum contract every orchestrator or subagent spawn uses when delegating
+work: wizz-router, wizz-maestro, wizz-party-mode (subagent/agent-team)
+and swarm-orchestrator. Goal: cut the double cerebro lookup (cerebro
+paid for twice in the same chain), lock down the router-maestro-router loop,
+and pass along only the skill's entrypoint and the references actually needed
+(progressive disclosure), not the whole package.
 
-## Campos do brief
+## Brief fields
 
-- skill de área: nome canônico da persona a invocar via `Skill` (ex.: `wizz-growth`). Não é `subagent_type`: para isolar a tarefa, escolha um executor nativo disponível (`wizz-exec-*`) e instrua-o a carregar essa skill antes de trabalhar. A ausência de um executor não impede invocar a skill na sessão atual.
-- origem: quem está delegando (ex: wizz-router, wizz-maestro). Regra
-  anti-loop: nunca invoque quem já está na cadeia de origem. Exemplo
-  proibido: router delega pro maestro, maestro devolve pro router.
-- cérebro já consultado: resumo de até 3 linhas do que o /cerebro ver já
-  trouxe (estado do projeto, decisões recentes relevantes à área). Se este
-  campo veio preenchido, quem recebe o handoff não roda /cerebro ver de
-  novo, usa o resumo recebido.
-- decisões já tomadas na cadeia: lista curta do que já foi decidido antes
-  deste handoff (ex: paleta aprovada, escopo definido).
-- seção relevante da skill: indique o assunto e as referências necessárias.
-  Quem recebe carrega primeiro o SKILL.md completo via invocação da skill;
-  depois lê apenas as referências exigidas pela tarefa. Skills carregadas
-  pelo lead não são herdadas automaticamente por um subagente.
-- model_hint (opcional): degrau da escada, não modelo cru. Valores:
-  `haiku | sonnet | opus | review`. Quem recebe despacha `wizz-exec-<hint>`
-  (nativo em Claude Code, Codex, OpenCode e Gemini CLI). Escalada: no
-  máximo 1 degrau acima se o executor devolver ambiguidade ou os testes
-  falharem 2x. `opus` é degrau real só quando a sessão que delega roda
-  acima de Opus (Fable); em sessão Opus quem recebe pula para `review`
-  (detalhe completo em `_shared/model-ladder.md`, no módulo wizz).
-  Campo opcional: sem ele o handoff funciona normal.
-- max_calls (opcional): teto de chamadas de ferramenta (tool calls) que o
-  executor pode gastar neste brief, como inteiro. Quem recebe despacha o
-  `wizz-exec-<hint>` com esse teto declarado no brief. Ao atingir o teto,
-  o executor PARA, entrega o parcial com pendências explícitas e não
-  escala sozinho: quem delega decide o próximo passo (reemitir com teto
-  maior, escalar 1 degrau, ou absorver o resto). Regra instrucional, igual
-  à anti-loop: nada programático conta as chamadas. Sem `max_calls` o
-  handoff funciona normal.
-- precisa planejar (opcional): veredito sim/não do fator de planejamento
-  do sinal de complexidade, avaliado por quem delega. Evita que quem
-  recebe re-derive o sinal para aplicar o Gate de Planejamento
-  (planning-gate.md, _shared do módulo wizz).
-- gate (opcional): estado do Gate de Planejamento na cadeia. `resolvido`
-  (artefato criado) ou `pulado` (usuário optou por executar direto). Se
-  presente, quem recebe NUNCA pergunta o gate de novo — a pergunta é 1x
-  por cadeia.
+- area skill: canonical name of the persona to invoke via `Skill` (e.g. `wizz-growth`). Not a `subagent_type`: to isolate the task, pick an available native executor (`wizz-exec-*`) and instruct it to load that skill before working. The absence of an executor doesn't block invoking the skill in the current session.
+- origin: who is delegating (e.g. wizz-router, wizz-maestro). Anti-loop
+  rule: never invoke whoever is already in the origin chain. Forbidden
+  example: router delegates to maestro, maestro hands it back to router.
+- cerebro already consulted: a summary of up to 3 lines of what `/cerebro ver` already
+  brought back (project state, recent decisions relevant to the area). If this
+  field is filled in, whoever receives the handoff does not run `/cerebro ver`
+  again, and uses the summary received instead.
+- decisions already made in the chain: a short list of what was already decided before
+  this handoff (e.g. approved palette, defined scope).
+- relevant section of the skill: state the subject and the references needed.
+  The receiver first loads the full SKILL.md by invoking the skill;
+  then reads only the references the task requires. Skills loaded
+  by the lead are not automatically inherited by a subagent.
+- model_hint (optional): a rung on the ladder, not a raw model. Values:
+  `haiku | sonnet | opus | review`. The receiver dispatches `wizz-exec-<hint>`
+  (native in Claude Code, Codex, OpenCode and Gemini CLI). Escalation: at
+  most 1 rung up if the executor returns ambiguity or tests
+  fail twice. `opus` is only a real rung when the delegating session runs
+  above Opus (Fable); in an Opus session the receiver jumps straight to `review`
+  (full detail in `_shared/model-ladder.md`, in the wizz module).
+  Optional field: the handoff works fine without it.
+- max_calls (optional): a cap on tool calls the executor can spend
+  on this brief, as an integer. The receiver dispatches
+  `wizz-exec-<hint>` with that cap declared in the brief. On hitting the cap,
+  the executor STOPS, delivers the partial work with explicit pending items, and does not
+  escalate on its own: the delegator decides the next step (reissue with a
+  higher cap, escalate one rung, or absorb the rest). An instructional rule, just
+  like the anti-loop one: nothing programmatic counts the calls. Without `max_calls` the
+  handoff works fine.
+- needs planning (optional): a yes/no verdict on the planning factor
+  of the complexity signal, assessed by the delegator. Keeps the receiver
+  from re-deriving the signal to apply the Planning Gate
+  (planning-gate.md, wizz module `_shared`).
+- gate (optional): state of the Planning Gate in the chain. `resolved`
+  (artifact created) or `skipped` (user chose to execute directly). If
+  present, the receiver NEVER asks about the gate again -- the question is asked once
+  per chain.
 
-## Exemplo de brief
+## Example brief
 
-    origem: wizz-router
-    cérebro já consultado: projeto usa Next.js + Supabase; paleta copper
-      aprovada; falta terminar o checkout.
-    decisões já tomadas na cadeia: escopo é só mobile-first.
-    seção relevante da skill: page-cro/references/checkout-flow.md
+    origin: wizz-router
+    cerebro already consulted: project uses Next.js + Supabase; copper palette
+      approved; checkout still needs finishing.
+    decisions already made in the chain: scope is mobile-first only.
+    relevant section of the skill: page-cro/references/checkout-flow.md
     model_hint: sonnet
     max_calls: 40
 
-## Regra anti-loop
+## Anti-loop rule
 
-Hoje a prevenção de loop é só instrucional (nada programático barra). Quem
-delega sempre declara `origem`; quem recebe nunca invoca de volta quem
-está na cadeia. Se precisar de mais triagem, resolve sozinho ou rebaixa
-para o agente de área, nunca devolve para quem chamou.
+Today loop prevention is instructional only (nothing programmatic blocks it). Whoever
+delegates always declares `origin`; whoever receives never calls back
+whoever is already in the chain. If more triage is needed, resolve it yourself or step down
+to the area agent, never hand it back to whoever called you.
 
-## Quem usa este protocolo
+## Who uses this protocol
 
-- wizz-router: declara ao delegar para o agente de área ou para o maestro.
-- wizz-maestro: declara ao delegar para os agentes de área.
-- wizz-party-mode (mode-subagent, mode-agent-team): inclui o resumo do
-  cerebro e as decisões da cadeia no brief de cada persona/subagente.
-- swarm-orchestrator: inclui o mesmo resumo no spawn prompt de cada
-  teammate (eles não herdam a conversa do lead).
+- wizz-router: declares it when delegating to the area agent or to the maestro.
+- wizz-maestro: declares it when delegating to the area agents.
+- wizz-party-mode (mode-subagent, mode-agent-team): includes the cerebro
+  summary and the chain's decisions in each persona's/subagent's brief.
+- swarm-orchestrator: includes the same summary in the spawn prompt of each
+  teammate (they don't inherit the lead's conversation).
 
-## Cobertura de eval
+## Eval coverage
 
-O cenário de loop router-maestro-router não ganhou caso automatizado em
-evals/routing/dataset.json: o runner (run-routing-eval.mjs) testa a
-classificação de 1 prompt do usuário (isTrivial + rota via LLM), não
-simula uma cadeia de handoff nem lê um campo origem. Um caso com esse
-campo não seria exercido por nenhum código do runner hoje. A cobertura
-real da regra anti-loop fica instrucional (seção acima) até o runner
-ganhar suporte a cenário multi-hop.
+The router-maestro-router loop scenario has no automated case yet in
+evals/routing/dataset.json: the runner (run-routing-eval.mjs) tests
+classification of 1 user prompt (isTrivial + LLM routing), it doesn't
+simulate a handoff chain or read an origin field. A case with that
+field wouldn't be exercised by any of the runner's code today. Real
+coverage of the anti-loop rule stays instructional (section above) until the runner
+gains support for a multi-hop scenario.

package/src/core-skills/wizz-review-adversarial-general/SKILL.md

@@ -7,7 +7,7 @@ description: 'Perform a Cynical Review and produce a findings report. Use when t
 
 > **Cross-reference:** this is the "Blind Hunter" review lens (diff only, no project context, no triage). It is not meant to be invoked standalone by a user. For an ad hoc adversarial pass outside a bmm workflow, use the `wizz-adversarial-reviewer` skill directly; for the full triaged multi-layer review of a real diff, run `wizz-code-review`.
 >
-> **Fonte única do prompt (2026-09-11, item 22 da auditoria):** o texto operacional do Blind Hunter mora em `src/bmm-skills/4-implementation/wizz-code-review/review-prompts/blind-hunter.md` (cópia idêntica em `wizz-quick-dev/review-prompts/`, paridade travada por `test/test-blind-hunter-parity.js`). Este SKILL.md guarda a persona e o mindset cínico que o revisor assume; os workflows não invocam esta skill — leem o review-prompts direto.
+> **Single source of the prompt (2026-09-11, item 22 of the audit):** the Blind Hunter's operational text lives in `src/bmm-skills/4-implementation/wizz-code-review/review-prompts/blind-hunter.md` (an identical copy in `wizz-quick-dev/review-prompts/`, parity locked by `test/test-blind-hunter-parity.js`). This SKILL.md holds the persona and cynical mindset the reviewer takes on; the workflows don't invoke this skill, they read the review-prompts directly.
 
 **Goal:** Cynically review content and produce findings.
 

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

@@ -1,77 +1,77 @@
-# Copy das páginas do funil
+# Copy for the funnel pages
 
-## Os 10 blocos, nesta ordem
+## The 10 blocks, in this order
 
-1. Indicador de etapa
-2. Eyebrow / contexto
+1. Step indicator
+2. Eyebrow / context
 3. Headline
-4. Corpo
-5. Ancoragem de preço
-6. Card de preço
-7. Três bullets de resultado
+4. Body
+5. Price anchor
+6. Price card
+7. Three outcome bullets
 8. CTA
-9. Recusa
-10. Barra de confiança
+9. Decline
+10. Trust bar
 
-A ordem não se mexe. Ela é o que faz a pessoa entender onde está no fluxo antes de decidir.
+The order doesn't move. It's what lets the person understand where they are in the flow before deciding.
 
-## Regras por bloco
+## Rules per block
 
-**Headline.** Curta. De preferência com **uma** palavra destacada visualmente. Promessa concreta. Headline não é parágrafo.
+**Headline.** Short. Preferably with **one** visually highlighted word. Concrete promise. A headline is not a paragraph.
 
-**Corpo.** Três a cinco parágrafos curtos, escritos para serem lidos no celular em movimento. Nada de bloco gigante.
+**Body.** Three to five short paragraphs, written to be read on a phone on the move. No giant blocks of text.
 
-**Ancoragem.** `De R$X por R$Y`, com o valor original riscado quando virar HTML. **Não inventar o preço original.** Sem ancoragem legítima, perguntar ou deixar explícito que ela precisa ser definida.
+**Anchor.** `De R$X por R$Y` (From R$X for R$Y), with the original value struck through once it becomes HTML. **Never make up the original price.** With no legitimate anchor, ask, or state explicitly that it still needs to be defined.
 
-**Bullets.** Resultado, nunca inventário.
+**Bullets.** Outcome, never inventory.
 
-| Errado | Certo |
+| Wrong | Right |
 |---|---|
 | 12 módulos | Você monta a primeira campanha sem travar na tela em branco |
 | 8 aulas | Você sabe exatamente o que fazer depois da compra |
 | PDF de 40 páginas | Você para de perder tempo procurando o próximo passo |
 
-Não prometer resultado que o produto não entrega.
+Never promise a result the product doesn't deliver.
 
-**CTA.** Um por página. Ação mais benefício: `SIM, QUERO [BENEFÍCIO]`, `QUERO ACESSAR AGORA`, `SIM, QUERO ADICIONAR ISSO`. Uma dor, um CTA: página que tenta vender duas coisas ao mesmo tempo vende zero (§7.7 de `07-funil-upsell.md`).
+**CTA.** One per page. Action plus benefit: `SIM, QUERO [BENEFÍCIO]`, `QUERO ACESSAR AGORA`, `SIM, QUERO ADICIONAR ISSO`. One pain, one CTA: a page that tries to sell two things at once sells nothing (§7.7 of `07-funil-upsell.md`).
 
-**Recusa.** O link existe sempre, discreto e não escondido: "Não, obrigado. Quero seguir sem essa oferta." Nada de manipulação agressiva do tipo "não, prefiro continuar perdendo dinheiro".
+**Decline.** The link always exists, discreet and not hidden: "Não, obrigado. Quero seguir sem essa oferta." No aggressive manipulation like "não, prefiro continuar perdendo dinheiro."
 
-## Tom por etapa
+## Tone per step
 
-| Etapa | Tom |
+| Step | Tone |
 |---|---|
-| Front | aspiracional e direto |
-| Upsell | celebratório: reconhece a compra que acabou de acontecer e apresenta a próxima oportunidade |
-| Downsell | empático: a recusa não foi um erro |
-| Oferta final | universal e simples: dá para entender a utilidade em cinco segundos |
+| Front | aspirational and direct |
+| Upsell | celebratory: acknowledges the purchase that just happened and presents the next opportunity |
+| Downsell | empathetic: declining wasn't a mistake |
+| Final offer | universal and simple: its usefulness is clear in five seconds |
 
-> Quem chega no upsell acabou de comprar: é o nível 5 (totalmente consciente) da escada de `18-copy-desejo-oferta.md` (§18.3). Fala direto (oferta, bônus, garantia, urgência), sem reconstruir o problema do zero. Modelos de abertura por tom: §7.6 de `07-funil-upsell.md`.
+> Whoever reaches the upsell just bought: they're at level 5 (fully aware) of the ladder in `18-copy-desejo-oferta.md` (§18.3). Speak directly (offer, bonus, guarantee, urgency), without rebuilding the problem from scratch. Opening templates by tone: §7.6 of `07-funil-upsell.md`.
 
-## Humanização
+## Humanization
 
-Cortar antes de entregar:
+Cut before delivering:
 
 `crucial` · `jornada` · `mindset` · `transformador` · `revolucionário` · `empoderamento` · `protagonismo` · `alavancar` · `ecossistema` · `potencializar` · `holístico` · `agregar valor` · `sinergia`
 
-E as aberturas de piloto automático: "Nos dias de hoje...", "No cenário atual...", "Em um mundo onde...", "A verdade é que...", "No fundo...", "A questão é...", "Não só..., mas também...", "Transforme sua vida agora", "A oportunidade de ouro", "O futuro é seu".
+And the autopilot openers: "Nos dias de hoje...", "No cenário atual...", "Em um mundo onde...", "A verdade é que...", "No fundo...", "A questão é...", "Não só..., mas também...", "Transforme sua vida agora", "A oportunidade de ouro", "O futuro é seu".
 
-No lugar: linguagem falada. "do jeito certo", "na prática", "pra valer", "na real". Gíria só quando combina com o público.
+Instead: spoken language. "do jeito certo", "na prática", "pra valer", "na real". Slang only when it fits the audience.
 
-**Cena no lugar de emoção abstrata.** Em vez de "você se sente inseguro", algo que a pessoa realmente vive: "você abre o computador às 9h e às 11h ainda está tentando descobrir por onde começar".
+**A scene instead of abstract emotion.** Instead of "você se sente inseguro", something the person actually lives: "você abre o computador às 9h e às 11h ainda está tentando descobrir por onde começar".
 
-**Repetição é permitida.** Não trocar `produto` por `material`, `programa`, `formação`, `solução` a cada frase só para variar. Se o produto se chama X, ele se chama X.
+**Repetition is allowed.** Don't swap `produto` for `material`, `programa`, `formação`, `solução` in every sentence just for variety. If the product is called X, it's called X.
 
-**Ritmo.** Frases curtas, misturadas com algumas um pouco maiores. Poucas orações subordinadas. Ler mentalmente em voz alta: se soar como apresentação corporativa, reescrever.
+**Rhythm.** Short sentences, mixed with a few slightly longer ones. Few subordinate clauses. Read it out loud mentally: if it sounds like a corporate presentation, rewrite it.
 
-**Sem travessão longo.** Vírgula, ponto, dois pontos ou parênteses.
+**No long em-dashes.** Comma, period, colon or parentheses.
 
-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.
+Before delivering, run the 10-filter checklist from `07a-copy-humanizacao.md` (sibling shard of `07-funil-upsell.md`, in `wizz-lowticket-metodologia`): fail 3 or more, redo it. The banned-word list above is the baseline; the expanded list and the replacement table are in the shard.
 
-## Objeções
+## Objections
 
-Antecipar as reais: "está caro", "não tenho tempo", "será que funciona pro meu caso". Responder de forma concreta, sem inventar prova, depoimento ou número.
+Anticipate the real ones: "está caro", "não tenho tempo", "será que funciona pro meu caso" (it's expensive, I don't have time, will it work for my case). Answer concretely, without inventing proof, testimonials or numbers.
 
 ## HTML
 
-Só gerar quando pedido. Quando gerar: HTML/CSS simples, mobile primeiro, carregamento abaixo de 2s, `noindex` nas páginas do funil (evita canibalizar busca e mapeamento por concorrente), CTA e preço em destaque, link de recusa discreto, os 10 blocos preservados. Nada de script estranho e nada de integração inventada. Se a integração pedida não for conhecida, pedir a documentação em vez de improvisar. (§7.8 de `07-funil-upsell.md`.)
+Only generate it when asked. When generating: simple HTML/CSS, mobile first, load time under 2s, `noindex` on funnel pages (avoids cannibalizing search and competitor mapping), CTA and price prominent, discreet decline link, the 10 blocks preserved. No weird scripts and no invented integrations. If the requested integration isn't known, ask for the documentation instead of improvising. (§7.8 of `07-funil-upsell.md`.)

package/src/modules/lowticket/skills/wizz-lowticket-funil/references/mapa-do-funil.md

@@ -1,6 +1,6 @@
-# Mapa do funil · template de saída
+# Funnel map · output template
 
-Entregue o mapa completo antes de escrever qualquer copy. Ele é o contrato: se um produto muda depois, a copy toda muda junto.
+Deliver the full map before writing any copy. It's the contract: if a product changes later, all the copy changes with it.
 
 ```
 FRONT-END
@@ -38,36 +38,36 @@ Por que praticamente todo comprador pode querer:
 3 resultados:
 ```
 
-## A escada de dor
+## The pain ladder
 
-O que muda de um degrau para o outro não é o preço, é a dor:
+What changes from one step to the next isn't the price, it's the pain:
 
-| Degrau | Tipo de dor |
+| Step | Type of pain |
 |---|---|
-| Front | a dor principal |
-| U1 | a dor complementar, que só aparece depois de resolver a principal |
-| U2 | a dor avançada de quem já está aplicando |
-| Downsell | a dor imediata e simples, resolvida rápido |
-| Oferta final | a dor universal do nicho |
+| Front | the main pain |
+| U1 | the complementary pain, which only shows up after solving the main one |
+| U2 | the advanced pain of someone already applying it |
+| Downsell | the immediate, simple pain, solved quickly |
+| Final offer | the niche's universal pain |
 
-## O fluxo
+## The flow
 
 ```
 Front → Checkout → U1
-                    ├─ aceitou  → U2
-                    └─ recusou  → Downsell
+                    ├─ accepted → U2
+                    └─ declined → Downsell
                                    ↓
-                              Oferta Final → Obrigado
+                              Final Offer → Thank you
 ```
 
-Máximo três etapas pagas depois do checkout. Todo comprador chega na oferta final. U2 e downsell nunca aparecem para a mesma pessoa.
+Maximum three paid steps after checkout. Every buyer reaches the final offer. U2 and the downsell never appear to the same person.
 
-## Checagem antes de fechar o mapa
+## Check before closing the map
 
-- [ ] Cada degrau resolve o próximo problema real, não um problema inventado para justificar a venda?
-- [ ] O downsell é produto diferente, não desconto?
-- [ ] O preço do downsell foi calculado sobre o produto recusado, não sobre o front?
-- [ ] O preço do front continuou intacto?
-- [ ] Os três resultados de cada degrau são resultados, e não conteúdo?
-- [ ] A plataforma suporta OTO de um clique? Se não, isso foi dito antes de prometer?
-- [ ] Este mapa se preenche em 5 minutos? Se não, os produtos ainda não estão claros o bastante para construir (§7.9 de `07-funil-upsell.md`).
+- [ ] Does each step solve the next real problem, not a problem invented to justify the sale?
+- [ ] Is the downsell a different product, not a discount?
+- [ ] Was the downsell price calculated on the declined product, not on the front?
+- [ ] Did the front price stay intact?
+- [ ] Are the three outcomes for each step actual outcomes, not content?
+- [ ] Does the platform support a one-click OTO? If not, was that stated before promising it?
+- [ ] Does this map take 5 minutes to fill in? If not, the products still aren't clear enough to build (§7.9 of `07-funil-upsell.md`).