Продвинутый потребитель Claude Code разделил свой CLAUDE.md на 27 файлов

Один из пользователей Claude Code рассказал, что отказался от монолитного CLAUDE.md около на 800 строк и разделил инструкции на 27 отдельных файлов. Причина - в большом файле правила для разных сценариев начинали конфликтовать друг с другом, важные ограничения терялись глубоко в тексте, а модель хуже держала нужный контекст.

Он разделил правила на 3 уровня: движок (core) -загружается всегда, примерно 10К токенов, общие инструкции для проекта (shared), и правила для конкретных проектов (context-specific) - файлы, которые подключаются только при работе с определенными папками через paths. Такой решение даёт возможность держать в постоянном контексте только базовые правила, а остальное подгружать по необходимости.

Монолитный CLAUDE.md тратит драгоценные токены (системный промпт Claude и так занимает примерно 23К), смешивает правила для разных задач и усложняет поддержку. Модульная платформа даёт возможность загружать только нужные инструкции, создавая композитные и легко управляемые наборы правил. Например, правила для написания кода на Python не будут загружаться, когда вы работаете с документацией в Markdown. Этот подход особенно полезен для ведения баз знаний и работы с несколькими проектами одновременно.

Отдельно он отмечает, что одних инструкций нев достаточной степени: для критичных ограничений он использует PostToolUse hooks - скрипты, которые после записи файла проверяют frontmatter, даты и wikilinks. Идея в том, что правила в CLAUDE.md модель может соблюдать не всегда, а хуки уже обеспечивают принудительную проверку.

В качестве практического совета автор предлагает не начинать сразу с 27 файлов: сначала вынести хотя бы 2 блока - жесткие ограничения и профиль пользователя, а дальше добавлять отдельные контекстные файлы только тогда, когда монолитный CLAUDE.md действительно начинает мешать.

P.S. Поддержать меня можно подпиской на канал "НейроProfit", где я рассказываю о том, в чем разбираюсь или пытаюсь разобраться сама, тестирую полезные ИИ-сервисы, инструменты для офиса, бизнеса, маркетинга и видео.