wizz-method 2.2.0 → 2.3.1

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

@@ -1,99 +1,99 @@
-# Tabela de Roteamento — Modo Flat
+# Routing Table — Flat Mode
 
-Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem `_wizz/`) — aí o router dispara a skill sozinho. **Dentro de projeto Wizz** ela também pode ser consultada como ÍNDICE DE CAPACIDADES, pra descobrir uma capacidade relevante que o usuário não nomeou (ex.: "quero um carrossel" → `wizz-canvas-design`); mas a delegação continua sendo feita pelo dispatch normal do SKILL.md (agente da área / maestro) — a tabela nunca dispara a skill direto dentro de projeto Wizz.
+Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `_wizz/`) — there the router fires the skill on its own. **Inside a Wizz project** it can also be consulted as a CAPABILITY INDEX, to discover a relevant capability the user didn't name (e.g. "I want a carousel" → `wizz-canvas-design`); but delegation still happens through the normal SKILL.md dispatch (area agent / maestro) — the table never fires a skill directly inside a Wizz project.
 
-**Verificação de existência:** antes de oferecer qualquer skill, confirme que ela existe no ambiente (catálogo de skills da sessão ou `ls ~/.claude/skills`); se não existir, não ofereça: use o protocolo de skill faltante (`find-skills`).
+**Existence check:** before offering any skill, confirm it exists in the environment (the session's skill catalog or `ls ~/.claude/skills`); if it doesn't exist, don't offer it: use the missing-skill protocol (`find-skills`).
 
-## Área Técnica — Backend / Dados / Infra
+## Technical Area — Backend / Data / Infra
 
-| Intenção / palavras-chave | Skills a oferecer | Prioridade |
+| Intent / keywords | Skills to offer | Priority |
 |---|---|---|
-| Banco lento, queries, índices, N+1, sharding, connection pool | `wizz-database-scaling` + `wizz-supabase-postgres-best-practices` | 1 |
-| Cache, Redis, filas, BullMQ, SQS, Kafka, job assíncrono | `wizz-caching-and-queues` | 1 |
-| Kubernetes, auto-scaling, CDN, capacidade, SLO, load test | `wizz-infrastructure` | 1 |
-| Cloud spend, custo de infra, right-sizing, AWS/GCP billing | `wizz-cloud-and-infra` | 1 |
-| Auth, secrets, tokens, OAuth, JWT, Clerk, permissões | `wizz-auth-and-secrets` + `wizz-web-security` | 1 |
-| Dependências, packages, vulnerabilidades, npm audit | `wizz-database-and-deps` | 2 |
-| Segurança, XSS, CSRF, SQLi, IDOR, OWASP, rate limit, CORS, clickjacking, PII na resposta, enumeração de usuário, headers | `wizz-web-security` + `wizz-auth-and-secrets` | 1 |
-| Auditoria/pentest de segurança do app inteiro, "auditar segurança", "pentest", "encontrar vulnerabilidades", varredura antes de release | `security-audit-pentest` | 1 |
-| Auditoria de prontidão pra lançamento, "tá pronto pra lançar?", checklist de release amplo (técnico, segurança, SEO, analytics, conteúdo, legal, infra), "o que falta antes de ir pra produção" | `wizz-launch-readiness` | 1 |
+| Slow database, queries, indexes, N+1, sharding, connection pool | `wizz-database-scaling` + `wizz-supabase-postgres-best-practices` | 1 |
+| Cache, Redis, queues, BullMQ, SQS, Kafka, async job | `wizz-caching-and-queues` | 1 |
+| Kubernetes, auto-scaling, CDN, capacity, SLO, load test | `wizz-infrastructure` | 1 |
+| Cloud spend, infra cost, right-sizing, AWS/GCP billing | `wizz-cloud-and-infra` | 1 |
+| Auth, secrets, tokens, OAuth, JWT, Clerk, permissions | `wizz-auth-and-secrets` + `wizz-web-security` | 1 |
+| Dependencies, packages, vulnerabilities, npm audit | `wizz-database-and-deps` | 2 |
+| Security, XSS, CSRF, SQLi, IDOR, OWASP, rate limit, CORS, clickjacking, PII in the response, user enumeration, headers | `wizz-web-security` + `wizz-auth-and-secrets` | 1 |
+| Full-app security audit/pentest, "audit security", "pentest", "find vulnerabilities", pre-release scan | `security-audit-pentest` | 1 |
+| Launch-readiness audit, "is it ready to launch?", broad release checklist (technical, security, SEO, analytics, content, legal, infra), "what's missing before going to production" | `wizz-launch-readiness` | 1 |
 | Desktop, Electron, contextIsolation, code signing | `wizz-desktop-security` | 2 |
 
-## Área Técnica — Código e Qualidade
+## Technical Area — Code and Quality
 
-| Intenção / palavras-chave | Skills a oferecer | Prioridade |
+| Intent / keywords | Skills to offer | Priority |
 |---|---|---|
-| Revisar código, code review, qualidade, segunda opinião adversarial | `wizz-adversarial-reviewer` | 1 |
-| Novo feature, bug fix, TDD, testes, cobertura | execução direta com TDD (rules globais) e verificação end-to-end ao final | 1 |
-| Build quebrado, erros de TypeScript, lint, CI | execução direta (fix mínimo até build verde) | 2 |
-| Arquitetura, design de sistema, decisão técnica, plano técnico, breakdown, handoff | `wizz-implementation-planner` | 1 |
-| Fluxo crítico, E2E, verificação visual no browser | `wizz-agent-browser` | 2 |
-| SQL, schema, migrations, Supabase, RLS, performance de queries | `wizz-supabase-postgres-best-practices` + `wizz-database-scaling` | 1 |
-| Dead code, limpeza, refactoring | execução direta + `wizz-adversarial-reviewer` na revisão | 2 |
-| Novo projeto, iniciar app, ponto de partida, onboarding dev | `wizz-inicio-de-projeto` | 1 |
-| Construir/melhorar agente ou produto de IA, system prompt, tool definitions | `wizz-ai-product-design` | 1 |
-
-## Área de Design e UI
-
-| Intenção / palavras-chave | Skills a oferecer | Prioridade |
+| Code review, quality, adversarial second opinion | `wizz-adversarial-reviewer` | 1 |
+| New feature, bug fix, TDD, tests, coverage | direct execution with TDD (global rules) and end-to-end verification at the end | 1 |
+| Broken build, TypeScript errors, lint, CI | direct execution (minimal fix until the build is green) | 2 |
+| Architecture, system design, technical decision, technical plan, breakdown, handoff | `wizz-implementation-planner` | 1 |
+| Critical flow, E2E, visual browser verification | `wizz-agent-browser` | 2 |
+| SQL, schema, migrations, Supabase, RLS, query performance | `wizz-supabase-postgres-best-practices` + `wizz-database-scaling` | 1 |
+| Dead code, cleanup, refactoring | direct execution + `wizz-adversarial-reviewer` on review | 2 |
+| New project, starting an app, starting point, dev onboarding | `wizz-inicio-de-projeto` | 1 |
+| Build/improve an AI agent or product, system prompt, tool definitions | `wizz-ai-product-design` | 1 |
+
+## Design and UI Area
+
+| Intent / keywords | Skills to offer | Priority |
 |---|---|---|
-| Design, UI, visual, componente, estilo, paleta, tipografia, sistema de design | `wizz-ui-ux-pro-max` + `wizz-ui-component-curator` | 1 |
-| Landing page, hero, motion, animação 3D, conversão, CRO visual | `wizz-premium-landing-ui-researcher` | 1 |
-| Qualidade de design, anti-slop, gosto visual, estética, olhar crítico | `wizz-taste-skill` (se instalada) | 1 |
-| Regras de frontend, código UI determinístico, 44 regras, audit de frontend | `wizz-impeccable` (se instalada) | 2 |
-| Design system HTML-native, filosofia visual, review 5-dim, export MP4 | `wizz-huashu-design` (se instalada) | 2 |
-| Animação, motion, vídeo programático em código, Remotion, Three.js, 3D, WebGL | `wizz-motion-3d-director` + `wizz-remotion-best-practices` | 1 |
-| Craft de animação/micro-interação, easing, timing, reduced-motion, "essa animação travou/tá ruim" | `wizz-animate` + `wizz-design-motion-principles` | 2 |
-| Gerar imagem por código: carrossel, quote card, infográfico (PNG/PDF editável), fundo/textura generativa de hero | `wizz-canvas-design` + `wizz-algorithmic-art` | 2 |
-| **Vídeo com áudio, narração, SFX ou legenda sincronizada** (montagem do filme) | `wizz-remotion-best-practices` (Remotion monta; timing de frame). Regra do pipeline: HyperFrames desenha as telas mudas, Remotion monta o filme — não usar hyperframes para posicionar áudio/legenda (drift de ~2,76s e CSS vazando entre telas em produção) | 1 |
-| Desenhar TELA/cena de vídeo em HTML/CSS, visual mudo (maqueta de app, gráfico animado, título, loop; HTML→MP4) | CLI `hyperframes` (registry designer; `npx skills add heygen-com/hyperframes`) — só telas mudas; montagem com áudio vai pro Remotion (linha acima) | 2 |
-| Timestamps palavra a palavra de narração TTS (sincronizar legenda/corte/animação com a fala) | `ctc-align` (registry designer; fonte única de timing, substitui Whisper) | 2 |
-| **Editar/cortar vídeo** (cortes, selects, roughcut) | CLI `buttercut` (registry designer; **só Apple Silicon**, clone-and-run no projeto, deps pesadas) | 1 |
-| Gerar vídeo-ad/imagem por IA (Sora/Veo/Kling) + publicar Meta | CLI `arcads` (registry `ads`; git clone + Arcads API key) | 1 |
-| Analisar/entender vídeo existente (frames + transcrição) | CLI `claude-video` (registry designer; `npx skills add bradautomates/claude-video`) | 2 |
-| Narração / voz / TTS / clonagem de voz para vídeo | CLI `voicebox` (registry designer; app local com endpoint MCP) | 2 |
-| Pesquisar componentes compatíveis com o projeto | `wizz-ui-component-curator` (demos, código e registries públicos com evidências) | 1 |
-
-## Área de Marketing / Growth
-
-| Intenção / palavras-chave | Skills a oferecer | Prioridade |
+| Design, UI, visual, component, style, palette, typography, design system | `wizz-ui-ux-pro-max` + `wizz-ui-component-curator` | 1 |
+| Landing page, hero, motion, 3D animation, conversion, visual CRO | `wizz-premium-landing-ui-researcher` | 1 |
+| Design quality, anti-slop, visual taste, aesthetics, critical eye | `wizz-taste-skill` (if installed) | 1 |
+| Frontend rules, deterministic UI code, 44 rules, frontend audit | `wizz-impeccable` (if installed) | 2 |
+| HTML-native design system, visual philosophy, 5-dim review, MP4 export | `wizz-huashu-design` (if installed) | 2 |
+| Animation, motion, programmatic video in code, Remotion, Three.js, 3D, WebGL | `wizz-motion-3d-director` + `wizz-remotion-best-practices` | 1 |
+| Animation/micro-interaction craft, easing, timing, reduced-motion, "this animation is janky/bad" | `wizz-animate` + `wizz-design-motion-principles` | 2 |
+| Generate an image via code: carousel, quote card, infographic (editable PNG/PDF), generative hero background/texture | `wizz-canvas-design` + `wizz-algorithmic-art` | 2 |
+| **Video with audio, narration, SFX, or synced captions** (film assembly) | `wizz-remotion-best-practices` (Remotion assembles; frame timing). Pipeline rule: HyperFrames draws the mute screens, Remotion assembles the film — don't use hyperframes to position audio/captions (~2.76s drift and CSS leaking between screens in production) | 1 |
+| Draw a video SCREEN/scene in HTML/CSS, mute visual (app mockup, animated chart, title, loop; HTML→MP4) | CLI `hyperframes` (designer registry; `npx skills add heygen-com/hyperframes`) — mute screens only; assembly with audio goes to Remotion (line above) | 2 |
+| Word-by-word timestamps for TTS narration (sync captions/cuts/animation with speech) | `ctc-align` (designer registry; single source of timing, replaces Whisper) | 2 |
+| **Edit/cut video** (cuts, selects, roughcut) | CLI `buttercut` (designer registry; **Apple Silicon only**, clone-and-run in the project, heavy deps) | 1 |
+| Generate an AI video ad/image (Sora/Veo/Kling) + publish to Meta | CLI `arcads` (`ads` registry; git clone + Arcads API key) | 1 |
+| Analyze/understand an existing video (frames + transcription) | CLI `claude-video` (designer registry; `npx skills add bradautomates/claude-video`) | 2 |
+| Narration / voice / TTS / voice cloning for video | CLI `voicebox` (designer registry; local app with MCP endpoint) | 2 |
+| Research components compatible with the project | `wizz-ui-component-curator` (demos, code, and public registries with evidence) | 1 |
+
+## Marketing / Growth Area
+
+| Intent / keywords | Skills to offer | Priority |
 |---|---|---|
-| Ideias de marketing, estratégia de marketing, posicionamento | `wizz-marketing-ideas` + `wizz-marketing-psychology` + `wizz-product-marketing-context` | 1 |
-| Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `wizz-paid-ads` + `wizz-ad-creative` + `wizz-analytics-tracking` | 1 |
-| Pixel/UTM/atribuição erradas, "a venda não bate com o gerenciador", "onde está furando o funil", tráfego orgânico inflado, conferir tracking antes de subir campanha | `wizz-tracking-audit` (+ `wizz-analytics-tracking` se for SaaS/produto) | 1 |
-| Lançamento de feature, lançamento de produto, go-to-market | `wizz-launch-strategy` + `wizz-social-content` + `wizz-email-sequence` | 1 |
-| Site pronto pra subir, pré-lançamento de SITE, "revisa antes do deploy", checklist de go-live, ou item pontual pré-lançamento (og:image/prévia de link, FAQ com schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
-| Preço, planos, pricing, monetização | `wizz-pricing-strategy` + `wizz-paywall-upgrade-cro` | 1 |
-| Churn, retenção, cancelamento, NPS | `wizz-churn-prevention` + `wizz-revops` | 1 |
-| Conversão de página, CRO, otimização de funil | `wizz-page-cro` + `wizz-copywriting` + `wizz-form-cro` | 1 |
-| Signup, onboarding, ativação de usuário | `wizz-signup-flow-cro` + `wizz-onboarding-cro` | 1 |
-| SEO, Google, busca, AI search, LLM SEO | `wizz-seo-audit` + `wizz-ai-seo` + `wizz-schema-markup` + `wizz-programmatic-seo` + `wizz-site-architecture` | 1 |
-| Comparativo vs concorrente, alternatives page, war room | `wizz-competitor-alternatives` | 2 |
-| Conteúdo, social media, newsletter, threads | `wizz-content-strategy` + `wizz-social-content` + `wizz-copy-editing` | 2 |
-| Cold email, outbound B2B, prospecção | `wizz-cold-email` | 2 |
-| Referral, indicação, programa de afiliados | `wizz-referral-program` | 2 |
-| Material de vendas, pitch, deck, proposta | `wizz-sales-enablement` | 2 |
-| Ferramenta grátis de captação de leads | `wizz-free-tool-strategy` | 2 |
-| A/B test, variações, experimentos de conversão | `wizz-ab-test-setup` + `wizz-analytics-tracking` | 2 |
-| Copywriting, copy, persuasão, texto de venda | `wizz-copywriting` + `wizz-humanizer` | 1 |
-| Pesquisa de público de oferta, VoC, matriz de ângulos, léxico de infoproduto | `pesquisa-de-publico-do-piva` | 1 |
-| Forjar oferta, criar oferta irresistível, mecanismo único, bônus, garantia | `wizz-offer-forge` + `wizz-pricing-strategy` | 1 |
-| Pesquisa de mercado, inteligência competitiva | `deep-research` (plugin externo — só se instalado) | 2 |
-
-## Contexto e Memória
-
-| Intenção / palavras-chave | Skills a oferecer | Prioridade |
+| Marketing ideas, marketing strategy, positioning | `wizz-marketing-ideas` + `wizz-marketing-psychology` + `wizz-product-marketing-context` | 1 |
+| Paid ads, ads, Google Ads, Meta Ads, TikTok Ads, paid media | `wizz-paid-ads` + `wizz-ad-creative` + `wizz-analytics-tracking` | 1 |
+| Wrong pixel/UTM/attribution, "sales don't match the ads manager", "where is the funnel leaking", inflated organic traffic, checking tracking before launching a campaign | `wizz-tracking-audit` (+ `wizz-analytics-tracking` if it's a SaaS/product) | 1 |
+| Feature launch, product launch, go-to-market | `wizz-launch-strategy` + `wizz-social-content` + `wizz-email-sequence` | 1 |
+| Site ready to go live, SITE pre-launch, "review before deploy", go-live checklist, or a specific pre-launch item (og:image/link preview, FAQ with schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
+| Price, plans, pricing, monetization | `wizz-pricing-strategy` + `wizz-paywall-upgrade-cro` | 1 |
+| Churn, retention, cancellation, NPS | `wizz-churn-prevention` + `wizz-revops` | 1 |
+| Page conversion, CRO, funnel optimization | `wizz-page-cro` + `wizz-copywriting` + `wizz-form-cro` | 1 |
+| Signup, onboarding, user activation | `wizz-signup-flow-cro` + `wizz-onboarding-cro` | 1 |
+| SEO, Google, search, AI search, LLM SEO | `wizz-seo-audit` + `wizz-ai-seo` + `wizz-schema-markup` + `wizz-programmatic-seo` + `wizz-site-architecture` | 1 |
+| Competitor comparison, alternatives page, war room | `wizz-competitor-alternatives` | 2 |
+| Content, social media, newsletter, threads | `wizz-content-strategy` + `wizz-social-content` + `wizz-copy-editing` | 2 |
+| Cold email, B2B outbound, prospecting | `wizz-cold-email` | 2 |
+| Referral, referrals, affiliate program | `wizz-referral-program` | 2 |
+| Sales material, pitch, deck, proposal | `wizz-sales-enablement` | 2 |
+| Free lead-capture tool | `wizz-free-tool-strategy` | 2 |
+| A/B test, variations, conversion experiments | `wizz-ab-test-setup` + `wizz-analytics-tracking` | 2 |
+| Copywriting, copy, persuasion, sales text | `wizz-copywriting` + `wizz-humanizer` | 1 |
+| Offer audience research, VoC, angle matrix, info-product lexicon | `pesquisa-de-publico-do-piva` | 1 |
+| Forge an offer, create an irresistible offer, unique mechanism, bonus, guarantee | `wizz-offer-forge` + `wizz-pricing-strategy` | 1 |
+| Market research, competitive intelligence | `deep-research` (external plugin — only if installed) | 2 |
+
+## Context and Memory
+
+| Intent / keywords | Skills to offer | Priority |
 |---|---|---|
-| O que foi decidido, contexto passado, aprendizados, histórico | `cerebro` (/ver ou /dia) | 1 |
+| What was decided, past context, learnings, history | `cerebro` (/ver or /dia) | 1 |
 
 ---
 
-## Fallback — skill OU MCP faltante
+## Fallback — missing skill OR MCP
 
-Quando nenhuma skill/MCP instalado cobrir o pedido, **classifique o que falta** (skill = conhecimento/fluxo; MCP = acesso real a ferramenta/API):
+When no installed skill/MCP covers the request, **classify what's missing** (skill = knowledge/flow; MCP = real access to a tool/API):
 
-**Falta uma SKILL:** informe → invoque `find-skills` → `npx skills find "<termo>"` → apresente 2-3 candidatas com fonte → proponha `npx skills add <pkg>` com confirmação → roteie de novo. Fontes: anthropics/skills, superpowers-marketplace, skill-codex, claude-mem, skills.sh. **Revise o SKILL.md e qualquer `scripts/` antes de instalar; prefira owners conhecidos.**
+**Missing a SKILL:** inform → invoke `find-skills` → `npx skills find "<term>"` → present 2-3 candidates with source → propose `npx skills add <pkg>` with confirmation → route again. Sources: anthropics/skills, superpowers-marketplace, skill-codex, claude-mem, skills.sh. **Review the SKILL.md and any `scripts/` before installing; prefer known owners.**
 
-**Falta um MCP:** informe → `claude mcp list` → consulte `skills-registry.yaml` (`mcps:`/`mcp_utility:`, com `server` pronto) → proponha `claude mcp add <id> [-e VAR=$VAR] -- <command> [args]`. Secrets sempre via env/placeholder, nunca token real.
+**Missing an MCP:** inform → `claude mcp list` → check `skills-registry.yaml` (`mcps:`/`mcp_utility:`, with a ready `server`) → propose `claude mcp add <id> [-e VAR=$VAR] -- <command> [args]`. Secrets always via env/placeholder, never a real token.
 
-MCPs comuns: context7 (docs de libs), supabase (Postgres), exa (pesquisa). Browser/E2E é sempre via CLI `wizz-agent-browser`, nunca via MCP Playwright.
+Common MCPs: context7 (library docs), supabase (Postgres), exa (search). Browser/E2E is always via the `wizz-agent-browser` CLI, never via the Playwright MCP.

package/src/skills-lib/wizz-tracking-audit/SKILL.md

@@ -1,78 +1,78 @@
 ---
 name: wizz-tracking-audit
-description: Auditoria e diagnóstico de rastreamento de resposta direta em dois modos. Modo implantação valida pixel, CAPI, domínio verificado, eventos priorizados, template de UTM com ID, repasse do parâmetro nativo pelo checkout, higiene de nomenclatura e compra-teste por caminho. Modo diagnóstico lê as transições do funil contra a régua, separa problema de medição de problema de conversão e diz qual transição está furando. Use quando alguém perguntar "por que a venda não bate com o gerenciador", "onde está furando o funil", "meu pixel está certo?", "as UTMs estão corretas?", "o tráfego orgânico está inflado", "qual dado falta pra eu decidir", ou antes de subir campanha nova. NÃO use para desenhar plano de medição de SaaS/produto (use wizz-analytics-tracking), para decidir bid e orçamento (use wizz-paid-ads) nem para criar a oferta (use wizz-offer-forge).
+description: Audit and diagnosis of direct-response tracking in two modes. Implementation mode validates the pixel, CAPI, verified domain, prioritized events, ID-carrying UTM template, checkout pass-through of the native parameter, naming hygiene, and per-path test purchase. Diagnostic mode reads the funnel's transitions against the ruler, separates a measurement problem from a conversion problem, and identifies which transition is leaking. Use when someone asks "why don't sales match the ads manager", "where is the funnel leaking", "is my pixel right?", "are the UTMs correct?", "is organic traffic inflated", "what data is missing for me to decide", or before launching a new campaign. Do NOT use it to design a SaaS/product measurement plan (use wizz-analytics-tracking), to decide bid and budget (use wizz-paid-ads), or to create the offer (use wizz-offer-forge).
 ---
 
 # Tracking Audit
 
-Auditoria de rastreamento para oferta de resposta direta. Uma hora aqui evita 30 dias de campanha medida errado.
+Tracking audit for a direct-response offer. An hour here saves 30 days of a campaign measured wrong.
 
-A skill faz duas coisas e nada além: **valida o que foi instalado** e **diz onde o funil está furando**. Ela não cria oferta, não decide bid e não escreve copy.
+The skill does two things and nothing else: **validates what was installed** and **says where the funnel is leaking**. It doesn't create the offer, doesn't decide bid, and doesn't write copy.
 
-## Passo 0 — Achar a régua (obrigatório, sempre)
+## Step 0 — Find the ruler (mandatory, always)
 
-Benchmark sem origem é chute. Antes de qualquer análise, resolva de onde vêm os números, nesta ordem:
+A benchmark with no source is a guess. Before any analysis, resolve where the numbers come from, in this order:
 
-1. **Skill `wizz-lowticket-metodologia` instalada?** Se sim, ela tem precedência. Leia a entrada de diagnóstico de funil no INDEX dela e use os benchmarks de lá. Declare na resposta: "régua: metodologia low ticket".
-2. **O projeto tem histórico próprio?** Trinta dias de dados reais do mesmo público valem mais que qualquer benchmark de mercado. Use a mediana do próprio histórico como linha de base.
-3. **Nenhum dos dois?** Peça ao usuário. Não invente faixa, não use número de memória, não cite benchmark sem dizer de onde saiu.
+1. **Is the `wizz-lowticket-metodologia` skill installed?** If so, it takes precedence. Read its funnel-diagnosis entry in its INDEX and use its benchmarks. State in the response: "ruler: low-ticket methodology".
+2. **Does the project have its own history?** Thirty days of real data from the same audience are worth more than any market benchmark. Use the median of the project's own history as the baseline.
+3. **Neither of the two?** Ask the user. Don't invent a range, don't use a number from memory, don't cite a benchmark without saying where it came from.
 
-> Regra anti-invenção: todo número que aparecer no relatório tem fonte declarada, ou vira PENDÊNCIA. Um relatório com faixa inventada é pior que nenhum relatório, porque parece medido.
+> Anti-invention rule: every number that appears in the report has a declared source, or it becomes a PENDING item. A report with an invented range is worse than no report, because it looks measured.
 
-## Escolher o modo
+## Choosing the mode
 
-| O pedido é... | Modo | Referência |
+| The request is... | Mode | Reference |
 |---|---|---|
-| Vou subir campanha, está tudo instalado? | implantação | `references/modo-implantacao.md` |
-| Está rodando e o número não fecha | diagnóstico | `references/modo-diagnostico.md` |
-| A venda não bate com o gerenciador | diagnóstico, começando por atribuição | `references/utm-e-atribuicao.md` |
-| Como monto as UTMs desta conta | implantação, só a parte de tags | `references/utm-e-atribuicao.md` |
+| I'm about to launch a campaign, is everything installed? | implementation | `references/modo-implantacao.md` |
+| It's running and the numbers don't add up | diagnostic | `references/modo-diagnostico.md` |
+| Sales don't match the ads manager | diagnostic, starting with attribution | `references/utm-e-atribuicao.md` |
+| How do I set up UTMs for this account | implementation, tags section only | `references/utm-e-atribuicao.md` |
 
-Em dúvida entre os dois: se existe dado rodando, é diagnóstico. Implantação é para o que ainda não subiu.
+When in doubt between the two: if there's data already running, it's diagnostic. Implementation is for what hasn't launched yet.
 
-## Os princípios que decidem no empate
+## The principles that decide ties
 
-- **O banco próprio é a fonte de verdade.** Gerenciador e Analytics perdem venda (bloqueador, iOS, cookie recusado). O número oficial vem do banco alimentado por webhook da plataforma de pagamento. Quando as duas fontes divergem, a divergência é o achado, não um erro de leitura.
-- **O pixel mede o pixel.** Connect rate é o instante em que o `PageView` dispara, não o instante em que a pessoa vê a oferta. Subir o pixel sem consertar a página é maquiagem de métrica.
-- **Atribuir por ID, não por nome.** A UTM carrega nome e ID. Renomear campanha não pode quebrar a atribuição.
-- **Orgânico não é canal, é ausência de UTM.** O balde "organic" é destaque sem tag, direct e recompra. Taguear tudo e ver o orgânico cair é a prova da origem real.
-- **Higiene de nomenclatura é infraestrutura.** Nome de campanha sujo não se conserta depois: a plataforma continua servindo o nome antigo em cache para o que já foi entregue.
-- **Diagnóstico é do fim para o começo.** Sempre. Recuperar venda iniciada é dinheiro que já era seu; mexer em criativo com checkout furando é desperdício.
+- **Your own bank is the source of truth.** The ads manager and Analytics lose sales (blocker, iOS, cookie refusal). The official number comes from the bank fed by the payment platform's webhook. When the two sources diverge, the divergence is the finding, not a reading error.
+- **The pixel measures the pixel.** Connect rate is the moment `PageView` fires, not the moment the person sees the offer. Fixing the pixel without fixing the page is metric makeup.
+- **Attribute by ID, not by name.** The UTM carries name and ID. Renaming a campaign must not break attribution.
+- **Organic isn't a channel, it's the absence of a UTM.** The "organic" bucket is an untagged highlight, DMs, and repeat purchases. Tagging everything and watching organic drop is proof of the real source.
+- **Naming hygiene is infrastructure.** A dirty campaign name can't be fixed later: the platform keeps serving the old cached name for what's already been delivered.
+- **Diagnosis goes from the end backward.** Always. Recovering an already-started order is money that was already yours; touching the creative while checkout is leaking is wasted effort.
 
-## Entradas que a auditoria precisa
+## Inputs the audit needs
 
-Peça de uma vez, não uma por uma:
+Ask for all of them at once, not one at a time:
 
-- URL da página de vendas e da página de checkout
-- Plataforma de checkout e de pagamento
-- Print ou export do gerenciador com: cliques no link, visitas à página, checkouts iniciados, compras, valor gasto, valor atribuído
-- Acesso (ou print) do painel de atribuição, quando existir
-- O template de UTM que está colado hoje no campo de parâmetros de URL
+- URL of the sales page and of the checkout page
+- Checkout platform and payment platform
+- Screenshot or export from the ads manager with: link clicks, page visits, checkouts started, purchases, amount spent, attributed value
+- Access to (or a screenshot of) the attribution panel, when one exists
+- The UTM template currently pasted in the URL parameters field
 
-Faltou item: siga com o que dá e liste o que falta em PENDÊNCIAS. Nunca preencha buraco de dado com estimativa.
+Missing an item: proceed with what's available and list what's missing under PENDING. Never fill a data gap with an estimate.
 
-## Saída
+## Output
 
-Um relatório em markdown, sempre com estas quatro partes:
+A markdown report, always with these four parts:
 
-1. **Achados por severidade.** `CRÍTICO` (o dado está errado e a decisão em cima dele também), `ALTO` (perde venda ou perde atribuição), `MÉDIO` (higiene, vai doer depois), `BAIXO` (melhoria).
-2. **A transição que está furando**, com a taxa real calculada e a régua ao lado, sempre com a fonte da régua.
-3. **O que consertar, em ordem**, seguindo a hierarquia do modo diagnóstico. Um item por linha, com quem resolve (dev, checkout, criativo, página).
-4. **Plano de tags pronto para colar**, quando o modo for implantação ou quando a auditoria encontrar UTM errada.
+1. **Findings by severity.** `CRITICAL` (the data is wrong and so is the decision built on it), `HIGH` (loses a sale or loses attribution), `MEDIUM` (hygiene, will hurt later), `LOW` (improvement).
+2. **The transition that's leaking**, with the real rate calculated and the ruler alongside it, always with the ruler's source.
+3. **What to fix, in order**, following the diagnostic mode's hierarchy. One item per line, with who resolves it (dev, checkout, creative, page).
+4. **Ready-to-paste tagging plan**, when the mode is implementation or when the audit finds a wrong UTM.
 
-Feche com **PENDÊNCIAS**: o que não deu para verificar e o que precisa de acesso ou de dado que não veio.
+Close with **PENDING**: what couldn't be verified and what needs access or data that wasn't provided.
 
-## Ferramentas
+## Tools
 
-- Inspeção de página: CLI `wizz-agent-browser`. Nunca Playwright.
-- Nada mais é obrigatório. A auditoria funciona lendo print e página.
+- Page inspection: the `wizz-agent-browser` CLI. Never Playwright.
+- Nothing else is mandatory. The audit works by reading a screenshot and the page.
 
-## Quando delegar
+## When to delegate
 
-| Situação | Vai para |
+| Situation | Goes to |
 |---|---|
-| O furo é a página (LCP, mobile, blocos) | `wizz-page-cro` |
-| O furo é o criativo | `wizz-ad-creative` |
-| O furo é bid, orçamento ou estrutura de campanha | `wizz-paid-ads` |
-| Precisa desenhar medição de produto ou SaaS | `wizz-analytics-tracking` |
-| A oferta em si não fecha | `wizz-offer-forge` |
+| The leak is the page (LCP, mobile, blocks) | `wizz-page-cro` |
+| The leak is the creative | `wizz-ad-creative` |
+| The leak is bid, budget, or campaign structure | `wizz-paid-ads` |
+| Need to design measurement for a product or SaaS | `wizz-analytics-tracking` |
+| The offer itself doesn't work | `wizz-offer-forge` |

package/src/skills-lib/wizz-tracking-audit/references/modo-diagnostico.md

@@ -1,72 +1,72 @@
-# Modo diagnóstico
+# Diagnostic mode
 
-Está rodando e o número não fecha. Este modo descobre **qual transição está furando** e separa problema de medição de problema de conversão.
+The campaign is running and the numbers don't add up. This mode finds **which transition is leaking** and separates a measurement problem from a conversion problem.
 
-Régua: leia o Passo 0 do `SKILL.md`. Cada faixa citada no relatório declara de onde veio.
+Ruler: read Step 0 of `SKILL.md`. Every rate cited in the report declares where it came from.
 
-## As 5 transições
+## The 5 transitions
 
-Base do funil é a visita à página, igual a 100%. A taxa real de cada transição é a etapa dividida pela **anterior**, nunca pela base.
+The funnel base is the page visit, equal to 100%. The real rate of each transition is that step divided by the **previous one**, never by the base.
 
-| # | Transição | O que ela revela |
+| # | Transition | What it reveals |
 |---|---|---|
-| 1 | Cliques no anúncio → Visitas na página | Saúde técnica: velocidade, redirect, SSL, mobile, disparo do `PageView` |
-| 2 | Visitas → Checkout iniciado | Casamento entre criativo, página e oferta |
-| 3 | Checkout iniciado → Venda iniciada | Atrito de checkout: campos, meios de pagamento, frete, taxa surpresa |
-| 4 | Venda iniciada → Aprovada (PIX) | Recuperação: lembrete, prazo, instrução |
-| 5 | Venda iniciada → Aprovada (cartão) | Recusa: antifraude, parcelamento, emissor |
+| 1 | Ad clicks → Page visits | Technical health: speed, redirect, SSL, mobile, `PageView` firing |
+| 2 | Visits → Checkout started | Fit between creative, page, and offer |
+| 3 | Checkout started → Order started | Checkout friction: fields, payment methods, shipping, surprise fees |
+| 4 | Order started → Approved (PIX) | Recovery: reminder, deadline, instructions |
+| 5 | Order started → Approved (card) | Decline: antifraud, installments, issuer |
 
-Sempre diagnosticar **do fim para o começo**.
+Always diagnose **from the end backward**.
 
-## Hierarquia do que atacar primeiro
+## What to attack first, in order
 
-Se dá para mexer em uma coisa só:
+If you can only touch one thing:
 
-1. **Venda iniciada → aprovada.** O ROI mais rápido do funil. Esse dinheiro já era seu.
-2. **Checkout iniciado → venda iniciada.** Ajuste barato, ganho grande.
-3. **Visitas → checkout.** Página e criativo. Mais lento e mais caro; só depois que o checkout está resolvido.
-4. **Cliques → visitas.** Técnico. Chama dev.
+1. **Order started → approved.** The fastest ROI in the funnel. That money was already yours.
+2. **Checkout started → order started.** Cheap fix, big gain.
+3. **Visits → checkout.** Page and creative. Slower and more expensive; only after checkout is solved.
+4. **Clicks → visits.** Technical. Call a developer.
 
-Ordem de prioridade das métricas: vendas > checkout iniciado > CPC > hook rate > hold rate > CPM. Não se mexe em CPC se a página não converte. Não se mexe em CPA se o checkout está furando.
+Metric priority order: sales > checkout started > CPC > hook rate > hold rate > CPM. Don't touch CPC if the page doesn't convert. Don't touch CPA if checkout is leaking.
 
-## Medição contra conversão
+## Measurement vs. conversion
 
-Antes de dizer "a conversão caiu", prove que a **medição** está de pé. As três perguntas:
+Before saying "conversion dropped," prove that **measurement** is solid. The three questions:
 
-| Sintoma | Se for medição | Se for conversão |
+| Symptom | If it's measurement | If it's conversion |
 |---|---|---|
-| Cliques muito acima das visitas | `PageView` não dispara, ou dispara tarde | Página fora do ar, redirect quebrado |
-| Venda no banco e não no gerenciador | Falta CAPI, falta domínio verificado, iOS | Nada: a venda existe |
-| Venda no gerenciador e não no banco | Deduplicação ausente, evento duplicado | Nada: a venda não existe |
-| Orgânico subindo sozinho | Rota sem UTM | Recompra e boca a boca de verdade |
-| Atribuição some ao renomear campanha | Atribuição por nome, não por ID | Nada |
+| Clicks way above visits | `PageView` doesn't fire, or fires late | Page down, broken redirect |
+| Sale in the bank, not in the ads manager | Missing CAPI, missing verified domain, iOS | Nothing: the sale exists |
+| Sale in the ads manager, not in the bank | Missing deduplication, duplicated event | Nothing: the sale doesn't exist |
+| Organic rising on its own | Route without UTM | Real repeat purchase and word of mouth |
+| Attribution disappears when renaming a campaign | Attribution by name, not by ID | Nothing |
 
-Regra prática: se as duas fontes discordam, a discordância **é** o achado. Nunca escolha a fonte que confirma a tese.
+Practical rule: if the two sources disagree, the disagreement **is** the finding. Never pick the source that confirms your thesis.
 
-## Qual dado falta para decidir
+## What data is missing to decide
 
-Parte do trabalho é dizer o que não dá para responder ainda. Formato:
+Part of the job is saying what can't be answered yet. Format:
 
 ```
-PENDÊNCIA: não dá para separar atrito de checkout de desistência de preço.
-Falta: evento AddPaymentInfo.
-Custo de instalar: baixo.
-O que muda quando existir: a transição 3 vira duas, e o conserto deixa de ser chute.
+PENDING: can't separate checkout friction from price hesitation.
+Missing: AddPaymentInfo event.
+Cost to install: low.
+What changes once it exists: transition 3 splits into two, and the fix stops being a guess.
 ```
 
-Nunca invente o número que falta. Um "provavelmente uns 30%" contamina a decisão inteira.
+Never invent the missing number. A "probably around 30%" contaminates the whole decision.
 
-## ROI verdadeiro contra ROI falso
+## True ROI vs. false ROI
 
-- **ROI falso:** valor atribuído pelo gerenciador dividido pelo gasto do gerenciador. Conta venda que não entrou e ignora venda que entrou sem atribuição.
-- **ROI verdadeiro:** faturamento aprovado no banco próprio, menos taxa da plataforma e menos reembolso, dividido pelo gasto real do período.
+- **False ROI:** the value attributed by the ads manager divided by the ads manager's spend. Counts sales that didn't happen and ignores sales that happened without attribution.
+- **True ROI:** approved revenue in your own bank, minus platform fees and refunds, divided by real spend for the period.
 
-Sempre reporte os dois lado a lado. A diferença entre eles é o tamanho do buraco de medição.
+Always report both side by side. The gap between them is the size of the measurement hole.
 
-## Leitura de print do gerenciador
+## Reading an ads-manager screenshot
 
-Métricas que precisam aparecer no print para o diagnóstico rodar:
+Metrics that need to appear in the screenshot for the diagnosis to run:
 
-cliques no link, visualizações da página, checkouts iniciados, compras (ou resultados quando a campanha otimiza para compra), valor gasto, valor atribuído.
+link clicks, page views, checkouts started, purchases (or results when the campaign optimizes for purchase), amount spent, attributed value.
 
-Faltou alguma: diga qual e o que ela impede de calcular. Não estime.
+If any is missing: say which one and what it prevents you from calculating. Don't estimate.