Un archivo llamado CLAUDE.md llegó al #1 en GitHub Trending.
82,000 estrellas. 7,800 forks.
Todo comenzó con Andrej Karpathy. Ex Director de IA en Tesla. Miembro fundador de OpenAI. Identificó 4 comportamientos que hacen fallar a Claude Code y los escribió en un solo archivo.
Un desarrollador tomó esas 4 reglas, las amplió, publicó el archivo. Se volvió viral..
La razón: la precisión en la codificación pasó del 65% al 94%.
La mayoría de los desarrolladores que usan Claude Code a diario nunca lo han configurado. Empiezan desde cero cada sesión. Reexplicando el mismo contexto. Limpiando cambios de alcance no deseados. Revirtiendo refactorizaciones que nadie pidió.
Este es el archivo completo.
La configuración que la mayoría de los desarrolladores pasaron por alto
Cada vez que abres Claude Code, comienza sin nada.
No conoce tu stack. Tus estándares. El contexto de tu proyecto. Lo que ya has probado. Lo que decidiste explícitamente no hacer hace tres sesiones.
Así que adivina. Y cuando adivina, refactoriza código que no le pediste que tocara. Sugiere frameworks que rompen tu arquitectura existente. Elimina archivos sin preguntar. Contradice decisiones que ya tomaste.
CLAUDE.md es un archivo de texto plano que colocas en la raíz de tu proyecto. Claude Code lo lee automáticamente al inicio de cada sesión.
Una configuración. Cero explicaciones repetidas. Tres categorías de errores costosos solucionados.
1 / 3 | VALORES PREDETERMINADOS: $375/semana que estás gastando en repetirte
El desarrollador promedio gasta 30 minutos al día reexplicando el contexto a Claude.
Stack. Estándares de codificación. Antecedentes del proyecto. Lo que ya se ha probado. Nada de eso persiste entre sesiones a menos que lo escribas una vez y dejes que Claude lo lea cada vez.
30 minutos al día a $150/hora tarifa de desarrollador: $375/semana. Por desarrollador.
Para un equipo de 5: $1,875/semana perdidos.
Estas 7 reglas van al principio de tu archivo CLAUDE.md.
→ Elimina el relleno:
→ Iguala la longitud a la tarea:
→ Muestra opciones antes de actuar:
→ Admite incertidumbre antes de que me cueste:
→ Quién soy y qué sé:
→ Contexto actual del proyecto:
→ Fija tu voz:
Tiempo empleado en reexplicar contexto por día: 30 min A $150/hora tarifa de desarrollador: $75/día Por semana: $375/semana por desarrollador Equipo de 5: $1,875/semana Configuración de CLAUDE.md para esta sección: 45 minutos en total
Error a evitar: no escribas tu CLAUDE.md desde cero. Usa primero este prompt, luego edita el resultado:
2 / 3 | COMPORTAMIENTO: los cambios de $150/hora que no autorizaste
Le pides a Claude que arregle una función.
Refactoriza tres archivos, renombra tus variables, reorganiza los imports y reescribe comentarios que te tomaste tiempo en redactar.
Todo sin preguntar.
1 hora para revisar y revertir cambios no deseados: $150. Tres veces por semana: $450/semana. Por desarrollador.
Para un equipo de 5: $2,250/semana gastados en limpiar cambios que nadie autorizó.
Estas 7 reglas van en la sección de comportamiento de tu CLAUDE.md.
→ Mantente dentro del alcance:
→ Pregunta antes de cambios grandes:
→ Confirma antes de cualquier cosa destructiva:
→ Frenos de seguridad para producción:
→ Siempre muestra lo que cambió:
→ Nunca actúes sin confirmación explícita:
→ Piensa antes de escribir código:
1 hora/semana revirtiendo cambios de alcance no deseados: $150/semana 30 min/semana haciendo diffs manuales después de cada tarea: $75/semana Total de desperdicio relacionado con comportamiento por desarrollador: $225/semana Equipo de 5: $1,125/semana Configuración de la sección de comportamiento de CLAUDE.md: 30 minutos
3 / 3 | MEMORIA + STACK: la configuración que hace que Claude Code sea realmente confiable
Claude olvida todo entre sesiones.
Cada decisión que tomaste. Cada enfoque que falló. La razón por la que elegiste Prisma en lugar de Drizzle hace seis meses. La restricción que existe debido a un requisito específico del cliente.
Lo olvida. Luego sugiere exactamente lo que ya descartaste.
Esta sección le da a Claude lo más parecido a una memoria real que existe actualmente. Y fija tu stack tecnológico para que deje de proponer herramientas que rompen tu arquitectura existente.
→ Registro de decisiones en MEMORY.md:
→ Resumen de fin de sesión:
→ Registro de fallos en ERRORS.md:
→ Lista de hechos permanentes:
→ Fija tu stack tecnológico:
→ Pensamiento extendido para decisiones difíciles:
→ Las 4 reglas que se volvieron virales:
Karpathy identificó 4 comportamientos que hacen fallar a Claude Code. Un desarrollador los destiló en estas 4 líneas. La precisión en la codificación pasó del 65% al 94%.
2 horas/semana recuperándose de decisiones olvidadas y sugerencias incorrectas: $300/semana por desarrollador Recomendaciones de stack incorrectas y herramientas incompatibles: $75/semana Total de desperdicio relacionado con memoria por desarrollador: $375/semana Equipo de 5: $1,875/semana Configuración de MEMORY.md + ERRORS.md + stack: 20 minutos
CONCLUSIÓN
Aquí están las cuentas completas.
$375/semana reexplicando contexto cada sesión $225/semana revirtiendo cambios no autorizados $375/semana recuperándose de decisiones olvidadas Desperdicio total por desarrollador: $975/semana
Equipo de 5 desarrolladores: $4,875/semana Por año: $253,500
Configuración de CLAUDE.md: 2 horas en total Las 4 reglas de Karpathy por sí solas: del 65% al 94% de precisión en codificación
Un archivo de texto plano. 21 reglas. Dos horas de trabajo.
Los desarrolladores que configuraron esto están trabajando con una versión de Claude que recuerda decisiones, se mantiene dentro del alcance, confirma antes de destruir algo, nunca sugiere un framework que rompa tu arquitectura.
Los que no lo han hecho están gastando $975/semana en repetirse.
P.D.: comienza con las 4 reglas de Karpathy. solo esas 4. pégalas en un nuevo archivo llamado CLAUDE.md en la raíz de tu proyecto ahora mismo. toma 2 minutos. agrega el resto una semana a la vez a medida que notes lo que falta.
Guarda esto como favorito antes de que se pierda. Si te fue útil, compártelo con una persona que lo necesite.
