Изначально я работал с CLAUDE.md и настройками отдельных агентов, но это не до конца решало мои задачи: агент всё равно иногда забывал важные детали, путался в инфраструктуре или начинал работать “как обычно”, без учёта контекста проекта.
Когда в Claude Code появился удобный механизм rules, я начал строить рабочий процесс вокруг этих правил. Идея простая: не пытаться запихнуть всё в один огромный файл, а разложить правила на небольшие, хорошо отлаженные слои.
Коротко о том, как это устроено у меня.
L1 — глобальный слой.
Это короткие правила про работу со всей нашей инфраструктурой: где искать задачи, как ходить в вики, какие CLI использовать, как посмотреть комменты с PR, как искать код и т.д. У меня это около 15 небольших файлов примерно на 6к токенов, которые лежат в глобальных правилах на маке:
/Users/<username>/.claude/rules/
Благодаря этому Claude Code в любой директории понимает, какая инфраструктура у меня есть и как с ней работать.
L2 — проектный слой.
Под каждый проект я добавляю отдельные правила. Если нужно, между L1 и L2 появляется ещё слой для домена: мобильная разработка, фронт, бэкенд и т.п. А уже после него идут конкретные проектные правила.
Что находится в проектных правилах?
Я сторонник коротких, но точных правил. Обычно там лежит: краткое описание архитектуры проекта, сжатая карта проекта, основные “нельзя”, базовые паттерны и ссылки, куда смотреть примеры. Для большого проекта это особенно важно: когда у тебя десятки тысяч файлов и сотни модулей, агенту нужно не “читать всё”, а быстро понять, куда идти.
Что это даёт?
Получается слоёная структура: L1 + L2 + LN, которая меняется в зависимости от проекта. Она занимает немного кэшируемого контекста, но сильно повышает предсказуемость агента. Вместо одного огромного файла с правилами получается набор маленьких кирпичиков, каждый из которых отвечает за свою часть рабочего процесса.
Мне такой подход кажется очень эффективным: его недорого внедрить, легко поддерживать и удобно переиспользовать между проектами. Особенно если вы активно работаете с агентами в разных проектах
Попробуйте — возможно, вам тоже понравится, насколько меняется работа Claude Code при таком подходе.