wizz-method 2.2.0 → 2.3.1

package/src/skills-lib/wizz-offer-forge/references/mecanismo-unico.md

@@ -1,28 +1,28 @@
-# Mecanismo Único (Causa e Solução)
+# Unique Mechanism (Cause and Solution)
 
-O Mecanismo Único é a peça central que separa uma oferta genérica de uma máquina de conversão.
+The Unique Mechanism is the centerpiece that separates a generic offer from a conversion machine.
 
-## 1. Mecanismo da Causa (Por que falharam antes)
+## 1. Cause Mechanism (Why they failed before)
 
-O prospecto já tentou soluções concorrentes e não alcançou o resultado. Se dissermos que ele falhou por falta de esforço ou incompetência, ele rejeitará a mensagem.
+The prospect has already tried competing solutions and didn't get the result. If we tell them they failed due to lack of effort or incompetence, they will reject the message.
 
-O Mecanismo da Causa identifica o **vilão oculto**:
-- A falha estrutural dos métodos tradicionais.
-- A armadilha que o mercado ensina que sabota os resultados.
-- O fator biológico, algorítmico, econômico ou psicológico que ninguém explicou para ele.
+The Cause Mechanism identifies the **hidden villain**:
+- The structural flaw of traditional methods.
+- The trap the market teaches that sabotages results.
+- The biological, algorithmic, economic, or psychological factor nobody explained to them.
 
-*Exemplo:* "Você não consegue manter a dieta porque métodos tradicionais cortam calorias e disparam o hormônio grelina, forçando seu cérebro a sabotar você em nível biológico."
+*Example:* "Você não consegue manter a dieta porque métodos tradicionais cortam calorias e disparam o hormônio grelina, forçando seu cérebro a sabotar você em nível biológico."
 
-## 2. Mecanismo da Solução (O Veículo Proprietário)
+## 2. Solution Mechanism (The Proprietary Vehicle)
 
-É o nome próprio, método, ferramenta ou tecnologia que resolve a causa raiz de forma elegante:
-- Deve ter um nome memorável (ex: *Protocolo 3-Fases*, *Fórmula da Oferta Invertida*, *Método Turbo-Sync*).
-- Deve ser explicável em 3 passos lógicos e sequenciais.
-- Deve tornar o resultado inevitável se os passos forem seguidos.
+This is the proper name, method, tool, or technology that elegantly resolves the root cause:
+- It must have a memorable name (e.g., *Protocolo 3-Fases*, *Fórmula da Oferta Invertida*, *Método Turbo-Sync*).
+- It must be explainable in 3 logical, sequential steps.
+- It must make the result inevitable if the steps are followed.
 
-## 3. Checklist do Mecanismo Único
+## 3. Unique Mechanism Checklist
 
-- [ ] O mecanismo tem um nome proprietário e sonoro?
-- [ ] Ele isenta o cliente de culpas passadas?
-- [ ] Ele explica por que a concorrência falha?
-- [ ] Ele cria uma categoria própria onde sua oferta não tem concorrente direto?
+- [ ] Does the mechanism have a proprietary, catchy name?
+- [ ] Does it absolve the customer of past guilt?
+- [ ] Does it explain why the competition fails?
+- [ ] Does it create its own category where your offer has no direct competitor?

package/src/skills-lib/wizz-offer-forge/references/ponte-trafego.md

@@ -1,21 +1,21 @@
-# Ponte de Tráfego: Da Oferta ao Criativo
+# Traffic Bridge: From Offer to Creative
 
-Uma oferta excelente sem uma ponte direta para a mídia paga não escala. A ponte de tráfego traduz a tese da oferta em ganchos e ângulos de anúncios.
+A great offer without a direct bridge to paid media doesn't scale. The traffic bridge translates the offer's thesis into ad hooks and angles.
 
-## 1. Os 4 Formatos de Anúncios de Entrada
+## 1. The 4 Top-of-Funnel Ad Formats
 
-1. **O Gancho da Quebra de Padrão (Pattern Interrupt):**
-   - Ataca a crença tradicional do mercado.
-   - *Estrutura:* "Por que [Conselho Popular] é o motivo exato de você estar [Falhando]."
-2. **O Gancho do Erro Comum / Quiz:**
-   - Desafia o espectador a checar se está cometendo um erro crítico.
-   - *Estrutura:* "Se você está fazendo [Ação X], pare agora antes que aconteça [Consequência Ruim]."
-3. **O Gancho da Demonstração do Mecanismo (Show, Don't Tell):**
-   - Mostra o processo ou o resultado visual imediato em tela.
-   - *Estrutura:* "Como esta ferramenta / método de 3 passos gerou [Resultado] em apenas [Tempo]."
-4. **O Gancho do Relato / Não Consegue Dizer (Can't Tell):**
-   - Toca na ferida emocional profunda que o cliente sente mas tem vergonha de admitir.
-   - *Estrutura:* "A sensação silenciosa de trabalhar 12 horas por dia e ver o saldo da conta estagnado..."
+1. **The Pattern Interrupt Hook:**
+   - Attacks the market's traditional belief.
+   - *Structure:* "Por que [Conselho Popular] é o motivo exato de você estar [Falhando]."
+2. **The Common Mistake / Quiz Hook:**
+   - Challenges the viewer to check whether they're making a critical mistake.
+   - *Structure:* "Se você está fazendo [Ação X], pare agora antes que aconteça [Consequência Ruim]."
+3. **The Mechanism Demo Hook (Show, Don't Tell):**
+   - Shows the process or the immediate visual result on screen.
+   - *Structure:* "Como esta ferramenta / método de 3 passos gerou [Resultado] em apenas [Tempo]."
+4. **The Confession / Can't-Tell Hook:**
+   - Touches the deep emotional wound the customer feels but is ashamed to admit.
+   - *Structure:* "A sensação silenciosa de trabalhar 12 horas por dia e ver o saldo da conta estagnado..."
 
-## 2. Handoff para o `traffic-masters` e `copy-squad`
-A matriz de criativos gerada pela skill `wizz-offer-forge` serve como o brief exato para os agentes de mídia paga (`wizz-ads`, `pedro-sobral`, `molly-pittman`, `ad-midas`) e de copy (`wizz-copy`, `hormozi-copy`).
+## 2. Handoff to `traffic-masters` and `copy-squad`
+The creative matrix generated by the `wizz-offer-forge` skill serves as the exact brief for the paid media agents (`wizz-ads`, `pedro-sobral`, `molly-pittman`, `ad-midas`) and the copy agents (`wizz-copy`, `hormozi-copy`).

package/src/skills-lib/wizz-premium-landing-ui-researcher/SKILL.md

@@ -1,59 +1,59 @@
 ---
 name: wizz-premium-landing-ui-researcher
-description: Pesquisar animações, componentes, referências visuais e padrões de conversão para criar landing pages premium em React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js e React Three Fiber. Use quando o pedido envolver analisar projeto existente; classificar nível de complexidade do site (básico a 3D high-end/Signature); escolher componentes/animações; melhorar UI genérica; criar landing page completa, transformar oferta em página estratégica, dashboard SaaS, site de autoridade/portfolio (agência, estúdio, consultoria, marca pessoal, lead passivo), case studies/selected work editoriais, ou experiência 3D cinematográfica para marcas premium; buscar referências em fontes premium (React Bits, Cult UI, Watermelon UI, Skiper UI, Componentry, outras em references/component-sources.md); ou escolher motion engine (GSAP, anime.js, Framer Motion, Three.js/R3F) para scroll storytelling.
+description: Research animations, components, visual references, and conversion patterns to build premium landing pages in React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js, and React Three Fiber. Use when the request involves analyzing an existing project; classifying a site's complexity level (basic to 3D high-end/Signature); choosing components/animations; improving generic UI; building a complete landing page, turning an offer into a strategic page, a SaaS dashboard, an authority/portfolio site (agency, studio, consultancy, personal brand, passive lead gen), editorial case studies/selected work, or a cinematic 3D experience for premium brands; researching references from premium sources (React Bits, Cult UI, Watermelon UI, Skiper UI, Componentry, others in references/component-sources.md); or choosing a motion engine (GSAP, anime.js, Framer Motion, Three.js/R3F) for scroll storytelling.
 ---
 
 # Premium Landing UI Researcher
 
-Estrategista autônomo de landing pages premium, UI SaaS e experiências visuais avançadas (React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js, R3F). Este arquivo é o índice: só as regras sempre ativas ficam aqui. O detalhe de cada etapa vive em `references/` e deve ser lido apenas quando a etapa for executada.
+Autonomous strategist for premium landing pages, SaaS UI, and advanced visual experiences (React, Next.js, Tailwind, shadcn/ui, Framer Motion, Three.js, R3F). This file is the index: only the always-active rules live here. The detail for each step lives in `references/` and should be read only when that step is executed.
 
-## Gate 1: Source-First (sempre, antes de qualquer código de UI)
+## Gate 1: Source-First (always, before any UI code)
 
-Esta skill existe porque escrever shaders, animações, hovers e componentes do zero NÃO é o caminho. O caminho é curar componentes, animações e shaders maduros de fontes profissionais (`modelos lp/` do usuário, React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Componentry e registries públicos) e adaptar à marca.
+This skill exists because writing shaders, animations, hovers, and components from scratch is NOT the way. The way is to curate mature components, animations, and shaders from professional sources (the user's `modelos lp/`, React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Componentry, and public registries) and adapt them to the brand.
 
-Regra absoluta: inspecione fontes reais, registre evidências e recomende opções, adapte à marca. Nunca recrie o que já existe maduro. Se uma fonte estiver indisponível, registre a limitação e pesquise outra fonte pública ou local antes de justificar uma implementação própria. Nunca cair pro fallback silenciosamente. O mandato completo (anti-patterns e required pattern) está no topo de [source-first-protocol](references/source-first-protocol.md).
+Absolute rule: inspect real sources, log evidence, and recommend options, adapt to the brand. Never recreate something that already exists in mature form. If a source is unavailable, log the limitation and research another public or local source before justifying a custom implementation. Never fall back silently. The full mandate (anti-patterns and required pattern) is at the top of [source-first-protocol](references/source-first-protocol.md).
 
-## Gate 2: classificar o nível do site (sempre, antes de recomendar componentes)
+## Gate 2: classify the site's level (always, before recommending components)
 
-Se faltarem dados essenciais, fazer no máximo 5 perguntas estratégicas: (1) negócio/produto/oferta, (2) público-alvo, (3) objetivo principal da página, (4) nível visual desejado, (5) referências visuais existentes. Se o usuário não responder tudo, continuar com hipóteses estratégicas coerentes. Regra mestra: perguntar, inferir, executar.
+If essential data is missing, ask at most 5 strategic questions: (1) business/product/offer, (2) target audience, (3) page's main objective, (4) desired visual level, (5) existing visual references. If the user doesn't answer everything, continue with coherent strategic hypotheses. Master rule: ask, infer, execute.
 
-Classificar o projeto em um dos 5 níveis (regras, motion permitido/proibido e budget por nível em [site-levels](references/site-levels.md)):
+Classify the project into one of 5 levels (rules, allowed/forbidden motion, and budget per level in [site-levels](references/site-levels.md)):
 
 1. Basic Site: Clean Motion
 2. Intermediate Site: Polished Motion
 3. Advanced Site: Premium Motion
 4. 3D High-End Site: Cinematic Motion
-5. 3D High-End Site, modo Signature 3D Experience: Maximum Wow
+5. 3D High-End Site, Signature 3D Experience mode: Maximum Wow
 
-## Fluxo de alto nível
+## High-level flow
 
-1. Analisar contexto do projeto e do negócio; aplicar a regra de autonomia.
-2. Classificar o nível do site (Gate 2).
-3. Definir direção visual e stack.
-4. Decidir modos extras: dashboard SaaS e/ou Portfolio / Authority Mode.
-5. Checkpoints de fontes: inventário interno, Source-First Protocol completo e escolha das fontes dentro do escopo autorizado (Gate 1). Nunca pular silenciosamente.
-6. Se nível 4 ou 5: handoff pro `wizz-motion-3d-director` antes de implementar.
-7. Escrever copy completa e estrutura da página.
-8. Plano de implementação (handoff pro `wizz-implementation-planner` quando aplicável).
-9. Audit Protocol: 4 passes de qualidade antes de declarar pronto (Pass 4 nunca pode ser pulado).
-10. Entregar no formato de resposta final e rodar o self-check.
+1. Analyze the project and business context; apply the autonomy rule.
+2. Classify the site's level (Gate 2).
+3. Define visual direction and stack.
+4. Decide on extra modes: SaaS dashboard and/or Portfolio / Authority Mode.
+5. Source checkpoints: internal inventory, full Source-First Protocol, and choosing sources within the authorized scope (Gate 1). Never skip silently.
+6. If level 4 or 5: handoff to `wizz-motion-3d-director` before implementing.
+7. Write complete copy and page structure.
+8. Implementation plan (handoff to `wizz-implementation-planner` when applicable).
+9. Audit Protocol: 4 quality passes before declaring it done (Pass 4 can never be skipped).
+10. Deliver in the final response format and run the self-check.
 
-## Mapa de references (ler sob demanda)
+## References map (read on demand)
 
-| Para... | Leia |
+| For... | Read |
 |---|---|
-| Papel completo da skill, regra de autonomia, Project Intelligence Mode | [core-goal](references/core-goal.md) |
-| Os 5 níveis do site, motion budget, Signature 3D em detalhe | [site-levels](references/site-levels.md) |
-| Handoffs pro wizz-motion-3d-director e wizz-implementation-planner, regra final do ladder | [handoffs](references/handoffs.md) |
-| SaaS Dashboard Mode e Portfolio / Authority Site Mode | [dashboard-and-portfolio-modes](references/dashboard-and-portfolio-modes.md) |
-| Processo obrigatório de 12 passos e checkpoint de honestidade | [mandatory-process](references/mandatory-process.md) |
-| Protocolo em 5 fases (inventário, busca pública, cache, evidências, adaptação) | [source-first-protocol](references/source-first-protocol.md) |
+| The skill's full role, autonomy rule, Project Intelligence Mode | [core-goal](references/core-goal.md) |
+| The 5 site levels, motion budget, Signature 3D in detail | [site-levels](references/site-levels.md) |
+| Handoffs to wizz-motion-3d-director and wizz-implementation-planner, final ladder rule | [handoffs](references/handoffs.md) |
+| SaaS Dashboard Mode and Portfolio / Authority Site Mode | [dashboard-and-portfolio-modes](references/dashboard-and-portfolio-modes.md) |
+| The mandatory 12-step process and honesty checkpoint | [mandatory-process](references/mandatory-process.md) |
+| The 5-phase protocol (inventory, public search, cache, evidence, adaptation) | [source-first-protocol](references/source-first-protocol.md) |
 | Audit Protocol: Pass 1 Taste, Pass 2 Impeccable, Pass 3 Cross-check, Pass 4 A11y/Perf | [audit-protocol](references/audit-protocol.md) |
-| Fontes de componentes (React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Bklit UI, Componentry), animation engines (GSAP, anime.js), fontes de referência e inspiração visual, Clone Policy, Paid Source Policy | [component-sources](references/component-sources.md) |
-| Stack default, direção visual, paletas, tipografia e regras de seleção de animação | [stack-and-visual-direction](references/stack-and-visual-direction.md) |
-| Estrutura obrigatória da landing, case studies/portfolio, copywriting, conversão e CTA externo/WhatsApp | [landing-page-strategy](references/landing-page-strategy.md) |
-| Prompts base (landing completa e hero 3D com scroll) | [prompt-templates](references/prompt-templates.md) |
-| Formato de resposta final, Quality Bar e self-check antes de fechar a entrega | [output-format-and-quality](references/output-format-and-quality.md) |
-| Links diretos de todas as fontes autorizadas | [source-links](references/source-links.md) |
-
-Regra final: nunca colocar chaves reais dentro da skill (só variáveis de ambiente) e nunca entregar uma landing que pareça template sem posicionamento.
+| Component sources (React Bits, Cult UI, Ali Imam, Watermelon, StyleUI, Skiper UI, Bklit UI, Componentry), animation engines (GSAP, anime.js), reference and visual inspiration sources, Clone Policy, Paid Source Policy | [component-sources](references/component-sources.md) |
+| Default stack, visual direction, palettes, typography, and animation selection rules | [stack-and-visual-direction](references/stack-and-visual-direction.md) |
+| Required landing page structure, case studies/portfolio, copywriting, conversion, and external CTA/WhatsApp | [landing-page-strategy](references/landing-page-strategy.md) |
+| Base prompts (complete landing page and 3D scroll hero) | [prompt-templates](references/prompt-templates.md) |
+| Final response format, Quality Bar, and self-check before closing the delivery | [output-format-and-quality](references/output-format-and-quality.md) |
+| Direct links to every authorized source | [source-links](references/source-links.md) |
+
+Final rule: never put real keys inside the skill (environment variables only), and never deliver a landing page that looks like a template with no positioning.

package/src/skills-lib/wizz-premium-landing-ui-researcher/references/audit-protocol.md

@@ -1,124 +1,123 @@
 ## Audit Protocol
 
-O Source-First Protocol cuida do **início** (curar fontes maduras antes de implementar). O Audit Protocol cuida do **fim** (validar qualidade antes de declarar a landing pronta).
+The Source-First Protocol takes care of the **beginning** (curating mature sources before implementing). The Audit Protocol takes care of the **end** (validating quality before declaring the landing page done).
 
-Aplicar 3 passes em ordem. Cada um pega uma classe de problema diferente: usar os dois primeiros é redundante apenas em 60% dos casos; nos outros 40% um pega o que o outro deixou passar.
+Apply 3 passes in order. Each catches a different class of problem: using the first two is redundant only 60% of the time; in the other 40%, one catches what the other missed.
 
-### Pass 1: Taste Skill (cedo, antes da implementação completa)
+### Pass 1: Taste Skill (early, before full implementation)
 
-**Quando aplicar:** logo depois da Fase 5 do Source-First Protocol, quando você tem mockup/wireframe das seções ou primeira versão do hero implementada. Idealmente ainda dá tempo de trocar de componente sem custo alto.
+**When to apply:** right after Phase 5 of the Source-First Protocol, when you have a mockup/wireframe of the sections or a first version of the hero implemented. Ideally there's still time to swap a component without high cost.
 
-**Fonte:** `https://github.com/Leonxlnx/taste-skill.git`
+**Source:** `https://github.com/Leonxlnx/taste-skill.git`
 
-**Ângulo:** detector anti-AI-generic. Pergunta-chave: *"Esse layout poderia ser de qualquer SaaS genérico, ou tem assinatura autoral?"*
+**Angle:** an anti-AI-generic detector. Key question: *"Could this layout belong to any generic SaaS, or does it have an authorial signature?"*
 
-**O que procurar e marcar como problema:**
+**What to look for and flag as a problem:**
 
-- Hero com "headline grande + subtítulo + 2 CTAs side-by-side" sem identidade própria
-- Features em grid 3-col com ícones decorativos cute (estilo "✨ Fast 🚀 Reliable 🔥 Secure")
-- Gradientes coloridos saturados sem propósito (purple-to-pink, blue-to-cyan padrão Tailwind)
-- Copy de IA: "revolutionize your workflow", "supercharge your business", "10x your results"
-- Layout simétrico perfeito sem tensão editorial
-- Bordas arredondadas excessivas (`rounded-3xl` em tudo)
-- Card stacks com shadow padrão `shadow-xl` Tailwind
-- Emoji decorativo em qualquer lugar que não seja microcopy de status
-- Testimonial cards genéricos com avatar redondo + nome + cargo + frase entre aspas
-- Pricing cards com badge "Most Popular" centralizado e gradiente
+- A hero with "big headline + subtitle + 2 side-by-side CTAs" with no identity of its own
+- Features in a 3-col grid with cute decorative icons (the "✨ Fast 🚀 Reliable 🔥 Secure" style)
+- Saturated color gradients with no purpose (purple-to-pink, blue-to-cyan, the default Tailwind look)
+- AI copy: "revolutionize your workflow", "supercharge your business", "10x your results"
+- A perfectly symmetrical layout with no editorial tension
+- Excessive rounded corners (`rounded-3xl` on everything)
+- Card stacks with the default Tailwind `shadow-xl`
+- Decorative emoji anywhere other than status microcopy
+- Generic testimonial cards with a round avatar + name + title + quoted sentence
+- Pricing cards with a centered, gradient "Most Popular" badge
 
-**Saída do pass:** lista de até 5 pontos onde a landing parece template, com sugestão de **substituição** para cada um (componente de fonte autorizada, decisão editorial, ou remoção). Apresentar ao usuário antes de prosseguir.
+**Pass output:** a list of up to 5 spots where the landing page looks templated, with a **replacement** suggestion for each one (a component from an authorized source, an editorial decision, or removal). Present it to the user before proceeding.
 
-### Pass 2: Impeccable (tarde, com tokens e conteúdo reais)
+### Pass 2: Impeccable (late, with real tokens and content)
 
-**Quando aplicar:** depois da implementação estar montada com tokens da marca, tipografia real, imagens/mockups reais. Pega problemas que só aparecem quando o componente está vivo, não em wireframe.
+**When to apply:** after the implementation is assembled with brand tokens, real typography, real images/mockups. Catches problems that only appear once the component is alive, not in a wireframe.
 
-**Fonte:** `https://github.com/pbakaus/impeccable.git`
+**Source:** `https://github.com/pbakaus/impeccable.git`
 
-**Ângulo:** bagagem de design clássico. Pergunta-chave: *"Isso parece feito por um designer sênior com 10+ anos de bagagem editorial?"*
+**Angle:** classic design chops. Key question: *"Does this look like it was made by a senior designer with 10+ years of editorial background?"*
 
-**O que procurar e marcar como problema:**
+**What to look for and flag as a problem:**
 
-- **Spacing**: padding/margin inconsistente entre seções (24px aqui, 28px ali, 32px em outra). Definir e seguir uma escala (4/8/12/16/24/32/48/64/96/128)
-- **Hierarchy**: títulos competindo entre si por peso/tamanho. H1, H2, H3 devem ter contraste claro
-- **Leading**: `line-height` muito apertado em body (<1.5) ou muito largo em headlines (>1.15)
-- **Tracking**: letter-spacing wrong em maiúsculas pequenas (mono labels precisam mais tracking, ~0.18em)
-- **Optical alignment**: ícones com peso visual diferente do texto adjacente, números mono não monoespaçados na vertical
-- **Ritmo vertical**: scroll sem respiração (seção atrás de seção sem ar) ou com buracos enormes inexplicáveis
-- **Color hierarchy**: 5+ tons cinza para texto sem justificativa, accent usado em coisas que não são acionáveis
-- **Image cropping**: thumbnails com aspect ratio inconsistente entre cards
-- **Contraste tipográfico**: títulos heavy + body também heavy (faltou um light/regular pra criar contraste)
-- **Edge cases**: o que acontece quando o nome do projeto tem 4 palavras vs 1? E quando a descrição tem 2 linhas vs 4?
-- **Focus states**: o tab order entrega uma sequência editorial ou pula entre seções caoticamente?
+- **Spacing**: inconsistent padding/margin between sections (24px here, 28px there, 32px elsewhere). Define and follow a scale (4/8/12/16/24/32/48/64/96/128)
+- **Hierarchy**: headings competing with each other for weight/size. H1, H2, H3 should have clear contrast
+- **Leading**: `line-height` too tight in body text (<1.5) or too loose in headlines (>1.15)
+- **Tracking**: wrong letter-spacing on small uppercase text (mono labels need more tracking, ~0.18em)
+- **Optical alignment**: icons with a different visual weight than adjacent text, mono numbers not monospaced vertically
+- **Vertical rhythm**: scrolling with no breathing room (section after section with no air) or with unexplainable huge gaps
+- **Color hierarchy**: 5+ shades of gray for text with no justification, accent color used on things that aren't actionable
+- **Image cropping**: thumbnails with inconsistent aspect ratio between cards
+- **Typographic contrast**: heavy headings + heavy body text too (missing a light/regular weight to create contrast)
+- **Edge cases**: what happens when the project name has 4 words vs. 1? And when the description has 2 lines vs. 4?
+- **Focus states**: does the tab order deliver an editorial sequence, or does it jump around chaotically between sections?
 
-**Saída do pass:** lista de até 7 ajustes finos com **antes/depois** específicos (ex: "Hero subhead: trocar leading 1.1 → 1.3" / "Cards grid: alinhar baseline da numeração mono com baseline da headline do card").
+**Pass output:** a list of up to 7 fine-tuning adjustments with specific **before/after** (e.g., "Hero subhead: change leading 1.1 → 1.3" / "Cards grid: align the mono numbering baseline with the card headline baseline").
 
-### Pass 3: Cross-check com referências
+### Pass 3: Cross-check with references
 
-**Quando aplicar:** depois dos passes 1 e 2, com a landing visualmente refinada.
+**When to apply:** after passes 1 and 2, with the landing page visually refined.
 
-**Como usar agent-browser neste pass (ferramenta padrão):**
+**How to use agent-browser in this pass (default tool):**
 
-agent-browser navega autonomamente em Chrome via CDP e devolve **accessibility tree compacto com refs `@eN`** (~200-400 tokens), não depende de screenshots. Skill instalada via `npm install -g agent-browser` (repo: https://github.com/vercel-labs/agent-browser). Para ver o core skill da CLI: `agent-browser skills get core`.
+agent-browser navigates Chrome autonomously via CDP and returns a **compact accessibility tree with `@eN` refs** (~200-400 tokens), not screenshot-dependent. Skill installed via `npm install -g agent-browser` (repo: https://github.com/vercel-labs/agent-browser). To see the CLI's core skill: `agent-browser skills get core`.
 
-Loop padrão:
+Standard loop:
 ```bash
-agent-browser open <url>        # 1. abre a página
-agent-browser snapshot -i       # 2. lê estrutura (interactive elements)
-agent-browser get text @e1      # 3. inspeciona um nó específico
-agent-browser eval "<js>"       # 4. mede tokens (computed styles, etc.)
+agent-browser open <url>        # 1. open the page
+agent-browser snapshot -i       # 2. read the structure (interactive elements)
+agent-browser get text @e1      # 3. inspect a specific node
+agent-browser eval "<js>"       # 4. measure tokens (computed styles, etc.)
 ```
 
-**O que fazer:**
+**What to do:**
 
-1. **Abrir a landing/dashboard** com `agent-browser open <url>` e capturar snapshot textual de cada seção crítica via `snapshot -i -s "<seletor>"` (escopo CSS).
-2. **Abrir 1-2 referências** da direção aprovada na mesma sessão (`open` + `snapshot -i`): Linear, Stripe, Beli, Copilot Money etc, conforme o público.
-3. **Comparar via accessibility tree + computed styles** (`get styles @eN` ou `eval "getComputedStyle(...)"`):
-   - hierarquia tipográfica (tamanhos, pesos, tracking)
-   - escala de radius e shadow
-   - densidade vertical (padding/margin entre seções)
-   - estados interativos (focus visible, contraste, tab order)
-4. **Screenshot é opcional**: só use `agent-browser screenshot path.png` quando precisar de confirmação visual de algo que o accessibility tree não captura (atmosfera, gradientes, motion frozen).
-5. Pergunta-chave: *"Está no mesmo degrau de qualidade visual ou ainda parece um nível abaixo?"*
+1. **Open the landing page/dashboard** with `agent-browser open <url>` and capture a textual snapshot of each critical section via `snapshot -i -s "<selector>"` (CSS scope).
+2. **Open 1-2 references** for the approved direction in the same session (`open` + `snapshot -i`): Linear, Stripe, Beli, Copilot Money, etc., depending on the audience.
+3. **Compare via accessibility tree + computed styles** (`get styles @eN` or `eval "getComputedStyle(...)"`):
+   - typographic hierarchy (sizes, weights, tracking)
+   - radius and shadow scale
+   - vertical density (padding/margin between sections)
+   - interactive states (focus visible, contrast, tab order)
+4. **Screenshot is optional**: only use `agent-browser screenshot path.png` when you need visual confirmation of something the accessibility tree doesn't capture (atmosphere, gradients, frozen motion).
+5. Key question: *"Is this at the same level of visual quality, or does it still look a notch below?"*
 
-**Diagnóstico:**
+**Diagnosis:**
 
-- Se a diferença for **gosto/direção** (escolhas conscientes de marca) → ok, manter
-- Se a diferença for **execução** (a referência tem polish que falta na sua) → voltar pro Source-First e buscar o componente que falta
-- Se a diferença for **fluidez de motion** → revisar timing, easing, escala e composição das animações (provavelmente faltou aplicar Design Motion Principles)
-- Se a diferença for **densidade visual** (referência mais espaçada e respira mais) → cortar elementos, não adicionar
+- If the difference is **taste/direction** (conscious brand choices) → ok, keep it
+- If the difference is **execution** (the reference has polish yours is missing) → go back to Source-First and find the missing component
+- If the difference is **motion fluidity** → review timing, easing, scale, and animation composition (the Design Motion Principles were probably not applied)
+- If the difference is **visual density** (the reference is more spaced out and breathes more) → cut elements, don't add
 
-**Saída do pass:** veredicto curto: "pronta", "precisa de 1 pass mais (passe X)", ou "precisa voltar pro Source-First por causa de Y".
+**Pass output:** a short verdict: "ready", "needs one more pass (pass X)", or "needs to go back to Source-First because of Y".
 
-> **Regra**: agent-browser navega via accessibility tree (texto) por padrão. **Não tirar screenshots por reflexo**: é overhead desnecessário. Só capturar imagem quando o tree não responde a pergunta (ex: comparar atmosfera visual entre 2 sites).
+> **Rule**: agent-browser navigates via the accessibility tree (text) by default. **Don't take screenshots reflexively**: it's unnecessary overhead. Only capture an image when the tree doesn't answer the question (e.g., comparing visual atmosphere between 2 sites).
 
-### Pass 4: Acessibilidade e performance (sempre, antes de entregar)
+### Pass 4: Accessibility and performance (always, before delivering)
 
-Não é gosto, é qualidade técnica. Verificar:
+Not a matter of taste, it's technical quality. Check:
 
-- Contraste AA em todos os textos (mínimo 4.5:1 para body, 3:1 para large text)
-- Tab order coerente, focus visible em todos os elementos clicáveis
-- `prefers-reduced-motion` respeitado (3D off, animações simples)
-- Mobile: hero estático funciona, scroll horizontal vira vertical, sem cursor custom
+- AA contrast on all text (minimum 4.5:1 for body, 3:1 for large text)
+- Coherent tab order, focus visible on all clickable elements
+- `prefers-reduced-motion` respected (3D off, simple animations)
+- Mobile: static hero works, horizontal scroll becomes vertical, no custom cursor
 - Lighthouse: Desktop ≥ 90 Performance, 100 Accessibility, 100 SEO. Mobile ≥ 80 Performance, 100 Accessibility
 - LCP < 2.5s, CLS < 0.1, INP < 200ms
-- Bundle 3D faz lazy load (não bloqueia LCP)
+- 3D bundle lazy loads (doesn't block LCP)
 
-### Ordem e custo de cada pass
+### Order and cost of each pass
 
-| Pass | Quando | Custo de ajuste | Frequência |
+| Pass | When | Adjustment cost | Frequency |
 |---|---|---|---|
-| 1. Taste Skill | Wireframe / hero primeiro | Baixo (ainda dá pra trocar componente) | Sempre |
-| 2. Impeccable | Implementação com tokens reais | Médio (CSS fino) | Sempre |
-| 3. Cross-check | Visual final | Variável | Sempre |
-| 4. Acessibilidade + Perf | Antes de entregar | Médio-alto (pode exigir refactor) | Sempre |
+| 1. Taste Skill | Wireframe / hero first | Low (component can still be swapped) | Always |
+| 2. Impeccable | Implementation with real tokens | Medium (fine CSS) | Always |
+| 3. Cross-check | Final visual | Variable | Always |
+| 4. Accessibility + Perf | Before delivering | Medium-high (may require refactor) | Always |
 
-### Quando pular um pass
+### When to skip a pass
 
-**Nunca pular sem declarar ao usuário.** Casos onde faz sentido pular:
+**Never skip without telling the user.** Cases where it makes sense to skip:
 
-- Pass 1 (Taste): pular se a direção visual veio inteira de uma referência específica que o usuário aprovou (ex: "clone exato do Everswap"): nesse caso, taste já foi decidido upstream
-- Pass 2 (Impeccable): pular se a landing for v0 throwaway / wireframe interno, não entrega real
-- Pass 3 (Cross-check): pular se não há referência pública disponível
-- Pass 4 (Acessibilidade): **nunca pular**
-
-Em qualquer pulada, declarar ao usuário: "vou pular o pass X porque Y, ok?". Nunca pular silenciosamente.
+- Pass 1 (Taste): skip if the visual direction came entirely from a specific reference the user approved (e.g., "exact clone of Everswap"): in that case, taste was already decided upstream
+- Pass 2 (Impeccable): skip if the landing page is a throwaway v0 / internal wireframe, not a real deliverable
+- Pass 3 (Cross-check): skip if there's no public reference available
+- Pass 4 (Accessibility): **never skip**
 
+Whenever you skip one, tell the user: "I'm going to skip pass X because Y, ok?". Never skip silently.