Programación y vibe coding
CLAUDE.md con las 4 reglas de Karpathy: que tu agente no asuma ni reescriba de más
Es un único archivo CLAUDE.md que se copia en la raíz del proyecto. Pide al agente cuatro cosas: pensar y preguntar antes de programar, el código mínimo, tocar solo lo pedido y fijar un criterio de éxito que se pueda comprobar. Sirve para Claude Code y trae regla para Cursor. No probado por Fluye.
| Herramientas | Claude Code (principal)Cursor |
|---|---|
| Qué necesitas |
|
| Coste aprox. | El archivo es gratis. El agente que lo lee (Claude Code, Cursor...) va con tu plan. El repo no muestra licencia en GitHub. |
| Tiempo de montaje | 5 min (primera vez) |
| Nivel | Fácil |
| Plan gratis | Puede bastar para pruebas |
Prompt listo para usar
Sigue las reglas del CLAUDE.md de este proyecto. La tarea es: [TAREA]. 1. Antes de escribir código, dime qué das por supuesto y qué dudas tienes. Si hay dos formas de entenderlo, enséñamelas y pregunta. 2. Escribe un plan corto con este formato: paso, y cómo compruebo que está bien. 3. Haz el cambio mínimo. No toques código, comentarios ni formato que no tengan que ver con [TAREA]. 4. El éxito es: [CRITERIO]. No digas que está listo hasta que lo hayas comprobado y me enseñes cómo.
| Variable | Qué poner | Ejemplo |
|---|---|---|
[TAREA] | Lo que quieres que haga el agente | validar el email del formulario de contacto |
[CRITERIO] | Algo que se pueda comprobar, mejor un test | un test con tres emails malos que falla antes y pasa después |
Pégalo en: Claude Code, Cursor
Prompt propio de Fluye que aplica las cuatro reglas del archivo. No lo hemos ejecutado aquí.
Cómo funciona
- Instálalo como plugin o como archivo. En Claude Code, /plugin marketplace add forrestchang/andrej-karpathy-skills y después /plugin install andrej-karpathy-skills@karpathy-skills. Si lo quieres solo en un proyecto, descarga el CLAUDE.md del repo a la raíz (o añádelo al final del que ya tengas).
- Regla 1: pensar antes de programar. El agente dice qué supone, enseña las interpretaciones posibles, propone algo más simple si lo hay y para a preguntar cuando no lo tiene claro.
- Regla 2: simplicidad primero. Nada que no se haya pedido: ni funciones extra, ni abstracciones para un solo uso, ni configuraciones que nadie quiere.
- Regla 3: cambios quirúrgicos. Solo toca lo necesario y respeta el estilo del proyecto. Si ve código muerto que no es suyo, lo menciona pero no lo borra.
- Regla 4: objetivo comprobable. En vez de «arregla el bug», «escribe un test que lo reproduzca y haz que pase». En tareas largas, un plan con una comprobación por paso.
Qué resultado esperar
Diffs más cortos y fáciles de revisar, menos cambios que nadie pidió y un agente que pregunta cuando duda en vez de inventar.
- Qué se hizo
- Un desarrollador convirtió en un CLAUDE.md las quejas de Andrej Karpathy sobre cómo programan los LLM: suposiciones sin preguntar, código inflado y cambios colaterales.
- Cómo fue
- El repo pasa de 228K estrellas en GitHub (3 nov 2026). No publica medidas de antes y después.
- A tener en cuenta
- Es un conjunto de reglas, no una herramienta que mida nada. Sin prueba propia todavía.
Límites y precauciones
- El propio README avisa de que estas reglas van hacia la prudencia: en tareas triviales pueden frenar más de la cuenta.
- No hay cifras medidas de mejora en la fuente. Es un archivo de reglas, no un caso con resultados.
- El agente puede saltarse reglas de vez en cuando: sigue leyendo el diff.
- Sin prueba propia todavía.
- Descarga el archivo del repo original y léelo antes de añadirlo: es texto que el agente obedecerá en cada sesión.
- Si ya tienes un CLAUDE.md, añádelo al final en vez de sustituirlo para no perder tus reglas.
Variantes
- cursor: El repo incluye una regla de proyecto para Cursor (.cursor/rules/karpathy-guidelines.mdc) con las mismas pautas.
Fuentes: repo andrej-karpathy-skills en GitHub, el post de Andrej Karpathy en X y el post de @angeldot_ (17 oct 2026). Caso curado, no probado por Fluye.
Le pides al agente una validación y te devuelve 300 líneas, dos archivos que no tocaba y un comentario borrado. Karpathy lo resumió en X: los modelos suponen cosas por ti sin avisar, complican el código y cambian lo que no entienden como efecto secundario. Este repo convierte esas quejas en un solo CLAUDE.md que el agente carga en cada sesión.
Son cuatro reglas. Pensar antes de programar: decir qué supone y preguntar si duda. Simplicidad: el código mínimo, sin extras. Cambios quirúrgicos: cada línea cambiada tiene que venir de lo que pediste. Y objetivos comprobables: en vez de «arréglalo», un test que falle antes y pase después. La última es la que más rinde, porque le da al agente algo contra lo que repetir hasta acertar.
Se instala en un minuto como plugin de Claude Code o copiando el archivo al proyecto, y trae regla para Cursor. No hace magia: el agente puede saltársela y tú sigues leyendo el diff. Para tareas grandes, combínalo con Spec Kit, y para revisar lo que sale, revisión de código con agentes. Ficha de la herramienta: Claude Code.
Preguntas frecuentes
¿Lo habéis probado?
No. La ficha resume el README del repo y los posts de Karpathy y @angeldot_. No hemos medido si los diffs salen más cortos.
¿Es oficial de Karpathy?
No. Lo publica otro desarrollador, inspirado en las observaciones que Karpathy compartió en X.
¿Funciona fuera de Claude Code?
El repo trae una regla para Cursor. Cualquier agente que lea un archivo de reglas del proyecto puede usar el mismo texto.
¿Choca con Spec Kit o ECC?
No tiene por qué. Spec Kit y ECC organizan el trabajo; este archivo marca cómo se comporta el agente al escribir código. Se pueden combinar.
Telegram. Suscríbete al canal de Telegram para no perderte nada y estar al loro de todo lo nuevo en automatización y agentes de IA.Unirme al canal