Prompts Avancados

# Prompt engineering avançado (com foco em output verificável)

## Quando usar / Quando evitar

- **Quando usar**: para guiar o agente em formato, restrições, estratégia e critérios de aceitação — especialmente quando o problema é ambíguo.
- **Quando evitar**: como “substituto” de contexto real do repo, testes e ferramentas. Prompt bom não compensa ausência de evidência.

## Sinais de que está dando errado

- **Respostas longas, pouco específicas**: faltou *constraints-first* + limite de output.
- **Faz a coisa errada “corretamente”**: aceites não são verificáveis; faltou ancorar em arquivo/símbolo real.
- **Finge que rodou testes**: não houve exigência explícita de “rodar e reportar saída”.

## Checklist operacional

- **Constraints-first**: declare o que é inegociável (segurança, performance, compatibilidade, não mexer em X).
- **Objetivo verificável**: escreva aceites como checklist (pass/fail).
- **Âncora no repo**: “siga o padrão de `X` em `Y`” + paths reais.
- **Formato do output**: diffs pequenos, lista de arquivos impactados, comandos de validação.
- **Limite de escopo**: “não refatore além do necessário”.

## Trade-offs e decisões

### Prompts “procedurais” vs “contextuais”

- **Procedural** (“faça A, depois B, depois C”) pode piorar modelos menores e aumentar regressão quando vira *cargo cult*.
- **Contextual** (“aqui está o padrão, aqui estão os invariantes, aqui está o oracle”) tende a escalar melhor.

### Exemplos (few-shot) vs regras

- **Few-shot** é poderoso, mas caro. Prefira 1–3 exemplos **canônicos** ao invés de 20 edge cases.
- Regras de estilo extensas: melhor via linter/formatter do que prompt.

## Exemplos (templates prontos)

### Template: mudança de código pequena (diff controlado)