Rules для команды: один файл — меньше споров в ревью

Общий .cursor/rules выравнивает стиль агента у всех. Что писать в правилах и чего лучше не класть.

Общий файл правил экономит часы ревью: агент перестаёт угадывать стек и не тащит в diff чужой стиль.

Зачем это команде

Без правил каждый открывает Cursor со своими привычками. Один просит Tailwind, второй пишет инлайн-стили, третий переименовывает slug «чтобы было красивее». На ревью вы спорите не о задаче, а о том, что модель выдумала за ночь.

Короткий .cursor/rules или набор файлов в .cursor/rules/ фиксирует договорённость текстом. Агент читает его чаще, чем Slack.

Что положить в правила

Хватит одной-двух страниц. Пишите запреты и факты, не лозунги.

стек: Next.js, App Router, какой пакетный менеджер;
куда не ходить: чужие сайты на VPS, прод-базы без явной просьбы;
как коммитить: без .env, без ключей, без --force в main;
стиль diff: минимальные правки, без рефакторинга «заодно»;
продукт: какие кнопки нельзя вести на офферы, какой язык у пользователя.

Плохой пример: «пиши чистый код и думай как сеньор». Хороший: «не меняй существующие slug без миграции».

Чего не класть

Секреты, пароли, connection string. Простыни «для SEO». Копию всего README. Если правило нельзя проверить по diff за десять секунд — его лучше выкинуть.

Не дублируйте гайд на три тысячи слов. Для глубины оставьте ссылку на полное руководство по Rules и правила и агенты.

Как ввести в репозиторий

Создайте .cursor/rules/project.mdc или один .cursorrules, как принято у вас.
Опишите 15–25 конкретных строк и пример «плохо / хорошо».
Прогоните одну типичную задачу с Agent и посмотрите, нарушил ли он запрет.
Поправьте формулировку, если агент её обходит общими словами.
Закоммитьте файл вместе с командой — правила живут в git, не в голове тимлида.

Новичкам достаточно сказать: «открой проект, правила уже в репозитории». Не нужно заново объяснять стек в каждом чате.

Как понять, что правила работают

Агент реже трогает соседние папки. Diff короче. В ревью меньше комментариев «зачем переписал этот файл». Если после правил шума стало больше — вы написали слишком общо или слишком много.

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

Короткий чеклист перед мержем правил

Нет секретов и внутренних URL с токенами.
Есть хотя бы три запрета, которые ловят реальные ошибки команды.
Есть стек и имя продукта.
Файл читается за минуту.

Дальше можно не спорить в каждом PR, а ткнуть в файл: «это уже в rules».