4 princípios inspirados em Andrej Karpathy para tirar mais do Claude Code

Um projeto pequeno no GitHub, o andrej-karpathy-skills, chamou atenção por um motivo direto: condensa observações públicas de Andrej Karpathy — pesquisador de IA e ex-diretor de IA da Tesla — sobre os erros mais comuns de agentes de código em um único arquivo de instruções (CLAUDE.md), pronto pra usar no Claude Code.

O problema que o projeto ataca

A crítica de Karpathy, reproduzida no repositório, é específica: modelos de código fazem suposições silenciosas e seguem em frente sem checar, não sinalizam confusão, não apresentam trade-offs, não questionam quando deveriam. E, no lado oposto, tendem a complicar demais — inflam abstrações, implementam 1000 linhas onde 100 resolveriam, e às vezes mexem em comentários ou código que não deveriam tocar, como efeito colateral de uma tarefa que não tinha nada a ver com aquilo.

Quem já revisou um PR gerado por agente reconhece o padrão.

Os quatro princípios

1. Pensar antes de codificar. Em vez de escolher uma interpretação em silêncio, o agente deve declarar suposições explicitamente, apresentar interpretações alternativas quando há ambiguidade, e parar para perguntar quando algo não está claro — em vez de simplesmente seguir em frente.

2. Simplicidade em primeiro lugar. Código mínimo que resolve o problema, nada especulativo: sem funcionalidade além do que foi pedido, sem abstração para uso único, sem "flexibilidade" que ninguém pediu. O teste sugerido no repositório: um engenheiro sênior diria que isso está complicado demais? Se sim, simplifique.

3. Mudanças cirúrgicas. Tocar só o que precisa ser tocado. Não "melhorar" código adjacente, comentários ou formatação por conta própria; não refatorar o que não está quebrado; remover apenas imports/variáveis que a própria mudança tornou órfãos — nunca limpar código morto pré-existente sem que isso tenha sido pedido.

4. Execução guiada por objetivo. Transformar instruções imperativas em critérios de sucesso verificáveis. Em vez de "adicione validação", o padrão sugerido é "escreva testes para entradas inválidas, depois faça-os passar". Critérios fracos como "faça funcionar" forçam esclarecimento constante; critérios fortes permitem que o agente itere sozinho até verificar o resultado.

Como aplicar

O projeto é literalmente um arquivo CLAUDE.md — ou um plugin instalável via /plugin marketplace add no Claude Code — pensado para ser mesclado com instruções específicas do seu projeto, não para substituí-las. A observação mais honesta do próprio repositório: essas diretrizes priorizam cautela sobre velocidade, e para tarefas triviais (typo, ajuste óbvio de uma linha) o rigor completo é exagero — o critério é usar bom senso.

Vale menos como "receita mágica" e mais como um lembrete estruturado de disciplina que já vale para qualquer revisor humano de código: declare o que você assumiu, mude só o que precisa mudar, e defina como vai saber que terminou antes de começar.