Как предотвратить гниение CLAUDE.md: Относитесь к правилам как к коду

После 18 месяцев использования Claude Code в производственных проектах u/mm_cm_m_km выявил самую частую точку отказа: файл CLAUDE.md гниет. Не потому, что Claude его игнорирует, а потому что разработчики постоянно добавляют правила, никогда их не очищая. Результат — раздутый файл на 500 строк, который расходует токены на каждом шаге и расходится с реальной кодовой базой.

1. CLAUDE.md как указатель, а не инструкция

Держите CLAUDE.md в пределах 30–50 строк. Он должен служить оглавлением, указывающим на конкретные файлы для конкретных задач, а не стеной всех ваших когда-либо установленных предпочтений. Claude перечитывает файл на каждом шаге; короткие файлы дешевы, длинные тратят токены и внимание.

2. Каждый раздел отвечает на один из двух вопросов

• Какое поведение вы хотите? (правило) — должно быть в CLAUDE.md.
• Где найти актуальную правду? (источник) — должно быть URL или путем к файлу, который Claude может перечитать при выполнении задачи.

Смешивание правил и источников — вот как файлы бесконечно растут. Держите правило коротким, источник — внешним.

3. Проверяйте до слияния, а не после

Правила незаметно устаревают, когда вы переименовываете вещи, рефакторите хуки или удаляете функции. Исправление — не «будьте внимательнее», а шаг CI. Автор создал GitHub-приложение agentlint (agentlint.net), которое проверяет поверхность правил в каждом PR: противоречия между файлами, ссылки на удаленные пути, правила, описывающие функции, которые ваша версия не поддерживает.

4. Удаляйте больше, чем добавляете

Почти каждый CLAUDE.md получает одно новое правило в неделю и не удаляет ни одного. Через полгода получается Франкенштейн. Дисциплина: за каждое новое правило найдите одно для удаления. Это позволило автору держать файл в пределах 100 строк.

Основная идея: относитесь к правилам как к коду. Код имеет тесты, ревью и обнаружение дрейфа. Правилам нужно то же самое.