Respuestas
Tu CLAUDE.md creció más de una página. ¿Qué sale de ahí?
El consejo de mantener un CLAUDE.md en menos de una página es bueno, y cuesta seguirlo porque en el mismo archivo terminan dos tipos de conocimiento distintos. Uno pertenece ahí para siempre: los comandos, las convenciones, los errores que un asistente repite en esta base de código. El otro es lo que decidió una persona — qué regla está vigente, por qué se descartó un enfoque, qué se le puede prometer a un cliente — y crece sin límite, porque las decisiones nunca dejan de tomarse. El corte no es entre lo importante y lo que no lo es. Es entre lo que le pertenece al repositorio y lo que le pertenece al equipo.
Última actualización August 26, 2026
Lo que se gana su lugar en el archivo
Quédate con lo que un asistente necesita para trabajar en esta base de código y en ninguna otra: cómo compilarla y probarla, las convenciones que el código sigue de verdad, la forma de los directorios, los errores concretos que un asistente repite acá. Ese contenido es estable y corto por naturaleza — deja de crecer en cuanto es exacto. Cuando cambia, cambia porque cambió el código, y el mismo commit que cambia el código cambia el archivo.
Lo que lo está haciendo largo
Todo lo que tiene una persona detrás. Una decisión sobre precios o alcance, una regla sobre qué se le puede mandar a un cliente, el enfoque que el equipo probó y abandonó, la convención acordada en una reunión por alguien que no comitea código. Cada línea vale la pena y ninguna le pertenece al repositorio, así que el archivo crece en la única dirección que no se puede permitir — y una vez que pasa la página, las líneas que más importan compiten por atención con las líneas que simplemente nunca se borraron.
Adónde va el segundo tipo
A Arroway: escrito por personas y por los asistentes que usan, aprobado por una persona antes de regir nada, con la condición que lo termina encima, y servido por relevancia para la tarea que hay delante en lugar de cargarse entero. El problema de tamaño deja de ser un problema de tamaño, porque una lectura selecciona. Un archivo no puede seleccionar — se pone entero delante del modelo, todas las veces, y la única manera de mantenerlo chico es seguir borrando cosas que una persona todavía necesita.
Cómo se ve en la práctica
El archivo de contexto de un equipo llega a cuatro páginas. Alguien lo recorta a una, y recorta por longitud en vez de por pertenencia: los comandos de compilación se quedan porque son cortos, y el párrafo que explica por qué el equipo dejó de usar cierta biblioteca se va porque es largo. Dos semanas después un asistente propone esa biblioteca. El recorte se hizo exactamente como aconsejan, y se llevó la línea que más trabajo estaba haciendo.
Preguntas que la gente hace sobre esto
- ¿Entonces el CLAUDE.md está mal?
- No. El archivo es lo correcto para lo que le pertenece al repositorio, y el propio repositorio de Arroway mantiene uno justamente para eso. Lo que el archivo no puede hacer es sostener lo que cambia sin que cambie el código, decir que una línea quedó superada, o llegarle a una persona que nunca abre el repositorio. Para esos tres huecos existe la segunda capa — y el archivo deja de crecer porque el crecimiento tiene adónde ir.
- ¿No puedo simplemente partirlo en varios archivos?
- Puedes, y eso pospone el problema en vez de resolverlo. Más archivos significa más texto puesto delante del modelo, o una regla de carga que alguien tiene que mantener — y ninguna de las dos cosas toca la parte que de verdad duele: nada dentro de un archivo dice cuál de dos líneas contradictorias está vigente hoy. Partirlo organiza el texto. No le da a una decisión un vencimiento, un autor, ni una persona que la aprobó.
- ¿Qué lee el asistente, entonces, y cómo sé que le llegó?
- Lee el archivo para lo que le pertenece al repositorio y le pide a Arroway lo que le pertenece al equipo, al empezar el trabajo. Esa lectura se ordena por la tarea y vuelve diciendo qué entregó y qué no entró — así “¿el asistente recibió de verdad nuestras reglas?” tiene una respuesta que puedes mirar, que es algo que ningún archivo puede ofrecer sobre sí mismo.
Dónde se puede comprobar
La documentación de producto de este sitio (Cómo funciona, Instalar) y la especificación de producto sancionada en el repositorio. La recomendación de mantener corto un archivo de contexto es práctica publicada; toda propiedad que se nombra acá sobre un archivo de contexto corriente es una que tiene cualquier archivo de texto versionado — sin vencimiento, sin paso de sanción, sin selección, sin acuse de entrega. Esta página no afirma nada sobre la memoria integrada de ningún producto de IA.
https://www.arroway.app/en/answers/context-file-outgrew-a-page