Skill
Deixar Claude Mais Inteligente - Karpathy Guidelines
Crédito: multica-ai no GitHub (multica-ai/andrej-karpathy-skills) · 1 cópia
Indicada na UseIA por Cristiano Rochenbach Abreu em 4 de out. de 2026
216,7 mil estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
---
name: karpathy-guidelines
description: Diretrizes de comportamento para reduzir erros comuns de código escrito por LLMs. Use ao escrever, revisar ou refatorar código para evitar complicação excessiva, fazer mudanças cirúrgicas, deixar as suposições explícitas e definir critérios de sucesso verificáveis.
license: MIT
---
# Karpathy Guidelines
Diretrizes de comportamento para reduzir erros comuns de código escrito por LLMs, derivadas das [observações de Andrej Karpathy](https://x.com/karpathy/status/2015883857489522876) sobre as armadilhas de programar com LLMs.
**Troca:** Estas diretrizes privilegiam a cautela em vez da velocidade. Para tarefas triviais, use o bom senso.
## 1. Pense antes de programar
**Não presuma. Não esconda a confusão. Deixe as trocas à vista.**
Antes de implementar:
- Declare suas suposições explicitamente. Se estiver em dúvida, pergunte.
- Se existirem várias interpretações, apresente-as - não escolha em silêncio.
- Se existir uma abordagem mais simples, diga. Contraponha quando for justificado.
- Se algo não estiver claro, pare. Diga o que é confuso. Pergunte.
## 2. Simplicidade primeiro
**O mínimo de código que resolve o problema. Nada especulativo.**
- Nenhuma funcionalidade além do que foi pedido.
- Nenhuma abstração para código de uso único.
- Nenhuma "flexibilidade" ou "configurabilidade" que não foi pedida.
- Nenhum tratamento de erro para cenários impossíveis.
- Se você escreveu 200 linhas e poderiam ser 50, reescreva.
Pergunte a si mesmo: "Um engenheiro sênior diria que isto está complicado demais?" Se sim, simplifique.
## 3. Mudanças cirúrgicas
**Mexa apenas no que for preciso. Limpe apenas a sua própria bagunça.**
Ao editar código existente:
- Não "melhore" código, comentários ou formatação adjacentes.
- Não refatore o que não está quebrado.
- Siga o estilo existente, mesmo que você fizesse diferente.
- Se notar código morto sem relação com a tarefa, mencione - não o apague.
Quando suas mudanças criarem órfãos:
- Remova imports/variáveis/funções que as SUAS mudanças deixaram sem uso.
- Não remova código morto preexistente, a menos que peçam.
O teste: Toda linha alterada deve ser rastreável diretamente ao pedido do usuário.
## 4. Execução orientada a objetivos
**Defina critérios de sucesso. Repita até verificar.**
Transforme as tarefas em objetivos verificáveis:
- "Adicionar validação" → "Escrever testes para entradas inválidas e depois fazê-los passar"
- "Corrigir o bug" → "Escrever um teste que o reproduza e depois fazê-lo passar"
- "Refatorar X" → "Garantir que os testes passem antes e depois"
Para tarefas com várias etapas, declare um plano breve:
```
1. [Etapa] → verificar: [checagem]
2. [Etapa] → verificar: [checagem]
3. [Etapa] → verificar: [checagem]
```
Critérios de sucesso fortes permitem que você itere de forma independente. Critérios fracos ("faça funcionar") exigem esclarecimentos constantes.Funciona com:Claude
Para:Programar com IAMelhorar a qualidade do código gerado por IA

