CLAUDE.md

Boris Cherny, quien creó Claude Code en Anthropic, describe «CLAUDE.md» como una función que fue advertida más que diseñada: igual que el modo plan, surgió al observar a los usuarios improvisarla por su cuenta. El archivo se lee al inicio de cada sesión, y eso es lo que lo distingue de un prompt.

El hábito que el equipo de Claude Code repite con más frecuencia es un trinquete: después de que Claude comete un error, se le pide que escriba la corrección en «CLAUDE.md» para que el error no se repita. Cherny considera que Claude es inesperadamente bueno redactando sus propias reglas. Michael Nuñez informa que el equipo mantiene un único «CLAUDE.md» en su repositorio git, donde cada error se convierte en una regla permanente; Kieran Klaassen cierra cada ciclo de entrega codificando allí un único aprendizaje.

Louis Claxton ubica el archivo dentro de una división más amplia del conocimiento institucional en artefactos versionados: «CLAUDE.md» para el contexto del repositorio, REVIEW.md para la doctrina de revisión, bands.yaml para los umbrales de producción. La misma división recorre el pipeline de revisión de Anthropic, donde «CLAUDE.md» describe el proyecto y REVIEW.md, escrito por los propietarios del código, le indica al revisor qué es importante. Frente a las skills, la frontera es la frecuencia: «CLAUDE.md» contiene lo que se aplica siempre.

Cobus Greyling interpreta el archivo como evidencia de una capa que se está colapsando: las instrucciones en lenguaje natural dentro de un «CLAUDE.md» han desplazado a frameworks de orquestación como «LangGraph» y «CrewAI». Shubham Saboo nombra el costo en su defensa de «Loop Engineering»: el archivo se alarga, los criterios cambian sin dejar rastro, y tras un mes el agente parece peor aunque el modelo no haya retrocedido. El hábito de añadir texto tras cada corrección y esa deriva son el mismo mecanismo.