Communitygithub.com

build-site

Executa o pipeline completo de criação de site para cliente: briefing e definição de design, sitemap e textos, construção, verificações, revisão, SEO e preparação para lançamento, com dois portões de aprovação e um loop de correção limitado.

O que é build-site?

Esta skill orquestra o pipeline completo de criação de site para um cliente, desde a coleta de requisitos até a preparação para lançamento, usando subagentes especializados em cada etapa. Ela é essencial para projetos de sites reais, garantindo qualidade, consistência e aprovação do cliente em pontos críticos. A skill é executada em uma única sessão principal e delega tarefas a subagentes como 'design-taste-frontend' para construção visual, 'copywriting' para textos, 'site-reviewer' para revisão e 'seo' para otimização. Ela suporta a plataforma Astro e mantém todo o progresso em artefatos no diretório `.claude/pipeline/`, permitindo que a construção seja retomada em várias sessões. O pipeline inclui dois portões de aprovação do usuário (plano e site final), um loop de correção de no máximo duas rodadas, e uma etapa de lições aprendidas para melhoria contínua.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construir um site para cliente

A sessão principal executa este pipeline e delega para subagentes. (Subagentes não podem iniciar outros subagentes, por isso esta é uma skill, não um agente orquestrador.)

[0 Portão de Briefing]  brief + DESIGN.md + referências
      ↓
[1 Planejamento]  sitemap, seções de página, textos  →  plan.md, src/data/*
      ↓
[PORTÃO DO USUÁRIO 1]  aprovar plano e textos
      ↓
[2 Construção]  páginas e sistema visual
      ↓
[3 SEO]     agente seo            →  seo-report.md
      ↓
[4 Verificação]  npm run verify (portão rígido)
      ↓
[5 Revisão]  agente revisor de site  →  review-report.md
      ↓
[6 Loop de correção]  P0/P1 → corrigir → verificar → revisar novamente (máx. 2 rodadas)
      ↓
[PORTÃO DO USUÁRIO 2]  aprovar o site
      ↓
[7 Preparação para lançamento]  checklist de lançamento + documento de entrega
      ↓
[8 Lições]  anexar a docs/lessons.md

Artefatos

Tudo vai em .claude/pipeline/:

pipeline-state.md   estágio, rodada de correção, última atualização
plan.md             sitemap, seções por página, ação principal por página
review-report.md    do revisor de site
seo-report.md       do seo
screenshots/        do npm run verify

Leia pipeline-state.md no início de cada estágio e retome de onde ele indica. Atualize-o ao final de cada estágio. Isso permite que uma construção abranja várias sessões.

Estágio 0: Portão de Briefing

Verifique cada item. Se algum estiver faltando, pare e ajude o usuário a preenchê-lo antes de qualquer outra coisa.

ItemPronto quando
.agents/product-marketing.mdSeção de fatos do negócio completa, ação principal nomeada, público e tom preenchidos. Use a skill product-marketing para rascunhá-lo a partir do que o usuário fornecer.
src/data/business.jsonNome, telefone, endereço, horário, link do mapa correspondem ao briefing. Copie-os do briefing.
DESIGN.mdTodas as seções preenchidas. Se o usuário tiver apenas referências, rascunhe a partir de references/ e peça confirmação.
references/Pelo menos duas capturas de tela ou URLs com uma linha sobre o que aproveitar de cada uma.
Ativos do clienteLogotipo e fotos, ou uma nota explícita de que substitutos temporários são aceitáveis por enquanto.
EdiçãoO cliente editará o site por conta própria? (Afeta o estágio 7.)

Em seguida, preencha src/styles/tokens.css a partir de DESIGN.md.

Estágio 1: Planejamento

  1. Escreva plan.md: as páginas (a maioria dos clientes precisa de Home, uma página por oferta principal ou uma página de Menu/Serviços, Sobre, Contato), a ação principal por página e as seções em cada página em ordem. Use o briefing e site-essentials.
  2. Escreva os textos com a skill copywriting, depois execute copy-editing neles. Comece pelo idioma do cliente do briefing e pelas próprias palavras do cliente, e use algumas dessas frases quase literalmente. Siga a regra interna 9 em CLAUDE.md (sem frases genéricas de IA). Coloque em src/data/ (home.json, servicos, FAQs), não em componentes.
  3. Marque qualquer coisa que você não sabe como [PRECISA: ...]. Nunca preencha uma lacuna com um fato inventado.

Portão do usuário 1

Pare. Mostre ao usuário: o sitemap, as seções de cada página e ação principal, os textos completos e cada item [PRECISA: ...]. Aguarde aprovação ou alterações. Textos são mais baratos de mudar agora do que após a construção.

Estágio 2: Construção

Construa com a skill design-taste-frontend (Skill de Gosto), dentro deste projeto Astro. Antes de começar, informe:

  • O tipo é lugar (as pessoas vão até ele) ou serviço (as pessoas são contratadas), nunca um tipo técnico.
  • DESIGN.md e references/ definem paleta, tipografia e estilo. Sua própria paleta e fontes padrão são substituídas.
  • Fatos do negócio vêm de src/data/business.json. Suas regras de contato substitutas não se aplicam.
  • Movimento segue as regras internas em CLAUDE.md.

Construa página por página, home primeiro. Após a home, execute npm run verify, veja as três capturas de tela e corrija o que você ver antes de construir a próxima página. O portão de finalização da Skill de Gosto é executado por conta própria quando ela para; trate suas descobertas como entrada, mas CLAUDE.md vence em conflitos.

Estágio 3: SEO

O agente seo edita tags head, JSON-LD e robots, então ele é executado antes da verificação e revisão. Dessa forma, a revisão julga o site finalizado.

seo: "Audite e implemente SEO para este site, incluindo a etapa de negócio local. Briefing: .agents/product-marketing.md. Escreva seu relatório em .claude/pipeline/seo-report.md."

Estágio 4: Verificação (portão rígido)

npm run verify

Todas as falhas do check-site e problemas de captura de tela (rolagem lateral, erros de console) devem ser corrigidos antes da revisão. Falhas [PRECISA: ...] são permitidas apenas para fatos que já foram solicitados ao usuário; liste-os. Reescreva qualquer texto que check-site sinalizar como genérico, a menos que o cliente realmente use aquela palavra.

Estágio 5: Revisão

O revisor é somente leitura e retorna seu relatório como sua mensagem final. Salve essa mensagem literalmente em .claude/pipeline/review-report.md.

site-reviewer: "Revise o site construído. Plano: .claude/pipeline/plan.md. Briefing: .agents/product-marketing.md. Design: DESIGN.md. Capturas de tela: .claude/pipeline/screenshots/. Alterações de SEO já feitas: .claude/pipeline/seo-report.md. Retorne o relatório completo como sua mensagem final."

Estágio 6: Loop de correção

Veredito do revisor de siteAção
ProntoVá para o portão 2
Precisa de acompanhamento, apenas P2sVá para o portão 2, liste os P2s
Precisa de acompanhamento (P1s) ou Bloqueado (P0s)Rodada < 2: corrija-os, execute novamente o estágio 4 (verificação), execute novamente o revisor de site nas páginas alteradas e salve seu relatório. Rodada = 2: pare e mostre ao usuário.

Use o agente bug-fixer para qualquer coisa que esteja quebrada, em vez de apenas fora do briefing. Incremente a rodada em pipeline-state.md a cada vez.

Portão do usuário 2

Pare. Mostre ao usuário: capturas de tela da home em 390 e 1440, o veredito, P2s restantes, decisões de SEO necessárias, itens [PRECISA: ...] restantes e fotos substitutas a serem trocadas. Aguarde aprovação.

Estágio 7: Preparação para lançamento

  1. Execute npm run check:launch e corrija cada FALHA. Em seguida, preencha docs/launch-checklist.md, marcando cada item como feito, não aplicável ou aguardando alguém (diga quem).
  2. Preencha docs/handoff.md para o cliente.
  3. Se o cliente editará o site, siga docs/client-editing.md.
  4. Após o site estar no ar em seu domínio real, lembre o usuário de executar claude-seo nele: /seo local <url> e /seo audit <url>.

Estágio 8: Lições

Examine os relatórios e as rodadas de correção em busca de qualquer coisa que deu errado duas vezes ou custou tempo real. Acrescente uma linha datada por lição a docs/lessons.md. Diga ao usuário quais lições valem a pena copiar de volta para o site-starter para que todo site futuro se beneficie delas.

Habilidades Relacionadas