# Prompts de código que funcionam (depuração, refatoração, testes)

> Como parar de receber respostas genéricas: exija diffs, restrições e checklists de teste.

Fonte: Promptea — https://www.promptea.me/pt/guides/code-prompts-that-work · Idioma: Português · Última atualização: 2026-11-09

## Seja concreto

- Forneça um trecho mínimo que reproduza o problema + o esperado vs. o obtido.
- Exija uma estrutura de saída (passos, diff, checklist).
- Inclua restrições de ambiente e de versão.
- Peça casos de borda + testes.

## Antes → depois: um pedido de depuração

- Antes: "Minha função não funciona, conserte." O modelo precisa adivinhar a linguagem, o sintoma e o que significa 'funcionar', então reescreve a função de forma genérica.
- Depois: "Bug: o total sai com um a menos quando a lista tem um único item. Ambiente: Node 20, TypeScript 5. Esperado: 10. Obtido: 9. Reprodução mínima abaixo. Retorne a causa, a correção como diff e um teste que falhe antes e passe depois."
- O que mudou: sintoma, ambiente, esperado versus obtido, uma reprodução mínima e a entrega exata agora estão declarados.

## Confira a resposta antes de confiar nela

- Rode o código e os testes que ele propõe. Uma explicação confiante não prova que a correção funciona.
- Peça um diff ou só as partes alteradas, para revisar uma mudança pequena em vez de um arquivo reescrito.
- Mude uma coisa por pedido. Se você pedir uma refatoração, uma funcionalidade nova e uma correção de bug ao mesmo tempo, não vai saber qual mudança quebrou o quê.
- Pergunte do que ele não tem certeza ('liste as suposições que você fez'): é das suposições que saem as correções erradas.

## Templates

### Refatoração com invariantes

```text
Refatore este código mantendo o comportamento idêntico.

Restrições:
- Não altere a API pública.
- Mantenha a complexidade de execução <= a atual.
- Prefira funções pequenas + nomes mais claros.

Código:
"""[cole aqui]"""

Retorne:
1) justificativa breve
2) diff/trecho (só as partes alteradas)
3) checklist de testes (o que cobrir)
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Refatore+este+c%C3%B3digo+mantendo+o+comportamento+id%C3%AAntico.%0A%0ARestri%C3%A7%C3%B5es%3A%0A-+N%C3%A3o+altere+a+API+p%C3%BAblica.%0A-+Mantenha+a+complexidade+de+execu%C3%A7%C3%A3o+%3C%3D+a+atual.%0A-+Prefira+fun%C3%A7%C3%B5es+pequenas+%2B+nomes+mais+claros.%0A%0AC%C3%B3digo%3A%0A%22%22%22%5Bcole+aqui%5D%22%22%22%0A%0ARetorne%3A%0A1%29+justificativa+breve%0A2%29+diff%2Ftrecho+%28s%C3%B3+as+partes+alteradas%29%0A3%29+checklist+de+testes+%28o+que+cobrir%29&purpose=code&target=claude)

### Depuração com esperado vs. obtido

```text
Bug: [descrição em uma linha]
Ambiente: [linguagem, runtime, versões dos frameworks]
Esperado: [o que deveria acontecer]
Obtido: [o que acontece; cole o erro ou o stack trace]

Reprodução mínima:
"""[código]"""

Retorne:
1) a causa mais provável, em duas frases
2) a correção mínima como diff (só as linhas alteradas)
3) um teste que falhe antes da correção e passe depois
4) as suposições que você fez, para eu poder conferir
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Bug%3A+%5Bdescri%C3%A7%C3%A3o+em+uma+linha%5D%0AAmbiente%3A+%5Blinguagem%2C+runtime%2C+vers%C3%B5es+dos+frameworks%5D%0AEsperado%3A+%5Bo+que+deveria+acontecer%5D%0AObtido%3A+%5Bo+que+acontece%3B+cole+o+erro+ou+o+stack+trace%5D%0A%0AReprodu%C3%A7%C3%A3o+m%C3%ADnima%3A%0A%22%22%22%5Bc%C3%B3digo%5D%22%22%22%0A%0ARetorne%3A%0A1%29+a+causa+mais+prov%C3%A1vel%2C+em+duas+frases%0A2%29+a+corre%C3%A7%C3%A3o+m%C3%ADnima+como+diff+%28s%C3%B3+as+linhas+alteradas%29%0A3%29+um+teste+que+falhe+antes+da+corre%C3%A7%C3%A3o+e+passe+depois%0A4%29+as+suposi%C3%A7%C3%B5es+que+voc%C3%AA+fez%2C+para+eu+poder+conferir&purpose=code&target=claude)

## Perguntas frequentes

### Como consigo um diff de verdade?

Peça 'só as partes alteradas' e especifique o contexto do arquivo. Se possível, inclua os nomes dos arquivos.

### Devo colar o arquivo inteiro?

Cole o menor trecho que reproduza o problema, mais as assinaturas das quais ele depende. Um arquivo inteiro acrescenta ruído e pode tirar o foco das linhas relevantes.

### Como evito que ele reescreva tudo?

Declare as invariantes ('não altere a API pública') e peça o diff mínimo. Dizer o que precisa continuar igual funciona melhor do que pedir que ele 'tome cuidado'.
