Recursos

Tutorial 45 min de leitura

Publique seu portfólio com Claude Code: workspace guiado

Escolha uma de três rotas e publique um portfólio operável: prompts únicos, checklists verificáveis, revisão segura e manutenção.

Você não precisa saber programar pra publicar um bom portfólio. Precisa especificar o que importa, limitar cada mudança e exigir prova do que foi verificado. Este workspace, um painel de trabalho que salva seu progresso, transforma isso em processo: seis etapas de entrega, uma área de manutenção e três rotas com consequências diferentes para site novo, base existente ou site pronto pra publicar.

Separe cerca de 45 minutos para ler e configurar o workspace. Executar a rota completa leva de 5,5 a 8,5 horas quando conteúdo e imagens precisam ser organizados; a rota de publicação leva de 1,5 a 2,5 horas se a verificação não revelar falhas. Tudo o que você marcar fica salvo neste navegador, sem cadastro.

Antes de entrar, tenha acesso de administrador ao computador, conta no GitHub (o serviço que guarda a pasta e o histórico do projeto), conta no Netlify (o serviço que publica o site na internet), acesso pago ao Claude Code ou créditos de API, a forma técnica de pagar pelo uso conforme o consumo, e a pasta do seu projeto. Se vai começar do zero, leve também conteúdo de pelo menos dois projetos. O workspace não inventa case, resultado nem responsabilidade que você não forneceu.

Ferramentas mudam; confira antes de começar

Guia verificado em 6 de agosto de 2026. O GitHub Free oferece quantidade ilimitada de repositórios públicos e privados, as pastas de projeto guardadas com histórico, e bloqueia arquivos acima de 100 MB. Contas novas do Netlify Free recebem 300 créditos mensais; cada deploy de produção, a publicação de uma nova versão, usa 15 créditos, cada GB de banda, um gigabyte de dados entregue aos visitantes, usa 20 e o site pausa sem cobrança ao esgotar. O Claude Code exige plano pago da Anthropic, a partir do Pro, ou créditos de API. O plano gratuito do Claude não inclui a ferramenta. As fontes oficiais mandam se os valores mudarem.

Do conteúdo cru ao portfólio no ar

Seis etapas de entrega e uma de manutenção, cada uma com objetivo, prompt e critério de validação. Resultado esperado: um site seu, publicado num endereço que qualquer pessoa consegue abrir na internet, com um recibo do que foi verificado. Seu progresso fica salvo neste navegador, sem cadastro.

De onde você está partindo?

Rota: quero construir um site novo

Ainda não tenho código ou quero recomeçar numa pasta vazia.

Você começa pela etapa 1

Tempo de execução estimado: 5,5 a 8,5 horas, normalmente divididas em dois blocos.

Tenha em mãos

  • Conteúdo de pelo menos dois projetos ou tempo reservado pra organizá-lo
  • Acesso de administrador ao computador pra instalar ferramentas

Risco principal

Começar pelo visual e deixar o Claude preencher lacunas com conteúdo genérico.

Rota: tenho um site ou template

Quero preservar, corrigir ou adaptar uma base que já existe.

Você começa pela etapa 2

Tempo de execução estimado: 4 a 7 horas, conforme o estado e a complexidade da base.

Tenha em mãos

  • Pasta local do projeto e permissão de uso do template, quando houver
  • Uma cópia segura ou histórico em Git antes da primeira alteração

Risco principal

Sobrescrever código útil, remover dependências necessárias ou violar a licença do template.

Rota: meu site está pronto

Quero verificar a base e publicar no GitHub e no Netlify.

Você começa pela etapa 2

Tempo de execução estimado: 1,5 a 2,5 horas, se a verificação não revelar falhas.

Tenha em mãos

  • Site abrindo localmente e conteúdo final revisado
  • Acesso às contas do GitHub e do Netlify

Risco principal

Enviar credenciais, escolher o repositório errado ou publicar uma build que só funciona localmente.

Glossário rápido dos termos que este guia usa
Terminal
A janela onde você digita instruções de texto pro computador. É por onde o Claude Code trabalha.
Git
O sistema que registra versões dos arquivos na sua máquina.
URL
O endereço exato de uma página na internet.
Repositório
A pasta do projeto hospedada no GitHub, com as versões registradas em commits.
Commit
Um ponto de salvamento com descrição. Cada commit é uma versão à qual dá pra voltar.
Push
Enviar seus commits da sua máquina pro GitHub.
Build
O processo que transforma o código na versão final do site.
Deploy
Publicar: pegar o build e disponibilizar na internet, numa URL.
Framework
Kit pronto de estrutura de código (Next.js, Astro). O Claude escolhe e justifica; você não precisa dominar.
Domínio
O endereço do site (seunome.com). Começa com um endereço gratuito do Netlify; domínio próprio é compra à parte.
API
A interface técnica usada por programas para conversar entre si. Créditos de API pagam esse uso conforme o consumo.
Token de acesso
Chave de acesso em formato de texto. Funciona como senha: nunca entra em código, repositório ou print.
MCP
Ponte padronizada entre a IA e serviços externos (com sua autorização). Opcional neste fluxo inteiro.
Variável de ambiente
Configuração que vive fora do código (ex: uma chave), definida na sua máquina ou no painel do Netlify.
SEO
Dados e estrutura que ajudam buscadores e cartões de compartilhamento a entender uma página.
Open Graph
Dados usados para montar o cartão de uma página quando o link é compartilhado.
Sitemap
Arquivo que lista as páginas públicas do site para mecanismos de busca.
Favicon
O pequeno ícone que identifica o site na aba do navegador.
GB de banda
Um gigabyte de dados entregue pelo site aos visitantes.

Progresso

0 de 6 etapas validadas na sua rota

Etapa 1 de 7 · 1 a 2 h

Conteúdo

Objetivo: separar bio, projetos, imagens e contato antes de abrir qualquer ferramenta.

Por que importa: é a única parte que nenhuma IA faz por você. Conteúdo pronto evita rodadas desnecessárias e tende a consumir menos limite de uso: o Claude não precisa voltar pra perguntar o que escrever.

Ação

Crie uma pasta pro projeto, copie o checklist abaixo para um arquivo chamado CONTEUDO.md dentro dela e preencha. Não precisa ficar perfeito. Precisa existir no lugar que o Claude vai ler durante a construção.

Limpe o conteúdo antes de salvar

Remova credenciais, dados pessoais de terceiros, nomes protegidos e qualquer material coberto por acordo de confidencialidade. Troque detalhes sensíveis por [CONFIDENCIAL].

Checklist pra copiarChecklist de preparação de conteúdo
PREPARAÇÃO DE CONTEÚDO

Identidade
[ ] Nome como quero aparecer
[ ] Título profissional em uma linha
[ ] Bio curta: 3 a 5 frases
[ ] Foto ou imagem de apresentação
[ ] Email profissional
[ ] Links: LinkedIn e o que mais fizer sentido

Trajetória
[ ] Experiências principais: empresa, cargo, período, uma linha do que fiz
[ ] Formação relevante

Projetos (2 a 4)
Para cada um:
[ ] Nome + uma frase de resumo
[ ] Imagem de capa
[ ] Contexto (produto, empresa ou estudo, momento)
[ ] Problema que existia
[ ] Minha responsabilidade específica
[ ] 2 ou 3 decisões importantes e o porquê
[ ] Resultado com fonte, ou aprendizado honesto
[ ] 3 a 6 imagens de processo ou solução

Direção
[ ] 3 referências visuais (links)
[ ] O que quero delas e o que NÃO quero
Ainda não tem conteúdo? Abra o kit inicial

Três ferramentas pra sair do zero. Nenhuma inventa nada por você: elas puxam o que já está na sua memória e na sua pasta de projetos antigos.

Template pra preencherTemplate de bio
Sou [NOME], [TÍTULO] com [X anos ou "experiência em"] [ÁREA].
Trabalho principalmente com [TIPO DE PRODUTO OU PROBLEMA].
Me interessa [O QUE TE MOVE NO DESIGN, uma frase concreta].
No momento, busco [OPORTUNIDADE].
Template pra preencherPerguntas pra recuperar um projeto antigo
Sobre aquele projeto que você lembra mas não documentou:
1. Qual era o produto e pra quem?
2. O que estava quebrado ou faltando quando você chegou?
3. O que VOCÊ fez, especificamente? (não o time: você)
4. Qual decisão gerou discussão? Como se resolveu?
5. O que mudou depois que entregou? (número, feedback, consequência)
6. Que imagem, print ou arquivo ainda existe disso?
Prompt pro Claude CodePrompt: organizar notas soltas
Vou colar notas soltas sobre um projeto meu. Organize no formato: resumo,
contexto, desafio, minha responsabilidade, decisões, resultado.
Use somente o que está nas notas: não invente nada. O que faltar vira
[FALTA: o quê]. No final, me faça as 3 perguntas que mais fortaleceriam o case.

Notas: [COLE AQUI]
Exemplo fictício, só pra calibrar

Um item de decisão bem escrito soa assim: "Optei por fluxo de cadastro em 2 telas em vez de 5 porque o funil mostrava 60% de abandono na tela 3; negociei com o time de dados a coleta progressiva depois do primeiro login". Esse exemplo é inventado e serve só de régua de especificidade: o seu precisa ser verdadeiro.

Funcionou se

Problema mais comum

Travar buscando o projeto perfeito. Dois projetos honestos e bem contados valem mais que quatro pela metade. Escolha os dois que você defenderia numa entrevista e siga em frente: dá pra adicionar o terceiro com um prompt de manutenção depois.

Etapa 2 de 7 · ~30 min

Contas e ambiente

Objetivo: Claude Code instalado, contas GitHub e Netlify criadas, cada peça testada.

Por que importa: erro de ambiente descoberto agora custa minutos; descoberto no meio da construção, custa a tarde.

O que custa o quê (agosto de 2026)

GitHub Free (abre em nova aba): repositórios públicos e privados ilimitados; arquivos acima de 100 MB são bloqueados (abre em nova aba). Netlify Free (abre em nova aba): contas novas recebem 300 créditos por mês; cada deploy de produção usa 15 e cada GB de banda usa 20. Ao esgotar, o site pausa sem cobrança. Claude Code (abre em nova aba): exige plano pago, a partir do Pro, ou créditos de API. O plano gratuito do Claude não inclui.

Ação 1: contas

Ação 2: instalar o Claude Code

Abra o Terminal (Cmd + Espaço, digite "Terminal") e cole:

No terminalmacOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

Abra o PowerShell (menu Iniciar, digite "PowerShell") e cole:

No terminalWindows
irm https://claude.ai/install.ps1 | iex

O instalador nativo oficial não exige Node.js. Depois, confirme que instalou:

No terminal
claude --version

Este fluxo também usa Git, o sistema que registra versões. Confira antes de começar:

No terminal
git --version

Comandos conferidos na documentação oficial de instalação (abre em nova aba) em agosto de 2026; se algo divergir, a documentação manda.

Primeiro diagnóstico em modo de planejamento

O modo padrão pode executar ações de leitura sem pedir confirmação a cada uma. Para inspecionar e planejar sem editar arquivos, inicie a primeira sessão assim:

No terminal
claude --permission-mode plan

Durante uma sessão, Esc interrompe a ação atual e /rewind abre o histórico de etapas pra voltar a um estado anterior. Esses controles ajudam, mas não substituem commits revisados no Git.

E o MCP? Preciso conectar alguma coisa?

Não precisa. MCP é a ponte que deixa o Claude operar serviços externos (como o Netlify) direto, com a sua autorização. É opcional: o Claude Code conversa com GitHub e Netlify pelo terminal sem ponte nenhuma, e este guia funciona inteiro assim.

Se quiser ligar a ponte do Netlify mesmo assim, use o guia oficial do Netlify pra Claude Code (abre em nova aba). A autenticação é por login autorizado no navegador. Nunca cole token ou senha em arquivo do projeto, código ou print.

Funcionou se

Problema mais comum

"Comando não encontrado" depois de instalar: feche o terminal por completo e abra de novo (a instalação só registra o comando em janelas novas). Se persistir, cole a mensagem de erro no chat do Claude no navegador e peça o diagnóstico: vale usar a IA pra destravar a instalação da própria IA.

Etapa 3 de 7 · ~30 min

Briefing e plano

Objetivo: CONTEUDO.md e BRIEFING.md preenchidos, um plano aprovado no chat e a versão final salva em PLANO.md.

Por que importa: um briefing específico tende a consumir menos limite de uso que uma conversa caótica com cinquenta correções, e o plano é sua primeira etapa de revisão: corrigir rumo em texto custa uma frase.

Diagnóstico antes de publicar

Objetivo: um diagnóstico de publicação revisado, sem alterar nem enviar nada.

Por que importa: a verificação separa um site pronto na sua máquina de um site seguro pra enviar: destino, build, arquivos grandes e credenciais precisam estar explícitos antes da publicação.

Ação 1: gere seu prompt inicial

O CONTEUDO.md da etapa 1 continua como fonte. Aqui, o gerador cria BRIEFING.md e o prompt de diagnóstico sem sobrescrever sua matéria-prima. Nada do que você digita é enviado, salvo ou processado por IA.

Como esta rota pode ter pulado a preparação, o gerador cria CONTEUDO.md, BRIEFING.md e o prompt de diagnóstico. Nada do que você digita é enviado, salvo ou processado por IA.

Retire o que não pode ser publicado

Não cole credenciais, dados pessoais de terceiros, nomes protegidos nem material coberto por acordo de confidencialidade. Troque detalhes sensíveis por [CONFIDENCIAL] antes de preencher.

Você e a oportunidade

Exemplo: Product Designer focada em produtos B2B

Exemplo: vaga plena em fintech ou projetos de UI

Email profissional ou outro canal que pode aparecer no site

Duas ou três frases factuais sobre o que você faz e o tipo de problema que resolve

Matéria-prima dos projetos

Pra cada projeto, inclua contexto, problema, sua responsabilidade, restrições, decisões, evidências, solução, resultado e aprendizados. O que faltar continuará marcado.

Escopo mínimo

Quem precisa entender e confiar neste portfólio

Base técnica é a combinação de ferramentas do projeto. Em branco, o Claude propõe e justifica.

Limites e critério de pronto

O que não pode ser inventado, alterado, publicado ou instalado

Provas observáveis, como rotas abertas, conteúdo revisado e build aprovado

Refinar a direção visual

Três adjetivos valem mais que um parágrafo

Nome ou código. Em branco, a decisão fica aberta no briefing.

Links e o critério que você quer aproveitar de cada um

Complemento: direção visual em dez respostas

Cole no seu BRIEFING.md e responda. É o que dá critério visual ao Claude em vez do gosto médio da internet.

Template pra preencherDireção visual
DIREÇÃO VISUAL

1. Três adjetivos que o site deve transmitir: [ ]
2. Três referências e o que aproveitar de cada uma: [ ]
3. Animação: nenhuma, sutil ou presente? [ ]
4. Densidade: arejada ou compacta? [ ]
5. Contraste: suave ou marcado? [ ]
6. Cor principal e por quê: [ ]
7. Fonte: com serifa, sem serifa ou uma de cada? [ ]
8. Fotografia real, ilustração ou nenhuma? [ ]
9. O que o visitante deve sentir em 5 segundos: [ ]
10. O que o site NÃO pode parecer de jeito nenhum: [ ]

Ação 2: planeje no chat

Crie uma pasta pro projeto e abra o terminal dentro dela: digite cd seguido de um espaço, arraste a pasta pra dentro da janela do terminal (o caminho se preenche sozinho) e aperte Enter. Depois rode claude --permission-mode plan. Confirme que CONTEUDO.md e BRIEFING.md estão nessa pasta, depois cole o diagnóstico gerado. O Claude deve ler os dois arquivos, devolver o plano no chat e parar sem criar nem alterar arquivos.

Abra a pasta do projeto existente e abra o terminal dentro dela: digite cd seguido de um espaço, arraste a pasta pra dentro da janela do terminal (o caminho se preenche sozinho) e aperte Enter. Depois rode claude --permission-mode plan. Confirme que CONTEUDO.md e BRIEFING.md estão nessa pasta, depois cole o diagnóstico gerado. O Claude deve ler os dois arquivos, devolver o plano no chat e parar sem criar nem alterar arquivos.

Leia o plano de verdade

Esse é o momento mais barato de todo o processo pra mudar de ideia. Se o plano propõe cinco páginas e você pediu uma, corrija agora, em português: "refaça o plano com uma página só".

Ação 3: salve o plano aprovado

Quando o plano estiver certo, pressione Shift+Tab até voltar ao modo padrão, no qual alterações pedem aprovação. Só então cole este prompt. Ele salva a versão aprovada em PLANO.md sem começar a construção.

Prompt pro Claude CodeDepois da aprovação: salvar o plano
Saí do modo de planejamento e aprovei o plano apresentado no chat.
Salve exatamente esse plano em um arquivo chamado PLANO.md dentro da pasta atual.
Não implemente nenhuma etapa, não instale nada e não altere outro arquivo.
Ao terminar, informe apenas o caminho do PLANO.md criado e pare.

Funcionou se

Problema mais comum

Aprovar o plano sem ler, "porque a IA sabe o que está fazendo". Ela sabe construir; o que construir é decisão sua. Muitos problemas caros das próximas etapas começam num plano aprovado no piloto automático.

Ação: diagnostique sem alterar

Abra o terminal na pasta do site, inicie o Claude Code em Plan Mode, o modo de planejamento que permite inspecionar sem editar, e cole o diagnóstico abaixo. Ele deve devolver as evidências no chat e parar antes de qualquer envio.

Prompt pro Claude CodeDiagnóstico da sua rota
Você vai fazer a verificação de um site pronto antes da publicação.

1. Confirme a pasta atual, a base técnica e o comando de build existente.
2. Verifique o estado do Git, arquivos acima de 100 MB, arquivos .env, credenciais e dados pessoais. Não repita nenhum segredo.
3. Identifique o comando de build já definido, mas não o execute nesta etapa de leitura.
4. Liste a pasta de publicação, as variáveis de ambiente apenas pelo nome e as rotas que precisam ser abertas.
5. Mostre o repositório do GitHub e o site do Netlify que pretende usar como destino e aguarde minha confirmação.

Não altere o código, não crie arquivos, não instale nada e não faça envio nem deploy. Devolva o diagnóstico no chat e pare.
Leia o destino antes de autorizar

O diagnóstico precisa mostrar a pasta atual, o repositório do GitHub e o site do Netlify que pretende usar. Um destino ambíguo não é detalhe. É motivo pra parar.

Funcionou se

Problema mais comum

Ler um build verde como autorização de publicação. O build prova que o projeto foi montado; não prova que o destino está certo nem que o repositório está livre de dados que não deveriam sair da sua máquina.

Etapa 4 de 7 · 2 a 4 h

Construção

Objetivo: o escopo aprovado implementado em etapas fechadas, com sua revisão entre elas.

Por que importa: prompts com escopo limitado evitam o efeito 'pedi um ajuste no rodapé, recebi um site redesenhado' e mantêm o consumo de uso sob controle: se o limite acabar, o progresso está salvo nos arquivos e você continua na sessão seguinte.

Rode um prompt por vez. Entre um e outro, abra o site no navegador e revise. O padrão dos seis: objetivo declarado, escopo limitado, reutilizar o que existe, proibir o resto, validar antes de concluir.

A regra de ouro da etapa

Faça assim

Um prompt, uma revisão sua no navegador, o próximo prompt.

Evite

Colar os seis prompts de uma vez e voltar em uma hora pra ver no que deu.

Prompt pro Claude CodePrompt 2: fundação visual
Execute esta etapa apenas se a fundação visual estiver no PLANO.md aprovado. Implemente tipografia, escala de espaçamento, cores com contraste adequado, grid e navegação.
Use o BRIEFING.md como fonte das decisões visuais.
Preserve toda estrutura existente que o plano não colocou no escopo. Não crie conteúdo nem páginas além do esqueleto de navegação.
Não altere arquivos fora do projeto.
Ao terminar, rode o projeto localmente e informe a URL exata pra abrir no navegador.
Não avance pra próxima etapa.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.
Prompt pro Claude CodePrompt 3: página inicial
Execute esta etapa apenas se a página inicial estiver no PLANO.md aprovado. Implemente a página com o conteúdo real de BRIEFING.md e CONTEUDO.md: apresentação, projetos em destaque, resumo de experiência e contato.
Não invente texto, número, cargo ou resultado. Onde faltar conteúdo, insira [PREENCHER] e liste todos os marcadores no final.
Reutilize a fundação visual pronta. Preserve toda estrutura existente que o plano não colocou no escopo. Não altere tipografia nem cores.
Abra a página no navegador e verifique navegação, conteúdo e erros no console, a área que mostra mensagens técnicas do site.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.
Prompt pro Claude CodePrompt 4: projetos
Execute esta etapa apenas se projetos estiverem no PLANO.md aprovado. Leia BRIEFING.md, CONTEUDO.md e a arquitetura aprovada no plano.
Se o plano define página única, crie ou complete a seção de projetos e estudos de caso nessa mesma página. Se define arquitetura completa, crie a listagem e as páginas individuais previstas. Use estas seções quando houver material: resumo, contexto, desafio, minha responsabilidade, decisões, evidências e resultado.
Preencha apenas com o conteúdo de CONTEUDO.md. Texto que não existe vira [PREENCHER], nunca invenção.
Preserve toda estrutura existente que o plano não colocou no escopo. Não altere a fundação visual.
No final, liste as seções ou páginas criadas, os endereços de acesso e os marcadores pendentes.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.
Prompt pro Claude CodePrompt 5: responsividade e acessibilidade
Revise o site inteiro em três larguras de tela: 375 px, 768 px e 1280 px. Corrija apenas problemas de layout, sem redesenhar.
Faça uma revisão de acessibilidade: navegação por teclado, foco visível, contraste, texto alternativo em imagens, hierarquia correta de títulos e respeito a prefers-reduced-motion, a preferência do sistema por menos animação.
Não declare que um leitor de tela foi testado se você não tiver executado esse teste.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.
Prompt pro Claude CodePrompt 6: conteúdo e SEO
Configure o básico de SEO, o conjunto de dados que ajuda buscadores e cartões de compartilhamento a entender o site, sem instalar dependências novas.
Inclua título e descrição únicos por página, Open Graph para o cartão de preview, sitemap.xml para listar as páginas, favicon para o ícone da aba e URLs limpas.
Aponte textos confusos ou genéricos, mas não os reescreva sem me mostrar antes.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.
Prompt pro Claude CodePrompt 7: revisão final
Rode o build de produção, a geração da versão final do site, e corrija apenas erros causados ou pertencentes a este projeto.
Depois verifique links quebrados, imagens ausentes, marcadores [PREENCHER], páginas órfãs e erros no console do navegador.
Não adicione nenhuma funcionalidade nova. Se encontrar um problema fora do escopo ou não relacionado, pare e reporte antes de mudar.

Entregue um recibo de prontidão com:
1. comando executado e código de saída;
2. rotas verificadas e resultado de cada uma;
3. larguras de tela abertas no navegador;
4. erros de console encontrados;
5. pendências que dependem de mim;
6. qualquer item que não conseguiu verificar. Não trate ausência de teste como aprovação.

Funcionou se

Problema mais comum

O Claude "melhorar" coisas que você não pediu. Não brigue: reforce o escopo. "Você alterou X e eu não pedi. Desfaça só isso e mantenha o resto". Depois, confira a lista de arquivos alterados e o resultado no navegador.

Etapa 5 de 7 · ~1 h

Revisão

Objetivo: passar o site pelas cinco lentes que separam 'no ar' de 'pronto': conteúdo, experiência, acessibilidade, desempenho, SEO.

Por que importa: o prompt 7 audita o que é automatizável; esta etapa cobre o que só olho humano pega, tipo um case que tecnicamente funciona mas não convence.

Antes da revisão humana: prove o build

O diagnóstico anterior aconteceu em Plan Mode. Pressione Shift+Tab até voltar ao modo padrão, depois rode o prompt 7. Ele executa o build de produção e separa o que foi verificado do que ainda depende de você, sem publicar nada.

Prompt pro Claude CodePrompt 7: revisão final
Rode o build de produção, a geração da versão final do site, e corrija apenas erros causados ou pertencentes a este projeto.
Depois verifique links quebrados, imagens ausentes, marcadores [PREENCHER], páginas órfãs e erros no console do navegador.
Não adicione nenhuma funcionalidade nova. Se encontrar um problema fora do escopo ou não relacionado, pare e reporte antes de mudar.

Entregue um recibo de prontidão com:
1. comando executado e código de saída;
2. rotas verificadas e resultado de cada uma;
3. larguras de tela abertas no navegador;
4. erros de console encontrados;
5. pendências que dependem de mim;
6. qualquer item que não conseguiu verificar. Não trate ausência de teste como aprovação.

Revisão de qualidade

Marque apenas o que você verificou.

Conteúdo

Experiência

Acessibilidade

Desempenho

SEO e compartilhamento

Problema mais comum

Marcar "acessibilidade ok" sem testar. O teste mínimo honesto: desligue o mouse e navegue o site inteiro com Tab e Enter. Se você se perder ou o foco sumir, seu visitante também vai. Leve o problema pro Claude com o prompt de acessibilidade da etapa de manutenção.

Etapa 6 de 7 · ~30 min

Publicação

Objetivo: repositório no GitHub conectado ao Netlify, primeiro deploy verde, URL pública no ar.

Por que importa: se a publicação contínua, a conexão que refaz o site a cada envio ao GitHub, estiver configurada, cada atualização futura pode acionar uma nova publicação. É o circuito que mantém o portfólio atualizável.

O caminho até o site publicado
  1. Vocêdecide e revisa
  2. Claude Codelê, cria e testa
  3. Arquivos locaiso site no seu computador
  4. GitHubguarda o histórico
  5. Netlifycompila e hospeda
  6. Site no arsua URL pública

Ação 1: valide a revisão

Antes de conectar no Netlify, revise os destinos e rode a validação:

Prompt pro Claude CodeValidação pré-deploy
Vou conectar este projeto ao Netlify. Me responda:
1. Confirme a pasta atual, o repositório do GitHub e o site de destino no Netlify. Pare se algum destino for ambíguo.
2. Qual é o comando de build e qual pasta contém o site pronto?
3. Rode o build de produção local e reporte o comando e o código de saída.
4. Alguma variável de ambiente é necessária? Liste só os nomes, nunca os valores.
5. Algo depende de uma versão específica do Node, o programa que executa a montagem de muitos sites? Mostre onde está definido.
6. Liste as rotas que eu preciso abrir depois do deploy.
Se encontrar problema, reporte a causa e a correção proposta. Não altere nem envie nada antes da minha confirmação.

Ação 2: publique com confirmação

Depois de ler a validação e resolver qualquer pendência, use o prompt de publicação. Ele exige confirmação dos destinos antes de cada envio.

Prompt pro Claude CodePrompt 8: GitHub e publicação
Prepare o projeto pra publicação. Confira se o .gitignore, o arquivo que impede o envio de itens locais, exclui node_modules, a pasta de pacotes instalados, arquivos .env de configuração local e qualquer credencial.
Revise os arquivos procurando segredos ou dados pessoais que não devem ser públicos. Se encontrar uma credencial, informe o tipo e o arquivo, sem repetir o valor.
Confirme a pasta atual, o repositório do GitHub e o site de destino no Netlify. Mostre os três destinos e espere minha confirmação.
Depois me guie, um passo de cada vez, para registrar a versão em Git, enviar ao GitHub e conectar o repositório ao Netlify.
Espere minha confirmação antes de cada envio. Nunca desative proteções, nunca exponha valores de variáveis de ambiente e nunca publique em outro destino por suposição.

Ao terminar, entregue um recibo curto com:
- arquivos alterados;
- comando de verificação executado e código de saída, o número que indica sucesso ou falha;
- o que você verificou no navegador;
- o que não conseguiu verificar e ainda depende de revisão humana.

No Netlify: Add new project, importar do GitHub, escolher o repositório, conferir os dois campos que a validação te deu (comando de build e pasta de publicação) e confirmar. O Netlify mostra o estado da tentativa e, quando terminar, entrega a URL pública. Abra essa URL antes de considerar a publicação concluída.

Deu errado? Os 8 problemas clássicos e o conserto de cada um

O build falhou no Netlify

Abra o log do deploy, o registro textual da tentativa, e localize o primeiro erro. Antes de copiar, apague tokens, valores de variáveis, emails e dados pessoais.

Prompt pro Claude Code
O deploy no Netlify falhou. Base técnica: [INFORME]. Primeiro erro do log, já sem credenciais ou dados pessoais: [COLE]. Diagnostique a causa antes de editar, explique em linguagem simples e proponha a menor correção. Aguarde minha aprovação.

A página abre em branco

Abra o console do navegador, a área de mensagens técnicas em Inspecionar, e localize o primeiro erro. Remova qualquer dado sensível antes de copiar.

Prompt pro Claude Code
O site publicou mas abre em branco. Base técnica: [INFORME]. Primeiro erro do console, já sem dados sensíveis: [COLE]. Identifique a causa antes de editar e proponha a menor correção. Aguarde minha aprovação.

Uma rota funciona na home, mas dá 404 ao recarregar

Esse sintoma pode vir da estratégia de geração de páginas ou da configuração de rotas. Descubra qual delas o projeto usa antes de adicionar redirecionamentos.

Prompt pro Claude Code
A rota [URL] abre pela navegação, mas dá 404 ao recarregar no Netlify. Identifique a base técnica e se o projeto usa páginas estáticas, geradas antes da visita, renderização no servidor, gerada a cada pedido, ou página única. Diagnostique a causa e mostre a correção proposta antes de editar.

Imagens não carregam no site publicado

Compare o endereço pedido pelo navegador com o nome e a localização reais do arquivo. Maiúsculas, pasta pública e configuração de imagem são hipóteses, não diagnóstico.

Prompt pro Claude Code
A imagem [URL] funciona localmente mas não no site publicado. Verifique o pedido de rede, o caminho, maiúsculas no nome, pasta pública e configuração da base técnica. Diga qual hipótese foi provada antes de corrigir.

Erro citando variável de ambiente ausente

Configuração que existe na sua máquina mas não no Netlify. Adicione no painel: Site configuration, Environment variables. Nunca resolva colando o valor no código.

Prompt pro Claude Code
O build reclama de variável de ambiente ausente: [NOME]. Me diga pra que ela serve, onde configurá-la no Netlify e confirme que o valor não está escrito em nenhum arquivo do repositório.

Erro de versão do Node

Node é o programa que executa a montagem de muitos sites. Compare a versão local, a exigida pelo projeto e a usada no Netlify antes de fixar qualquer número.

Prompt pro Claude Code
O deploy indica versão do Node incompatível: [ERRO]. Compare a versão local, package.json, o arquivo que lista pacotes e comandos do projeto, arquivos de configuração e o log do Netlify. Proponha onde registrar a versão compatível e aguarde minha aprovação.

Dependência ausente no build

Dependência é um pacote que o projeto usa. Descubra se ela está ausente da lista do projeto, se o nome está errado ou se o arquivo foi importado por engano.

Prompt pro Claude Code
O build no Netlify falha por módulo não encontrado: [NOME]. Verifique package.json, a lista de pacotes e comandos, o arquivo que fixa versões e a importação que falhou. Diga qual causa foi provada antes de instalar, remover ou alterar qualquer pacote.

Funciona na minha máquina, quebra em produção

Ambiente local e produção podem divergir em versão, configuração, arquivos e letras maiúsculas. Compare evidências antes de escolher uma causa.

Prompt pro Claude Code
O site funciona localmente mas quebra em produção: [DESCREVA]. Compare versão do Node, variáveis apenas pelos nomes, arquivos enviados, caminhos e log do Netlify. Teste uma hipótese por vez e só corrija a causa comprovada.

Funcionou se

Problema mais comum

Deploy verde, site com cara de quebrado: duas causas comuns são imagem com caminho errado e rota que dá 404 ao recarregar. Não escolha por palpite. Os dois sintomas estão no bloco de problemas aqui em cima, com um diagnóstico guiado.

Etapa 7 de 7 · contínua

Manutenção

Objetivo: atualizar o site sem reconstruí-lo do zero: cada mudança é um prompt pequeno de escopo fechado.

Por que importa: portfólio desatualizado envelhece mal. Com o circuito montado, um projeto novo vira uma alteração pequena, revisável e publicada pelo mesmo caminho.

Os dez pedidos mais comuns do dia a dia, prontos pra copiar. O padrão de todos: alterar só o necessário, build verde antes de concluir.

Adicionar um projeto
Prompt pro Claude Code
Adicione um novo projeto usando o template de case existente. Conteúdo: [COLE]. Inclua na listagem e, se merecer, um destaque na home. Não altere os outros projetos nem o layout. Rode o build e confirme.
Atualizar a bio
Prompt pro Claude Code
Atualize minha bio em todos os lugares onde ela aparece pra: [NOVA BIO]. Não mude mais nada. Liste os arquivos alterados.
Trocar uma imagem
Prompt pro Claude Code
Substitua a imagem [QUAL, ONDE] por [NOVO ARQUIVO]. Otimize o peso, mantenha as dimensões do layout e confira o texto alternativo. Não toque em mais nada.
Atualizar o currículo ou experiência
Prompt pro Claude Code
Atualize a seção de experiência com: [MUDANÇA]. Mantenha o formato das entradas existentes. Me mostre a lista exata de alterações antes de finalizar.
Criar uma página nova
Prompt pro Claude Code
Crie uma página nova: [PROPÓSITO]. Reutilize a fundação visual e a navegação existentes. Adicione o link no menu. Não redesenhe nada do que já existe.
Corrigir um bug
Prompt pro Claude Code
Em [ONDE], acontece [O QUÊ] quando [AÇÃO]; deveria [COMPORTAMENTO ESPERADO]. Diagnostique a causa antes de mexer, corrija só o necessário e me diga o que era. Build verde antes de concluir.
Melhorar SEO
Prompt pro Claude Code
Faça uma revisão de SEO: títulos e descrições únicos, Open Graph, sitemap atualizado, links internos. Me devolva a lista do que mudou e por quê. Não altere o conteúdo visível sem me mostrar.
Revisar acessibilidade
Prompt pro Claude Code
Rode uma revisão de acessibilidade: teclado, foco visível, contraste, texto alternativo, hierarquia de títulos e preferência por menos movimento. Corrija o que for objetivo e me liste o que exige decisão minha.
Atualizar dependências
Prompt pro Claude Code
Atualize as dependências do projeto com segurança: uma de cada vez nas críticas, rodando o build entre elas. Se algo quebrar, reverta e me explique. No final, resumo do que subiu de versão.
Publicar uma nova versão
Prompt pro Claude Code
Revise as alterações desde o último commit (segredos, arquivos desnecessários), rode o build, prepare um commit descritivo e me guie no push. Confirmo o destino antes do envio.

Guia completo. O site é seu: a partir daqui, ele evolui no seu ritmo, um prompt de cada vez.

O método por trás do workspace

Este guia é a versão operacional de um argumento maior sobre trabalhar com IA sendo designer: o valor não está em decorar prompts, está em organizar contexto, limitar escopo e revisar com olho de dono. O resultado é um portfólio operável, cujo conteúdo você controla, cuja publicação você consegue explicar e cuja verificação você consegue provar. O raciocínio completo, com os quatro vícios do portfólio feito por IA e o modelo de estudo de caso que foge do formato escolar, está no artigo Como criar e publicar seu portfólio com Claude Code, mesmo sem saber programar.

Pra continuar dali:

#Claude Code#Portfólio#GitHub#Netlify#Tutorial

Continue lendo

Ver todos os recursos →

Depois de aplicar isso

Se quiser fazer no seu caso, com alguém olhando junto, a mentoria 1:1 é individual e trabalha em cima do seu material. Se preferir seguir sozinho, o handbook e os sete métodos são abertos.

Conhecer a mentoria Ler o handbook