wizz-method 2.2.0 → 2.3.0

package/src/skills-lib/site-launch-kit/references/01-cta-principal.md

@@ -1,31 +1,31 @@
-# Rodada 01 · CTA principal acima da dobra
+# Round 01 · Primary CTA above the fold
 
-**Garante:** cada página pública pede UMA ação, visível sem rolar.
-**Rode quando:** antes de publicar ou revisar qualquer página pública do site.
+**Ensures:** every public page asks for ONE action, visible without scrolling.
+**Run when:** before publishing or reviewing any public page of the site.
 
-Você é um especialista em conversão trabalhando no repositório de um site que está prestes a ir ao ar. Sua única tarefa nesta rodada: fazer com que cada página pública peça UMA ação, e que essa ação esteja visível sem rolar.
+You are a conversion specialist working in the repository of a site about to go live. Your only task in this round: make every public page ask for ONE action, and make that action visible without scrolling.
 
-Antes de editar, detecte o terreno lendo o repositório, não pergunte: framework e roteamento (Next.js App Router ou Pages, React + Vite, Astro, HTML estático), onde moram as páginas públicas e qual é o componente de topo.
+Before editing, scan the terrain by reading the repository, don't ask: framework and routing (Next.js App Router or Pages, React + Vite, Astro, static HTML), where the public pages live, and which component is the top-of-page one.
 
-NÃO redesenhe o layout. NÃO troque paleta, tipografia ou o conteúdo das seções. NÃO invente oferta, preço, prazo ou telefone.
+DO NOT redesign the layout. DO NOT change the palette, typography, or the section content. DO NOT invent an offer, price, deadline, or phone number.
 
-1. LEVANTE
-   Liste toda página pública (home, serviços, sobre, contato, landing). Para cada uma responda: qual é a ação principal, em que altura ela aparece pela primeira vez, e se está clicável sem rolagem em 390x670, 768x1024 e 1440x800. Vale como "abaixo da dobra" o CTA que exigir rolagem em QUALQUER um dos três tamanhos.
+1. SURVEY
+   List every public page (home, services, about, contact, landing). For each one, answer: what's the primary action, at what height it first appears, and whether it's clickable without scrolling at 390x670, 768x1024 and 1440x800. A CTA counts as "below the fold" if it requires scrolling at ANY of the three sizes.
 
-2. CORRIJA, nesta ordem
-   a) Uma ação principal por página. Havendo duas com o mesmo peso visual, rebaixe a secundária para link de texto.
-   b) O CTA principal entra dentro dos primeiros 100vh: no herói, junto do título, sem depender de imagem carregar para aparecer.
-   c) O rótulo diz o que acontece depois do clique, na voz do visitante ("Pedir orçamento", "Falar no WhatsApp", "Ver preços"), nunca "Saiba mais", "Clique aqui" ou "Enviar".
-   d) Abaixo do botão, uma linha curta de redução de atrito usando informação QUE JÁ EXISTE no site (prazo de resposta, "sem compromisso", garantia). Não existindo, deixe a linha de fora e registre em PENDÊNCIAS.
-   e) O botão precisa ser alcançável por teclado, ter foco visível e área de toque de no mínimo 44x44 px no mobile.
+2. FIX, in this order
+   a) One primary action per page. If two have equal visual weight, demote the secondary one to a text link.
+   b) The primary CTA sits within the first 100vh: in the hero, next to the title, without depending on an image loading to appear.
+   c) The label says what happens after the click, in the visitor's voice ("Pedir orçamento", "Falar no WhatsApp", "Ver preços"), never "Saiba mais", "Clique aqui" or "Enviar".
+   d) Below the button, a short friction-reduction line using information that ALREADY EXISTS on the site (response time, "no commitment", guarantee). If it doesn't exist, leave the line out and log it under PENDING ITEMS.
+   e) The button needs to be keyboard-reachable, have visible focus, and a touch target of at least 44x44 px on mobile.
 
-3. CONFIRA
-   Rode o build. Compare antes e depois em 390 e 1440 de largura: nenhuma página pode ter regressão de layout.
+3. VERIFY
+   Run the build. Compare before and after at 390 and 1440 width: no page may have a layout regression.
 
-Formato de saída: depois de aplicar as mudanças, responda com uma tabela markdown, sem texto antes:
+Output format: after applying the changes, answer with a markdown table, no text before it:
 
-| Página | Ação principal | Onde estava | Onde está | Rótulo novo |
+| Page | Primary action | Where it was | Where it is now | New label |
 
-Em seguida, a seção PENDÊNCIAS, uma linha por item, no formato "o que falta · onde entra · como obter". Sem pendências, escreva NENHUMA PENDÊNCIA.
+Then, the PENDING ITEMS section, one line per item, in the format "what's missing · where it goes · how to get it". If there are no pending items, write NO PENDING ITEMS.
 
-REGRA DE CORTE: nenhum texto inventado entra no site. É melhor a linha de atrito ficar faltando e aparecer em PENDÊNCIAS do que o site subir prometendo um prazo que ninguém combinou com o cliente.
+CUTOFF RULE: no invented text goes on the site. It's better for the friction-reduction line to be missing and show up in PENDING ITEMS than for the site to go live promising a deadline nobody agreed to with the client.

package/src/skills-lib/site-launch-kit/references/02-barra-fixa-mobile.md

@@ -1,35 +1,35 @@
-# Rodada 02 · Barra de ação fixa no mobile
+# Round 02 · Fixed action bar on mobile
 
-**Garante:** barra fixa no rodapé do celular ligada à ação principal de cada página.
-**Rode quando:** depois da Rodada 01, ao preparar a experiência mobile para lançamento.
+**Ensures:** a fixed bar at the bottom of the phone screen linked to each page's primary action.
+**Run when:** after Round 01, while preparing the mobile experience for launch.
 
-Você é um desenvolvedor front-end focado em mobile. Sua única tarefa nesta rodada: criar uma barra de ação fixa no rodapé do celular, ligada à ação principal de cada página pública.
+You are a front-end developer focused on mobile. Your only task in this round: create a fixed action bar at the bottom of the phone screen, linked to each public page's primary action.
 
-Antes de editar, leia o repositório e descubra: framework e roteamento, qual é o CTA principal de cada página, se já existe algum elemento fixo (cookie banner, chat, botão de WhatsApp) e onde ficam os estilos globais.
+Before editing, read the repository and find out: framework and routing, what each page's primary CTA is, whether some fixed element already exists (cookie banner, chat, WhatsApp button), and where the global styles live.
 
-NÃO crie um segundo botão flutuante se já houver um widget de chat ou de WhatsApp fixo, nesse caso, integre os dois em uma barra só e diga o que fez. NÃO mostre a barra no desktop. NÃO invente número, link ou oferta.
+DO NOT create a second floating button if a fixed chat or WhatsApp widget already exists — in that case, merge the two into a single bar and say what you did. DO NOT show the bar on desktop. DO NOT invent a phone number, link, or offer.
 
-1. COMPONENTE
-   Uma barra fixa no rodapé, visível só abaixo de 768px, com:
-   - o rótulo da ação principal daquela página (o mesmo texto do CTA do herói, sem inventar variação);
-   - no máximo dois botões: o principal cheio e, se fizer sentido, um secundário discreto (ligar, WhatsApp, ver preços);
-   - altura enxuta, área de toque mínima de 44x44 px;
-   - padding-bottom com env(safe-area-inset-bottom), senão o iPhone come o botão com a barra de gestos;
-   - z-index abaixo de modal e de menu aberto, nunca por cima deles.
+1. COMPONENT
+   A fixed bar at the bottom, visible only below 768px, with:
+   - the label of that page's primary action (the same text as the hero CTA, no invented variation);
+   - at most two buttons: the primary one filled and, if it makes sense, a discreet secondary one (call, WhatsApp, see prices);
+   - a lean height, minimum touch target of 44x44 px;
+   - padding-bottom with env(safe-area-inset-bottom), otherwise the iPhone's gesture bar eats the button;
+   - z-index below any open modal or menu, never above them.
 
-2. REGRA DE EXIBIÇÃO
-   - Aparece depois que o herói sai da tela (IntersectionObserver no herói, não listener de scroll com número mágico).
-   - Some enquanto o formulário de contato ou o CTA final estiverem visíveis: dois botões idênticos na mesma tela viram ruído.
-   - Nunca cobre o rodapé, links legais ou o último campo do formulário. Se cobrir, some ou empurre o conteúdo com padding equivalente.
-   - Respeita prefers-reduced-motion: sem animação de entrada, só opacidade.
+2. DISPLAY RULE
+   - Appears after the hero scrolls off screen (IntersectionObserver on the hero, not a scroll listener with a magic number).
+   - Disappears while the contact form or final CTA are visible: two identical buttons on the same screen become noise.
+   - Never covers the footer, legal links, or the last form field. If it does, hide it or push the content with matching padding.
+   - Respects prefers-reduced-motion: no entrance animation, opacity only.
 
-3. RASTREIO
-   Se o site já tiver analytics instalado, dispare o mesmo evento do CTA principal, com um identificador que diferencie a origem (por exemplo, um parâmetro "sticky_mobile"). Se não tiver, não instale nada aqui e registre em PENDÊNCIAS.
+3. TRACKING
+   If the site already has analytics installed, fire the same event as the primary CTA, with an identifier that distinguishes the origin (e.g. a "sticky_mobile" parameter). If it doesn't have analytics, don't install anything here and log it under PENDING ITEMS.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Página | Ação da barra | Quando aparece | Quando some | Conflito resolvido |
+| Page | Bar action | When it appears | When it disappears | Conflict resolved |
 
-Em seguida, PENDÊNCIAS, uma linha por item no formato "o que falta · onde entra · como obter". Sem pendências, escreva NENHUMA PENDÊNCIA.
+Then, PENDING ITEMS, one line per item in the format "what's missing · where it goes · how to get it". If there are no pending items, write NO PENDING ITEMS.
 
-REGRA DE CORTE: se em alguma página a barra atrapalharia mais do que ajuda (checkout, área logada, política de privacidade), não coloque, e explique em uma linha por que ficou de fora.
+CUTOFF RULE: if on some page the bar would get in the way more than it helps (checkout, logged-in area, privacy policy), don't add it, and explain in one line why it was left out.

package/src/skills-lib/site-launch-kit/references/03-tempo-de-resposta.md

@@ -1,33 +1,33 @@
-# Rodada 03 · Promessa de tempo de resposta
+# Round 03 · Response-time promise
 
-**Garante:** todo ponto de contato diz quanto tempo o visitante vai esperar.
-**Rode quando:** antes de publicar, após revisar CTAs e barra mobile.
+**Ensures:** every point of contact states how long the visitor will wait.
+**Run when:** before publishing, after reviewing CTAs and the mobile bar.
 
-Você é um redator de conversão com acesso ao repositório deste site. Sua única tarefa nesta rodada: tornar explícito, em cada ponto de contato, quanto tempo o visitante vai esperar por uma resposta.
+You are a conversion copywriter with access to this site's repository. Your only task in this round: make explicit, at every point of contact, how long the visitor will wait for a response.
 
-Antes de escrever, leia o repositório: todo formulário, telefone, e-mail, link de WhatsApp e rodapé; e todo texto que já fale de prazo, horário de atendimento ou tempo de resposta.
+Before writing, read the repository: every form, phone number, email, WhatsApp link and footer; and every piece of text that already mentions a deadline, business hours, or response time.
 
-NÃO invente o prazo. NÃO escolha o número sozinho. Você levanta, aponta divergência e propõe, a decisão é de quem vai cumprir.
+DO NOT invent the deadline. DO NOT pick the number on your own. You survey, point out divergences, and propose — the decision belongs to whoever has to honor it.
 
-1. INVENTÁRIO
-   Liste todo ponto de contato do site e o que cada um promete hoje (inclusive "entraremos em contato em breve", que não promete nada). Marque as divergências: prazos diferentes para o mesmo canal em páginas diferentes é o achado mais comum e o mais caro.
+1. INVENTORY
+   List every point of contact on the site and what each one promises today (including "we'll get back to you soon", which promises nothing). Flag the divergences: different deadlines for the same channel across different pages is the most common finding, and the costliest.
 
-2. PROPOSTA
-   Proponha UMA promessa por canal, no formato "respondemos em até X [horas úteis / dia útil]", junto do horário de atendimento e do que acontece fora dele. Baseie a proposta no que o site já diz. Se o site não disser nada em lugar nenhum, deixe o valor como placeholder explícito ({{PRAZO_RESPOSTA}}) e liste em PENDÊNCIAS, nunca escolha um número plausível por conta própria.
+2. PROPOSAL
+   Propose ONE promise per channel, in the format "we respond within X [business hours / business day]", along with the business hours and what happens outside them. Base the proposal on what the site already says. If the site says nothing anywhere, leave the value as an explicit placeholder ({{PRAZO_RESPOSTA}}) and list it under PENDING ITEMS — never pick a plausible number on your own.
 
-3. IMPLEMENTAÇÃO
-   - Um componente ou parcial único, com o texto vindo de UM lugar só (constante, config ou CMS). Repetir a frase em oito arquivos garante que daqui a três meses eles não digam mais a mesma coisa.
-   - Aplique embaixo do botão de envio de cada formulário, ao lado do telefone e do WhatsApp, e no rodapé.
-   - Incluir o horário de atendimento e o comportamento fora dele ("fora desse horário, respondemos na manhã seguinte").
-   - Se o site tiver mensagem de sucesso ou página de obrigado, repita a mesma promessa lá, com o mesmo texto vindo da mesma fonte.
+3. IMPLEMENTATION
+   - A single component or partial, with the text coming from ONE place only (constant, config, or CMS). Repeating the phrase across eight files guarantees that in three months they won't say the same thing anymore.
+   - Apply it below the submit button of every form, next to the phone number and WhatsApp, and in the footer.
+   - Include the business hours and the behavior outside them ("outside these hours, we respond the next morning").
+   - If the site has a success message or thank-you page, repeat the same promise there, with the same text coming from the same source.
 
-4. CONFIRA
-   Faça uma busca no repositório por qualquer prazo remanescente escrito à mão. Nenhum pode sobreviver fora da fonte única.
+4. VERIFY
+   Search the repository for any remaining hand-written deadline. None may survive outside the single source.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Ponto de contato | Arquivo | O que prometia | O que promete agora |
+| Point of contact | File | What it used to promise | What it promises now |
 
-Em seguida, PENDÊNCIAS, uma linha por item no formato "o que falta · onde entra · como obter". Sem pendências, escreva NENHUMA PENDÊNCIA.
+Then, PENDING ITEMS, one line per item in the format "what's missing · where it goes · how to get it". If there are no pending items, write NO PENDING ITEMS.
 
-REGRA DE CORTE: promessa que a empresa não consegue cumprir é pior do que promessa nenhuma, ela produz a primeira reclamação antes da primeira venda. Na dúvida entre dois prazos, proponha o mais folgado e explique.
+CUTOFF RULE: a promise the company can't keep is worse than no promise at all — it produces the first complaint before the first sale. When in doubt between two deadlines, propose the more generous one and explain why.

package/src/skills-lib/site-launch-kit/references/04-prova-social.md

@@ -1,33 +1,33 @@
-# Rodada 04 · Prova social real
+# Round 04 · Real social proof
 
-**Garante:** só avaliação com origem verificável fica no ar.
-**Rode quando:** antes de publicar, depois de fechar CTAs, barra mobile e promessas de prazo.
+**Ensures:** only reviews with a verifiable origin stay live.
+**Run when:** before publishing, after CTAs, mobile bar and response-time promises are closed.
 
-Você é o responsável pela prova social deste site, com acesso ao repositório. Sua única tarefa nesta rodada: deixar no ar apenas avaliação que existe de verdade.
+You are the person responsible for this site's social proof, with access to the repository. Your only task in this round: leave online only reviews that genuinely exist.
 
-REGRA ZERO: você NÃO escreve depoimento, NÃO cria nome de cliente, NÃO inventa nota e NÃO gera foto de pessoa. Avaliação fabricada é propaganda enganosa, e no Brasil ela também é problema de Código de Defesa do Consumidor. Tudo que entrar aqui tem origem verificável.
+RULE ZERO: you will NOT write a testimonial, NOT create a customer name, NOT invent a rating, and NOT generate a photo of a person. A fabricated review is deceptive advertising, and in Brazil it's also a Consumer Protection Code issue. Everything that goes in here has a verifiable origin.
 
-1. AUDITE O QUE JÁ ESTÁ NO AR
-   Procure no repositório todo depoimento, avaliação, estrela e contador de nota. Para cada um responda: veio de uma pessoa real? Tem nome completo ou primeiro nome com sobrenome abreviado, data e origem? Marque para REMOÇÃO tudo que for texto de template, avatar de banco de imagens, "Cliente Satisfeito", "Maria S." sem procedência, e nota agregada sem base ("4,9 de 5" sem dizer de quantas avaliações).
+1. AUDIT WHAT'S ALREADY LIVE
+   Search the repository for every testimonial, review, star rating and rating counter. For each one, answer: did it come from a real person? Does it have a full name, or a first name with an abbreviated last name, a date, and an origin? Mark for REMOVAL anything that's template text, a stock-photo avatar, "Cliente Satisfeito", "Maria S." with no provenance, and an aggregate rating with no basis ("4.9 out of 5" with no count of how many reviews).
 
-2. PEÇA O MATERIAL REAL
-   Pergunte e espere a resposta:
-   - Existe perfil no Google Business, Instagram, Facebook ou marketplace com avaliação pública? Passe o link.
-   - Tem elogio em WhatsApp ou e-mail que possa ser citado? Print serve.
-   - Tem autorização para publicar nome e foto de cada pessoa?
+2. REQUEST THE REAL MATERIAL
+   Ask and wait for the answer:
+   - Is there a Google Business, Instagram, Facebook, or marketplace profile with public reviews? Provide the link.
+   - Is there praise in WhatsApp or email that could be quoted? A screenshot works.
+   - Is there authorization to publish each person's name and photo?
 
-3. PUBLIQUE COM PROCEDÊNCIA
-   Cada avaliação vai ao ar com: texto na íntegra (sem edição que mude o sentido; corte de trecho marcado com reticências), nome como a pessoa autorizou, data, e a origem visível ("via Google", "via WhatsApp, publicado com autorização"). Sem foto real, use inicial ou monograma, nunca uma foto de banco de imagens ou gerada. Se houver perfil público com avaliações, prefira sempre um link para o perfil, ao lado das citações: verificável vale mais que bonito.
+3. PUBLISH WITH PROVENANCE
+   Every review goes live with: the full text (no edits that change the meaning; a trimmed excerpt marked with an ellipsis), the name as the person authorized, the date, and the visible source ("via Google", "via WhatsApp, published with authorization"). With no real photo, use an initial or monogram, never a stock or generated photo. If there's a public profile with reviews, always prefer a link to the profile alongside the quotes: verifiable beats pretty.
 
-4. QUANDO NÃO HOUVER NENHUMA
-   Não preencha. Implemente o componente, deixe a seção fora da página com um TODO, e entregue junto:
-   - o link direto de avaliação do Google Business (se houver perfil);
-   - uma mensagem curta e educada, pronta para o dono mandar aos últimos cinco clientes pedindo avaliação.
+4. WHEN THERE ARE NONE
+   Don't fill it in. Implement the component, leave the section out of the page with a TODO, and deliver along with it:
+   - the direct Google Business review link (if there's a profile);
+   - a short, polite message, ready for the owner to send to their last five customers asking for a review.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Avaliação | Origem | Data | Autorizada? | Ação (publicada/removida) |
+| Review | Origin | Date | Authorized? | Action (published/removed) |
 
-Em seguida, PENDÊNCIAS, uma linha por item no formato "o que falta · de quem obter · o que ele destrava".
+Then, PENDING ITEMS, one line per item in the format "what's missing · who to get it from · what it unlocks".
 
-REGRA DE CORTE: três avaliações reais e datadas ganham de doze perfeitas. Se o resultado da auditoria for "nenhuma avaliação sobreviveu", entregue a seção vazia e diga isso com todas as letras.
+CUTOFF RULE: three real, dated reviews beat twelve perfect ones. If the audit result is "no review survived", deliver the section empty and say so plainly.

package/src/skills-lib/site-launch-kit/references/05-faq-decisao.md

@@ -1,39 +1,39 @@
-# Rodada 05 · FAQ de decisão com dados estruturados
+# Round 05 · Decision FAQ with structured data
 
-**Garante:** cinco perguntas que resolvem dúvida de decisão, marcadas com FAQPage.
-**Rode quando:** por último, depois de CTAs, barra mobile, prazos de resposta e prova social estarem fechados.
+**Ensures:** five questions that resolve decision doubts, marked up with FAQPage.
+**Run when:** last, after CTAs, mobile bar, response-time promises and social proof are closed.
 
-Você é responsável pelas objeções deste site, com acesso ao repositório. Sua única tarefa nesta rodada: publicar cinco perguntas frequentes que resolvam dúvida de decisão, e marcá-las com dados estruturados.
+You are responsible for this site's objections, with access to the repository. Your only task in this round: publish five frequently asked questions that resolve decision doubts, and mark them up with structured data.
 
-Antes de escrever, leia o site inteiro e liste o que ele JÁ responde. Sua matéria-prima é essa; o que não estiver lá, você pergunta.
+Before writing, read the whole site and list what it ALREADY answers. That's your raw material; what's not there, you ask about.
 
-NÃO invente preço, prazo, política de reembolso, área de cobertura ou condição comercial. Esses são exatamente os campos que o visitante vai cobrar depois.
+DO NOT invent a price, deadline, refund policy, coverage area, or commercial condition. These are exactly the fields the visitor will hold you to later.
 
-1. ESCOLHA AS CINCO
-   Priorize, nesta ordem, a pergunta que trava a decisão:
-   - quanto custa (ou como o preço é formado, se não houver tabela);
-   - quanto tempo demora;
-   - como funciona, passo a passo, do primeiro contato à entrega;
-   - para quem NÃO serve, ou o que não está incluso;
-   - o que acontece se der errado (garantia, suporte, revisão).
-   Adapte ao negócio, mas mantenha o critério: pergunta desconfortável entra, pergunta institucional ("quem somos?", "qual nossa missão?") fica de fora. Se o repositório tiver histórico de atendimento, chat ou e-mails, use a frequência real das perguntas em vez do seu palpite.
+1. PICK THE FIVE
+   Prioritize, in this order, the question that blocks the decision:
+   - how much it costs (or how the price is determined, if there's no price table);
+   - how long it takes;
+   - how it works, step by step, from first contact to delivery;
+   - who it's NOT for, or what's not included;
+   - what happens if something goes wrong (warranty, support, revision).
+   Adapt to the business, but keep the criterion: an uncomfortable question gets in, an institutional one ("who are we?", "what's our mission?") stays out. If the repository has support history, chat logs, or emails, use the real frequency of questions instead of your guess.
 
-2. ESCREVA AS RESPOSTAS
-   - Comece pela resposta, não pelo contexto. Primeira linha resolve.
-   - Duas a quatro frases. Resposta longa é resposta que ninguém lê.
-   - Sem "depende": diga de que depende e dê a faixa.
-   - Sem eufemismo: se o serviço não atende certa região ou porte, diga.
-   - Cada resposta que dependa de informação que você não tem vira placeholder explícito ({{PRAZO}}, {{FAIXA_DE_PRECO}}) e entra em PENDÊNCIAS. Nunca preencha por estimativa.
+2. WRITE THE ANSWERS
+   - Start with the answer, not the context. The first line resolves it.
+   - Two to four sentences. A long answer is an answer nobody reads.
+   - No "it depends": say what it depends on and give the range.
+   - No euphemisms: if the service doesn't cover a certain region or business size, say so.
+   - Every answer that depends on information you don't have becomes an explicit placeholder ({{PRAZO}}, {{FAIXA_DE_PRECO}}) and goes under PENDING ITEMS. Never fill it in with an estimate.
 
-3. IMPLEMENTE
-   - Acordeão acessível: <details>/<summary> ou botão com aria-expanded e aria-controls; navegável por teclado; a resposta precisa estar no HTML mesmo fechada, senão o Google não lê.
-   - JSON-LD de FAQPage com exatamente as mesmas perguntas e respostas que estão na tela. Divergir entre marcação e conteúdo visível é violação de diretriz e derruba o rich result.
-   - Ao final da seção, o CTA principal do site: quem chegou até aqui está decidindo.
+3. IMPLEMENT
+   - Accessible accordion: <details>/<summary> or a button with aria-expanded and aria-controls; keyboard-navigable; the answer needs to be in the HTML even when collapsed, otherwise Google won't read it.
+   - FAQPage JSON-LD with exactly the same questions and answers shown on screen. A mismatch between markup and visible content is a guideline violation and drops the rich result.
+   - At the end of the section, the site's primary CTA: whoever got this far is deciding.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| # | Pergunta | Fonte da resposta | Objeção que derruba |
+| # | Question | Answer source | Objection it overcomes |
 
-Em seguida, PENDÊNCIAS, uma linha por item no formato "o que falta · de quem obter · o que ele destrava". Liste também as perguntas que você considerou e descartou, com o motivo em três palavras.
+Then, PENDING ITEMS, one line per item in the format "what's missing · who to get it from · what it unlocks". Also list the questions you considered and discarded, with the reason in three words.
 
-REGRA DE CORTE: cinco perguntas que doem valem mais que doze que enfeitam. Se só houver material honesto para três, publique três.
+CUTOFF RULE: five questions that sting are worth more than twelve that decorate. If there's only honest material for three, publish three.

package/src/skills-lib/site-launch-kit/references/06-imagens-reais.md

@@ -1,38 +1,38 @@
-# Rodada 06 · Imagens reais, não stock
+# Round 06 · Real images, not stock
 
-**Garante:** nenhuma imagem fingindo ser gente da casa, com o lugar preparado para a foto real.
-**Rode quando:** o site tiver seção de equipe, escritório ou depoimento com foto.
+**Ensures:** no image pretending to be actual staff, with the spot prepared for the real photo.
+**Run when:** the site has a team, office, or testimonial-with-photo section.
 
-Você é o diretor de arte deste site, com acesso ao repositório. Sua única tarefa nesta rodada: tirar do ar toda imagem que finge ser gente da casa, e preparar o lugar da foto real.
+You are this site's art director, with access to the repository. Your only task in this round: take down every image pretending to be actual staff, and prepare the spot for the real photo.
 
-NÃO gere imagem de pessoa. NÃO substitua uma foto de banco de imagens por outra foto de banco de imagens. NÃO invente nome, cargo ou biografia.
+DO NOT generate an image of a person. DO NOT replace one stock photo with another stock photo. DO NOT invent a name, title, or bio.
 
-1. INVENTÁRIO
-   Percorra todas as imagens do projeto (pasta de assets, componentes, CMS, URLs externas) e classifique cada uma:
-   - REAL: é do negócio, do time, do produto ou do trabalho entregue;
-   - GENÉRICA: banco de imagens, ilustração de template, foto de modelo, escritório que não é o escritório;
-   - INDEFINIDA: não dá para saber sem perguntar.
-   Sinais de genérica: nome de arquivo com id numérico de banco de imagens, aperto de mão corporativo, operador de headset, sala de reunião com pessoas rindo de gráfico, foto perfeita em contexto de negócio pequeno.
+1. INVENTORY
+   Go through every image in the project (assets folder, components, CMS, external URLs) and classify each one:
+   - REAL: it's of the business, the team, the product, or the delivered work;
+   - GENERIC: stock photo, template illustration, model photo, an office that isn't the actual office;
+   - UNDETERMINED: can't tell without asking.
+   Signs of generic: filename with a stock-photo numeric id, corporate handshake, headset operator, meeting room with people laughing at a chart, a photo too perfect for a small-business context.
 
-2. DECIDA POR IMAGEM
-   - Genérica em seção de equipe, escritório ou depoimento: remove.
-   - Genérica como fundo abstrato ou textura: pode ficar, se não afirmar nada sobre o negócio. Diga isso na tabela.
-   - Indefinida: pergunte antes de mexer.
+2. DECIDE PER IMAGE
+   - Generic in a team, office, or testimonial section: remove.
+   - Generic as an abstract background or texture: can stay, as long as it doesn't claim anything about the business. Note this in the table.
+   - Undetermined: ask before touching it.
 
-3. PREPARE O LUGAR DA FOTO REAL
-   - Componente de equipe com foto, nome e cargo (nunca só cargo).
-   - Proporção fixa com object-fit: cover, para foto de celular vertical não quebrar a grade quando chegar.
-   - Tamanho responsivo, carregamento preguiçoso fora da primeira tela e dimensões declaradas, para não pular layout.
-   - Texto alternativo descrevendo quem está na foto, não "foto da equipe".
-   - Enquanto a foto real não chegar: bloco fora da página com TODO. Um monograma com as iniciais é aceitável como provisório. Stock, não.
+3. PREPARE THE SPOT FOR THE REAL PHOTO
+   - A team component with photo, name and title (never just the title).
+   - Fixed aspect ratio with object-fit: cover, so a vertical phone photo doesn't break the grid once it arrives.
+   - Responsive sizing, lazy loading outside the first screen, and declared dimensions, so the layout doesn't jump.
+   - Alt text describing who's in the photo, not "team photo".
+   - Until the real photo arrives: a block left out of the page with a TODO. A monogram with initials is acceptable as a placeholder. Stock is not.
 
-4. ENTREGUE O BRIEFING DE FOTO
-   Cinco linhas, no tom de mensagem de WhatsApp, dizendo o que fotografar (equipe no local de trabalho, luz natural, sem pose corporativa), quantas fotos, orientação, resolução mínima e o que evitar.
+4. DELIVER THE PHOTO BRIEF
+   Five lines, in the tone of a WhatsApp message, saying what to photograph (team at the workplace, natural light, no corporate posing), how many photos, orientation, minimum resolution, and what to avoid.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Imagem | Onde aparece | Classificação | Ação | Substituta necessária |
+| Image | Where it appears | Classification | Action | Replacement needed |
 
-Em seguida, PENDÊNCIAS com as fotos que precisam ser tiradas, e o briefing de foto em bloco de citação.
+Then, PENDING ITEMS with the photos that need to be taken, and the photo brief in a blockquote.
 
-REGRA DE CORTE: seção de equipe vazia é melhor que seção de equipe falsa. Se a remoção esvaziar uma página inteira, diga isso e proponha o que colocar no lugar com material que já exista.
+CUTOFF RULE: an empty team section is better than a fake team section. If the removal empties out an entire page, say so and propose what to put there using material that already exists.

package/src/skills-lib/site-launch-kit/references/07-endereco-como-chegar.md

@@ -1,37 +1,37 @@
-# Rodada 07 · Endereço e como chegar
+# Round 07 · Address and directions
 
-**Garante:** qualquer pessoa descobre onde é e como chegar em menos de dez segundos.
-**Rode quando:** o negócio tiver endereço físico visível ao público.
+**Ensures:** anyone can find out where it is and how to get there in under ten seconds.
+**Run when:** the business has a physical address visible to the public.
 
-Você é um desenvolvedor front-end trabalhando no site de um negócio com endereço físico. Sua única tarefa nesta rodada: fazer com que qualquer pessoa descubra onde é e como chegar em menos de dez segundos.
+You are a front-end developer working on the site of a business with a physical address. Your only task in this round: make sure anyone can find out where it is and how to get there in under ten seconds.
 
-PRIMEIRO, VERIFIQUE SE ESTE ITEM SE APLICA. Procure endereço no repositório (rodapé, contato, schema, CMS). Se o negócio for totalmente remoto ou não tiver endereço público, PARE, responda "ITEM NÃO SE APLICA" com uma linha de justificativa, e não invente sede nenhuma.
+FIRST, CHECK WHETHER THIS ITEM APPLIES. Search the repository for an address (footer, contact, schema, CMS). If the business is fully remote or has no public address, STOP, answer "ITEM DOES NOT APPLY" with a one-line justification, and don't invent any headquarters.
 
-NÃO invente endereço, CEP, horário, telefone ou ponto de referência.
+DO NOT invent an address, zip code, business hours, phone number, or landmark.
 
-1. INVENTÁRIO
-   Liste todo lugar onde o endereço aparece hoje e compare caractere a caractere: rodapé, página de contato, schema, textos soltos. Endereço divergente entre o site e o Google Business atrapalha a busca local além de confundir o cliente. Aponte cada divergência.
+1. INVENTORY
+   List every place the address appears today and compare them character by character: footer, contact page, schema, loose text. An address that diverges between the site and Google Business hurts local search on top of confusing the customer. Point out every divergence.
 
-2. BLOCO DE ENDEREÇO
-   Um componente único, alimentado por UMA fonte de dados, com:
-   - endereço completo em texto selecionável (para copiar e colar);
-   - botão "Como chegar" abrindo a rota no app de mapa do aparelho (link universal de mapa com o endereço codificado, não coordenadas escritas à mão);
-   - telefone e WhatsApp como link clicável (tel: e wa.me);
-   - horário de funcionamento;
-   - referências que só quem já foi conhece: estacionamento, andar, entrada, portaria, ponto de referência. Pergunte, não deduza.
+2. ADDRESS BLOCK
+   A single component, fed by ONE data source, with:
+   - the full address as selectable text (so it can be copied and pasted);
+   - a "Get directions" button opening the route in the device's map app (a universal map link with the encoded address, not hand-written coordinates);
+   - phone and WhatsApp as clickable links (tel: and wa.me);
+   - business hours;
+   - references only a past visitor would know: parking, floor, entrance, front desk, landmark. Ask, don't guess.
 
-3. MAPA SEM DERRUBAR A PÁGINA
-   - Nada de iframe carregando junto com a página. Use imagem estática ou um bloco com aparência de mapa, e carregue o iframe só no clique ou quando ele entrar na tela.
-   - iframe com loading="lazy", title descritivo e dimensões declaradas.
-   - Se houver banner de cookies ou controle de consentimento, o mapa de terceiro respeita o consentimento antes de carregar.
+3. A MAP THAT DOESN'T TANK THE PAGE
+   - No iframe loading together with the page. Use a static image or a map-styled block, and only load the iframe on click or when it scrolls into view.
+   - iframe with loading="lazy", a descriptive title, and declared dimensions.
+   - If there's a cookie banner or consent control, the third-party map respects consent before loading.
 
-4. COERÊNCIA
-   Depois de implementar, o endereço precisa estar idêntico em todos os lugares e vir da mesma fonte. Anote para a rodada 12 (schema local) qual é essa fonte.
+4. CONSISTENCY
+   After implementing, the address needs to be identical everywhere and come from the same source. Note for round 12 (local schema) which source that is.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Onde | O que havia | O que há agora | Divergência corrigida |
+| Where | What was there | What's there now | Divergence fixed |
 
-Em seguida, PENDÊNCIAS, uma linha por item no formato "o que falta · de quem obter · o que ele destrava".
+Then, PENDING ITEMS, one line per item in the format "what's missing · who to get it from · what it unlocks".
 
-REGRA DE CORTE: ponto de referência inventado manda gente para o lugar errado. O que você não souber, pergunte; o que não for respondido, fica fora da página.
+CUTOFF RULE: an invented landmark sends people to the wrong place. What you don't know, ask about; what doesn't get answered, stays off the page.