На GitHub внезапно в топе оказался не новый фреймворк и не впечатляющий open-source-проект, а обычный текстовый файл — CLAUDE.md. За неделю репозиторий набрал более 44 тысяч звезд, а общее число превысило 61 тысячу.

Причина такого ажиотажа проста: файл предлагает крайне практичный набор правил для AI-агентов, пишущих код, и, по сути, превращает опыт сильного инженера в готовую «прошивку поведения» для модели.

В основе CLAUDE.md лежат наблюдения Андрея Карпаты о том, как LLM чаще всего ошибаются в программировании. Документ формулирует четыре базовых принципа.

Во-первых, если модель не уверена, она должна не угадывать, а задавать уточняющие вопросы.

Во-вторых, код должен оставаться максимально простым: без лишних абстракций, ненужной гибкости и «корпоративной архитектуры» там, где нужен небольшой фрагмент логики.

В-третьих, AI не должен трогать ничего сверх поставленной задачи: исправил баг — не устраивай попутный рефакторинг всего файла. И, наконец, модель нужно ориентировать не на пошаговые инструкции, а на четкий результат и критерии проверки.

Именно эта простота и сделала файл вирусным. Разработчики быстро узнали в этих правилах свои ежедневные боли: модель выбирает слишком сложный путь, меняет лишнее, придумывает требования сама и тратит время там, где хватило бы одного вопроса.

Как отмечают участники обсуждения, проблема все чаще заключается уже не только в качестве самой модели, а в «обвязке» вокруг нее — в правилах, ограничениях и способах постановки задач.

Автор проекта, Jiayuan Zhang, превратил длинный пост Карпаты о типичных ошибках AI-агентов в компактный и пригодный к использованию файл инструкций.

Получился не просто набор советов, а универсальный интерфейс управления поведением AI при работе с кодом. Достаточно положить CLAUDE.md в корень проекта, и агент будет ориентироваться на эти правила при генерации и правке кода.

Популярность репозитория хорошо вписывается в более широкий сдвиг, о котором говорит сам Карпаты. По его словам, рабочий процесс программиста уже меняется: вместо модели «80% кода пишу сам, 20% помогает AI» появляется противоположная схема — 80% работы берет на себя агент, а человек в основном проверяет, направляет и дорабатывает.

Это делает разработку быстрее, но одновременно несет риск лавины низкокачественного AI-контента и постепенного ослабления собственных навыков ручного кодинга.

Поэтому феномен CLAUDE.md — это не просто история о популярном файле. Это сигнал о том, что программирование входит в эпоху agentic engineering, где главное конкурентное преимущество дает не только мощная модель, но и умение правильно задать ей рамки, цели и критерии качества.

И, возможно, именно такие «простые» текстовые файлы станут новой инженерной дисциплиной для работы с ИИ.