Файлы CLAUDE.md часто организованы для разработчиков, а не для ИИ-моделей — вот почему это важно

Пост на r/ClaudeAI подчеркивает распространенный сбой в файлах CLAUDE.md: они структурированы вокруг того, что разработчик хочет задокументировать, а не того, что модели нужно для принятия решений. Это разные задачи.

Структура, ориентированная на разработчика

Пример файла, организованного для разработчика:

## О проекте
[3 абзаца контекста]
## Технологический стек
[15 пунктов]
## Цели
[5 пунктов списка]
## Жесткие правила   <- это на строке 47

Модель читает линейно. К тому времени, когда она доходит до жестких правил, она уже начала формировать предположения. Если ограничение должно переопределить эти предположения, модель борется с трудностями.

Структура, ориентированная на модель

В посте предлагается ментальная модель: спросите «что модели нужно за 3 секунды до того, как она сделает что-то необратимое?» Поместите это первым. Лучшая структура:

## Жесткие правила (прочтите их первыми)
[ваши фактические ограничения]
## Текущий контекст
[что сейчас активно]
## Предыстория
[остальное]

Проблема длины

4000-строчный CLAUDE.md — это не организация, это архивирование. Архивированный файл читается плохо. Организованный файл читается быстро. Ясность важнее полноты, всегда. Автор спрашивает: что в первых 20 строках вашего CLAUDE.md?