Skill Aula Revisao Final

Skill Aula Revisão Final

Faça uma revisão com correção. Não entregue apenas uma lista de defeitos quando puder resolver o problema no projeto.

Preparação

1. Leia references/contrato-projeto.md.
2. Leia todos os artefatos .aula-site, DESIGN.md, package.json, index.html, src/, public/ e arquivos de ambiente documentados.
3. Leia references/checklist-final.md e references/anti-ai-generico.md.
4. Marque review como in_progress.
5. Preserve a oferta, a copy aprovada e a direção visual. Corrija texto somente quando houver erro, inconsistência, placeholder ou quebra de layout; não invente fatos.

Passagem 1 - diagnóstico determinístico

Execute o script incluído nesta skill, a partir da raiz do projeto:

node <diretorio-da-skill>/scripts/audit-site.mjs .

Leia o resultado; não trate regex como verdade absoluta. Confirme cada achado no código.

Depois execute:

npm run lint
npm run build

Se lint não existir, registre “não configurado”; não crie uma configuração complexa apenas para marcar a caixa. O build é obrigatório.

Passagem 2 - revisão visual e funcional

Quando houver browser ou screenshot, inspecione a página em aproximadamente:

• 390 × 844: celular;
• 768 × 1024: tablet;
• 1440 × 900: desktop.

Teste também teclado, foco e redução de movimento quando as ferramentas permitirem. Se não houver inspeção visual, declare a limitação em revisao.md.

Corrigir por prioridade

Bloqueadores

• build quebrado;
• página em branco, erro no console ou asset ausente;
• CTA principal sem destino;
• navegação apontando para ids inexistentes;
• WhatsApp com número fictício ou placeholder clicável;
• overflow horizontal sério;
• conteúdo ou botão inacessível no mobile;
• contraste que impede leitura;
• placeholder crítico de preço, contato ou claim tratado como dado real.

Alta prioridade

• hero sem clareza ou CTA fora da primeira viewport;
• headings fora de ordem;
• imagens informativas sem alt;
• formulário sem label, feedback ou validação básica;
• foco invisível;
• animação sem prefers-reduced-motion;
• imagem principal carregada de forma inadequada;
• imagens grandes sem dimensões reservadas;
• conteúdo coberto pelo botão flutuante;
• aparência claramente repetitiva ou genérica em conflito com DESIGN.md.

Acabamento

• ritmo, alinhamento, espaçamento e consistência de raio;
• estados hover, active e focus;
• copy duplicada ou quebrada;
• meta title, description e Open Graph coerentes;
• lazy loading abaixo da dobra;
• microinterações leves e motivadas;
• comentários e arquivos demonstrativos do Vite não utilizados.

Faça a menor correção que resolve a causa. Não reescreva a página inteira para corrigir um detalhe.

Imagens

Verifique tamanho em pixels, bytes, formato, alt, dimensões, loading e crop. Quando um raster estiver claramente maior que o necessário e sharp estiver disponível, use o script opcional:

node <diretorio-da-skill>/scripts/optimize-images.mjs .

O script cria WebP sem apagar originais. Atualize imports somente depois de comparar e confirmar a imagem nova. Se sharp não estiver instalado, decida se vale instalar como dependência de desenvolvimento; não bloqueie a aula para economias marginais.

Relatório

Crie .aula-site/revisao.md com:

• data e escopo;
• ferramentas e viewports realmente usadas;
• testes aprovados;
• problemas corrigidos, com arquivos;
• pendências que exigem informação real do usuário;
• limitações da revisão;
• resultado de lint e build;
• URL local confirmada;
• critério final: pronto localmente, pronto com pendências não críticas ou aguardando correção crítica.

Não use uma nota subjetiva para esconder falhas. Liste evidências.

Encerramento

1. Execute lint/build novamente após as correções.
2. Inicie ou confirme o servidor local e teste a URL.
3. Marque review como complete somente se não houver bloqueador.
4. Quando faltar dado crítico real, marque awaiting_user e diga exatamente qual dado inserir.
5. Informe os principais consertos, a URL local e o caminho de revisao.md.

Não faça deploy. A próxima etapa de publicação pertence a outra aula.