O que webbuild faz?
Faça sites pelos quais um empresário pagaria: específicos para ele, rápidos no celular, um momento memorável e nada que grite "um IA fez isso". O capricho está principalmente nas escolhas antes do código e em olhar honestamente para o resultado depois.
Os caminhos abaixo são relativos à pasta desta skill (scripts/, references/, assets/).
0. Configurar o projeto (2 min)
- Novo site → copie
assets/starter/para dentro da pasta do projeto (HTML + CSS + ES modules puros, importações CDN fixas, sem etapa de build: implanta em qualquer lugar, fácil de editar). Use Next.js / Astro / R3F apenas se o usuário pedir ou o projeto já os utilizar (references/3d-playbook.md§5). - Projeto existente → mantenha seu framework, tokens e componentes; esta skill adiciona direção, movimento e QA, não uma reescrita.
- Crie
BUILD_NOTES.mdno projeto. É a memória entre reinícios de contexto: resumo, decisões, perguntas em aberto, correções que funcionaram.
1. Briefing — entenda o negócio real
Colete (do usuário, do site atual do negócio, Google Business Profile, Instagram):
nome, o que vendem, onde, desde quando, a única ação principal (ligar / agendar / encomendar /
pedir orçamento / visitar), prova real (avaliação + quantidade, anos, licenças, imprensa), fotos reais, logo/cores,
horários, endereço, telefone. Escreva o briefing de 5 linhas de references/design-system.md §2 em
BUILD_NOTES.md.
Nunca invente fatos — avaliações, estatísticas, preços ou endereços fabricados em uma apresentação destroem a confiança no momento em que o proprietário os lê. Em vez disso:
- Escreva em torno das incógnitas para que o demo ainda pareça finalizado: "Koregaon Park, Pune" em vez de um número de rua inventado; "Avaliado com 4,7 no Google" em vez de citações inventadas; nomes de serviços sem preços, ou "a partir de R$…" apenas se souber.
- Quando um fato for realmente necessário (telefone, endereço exato, horários), use um
{{placeholder}}visível — oslop_check.pybloqueia o envio até que seja preenchido. - Coloque todas as incógnitas e suposições em uma lista "Perguntar ao cliente" para o relatório final.
Para um site de criador ou canal, peça (ou extraia) os números do painel e a foto de perfil com antecedência: capturas de tela do YouTube Studio / Instagram Insights, além de vidIQ ou similar, se conectado. Uma seção de Resultados construída a partir de números reais é o que vende.
Se o briefing for superficial e o usuário estiver por perto, faça no máximo 3 perguntas (negócio + cidade, ação principal, algum site que eles amam). Se eles quiserem que você apenas vá, faça suposições sensatas, escreva-as e continue.
2. Referência (quando o usuário nomear um site, enviar uma gravação ou quiser uma "reconstrução")
Siga references/reverse-engineer.md: node scripts/teardown.mjs <url> mede a stack,
fontes, paleta, mídia e evidências de shader e captura a rolagem; gravações de tela se tornam
quadros que você lê e transforma em uma especificação de movimento passo a passo. Quando essa passagem rápida não conseguir explicar
um efeito, vá mais fundo com o mecanismo REA: scripts/rea-teardown.sh <url> captura a página,
identifica o bundle e exporta todos os scripts para que você possa ler como ele realmente é construído
(guias em references/rea/). Registre OBSERVADO → INFERÊNCIA → DECISÃO. Aprenda a técnica;
nunca copie marca, texto, ativos ou código.
3. Direção — planeje, depois ataque o plano
Leia references/design-system.md (as regras anti-slop — clássicas e os sinais
"IA de bom gosto" mais novos, como creme + terracota, sobrancelhas EM CAIXA ALTA, linhas editoriais). Em
BUILD_NOTES.md escreva:
- 4–6 tokens de cor nomeados, extraídos do negócio, par de tipos + funções, linguagem de raio
- Wireframe ASCII de cada seção (varie o ritmo — sem herói → 3 cards → logotipos → depoimentos)
- o momento de assinatura (exatamente um) e por que ele se encaixa neste negócio
- 3 princípios que o tornam distinto
Em seguida, revise o plano contra a lista de sinais e, para cada escolha que pareça padrão, justifique-a para este negócio ou mude-a. Perguntar "isso poderia pertencer a outro negócio se euro trocar o logotipo?" detecta a maioria dos problemas aqui, onde são baratos.
Para uma direção indecisa sobre a qual o usuário queira escolher, mostre 2–3 direções genuinamente diferentes
(uma imagem estática ou um esboço HTML rápido cada) antes de construir — 21st-ui-explore pode ajudar, se instalado.
4. Herói — escolha o modo que atende ao negócio
references/3d-playbook.md §1 tem a tabela de decisão. Versão resumida:
- estático (ótima foto/tipografia) — lugares, comida, salões, clínicas, serviços. Muitas vezes a escolha certa.
- vídeo — loop de atmosfera, idealmente tratado com
assets/starter/grade.jspara que o material de IA/stock receba uma gradação personalizada (grão, halação, lift/gamma/gain, vinheta). Escolha um VISUAL e mantenha-o sutil. - quadros — o "site 3D de R$ 50 mil": keyframes de IA de início/fim → vídeo do primeiro/último quadro →
scripts/frames.sh→ canvas controlado pela rolagem. Leiareferences/scroll-video-playbook.mdpara as regras de keyframe, prompts e mesclagem. - cena — Three.js / R3F ao vivo quando o 3D é a história do produto (produto configurável, arquitetura, tecnologia). O assunto deve ser a coisa do negócio, nunca o nó placeholder.
- página inteira — quando o proprietário pede um "site 3D", ele geralmente quer 3D em toda parte,
não um herói 3D. Use uma cena fixa com uma câmera por seção
(
references/3d-playbook.md§6).
Gere ativos com o que estiver conectado (Higgsfield / Kling / kie.ai / Nano Banana MCPs ou skills), ou peça ao usuário para colocar os arquivos. Se nada estiver disponível, construa com um placeholder claramente identificado e liste exatamente qual ativo gerar, com o prompt.
5. Construir
Ordem: tokens (styles.css :root) → seções HTML semânticas com texto real → layout em 390px
e 1440px → modo herói → movimento por último.
- Regras de texto:
references/design-system.md§8 (resultado + lugar + especificidades, verbos reais de CTA, palavras proibidas). - Obrigatório para um site empresarial: um CTA óbvio acima da dobra e novamente no final,
tel:/ agendamento / formulário, horários + endereço + link do mapa, prova real, título + descrição + imagem OG, JSON-LD de LocalBusiness, favicon, barra fixa de ligar/agendar no celular quando a ação for uma ligação. - Movimento: um momento de assinatura + microfeedback silencioso de 150–300 ms; ease-out, nunca bounce;
apenas
transform/opacity; movimento reduzido mostra estados finais. - Componentes: pesquise nos registros
references/resources.md(21st.dev, React Bits, Aceternity, Motion Primitives…) antes de escrever efeitos complexos à mão, depois reestilize para os tokens. Em um site estático, reconstrua componentes React em vanilla em vez de adicionar React para um efeito. - Rodapé: construa-o de acordo com
references/design-system.md§11 (bloco de marca, colunas de links com logotipos de plataforma, botões de contato, logotipo grande, linha inferior). Os proprietários julgam o site inteiro por ele. O pequeno crédito do construtor já está no starter; o cliente pode pedir para removê-lo. - Botões e rolagem: siga
references/design-system.md§12 (botões táteis de 0,16 s, anel do cursor viacursor.jsdo starter, sem barra de rolagem nativa: oblockbar.jsdo starter a substitui). - Antes de considerar concluído, releia
references/design-system.md§10: as coisas que os proprietários ainda chamam de slop depois que todas as regras passam.
6. Olhe para ele — é aqui que os bons sites são feitos
Sirva localmente (npx serve . ou o servidor de desenvolvimento do projeto), então:
node scripts/shoot.mjs http://localhost:3000 ./shots— capturas de tela de celular / laptop / desktop ao longo da rolagem + erros de console, overflow, LCP, peso. Leia os PNGs. (Ou use o painel do navegador / MCP do Playwright, se disponível.) Execute também uma vez com--reduced-motion.python3 scripts/slop_check.py .— deve terminar com 0 FAIL. Trate WARNs como perguntas. (npx impeccable detecté uma boa segunda opinião, se instalado.)- Critique honestamente contra o briefing: hierarquia, tipo, cor, o momento de assinatura, mobile, especificidade do texto. Corrija em lotes com intenção clara ("seções inferiores parecem genéricas — torne-as mais caras, não mais ocupadas").
- Remova um elemento decorativo antes de considerar concluído.
Espere 3–6 rodadas; ninguém acerta de primeira. Registre o que corrigiu o quê em BUILD_NOTES.md.
7. Enviar + apresentar
- Implante: Vercel / Netlify / Cloudflare Pages / GitHub Pages. Faça commit da pasta de frames
(o bug mais comum de "o herói desapareceu em produção"). Adicione
<meta name="robots" content="noindex">em demos para especulação até que o cliente compre. - Se for uma apresentação, leia
references/pitch-and-sell.md: vídeo antes/depois, scripts de divulgação, âncoras de preço, lista de verificação pronta para apresentação, entrega.
Relatório final ao usuário
Mantenha-o curto e concreto:
- O que foi construído (direção em uma linha, momento de assinatura, modo herói) e onde (caminhos, URL)
- Como executar (
npx serve .ou o comando de desenvolvimento) - Resultados do QA: contagens de FAIL/WARN do slop_check, LCP / erros por viewport do shoot.mjs, o que você examinou e corrigiu
- Lista Perguntar ao cliente: cada
{{placeholder}}e suposição - Ativos ainda a serem gerados (com prompts prontos para uso), se houver
Mapa de referência
| Leia | Quando |
|---|---|
references/design-system.md | Sempre, antes de escolher cor/tipo/layout/texto |
references/3d-playbook.md | Escolher o herói; qualquer Three.js/R3F; orçamento de desempenho + acessibilidade |
references/scroll-video-playbook.md | Herói "3D" controlado por rolagem a partir de vídeo de IA |
references/reverse-engineer.md | Um site de referência, uma gravação ou reconstruir o site de um cliente potencial |
references/rea/README.md | Aprofundar-se além do teardown.mjs com as ferramentas REA |
references/resources.md | Registros de componentes, ferramentas de efeitos, inspiração, skills complementares |
references/pitch-and-sell.md | Site de especulação para um cliente potencial, preço, divulgação, entrega |
| Script | Faz |
|---|---|
scripts/teardown.mjs <url> | Medir um site de referência (stack, fontes, paleta, mídia, shaders, capturas de tela) |
scripts/rea-teardown.sh <url> | Dissecação profunda com o mecanismo REA: captura de página, impressões digitais do bundle, scripts exportados |
scripts/frames.sh <video> <out> | Vídeo → sequências de quadros WebP (desktop + mobile) + manifesto |
scripts/shoot.mjs <url> [out] | Capturas de tela em 3 larguras ao longo da rolagem + erros/LCP/overflow |
scripts/slop_check.py <dir> | Linter de slop de IA + prontidão para envio (0 FAIL para enviar) |
Playwright para os scripts .mjs: npm i -D playwright && npx playwright install chromium.