Un archivo de texto plano acaba de cambiar para siempre la forma en que los desarrolladores usan la programación con IA.
No es un modelo nuevo.
No es un IDE costoso.
No es otra startup de “agentes de IA”.
Solo un archivo:
CLAUDE.md
Y silenciosamente se convirtió en uno de los setups de desarrollo de más rápido crecimiento en GitHub.
Más de 82,000 estrellas.
Miles de forks.
Ingenieros desde startups hasta equipos empresariales copiándolo en sus proyectos de la noche a la mañana.
Porque los desarrolladores finalmente se dieron cuenta de algo:
Claude Code no falla porque el modelo sea débil.
Falla porque cada sesión comienza con amnesia.
Cada vez que abres Claude Code, olvida:
• tu stack
• tus decisiones de arquitectura
• tus convenciones de nombres
• tus estándares de codificación
• lo que ya falló la semana pasada
• lo que NUNCA se debe cambiar
• por qué elegiste un framework sobre otro
• qué archivos son demasiado riesgosos de tocar
Entonces el modelo hace lo que cualquier IA hace sin contexto:
Adivina.
Y esas adivinanzas se vuelven increíblemente costosas.
Le pides que arregle una función.
Reescribe tres archivos.
Renombra variables que elegiste intencionalmente.
Refactoriza código que funciona.
Sugiere herramientas incompatibles con tu arquitectura.
Elimina cosas “para limpiar”.
Cambia el formato que nadie le pidió tocar.
Luego pasas la siguiente hora deshaciendo la “ayuda”.
Ese es el impuesto oculto de la programación con IA del que nadie habla.
Un engineering manager estimó que su equipo estaba perdiendo casi 8 horas cada semana solo por:
→ reexplicar el contexto del proyecto
→ revertir cambios no autorizados
→ corregir suposiciones incorrectas
→ reenseñar decisiones de arquitectura
→ detener la expansión del alcance
Eso no es un problema de IA.
Es un problema de memoria.
Y CLAUDE.md lo soluciona de la manera más simple posible.
Es solo un archivo de texto plano colocado en la raíz de tu proyecto.
Pero Claude lo lee automáticamente al inicio de cada sesión.
Lo que significa que tu IA finalmente empieza con contexto en lugar de caos.
La diferencia es enorme.
Sin CLAUDE.md:
“Asistente de IA”
Con CLAUDE.md:
“Ingeniero que ya conoce tu proyecto”.
El archivo suele contener 3 capas.
━━━━━━━━━━━━━━━
- REGLAS PREDETERMINADAS ━━━━━━━━━━━━━━━
Esta sección le enseña a Claude cómo trabajas.
Qué tan detalladas deben ser las respuestas.
Cómo se ve tu stack.
Cómo te comunicas.
Cuánto contexto ya conoces.
Qué estilo de escritura usar.
Qué NO hacer.
Cosas como:
→ no uses frases de relleno
→ mantén las respuestas proporcionales a la complejidad de la tarea
→ pregunta antes de asumir
→ nunca expliques en exceso conceptos básicos
→ sigue exactamente mi estilo de codificación
→ respeta las restricciones del proyecto automáticamente
Suena pequeño.
¿Pero a lo largo de cientos de prompts?
Esto elimina una repetición masiva.
La mayoría de los desarrolladores, sin saberlo, pasan de 20 a 40 minutos cada día reenseñando contexto a la IA.
Cada. Mal. Sesión.
Ahora multiplícalo en un equipo de ingeniería.
Eso son miles de dólares al mes desperdiciados solo repitiéndote.
━━━━━━━━━━━━━━━
- CONTROL DE COMPORTAMIENTO
━━━━━━━━━━━━━━━
Esta es la sección que los desarrolladores desearían haber tenido hace meses.
Porque aquí es donde evitas que Claude se vuelva “creativamente destructivo”.
Defines límites firmes como:
→ solo toca archivos directamente relacionados con la tarea
→ nunca refactorices código no relacionado
→ pregunta antes de eliminar algo
→ confirma antes de acciones destructivas
→ no reescribas la estructura existente sin aprobación
→ siempre muestra exactamente lo que cambió
→ nunca implementes ni ejecutes migraciones automáticamente
Esta sola sección previene la mayoría de las historias de terror de la programación con IA.
No más reescrituras sorpresa.
No más desviación de la arquitectura.
No más desastres de “te limpié esto”.
La IA se vuelve predecible.
Que es exactamente lo que los ingenieros realmente quieren.
━━━━━━━━━━━━━━━
- MEMORIA + CEREBRO DEL PROYECTO
━━━━━━━━━━━━━━━
Aquí es donde las cosas se vuelven realmente poderosas.
Los desarrolladores empezaron a combinar CLAUDE.md con archivos como:
MEMORY.md
ERRORS.md
Ahora Claude puede recordar:
• decisiones que tu equipo ya tomó
• enfoques que fallaron
• herramientas rechazadas
• incidentes de producción
• restricciones técnicas
• compensaciones de arquitectura
• reglas específicas del cliente
Lo que significa que la IA deja de recomendar cosas que ya descartaste hace meses.
Deja de olvidar.
Eso lo cambia todo.
Porque el verdadero cuello de botella en la programación con IA ya no es la generación de código.
Es el contexto persistente.
Y la mayoría de la gente aún no se ha dado cuenta de esto.
━━━━━━━━━━━━━━━
LAS 4 REGLAS QUE LO HICIERON VIRAL
━━━━━━━━━━━━━━━
El setup explotó después de que los desarrolladores comenzaron a compartir 4 reglas simples inspiradas en el enfoque de Andrej Karpathy para trabajar con sistemas de IA.
Se ven engañosamente básicas:
- Pregunta antes de asumir.
- Usa la solución más simple primero.
- No toques código no relacionado.
- Señala la incertidumbre de inmediato.
Eso es todo.
Pero esas 4 reglas resuelven la mayoría de los fallos de la programación con IA.
Porque el mayor daño suele venir de la IA actuando con confianza sin suficiente contexto.
Los desarrolladores que obtienen los mejores resultados no están usando “más IA”.
Están reduciendo la ambigüedad.
Y una vez que ves esto, no puedes dejar de verlo.
━━━━━━━━━━━━━━━
LA VERDADERA DIVISIÓN EN LA PROGRAMACIÓN CON IA
━━━━━━━━━━━━━━━
Ahora mismo hay básicamente dos tipos de desarrolladores usando Claude Code.
Grupo 1:
Empieza cada sesión desde cero.
Repite el contexto a diario.
Limpia cambios no deseados.
Combate la expansión del alcance constantemente.
Trata a la IA como un autocompletado temporal.
Grupo 2:
Usa instrucciones persistentes.
Bloquea reglas de comportamiento.
Mantiene la memoria del proyecto.
Controla el alcance estrictamente.
Trata a la IA como un colaborador de ingeniería a largo plazo.
Mismo modelo.
Resultados completamente diferentes.
Por eso este archivo se propagó tan rápido.
Porque una vez que Claude tiene:
• reglas
• memoria
• conocimiento del stack
• restricciones de comportamiento
• contexto del proyecto
…deja de sentirse como un chatbot.
Y comienza a sentirse como infraestructura.
━━━━━━━━━━━━━━━
EMPIEZA AQUÍ
━━━━━━━━━━━━━━━
Abre tu proyecto.
Crea un archivo llamado:
CLAUDE.md
Luego pega estas 4 reglas primero:
• Pregunta antes de asumir
• Solución más simple primero
• No toques código no relacionado
• Señala la incertidumbre explícitamente
Eso solo mejorará inmediatamente cómo se comporta Claude.
Luego expande gradualmente con el tiempo:
→ tu stack
→ estándares de codificación
→ reglas de arquitectura
→ acciones prohibidas
→ registros de decisiones
→ memoria del proyecto
La mayoría de los desarrolladores aún no han hecho esto.
Lo que significa que la brecha entre la programación asistida por IA promedio y la de élite se está volviendo menos sobre modelos…
…y más sobre quién sabe cómo estructurar el contexto adecuadamente.
Guarda esto.
Porque dentro de seis meses, la memoria persistente del proyecto de IA probablemente se sentirá tan normal como los repositorios de GitHub hoy.
