Peça pro seu agente | Prompts

Prompts para colar no seu agente

Cada prompt está completo e diz o que fica pronto. Você copia, cola no seu agente e confere o resultado. A etapa indica onde ele entra no caminho.

Os marcados como "não testado" ainda não passaram pela nossa bancada. Quando testarmos, publicamos a data, a versão e o que deu errado.

Gravura em vinho de uma mão humana entregando um envelope a uma mão robótica

Prompt 01Etapa 1v1, não testado

Crie o arquivo que faz o agente lembrar do seu projeto

Por que o agente esquece como meu projeto funciona?

Quando usar: Logo no primeiro dia de um projeto, ou quando o agente repete o mesmo erro.
Para qual agente: Claude Code (CLAUDE.md), Codex e Cursor (AGENTS.md)

prompt

Leia este repositório inteiro antes de escrever qualquer coisa.

Depois crie um arquivo AGENTS.md na raiz (se você for o Claude Code, crie CLAUDE.md com o mesmo conteúdo) com estas seções, em no máximo 60 linhas:

1. O que é o projeto, em 2 frases.
2. Stack: linguagem, framework, banco e hospedagem, com versões do package.json ou equivalente.
3. Comandos: instalar, rodar local, testar e fazer build. Só comandos que existem de verdade nos scripts.
4. Estrutura: as 5 a 8 pastas mais importantes e o que tem em cada uma.
5. Regras: padrões de código que você encontrou (nomes, formatação, onde ficam os componentes).
6. Não faça: arquivos e pastas que não devem ser alterados, como .env e migrações antigas.

Não invente nada. Se não souber alguma coisa, escreva "A CONFIRMAR" e me pergunte no fim.

O que fica pronto. Um AGENTS.md que o agente lê toda vez que você abre o projeto.

Como saber se deu certo. Existe um AGENTS.md (ou CLAUDE.md) na raiz com as 6 seções, os comandos rodam quando você copia e cola, e nada está inventado: o que faltou aparece como A CONFIRMAR.

Depois. Leia o arquivo gerado, corrija o que estiver errado e faça commit. Atualize sempre que o agente errar por falta de contexto.

Prompt 02Etapa 2v1, não testado

Peça uma revisão antes de colocar no ar

Como saber se posso fazer deploy sem quebrar nada?

Quando usar: Antes de todo deploy para produção.
Para qual agente: Claude Code, Codex, Cursor

prompt

Revise as mudanças desde o último commit publicado (use git diff main ou o branch que eu indicar).

Não altere nenhum arquivo ainda. Primeiro me entregue um relatório com:

1. Resumo do que mudou, em até 5 bullets.
2. Riscos: o que pode quebrar em produção, ordenado do mais grave ao menos grave.
3. Segurança: chaves, senhas ou tokens expostos no código; rotas sem validação de entrada.
4. Build: rode o comando de build e os testes que existirem e cole o resultado.
5. Veredito: "pode subir" ou "não suba ainda", com o motivo em uma frase.

Só depois de eu responder "pode corrigir" você mexe no código.

O que fica pronto. Um relatório de riscos e um veredito antes de cada deploy.

Como saber se deu certo. Você recebe o relatório com as 5 partes, o resultado do build colado e nenhum arquivo alterado antes de você responder "pode corrigir".

Depois. Se o veredito for "não suba ainda", peça a correção de um risco por vez e rode a revisão de novo.

Prompt 03Etapa 3v1, não testado

Faça o agente achar a causa do bug antes de mexer

Por que o agente corrige um bug e cria outro?

Quando usar: Quando aparece um erro e você não sabe de onde ele vem.
Para qual agente: Claude Code, Codex, Cursor

prompt

Tenho este erro:

[COLE AQUI A MENSAGEM DE ERRO COMPLETA]

Ele acontece quando: [DESCREVA O QUE VOCÊ FEZ ANTES DO ERRO]

Siga esta ordem e não pule etapas:

1. Reproduza o erro e me diga o comando que usou.
2. Liste até 3 causas possíveis, com o arquivo e a linha de cada uma.
3. Teste cada causa e diga qual se confirmou e como você sabe.
4. Proponha a menor correção possível. Mostre o diff antes de aplicar.
5. Depois de aplicar, rode de novo o passo 1 e confirme que o erro sumiu.

Não refatore nada que não seja necessário para corrigir este erro.

O que fica pronto. A causa do erro confirmada e a menor correção possível.

Como saber se deu certo. O agente mostra o comando que reproduz o erro, aponta uma causa confirmada, mostra o diff antes de aplicar e roda o comando de novo sem erro.

Depois. Se a correção funcionar, peça para o agente adicionar um teste que pegaria esse erro no futuro.

Toda terça: uma coisa construída com IA, como fizemos e o que você pode colocar no ar.

Grátis, em português. Cancele quando quiser.