O que Portfolio Forge faz?
Transforma "informações de uma pessoa" em um site pessoal esteticamente impecável e publicável. O núcleo é um pipeline validado: Documento de conteúdo (única fonte de verdade) → Imagens de referência → Revisão adversarial → Replicação de alta fidelidade → QA seção por seção → Deploy reversível.
Inspirado no método de quatro passos "faça um site pessoal com Codex em duas horas" (organizar conteúdo → gerar imagens de referência com taste → gerar ativos → replicar), este skill solidifica três etapas que realmente determinam a qualidade e que o original não ensina: documento de conteúdo contra alucinações, revisão adversarial imagem por imagem, e validação headless antes do deploy.
Quando Acionar
- "Fazer site pessoal" "Fazer portfólio" "Transformar minhas informações em site"
- "personal website" "portfolio" "Me ajudar com uma landing page"
- "Quero uma página pessoal para mostrar" "No era da IA, site pessoal é currículo"
- Até mesmo apenas "Me ajuda a fazer um site" "Colocar minhas coisas numa página"
Pré-requisitos (Verificar no Primeiro Uso)
Este pipeline requer três ferramentas externas. Se faltarem, instale (veja métodos em workflows/reference-image-gen.md e início de workflows/frontend-replication.md):
- taste-skill
imagegen-frontend-web— Gera imagens de referência de alta estética por seção. Instale em~/.claude/skills/e~/.codex/skills/. - Plugin
build-web-appsdo Codex (com skill Frontend App Builder) — Replicação de alta fidelidade.codex plugin add build-web-apps@openai-curated. - Chrome + puppeteer-core — QA headless para capturar screenshots por seção.
Princípios Fundamentais
- Documento de conteúdo é a única fonte de verdade: Antes de começar, organize o perfil da pessoa / posicionamento / estilo / paleta de cores / estrutura de seções em um arquivo
CONTENT.md. Depois, qualquer texto gerado por IA nas imagens de referência que não corresponda ao documento deve ser ignorado — o documento é soberano. Esta é a base contra alucinações. - Revisão adversarial imagem por imagem: As imagens de referência não são para replicar diretamente; são para desafiar. Pergunte para cada imagem: "O tamanho da fonte está exagerado? Tem espaço para respirar? A composição caiu em padrão de IA? Tem texto alucinado? As imagens são consistentes entre si?" Se não passar, regere apenas aquela imagem. Este passo determina se o resultado final será "aceitável" ou "realmente bonito".
- Ativos reais têm prioridade: Fotos reais da pessoa, screenshots de projetos reais — use sempre os reais. IA é usada apenas para gerar "imagens de referência de estilo" e "ativos estilizados", nunca para falsificar rostos ou screenshots. Se o usuário forneceu fotos, use-as diretamente, não gere outras.
- QA seção por seção é o único critério de conclusão: A replicação não é entrega; é validação. Use Puppeteer para rolar a página real, capturar screenshots de cada seção, e compará-las lado a lado com as imagens de referência. Se algo não corresponder, volte para o estágio de replicação e itere.
- Deploy reversível, sem mexer em ativos existentes: O deploy é sempre primeiro em um subdomínio independente
*.pages.dev. Antes de tocar no domínio existente do usuário, verifique as vinculações e trate a decisão de "mudar o domínio" como escolha do usuário, sem agir por conta própria. - Texto em linguagem humana primeiro (feedback de usuário de julho de 2026): O texto do site e materiais de divulgação, por padrão, são escritos para leitores não técnicos — termos de stack tecnológico (framework, banco de dados, provedor de serviços) não aparecem no corpo do texto; em vez disso, diga "o que isso faz, para quem serve". Termos técnicos só são mantidos se a entrevista confirmar que o público é técnico. Instruções de instalação/uso priorizam comandos do tipo "entregue este parágrafo para seu assistente de IA", em vez de comandos de terminal.
Fluxo de Trabalho (Seis Estágios)
Estágio 0: Esclarecer Posicionamento (Entrevista para Convergência)
Siga workflows/content-intake.md. Use AskUserQuestion para convergir as decisões-chave: para quem é o site, posicionamento, estilo visual, idioma e escala, fonte dos ativos, trabalhos selecionados, CTA principal, destino do deploy. Opções de estilo conforme references/design-style-library.md (estilo é o input mais importante na geração de imagens com taste).
Estágio 1: Documento de Conteúdo (Única Fonte de Verdade)
Organize os resultados da entrevista + dados externos capturados (site existente, Substack, redes sociais) em CONTENT.md, seguindo o formato de references/content-doc-template.md. Este documento é a base para todos os estágios seguintes.
Estágio 2: Gerar Imagens de Referência por Seção
Siga workflows/reference-image-gen.md. Divida a página em 6–8 seções. Use imagegen-frontend-web para gerar uma imagem por seção (via codex exec em segundo plano). Salve em refs/.
Estágio 3: Revisão Adversarial + Iteração (A Alma)
Siga workflows/adversarial-design-review.md. Primeiro, leia cada imagem e a desafie por conta própria. Depois, submeta para revisão do usuário. As que não passarem, regere apenas aquela imagem. Este passo pode exigir várias rodadas — é normal, não pule.
Estágio 4: Replicação de Alta Fidelidade
Siga workflows/frontend-replication.md. Entregue o pacote completo ("imagens de referência aprovadas + CONTENT.md + ativos reais") para o Codex Frontend App Builder, com o objetivo de replicação 1:1, orientado a dados, com animações e RWD. Os efeitos dinâmicos são selecionados de references/motion-effects-library.md (11 receitas de efeitos validados na prática) e listados um a um no prompt de replicação — regra de ferro: movimento serve ao tema, respeite prefers-reduced-motion, no máximo 1 efeito grande por página.
Estágio 5: QA Seção por Seção
Siga a primeira metade de workflows/headless-qa-and-deploy.md. Use Puppeteer para rolar a página real e capturar screenshots de cada seção. Compare com as imagens de referência usando references/qa-checklist.md. Se algo não corresponder, volte para o Estágio 4.
Estágio 6: Deploy + Smoke Test
Siga a segunda metade de workflows/headless-qa-and-deploy.md. Faça deploy no Cloudflare Pages em subdomínio independente *.pages.dev → execute smoke test headless online (status HTTP + carregamento de assets + screenshot da primeira tela) → devolva a decisão de domínio ao usuário.
Design de Subagentes / Ferramentas
As tarefas pesadas deste pipeline são delegadas ao Codex (geração de imagens, replicação). O Claude fica responsável pela entrevista, redação de documentos, revisão adversarial, QA de validação e orquestração do deploy.
- Geração de Imagens / Replicação:
codex exec --skip-git-repo-check --full-auto "<prompt>", usandorun_in_background: truepara execução em segundo plano. Valide após a conclusão. - Captura de Dados Externos:
WebFetch(site existente, perfil e artigos do Substack). - QA com Screenshots: Chrome headless ou puppeteer-core (veja notas de armadilhas no workflow para screenshots por seção).
- Deploy:
wrangler pages.
Estratégia de paralelismo: As 7–8 imagens de referência são geradas sequencialmente em uma única execução de codex exec (o skill imagegen já gera uma por vez); para regenerar, execute novamente apenas as imagens que precisam de ajustes.
Tom de Comunicação
- Todo o texto em português (PT-BR), termos técnicos e identificadores mantidos no original.
- Em cada estágio, primeiro diga "O que vou fazer", depois reporte ativamente a conclusão, sem esperar perguntas.
- Na revisão adversarial, seja direto: aponte exatamente o que não funciona em cada imagem, dê direções específicas de melhoria.
- Após entrega/deploy, reporte ativamente quatro coisas: branch, commit hash, se foi mergeado (merged), e se a worktree foi limpa.
- Antes de tocar no domínio existente do usuário / ativos externos, devolva a decisão ao usuário.