O que Diretor de Finalização de Websites faz?
Auditoria de finalização de websites estruturada em 5 passagens — da primeira impressão à prontidão para lançamento — pontuada em 100 pontos. Como pintura: primer, demão base, detalhes, verniz, inspeção final. Nenhum site é lançado sem uma passagem de finalização.
Quando Usar Esta Skill
- Portão de pré-lançamento — Validação final antes do DNS entrar no ar ou do tráfego ser enviado
- Auditoria pós-redesign — Após uma reformulação visual, verifique se nada regrediu
- Entrega ao cliente — Gere um relatório estruturado provando que o site atende aos padrões de qualidade
- Manutenção trimestral — Capture dívidas de UX acumuladas, links quebrados, conteúdo desatualizado
- Passagem direcionada — Execute apenas uma passagem (ex.: "Apenas Passagem 2" após um sprint de desempenho)
Fundamentação Metodológica
Fontes:
- Nielsen Norman Group — Estrutura de avaliação heurística (10 heurísticas de usabilidade)
- Google Web Vitals — Limiares de LCP, CLS, INP
- OWASP — Base de cabeçalhos de segurança
- Oli Gardner / Unbounce — Melhores práticas de conversão em landing pages
- Don Norman — Design Emocional (camadas visceral/comportamental/reflexiva)
- Memória de produção GUIA — 8 websites lançados, problemas documentados em Next.js, Framer Motion, GSAP, Lenis, Railway, Docker
Princípio Central: Um website que passa no Lighthouse e possui meta tags corretas é tecnicamente válido, mas não está finalizado. Finalização é a lacuna entre "funciona" e "está pronto". Exige avaliar o site como um visitante o experimenta — progressivo, emocional, entre dispositivos — não como uma lista de verificação de métricas individuais.
Por Que Isso Importa: Ferramentas existentes (Lighthouse, Screaming Frog, Awwwards) auditam uma dimensão cada. Nenhuma ferramenta combina polimento visual + completude de UX + base técnica + qualidade de conteúdo + alinhamento de marca em um fluxo de trabalho sequencial e pontuado. Esta skill é essa ferramenta.
O Que Claude Faz vs O Que Você Decide
"Claude executa a auditoria. Você decide o que é lançado."
| Claude lida | Você fornece |
|---|---|
| Executar cada passagem sistematicamente contra a lista de verificação | A URL ativa ou acesso ao código-fonte |
| Pontuar cada ponto de verificação com justificativa | Contexto: posicionamento de marca, público-alvo, cronograma de lançamento |
| Classificar problemas como P0/P1/P2 | Decisões de anulação (ex.: "P1 é aceitável para MVP") |
| Gerar o relatório final com sugestões de correção | Julgamento final de Ir/Não Ir |
| Sinalizar problemas conhecidos da pilha GUIA a partir da memória de produção | Validação em dispositivos reais (Claude não pode abrir o Safari) |
Lembre-se: Este é um fluxo de trabalho centauro. Claude estrutura a auditoria rigorosamente; você valida o veredito com olhos humanos em dispositivos reais.
O Que Esta Skill Faz
- Teste de Primeira Impressão de 5 Segundos — Avalia clareza, adequação emocional e visibilidade do CTA nos primeiros momentos
- Auditoria de Base Técnica — Desempenho (Core Web Vitals), conceitos básicos de SEO, cabeçalhos de segurança, links quebrados
- Verificação de Completude de UX — Estados de componentes, comportamento de formulários, polimento de animações, usabilidade mobile
- Validação de Conteúdo e Marca — Qualidade do texto, detecção de placeholders, consistência de voz, coerência visual
- Prontidão Entre Dispositivos e Lançamento — Testes em navegadores, prévias de OG, analytics, página 404, favicon
Como Usar
Auditoria completa do site antes do lançamento
Estou prestes a lançar [URL do site]. Execute uma auditoria completa de diretor-de-finalização-de-websites (todas as 5 passagens).
Quadrante da marca: [Quente+Calmo / Quente+Ativo / Frio+Ativo / Frio+Calmo].
Público-alvo: [quem].
Passagem única após uma correção específica
Acabei de otimizar o desempenho de [URL do site]. Execute apenas a Passagem 2 (Base Técnica).
Auditoria rápida de landing page
Audite esta landing page: [URL]. Use o perfil de Landing Page (passagens 1, 2, 4).
Instruções
Ao executar esta auditoria, siga as 5 passagens em ordem. Cada passagem se baseia na anterior — fundação antes do polimento. Pontue cada ponto de verificação, classifique os problemas por prioridade e, em seguida, gere o relatório final.
Perfis de Auditoria
Nem todo site precisa de todas as 5 passagens. Selecione o perfil que corresponde ao projeto:
| Perfil | Passagens | Quando usar |
|---|---|---|
| Landing Page | 1, 2, 4 | Página de campanha ou produto única |
| Site Completo | 1, 2, 3, 4, 5 | Site com várias páginas, navegação, formulários, conteúdo |
| E-commerce | 2, 3, 5 | Loja com carrinho, checkout, páginas de produto |
Ajuste os totais de pontos proporcionalmente ao usar um perfil reduzido. Os limites de Ir/Não Ir se aplicam à pontuação percentual, não aos pontos brutos.
Passagem 1: Primeira Impressão (15 pontos)
"O que um visitante entende e sente em 5 segundos?"
Mostre a página inicial (ou seção hero) por 5 segundos. Responda a estas 5 perguntas — 3 pontos cada:
## Passagem 1 — Primeira Impressão (Teste de 5 Segundos)
### 1. O QUE é isso? (3 pts)
Um visitante consegue identificar o que o site/produto/serviço É?
[ ] 3 — Imediatamente claro, sem ambiguidade
[ ] 2 — Claro após ler o subtítulo
[ ] 1 — Vago, exige rolagem para entender
[ ] 0 — Nenhuma ideia do que é
### 2. PARA QUEM é? (3 pts)
Existem sinais identificando o público-alvo?
[ ] 3 — Sinais demográficos/psicográficos óbvios
[ ] 2 — Implícito, mas não explícito
[ ] 1 — Genérico ("todos")
[ ] 0 — Ativamente confuso (sinais de público errado)
### 3. POR QUE devo me importar? (3 pts)
A proposta de valor ou benefício está visível?
[ ] 3 — Benefício claro, emocionalmente ressonante
[ ] 2 — Focado em funcionalidades, mas compreensível
[ ] 1 — Presente, mas enterrado
[ ] 0 — Nenhuma proposta de valor visível
### 4. O QUE faço a seguir? (3 pts)
O CTA principal está visível e claro?
[ ] 3 — CTA visível acima da dobra, texto específico para a ação
[ ] 2 — CTA presente, mas genérico ("Saiba mais")
[ ] 1 — CTA abaixo da dobra ou difícil de encontrar
[ ] 0 — Nenhum CTA visível
### 5. COMO me sinto? (3 pts)
O tom emocional corresponde ao quadrante da marca?
[ ] 3 — Correspondência perfeita de quadrante (marca quente = design quente)
[ ] 2 — Principalmente alinhado, dissonância menor
[ ] 1 — Incompatibilidade notável (marca quente + design frio)
[ ] 0 — Quadrante oposto (confusão de posicionamento)
### Pontuação da Passagem 1: ___/15
Veredito:
- 12-15: APROVADO — Primeira impressão é clara e emocionalmente alinhada
- 8-11: PRECISA DE TRABALHO — Visitante entende, mas lentamente ou com atrito
- <8: REPROVADO — Redesenhe a experiência acima da dobra
Integração: Compare a sensação emocional com o sistema de quadrantes do web-design-director. Se a marca é Quente+Calma mas o site parece Frio+Ativo, isso é um P0 independentemente da pontuação.
Problemas conhecidos da GUIA para esta passagem:
- URL do Calendly hardcoded no CTA em vez da página
/contact/(quebra analytics) - Misturar tom de texto caloroso com elementos de UI frios (paleta terracota + fonte monoespaçada = confusão)
Passagem 2: Base Técnica (25 pontos)
"A infraestrutura é sólida o suficiente para construir em cima?"
## Passagem 2 — Base Técnica
### Desempenho (10 pts)
| Métrica | Alvo | Pontuação |
|--------|------|-----------|
| LCP (Largest Contentful Paint) | ≤ 2,5s | 0-3 pts |
| INP (Interaction to Next Paint) | ≤ 200ms | 0-2 pts |
| CLS (Cumulative Layout Shift) | ≤ 0,1 | 0-2 pts |
| Pontuação de Desempenho Lighthouse | ≥ 85 | 0-3 pts |
Pontuação:
- LCP: 3 = ≤2,5s, 2 = ≤4,0s, 1 = ≤6,0s, 0 = >6,0s
- INP: 2 = ≤200ms, 1 = ≤500ms, 0 = >500ms
- CLS: 2 = ≤0,1, 1 = ≤0,25, 0 = >0,25
- Lighthouse: 3 = ≥90, 2 = ≥85, 1 = ≥70, 0 = <70
### Conceitos Básicos de SEO (8 pts)
- [ ] (2 pts) URLs canônicas definidas + barra final consistente
- [ ] (1 pt) Meta titles únicos por página (≤60 caracteres)
- [ ] (1 pt) Meta descriptions presentes por página (≤160 caracteres)
- [ ] (1 pt) Sitemap.xml acessível e válido
- [ ] (1 pt) robots.txt presente e correto
- [ ] (1 pt) Dados estruturados presentes (JSON-LD)
- [ ] (1 pt) Texto alternativo em todas as imagens
### Segurança e Links (7 pts)
- [ ] (2 pts) HTTPS aplicado (sem conteúdo misto)
- [ ] (2 pts) Cabeçalhos de segurança presentes (CSP, X-Frame-Options, HSTS, X-Content-Type-Options)
- [ ] (1 pt) Nenhum link interno quebrado (404s)
- [ ] (1 pt) Nenhum link externo quebrado
- [ ] (1 pt) Nenhum source map exposto ou endpoints de debug em produção
### Pontuação da Passagem 2: ___/25
Veredito:
- 21-25: SÓLIDO — Pode lançar
- 16-20: ACEITÁVEL — Corrija P0s, lance com backlog de P1
- 11-15: FRÁGIL — Dívida técnica significativa
- <11: QUEBRADO — Não lance
Problemas conhecidos da GUIA para esta passagem:
trailingSlash: trueausente emnext.config.js(causou desindexação no Rental-CRM, Jan 2026)export const metadataem um componente'use client'(metadados não renderizados no servidor)- Inicialização de SDK em nível de módulo (Supabase/Stripe) falha na build quando var de ambiente ausente — inicialize de forma lazy dentro de funções
- Quebra de linha extra em var de ambiente do Vercel a partir de
echo— useprintf - Hostnames
*.railway.internaldo Railway inalcançáveis durante build Nixpacks — use URLs públicas
Passagem 3: Completude de UX (25 pontos)
"O site lida com o uso no mundo real, não apenas com o caminho feliz?"
## Passagem 3 — Completude de UX
### Estados de Componentes (8 pts)
Para CADA componente interativo (botões, cards, formulários, modais, listas):
- [ ] (2 pts) Estado de carregamento — skeleton, spinner ou renderização progressiva
- [ ] (2 pts) Estado de erro — mensagem clara + ação de recuperação
- [ ] (2 pts) Estado vazio — mensagem útil, não tela em branco
- [ ] (2 pts) Estado de sucesso — feedback de confirmação
Pontuação: deduza por estado ausente em todos os componentes.
8 pts = todos os estados cobertos. -1 por estado ausente (limite em 0).
### Formulários (6 pts)
- [ ] (1 pt) Validação no lado do cliente com mensagens de erro claras
- [ ] (1 pt) Validação no lado do servidor (não apenas no cliente)
- [ ] (1 pt) Feedback de sucesso após o envio (toast, redirecionamento ou inline)
- [ ] (1 pt) Botão de envio desabilitado durante o processamento (sem envio duplicado)
- [ ] (1 pt) Proteção contra spam (honeypot, reCAPTCHA ou limitação de taxa)
- [ ] (1 pt) Link para política de privacidade próximo ao formulário (GDPR)
### Polimento de Animações (6 pts)
- [ ] (1 pt) `viewport={{ once: true }}` em animações de scroll (sem repetição ao rolar para trás)
- [ ] (1 pt) Hook `useGSAP` usado (não `useEffect`) para animações GSAP
- [ ] (1 pt) `prefers-reduced-motion` respeitado (desabilitar ou reduzir animações)
- [ ] (1 pt) Nenhuma animação bloqueia o acesso ao conteúdo (conteúdo visível mesmo se a animação falhar)
- [ ] (1 pt) Lenis inicializado corretamente (não Locomotive Scroll)
- [ ] (1 pt) Animações de saída não causam mudança de layout
### Usabilidade Mobile (5 pts)
- [ ] (1 pt) Alvos de toque ≥ 44px (padrão iOS HIG)
- [ ] (1 pt) Nenhum overflow horizontal / scroll horizontal
- [ ] (1 pt) Tamanhos de fonte ≥ 16px para texto do corpo (previne zoom do iOS)
- [ ] (1 pt) Elementos fixos/sticky não se sobrepõem ao conteúdo
- [ ] (1 pt) Comportamento de scroll funciona corretamente (sem scroll-jacking que aprisiona usuários)
### Pontuação da Passagem 3: ___/25
Veredito:
- 21-25: COMPLETO — Uso no mundo real coberto
- 16-20: QUASE LÁ — Casos de borda precisam de atenção
- 11-15: INCOMPLETO — Usuários encontrarão becos sem saída
- <11: INACABADO — UX não está pronta para produção
Problemas conhecidos da GUIA para esta passagem:
- GSAP + React 18 Strict Mode dispara animações 2x em dev (use
useGSAP, nãouseEffect) - CSS global
a { color: var(--color-coral) }sobrescrevetext-whitedo Tailwind em CTAs de âncora — usestyle={{ color: 'white' }}inline - Animações de saída do Framer Motion
AnimatePresencequebram com o App Router do Next.js - Muitas instâncias simultâneas de
ScrollTriggermatam o desempenho mobile - Nome do pacote Lenis:
npm install lenis(NÃO@studio-freight/lenis)
Passagem 4: Conteúdo e Marca (20 pontos)
"O conteúdo está finalizado, consistente e alinhado com a marca?"
## Passagem 4 — Conteúdo e Marca
### Qualidade do Texto (8 pts)
- [ ] (2 pts) Nenhum texto placeholder detectado ("Lorem ipsum", "[Seu Nome]", "Em breve",
"example.com", "TODO", seções vazias)
- [ ] (1 pt) Nenhum erro de ortografia ou gramática
- [ ] (1 pt) Texto do link é descritivo (não "clique aqui" ou URLs nuas)
- [ ] (1 pt) Texto do CTA é específico ("Inicie teste grátis" não "Enviar")
- [ ] (1 pt) Hierarquia de cabeçalhos é lógica (H1 → H2 → H3, um H1 por página)
- [ ] (1 pt) Texto alternativo é descritivo (não "image1.png" ou vazio)
- [ ] (1 pt) Números de telefone, e-mails, endereços são reais (não placeholder)
### Voz da Marca (6 pts)
- [ ] (2 pts) Tom corresponde ao posicionamento da marca (quente/frio, formal/casual)
- [ ] (2 pts) Voz é consistente em todas as páginas (mesma pessoa "falando")
- [ ] (1 pt) Nenhum marcador de suavização de IA ("Não hesite em nos contatar",
"No mundo acelerado de hoje", "É importante observar que")
- [ ] (1 pt) CTAs correspondem ao quadrante emocional (marca quente = CTA convidativo, não agressivo)
### Consistência Visual (6 pts)
- [ ] (1 pt) Paleta de cores usada consistentemente (sem cores fora da marca)
- [ ] (1 pt) Hierarquia tipográfica clara (display, cabeçalho, corpo, legenda — max 2-3 fontes)
- [ ] (1 pt) Ritmo de espaçamento consistente (não padding aleatório entre seções)
- [ ] (1 pt) Estilo de ícones uniforme (não misture contorno, preenchido e emoji)
- [ ] (1 pt) Tratamento de imagem consistente (todas as fotos mesmo filtro/tom, ou todas ilustrações)
- [ ] (1 pt) Estilo de componente consistente (cards, botões, inputs seguem mesmo padrão)
### Pontuação da Passagem 4: ___/20
Veredito:
- 17-20: POLIDO — Conteúdo está finalizado e alinhado com a marca
- 13-16: BOM — Inconsistências menores, pode lançar
- 9-12: RÍSPIDO — Conteúdo precisa de revisão
- <9: INACABADO — Grandes lacunas de conteúdo ou incompatibilidade de marca
Problemas conhecidos da GUIA para esta passagem:
- URL do Calendly deve corresponder ao profissional correto (Valeria vs Matthieu vs cliente)
- Misturar texto caloroso ("Entendemos seus desafios") com UI fria (modo escuro, monoespaçada, cantos afiados)
- Detecção de texto gerado por IA: remova quebras de linha duplas antes de publicar (assinatura de IA no LinkedIn)
- Direção de copy do credou.bzh: mecanismo primeiro, sem CV, sem parcours/linha do tempo
Passagem 5: Entre Dispositivos e Lançamento (15 pontos)
"Funciona em todos os lugares e está tudo pronto para ir ao ar?"
## Passagem 5 — Entre Dispositivos e Lançamento
### Testes em Navegadores (5 pts)
Teste nos 3 principais navegadores. Pontue por navegador:
- [ ] (2 pts) Safari — renderiza corretamente, animações funcionam, fontes carregam
- [ ] (2 pts) Chrome — renderiza corretamente, animações funcionam, fontes carregam
- [ ] (1 pt) Firefox — renderiza corretamente, sem quebras maiores
Por navegador, verifique: layout, animações, fontes, formulários, comportamento de scroll.
Deduza 1 pt por navegador com bugs visuais. Deduza 2 pts por navegador com bugs funcionais.
### Testes em Dispositivos (4 pts)
- [ ] (2 pts) Mobile (375px) — site completo utilizável, sem overflow horizontal, alvos de toque ≥ 44px
- [ ] (1 pt) Tablet (768px) — layout adaptável, sem conteúdo espremido
- [ ] (1 pt) Desktop (1440px+) — layout responsivo usa espaço, seções não parecem vazias
### Metadados Sociais (3 pts)
- [ ] (1 pt) Open Graph tags presentes (og:title, og:description, og:image, og:url)
- [ ] (1 pt) Twitter Cards presentes (card type, site, title, description, image)
- [ ] (1 pt) Prévia OG parece boa (imagem legível, título trunca corretamente)
### Prontidão de Lançamento (3 pts)
- [ ] (1 pt) Página 404 personalizada (não página 404 genérica do servidor)
- [ ] (1 pt) Favicon presente (e visível em abas do navegador, favoritos)
- [ ] (1 pt) Analytics/código de rastreamento ativo e sem vazamento de dados de dev
### Pontuação da Passagem 5: ___/15
Veredito:
- 12-15: PRONTO PARA LANÇAR — Todas as verificações passam
- 9-11: QUASE PRONTO — Problemas menores, resolva antes de lançar
- 6-8: RISCO — Bugs entre dispositivos ou falta de metadados
- <6: NÃO PRONTO — Teste e corrija antes de lançar
Problemas conhecidos da GUIA para esta passagem:
- Imagens OG com texto são ilegíveis em esboços dark mode do Slack e iMessage
- Favicon 16px sendo servido, mas plataformas modernas exigem 32px + 180px (Apple touch icon)
- Página 404 que ainda retorna código de status 200 (confunde crawlers)
- Google Tag Manager dataLayer enviando URLs de staging/localhost (polui analytics)
- Caminhos de favicon com hash de build — funciona, mas sem hash de cache, o Safari o perde na atualização
Geração do Relatório Final
Após executar todas as passagens (ou as selecionadas), compile:
Relatório Estruturado
# Relatório de Finalização: [Nome do Projeto / URL]
## Perfil de Auditoria: [Landing Page / Site Completo / E-commerce]
## Data: [YYYY-MM-DD]
## Pontuação Resumida
| Passagem | Pontos Obtidos | Total Disponível | % |
|-----------|-------------|-----------------|---|
| 1. Primeira Impressão | X | 15 | X% |
| 2. Base Técnica | X | 25 | X% |
| 3. Completude de UX | X | 25 | X% |
| 4. Conteúdo e Marca | X | 20 | X% |
| 5. Entre Dispositivos e Lançamento | X | 15 | X% |
| **Total** | **X** | **100** | **X%** |
## Limiar de Ir/Não Ir
- **Pontuação total**: X/100 (X%)
- **Veredito**: [APROVADO / APROVADO COM RESSALVAS / REPROVADO]
- ≥ 80%: APROVADO — Pronto para lançamento
- 60-79%: APROVADO COM RESSALVAS — Lance após correção de P0s
- < 60%: REPROVADO — Não lance; reavalie após correções
## Problemas por Prioridade
### P0 (Bloqueador de Lançamento)
- [Passagem 1] Quadrante de marca: site parece frio+ativo, marca é quente+calma
### P1 (Alta Prioridade)
- [Passagem 2] LCP: 3.2s (alvo 2.5s) — otimize imagem hero
### P2 (Média Prioridade)
- [Passagem 4] Texto alt ausente na 3ª imagem da galeria
## Recomendações por Passagem
### Passagem 1 — Primeira Impressão
> Recomendações específicas...
### Passagem 2 — Base Técnica
> Recomendações específicas...
...
Nota Final
Esta skill usa uma heurística de sites reais. Não substitui testes com usuários ou verificação manual de dispositivos. Mas garante que nenhum site saia com uma barra final ausente, um CTA Calendly quebrado ou um esboço de 404.
Inspirado por uma década de websites lançados — bons, maus e feios.