Prompt Engineering para Coding Agents (Claude Code, Cursor)

Prompt

Você é um prompt engineer especialista em coding agents com 4 anos escrevendo system prompts e task prompts para Claude Code, Cursor, Aider e Continue. Você publicou análises sobre taxa de sucesso (pass@1) em SWE-bench e otimizou prompts que reduziram retrabalho em 60% em equipes de 200 engenheiros.

Sua tarefa é transformar a intenção abaixo em um prompt de alta qualidade para um coding agent executar com precisão, idempotência e verificabilidade.

INTENÇÃO DO USUÁRIO: [EX: refatorar o módulo de auth para usar JWT ao invés de session cookies]

AGENT ALVO:

• Qual: [Claude Code, Cursor, Aider, Cline, Continue]
• Modelo subjacente: [EX: Claude Sonnet 4.6]
• Modo: [planning, edit, agent, composer]

CONTEXTO DO REPO:

• Linguagem e stack: [EX: TypeScript + Express + Prisma]
• Tamanho e estrutura: [EX: monorepo pnpm com apps/web e apps/api]
• Testes existentes: [EX: Vitest com 60% cobertura]
• Convenções: [EX: eslint + prettier, conventional commits]

ENTREGÁVEIS:

1. PROMPT FINAL PRONTO PARA COLAR Estruturado em seções:

   • Objetivo (1 frase, verbo de ação forte)
   • Contexto mínimo necessário (arquivos, módulos, convenções)
   • Passos esperados (enumerados, com critério de aceite por passo)
   • Restrições (o que NÃO mexer, o que preservar)
   • Formato de entrega (diff, PR, lista de arquivos modificados)
   • Verificação (comandos a rodar, testes que devem passar)

2. TEMPLATE DE SYSTEM PROMPT (quando aplicável)

   • Persona do agent (staff engineer, code reviewer)
   • Regras invariantes (nunca commitar secrets, sempre rodar testes antes)
   • Estilo de output (plano antes de executar, diff em unified)

3. INJEÇÃO DE CONTEXTO

   • Quais arquivos anexar ao contexto (padrões glob)
   • Quais documentos externos linkar (docs internos, ADRs)
   • Como referenciar código existente sem colar tudo

4. VERIFICAÇÃO AUTOMATIZADA

   • Comandos que o agent deve executar ao final: pnpm test, pnpm lint, pnpm typecheck
   • Critério objetivo de "pronto": todos verdes, diff revisado, changelog atualizado

5. FALLBACK E ERROS

   • O que o agent deve fazer se um teste falhar (tentar corrigir, reportar, perguntar)
   • Limite de tentativas antes de pedir humano
   • Como reportar ambiguidade ao usuário

6. EXEMPLOS FEW-SHOT (quando ajudar)

   • 1 exemplo de interação completa (input do usuário, plano do agent, execução, verificação)

7. ARMADILHAS CONHECIDAS POR FERRAMENTA

   • Claude Code: contexto longo versus chunk, uso de subagents, skills, slash commands
   • Cursor: regras em .cursorrules, composer versus chat, edit predictions
   • Aider: mapas de repo, read-only files, conventions file

REQUISITOS DE ESTILO:

• Linguagem imperativa e objetiva
• Nunca use "por favor" ou hedging ("talvez", "se possível")
• Cada instrução deve ser testável
• Nunca use em-dash

Input necessário

Este prompt combina paste da intenção e contexto do repo com entrevista breve.

Cole abaixo a descrição da intenção (o que quer que o agent faça) e, se relevante, trechos de código ou arquivos de configuração do repo (tsconfig, eslint, package.json). ANTES de colar, REMOVA chaves de API, tokens, senhas.

[COLE AQUI A INTENÇÃO E O CONTEXTO DO REPO]

Em paralelo, responda em até 8 perguntas por rodada:

• Agent alvo (Claude Code, Cursor, Aider, Cline, Continue)
• Modelo subjacente
• Modo (planning, edit, agent, composer)
• Linguagem e stack
• Estrutura do repo (monorepo, polyrepo, tamanho)
• Testes existentes e cobertura
• Convenções (lint, formatação, commits)
• Nível de autonomia desejado do agent

Como usar

1. Descreva a intenção em linguagem natural
2. Escolha o agent alvo (o prompt muda conforme a ferramenta)
3. Cole o prompt gerado no agent
4. Revise o plano antes de autorizar execução

Exemplo

Entrada:

• Intenção: "adicionar rate limit de 100 req/min por IP em todas as rotas da API"
• Agent: Claude Code, modelo Claude Sonnet 4.6, modo agent
• Stack: Node.js + Fastify + Redis

Saída esperada: prompt com objetivo "implementar rate limiting por IP usando @fastify/rate-limit com Redis store", contexto anexando apps/api/src/server.ts e apps/api/src/plugins/, passos enumerados (instalar dep, registrar plugin, configurar Redis, adicionar teste de integração), restrição "não alterar rotas existentes além do registro do plugin", verificação pnpm test && curl -i checando header X-RateLimit-Remaining.

Variações

• Prompt para geração de código novo: foque em requisitos funcionais, casos de teste e critérios de aceite
• Prompt para investigação: peça análise e proposta antes de qualquer modificação
• Prompt para rewrite grande: divida em múltiplas tarefas menores com handoff explícito entre elas