Раздул CLAUDE.md до 400 строк, и стало ХУЖЕ — кто-нибудь объяснит почему

[svelteandy]

Логика была — больше контекста = лучше. Напихал в CLAUDE.md все конвенции, плейбуки, пошаговые инструкции на 400 строк. В итоге он стал игнорить половину и косячить там где раньше было ок. Что не так?

[docker13]

Классика. Если CLAUDE.md слишком длинный, важные правила тонут в шуме и он их просто пропускает. Чисти безжалостно. Туда — факты и стоящие правила на каждую сессию, а не процедуры и плейбуки.

[Vvz1995]

Процедуры выноси в skills или слэш-команды, которые подгружаются по требованию. CLAUDE.md это про 'что всегда верно', а не 'как сделать X'. У меня он строк на 40 и работает лучше чем твои 400.

[leelo]

@svelteandy о, то есть плейбуки в команды а в md только инварианты. Логично, спасибо. Урезал до 50 строк, реально подхватывает лучше.

[misha12]

Кстати про автоматику — вместо того чтобы писать в md 'всегда запускай линтер', повесь PostToolUse хук. Хук гарантирует что форматтер ВСЕГДА отработает, а инструкция в md это просто пожелание которое он может проигнорить.

[burg0809]

@docker13 вот это разделение в голове щёлкнуло: хуки = гарантия, md = пожелание. Перенёс линт и тесты в хуки.

[deepsamurai]

Только с сабагентами осторожно. Команда гоняла параллельных code-review сабагентов на PR в 40 файлов и словила $180 за один прогон. Без per-session гейта по стоимости узнаешь об этом в счёте.

[alansmit]

@deepsamurai $180 за один прогон ревью это конечно мощно. Параллельные сабагенты крутая штука но кошелёк надо держать на коротком поводке.

[juniorstack]

Ровно в эту же яму упал на прошлой работе. Напихал в CLAUDE.md архитектурные принципы, правила именования, гайды по тестированию — думал, один раз потрачу время и больше не объяснять. Итог: модель первые 3-5 строк читает внимательно, дальше начинает срезать углы. Есть конкретное наблюдение: если в md больше 1500-2000 токенов, правила из середины документа начинают систематически нарушаться. У Claude 3.7 это ещё более выражено чем у 3.5 из-за того как устроено внимание на длинных системных промптах. Рецепт работающий: CLAUDE.md до 60 строк, всё остальное — отдельные .md файлы в папке .claude/docs/, которые подгружаются нужным слэш-командой или упоминаются в конкретном запросе. Модель читает их свежо, а не через замыленный фильтр общего промпта.

[delphin]

@svelteandy, хуки это вообще отдельная история. Только уточнение по PostToolUse: если завесить на него линтер, он будет дёргаться после КАЖДОГО вызова инструмента, включая чтение файлов. На больших проектах это начинает заметно тормозить. Лучше вешать на конкретные инструменты — например только на Write и Edit, а не на всё подряд. В settings.json это пишется так: matcher по tool name, не глобальный хук. Тогда форматтер стреляет ровно тогда когда надо.