Diretor de Finalização de Websites
Auditoria estruturada de finalização de website em 5 passagens — da primeira impressão à prontidão para lançamento — pontuada em 100 pontos. Como pintura: primer, base, detalhes, verniz, inspeção final. Nenhum site é lançado sem uma passagem de finalização.
Quando Usar Esta Habilidade
- 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 reforma visual, verifique se nada regrediu
- Entrega para cliente — Gere um relatório estruturado comprovando que o site atende aos padrões de qualidade
- Manutenção trimestral — Capture dívida de UX acumulada, links quebrados, conteúdo desatualizado
- Passagem direcionada — Execute apenas uma passagem (ex.: "Somente 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 — Linha de base de cabeçalhos de segurança
- Oli Gardner / Unbounce — Melhores práticas de conversão de landing pages
- Don Norman — Design Emocional (camadas visceral/comportamental/reflexiva)
- Memória de produção GUIA — 8 sites lançados, problemas documentados em Next.js, Framer Motion, GSAP, Lenis, Railway, Docker
Princípio Central: Um site que passa no Lighthouse e tem meta tags corretas é tecnicamente válido, mas não finalizado. Finalizar é a lacuna entre "funciona" e "está pronto". Requer 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 habilidade é essa ferramenta.
O Que Claude Faz vs. O Que Você Decide
"Claude executa a auditoria. Você decide o que sai."
| Claude lida com | Você fornece |
|---|---|
| Executar cada passagem sistematicamente contra a lista de verificação | A URL ativa ou acesso ao código-fonte |
| Pontuar cada checkpoint com justificativa | Contexto: posicionamento da marca, público-alvo, cronograma de lançamento |
| Classificar problemas como P0/P1/P2 | Decisões de substituição (ex.: "P1 é aceitável para MVP") |
| Gerar o relatório final com sugestões de correção | Julgamento final Go/No-Go |
| Sinalizar problemas 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 workflow de centauro. Claude estrutura a auditoria rigorosamente; você valida o veredito com olhos humanos em dispositivos reais.
O Que Esta Habilidade 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), fundamentos 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 móvel
- 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 de navegadores, prévias 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 website (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 — fundamento antes do polimento. Pontue cada checkpoint, 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 única ou página de produto |
| Site Completo | 1, 2, 3, 4, 5 | Site de várias páginas com navegação, formulários e conteúdo |
| E-commerce | 2, 3, 5 | Loja com carrinho, checkout e páginas de produto |
Ajuste os totais de pontos proporcionalmente ao usar um perfil reduzido. Os limites de Go/No-Go 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, requer 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ícitos, mas não explícitos
[ ] 1 — Genérico ("todos")
[ ] 0 — Ativamente confuso (sinais para o 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 recursos, mas compreensível
[ ] 1 — Presente, mas enterrado
[ ] 0 — Nenhuma proposta de valor visível
### 4. O QUE faço em seguida? (3 pts)
O CTA principal está visível e claro?
[ ] 3 — CTA visível acima da dobra, texto específico da 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 se sente? (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 perceptí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 o sentimento 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 GUIA para esta passagem:
- URL do Calendly codificada 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
### Fundamentos 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) Sem links internos quebrados (404s)
- [ ] (1 pt) Sem links externos quebrados
- [ ] (1 pt) Nenhum source map ou endpoint de depuração exposto em produção
### Pontuação da Passagem 2: ___/25
Veredito:
- 21-25: SÓLIDO — Pode lançar
- 16-20: ACEITÁVEL — Corrigir P0s, lançar com backlog de P1
- 11-15: FRÁGIL — Dívida técnica significativa
- <11: QUEBRADO — Não lance
Problemas 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 variáveis de ambiente faltam — inicialize de forma preguiçosa dentro de funções
- Variáveis de ambiente do Vercel com nova linha no final de
echo— useprintfem vez disso - Nomes de host
*.railway.internaldo Railway inacessíveis durante a 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 do lado do cliente com mensagens de erro claras
- [ ] (1 pt) Validação do lado do servidor (não apenas 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 da 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 rolagem (sem repetir 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 Móvel (5 pts)
- [ ] (1 pt) Alvos de toque ≥ 44px (padrão iOS HIG)
- [ ] (1 pt) Sem transbordamento horizontal / rolagem horizontal
- [ ] (1 pt) Tamanhos de fonte ≥ 16px para texto do corpo (evita zoom do iOS)
- [ ] (1 pt) Elementos fixos/sticky não sobrepõem conteúdo
- [ ] (1 pt) Comportamento de rolagem funciona corretamente (sem sequestro de rolagem que prenda 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 GUIA para esta passagem:
- GSAP + React 18 Strict Mode dispara animações 2x no 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 desempenho móvel - 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 à 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 headings é lógica (H1 → H2 → H3, um H1 por página)
- [ ] (1 pt) Texto alternativo é descritivo (não "imagem1.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 (a mesma pessoa "falando")
- [ ] (1 pt) Nenhum marcador de suavização de IA ("Não hesite em nos contatar", "No mundo acelerado de hoje", "É importante notar 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, heading, body, caption — máximo 2-3 fontes)
- [ ] (1 pt) Ritmo de espaçamento consistente (sem padding aleatório entre seções)
- [ ] (1 pt) Estilo de ícone uniforme (não misture outline, filled e emoji)
- [ ] (1 pt) Tratamento de imagem consistente (todas as fotos com o mesmo filtro/tom, ou todas ilustrações)
- [ ] (1 pt) Estilo de componente consistente (cards, botões, inputs seguem o mesmo padrão)
### Pontuação da Passagem 4: ___/20
Veredito:
- 17-20: POLIDO — Conteúdo finalizado e alinhado à marca
- 13-16: BOM — Inconsistências menores, pode lançar
- 9-12: RÚSTICO — Conteúdo precisa de revisão
- <9: INACABADO — Lacunas de conteúdo principais ou incompatibilidade de marca
Problemas 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 texto credou.bzh: mecanismo primeiro, sem CV, sem parcours/timeline
Passagem 5: Entre Dispositivos e Lançamento (15 pontos)
"Funciona em todos os lugares, e está tudo pronto para entrar no ar?"
## Passagem 5 — Entre Dispositivos e Lançamento
### Testes de Navegador (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 importantes
Por navegador, verifique: layout, animações, fontes, formulários, comportamento de rolagem.
Deduza 1 pt por navegador com bugs visuais. Deduza 2 pts por navegador com bugs funcionais.
### Testes de Dispositivo (4 pts)
- [ ] (2 pts) Mobile (375px) — site completo usável, sem problemas de layout
- [ ] (1 pt) Tablet (768px) — layouts responsivos funcionam
- [ ] (1 pt) Desktop grande (1920px+) — conteúdo não estica excessivamente, larguras máximas implementadas
### Prontidão para Lançamento (6 pts)
- [ ] (1 pt) Página 404 personalizada com navegação (não erro genérico do servidor)
- [ ] (1 pt) Favicon presente (incluindo SVG para modo escuro)
- [ ] (1 pt) Pré-visualizações OG funcionais (Facebook, LinkedIn, Twitter, Discord)
- [ ] (1 pt) Analytics instalado e disparando corretamente (sem vazamentos de PII)
- [ ] (1 pt) Redirecionamentos configurados (www para não-www, HTTP para HTTPS)
- [ ] (1 pt) Página de manutenção ou modo de construção desativado
### Pontuação da Passagem 5: ___/15
Veredito:
- 13-15: PRONTO — Pode lançar
- 10-12: QUASE — Um ou dois itens precisam de verificação final
- 7-9: ARRISCADO — Vários problemas podem causar má impressão no lançamento
- <7: NÃO PRONTO — Resolva os bloqueadores antes de lançar
Problemas GUIA para esta passagem:
- Image OG:
- Largura mínima 1200px (Discord falha silenciosamente com imagens menores)
- Proporção 1,91:1 (1200×627) para LinkedIn (não use 1200×630)
- Fontes: Carregar woff/woff2 do diretório público (não Google Fonts em produção) — queda de DNS no Railway se o Google estiver inacessível durante a build (documentado em Lerua, nov. 2025)
- Favicon: SVG + fallback .ico; ambos devem ser servidos com cabeçalho
Content-Typecorreto - Analytics:
- Verificar rastreamento de CTA com navegação (cliques podem ser perdidos se a página mudar antes do beacon)
- Usar
navigator.sendBeacon()para eventos de saída
Relatório Final
Sumário
| Passagem | Pontuação | Máximo | % |
|---|---|---|---|
| 1. Primeira Impressão | 15 | ||
| 2. Base Técnica | 25 | ||
| 3. Completude de UX | 25 | ||
| 4. Conteúdo & Marca | 20 | ||
| 5. Entre Dispositivos & Lançamento | 15 | ||
| Total | 100 |
Veredito
- ≥ 85%: APROVADO — Pronto para lançar. Corrija P0s, considere P1s.
- 70-84%: APROVADO COM RESSALVAS — Corrigir P0s, documentar P1s para o backlog. Lançamento permitido com aprovação.
- 50-69%: REPROVADO — Dívida técnica ou UX significativa. Não lance sem correções.
- < 50%: NÃO LANÇÁVEL — O site precisa de trabalho fundamental antes de ser apresentado a usuários reais.
Por que esses limites?
- 85% (= ~17 de 20 na escala de produto): Onde "bom o suficiente" se torna "pronto para primeiros usuários reais". P0s resolvidos, P1s documentados, nenhum constrangedor.
- 70%: Mínimo para stakeholders verem. Pode mostrar, mas não vender.
- 50%: Linha dura para qualquer tráfego pago ou indexação pública.
Decisão Final
Com base na auditoria acima, este site está:
- APROVADO — Lançar
- APROVADO COM RESSALVAS — Lançar após correções P0
- REPROVADO — Não lançar até nova auditoria
Checklist de Pré-Lançamento
- [ ] P0s resolvidos
- [ ] Backlog P1 documentado
- [ ] Validação em dispositivo real concluída (Safari + iOS + Android)
- [ ] Stakeholder aprovou o relatório
- [ ] Analytics verificado
- [ ] Redirecionamentos configurados
- [ ] CNAME/SSL verificado
- [ ] Modo de manutenção desativado
- [ ] Backup do pré-lançamento armazenado
Exemplo de Uso
Você: Estou prestes a lançar meu portfólio em https://meuportfolio.com. Execute uma auditoria completa de diretor de finalização de website. Quadrante da marca: Frio+Ativo. Público-alvo: gerentes de contratação de design.
Claude: Executando auditoria de 5 passagens em https://meuportfolio.com...
[Claude executa cada passagem, pontua cada checkpoint, classifica problemas e gera o relatório final.]
Claude: Resultado: 78/100 (APROVADO COM RESSALVAS)
P0s para corrigir:
- Meta description ausente na página Sobre
- Falha na imagem OG para Discord (redimensionar para 1200px de largura)
- Link quebrado no rodapé (aponta para página de projetos excluída)
P1s para documentar:
- Animação de rolagem é repetida ao rolar para trás (adicionar
once: true)- Tamanho do texto do corpo 15px no mobile (aumentar para 16px)
Seu veredito: Lançar após corrigir P0s, resolver P1s nesta semana.
Configuração de Ferramentas para os Usuários
Para obter os melhores resultados desta auditoria, prepare o seguinte antes de começar:
- Ferramenta de medição de desempenho — PageSpeed Insights ou Web Vitals do Chrome DevTools
- Validador de segurança — securityheaders.com
- Validador de dados estruturados — Validador de Rich Results do Google
- Teste de pré-visualização OG — opengraph.xyz
- Verificador de links quebrados — Extensão Chrome Check My Links ou ferramenta CLI
broken-link-checker
Por Que 100 Pontos?
100 pontos é intencional — não por ser um número redondo, mas porque:
- Mapeia para uma escala percentual familiar (0-100)
- Cada passagem tem peso proporcional à sua importância no resultado final:
- Primeira Impressão: 15% — Oportunidade inicial, mas não a história completa
- Base Técnica: 25% — Sem isso, nada mais importa
- Completude de UX: 25% — Onde a qualidade diária é sentida
- Conteúdo e Marca: 20% — O que faz as pessoas se importarem
- Entre Dispositivos e Lançamento: 15% — Polimento final e preparação para o mundo real
- Atingir 100 é quase impossível — e deveria ser. Assim como nenhum software está isento de bugs, nenhum site é perfeitamente finalizado. O objetivo é > 85.
Notas de Versão
v1.1 — Atualização de Março de 2026
- Adicionadas as 5 perguntas da Passagem 1 com pontuação de verificação de 3 pontos cada
- Esclarecido que o veredito se aplica à pontuação percentual, não aos pontos brutos, para perfis reduzidos
- Adicionada recomendação de ferramenta
broken-link-checkercomo alternativa CLI
v1.0 — Lançamento Inicial
- Estrutura de finalização de 5 passagens com pesos de 100 pontos
- Problemas GUIA documentados de 8 lançamentos de sites reais
- Perfis de auditoria (Landing Page / Site Completo / E-commerce)
- Limites de Go/No-Go em 85%, 70%, 50%
Construído a partir de ciclos de entrega reais na GUIA, onde cada site enfrentou problemas que ferramentas automatizadas não capturam. Sem teoria — apenas checklists que salvariam horas se tivéssemos tido elas mais cedo.