Este repositorio de GitHub ofrece un conjunto de directrices para Claude Code, inspiradas en las observaciones de Andrej Karpathy sobre las limitaciones de los LLM en el desarrollo de software. Con más de 3.400 estrellas en pocos días, aborda claramente una necesidad dentro de la comunidad.
Problemas identificados: Karpathy observó que los modelos tienden a hacer suposiciones erróneas sin verificarlas y a "avanzar en una dirección" sin validar sus premisas. A menudo sobrecomplican las soluciones, creando abstracciones innecesarias cuando bastarían enfoques simples. Por último, en ocasiones modifican o eliminan código que no comprenden del todo, incluso cuando no guarda relación con la tarea solicitada.
Cuatro principios fundacionales:
El primer principio, "Think Before Coding", exige explicitar las suposiciones y formular preguntas aclaratorias en lugar de adivinar. En caso de ambigüedad, presentar varios enfoques viables. Detenerse y reconocer la confusión cuando se produce.
El segundo principio, "Simplicity First", prescribe escribir el código mínimo que aborde únicamente lo solicitado. Evitar funcionalidades especulativas, abstracciones innecesarias y configurabilidad no solicitada. Eliminar el manejo de errores para escenarios imposibles. La prueba: ¿consideraría un ingeniero experimentado que este código está sobrediseñado?
El tercer principio, "Surgical Changes", limita las modificaciones al código directamente relacionado con la solicitud del usuario. Preservar el estilo y los comentarios existentes. Eliminar código muerto preexistente solo cuando se solicite explícitamente.
El cuarto principio, "Goal-Driven Execution", convierte las tareas en criterios de éxito específicos y verificables. En lugar de "añadir validación", formular "escribir pruebas para entradas inválidas y luego hacer que pasen". Usar planes numerados breves con pasos de verificación.
Idea central: Los modelos destacan en "iterar hasta alcanzar objetivos específicos". En lugar de emitir instrucciones imperativas, definir criterios de éxito claros y dejar que el sistema itere hacia esos objetivos.
Instalación y uso: El repositorio puede instalarse como un plugin de Claude (claude plugins add) o descargarse como un archivo CLAUDE.md por proyecto. Las directrices están diseñadas para fusionarse con reglas específicas del proyecto.
Indicadores de éxito: Los diffs contienen únicamente los cambios solicitados, el código evita la complejidad innecesaria en el primer intento, las preguntas aclaratorias preceden a la implementación, y las pull requests permanecen enfocadas sin refactorizaciones tangenciales.
Advertencia: Estas directrices priorizan la precisión sobre la velocidad. Para cambios triviales (erratas, ediciones obvias de una línea), aplicar el sentido común en lugar del rigor completo.