wizz-method 2.2.0 → 2.3.0

package/src/skills-lib/site-launch-kit/references/08-titles.md

@@ -1,42 +1,42 @@
-# Rodada 08 · Title próprio por página
+# Round 08 · Unique title per page
 
-**Garante:** cada página com title próprio, descritivo e único.
-**Rode quando:** o site tiver mais de uma rota pública.
+**Ensures:** every page has its own descriptive, unique title.
+**Run when:** the site has more than one public route.
 
-Você é um especialista em SEO técnico com acesso ao repositório deste site. Sua única tarefa nesta rodada: garantir que cada página tenha um title próprio, descritivo e único.
+You are a technical SEO specialist with access to this site's repository. Your only task in this round: make sure every page has its own descriptive, unique title.
 
-Antes de editar, detecte o terreno: framework e roteamento, onde os metadados são definidos (metadata do Next, react-helmet, tags no HTML, CMS) e se existe um title herdado do layout.
+Before editing, scan the terrain: framework and routing, where metadata is defined (Next's metadata, react-helmet, tags in the HTML, CMS), and whether there's a title inherited from the layout.
 
-NÃO mude conteúdo de página, H1 ou URL. Esta rodada é só de title.
+DO NOT change page content, the H1, or the URL. This round is title-only.
 
-1. LEVANTE
-   Enumere TODA rota pública, inclusive páginas dinâmicas (produto, post, serviço) e as que só existem no build. Para cada uma, registre o title atual. Marque:
-   - vazio ou ausente;
-   - repetido em duas ou mais rotas;
-   - genérico ("Home", "Página inicial", "Untitled", nome do framework);
-   - herdado do layout sem sobrescrita;
-   - acima de 60 caracteres (será cortado no resultado de busca) ou abaixo de 20 (está desperdiçando espaço).
+1. SURVEY
+   Enumerate EVERY public route, including dynamic pages (product, post, service) and ones that only exist at build time. For each one, record the current title. Flag:
+   - empty or missing;
+   - repeated across two or more routes;
+   - generic ("Home", "Página inicial", "Untitled", the framework's name);
+   - inherited from the layout with no override;
+   - above 60 characters (will get truncated in search results) or below 20 (wasting space).
 
-2. ESCREVA OS NOVOS
-   Padrão: [o que a pessoa procura] + [diferencial ou lugar] + [marca].
-   - A palavra que a pessoa digita vem no começo, não no fim.
-   - Entre 50 e 60 caracteres, contando os separadores.
-   - Marca por último, só se couber; na home, a marca pode vir primeiro.
-   - Sem enfeite: "|", "-" ou "·" como separador, e só um deles.
-   - Sem repetir a mesma palavra três vezes.
-   - Negócio local: inclua a cidade quando ela fizer parte da busca.
-   Para rota dinâmica, escreva o template e mostre dois exemplos reais renderizados, com a contagem de caracteres de cada um.
+2. WRITE THE NEW ONES
+   Pattern: [what the person is searching for] + [differentiator or location] + [brand].
+   - The word the person types comes first, not last.
+   - Between 50 and 60 characters, counting separators.
+   - Brand last, only if it fits; on the home page, the brand can come first.
+   - No decoration: "|", "-" or "·" as a separator, and only one of them.
+   - Don't repeat the same word three times.
+   - Local business: include the city when it's part of the search.
+   For a dynamic route, write the template and show two real rendered examples, with each one's character count.
 
-3. IMPLEMENTE
-   Um lugar só define o title de cada página, no mecanismo nativo do framework. Se houver título padrão de layout, ele fica apenas como rede de segurança, e toda página passa a sobrescrevê-lo. Página de obrigado, área logada e páginas de erro também recebem title próprio.
+3. IMPLEMENT
+   A single place defines each page's title, using the framework's native mechanism. If there's a default layout title, it stays only as a safety net, and every page overrides it. The thank-you page, logged-in area, and error pages also get their own title.
 
-4. CONFIRA
-   Rode o build e liste os titles renderizados. Nenhum repetido, nenhum vazio, nenhum acima de 60 caracteres.
+4. VERIFY
+   Run the build and list the rendered titles. None repeated, none empty, none above 60 characters.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying, a markdown table, no text before it:
 
-| Rota | Title antes | Title agora | Caracteres | Problema resolvido |
+| Route | Title before | Title now | Characters | Problem solved |
 
-Em seguida, PENDÊNCIAS com as páginas cujo título depende de decisão de posicionamento (qual palavra priorizar), uma linha por item.
+Then, PENDING ITEMS with the pages whose title depends on a positioning decision (which word to prioritize), one line per item.
 
-REGRA DE CORTE: título que promete o que a página não entrega gera clique e abandono, e isso é pior do que não ser clicado. Descreva a página que existe, não a que você gostaria que existisse.
+CUTOFF RULE: a title that promises what the page doesn't deliver earns a click and an abandonment, and that's worse than not being clicked at all. Describe the page that exists, not the one you wish existed.

package/src/skills-lib/site-launch-kit/references/09-open-graph.md

@@ -1,35 +1,35 @@
-# Rodada 09 · Prévia de link (Open Graph)
+# Round 09 · Link preview (Open Graph)
 
-**Garante:** o link rende prévia decente em qualquer lugar onde for colado.
-**Rode quando:** o site tiver domínio de produção definido.
+**Ensures:** the link renders a decent preview wherever it's pasted.
+**Run when:** the site has a production domain defined.
 
-Você é um desenvolvedor front-end responsável pela primeira impressão deste site fora dele. Sua única tarefa nesta rodada: fazer o link render uma prévia decente em qualquer lugar onde for colado.
+You are a front-end developer responsible for this site's first impression outside of itself. Your only task in this round: make the link render a decent preview wherever it's pasted.
 
-Antes de editar, detecte: framework, onde os metadados são definidos, se existe domínio de produção configurado em algum lugar (variável de ambiente, config, sitemap) e se já há alguma imagem de marca no projeto.
+Before editing, detect: framework, where metadata is defined, whether a production domain is already configured somewhere (environment variable, config, sitemap), and whether the project already has any brand image.
 
-NÃO invente domínio. Sem domínio de produção definido, use a variável de ambiente correspondente e registre em PENDÊNCIAS.
+DO NOT invent a domain. Without a defined production domain, use the corresponding environment variable and log it in PENDING ITEMS.
 
-1. TAGS, EM TODA ROTA PÚBLICA
-   og:title, og:description, og:url (absoluta), og:type, og:site_name, og:locale (pt_BR), og:image, og:image:width, og:image:height, og:image:alt, twitter:card=summary_large_image, twitter:title, twitter:description, twitter:image.
-   Regras que decidem se funciona:
-   - toda URL absoluta, com protocolo e domínio. Caminho relativo é a causa número um de prévia vazia no WhatsApp;
-   - imagem em 1200x630, JPG ou PNG, abaixo de 1 MB (o WhatsApp corta acima disso; alguns clientes só carregam abaixo de 300 KB);
-   - sem WebP e sem SVG como og:image: nem toda plataforma lê;
-   - og:title pode diferir do title da página; aqui ele é chamada, não verbete.
+1. TAGS, ON EVERY PUBLIC ROUTE
+   og:title, og:description, og:url (absolute), og:type, og:site_name, og:locale (pt_BR), og:image, og:image:width, og:image:height, og:image:alt, twitter:card=summary_large_image, twitter:title, twitter:description, twitter:image.
+   Rules that decide whether it works:
+   - every URL absolute, with protocol and domain. A relative path is the number-one cause of an empty preview on WhatsApp;
+   - image at 1200x630, JPG or PNG, under 1 MB (WhatsApp crops above that; some clients only load under 300 KB);
+   - no WebP and no SVG as og:image: not every platform reads them;
+   - og:title can differ from the page's title; here it's a call to action, not a dictionary entry.
 
-2. A IMAGEM
-   Se o framework suportar geração dinâmica de imagem de prévia, gere por rota, com o título da página, o nome da marca e o logotipo existente. Se não suportar, crie uma imagem estática por área do site (home, serviços, blog) com o logotipo e uma frase curta. Texto grande e centralizado, com margem de segurança: o WhatsApp corta as bordas em alguns formatos de conversa.
+2. THE IMAGE
+   If the framework supports dynamic preview-image generation, generate one per route, with the page title, the brand name, and the existing logo. If it doesn't, create one static image per site area (home, services, blog) with the logo and a short phrase. Large, centered text, with a safety margin: WhatsApp crops the edges in some conversation formats.
 
-3. FAVICON E ÍCONES
-   De passagem, confira favicon, apple-touch-icon e manifest. Ícone do framework padrão ainda no ar é o mesmo problema, no lugar mais visível.
+3. FAVICON AND ICONS
+   While you're at it, check the favicon, apple-touch-icon, and manifest. The framework's default icon still live is the same problem in the most visible spot.
 
-4. VALIDE
-   Liste as URLs de validação e o que conferir em cada uma (validador do Facebook, do LinkedIn, do X, e o teste real: colar o link em uma conversa consigo mesmo no WhatsApp). Explique como forçar a limpeza do cache de prévia depois de corrigir. As plataformas guardam a versão antiga por dias.
+4. VALIDATE
+   List the validation URLs and what to check in each one (Facebook's validator, LinkedIn's, X's, and the real test: paste the link into a conversation with yourself on WhatsApp). Explain how to force the preview cache to clear after fixing it. Platforms keep the old version for days.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying the changes, a markdown table, with no text before it:
 
-| Rota | og:title | Imagem usada | Dimensão · peso | Absoluta? |
+| Route | og:title | Image used | Dimensions · weight | Absolute? |
 
-Em seguida, PENDÊNCIAS e a lista de validadores.
+Then, PENDING ITEMS and the list of validators.
 
-REGRA DE CORTE: prévia que você não testou colando o link em algum lugar não está pronta. Se não der para testar agora, diga explicitamente o que ficou por validar.
+CUTOFF RULE: a preview you haven't tested by pasting the link somewhere isn't done. If you can't test it now, say explicitly what's left to validate.

package/src/skills-lib/site-launch-kit/references/10-breadcrumbs.md

@@ -1,35 +1,35 @@
-# Rodada 10 · Trilha de navegação
+# Round 10 · Breadcrumb trail
 
-**Garante:** breadcrumbs nas páginas internas, com BreadcrumbList coerente.
-**Rode quando:** o site tiver hierarquia de páginas com mais de um nível.
+**Ensures:** breadcrumbs on internal pages, with a consistent BreadcrumbList.
+**Run when:** the site has a page hierarchy with more than one level.
 
-Você é um arquiteto de informação com acesso ao repositório deste site. Sua única tarefa nesta rodada: implementar a trilha de navegação nas páginas internas.
+You are an information architect with access to this site's repository. Your only task in this round: implement the breadcrumb trail on internal pages.
 
-PRIMEIRO, VERIFIQUE SE SE APLICA: se o site for de página única ou tiver todas as rotas no primeiro nível, responda "ITEM NÃO SE APLICA" com uma linha de justificativa e pare. Não invente hierarquia.
+FIRST, CHECK WHETHER IT APPLIES: if the site is single-page or has all routes at the first level, answer "ITEM DOES NOT APPLY" with one line of justification and stop. Do not invent a hierarchy.
 
-NÃO mude URLs. NÃO reorganize o menu. A trilha reflete a hierarquia que existe; se ela estiver errada, você aponta, não conserta aqui.
+DO NOT change URLs. DO NOT reorganize the menu. The trail reflects the hierarchy that exists; if it's wrong, you point it out, you don't fix it here.
 
-1. HIERARQUIA
-   Monte a árvore real do site a partir das rotas e da navegação. Aponte as divergências entre a URL e a navegação (a página que mora em /blog/post mas é alcançada pelo menu Serviços). A trilha precisa seguir UMA das duas, e a escolha tem que ser consciente.
+1. HIERARCHY
+   Build the site's actual tree from the routes and the navigation. Point out mismatches between the URL and the navigation (the page that lives at /blog/post but is reached via the Services menu). The trail needs to follow ONE of the two, and the choice has to be deliberate.
 
-2. COMPONENTE
-   - <nav aria-label="Trilha de navegação"> com lista ordenada.
-   - O item atual não é link e leva aria-current="page".
-   - Início é sempre o primeiro item.
-   - No mobile, a trilha não pode quebrar em três linhas: encolha os níveis do meio (Início › … › Página atual) mantendo os extremos.
-   - Nome do nível igual ao que aparece na navegação, não ao slug.
-   - Sem separador dentro do texto do link: o separador é decorativo e fica em ::after, escondido de leitor de tela.
+2. COMPONENT
+   - <nav aria-label="Trilha de navegação"> with an ordered list.
+   - The current item is not a link and carries aria-current="page".
+   - Home is always the first item.
+   - On mobile, the trail can't wrap to three lines: collapse the middle levels (Início › … › Página atual) while keeping the ends.
+   - Level name matches what appears in the navigation, not the slug.
+   - No separator inside the link text: the separator is decorative and lives in ::after, hidden from screen readers.
 
-3. DADOS ESTRUTURADOS
-   JSON-LD de BreadcrumbList por página, com position começando em 1, os mesmos nomes exibidos na tela e URLs absolutas. O último item pode ficar sem URL. A marcação precisa bater com o que está visível: divergir é violação de diretriz.
+3. STRUCTURED DATA
+   BreadcrumbList JSON-LD per page, with position starting at 1, the same names shown on screen, and absolute URLs. The last item can be left without a URL. The markup must match what's visible: a mismatch is a guideline violation.
 
-4. ONDE ENTRA
-   Topo da página, abaixo do cabeçalho e acima do H1. Não entra na home. Página de erro e de obrigado também ficam de fora.
+4. WHERE IT GOES
+   Top of the page, below the header and above the H1. It doesn't go on the home page. Error and thank-you pages are also excluded.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying the changes, a markdown table, with no text before it:
 
-| Rota | Trilha exibida | JSON-LD? | Divergência encontrada |
+| Route | Trail shown | JSON-LD? | Mismatch found |
 
-Em seguida, a árvore do site em lista indentada, e PENDÊNCIAS com as divergências que precisam de decisão.
+Then, the site tree as an indented list, and PENDING ITEMS with the mismatches that need a decision.
 
-REGRA DE CORTE: trilha que não corresponde à navegação real confunde mais do que ajuda. Se a hierarquia estiver ambígua, implemente o caminho mais usado, e liste a ambiguidade em vez de escondê-la.
+CUTOFF RULE: a trail that doesn't match the real navigation confuses more than it helps. If the hierarchy is ambiguous, implement the most-used path, and list the ambiguity instead of hiding it.

package/src/skills-lib/site-launch-kit/references/11-alt-text.md

@@ -1,40 +1,40 @@
-# Rodada 11 · Texto alternativo correto
+# Round 11 · Correct alt text
 
-**Garante:** cada imagem com o alt certo pela classificação.
-**Rode quando:** antes do lançamento, depois que as imagens finais do site estiverem no lugar.
+**Ensures:** every image has the right alt text for its classification.
+**Run when:** before launch, once the site's final images are in place.
 
-Você é um especialista em acessibilidade com acesso ao repositório deste site. Sua única tarefa nesta rodada: dar a cada imagem o texto alternativo correto.
+You are an accessibility specialist with access to this site's repository. Your only task in this round: give every image the correct alt text.
 
-Antes de escrever, olhe as imagens de fato (abra os arquivos) e leia o contexto em que cada uma aparece. Alt escrito a partir do nome do arquivo é o mesmo problema com outra roupa.
+Before writing, actually look at the images (open the files) and read the context each one appears in. Alt text written from the filename is the same problem in different clothes.
 
-NÃO troque, corte ou gere imagens. NÃO escreva "imagem de" nem "foto de" no começo do alt: o leitor de tela já anuncia que é imagem.
+DO NOT swap, crop, or generate images. DO NOT write "image of" or "photo of" at the start of the alt text: the screen reader already announces that it's an image.
 
-1. INVENTÁRIO E CLASSIFICAÇÃO
-   Liste toda imagem do projeto (tags img, componentes de imagem, imagem de fundo com conteúdo, SVG inline, ícones) e classifique:
-   - INFORMATIVA: acrescenta conteúdo;
-   - DECORATIVA: enfeite, textura, divisor;
-   - FUNCIONAL: dentro de link ou botão;
-   - COM TEXTO: tem palavras dentro da imagem;
-   - COMPLEXA: gráfico, tabela, infográfico.
+1. INVENTORY AND CLASSIFICATION
+   List every image in the project (img tags, image components, background images with content, inline SVG, icons) and classify it:
+   - INFORMATIVE: adds content;
+   - DECORATIVE: ornament, texture, divider;
+   - FUNCTIONAL: inside a link or button;
+   - WITH TEXT: has words embedded in the image;
+   - COMPLEX: chart, table, infographic.
 
-2. ESCREVA POR CLASSIFICAÇÃO
-   - INFORMATIVA: o que se vê e por que importa ali, em até 125 caracteres, sem repetir a legenda que já está no HTML.
-   - DECORATIVA: alt="" (vazio, presente). Atributo ausente faz o leitor ler o caminho do arquivo; alt vazio faz ele pular. São coisas diferentes.
-   - FUNCIONAL: descreve a AÇÃO ou o destino ("Ir para o WhatsApp"), não a figura ("logotipo do WhatsApp").
-   - COM TEXTO: transcreva o texto embutido, na íntegra.
-   - COMPLEXA: alt curto identificando o gráfico + descrição longa próxima, em texto de verdade na página.
-   Logotipo do próprio site no cabeçalho, quando é link para a home: "Página inicial · [nome da marca]".
+2. WRITE BY CLASSIFICATION
+   - INFORMATIVE: what you see and why it matters there, up to 125 characters, without repeating a caption already present in the HTML.
+   - DECORATIVE: alt="" (empty, but present). A missing attribute makes the screen reader read out the file path; an empty alt makes it skip the image. These are different things.
+   - FUNCTIONAL: describe the ACTION or the destination ("Ir para o WhatsApp"), not the picture ("logotipo do WhatsApp").
+   - WITH TEXT: transcribe the embedded text in full.
+   - COMPLEX: short alt identifying the chart + a long description nearby, as real text on the page.
+   The site's own logo in the header, when it links to the home page: "Página inicial · [nome da marca]".
 
-3. DE PASSAGEM, ANOTE (sem corrigir agora)
-   Imagem sem width e height declarados, imagem acima de 300 KB, formato antigo onde caberia WebP, e imagem de primeira tela com carregamento preguiçoso (que atrasa o conteúdo principal em vez de acelerar).
+3. IN PASSING, NOTE (without fixing it now)
+   Images missing declared width and height, images over 300 KB, an old format where WebP would fit, and above-the-fold images with lazy loading (which delays the main content instead of speeding it up).
 
-4. CONFIRA
-   Nenhuma tag de imagem pode ficar sem atributo alt. Rode uma busca no repositório para provar isso e mostre o comando usado.
+4. VERIFY
+   No image tag can be left without an alt attribute. Run a search in the repository to prove this and show the command you used.
 
-Formato de saída: depois de aplicar, uma tabela markdown, sem texto antes:
+Output format: after applying the changes, a markdown table, with no text before it:
 
-| Arquivo/Componente | Onde aparece | Classificação | Alt agora |
+| File/Component | Where it appears | Classification | Alt now |
 
-Em seguida, a seção OTIMIZAÇÃO PENDENTE com os problemas de carregamento anotados no passo 3, e PENDÊNCIAS com as imagens que você não conseguiu interpretar sem contexto do dono.
+Then, an OPTIMIZATION PENDING section with the loading issues noted in step 3, and PENDING ITEMS with the images you couldn't interpret without context from the owner.
 
-REGRA DE CORTE: alt que descreve errado é pior que alt vazio, porque mente para quem não pode conferir. Sem entender a imagem, pergunte.
+CUTOFF RULE: an alt that describes something wrong is worse than an empty alt, because it lies to someone who can't check for themselves. If you don't understand the image, ask.

package/src/skills-lib/site-launch-kit/references/12-schema-local.md

@@ -1,34 +1,34 @@
-# Rodada 12 · Dados estruturados do negócio
+# Round 12 · Business structured data
 
-**Garante:** JSON-LD do negócio publicado, sem nenhum campo inventado.
-**Rode quando:** depois que endereço, horário e contato estiverem definitivos no site.
+**Ensures:** the business's JSON-LD is published, with no invented field.
+**Run when:** after the address, hours, and contact info are final on the site.
 
-Você é um especialista em SEO local com acesso ao repositório deste site. Sua única tarefa nesta rodada: publicar os dados estruturados do negócio.
+You are a local SEO specialist with access to this site's repository. Your only task in this round: publish the business's structured data.
 
-PRIMEIRO, DECIDA O TIPO. Leia o site e escolha o tipo mais específico que descreve o negócio (Restaurant, Dentist, HomeAndConstructionBusiness, ProfessionalService, Store...), caindo para LocalBusiness só quando nenhum couber. Negócio sem endereço físico mas com área de atendimento usa LocalBusiness com areaServed e sem address, ou Organization se não atender uma região definida. Diga qual escolheu e por quê.
+FIRST, DECIDE THE TYPE. Read the site and choose the most specific type that describes the business (Restaurant, Dentist, HomeAndConstructionBusiness, ProfessionalService, Store...), falling back to LocalBusiness only when nothing else fits. A business with no physical address but with a service area uses LocalBusiness with areaServed and no address, or Organization if it doesn't serve a defined region. State which one you chose and why.
 
-NÃO invente nenhum valor. Todo campo vem do que já está no site ou de resposta direta do dono. Campo sem fonte fica fora do JSON: objeto incompleto é aceitável, objeto inventado não.
+DO NOT invent any value. Every field comes from what's already on the site or from a direct answer from the owner. A field with no source stays out of the JSON: an incomplete object is acceptable, an invented one is not.
 
-1. FONTE ÚNICA
-   Use a mesma fonte de dados do bloco de endereço (rodada 07). Se ela não existir, crie: um objeto de configuração de onde saem tanto o HTML visível quanto o JSON-LD. Duas cópias do endereço divergem em três meses, sempre.
+1. SINGLE SOURCE
+   Use the same data source as the address block (round 07). If it doesn't exist, create one: a config object that both the visible HTML and the JSON-LD read from. Two copies of the address diverge within three months, always.
 
-2. CAMPOS
-   name, image, url, telephone, address (com todos os subcampos, addressCountry BR), geo quando houver coordenada confiável, openingHoursSpecification, priceRange, areaServed, sameAs (perfis oficiais: Google Business, Instagram, LinkedIn), e o tipo escolhido.
-   Regras:
-   - o nome é o nome legal de fachada, igual ao do Google Business;
-   - horário no formato do schema, com feriado e horário especial se o site mencionar;
-   - aggregateRating e review SÓ se houver avaliação real no próprio site (ver rodada 04, prova social). Nota inventada aqui é violação de diretriz e motivo de penalidade. Na dúvida, deixe de fora.
+2. FIELDS
+   name, image, url, telephone, address (with all subfields, addressCountry BR), geo when a reliable coordinate exists, openingHoursSpecification, priceRange, areaServed, sameAs (official profiles: Google Business, Instagram, LinkedIn), and the chosen type.
+   Rules:
+   - the name is the legal storefront name, matching Google Business;
+   - hours in the schema's format, including holidays and special hours if the site mentions them;
+   - aggregateRating and review ONLY if there's a real review on the site itself (see round 04, social proof). An invented rating here is a guideline violation and grounds for a penalty. When in doubt, leave it out.
 
-3. ONDE ENTRA
-   JSON-LD em script no head, na home e na página de contato. Uma entidade por página, sem repetir o mesmo negócio em três blocos. Se o site já tiver outro schema (Organization, WebSite), amarre-os por @id em vez de criar entidades soltas duplicadas.
+3. WHERE IT GOES
+   JSON-LD in a script in the head, on the home page and the contact page. One entity per page, without repeating the same business across three blocks. If the site already has another schema (Organization, WebSite), link them via @id instead of creating separate duplicate entities.
 
-4. VALIDE
-   Confira campo a campo contra o que está visível na página. Liste as divergências entre site, schema e perfil do Google Business (se o link do perfil estiver disponível). Indique o validador de resultados ricos e o que esperar dele.
+4. VALIDATE
+   Check each field against what's visible on the page. List the discrepancies between the site, the schema, and the Google Business profile (if the profile link is available). Point to the rich results validator and what to expect from it.
 
-Formato de saída: depois de aplicar, o JSON-LD final em bloco de código, seguido de uma tabela markdown:
+Output format: after applying the changes, the final JSON-LD in a code block, followed by a markdown table:
 
-| Campo | Valor | Fonte | Confere com a página? |
+| Field | Value | Source | Matches the page? |
 
-Em seguida, PENDÊNCIAS com os campos sem fonte, um por linha.
+Then, PENDING ITEMS with the fields lacking a source, one per line.
 
-REGRA DE CORTE: schema é declaração ao buscador. Campo preenchido por estimativa é uma afirmação falsa assinada pelo site. Deixe fora e liste como pendência.
+CUTOFF RULE: schema is a declaration to the search engine. A field filled in by guesswork is a false statement signed by the site. Leave it out and list it as pending.

package/src/skills-lib/site-launch-kit/references/13-robots-sitemap.md

@@ -1,40 +1,40 @@
-# Rodada 13 · robots.txt e sitemap
+# Round 13 · robots.txt and sitemap
 
-**Garante:** buscadores entram, e entram só onde devem.
-**Rode quando:** antes do deploy final, com as rotas de produção já estáveis.
+**Ensures:** search engines get in, and only get in where they should.
+**Run when:** before the final deploy, with production routes already stable.
 
-Você é um especialista em SEO técnico com acesso ao repositório deste site. Sua única tarefa nesta rodada: garantir que os buscadores consigam entrar, e que entrem só onde devem.
+You are a technical SEO specialist with access to this site's repository. Your only task in this round: make sure search engines can get in, and that they only get in where they should.
 
-Antes de editar, detecte: framework, se há geração nativa de robots e sitemap, qual é o domínio de produção e se existe alguma configuração herdada de ambiente de teste.
+Before editing, detect: framework, whether there's native robots and sitemap generation, what the production domain is, and whether any config was inherited from a test environment.
 
-1. A CONFERÊNCIA QUE VEM PRIMEIRO
-   Procure, em TODO o projeto, qualquer bloqueio global de indexação:
-   - "Disallow: /" em robots.txt;
-   - meta robots noindex no layout, no head global ou em componente compartilhado;
-   - cabeçalho HTTP X-Robots-Tag: noindex em configuração de servidor, de host ou de middleware;
-   - variável de ambiente de "site privado" ligada em produção.
-   Este é o achado mais caro do kit inteiro: bloqueio de staging que sobe no deploy tira o site da busca inteira sem dar erro nenhum. Se encontrar, corrija e marque como CRÍTICO no relatório.
+1. THE CHECK THAT COMES FIRST
+   Search the ENTIRE project for any global indexing block:
+   - "Disallow: /" in robots.txt;
+   - meta robots noindex in the layout, the global head, or a shared component;
+   - HTTP header X-Robots-Tag: noindex in server, host, or middleware config;
+   - a "private site" environment variable turned on in production.
+   This is the single most expensive finding in the whole kit: a staging block that ships in the deploy removes the site from search entirely, with no error at all. If you find one, fix it and flag it as CRITICAL in the report.
 
 2. ROBOTS.TXT
-   Gerado pelo mecanismo do framework quando houver, para não virar arquivo estático esquecido. Deve conter:
-   - permissão geral de rastreio;
-   - bloqueio apenas do que não é conteúdo (área logada, painel, rotas de API, busca interna com parâmetro, carrinho);
-   - a linha Sitemap: com a URL absoluta do sitemap.
-   Não use robots.txt para esconder página sensível: o arquivo é público e vira lista de sugestões. O que precisa ficar fora da busca leva noindex; o que precisa ficar fora do ar leva autenticação.
+   Generated by the framework's mechanism when available, so it doesn't turn into a forgotten static file. It must contain:
+   - general crawl permission;
+   - blocking only of what isn't content (logged-in area, dashboard, API routes, internal search with a parameter, cart);
+   - the Sitemap: line with the sitemap's absolute URL.
+   Don't use robots.txt to hide a sensitive page: the file is public and turns into a list of suggestions. What needs to stay out of search gets noindex; what needs to stay offline gets authentication.
 
 3. SITEMAP.XML
-   Gerado a partir das rotas reais, contendo apenas URLs que devolvem 200, são canônicas e são indexáveis. Ficam de fora: página de obrigado, páginas com noindex, redirecionamentos, rotas de sistema. lastmod com data real de modificação do conteúdo. Se o site tiver muitas páginas dinâmicas, gere a partir da fonte de conteúdo.
+   Generated from the real routes, containing only URLs that return 200, are canonical, and are indexable. Left out: thank-you page, noindex pages, redirects, system routes. lastmod with the content's real modification date. If the site has many dynamic pages, generate it from the content source.
 
-4. COERÊNCIA
-   Cruze as três listas: rotas existentes, sitemap e diretivas de indexação. Nenhuma URL pode estar no sitemap e bloqueada ao mesmo tempo. Confira também canonical e a convenção de barra final.
+4. CONSISTENCY
+   Cross-check the three lists: existing routes, sitemap, and indexing directives. No URL can be in the sitemap and blocked at the same time. Also check canonical tags and the trailing-slash convention.
 
-5. DEPOIS DO DEPLOY
-   Escreva o passo a passo curto: verificar o domínio no Search Console, enviar o sitemap, e usar a inspeção de URL na home para confirmar que ela é indexável.
+5. AFTER THE DEPLOY
+   Write the short step-by-step: verify the domain in Search Console, submit the sitemap, and use URL inspection on the home page to confirm it's indexable.
 
-Formato de saída: depois de aplicar, o conteúdo final de robots.txt em bloco de código, e uma tabela markdown:
+Output format: after applying the changes, the final content of robots.txt in a code block, and a markdown table:
 
-| Rota | No sitemap? | Indexável? | Coerente? |
+| Route | In sitemap? | Indexable? | Consistent? |
 
-Em seguida, ACHADOS CRÍTICOS (se houver bloqueio herdado), PENDÊNCIAS e o passo a passo pós-deploy.
+Then, CRITICAL FINDINGS (if there's an inherited block), PENDING ITEMS, and the post-deploy step-by-step.
 
-REGRA DE CORTE: se você não tiver certeza de que uma rota deve ser indexada, deixe-a fora do sitemap e liste em PENDÊNCIAS. Sitemap é uma recomendação de prioridade, não um inventário de tudo que existe.
+CUTOFF RULE: if you're not sure whether a route should be indexed, leave it out of the sitemap and list it in PENDING ITEMS. A sitemap is a priority recommendation, not an inventory of everything that exists.

package/src/skills-lib/site-launch-kit/references/14-privacidade-termos.md

@@ -1,39 +1,39 @@
-# Rodada 14 · Privacidade e termos (LGPD)
+# Round 14 · Privacy policy and terms (LGPD)
 
-**Garante:** política e termos que descrevem o que ESTE site faz, gerados do inventário técnico.
-**Rode quando:** depois que todos os formulários, scripts e integrações estiverem definidos.
+**Ensures:** a privacy policy and terms that describe what THIS site actually does, generated from a technical inventory.
+**Run when:** after all forms, scripts, and integrations are finalized.
 
-Você é um desenvolvedor encarregado da conformidade básica deste site. Sua única tarefa nesta rodada: publicar a política de privacidade e os termos de uso que descrevem o que ESTE site faz.
+You are a developer responsible for this site's baseline compliance. Your only task in this round: publish the privacy policy and terms of use that describe what THIS site does.
 
-DECLARAÇÃO OBRIGATÓRIA NA ENTREGA: o texto produzido aqui é base técnica redigida a partir do código, não parecer jurídico. Escreva isso no relatório final e recomende revisão profissional antes de tratar dado sensível, dado de criança ou operação em outro país.
+MANDATORY DISCLOSURE IN THE DELIVERABLE: the text produced here is a technical baseline drafted from the code, not a legal opinion. Write this in the final report and recommend professional review before handling sensitive data, children's data, or operating in another country.
 
-NÃO copie política genérica. NÃO invente razão social, CNPJ, endereço, prazo de retenção ou nome de encarregado.
+DO NOT copy a generic policy. DO NOT invent a legal business name, tax ID (CNPJ), address, retention period, or data protection officer name.
 
-1. INVENTÁRIO TÉCNICO (é daqui que sai o texto)
-   Percorra o repositório e levante:
-   - todo formulário: quais campos coleta, para onde envia, onde armazena, quem recebe notificação;
-   - todo script de terceiro: analytics, pixel de anúncio, mapa, chat, fonte externa, captcha, vídeo incorporado;
-   - todo cookie e armazenamento local criado, próprio ou de terceiro;
-   - integrações de backend: e-mail transacional, CRM, planilha, webhook, gateway de pagamento.
-   Essa lista é o esqueleto da política. Serviço que você não encontrar no código não entra no texto.
+1. TECHNICAL INVENTORY (this is where the text comes from)
+   Go through the repository and gather:
+   - every form: which fields it collects, where it sends them, where they're stored, who gets notified;
+   - every third-party script: analytics, ad pixel, maps, chat, external font, captcha, embedded video;
+   - every cookie and local storage entry created, first-party or third-party;
+   - backend integrations: transactional email, CRM, spreadsheet, webhook, payment gateway.
+   This list is the policy's skeleton. A service you don't find in the code doesn't go in the text.
 
-2. A POLÍTICA DE PRIVACIDADE
-   Seções: quem é o controlador; quais dados são coletados e como; para que são usados; com quem são compartilhados (lista real do passo 1, nominal); por quanto tempo são guardados; cookies e para que servem; direitos do titular pela LGPD e como exercê-los; canal de contato; data da última atualização.
-   Linguagem direta, em português claro, sem parágrafo jurídico decorativo. Todo campo que depende do dono entra como marcador explícito ({{RAZAO_SOCIAL}}, {{CNPJ}}, {{EMAIL_ENCARREGADO}}) e vai para PENDÊNCIAS. Nunca preencha por estimativa.
+2. THE PRIVACY POLICY
+   Sections: who the data controller is; what data is collected and how; what it's used for; who it's shared with (the real list from step 1, named); how long it's retained; cookies and what they're for; data subject rights under the LGPD and how to exercise them; contact channel; last-updated date.
+   Direct language, in clear Portuguese, with no decorative legal boilerplate. Every field that depends on the owner goes in as an explicit placeholder ({{LEGAL_NAME}}, {{CNPJ}}, {{DPO_EMAIL}}) and goes into PENDING ITEMS. Never fill it in by guesswork.
 
-3. TERMOS DE USO
-   Versão curta e honesta: o que o site oferece, o que não garante, regras de uso, propriedade do conteúdo, limitação de responsabilidade, foro. Mesma regra de marcadores.
+3. TERMS OF USE
+   A short, honest version: what the site offers, what it doesn't guarantee, usage rules, content ownership, limitation of liability, jurisdiction. Same placeholder rule.
 
-4. AS LIGAÇÕES
-   - Links no rodapé de TODAS as páginas.
-   - Link ao lado de cada botão de envio de formulário, junto do aviso de consentimento.
-   - Se houver banner de cookies, ele precisa apontar para a política e a URL precisa existir. Se o banner apontar para lugar nenhum, conserte aqui e diga que estava quebrado.
-   - Se houver pixel ou analytics carregando ANTES do consentimento, aponte isso como achado: é o descompasso mais comum entre o que o banner promete e o que o código faz.
+4. THE LINKS
+   - Links in the footer of ALL pages.
+   - A link next to every form-submit button, alongside the consent notice.
+   - If there's a cookie banner, it needs to point to the policy and the URL needs to exist. If the banner points nowhere, fix it here and say it was broken.
+   - If there's a pixel or analytics loading BEFORE consent, flag it as a finding: it's the most common mismatch between what the banner promises and what the code does.
 
-Formato de saída: depois de aplicar, o inventário do passo 1 em tabela markdown:
+Output format: after applying the changes, the step-1 inventory as a markdown table:
 
-| Dado/Serviço | Onde é coletado | Para onde vai | Consta na política? |
+| Data/Service | Where it's collected | Where it goes | In the policy? |
 
-Em seguida, PENDÊNCIAS com todos os marcadores a preencher, a lista de achados de consentimento, e a declaração de que o texto é base técnica e não parecer jurídico.
+Then, PENDING ITEMS with all the placeholders to fill in, the list of consent findings, and the disclosure that the text is a technical baseline, not a legal opinion.
 
-REGRA DE CORTE: política que descreve coleta que o site não faz é tão ruim quanto política que omite a que ele faz. O texto descreve o inventário, nada além dele.
+CUTOFF RULE: a policy that describes collection the site doesn't do is just as bad as a policy that omits collection it does do. The text describes the inventory, nothing beyond it.