К сожаленью, не нашел в русскоязычном комьюнити расширенного писания правил, как сейчас складывается практика по CLAUDE.md или AGENTS.md, хотя за более чем год она должна была сложиться. Поэтому решил провести свое исследование, чтобы можно было говорить не на уровне персональной экпертности, а на уровне цифр и того, как эти подходы помогают продвигать продукты.
Файл правил для AI‑агента — CLAUDE.md или AGENTS.md в корне репозитория — сейчас пишут почти все, кто работает с агентами всерьёз. Советов, что туда класть, много, и почти все они — личный опыт. Мне захотелось посмотреть на практику: что реально лежит в популярных репозиториях.
Я собрал четыре выборки по 1 000 проектов, прогнал по ним 70 шаблонов правил и свёл результат в 20 базовых правил. А потом взял проект с самым высоким покрытием — garrytan/gstack — и прочитал его файлы глазами. Вторая часть оказалась полезнее первой: она показала, где мой собственный метод врёт.
Сбор и подсчёт я делал вместе с агентом (Claude Code): он писал и запускал скрипты, я ставил задачи и перепроверял. Об этом тоже расскажу.
