
Conjunto de instrucciones de comportamiento que se le pasa a Claude Code (el asistente de codificación de Anthropic) para que trabaje de forma más disciplinada. Este en particular está inspirado en críticas que Andrej Karpathy hizo sobre los errores típicos de los LLMs al programar, y define cuatro reglas:
Pensar antes de codear: no asumir en silencio. Si hay ambigüedad, exponer las interpretaciones posibles o preguntar, en vez de decidir por su cuenta.
Simplicidad ante todo: escribir el mínimo código que resuelve el problema, sin abstracciones ni «flexibilidad» que nadie pidió.
Cambios quirúrgicos: tocar solo lo que hace falta. No «mejorar» código vecino, no refactorizar lo que no está roto, y no borrar código muerto preexistente (solo mencionarlo).
Ejecución orientada a objetivos: convertir cada tarea en un criterio verificable (por ejemplo «agregar validación» se convierte en «escribir tests para inputs inválidos y hacerlos pasar»), y declarar un plan de pasos con su verificación.
La idea de fondo: los LLMs tienden a sobre-ingenierizar, asumir cosas sin preguntar, y meter cambios innecesarios en un diff. Este archivo se coloca en la raíz de un repo (o se combina con instrucciones propias del proyecto) y Claude Code lo lee automáticamente como contexto persistente, ajustando su comportamiento a esas reglas en cada sesión de trabajo sobre ese código.
Es un ejemplo del patrón «prompt de sistema versionado junto al código» que se está volviendo común en equipos que usan Claude Code u otros agentes de codificación.
Link: https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md