Хеллоу.

Если решишь попробовать вайб-кодинг - очень быстро упрешься в одну штуку, про которую почти никто не рассказывает

Есть один файл, который держит на себе всю систему. Дело даже не в том, что про него мало кто знает - его дико недооценивают. А зря - это фундамент всей разработки с ИИ

Объясню просто. У кодинг-агента нет памяти между задачами, каждый раз он начинает с чистого листа. И есть текстовый файл, который он читает первым делом перед каждой задачей - его правила работы

В Claude Code это CLAUDE md, в Codex - AGENTS md, в Gemini - GEMINI md. По сути одно и то же

Так вот, от того насколько ты этот файл настроил - зависит вообще все

Файл пустой или кривой - агент тупит, галлюцинирует, переспрашивает по десять раз и делает по-своему. Файл собран нормально - понимает с полуслова, не лезет куда не просили, выдает то что нужно

И вторая вещь, которая до меня не сразу дошла. В сам файл складывается вся наработанная система - стек, ошибки, решения, баги. Я в главном файле держу ссылки на реестры со всей этой информацией и если чиним баг - система идет в реестр багов и смотрит какие баги были и как мы их чинили. Агент накосячил, я пофиксил баг - записал в этот реестр, и дальше он те же грабли уже обходит. Чем дольше работаешь - тем реже повторяет старое. Это не разовая настройка, а живой механизм

Что я думаю: это самое недооцененное место во всем вайб-кодинге. Все гоняются за новыми моделями, типо вот выйдет следующая и заживем, а реальный прирост часто вот тут, в обычном текстовом файле

И тут главная ловушка, на которой я сам обжегся. Работал-работал, и в какой-то момент Claude Code начал откровенно тупить. Полез разбираться - а у меня в этом файле уже 500 строк накопилось. А сами создатели Claude Code в Anthropic говорят: максимум 200, а лучше меньше. Есть и исследование ETH Zurich (февраль 2026): плохой раздутый файл хуже, чем вообще никакого. Так что меньше - лучше, целься в 50-100 строк без воды. Собственно, из этой истории и родился гайд

Я собрал в него все самые крутые практики из интернета на эту тему в одном месте. Что в файле должно быть, как его вести, чего туда писать НЕ надо (а косячат там все одинаково)

Как применить, два варианта:
1. Просто прочитать и понять что там должно быть. Этого уже хватит чтоб не наделать стандартных ошибок
2. Отдать гайд своему Claude или Codex и сказать: проверь свой ключевой файл по этим практикам, что добавить, что убрать. Он сам разберется и предложит правки

У меня это подняло эффективность работы с агентом в разы. Без новых подписок и сложных настроек - просто привел в порядок один файл

Забирайте, гайд по ссылке:
https://github.com/syrtsovk/Syrtsovk_toolkit/blob/main/guides/Ключевые-файлы-кодинг-агентов.pdf