@unbox-plus/cli 0.20.4

package/template/agents/definitions/14-seo.md

@@ -0,0 +1,388 @@
+# Agente 14 — Unbox AI SEO Agent
+
+## Objetivo
+
+Otimização avançada de SEO para o storefront headless. Complementa o agente 11 (infraestrutura básica) com schemas ricos, OG images dinâmicas, breadcrumbs, otimização de títulos e Core Web Vitals.
+
+**Pré-requisito:** agente 11 concluído — `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation), `sitemap.ts` e `robots.ts` já existem.
+
+---
+
+## Apresentação ao usuário
+
+Ao iniciar este agente, exiba o menu abaixo e pergunte quais módulos ativar:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Unbox AI SEO Agent — Módulos disponíveis
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  [1] Schemas JSON-LD Avançados
+      Organization, WebSite+SearchAction, BreadcrumbList,
+      AggregateRating e Review no Product schema
+      ⚙️  Sem dependências
+
+  [2] OG Images Dinâmicas
+      Imagem Open Graph gerada por produto e categoria
+      via Next.js ImageResponse (rota opengraph-image.tsx)
+      ⚙️  Sem dependências (usa dados já disponíveis no RSC)
+
+  [3] Breadcrumbs
+      Componente visual + BreadcrumbList JSON-LD integrado
+      Inserido no PDP e páginas de categoria
+      ⚙️  Sem dependências
+
+  [4] Templates de Título e Description
+      Templates configuráveis por tipo de página com variáveis
+      dinâmicas: {productName}, {categoryName}, {siteName}, {price}
+      ⚙️  Sem dependências
+
+  [5] Canonical e Paginação de Catálogo
+      Canonical limpo em URLs com query params de filtro/ordem
+      rel prev/next (ou canonical único) para paginação
+      ⚙️  Sem dependências
+
+  [6] Core Web Vitals
+      fetchpriority="high" no LCP image, preconnect hints,
+      font-display: swap, lazy loading estratégico
+      ⚙️  Sem dependências
+
+  [7] Search Console Setup
+      Meta tag de verificação, guia de submissão do sitemap,
+      teste de rich results para Product schema
+      ⚙️  Requer: acesso ao Google Search Console
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Opções: "all", números separados por vírgula (ex: 1,3,6), ou "none"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Aguarde a resposta antes de qualquer implementação.
+
+---
+
+## Módulos — especificação técnica
+
+### [1] Schemas JSON-LD Avançados
+
+**Arquivo:** `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation) (estender o existente)
+
+#### Organization + WebSite (global)
+
+**A foundation JÁ emite os dois** em `app/(loja)/page.tsx` (Organization + WebSite/SearchAction).
+ESTENDA esse bloco (sameAs, logo, contactPoint); não crie outro no `app/layout.tsx`: schema
+duplicado é penalizado. O exemplo abaixo mostra o formato completo pra comparar.
+
+```tsx
+// Formato de referência: a foundation já tem este bloco em app/(loja)/page.tsx
+const orgSchema = {
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  name: process.env.NEXT_PUBLIC_SITE_NAME,
+  url: process.env.NEXT_PUBLIC_SITE_URL,
+  logo: `${process.env.NEXT_PUBLIC_SITE_URL}/brand/logo.svg`,
+  // TODO: adicionar sameAs com redes sociais da loja
+  sameAs: [],
+}
+
+const websiteSchema = {
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  name: process.env.NEXT_PUBLIC_SITE_NAME,
+  url: process.env.NEXT_PUBLIC_SITE_URL,
+  potentialAction: {
+    "@type": "SearchAction",
+    target: {
+      "@type": "EntryPoint",
+      urlTemplate: `${process.env.NEXT_PUBLIC_SITE_URL}/busca?q={search_term_string}`,
+    },
+    "query-input": "required name=search_term_string",
+  },
+}
+```
+
+SearchAction habilita o **Sitelinks Searchbox** do Google — caixa de busca direta nos resultados.
+
+#### AggregateRating no Product JSON-LD
+
+Estender o objeto `jsonLd` em `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation):
+
+```ts
+// Adicionar ao objeto de retorno quando reviews existirem
+aggregateRating: reviews?.length ? {
+  "@type": "AggregateRating",
+  ratingValue: avgRating,        // média calculada localmente
+  reviewCount: reviews.length,
+  bestRating: 5,
+  worstRating: 1,
+} : undefined,
+review: reviews?.slice(0, 5).map(r => ({
+  "@type": "Review",
+  author: { "@type": "Person", name: r.author },
+  reviewRating: { "@type": "Rating", ratingValue: r.stars },
+  reviewBody: r.comment,
+})),
+```
+
+**Fonte dos reviews:** `lib/enrichment/products.json` (campo `reviews[]`) ou array vazio como fallback.
+
+---
+
+### [2] OG Images Dinâmicas
+
+**Arquivos:**
+- `app/(loja)/produto/[productSlug]/opengraph-image.tsx` — OG image por produto
+- `app/(loja)/categoria/[tagSlug]/opengraph-image.tsx` — OG image por categoria
+
+```tsx
+// app/(loja)/produto/[productSlug]/opengraph-image.tsx
+import { ImageResponse } from "next/og"
+
+export const runtime = "edge"
+export const size = { width: 1200, height: 630 }
+export const contentType = "image/png"
+
+export default async function Image({ params }: { params: { productSlug: string } }) {
+  const product = await withStoreClient((c) => c.getProductBySlug(params.productSlug)) // lib/unbox/store.ts
+
+  return new ImageResponse(
+    <div style={{ display: "flex", width: "100%", height: "100%", background: "#18181B" }}>
+      {/* Imagem do produto à direita */}
+      {product.imageUrls?.[0] && (
+        <img src={product.imageUrls[0]} style={{ width: 400, height: 630, objectFit: "cover" }} />
+      )}
+      {/* Texto à esquerda */}
+      <div style={{ flex: 1, padding: "60px 48px", display: "flex", flexDirection: "column", justifyContent: "center" }}>
+        <div style={{ color: "#D97706", fontSize: 18, marginBottom: 16 }}>
+          {process.env.NEXT_PUBLIC_SITE_NAME}
+        </div>
+        <div style={{ color: "white", fontSize: 48, fontWeight: 800, lineHeight: 1.1 }}>
+          {product.title}
+        </div>
+        {product.pricing?.[0]?.price && (
+          <div style={{ color: "#D97706", fontSize: 36, marginTop: 24 }}>
+            R$ {product.pricing[0].price.toFixed(2).replace(".", ",")}
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}
+```
+
+**Runtime:** não force `runtime = "edge"`: `withStoreClient` usa Node (cookies/`server-only`) e `ImageResponse` roda no Node normalmente. `app/opengraph-image.tsx` da foundation é o exemplo.
+
+---
+
+### [3] Breadcrumbs
+
+**Arquivo:** `components/ui/breadcrumbs.tsx`
+
+```tsx
+interface Crumb { label: string; href?: string }
+
+export function Breadcrumbs({ items }: { items: Crumb[] }) {
+  const jsonLd = {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((crumb, i) => ({
+      "@type": "ListItem",
+      position: i + 1,
+      name: crumb.label,
+      ...(crumb.href ? { item: `${process.env.NEXT_PUBLIC_SITE_URL}${crumb.href}` } : {}),
+    })),
+  }
+
+  return (
+    <>
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
+      <nav aria-label="Breadcrumb">
+        <ol className="flex flex-wrap items-center gap-1 text-sm text-muted-foreground">
+          {items.map((crumb, i) => (
+            <li key={i} className="flex items-center gap-1">
+              {i > 0 && <span aria-hidden>/</span>}
+              {crumb.href && i < items.length - 1
+                ? <a href={crumb.href} className="hover:text-foreground transition-colors">{crumb.label}</a>
+                : <span className="text-foreground font-medium">{crumb.label}</span>
+              }
+            </li>
+          ))}
+        </ol>
+      </nav>
+    </>
+  )
+}
+```
+
+**Inserir no PDP:**
+```tsx
+<Breadcrumbs items={[
+  { label: "Home", href: "/" },
+  { label: category.name, href: `/categoria/${category.slug}` },
+  { label: product.title },
+]} />
+```
+
+---
+
+### [4] Templates de Título e Description
+
+**Arquivo:** `lib/seo-templates.ts`
+
+```ts
+// Configurar aqui — usar variáveis entre chaves
+export const SEO_TEMPLATES = {
+  product: {
+    title:       "{productName} | {siteName}",
+    description: "Compre {productName} por R${price}. {shortDescription}",
+  },
+  category: {
+    title:       "{categoryName} — {siteName}",
+    description: "Confira nossa seleção de {categoryName} em {siteName}.",
+  },
+  home: {
+    title:       "{siteName} — Loja Oficial",
+    description: "Compre em {siteName}: {shortDescription}",
+  },
+  search: {
+    title:       'Resultados para "{query}" | {siteName}',
+    description: 'Encontre "{query}" em {siteName}. Filtros por categoria, preço e disponibilidade.',
+  },
+}
+
+// ⚠️ Nenhuma promessa comercial no template. Frete grátis só entra interpolado de
+// FREE_SHIPPING_THRESHOLD (lib/store-config.ts) quando não for null; prazo de entrega só se o
+// lojista tiver SLA documentado no DESIGN-<MARCA>.md. O unbox:honestidade derruba
+// "frete grátis acima de R$N" e "entrega rápida" escritos à mão.
+export function fillTemplate(template: string, vars: Record<string, string>): string {
+  return Object.entries(vars).reduce(
+    (str, [k, v]) => str.replaceAll(`{${k}}`, v),
+    template,
+  )
+}
+```
+
+Substituir chamadas hardcoded em `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation) por `fillTemplate(SEO_TEMPLATES.product.title, { ... })`.
+
+---
+
+### [5] Canonical e Paginação de Catálogo
+
+**Problema:** `/categoria/camisetas?sort=price&page=2` → Google vê URL diferente de `/categoria/camisetas`.
+
+**Solução em `buildCategoryMetadata`:**
+
+```ts
+export function buildCategoryMetadata(
+  tag: { name: string; displayTitle?: string; description?: string; slug: string },
+  page?: number,
+): Metadata {
+  const base = `${URL}/categoria/${tag.slug}`
+  const canonical = page && page > 1 ? `${base}?page=${page}` : base
+
+  return {
+    title: fillTemplate(SEO_TEMPLATES.category.title, { categoryName: tag.displayTitle ?? tag.name, siteName: SITE }),
+    description: tag.description,
+    alternates: {
+      canonical,
+      // rel prev/next para paginação — sinaliza série ao Google
+      ...(page && page > 1 ? { prev: page === 2 ? base : `${base}?page=${page - 1}` } : {}),
+    },
+    // Parâmetros de filtro e ordem não devem gerar URLs canônicas distintas
+    robots: { index: true, follow: true },
+  }
+}
+```
+
+**robots.txt** — bloquear parâmetros de ordenação/filtro que não mudam conteúdo:
+
+```ts
+disallow: [
+  "/conta/", "/checkout", "/pedido/", "/api/", "/busca?",
+  "/categoria/*?sort=",    // ordenação não cria página nova
+  "/categoria/*?filter=",  // filtros internos, se houver
+]
+```
+
+---
+
+### [6] Core Web Vitals
+
+#### LCP Image — fetchpriority
+
+```tsx
+// No hero / primeira imagem do PDP
+// next/image com priority={true} gera automaticamente fetchpriority="high" + preload link
+<Image
+  src={product.imageUrls[0]}
+  priority={true}   // ← crucial para LCP
+  sizes="(max-width: 768px) 100vw, 50vw"
+  fill
+  alt={product.title}
+/>
+```
+
+Garantir que `priority={true}` está em:
+- Hero da home (`components/home/sections/hero.tsx`)
+- Primeira imagem da galeria do PDP (`components/product/pdp/gallery.tsx`)
+- Primeira imagem do catálogo (acima da dobra apenas — produto 1 e 2)
+
+#### Preconnect hints em `app/layout.tsx`
+
+```tsx
+// No <head> via metadata ou diretamente no layout:
+<link rel="preconnect" href="https://cdn.unbox.com.br" />   // CDN de imagens Unbox
+<link rel="dns-prefetch" href="https://cdn.unbox.com.br" />
+```
+
+#### Font display
+
+```ts
+// No next/font (já configurado no layout.tsx) — garantir:
+const plusJakarta = Plus_Jakarta_Sans({
+  display: "swap",  // evita FOIT — texto invisível durante carregamento
+  // ...
+})
+```
+
+---
+
+### [7] Search Console Setup
+
+Este módulo não gera código — é um guia de ações manuais:
+
+```
+Checklist pós-deploy:
+
+□ 1. Acessar https://search.google.com/search-console
+□ 2. Adicionar propriedade (URL prefix) com a URL de produção
+□ 3. Verificar via meta tag:
+      → Copiar conteúdo do atributo "content" fornecido pelo GSC
+      → Adicionar em app/layout.tsx:
+         export const metadata = { verification: { google: "CODIGO_AQUI" } }
+□ 4. Fazer deploy e confirmar verificação no GSC
+□ 5. Submeter sitemap: Sitemaps → https://seudominio.com.br/sitemap.xml
+□ 6. Aguardar 3-5 dias e verificar em Enhancements → Shopping (Product rich results)
+□ 7. Testar JSON-LD em: https://search.google.com/test/rich-results
+      → Testar URL de produto → confirmar Product + breadcrumb valid
+```
+
+---
+
+## Fluxo do agente
+
+1. **Apresentar menu** e aguardar escolha.
+2. **Verificar pré-requisito:** confirmar que `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation) existe (agente 11 concluído).
+3. **Implementar** em ordem numérica — cada módulo é independente.
+4. **Para módulos que estendem `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation):** ler o arquivo atual antes de editar.
+5. **Ao final:** listar o que foi implementado e qualquer TODO que exige ação manual (ex: sameAs de redes sociais, código do Search Console).
+
+---
+
+## Regras
+
+- **Nunca duplicar** o que o agente 11 já fez — ler `app/(loja)/produto/[productSlug]/page.tsx` (metadata/JSON-LD inline — não existe lib/metadata.ts na foundation) antes de editar.
+- `<script type="application/ld+json">` deve usar `JSON.stringify()` — nunca template string com interpolação direta (risco de XSS se dados contiverem `</script>`).
+- OG images no Edge Runtime — não usar `import "server-only"` nem APIs Node.js nativas.
+- `priority={true}` apenas na primeira imagem visível — não em todas; múltiplos preloads prejudicam LCP.
+- Templates de título: nunca ultrapassar ~60 caracteres no título e ~155 na description para evitar truncamento no Google.

package/template/agents/definitions/15-branding.md

@@ -0,0 +1,26 @@
+# Agente 15 — Branding & Identidade
+
+**Este arquivo é um ponteiro de propósito. Não há definição aqui.**
+
+A definição viva do agente 15 é `.claude/agents/branding-briefing.md`, e o
+`.claude/settings.json` a carrega como **system prompt** assim que você abre o Claude Code na
+raiz deste projeto.
+
+Ou seja: **se você está numa sessão de briefing, esse texto já está inteiro no seu contexto.**
+Abrir a definição pra "consultar o que o agente deve fazer" relê ~8k tokens do que você já tem.
+
+Até a v0.14.3 este arquivo era uma cópia integral daquele prompt — 32 KB duplicados que o
+MANAGER apontava como "a definição", convidando exatamente essa releitura. Virou ponteiro na
+v0.15.0.
+
+## Se você quer mesmo ler a definição
+
+Casos legítimos: você está numa sessão que **não** é a de briefing (por exemplo, rodando o
+agente 16 de QA e querendo saber o que o 15 prometeu), ou está editando o prompt.
+
+    .claude/agents/branding-briefing.md
+
+## Se você quer saber onde as coisas ficam no projeto
+
+Não é aqui. É o `CLAUDE.md` da raiz — o mapa "quero mudar X, mexo em Y". É bem mais barato que
+abrir componentes até achar.

package/template/agents/definitions/16-qa-visual.md

@@ -0,0 +1,138 @@
+# Agente 16 — QA Visual (gate de "pronto")
+
+## Escopo
+Transformar o critério de pronto de "o agente achou que terminou" em "**todo frame foi
+visto e avaliado**". Roda depois do briefing/build do agente 15 e depois de CADA rodada de
+feedback (`marca/FEEDBACK-NN.md`). Nada vai pro cliente sem passar aqui.
+
+## Dependências
+- `marca/DESIGN-<MARCA>.md` existente (contrato de design do agente 15) — se não existir,
+  volte ao 15 e gere antes; avaliar sem contrato é opinião, não QA.
+- Skill `web-design-guidelines` (em `.claude/skills/`) — **invocação obrigatória** na etapa 4.
+
+## A regra de ordem: barato reprova antes de caro
+
+Screenshot é a etapa mais cara do ciclo, e um defeito pego na etapa 1 invalida todas as
+imagens da etapa 3. Então os gates de texto rodam **primeiro**, sempre, sem exceção. Nunca
+capture tela pra descobrir algo que um comando de dois segundos já diria.
+
+## Protocolo
+
+### 1. Gates de texto — antes de qualquer imagem
+```bash
+npm run typecheck          # o mais barato: erro de tipo derruba o build depois
+npm run unbox:honestidade  # promessa comercial sem lastro (detalhe na etapa 2)
+npm run unbox:receita      # variedade da receita — mede, não bloqueia
+npm run build              # dispara o prebuild de marca (selo + GTM)
+```
+**Não avance com nenhum deles vermelho.** Corrija e rode de novo. Só depois:
+
+```bash
+npm run start   # next start, porta 3000
+```
+> ⚠️ Build e dev compartilham `.next`: rodar `npm run build` enquanto o `next dev` serve
+> corrompe os dois. Derrube o dev antes. E painel de preview em aba oculta NÃO rasteriza
+> (screenshot vem em branco): use Chrome headless.
+>
+> ⚠️ Porta de preview: no localhost ela fica DESLIGADA por padrão (só liga em host de
+> preview — *.vercel.app/*.myunbox.com.br), então o QA local não esbarra na tela /acesso.
+> Se os screenshots vierem todos com a "Prévia privada", alguém setou `PREVIEW_FORCE=1`
+> no `.env.local` — remova pra rodar o QA.
+
+### 2. Gate de honestidade — contra fabricação SILENCIOSA
+O `unbox:honestidade` da etapa 1 lista prova social/afirmação sem lastro que alguém tenha
+ADICIONADO (vendas fixas, avaliações inventadas, nota estruturada pro Google, selos sem dado,
+prazos não confirmados). A foundation não traz nenhum: num scaffold novo ele sai verde. **Exit
+1 = algo entrou sem dado real e ninguém decidiu.**
+
+A regra: **você nunca inventa dado por conta própria, e nada fabricado vai pro ar por
+omissão — mas a loja é do lojista.** Apresente a lista a ele em linguagem simples ("isso
+aqui é número de exemplo, não é real — troco por dado real, tiro, ou você quer manter?").
+O que ele mandar manter é decisão DELE: registre a substring em
+`marca/honestidade-permitido.txt` e anote quem decidiu no `DESIGN-<MARCA>.md`. O que ele
+não decidir: dado real ou estado honesto (convite a avaliar, trust strip verdadeiro).
+
+### 3. Screenshots — com orçamento, não à exaustão
+Cobrir "nenhuma região sem frame" numa home de 16 seções em dois viewports passa de 70
+imagens por rodada, e a maioria mostra o que a anterior já mostrou. O que pega defeito é
+**dobra, transição entre seções e os extremos**, não o meio de um bloco.
+
+Orçamento por rodada completa — **~20 frames**, desktop 1440 e mobile 390:
+
+| Tela | Desktop | Mobile | O que capturar | Quem captura |
+|---|---:|---:|---|---|
+| Home | 4 | 4 | dobra, primeira transição de seção, meio, rodapé | `unbox:qa` |
+| PDP (produto principal) | 2 | 2 | dobra com galeria/preço, bloco de conteúdo enriquecido | `unbox:qa` com `QA_PDP=/produto/<slug>` |
+| PDP (2º produto) | 1 | 1 | só a dobra — confere que não quebra com outro dado | manual (browser) |
+| Catálogo | 1 | 1 | grade (o script captura sem filtro; filtro aplicado é manual) | `unbox:qa` |
+| Carrinho | 1 | 1 | o script captura VAZIO; com item dentro é manual | `unbox:qa` + manual |
+| Checkout | 1 | 1 | primeira tela | `unbox:qa` |
+
+```bash
+npm run unbox:placeholder   # antes de publicar: placeholder no HTML servido
+npm run unbox:qa                                  # home, catálogo, carrinho, checkout (14 frames)
+QA_PDP=/produto/<slug> npm run unbox:qa           # + PDP do produto principal (18 frames)
+```
+
+O que o script não cobre (2º produto, catálogo filtrado, carrinho com item) você captura no
+browser, só na dobra, e só se a rodada for a final.
+
+**Nunca capture com `chrome --headless --window-size=390,844`.** No macOS o Chrome trava a
+largura mínima da janela: o PNG sai com 390 de largura — e é por isso que o erro passa
+despercebido — mas a página renderizou a **500**. Medido, nos dois modos headless:
+
+    --window-size=390,844   →   window.innerWidth = 500
+
+O "mobile" do QA era o layout de 500px reduzido, e metade da revisão visual de toda loja
+aprovava uma tela que nenhum usuário vê. O `unbox:qa` usa emulação de dispositivo do CDP
+(`Emulation.setDeviceMetricsOverride`), que independe do tamanho da janela, e **confere a
+cada captura que `window.innerWidth` bateu com o pedido** — se divergir, ele avisa e sai
+com erro em vez de entregar frame inválido em silêncio. Sem dependência nova.
+
+Precisa de outra rota ou de mais frames numa página? O plano fica no topo de
+`scripts/qa-screenshots.mjs`. Rotas com dado de sessão (PDP de um produto real, carrinho
+com item dentro) pedem captura manual — use o mesmo script como base, nunca `--window-size`.
+
+Estoure o orçamento de propósito quando houver motivo declarado: seção nova que ninguém viu
+ainda, defeito que você não consegue localizar, ou pedido explícito do cliente. Orçamento é
+piso de disciplina, não teto burro.
+
+### 4. Avalie cada frame contra o contrato — cinco olhares, em paralelo
+São cinco leituras independentes do mesmo material, e nenhuma delas escreve nada. Rodar em
+série, dentro de uma conversa só, é o desperdício mais barato de eliminar do protocolo.
+
+Invoque o subagente `avaliador-visual` (em `.claude/agents/`) **uma vez por olhar**, na mesma
+mensagem, para que rodem juntos:
+
+| Olhar | Procura |
+|---|---|
+| composição | a dobra conta a história do conceito central? hierarquia, blocos órfãos, ritmo |
+| contraste | texto sobre imagem, tokens `--store-*` respeitados, foco visível |
+| responsivo | nada cortado/estourado no 390, nada "flutuando" no 1440, imagem acima da resolução registrada no inventário (ex.: foto de 432px em full-bleed) |
+| copy | tom de voz e proibições do contrato no texto renderizado (travessão, palavras vetadas) |
+| honestidade | afirmação sem lastro que não está em `marca/honestidade-permitido.txt` |
+
+O agente é somente-leitura de propósito: ele devolve achados, **você** corrige. Só quem vê os
+cinco retornos juntos consegue evitar correções que se atropelam.
+
+Antes de corrigir, junte os cinco retornos e **descarte o que se repete**: o mesmo defeito
+costuma aparecer em dois olhares com palavras diferentes.
+
+A skill `web-design-guidelines` continua de invocação obrigatória — invoque-a você, ao revisar
+os achados, não dentro de cada avaliador (cinco cópias da mesma skill não melhoram nada).
+
+### 5. Corrija e reveja — só o que mudou
+Liste os defeitos das etapas 2 e 4 e corrija. Na volta:
+
+- **os gates de texto da etapa 1 rodam inteiros de novo** — são baratos e pegam regressão;
+- **as capturas, não.** Recapture as telas que a correção tocou, mais a home (que quase tudo
+  afeta). Uma correção de CSS de PDP não pede recaptura de carrinho e checkout.
+
+A passada final é a exceção: quando você acredita que acabou, faça **uma** rodada completa do
+orçamento inteiro, do build novo. É essa que autoriza o "tá pronto" e é ela que fica em `qa/`.
+
+## Saída esperada
+- `qa/` com os screenshots da passada final completa (desktop + mobile, todas as telas);
+- `npm run typecheck`, `build` e `unbox:honestidade` saindo com ✓;
+- lista do que foi corrigido registrada em `marca/BRIEFING.md` (ou no FEEDBACK-NN da rodada);
+- só então: "tá pronto" pro cliente.