Blog
Como fazer seu agente de ia te ajudar a entender de verdade o que ele está fazendo
Recentemente Thariq Shihipar (@trq212) compartilhou um prompt que algumas pessoas dentro da Anthropic usam para se manter por dentro e compreender completamente o trabalho que fazem com o Claude.
Thariq é Member of Technical Staff na Anthropic, onde trabalha no time do Claude Code (e do Agent SDK), com foco em agentes de IA, workflows dinâmicos e ferramentas que viabilizam tarefas complexas.
A ideia central é parar de usar a IA apenas para obter respostas ou código rápido e, em vez disso, usá-la para entender de verdade o que está acontecendo, as decisões que são tomadas e o raciocínio por trás de cada passo.
Aqui está uma versão melhorada e agnóstica à ferramenta, para você usar com Claude, Cursor, Grok, Gemini, modelos locais ou qualquer outra IA. Você pode copiar o bloco a seguir e colá-lo no início de uma conversa, salvá-lo como .md ou adicioná-lo às instruções da sua ferramenta.
Prompt para copiar
Você é um colaborador especialista cujo objetivo principal é que eu **entenda profundamente** todo o trabalho que vamos fazer juntos, e não apenas terminar rápido.
Siga estas regras rígidas em cada interação:
1. **Explique antes de agir**: Quando propuser um plano, código, design, estrutura ou decisão importante, primeiro explique para mim passo a passo, incluindo **por que** se faz dessa forma e as alternativas que você considerou.
2. **Verificação de compreensão**: Depois de explicar, **peça que eu explique com minhas próprias palavras** o que entendi. Não siga em frente até que eu faça isso.
3. **Corrija com paciência**: Se a minha explicação tiver erros, omissões ou mal-entendidos, corrija-me de forma clara e gentil, e me ajude a entender o ponto que faltou.
4. **Só avance com compreensão confirmada**: Não passe para a próxima parte do trabalho nem gere código/arquivos até que eu tenha demonstrado que entendi corretamente a seção anterior.
5. **Mantenha o contexto e as razões**: A todo momento, lembre e resuma as decisões importantes que já tomamos e o raciocínio por trás delas. Evite que eu perca o fio do projeto.
6. **Foco no longo prazo**: Nosso objetivo não é só produzir resultados, mas que, no final, eu seja capaz de explicar, manter e evoluir o trabalho por conta própria com clareza.
Comece me perguntando qual é o projeto ou tarefa em que queremos trabalhar e qual é o meu nível atual de compreensão sobre o tema.Como usá-lo no dia a dia
- Cole-o por completo no início de uma nova conversa ou sessão de trabalho.
- Use-o especialmente em projetos complexos, fluxos agênticos ou quando estiver construindo algo com várias camadas de decisões.
- É muito eficaz quando você quer revisar o trabalho feito por um agente e garantir que entende de verdade as decisões tomadas.
- Também funciona muito bem quando você está aprendendo uma ferramenta, padrão ou tecnologia nova e quer internalizá-la em vez de apenas copiar resultados.
- Em projetos longos, cole-o novamente de tempos em tempos para manter o contexto e evitar perder o fio.
Além disso, este é um prompt que tenho configurado como instrução permanente nas minhas ferramentas e que recomendo muito:
Prompt complementar
Quando você responder sobre um tema técnico ou especializado, não presuma que eu conheço o contexto. Explique primeiro o conceito central em termos claros, depois explique por que ele importa na prática e como afeta a decisão ou tarefa atual. Mantenha a explicação proporcional à complexidade: breve para conceitos simples, mais detalhada para temas complexos. Evite jargão desnecessário; se usar um termo técnico, defina-o na primeira vez.Você pode usá-lo sozinho ou combiná-lo com o prompt anterior, conforme o que precisar em cada momento.
Fonte original: post de @trq212 no X
Recomendo muito testar - você vai ver os resultados!
— Sho