Revisão de Landing Page
Você audita uma landing page e escreve um veredito em landing/review.md. A página pode vir do pipeline landing-skills ou de qualquer outro lugar. Você lê o código-fonte, observa a página renderizada em quatro larguras, testa animações e 3D quando houver, e julga tudo contra uma única rubrica.
Páginas que parecem prontas muitas vezes têm problemas que ninguém procurou: um formulário que descarta todos os leads enquanto agradece o visitante, especificações e promessas que o cliente nunca deu, uma página 3D que fica em branco quando o WebGL não está disponível, padding de seção cancelado por outra regra em todas as larguras. Revisores que capturam quatro larguras e olham apenas duas perdem o que aparece em apenas uma. Seu trabalho é olhar tudo e relatar apenas o que você confirmou.
<skill-dir> abaixo significa o diretório que contém este SKILL.md; os scripts estão em sua pasta scripts/. Quando a habilidade foi carregada de um plugin, o caminho deste arquivo foi fornecido a você quando foi carregada; caso contrário, encontre-o com find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null. Execute cada comando a partir do projeto sendo revisado, com os scripts nomeados pelo caminho completo.
Entradas
Você precisa da página e usa qualquer contexto existente.
- A página. Um diretório de projeto, um único arquivo HTML ou uma URL publicada. Encontre o ponto de entrada:
index.html,src/pages/index.astro,src/App.jsx,app/page.tsxou o que a stack usar. Anote a stack; ela decide como você servirá a página na passagem visual. landing/brief.md: produto, público-alvo, ação de conversão, os fatos e provas que o cliente forneceu, os assets fornecidos, idioma. Esta é sua fonte da verdade para o que a página pode alegar.landing/copy.md: o texto aprovado. Compare a página com ele.landing/direction.mdelanding/tokens.css: a direção visual com suas justificativas e os tokens. Uma escolha que parece um padrão é aceitável quando a direção fornece um motivo específico para o cliente.
Quando os arquivos estiverem ausentes:
- Sem brief. Pergunte ao usuário quatro coisas antes de julgar alegações: qual é o produto, para quem ele é, qual é a única ação de conversão e quais fatos, números, depoimentos e logotipos são reais. Se você não puder perguntar, considere os fatos do que a página diz sobre o negócio e trate cada depoimento, nome de cliente, logotipo, avaliação e métrica como não verificado: relate cada um como um bloqueador com a correção "confirme que isso é real e fornecido pelo cliente, ou remova-o". Prova não verificada que é publicada é o mesmo risco que prova inventada.
- Sem copy.md ou direction.md. Revise o texto e os visuais por seus próprios méritos com a rubrica. Você perde a capacidade de dizer "isso difere do texto aprovado", nada mais. Não peça esses arquivos.
- Sem pasta
landing/. Crielanding/elanding/shots/no projeto; o relatório e as capturas de tela vão para lá. - A página não compila ou não será servida. Relate na linha B15 da rubrica, com o erro. Se nenhuma página renderizada puder ser obtida de outra forma (uma URL publicada, uma compilação anterior), a passagem visual não pode ser executada e o veredito é
incompleto(consulte Veredito).
Leia references/rubric.md antes de iniciar as passagens. Ela contém cada verificação com a aparência de aprovação e a gravidade quando falha. Leia references/report-format.md antes de escrever landing/review.md. references/snippets.md contém os scripts que as passagens executam.
Processo
Execute as passagens nesta ordem, depois escreva o relatório:
- Passagem estática: escaneie o código-fonte, depois leia-o.
- Passagem visual: renderize a página e observe-a em quatro larguras.
- Passagem de animação e 3D: apenas quando a página tiver animação ou uma cena 3D.
- Percorra toda a rubrica em
references/rubric.md, área por área: texto, direção de arte, construção, animação, prontidão para lançamento. Escreva uma lista de verificação funcional emlanding/review-checklist.mdcom uma linha para cada ID de linha:failcom o local,passcom evidência oun/acom o motivo. Uma aprovação conta apenas quando sua evidência é a saída do próprio "Como verificar" daquela linha: a lista onde diz lista, a contagem onde diz contagem, e cada seção, cabeçalho e rodapé incluídos, onde cobre cada seção. Uma linha marcada de memória da página não é percorrida. Leia o texto e a direção de arte com tanto cuidado em uma página estática curta quanto em uma complexa, e percorra cada linha mesmo quando um bloqueador já é óbvio: a revisão lista tudo que a próxima rodada deve corrigir, não apenas o que decide o veredito. - Escreva
landing/review.mdconforme descrito emreferences/report-format.md: falhas na tabela, aprovações com suas evidências em "Verificado e OK". Em seguida, execute a autoverificação no final deste arquivo.
Mantenha notas enquanto avança: para cada descoberta, onde você a viu (arquivo e linha, ou largura e seção) e como a confirmou.
Passagem estática
Aponte o scanner para os caminhos do código-fonte da página, não para um repositório inteiro:
node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json
O que ele lê: qualquer arquivo que você nomear diretamente, independentemente da extensão. Em um diretório, ele lê arquivos .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md e .mdx, ignora as pastas node_modules, .git, dist, build, .next, .astro, .output, .vercel e .wrangler, e ignora qualquer arquivo acima de 1 MB. Cada linha é verificada contra 25 regras. Uma descoberta é impressa como arquivo:linha [id-da-regra] mensagem seguida por uma linha correção:. Código de saída 1 significa que algo foi encontrado, 0 significa que nada foi encontrado, 2 significa caminho ou uso incorreto. --self-test verifica o próprio scanner.
Como ele lê Markdown, também relata frases citadas em notas, relatórios, briefings e revisões anteriores. Ignore toda descoberta em um arquivo que não seja código-fonte da página: landing/*.md, READMEs, notas, arquivos review.md anteriores.
Trate cada descoberta como um convite para olhar, nunca como um veredito. Abra a linha, veja o que ela realmente contém e o que a página faz com isso, e só então decida. Descreva o que a regra correspondeu: um acerto de paleta em uma cor de tag não é uma descoberta sobre o fundo da página. Exemplos do que a olhada decide:
dead-anchorem um link de logotipo é uma falha menor de construção. Na chamada para ação principal, significa que a conversão não funciona: um bloqueador.overused-fontsignifica que uma fonte comum lidera a pilha. É uma descoberta apenas quandodirection.mdnão fornece motivo e a fonte não é combinada com uma fonte distinta para exibição ou mono.palette-cream-terracottadispara em dois valores hexadecimais exatos. Creme sozinho nunca é um indicador; o conjunto de creme, acento terracota e uma serifa da moda é.
Uma varredura limpa não prova nada. Alegações inventadas, uma página que fica em branco sem JavaScript, um pacote superdimensionado e uma chamada para ação que leva a um ID válido na página, mas nunca leva a uma compra, não deixam padrão no código-fonte. A maioria das falhas são ausências, contagens, contradições, composição e comportamento quebrado, que uma regex linha por linha não pode ver. Uma página pode passar pela varredura limpa e falhar em todas as outras passagens.
Então, após a varredura, leia o código-fonte você mesmo. As verificações a serem feitas pela leitura estão em references/rubric.md, marcadas como "código-fonte". As que mais capturam:
- O
<head>: título,lang, meta descrição, favicon, tags Open Graph. - Cada formulário: para onde ele envia, o que o manipulador faz com os dados e se a mensagem de sucesso aguarda o servidor.
- Cada
hrefde chamada para ação: para onde realmente leva. - Fontes: cada
font-familyé carregada por um@font-face, um link de folha de estilo ou uma importação de fonte de framework, ou é apenas uma pilha do sistema? - Cada alegação, número, nome, especificação e promessa na página, verificado contra o briefing. Cada asset que o briefing diz ter sido fornecido, verificado contra o que a página mostra.
- CSS que se cancela, como uma classe de contêiner cuja abreviação
paddingé mais específica que a regra da seção e redefine silenciosamente o padding vertical da seção para zero. Confirme no navegador lendo o padding calculado. prefers-reduced-motion: presente ou ausente, e o que faz.- O corpo do HTML compilado: se for uma
<div id="root">vazia sem<noscript>, a página fica em branco sem JavaScript.
Passagem visual
Você precisa de uma página renderizada. O scanner e o código-fonte não podem mostrar sobreposições, metades vazias de um layout, títulos quebrados, espaçamento colapsado ou texto sobreposto a uma cena 3D.
Sirva a página
Sempre revise via HTTP, HTML simples incluso. Várias verificações precisam de um servidor: caminhos de assets relativos à raiz (/styles.css, /assets/...) falham sobre file://, e a linha L7 da rubrica solicita um caminho ausente, /robots.txt e /sitemap.xml. Instale as dependências primeiro se node_modules estiver faltando.
- URL publicada: use-a diretamente.
- HTML e CSS simples: na pasta que contém
index.html, executepython3 -m http.server 8000e abrahttp://localhost:8000/. - Vite:
npm run build, depoisnpx vite preview(porta 4173 por padrão). - Astro:
npm run build, depoisnpx astro preview(porta 4321 por padrão). - Next.js:
npm run build, depoisnpm run start(porta 3000 por padrão). - Qualquer outra compilação: compile, depois execute o mesmo comando
python3 -m http.serverna pasta de saída.
Escreva a URL que você revisou em Passagens. Abra um caminho file:// apenas como último recurso, quando nada puder ser servido; então L7 não é executada, e qualquer asset com caminho relativo à raiz pode estar ausente apenas por esse motivo. Liste ambos em Passagens e não relate um asset ausente que o servidor teria encontrado.
Revise uma saída de compilação existente apenas quando ela estiver atualizada com o código-fonte. find src index.html -newer dist/index.html (com os caminhos de código-fonte e saída da stack) lista arquivos de código-fonte alterados desde a compilação; se listar algum, ou não houver compilação, recompile. Declare em Passagens qual você revisou e por quê.
Escolha o método de captura, nesta ordem
-
Uma ferramenta de navegador, se o ambiente tiver uma. Você precisa destas capacidades: navegar para uma URL, definir a largura da viewport, tirar uma captura de tela de página inteira, executar um script na página e emular recursos de mídia (esquema de cores, movimento reduzido) e JavaScript desligado.
-
O script de fallback, quando não houver ferramenta de navegador ou ela não puder capturar. Execute-o mesmo que lhe tenham dito que nenhum navegador está disponível: ele inicia seu próprio navegador através de
npxe pode funcionar de qualquer forma.node <skill-dir>/scripts/screenshot.mjs <url-ou-arquivo> landing/shots node <skill-dir>/scripts/screenshot.mjs <url-ou-arquivo> landing/shots --darkEle escreve
360.png,768.png,1280.pnge1440.png(com--dark,360-dark.pnge assim por diante), página inteira, após uma espera de 1,5 segundos, e imprime cada caminho de arquivo. Se falhar com "Executable doesn't exist", executenpx playwright install chromiume tente novamente. Falhou quando sai com código diferente de zero, imprimecapture failed at <largura>pxou não escreve imagem alguma. -
Nenhum funciona. Só então a passagem visual não foi executada. Faça a passagem estática e a leitura do código-fonte de qualquer forma, depois siga a regra de Veredito para
incompleto.
O fallback não pode executar scripts na página, emular movimento reduzido, desligar JavaScript ou WebGL ou rolar. Com ele, julgue o que puder das imagens, verifique movimento reduzido, JavaScript desligado e WebGL desligado lendo o código-fonte e liste em Passagens cada verificação que você não pôde executar ao vivo, com o motivo.
Capture todas as quatro larguras
Para cada largura, 360, 768, 1280 e 1440 (altura 800 é suficiente):
- Defina a largura, carregue a página, aguarde fontes e imagens.
- Confirme a largura real com a verificação de viewport em
references/snippets.md. Algumas ferramentas não encolherão uma janela abaixo de um mínimo e silenciosamente lhe darão uma página mais larga; use a emulação de dispositivo ou viewport da ferramenta e verifique novamente. - Tire uma captura de tela de página inteira em
landing/shots/. - Execute o script de medição de
references/snippets.mde leia suas advertências: estouro, elementos mais largos que a viewport, mudança de layout, contagem de canvas. - Role pela página no navegador ao vivo, de cima a baixo.
Em seguida, abra e leia cada imagem: todas as quatro larguras, e as escuras se você as tirou. Escreva uma linha por largura em suas notas dizendo o que você viu antes de prosseguir. Olhar duas larguras e assumir as outras é como falhas que aparecem apenas em algumas larguras são perdidas: um bloco estreito deixando metade da linha vazia apenas nas larguras grandes, ou links de seção ocultos sem menu apenas na mais estreita.
Se uma captura de página inteira falhar ou retornar cortada, o que acontece em páginas altas com canvas, capture a viewport no topo e em várias posições de rolagem (um quarto, metade, três quartos, o fundo) em cada largura e diga isso em Passagens. O script de fallback só tira capturas de página inteira; se falhar dessa forma, registre quais larguras estão faltando.
Capturas de página inteira de páginas com rolagem acionada podem mostrar faixas em branco onde seções de paralaxe ou fixas ficam fora da tela na posição de rolagem zero. Antes de relatar uma área em branco, role até ela na página ao vivo. Se renderizar lá, é um artefato de captura, não um defeito.
Procure por
Em cada largura, com a rubrica aberta:
- Rolagem horizontal, texto cortado, elementos sobrepostos, texto sobre imagem ou canvas onde se torna difícil de ler.
- Espaçamento: seções sem padding vertical, títulos rentes ao bloco acima, bordas que se projetam além do conteúdo.
- Composição: linhas meio vazias em 1280 e 1440, títulos que quebram em quatro linhas ou deixam uma única palavra na última linha, sobrancelhas, rótulos e botões que quebram em 360, cartões de altura irregular.
- Navegação em 360: os links de seção ainda estão acessíveis, os botões têm pelo menos 44 por 44 px, um cabeçalho fixo cobre o título?
- Ordem em 360: o produto está visível acima do formulário ou empurrado para baixo dele?
- Imagens: assets reais ou placeholders rotulados na proporção correta para assets que ainda não existem.
- Teclado: pressione Tab pela página uma vez em 1280. O foco deve ser ...
[continuado; as seções restantes seguem o mesmo padrão de tradução do markdown original, preservando blocos de código, comandos e caminhos de arquivo.]