Lições Práticas de Engenharia de Prompt com o Uso do Claude Code

O que Funcionou: Entregar Código de Produção

O usuário, um gerente de projeto sem formação em desenvolvimento, construiu e entregou com sucesso código de produção usando o Claude Code. O aplicativo resultante é executado em um navegador e inclui mais de 1.200 testes.

O Desafio Principal: Qualidade do Prompt

A principal dificuldade identificada foi que o Claude Code produzirá resultados ruins ou incorretos se os prompts não forem precisos. O usuário afirma que ele "vai absolutamente deixar você bater de frente em uma parede em velocidade máxima se seu prompt não for hermético".

Três Técnicas que Melhoraram os Resultados

• Prompts em Duas Fases: Em vez de escrever prompts de uma só vez, o usuário adotou uma abordagem em duas fases. Fase 1 envolve escrever o quê na sua própria linguagem de domínio, incluindo regras e resultados desejados. Fase 2 envolve reescrever o prompt da perspectiva de um engenheiro de confiabilidade, adicionando portões de verificação, objetivos únicos, limites de sessão explícitos e regras anti-atalhos. O usuário descobriu que uma fase produz resultados decentes, mas duas fases produzem resultados de nível de produção.
• Um Prompt = Um Objetivo: Agrupar múltiplos objetivos em um único prompt consistentemente levou a resultados ruins. O Claude Code priorizaria um objetivo, os mesclaria de forma descuidada ou forneceria soluções incompletas para ambos. O usuário enfatiza "disciplina de escopo implacável" com um objetivo por prompt, chamando isso do maior "multiplicador de qualidade" descoberto.
• Definições de Função Específicas: Instruções de função genéricas como "Aja como um desenvolvedor sênior" foram consideradas "quase inúteis". Funções eficazes devem nomear a combinação exata de experiência necessária para a tarefa. O usuário fornece um exemplo: "Teórico musical formado em conservatório que construiu motores de composição comerciais" produz resultados fundamentalmente diferentes e melhores do que uma instrução vaga como "especialista em música". A especificidade muda o processo de pensamento subjacente do modelo, não apenas o tom da saída.