Software Crafters® 2026 | Creado con 🖤 para elevar el nivel de la conversación sobre programación en español | Legal
Hay un repositorio en GitHub que tiene más de 165 mil estrellas en el momento de escribir estas líneas.
Y en esencia solo tiene un CLAUDE.md. Nada más y nada menos.
Lo interesante es que está basado en las ideas de Andrej Karpathy. Karpathy, por si no lo conoces, es cofundador de OpenAI y exdirector de IA de Tesla.
Atento. Esto es lo que dice ese CLAUDE.md. Son solo 4 reglas.
Suena obvio. No lo es.
No asumas. Si dudas, pregunta. Si hay varias interpretaciones posibles, ponlas sobre la mesa en lugar de elegir en silencio.
Y si existe una forma más simple, dilo.
Escribe el mínimo código que resuelva el problema.
No especules.
No añadas abstracciones para código de un solo uso.
Ni "flexibilidad" que nadie ha pedido.
Ni manejo de errores para escenarios imposibles.
Si escribes 200 líneas y se podía hacer en 50, reescríbelo.
Toca solo lo que tienes que tocar. Y poco más.
No "mejoras" el código de al lado.
No refactorizas lo que no tienes que cambiar.
No cambias el estilo aunque tú lo harías diferente.
Cada línea que cambies tiene que poderse trazar a lo que te pidió el usuario.
Defines el criterio de éxito antes de empezar e iteras hasta verificarlo.
Por ejemplo, "arregla el bug" se convierte en "escribe un test que reproduzca el bug y haz que pase".
Y "añade validación" se convierte en "escribe tests para inputs inválidos y haz que pasen".
Bien.
Si te fijas, las cuatro reglas no son solo para la IA. Son reglas que tendría que cumplir cualquier dev.
La cuarta especialmente. "Escribe un test que reproduzca el bug y haz que pase".
Eso es TDD desde 1999.
Y el resto son las reglas del diseño simple de Kent Beck.
Te cuento algo.
La mayoría escribe tests porque toca. Sin haberse parado nunca a entender qué hacen, por qué funcionan o cuándo dejan de funcionar.
Y luego están los pocos que sí lo han hecho.
Son a los que el equipo escucha cuando hay que tomar una decisión técnica seria. Y, ahora, son los que saben qué meterle a un CLAUDE.md para que el agente no haga el tonto.
Las herramientas cambian. Los principios, no.
PD. El CLAUDE.md original está aquí: github.com/multica-ai/andrej-karpathy-skills.
¿Quiéres leer más artículos como éste? Pues suscríbete a la newsletter