Меню

AI Council и CLAUDE.md: когда файла с правилами перестаёт хватать

CLAUDE.md, AGENTS.md и cursor rules — хороший способ начать. Сложности появляются, когда к проекту подключается команда, растёт legacy и агенты работают в нескольких ветках сразу.

Записаться на демо

Когда CLAUDE.md достаточно

Проект небольшой, и правила помещаются на пару экранов
Над кодом работает один-два человека
Задачи идут последовательно, без параллельных веток агентов

В этом случае AI Council, скорее всего, не нужен.

Что ломается с ростом проекта

Файл отстаёт от кодаМодуль переехал, а правило осталось про старый путь. Никто не замечает, пока агент не сделает по-старому.
У каждого свой файлПравила расходятся между разработчиками и между репозиториями.
Всё сразу в контекстеАгент читает файл целиком, даже если для задачи нужна одна строка. С ростом файла растут расходы на токены.
Нет проверкиФайл советует, но не проверяет. Узнать, что правило нарушено, можно только на ревью.
Одна версия на все веткиРешение, принятое в одной задаче, сразу видно в другой, хотя ещё не прошло merge.

Сравнение по пунктам

Что важно	CLAUDE.md и аналоги	AI Council
Связь с кодом	Текст в файле	Знания привязаны к модулям и функциям и переанализируются после изменений
Команда	Каждый ведёт свой файл	Одна база на команду, похожие записи система находит и предлагает объединить
Ветки	Одна версия на все ветки	Знания разделены по веткам и переходят в целевую после merge
Что получает агент	Весь файл	Только то, что относится к задаче, в пределах бюджета токенов
Проверка	Нет	Проверка диффа на нарушения обязательных правил и ревью MR
Видимость	Нет	Нарушения, переделки и использование знаний по неделям

Можно ли оставить CLAUDE.md?

Да. AI Council не требует удалять файлы с правилами. Обычно команда переносит важные договорённости в базу знаний как правила MUST и SHOULD, а в файле остаётся короткое описание проекта.

Покажем на вашем репозитории

Подключим проект, перенесём главные правила и покажем первое ревью на реальном коде.

Записаться на демо