Andrej Karpathy resume as "Os Quatro Princípios de CLAUDE.md" explode no GitHub, fazendo a precisão do AI ao escrever código ultrapassar 90%

Revelação do Prompt de Nível Divino para Fazer a IA Obedecer Completamente! Recentemente, um arquivo chamado CLAUDE.md no GitHub se tornou o mais popular. Este documento, baseado nas "Quatro Grandes Diretrizes de Codificação" extraídas das observações do ex-diretor da OpenAI, Andrej Karpathy, parece ter implantado a alma de um engenheiro sênior na IA. Basta colocá-lo na raiz do projeto para que a precisão do código gerado por ferramentas como Claude Code aumente de 65% para mais de 90%, eliminando de vez os problemas de alterações não autorizadas, código malfeito e engenharia excessiva.
(Resumindo: Nova funcionalidade do Claude Code /comando /goals: separar execução e avaliação, evitando que a IA seja preguiçosa ou minta)
(Informação adicional: Andrej Karpathy, membro fundador da OpenAI, anunciou sua entrada na Anthropic, retornando ao front de pesquisa em LLMs)

À medida que ferramentas de desenvolvimento assistido por IA como Claude Code e Cursor se tornam mais comuns, muitos desenvolvedores enfrentam um problema comum: embora a IA escreva código rapidamente, ela frequentemente "se acha" demais, fazendo suposições, sobrecarregando o projeto com detalhes desnecessários ou até alterando o código original de forma indevida.

Porém, agora há uma solução definitiva para esse problema. O renomado especialista em IA, ex-diretor da OpenAI, Andrej Karpathy, analisou profundamente os padrões de falha comuns dos grandes modelos de linguagem (LLMs) ao escrever código; em seguida, desenvolvedores como Forrest Chang condensaram essa ideia central em um arquivo simples chamado CLAUDE.md. Este projeto (forrestchang/andrej-karpathy-skills) recentemente atingiu o topo das tendências no GitHub, acumulando dezenas de milhares de estrelas.

Muitos desenvolvedores testaram e relataram surpresos que, após implementar esse arquivo, a precisão do código gerado pela IA subiu de cerca de 65% para impressionantes mais de 90%.

Revelando os "Quatro Princípios de Ouro" do CLAUDE.md

Este arquivo mágico, na essência, é como uma "carta de conduta" para a IA, uma espécie de código de conduta de um engenheiro sênior. Quando colocado na raiz do projeto, o Claude Code lê automaticamente e usa como a principal diretriz de comportamento durante toda a conversa. Seus quatro princípios fundamentais são:

• 1. Pense Antes de Codificar (Think Before Coding):
  "Não faça suposições. Não esconda dúvidas. Mostre suas ponderações."
  Obriga a IA a declarar claramente suas hipóteses. Se encontrar requisitos incertos ou múltiplas soluções possíveis, a IA deve parar e perguntar ao usuário, ao invés de adivinhar e escrever algo sem certeza. Quando necessário refutar requisitos irracionais, a IA também tem o direito de "recuar" (push back).
• 2. Priorize a Simplicidade (Simplicity First):
  "Escreva apenas o código mínimo necessário para resolver o problema. Sem suposições."
  É estritamente proibido que a IA adicione funcionalidades desnecessárias. Não deve criar código defensivo para cenários improváveis ou arquiteturas complexas para tarefas simples. A regra é clara: se um problema pode ser resolvido em 50 linhas, não escreva 200.
• 3. Faça Modificações Cirúrgicas (Surgical Changes):
  "Altere apenas o que for estritamente necessário. Limpe apenas o código que você mesmo bagunçou."
  Essa é uma das preferidas dos desenvolvedores. A regra proíbe que a IA, ao corrigir um bug, também refatore ou altere código, comentários ou formatação ao redor. Cada mudança deve estar diretamente relacionada à necessidade explícita do usuário.
• 4. Execute com Foco no Objetivo (Goal-Driven Execution):
  "Defina critérios de sucesso. Verifique ciclicamente até alcançar o objetivo."
  Exige que a IA transforme tarefas vagas em metas concretas e verificáveis. Por exemplo, ao receber a instrução "corrigir bug", a IA deve primeiro criar um teste que reproduza o problema ➔, depois modificar o código ➔ e, por fim, fazer o teste passar, formando um ciclo de validação rigoroso.

Por que esse Prompt é tão eficaz?

Os LLMs tendem a agradar o usuário e são altamente propensos a "hipóteses fantasiosas (hallucinate assumptions)" e "escopo em expansão (scope creep)". A grandeza do CLAUDE.md está em codificar as "boas práticas e autocontrole" de um engenheiro experiente em um sistema de prompt (System Prompt).

Por meio desses quatro princípios, a IA é forçada a ser mais cautelosa, focada e a produzir resultados verificáveis. Muitos desenvolvedores relataram que as diferenças no Diff de código ficaram mais limpas do que nunca, com menos bugs e manutenção mais fácil. Não é mais como comandar uma máquina descontrolada, mas sim como colaborar com um "engenheiro sênior" confiável, experimentando a sensação de programação em dupla (Pair Programming).