⚠️ LEIA PRIMEIRO:
PNPM_11_REQUIREMENTS.mdneste diretório do skill. Os contêineres Webdev (onde Mike pré-visualiza seus sites) executam pnpm 11.1.1 desde 2026-05-13. TODO novo projeto DEVE declararpnpm.onlyBuiltDependenciesno package.json (no mínimo:["sharp"]para qualquer projeto Next.js) ou o servidor de desenvolvimento NÃO INICIARÁ. Ignore isso e o contêiner entra em loop de reinicialização, o site retorna 502, e o usuário culpa você. Leitura de 60 segundos; ignore por sua conta e risco.
Construtor de Sites — Skill Completo para Next.js
Construção de sites orientada por pesquisa e intencional no design. Cada decisão apoiada por dados, cada seção justificada pela pesquisa.
Quando Usar Este Skill
ACIONE quando o usuário pedir para:
- Construir um novo site
- Criar um site para o negócio dele
- Iniciar um novo projeto web
- "Fazer um site para mim"
NÃO USE para:
- Páginas Canvas (use o skill
canvas-web-design) - Editar um projeto de site existente (siga o
.claude/CLAUDE.mddesse projeto) - Projetos de vídeo Remotion (use o skill
remotion-video)
REGRAS INEGOCIÁVEIS
- NUNCA escreva código antes de concluir a pesquisa e o planejamento de design. As Fases 1-4 produzem zero código. Isso está correto.
- NUNCA entregue uma página com defaults de template. Se você vir "Logo", "(555) 000-0000", "[email protected]", "Serviço Um" — você FALHOU.
- NUNCA escreva texto sem pesquisa de palavras-chave. Cada título deve segmentar uma palavra-chave específica da Fase 3.
- NUNCA pule o plano de design. Cada seção, cor e animação deve ter um MOTIVO documentado.
- NUNCA use táticas de medo ou manchetes baseadas em pavor. Escreva textos focados em benefícios e otimizados para SEO.
- SEMPRE execute a varredura de placeholders antes de apresentar qualquer site. Tolerância zero.
- SEMPRE personalize cada seção. Se uma seção renderizar defaults embutidos, você esqueceu de passar as props.
- NUNCA implemente sequestro do botão 'voltar'. Sem loops de
history.pushState, armadilhas de redirecionamento ou cadeias de modais/overlays que impeçam o botão Voltar do navegador de retornar o usuário à SERP — uma violação da política de spam do Google (práticas maliciosas, aplicada em 2026-06-15) que acarreta risco de ação manual + rebaixamento. Audite scripts de intenção de saída, intersticiais e qualquer código de anúncio/biblioteca incluído (a violação geralmente se origina lá, não em código próprio). Verifique na Fase 12. (developers.google.com/search/blog/2026/04/back-button-hijacking)
Tipos de Site
Identifique durante a coleta de requisitos — isso muda tudo:
| Tipo | Objetivo | Seções Chave | Estilo de Texto |
|---|---|---|---|
| SEO para Geração de Leads | Ranquear + capturar leads | Hero + TrustBar + CoverageGrid + HowItWorks + FAQ + Testimonials + CTA | Rico em palavras-chave, focado em benefícios, profissional |
| Serviço Local | Chamadas telefônicas + formulários | Hero + TrustBar + Services + ServiceAreas + Reviews + CTA | Direto, geração de confiança, segmentado por localização |
| Portfólio | Mostrar trabalho | Hero + ProjectGrid + About + Process + Contact | Visual, texto mínimo, deixe o trabalho falar |
| SaaS / Produto | Inscrições / testes gratuitos | Hero + Features + Pricing + Testimonials + FAQ + CTA | Focado em benefícios, orientado por comparação |
Sites de Serviço Local: Consulte a seção Regras de CRO para Serviço Local abaixo antes de construir qualquer site de serviços domésticos ou de empreiteiros. A maioria dos sites locais converte abaixo de 1%. Estas regras visam atingir 3–5%.
Regras de CRO para Serviço Local
Fonte: Auditoria de conversão de Noah Igler (@noahiglerSEO) em sites de serviços domésticos (encanadores, HVAC, telhadores, eletricistas, paisagistas, etc.). A maioria dos sites obtém bom tráfego, mas o telefone não toca — porque o site perde leads, não tráfego.
A maioria dos sites de serviços domésticos converte abaixo de 1%. Estas regras visam 3–5% com o mesmo tráfego.
Acima da Dobra (80% das conversões são ganhas ou perdidas aqui)
Em até 3 segundos após o pouso, os visitantes devem saber: o que você faz, onde você faz, que você é confiável e como ligar para você. Cada elemento abaixo é obrigatório — não opcional.
- Formato do título:
"[Serviço] em [Cidade]"ou"Empresa de [Serviço] de Confiança em [Cidade]"— NÃO"Seu Parceiro de Serviços Domésticos de Confiança desde 2003" - Número de telefone: Canto superior direito, fonte grande, fixo conforme o usuário rola — conecte diretamente a um link
tel:(SEM modal, SEM popup, SEM etapa de confirmação — um modal causou a um cliente uma queda de 30% nas chamadas) - Barra de confiança / subtítulo: Avaliação por estrelas + número de avaliações + anos no mercado + número de licença + área de atuação — tudo no hero
- CTA principal:
"Ligue Agora"ou"Solicite Orçamento Grátis"— mostre o número de telefone NO botão ou imediatamente abaixo dele - Imagem do hero: Fotos reais da sua equipe com camisetas da marca, caminhões em locais de trabalho ou trabalhos reais — NEM FOTOS DE BANCO DE IMAGENS de famílias sorrindo (os visitantes as identificam instantaneamente; a confiança se torna negativa)
Visibilidade do Telefone — A Maior Alavanca Individual
- Cabeçalho fixo: número de telefone sempre visível no celular conforme o usuário rola
- Barra inferior fixa no celular: dois botões —
"Ligue Agora"(link tel:) e"Agende Online"— sempre à vista - Botão de ação flutuante em páginas longas
- Adiciona 15–25% ao volume de chamadas na prática
Formulários — Cada Campo Extra Custa ~10% das Conversões
Máximo de 4 campos para qualquer formulário de leads de serviço doméstico:
- Nome
- Telefone
- Serviço necessário (menu suspenso — não texto livre)
- Endereço
Nunca adicione: e-mail, "melhor horário para ligar", "como nos conheceu", caixa de comentários, comprovante de endereço ou qualquer pergunta de qualificação. Você não está administrando uma solicitação de crédito — está obtendo o número de telefone deles para poder ligar de volta. A qualificação acontece na ligação.
Velocidade Mobile — Inegociável
- Abaixo de PageSpeed 50 no mobile = perca 2–3 posições no Map Pack
- Abaixo de PageSpeed 70 = perca 20–30% dos visitantes mobile antes da página carregar
- Meta: PageSpeed 70+ no mobile, carregamento da página < 2 segundos
Correções de velocidade (em ordem de impacto):
- Comprimir a imagem do hero para 200–400KB (a maioria dos sites envia imagens de hero de 2–3MB)
- Remover plugins e scripts de rastreamento desnecessários
- Usar um CDN real (não apenas a opção agrupada do host)
- Carregamento lento (lazy load) de tudo abaixo da dobra
- Minimizar widgets de terceiros (chat ao vivo, incorporações de redes sociais, agregadores de avaliações) — eles carregam tarde e cobrem o número de telefone
Avaliações / Prova Social — Deve Aparecer em Cada Nível de Rolagem
Não coloque toda a prova em uma seção de depoimentos no meio da página. Os visitantes precisam vê-la em todos os níveis:
- Acima da dobra:
"4,9 estrelas de 312 avaliações do Google"— contagem + avaliação na barra de confiança do hero - Seção Hero: 2–3 citações curtas de avaliações reais, de preferência dinâmicas do GBP
- Páginas de serviço: seção de avaliação dedicada puxando citações que mencionam aquele serviço específico
- Perto do formulário: repita a prova imediatamente antes da solicitação
O objetivo: quando eles chegarem ao formulário, já viram prova 5–6 vezes.
Fotos — Imagens Reais Sempre, Não de Banco de Imagens
- Fotos reais da equipe com camisetas da marca em locais de trabalho
- Caminhões estacionados em casas de clientes reais
- Fotos de antes e depois (limpeza de ralos, trabalho em painéis, instalações de AC, dutos, substituições de telhados)
- Documentos de licença, certificações de fabricantes, certificados de seguro fotografados e exibidos
- O site deve parecer um negócio físico com pessoas reais, não um template em que uma agência de marketing colocou um logotipo
Financiamento — Obrigatório para Serviços de Alto Valor ($5K+)
~60% dos clientes para trabalhos de substituição querem financiamento. Se seu concorrente mostrar o logotipo da Synchrony / GreenSky / Wisetack e você não, eles fecham o negócio antes que você faça o orçamento.
- Logotipo do parceiro de financiamento visível acima da dobra nas páginas de serviço
- Chamada
"Financiamento 0% disponível"ou"Parcelas a partir de R$89/mês"no hero - Página de financiamento separada, vinculada a partir do menu principal
- Widget de pré-qualificação incorporado em páginas de serviço de alto valor
Erros Comuns Que Matam Conversões
Estes aparecem constantemente em auditorias — não implemente nenhum deles:
- Formulários mais longos para "qualificar" leads — você não está qualificando, está perdendo
- Esconder o telefone para forçar o preenchimento de formulários — eles simplesmente vão embora
- Vídeo em reprodução automática na seção hero — mata a velocidade mobile, irrita o visitante
- Pop-ups na primeira visita — gatilho imediato do botão 'voltar' no mobile
- Widgets de chat ao vivo — levam 4s para carregar, cobrem o número de telefone, agregam valor zero para serviços domésticos
Stack Tecnológica (todo projeto)
| Ferramenta | Pacote | Propósito |
|---|---|---|
| Next.js 15 | next | App Router, componentes de servidor, server actions |
| React 19 | react | Framework de UI |
| TypeScript | typescript | Segurança de tipos |
| Tailwind CSS v3 | tailwindcss | Estilização utilitária (v3 — NÃO v4, v4 tem problemas com PostCSS) |
| shadcn/ui | shadcn (CLI) | Biblioteca de componentes (Radix + Tailwind) |
| Motion | motion | Animações (física spring, scroll, layout) |
| Lenis | lenis | Scroll suave (< 4kb, acessível) |
| Lucide React | lucide-react | Ícones SVG |
Opcional (instale quando necessário)
| Ferramenta | Pacote | Quando |
|---|---|---|
| Pretext | @chenglou/pretext | Medição de texto sem reflow do DOM — listas virtualizadas, UIs de chat, grades masonry, contêineres de texto com redimensionamento automático, renderização de texto em canvas. ~500x mais rápido que getBoundingClientRect. Zero deps. Veja /mnt/shared-skills/pretext/SKILL.md |
| GSAP | gsap | Sequências complexas de scroll, SplitText, MorphSVG |
| Three.js | three + @react-three/fiber | Fundos 3D ou elementos do hero |
| MDX | @next/mdx | Blog com conteúdo rico |
| Prisma | prisma | Acesso a banco de dados |
Fluxo de Trabalho de 13 Fases
Siga estas fases EM ORDEM. Não pule fases. As Fases 1-4 produzem ZERO código — elas produzem pesquisa e um plano. Esse é o objetivo.
Fase 1: DESCOBERTA
Leia: instructions/brand-intake.md
Pergunte ao cliente as questões de coleta de marca ANTES de qualquer outra coisa:
- Identidade do negócio, setor, cliente-alvo
- Cores da marca, tom, personalidade
- Metas de SEO, concorrentes, o que os clientes pesquisam
- Páginas necessárias, recursos especiais, CTA principal
- Tipo de site (SEO para geração de leads, serviço local, portfólio, SaaS)
Entregável: Respostas da coleta de requisitos preenchidas
Fase 2: CONFIGURAÇÃO
Leia: instructions/folder-setup.md
Crie a estrutura de pastas ai/ dentro do diretório do projeto:
- Crie todos os diretórios de pesquisa (01-07)
- Crie diretórios de design, conteúdo e pesquisa de blog
- Inicialize
research-status.json - Preencha
01-business-profile/profile.mdcom as respostas da coleta
Entregável: Estrutura de pastas ai/ completa com o perfil do negócio preenchido
Fase 3: PESQUISA (a base — NÃO APRESSE)
Leia: instructions/research-plan.md
Seis tarefas de pesquisa que informam TUDO que se segue:
-
Pesquisa de palavras-chave — Encontre 50-100+ palavras-chave em categorias primárias, secundárias, de cauda longa e de localização. Documente em
ai/research/02-keyword-research/. Pesquise no Google, capture perguntas do PAA, construa clusters de palavras-chave. -
Análise aprofundada de concorrentes — Revise 5-10 sites concorrentes em detalhes. Para cada um: documente as seções da página inicial, layout do hero, CTAs, design visual, tipografia, animações, qualidade do conteúdo, pontos fortes, pontos fracos. Crie arquivos de revisão por concorrente em
ai/research/03-competitor-analysis/site-reviews/. Em seguida, sintetize empattern-analysis.md(padrões comuns no nicho) egaps-opportunities.md(o que exploramos). -
Estratégia de conteúdo — Mapeie cada página: URL, palavras-chave, seções, H1, meta tags. Crie briefings de conteúdo por página em
ai/research/04-content-strategy/content-briefs/. Pesquise perguntas de FAQ no PAA, Reddit, fóruns. -
Mapa tópico — Construa a arquitetura de clusters de tópicos: páginas pilar, conteúdo de cluster, estratégia de links internos. Documente em
ai/research/05-topical-map/. -
SEO Local (se aplicável) — Áreas de atuação alvo, concorrentes locais, palavras-chave específicas da cidade. Documente em
ai/research/06-local-seo/. -
Padrões de conversão — Analise CTAs dos concorrentes, sinais de confiança, padrões de prova social. Mapeie o funil de conversão. Documente em
ai/research/07-conversion-patterns/.
Entregável: 20-40 arquivos de pesquisa em 7 diretórios. Atualize research-status.json.
Fase 4: PLANO DE DESIGN (a fase de pensamento — cada decisão intencional)
Leia: instructions/design-plan.md
É aqui que um site sai de "mais um template" para algo que FUNCIONA. Seis documentos de design:
-
Auditoria visual dos concorrentes (
ai/design/competitor-visual-audit.md) — Revise todos os sites concorrentes em busca de padrões visuais: tipos de hero, ordenação de seções, esquemas de cores, tipografia, animações, estilo de fotografia. Classifique-os por qualidade visual. Identifique o que superar. -
Direção de estilo (
ai/design/style-direction.md) — Escolha a estética com justificativa. Cores, fontes, modo claro/escuro, espaçamento — cada escolha vinculada à coleta da marca + análise de concorrentes + contexto do setor. -
Plano de componentes (
ai/design/component-plan.md) — Cada componente necessário, em ordem, com seu propósito. Por que este layout de hero? Por que este estilo de barra de confiança? Por que estas seções nesta ordem? Mapeie para o funil de conversão. -
Plano de animação (
ai/design/animation-plan.md) — O que se move, por quê, como. Animações de entrada, estados de hover, efeitos de scroll. Movimento intencional, não decoração aleatória. -
Wireframes de página (
ai/design/page-wireframes.md) — Layout seção por seção para cada página. Wireframes em ASCII mostrando a estrutura. -
Briefing de design (
ai/design/design-brief.md) — Documento mestre. Resume todas as decisões de design, lista o que faz este site "se destacar" em relação aos concorrentes, conecta cada escolha à pesquisa.
Entregável: 6 documentos de design. O briefing de design é a referência para toda a construção.
Fase 5: ESTRUTURAÇÃO
Leia: instructions/architecture.md
Use: diretório templates/project/
- Copie
templates/project/paraWebsites/<nome-do-projeto>/ - Execute
pnpm install - Instale shadcn:
pnpm dlx shadcn@latest init - Instale componentes principais do shadcn:
pnpm dlx shadcn@latest add button card badge separator input textarea label - Instale deps de animação:
pnpm add motion lenis - Inicialize git, commite a estruturação
- Crie repositório privado no GitHub, faça push, crie branch
web-dev - Preencha
.claude/CLAUDE.mdusandotemplates/config/claude-project.md
Fase 6: SISTEMA DE DESIGN
Leia: instructions/design-system.md
Use: templates/config/design-system.md
- Configure o arquivo de tema Tailwind:
tailwind.config.ts— cores, fontes, espaçamento, breakpoints, animações do plano de design - Configure variáveis CSS globais:
app/globals.css— tokens de design, modo escuro, estilos base - Crie componentes base:
components/ui/— botão estilizado, badge, card, input, rotating-text, infinite-scroll-text, animated-beam - Configure fontes: importe do Google Fonts no layout, defina variáveis CSS
- Configure o provedor Lenis:
components/providers/smooth-scroll-provider.tsx - Configure o Motion:
lib/utils.tscom variante fade-in, slide-up, scale-in reutilizáveis
Fase 7: SEÇÃO HERO
Leia: instructions/sections/hero.md
Construa a seção hero de acordo com o plano de design e wireframes. A seção hero é a maior alavanca de conversão do site.
Implementação:
- Largura total, altura variável (nunca altura fixa)
- Fundo: gradiente, imagem, vídeo, mesh ou animação 3D (conforme plano de design)
- Conteúdo: título (H1), subtítulo, CTAs, barra de confiança
- Layout: centralizado, dividido ou sobreposto (conforme wireframe)
- Animação: Motion para entradas com spring, scroll, parallax
- Responsivo: teste em todos os tamanhos de viewport
Verificações:
- O título segmenta a palavra-chave principal da pesquisa?
- A barra de confiança mostra avaliações, contagem de avaliações, anos no mercado?
- O CTA é proeminente e acionável?
- A imagem é real (se for serviço local) ou de alta qualidade?
- A velocidade de carregamento é < 2s no mobile?
Fase 8: SEÇÕES PRINCIPAIS
Leia: instructions/sections/ para cada seção
Construa cada seção chave do site de acordo com o plano de design, wireframes e briefings de conteúdo.
Para cada seção:
- Implemente o layout exato do wireframe
- Popule com conteúdo otimizado para SEO das pesquisas
- Adicione animações do plano de animação
- Verifique a responsividade
- Garanta que os placeholders sejam substituídos
Fase 9: PÁGINAS ADICIONAIS
Leia: instructions/pages/ para cada página
Construa páginas internas (Sobre, Serviços, FAQ, Blog, Contato) de acordo com o plano de design.
Para cada página:
- Estrutura de layout seção por seção
- Conteúdo otimizado por palavra-chave dos briefings de conteúdo
- Navegação e breadcrumbs consistentes
- CTAs específicos da página
- Schema markup (se aplicável)
Fase 10: COMPONENTES DE CONVERSÃO
Leia: instructions/conversion/
Implemente componentes focados em conversão:
- Formulários — Máximo de 4 campos para leads de serviço local. Validação, feedback de erro, tratamento de estado de carregamento
- CTAs — Abordagem de teste A/B se aplicável. Botões proeminentes com texto orientado a ação
- Prova Social — Depoimentos, rolagem de avaliações, estudos de caso, logotipos de clientes
- Sinais de Confiança — Logotipos de financiamento, certificações, parcerias
- WhatsApp / Chat — Flutuante, não intrusivo, sem atrasos de carregamento
Fase 11: RESPONSIVIDADE E ACESSIBILIDADE
Responsividade:
- Teste em viewports: 375px, 768px, 1024px, 1440px, 1920px
- Verifique se o menu mobile funciona (hambúrguer, slide-in, etc.)
- Garanta que as fontes sejam legíveis em todos os tamanhos
- Verifique tabelas e grids em viewports pequenas
Acessibilidade:
- Use elementos semânticos HTML5 (, , , , , )
- Adicione atributos aria onde necessário (aria-label, aria-expanded, role)
- Garanta contraste de cores suficiente (WCAG AA)
- Suporte a navegação por teclado (Tab, Enter, Escape)
- Texto alternativo para imagens
- Estados de foco visíveis
Fase 12: TESTE
Execute testes completos:
-
Verificação de Placeholders — Varredura automatizada: grep por "Logo", "(555)", "@example.com", "Serviço Um", "Lorem ipsum", "Seu Nome Aqui", "(000)", "hello@", "Sua Empresa" em todos os arquivos. Tolerância zero.
-
Verificação de Links — Links internos funcionam? Links externos abrem em nova aba? Links de navegação rolam para a seção correta?
-
Verificação de Mídia — Imagens carregam? Vídeos têm fallback? Ícones SVG são exibidos?
-
Verificação de Velocidade — Teste no PageSpeed Insights. Alvo: 70+ mobile, 90+ desktop. Carregamento < 2s.
-
Verificação de Conteúdo — Cada seção tem texto real (não placeholder)? Ortografia e gramática verificadas?
-
Verificação de Sequestro do Botão Voltar — Verifique manualmente: visite o site, clique em links, use o botão Voltar do navegador. Você retorna à página anterior ou à SERP? NÃO deve haver loops de redirect, cadeias de modais ou comportamentos de retenção.
-
Verificação SEO — Meta tags (title, description, og), heading hierarchy (H1, H2, H3), schema markup (se aplicável), sitemap
Fase 13: IMPLANTAÇÃO
Leia: instructions/deployment.md
Use: instructions/deployment-checklist.md
- Faça push do branch
web-devpara o GitHub - Crie um Pull Request para
main - Configure a implantação na Vercel (ou plataforma escolhida)
- Configure o domínio personalizado (se aplicável)
- Configure analytics e monitoramento
- Teste o site implantado (executar todas as verificações da Fase 12 no site ao vivo)
- Mescle o PR quando todos os testes passarem
- Parabéns! Site implantado.
Estrutura de Diretórios
Websites/<nome-do-projeto>/
├── .claude/
│ └── CLAUDE.md
├── ai/
│ ├── 01-business-profile/
│ │ └── profile.md
│ ├── 02-keyword-research/
│ │ └── keywords.csv
│ ├── 03-competitor-analysis/
│ │ ├── site-reviews/
│ │ ├── pattern-analysis.md
│ │ └── gaps-opportunities.md
│ ├── 04-content-strategy/
│ │ └── content-briefs/
│ ├── 05-topical-map/
│ ├── 06-local-seo/
│ ├── 07-conversion-patterns/
│ ├── design/
│ │ ├── competitor-visual-audit.md
│ │ ├── style-direction.md
│ │ ├── component-plan.md
│ │ ├── animation-plan.md
│ │ ├── page-wireframes.md
│ │ └── design-brief.md
│ ├── content/
│ └── blog-research/
├── app/
│ ├── layout.tsx
│ ├── page.tsx
│ └── globals.css
├── components/
│ ├── ui/
│ ├── sections/
│ └── providers/
├── lib/
│ └── utils.ts
├── public/
├── tailwind.config.ts
├── package.json
└── README.md
Comandos Úteis
# Desenvolvimento
pnpm dev
# Construção
pnpm build
# Lint
pnpm lint
# Verificação de placeholders (execute antes de apresentar)
grep -rn "Logo\|\(555\)\|@example.com\|Serviço Um\|Lorem ipsum\|Seu Nome Aqui\|\(000\)\|hello@\|Sua Empresa" --include="*.tsx" --include="*.ts" --include="*.md" .