Construção de site para negócios locais (Grécia)
Extraído de um site real (Αποφράξεις Τσαβάρης) que precisou de dezenas de prompts porque a parte invisível dava errado repetidamente: configuração de servidor, consentimento, arquivos SEO, fatos inconsistentes. Objetivo: acertar na primeira tentativa. Fale com o usuário em grego.
Os caminhos abaixo são relativos à pasta desta skill. Resolva-os para caminhos absolutos antes de executar scripts; execute os scripts com deno run -A scripts/<nome>.mjs (ou node). Se nenhum existir, informe o usuário (instalação: winget install DenoLand.Deno, pergunte primeiro) e use as listas de verificação manuais.
Execução portátil
Verifique as capacidades do host antes de executar os helpers: terminal e acesso a arquivos, Node 18+ ou Deno, ferramentas de navegador, FFmpeg opcional e permissões de rede. Nunca presuma que a instalação fornece essas ferramentas. Use ferramentas de imagem/navegador equivalentes disponíveis ou listas de verificação de referência manual; relate quaisquer verificações automatizadas que não pôde executar. Resolva cada caminho de suporte em relação ao diretório desta skill instalada. Nunca presuma um caminho de usuário Windows ou instale software sem autorização.
Regras que nunca se curvam (cada uma custa tempo ou dinheiro real)
- Nunca invente fatos. Telefone, e-mail, endereço, ΑΦΜ, ΓΕΜΗ, horários, preços, avaliações, classificações, anos de atividade, licenças, garantias, tempos de chegada vêm do proprietário. Ausente → pergunte ou omita; marcadores
[ΧΡΕΙΑΖΕΤΑΙ: …]bloqueiam a publicação. Profissões regulamentadas (médico, dentista, advogado, farmacêutico): sem avaliações, sem alegações de sucesso (references/01 §4). - Uma única fonte da verdade:
site-facts.json(fora da pasta de deploy). Arquivos derivados (JSON-LD, sitemap, llms.txt, robots, manifest, vCard) são regenerados comscaffold.mjs derive, nunca editados manualmente. - O design é decidido por cliente, nunca copiado de um site anterior: escreva
docs/DESIGN.md, obtenha a escolha do usuário de UMA direção, depois codifique (references/02). - CSP limpo desde a primeira linha: sem script/style/manipuladores inline; cada terceiro adicionado ao CSP na mesma alteração; um CSP imposto.
- Nenhuma requisição de terceiros antes do consentimento ou de um clique. GA4 carrega somente após "Αποδοχή"; Aceitar/Rejeitar iguais; mapa no clique; fontes auto-hospedadas com glifos gregos verificados (muitas fontes populares, ex. Poppins/Montserrat, não têm).
- Corrija causas raiz, não patches por largura. Mobile-first; teste a matriz de larguras com
scripts/overflow_probe.js. - Nunca confie em uma diretiva de servidor. Hostinger/LiteSpeed ignora
<IfModule>, ignora silenciosamente diretivas não suportadas e força HTTPS na borda: verifique ao vivo comverify_live.mjs. - Arquivos SEO são entregáveis: canônico, robots (
Allow: /+ Sitemap), sitemap, JSON-LD (subtipo LocalBusiness), OG 1200×630, ícones incluindo maskable. - Incremente
?v=em cada página após qualquer alteração de CSS/JS (bump_version.mjs) e limpe os caches da Hostinger. - Verifique, não suponha. Diga "concluído" somente após a auditoria mostrar 0 erros nos arquivos finais, o QA do navegador estiver feito e você relatar honestamente o que não foi verificado.
Pegadinhas (crenças obsoletas ou falsas que parecem certas)
- Marcação FAQPage/HowTo não traz nada: resultados enriquecidos de FAQ foram descontinuados em 7 de maio de 2026.
llms.txtnão tem efeito comprovado (Google diz que não usa): opcional. - Nunca adicione
aggregateRating/reviewJSON-LD para o próprio negócio;sameAsapenas para perfis reais e povoados (nunca um segundo domínio vazio). - Um
Disallow: /de staging ounoindexdeixado em produção desindexa o site (auditoria SEO-001/023). - O domínio de preview da Hostinger
*.hostingersite.comduplica o site: redirecione 301 e remova-o. htaccesssem o ponto é ignorado; com o ponto deve ser enviado explicitamente (arquivo oculto). Docs/facts/.mdnão devem ficar empublic_html.- Links CDN do Google Fonts quebram privacidade e CSP; conselhos de design frontend que mencionam Poppins/DM Sans/Playfair etc. falham no grego.
- Um link que difere de um arquivo apenas por maiúsculas/minúsculas funciona no Windows e dá 404 no servidor.
- Âncoras construídas dentro de JS (banner de cookies →
/privacy.html#cookies) devem existir também. - O desafio de bot na borda após ~60 requisições rápidas não é uma falha do site: espere, não desvie.
Fluxo de trabalho (carregue a referência nomeada em cada etapa antes de executá-la)
- Triagem: site novo · reformulação · apenas auditoria (pule para 6) · pequena alteração (pule para 5). Verifique quais ferramentas existem (deno/node, ferramenta de navegador, ffmpeg, Edge/Chrome para
render_png). - Coleta → leia
references/01-intake-and-facts.md. Pergunte tudo em uma mensagem em grego (se ninguém puder responder, use apenas os fatos fornecidos, nunca invente, escrevaQUESTIONS.md); escrevasite-facts.jsona partir deassets/site-facts.example.json;scaffold.mjs check --facts site-facts.json. - Briefing de design →
references/02-design-direction.md; preenchadocs/DESIGN.md, proponha 2-3 direções, obtenha uma escolha. - Estruturação:
scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg](cria páginas, CSS base, JS,.htaccesscom CSP a partir das funcionalidades, robots, sitemap, llms.txt, manifest, vCard, documentos de handoff em grego, AGENTS.md/CLAUDE.md para o projeto). - Construção →
references/03-build-and-code.md,04-conversion-and-content.md,05-seo-schema-geo.md: tokens + TEMA emstyle.css, seções emindex.html(substitua o marcador[ΧΡΕΙΑΖΕΤΑΙ…]), assets viamake_icons.mjs,render_png.mjs(imagem OG de uma página HTML),images.mjs,font_greek_check.mjs --download. Para consentimento, texto de privacidade, identidade do rodapé, preços ou avaliações, leia também06-privacy-consent-legal.md. Um exemplo fictício concluído do nível de qualidade está emassets/example-site/(estude estrutura e tom de cópia, nunca sua aparência). - Após qualquer alteração de fato: fatos →
scaffold.mjs derive→ texto visível →bump_version.mjs. - Auditoria:
audit_site.mjs public --facts site-facts.json→ corrija cada ERRO, leia AVISO, forneça ao proprietário a lista VERIFICAR. Resultado não claro →references/mistake-registry.md. - QA e lançamento →
references/08-qa-and-launch.md(matriz de larguras, teste de consentimento, QA de conteúdo); implantação e detalhes do servidor emreferences/07-server-htaccess-deploy.md. - Pós-implantação:
verify_live.mjs https://DOMINIO --local public --preview-domain X.hostingersite.com; entregue ao proprietáriodocs/. Formulários, reservas, mais páginas, CMS, e-shop, outros idiomas, pixels de anúncios →references/09-beyond-the-basics.mde acorde escopo primeiro.
Scripts (scripts/)
audit_site.mjs auditoria pré-lançamento (ERRO/AVISO/VERIFICAR/INFO; --json, --strict; saída 1 em erros) · verify_live.mjs verificação ao vivo (redirecionamentos, cabeçalhos, 404, arquivos expostos, identidade de bytes; limitado) · scaffold.mjs init/derive/check · bump_version.mjs · render_png.mjs · make_icons.mjs · images.mjs (ffmpeg) · contrast.mjs · font_greek_check.mjs · overflow_probe.js (executar dentro da página). Todos imprimem uso no estilo --help quando chamados sem argumentos. Eles escrevem apenas dentro das pastas que você passa.
Índice de referência
01 coleta/fatos/profissões regulamentadas · 02 direções de design, fontes gregas · 03 construção, desempenho, acessibilidade, larguras · 04 conversão e cópia · 05 SEO/esquema/GBP/pesquisa AI · 06 privacidade e ponteiros de lei grega · 07 servidor Hostinger e implantação · 08 QA/lançamento · 09 além do básico · registro de erros. Data de pesquisa: 2026-10-05; leis e políticas do Google mudam: reverifique antes de confiar, e diga quando algo não foi verificado.