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.
| Item | Pronto quando |
|---|---|
.agents/product-marketing.md | Seçã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.json | Nome, telefone, endereço, horário, link do mapa correspondem ao briefing. Copie-os do briefing. |
DESIGN.md | Todas 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 cliente | Logotipo e fotos, ou uma nota explícita de que substitutos temporários são aceitáveis por enquanto. |
| Edição | O 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
- 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 esite-essentials. - Escreva os textos com a skill
copywriting, depois executecopy-editingneles. 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 emsrc/data/(home.json, servicos, FAQs), não em componentes. - 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) ouserviç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 site | Ação |
|---|---|
| Pronto | Vá para o portão 2 |
| Precisa de acompanhamento, apenas P2s | Vá 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
- Execute
npm run check:launche corrija cada FALHA. Em seguida, preenchadocs/launch-checklist.md, marcando cada item como feito, não aplicável ou aguardando alguém (diga quem). - Preencha
docs/handoff.mdpara o cliente. - Se o cliente editará o site, siga
docs/client-editing.md. - 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.