Un archivo de texto plano acaba de cambiar para siempre la forma en que los desarrolladores usan la IA para programar.
No un nuevo modelo.
No un costoso IDE.
Ni otra startup de "agentes de IA".
Solo un archivo:
CLAUDE.md
Y en silencio se convirtió en uno de los setups de desarrollo que más rápido crece en GitHub.
Más de 82 000 estrellas.
Miles de forks.
Ingenieros de startups y 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 empieza con amnesia.
Cada vez que abres Claude Code, olvida:
• tu stack
• tus decisiones de arquitectura
• tus convenciones de nomenclatura
• tus estándares de código
• lo que ya falló la semana pasada
• lo que NUNCA debe cambiarse
• por qué elegiste un framework sobre otro
• qué archivos son demasiado riesgosos de tocar
Entonces el modelo hace lo que toda 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 a propósito.
Refactoriza código que funciona.
Sugiere herramientas incompatibles con tu arquitectura.
Elimina cosas "por limpieza".
Cambia el formato que nadie le pidió tocar.
Luego pasas la siguiente hora deshaciendo la "ayuda".
Ese es el impuesto oculto de la IA para programar del que nadie habla.
Un engineering manager estimó que su equipo perdía casi 8 horas cada semana solo por:
→ reexplicar el contexto del proyecto
→ revertir cambios no autorizados
→ corregir suposiciones erróneas
→ volver a enseñ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 forma más simple posible.
Es solo un archivo de texto plano 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 POR DEFECTO ━━━━━━━━━━━━━━━
Esta sección le enseña a Claude cómo trabajas.
Qué tan detalladas deben ser las respuestas.
Cómo es tu stack.
Cómo te comunicas.
Cuánto contexto ya conoces.
Qué estilo de escritura usar.
Qué NO hacer.
Cosas como:
→ no usar frases de relleno
→ mantener las respuestas proporcionales a la complejidad de la tarea
→ preguntar antes de asumir
→ nunca sobreexplicar conceptos básicos
→ seguir exactamente mi estilo de código
→ cumplir automáticamente con las restricciones del proyecto
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. Maldita. Sesión.
Ahora multiplícalo por un equipo de ingeniería.
Son miles de dólares al mes desperdiciados solo en repetirte.
━━━━━━━━━━━━━━━
- 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 estrictos como:
→ solo tocar archivos directamente relacionados con la tarea
→ nunca refactorizar código no relacionado
→ preguntar antes de eliminar cualquier cosa
→ confirmar antes de acciones destructivas
→ no reescribir la estructura existente sin aprobación
→ mostrar exactamente lo que cambió
→ nunca desplegar ni ejecutar migraciones automáticamente
Esta sola sección previene la mayoría de las historias de terror con IA para programar.
No más reescrituras sorpresa.
No más desviación de la arquitectura.
No más desastres de "te lo limpié".
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 emparejar 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 todavía no se ha dado cuenta.
━━━━━━━━━━━━━━━
LAS 4 REGLAS QUE LO HICIERON VIRAL
━━━━━━━━━━━━━━━
El setup explotó después de que los desarrolladores comenzaron a compartir 4 simples reglas inspiradas en el enfoque de Andrej Karpathy para trabajar con sistemas de IA.
Parecen 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 IA para programar.
Porque el mayor daño suele venir de la IA actuando con seguridad 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 constantemente la expansión del alcance.
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.
El mismo modelo.
Resultados completamente diferentes.
Por eso este archivo se extendió 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 empieza 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 código
→ reglas de arquitectura
→ acciones prohibidas
→ registros de decisiones
→ memoria del proyecto
La mayoría de los desarrolladores todavía 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 con IA probablemente será tan normal como los repos de GitHub hoy.
