Los archivos CLAUDE.md suelen estar organizados para desarrolladores, no para modelos de IA – He aquí por qué es importante

Una publicación en r/ClaudeAI destaca un modo de fallo común en los archivos CLAUDE.md: están estructurados en torno a lo que el desarrollador quiere documentar, no a lo que el modelo necesita decidir. Son problemas diferentes.

La Estructura Centrada en el Desarrollador

Ejemplo de un archivo organizado para el desarrollador:

## Acerca de Este Proyecto
[3 párrafos de contexto]
## Pila Tecnológica
[15 elementos]
## Objetivos
[5 viñetas]
## Reglas Estrictas   <- esto está en la línea 47

El modelo lee linealmente. Cuando llega a las reglas estrictas, ya ha comenzado a construir suposiciones. Si una restricción debe anular esas suposiciones, el modelo está luchando cuesta arriba.

Una Estructura Centrada en el Modelo

La publicación sugiere un modelo mental: pregúntate "¿qué necesita el modelo 3 segundos antes de hacer algo irreversible?" Pon eso primero. Una mejor estructura:

## Reglas Estrictas (léelas primero)
[tus restricciones reales]
## Contexto Actual
[lo que está activo ahora]
## Antecedentes
[el resto]

El Problema de la Longitud

Un CLAUDE.md de 4000 líneas no está organizado, está archivado. Un archivo archivado no se lee bien. Un archivo organizado se lee rápido. La claridad supera a la integridad, siempre. El autor pregunta: ¿qué hay en las primeras 20 líneas de tu CLAUDE.md?