Como Escrever Prompts para Codigo: 20

A anatomia de um prompt bom para codigo

Antes dos templates, voce precisa entender por que alguns prompts funcionam e outros nao. A diferenca entre 'arruma esse codigo' e um prompt que gera resultado util nao e magica. E estrutura.

Todo prompt bom pra codigo tem 4 elementos. Nem sempre voce precisa dos 4, mas quanto mais voce incluir, melhor o resultado.

Contexto + Instrucao + Formato + Restricoes

Vou dar um exemplo concreto. Esse prompt ruim gera resultado generico:

E esse prompt com estrutura gera resultado utilizavel:

A diferenca no resultado e absurda. O primeiro vai te dar sugestoes vagas. O segundo vai te dar codigo pronto pra usar.

Templates de refatoracao

Refatoracao e onde a IA mais brilha porque o comportamento esperado ja existe. Voce quer o mesmo resultado com codigo melhor. Aqui vao 5 templates que eu uso toda semana.

Template 1: Extrair logica para service

Template 2: Quebrar funcao gigante

Template 3: Converter callback para async/await

Template 4: Eliminar duplicacao

Template 5: Adicionar tipagem TypeScript

Templates de geracao de testes

Gerar testes com IA e fantastico quando voce da contexto suficiente. Sem contexto, a IA gera testes triviais que testam se 1+1 e 2. Com contexto, ela gera testes que realmente pegam bugs.

Template 6: Testes unitarios completos

Template 7: Testes de integracao para API

Template 8: Testes de componente React

Template 9: Adicionar testes em codigo legado

Template 10: Gerar test data e fixtures

Templates de debug e fix

Debug e o cenario mais frustrante pra escrever prompts porque voce muitas vezes nao sabe exatamente o que ta errado. Esses templates ajudam a IA a investigar de forma sistematica em vez de chutar solucoes.

Template 11: Investigar erro com stack trace

Template 12: Fix de performance

Template 13: Fix de memory leak

Template 14: Debug de race condition

Template 15: Fix de tipo TypeScript

Templates de documentacao e explicacao

Documentacao e a tarefa que todo dev odeia mas que faz diferenca enorme. Com IA, o custo de documentar caiu pra quase zero. Nao tem mais desculpa.

Template 16: JSDoc completo

Template 17: Explicar codigo legado

Template 18: README de API

Template 19: Changelog a partir de commits

Template 20: Decisao de arquitetura (ADR)

Como adaptar esses templates pro seu stack

Esses templates sao genericos de proposito. Pra tirar o maximo deles, voce precisa customizar pro seu contexto. Aqui vao 3 formas de fazer isso.

1. Coloque no CLAUDE.md ou nas regras do Cursor

Se voce usa Claude Code, coloque seus templates favoritos no CLAUDE.md do projeto. Assim toda vez que voce usar um, o Claude ja sabe a stack, as convencoes e os padroes do projeto. Nao precisa repetir contexto.

No Cursor, voce pode fazer o mesmo com as regras do projeto em .cursorrules. Mesma ideia, formato diferente.

2. Crie aliases ou snippets

Se voce usa o terminal, crie aliases no seu .zshrc ou .bashrc pra rodar templates comuns com um comando. Tipo: 'ai-test src/services/user.ts' roda o template de testes automaticamente. Poupa tempo e padroniza.

3. Itere e melhore com o tempo

Nenhum template e perfeito de primeira. Use, veja o que ficou bom e o que ficou ruim, ajuste. Depois de 2-3 iteracoes, voce vai ter templates que geram resultado bom 90% das vezes pro seu projeto especifico.

Eu mantenho um arquivo templates.md no meu computador com todos os meus prompts refinados. Toda vez que descubro uma variacao que funciona melhor, atualizo. E um investimento que paga dividendos todos os dias.

Erros comuns em prompts para codigo

Pra fechar, os erros que eu vejo mais frequentemente. Se voce ta tendo resultados ruins com IA pra codigo, provavelmente ta caindo num desses.