Não comece pedindo código pro Claude — peça contexto primeiro

Eu não começo uma sessão no Claude pedindo código direto. Primeiro eu faço ele entender o projeto, o padrão e a tarefa. Só depois deixo ele escrever uma linha.

Parece bobo, mas é a diferença entre o Claude agir como autocomplete — chutando solução no escuro — e trabalhar como alguém que precisa entender antes de executar.

Por que pedir código direto sai mais caro

Quando você pede código na primeira mensagem, o Claude assume um monte de coisa pra te entregar algo:

• Assume a estrutura do projeto (e quase sempre erra o padrão que você já usa).
• Assume o fluxo atual (e reescreve coisa que já existia funcionando).
• Assume que a tarefa é simples (e ignora o risco de quebrar outra parte).

O resultado vem rápido, mas vem errado no detalhe. E corrigir detalhe é o que mais consome tempo numa sessão de IA.

A virada: direção antes de execução

A regra é simples e tem 3 fases, nessa ordem:

1. Entender — ler só o que importa, mapear o fluxo atual.
2. Explicar o plano — me mostrar o que pretende fazer antes de fazer.
3. Implementar — só depois que o plano faz sentido.

Quando o Claude segue essa ordem, ele para de chutar. Pergunta o que falta, aponta risco, sugere o caminho mais simples — e quando começa a codar, já está codando a coisa certa.

O prompt (copia, cola e usa no início da sessão)

Esse é o prompt que eu colo antes de pedir qualquer alteração de código:

Antes de alterar qualquer código, primeiro entenda o contexto do projeto.
Leia apenas os arquivos realmente relevantes para essa tarefa, identifique o fluxo atual e me explique o plano antes de implementar qualquer mudança.
Não saia criando solução no escuro.
Se faltar contexto, me pergunte antes de assumir qualquer coisa.
Se existir uma forma mais simples de resolver, me avise.
Se a mudança puder quebrar algo, aponte o risco antes.
Se encontrar código repetido, regra confusa ou algo que possa ser melhorado, me sinalize antes de alterar.
Quero que você trabalhe como um dev sênior analisando o problema antes de sair codando.
Primeiro: entenda.
Depois: explique o plano.
Só depois: implemente.

Cola no começo da conversa, antes de descrever a tarefa. Depois é só dizer o que você precisa — o Claude vai responder com o plano primeiro, não com código.

Por que cada linha está ali

Nenhuma linha é enfeite. Cada uma corta um tipo de erro que eu já cansei de ver:

• "Leia apenas os arquivos realmente relevantes" — evita o Claude varrer o projeto inteiro e se perder. Foco no que importa pra tarefa.
• "me explique o plano antes de implementar" — te dá um ponto de revisão antes de qualquer código existir. É aqui que você pega o erro de graça.
• "Se faltar contexto, me pergunte" — troca o chute por pergunta. Uma pergunta custa 10 segundos; um chute errado custa meia hora.
• "Se existir uma forma mais simples, me avise" — abre espaço pra IA sugerir o caminho curto em vez de só obedecer o que você pediu.
• "Se a mudança puder quebrar algo, aponte o risco antes" — transforma o Claude em revisor, não só em executor.
• "Se encontrar código repetido ou regra confusa, me sinalize" — vira um pente-fino do código enquanto resolve a tarefa.
• "Trabalhe como um dev sênior" — muda a postura. Sênior entende o problema antes de abrir o editor; júnior sai codando.

Como uso na prática

Colo o prompt, descrevo a tarefa e espero o plano. Leio o que ele entendeu do fluxo atual e o que pretende mudar.

Se o plano está certo, mando "pode implementar". Se ele perguntou algo, respondo. Se ele apontou um caminho mais simples, geralmente sigo.

Só libero o código depois que o plano faz sentido. Esse minuto a mais de leitura economiza horas de desfazer.

Fechamento

A maior parte do tempo perdido com IA não é por falta de prompt — é por pedir execução antes de garantir entendimento.

Inverte a ordem: entender, explicar o plano, depois implementar. É isso que separa quem usa IA como autocomplete de quem usa como um dev sênior do lado.

Se quer esse prompt pronto pra colar (e mais alguns que uso pra revisão de código e planejamento de tarefa), comenta PROMPT no meu Instagram que eu te mando no direct.