andrej-karpathy-skills: o arquivo CLAUDE.md que disciplina o Claude Code

Um arquivo .md com 9.839 stars no GitHub está virando padrão entre quem usa Claude Code para construir produtos. O andrej-karpathy-skills é um único arquivo CLAUDE.md — colocado na raiz do projeto — que reescreve o comportamento padrão do Claude Code. A base são as observações públicas de Andrej Karpathy (criador do GPT-2, ex-diretor de IA da Tesla, ex-OpenAI) sobre os maiores defeitos dos LLMs em tarefas de programação. Karpathy documentou que os modelos assumem premissas erradas sem perguntar, complicam código onde 100 linhas resolveriam o que foi feito em 1.000, e removem comentários ou trechos que não entendem como efeito colateral de tarefas não relacionadas. O repositório traduz essas críticas em quatro princípios práticos. Com 9.839 stars, 669 forks e crescimento acelerado, virou referência para quem constrói produtos com IA sem aceitar retrabalho constante.

O que faz

O andrej-karpathy-skills é um único arquivo CLAUDE.md de configuração que vai na raiz do projeto. O Claude Code lê esse arquivo automaticamente e passa a seguir quatro princípios derivados das observações de Karpathy:

Não assumir — perguntar antes de tomar decisões ambíguas
Não complicar — preferir 100 linhas simples a 1.000 linhas “elegantes”
Não apagar — nunca remover código que não entende completamente
Não enrolar — apresentar trade-offs, sinalizar inconsistências, fazer push-back quando necessário

O problema que resolve é direto: quem usa vibe coding para construir software com IA sabe que o modelo às vezes vai em frente com premissas erradas, cria abstrações desnecessárias e apaga comentários importantes como “efeito colateral” de uma tarefa não relacionada. Esse arquivo tenta corrigir isso na raiz — antes da conversa começar. O resultado prático é menos ciclos de revisão, menos prompt engineering reativo, menos tempo desfazendo o que a IA “melhorou”.

Por que está em alta

O repositório surgiu depois que Karpathy publicou uma thread detalhando os comportamentos problemáticos dos LLMs em programação. A tração foi imediata: quase 10 mil stars em poucas semanas.

O timing é relevante. Claude Code se tornou ferramenta dominante entre desenvolvedores e empreendedores que constroem sem equipe técnica tradicional. Qualquer ajuste que reduz retrabalho tem valor direto: menos ciclos de correção, menos tokens gastos, produto funcionando mais rápido. Em março de 2026, o repositório mantinha atividade constante — pequeno, mas focado no que importa.

Métricas

Métrica	Valor
Stars	9.839
Licença	Não especificada
Último commit	52 dias atrás
Linguagem	Markdown
Contributors	5

Para quem serve / Para quem NÃO serve

Serve para:

Quem usa Claude Code como ferramenta principal de desenvolvimento
Fundadores construindo MVPs sem CTO ou equipe técnica dedicada
Quem já perdeu horas corrigindo código que o Claude “melhorou” sem pedir permissão
Times pequenos onde cada ciclo de retrabalho custa caro em tempo e dinheiro

Não serve para:

Quem usa Cursor, Windsurf, Copilot ou qualquer ferramenta que não seja Claude Code — o arquivo é específico para o comportamento do Claude
Projetos com CLAUDE.md já customizado com regras complexas de negócio — pode gerar conflito de instruções
Quem quer plug-and-play sem leitura: o arquivo precisa ser entendido e adaptado ao contexto do projeto

A limitação honesta: sem licença especificada, uso comercial fica em zona cinzenta. E com apenas 1 arquivo e 5 contributors, não há garantia de manutenção a longo prazo.

Alternativas

Cursor Rules — repositório com regras equivalentes para o Cursor IDE. Grátis, comunidade maior, mais opções por linguagem e framework.
awesome-claude-prompts — coleção de prompts para Claude. Mais amplo, menos focado em comportamento de código.
Arquivo próprio CLAUDE.md — a Anthropic documenta o formato oficialmente. Dá controle total, mas exige tempo de curadoria e testes antes de funcionar bem.

Quem já trabalha com estratégia de SEO orientada a entidades e precisa que a IA gere conteúdo estruturado sem inventar informações vai achar que regras customizadas resolvem mais do que um arquivo genérico.

Veredicto

Vale testar em qualquer projeto ativo no Claude Code. O custo é zero — é um arquivo de texto. O ganho potencial é reduzir o número de vezes que o modelo toma decisão errada sem avisar. Não é solução definitiva, mas é o melhor ponto de partida disponível hoje para quem quer um Claude mais disciplinado e menos criativo no lugar errado.

Fonte: andrej-karpathy-skills no GitHub