Cursor Rules: как настроить .cursor/rules чтобы AI знал ваш стек раз и навсегда

Cursor Rules в 2026 как настроить .cursor/rules за один вечер

Cursor Rules это файлы с инструкциями, которые подгружаются в каждый запрос к AI, чтобы агент знал ваш стек, стиль кода и запреты без повторов в чате. В 2026 старый .cursorrules в корне проекта устарел. Актуальный формат это папка .cursor/rules/ с .mdc файлами, по одному на каждую зону ответственности. Ниже разберем четыре типа правил, как они приоритезируются при конфликте, как сгенерировать правило за минуту вместо написания руками и готовые шаблоны под Next.js, Python и 1С.

Если коротко: один always-rule под 200 слов с описанием проекта, три-четыре auto-attach правила по типам файлов и одно-два ручных под особые задачи. Этого хватает 90% проектов.

Что такое Cursor Rules и зачем они нужны

Правила решают одну проблему: модель не помнит контекст между запросами. Каждый новый чат начинается с чистого листа, и без правил вы каждый раз объясняете заново, что у вас Next.js 15, а не Pages Router, и что в проекте только named exports.

Правило это постоянный системный промпт, который встраивается перед каждым запросом агента. Описали стек один раз, и Cursor применяет конвенции сам. На практике это экономит часы: не надо в десятый раз писать «используй pnpm, не npm».

Один автор YouTube-гайда пошутил, что правила повышают благополучие вайбкодера минимум на 27%. Цифра выдуманная, но идея верная. Когда агент перестает предлагать паттерны, которые вы только что запретили, работать становится спокойнее.

Максим: «Ребят, это работает. Когда мы пилили GoBanana, без правил Cursor каждый раз тащил классовые компоненты вместо хуков. Прописали один .mdc на 40 строк, и агент перестал спорить со стеком. Сделал, получил цифру: примерно минус полчаса в день на правки за агентом.»

Почему .cursorrules устарел и что вместо него

Короткий ответ: один файл .cursorrules в корне грузился целиком в каждый запрос и жрал контекст. Папка .cursor/rules/ с отдельными .mdc файлами грузит только то, что нужно под текущую задачу. Экономия токенов доходит до 40-60%.

.mdc это markdown с YAML-блоком метаданных сверху. Если знаете markdown, разберетесь за пять минут. В шапке указываете три поля: description (зачем правило), globs (к каким файлам цепляется) и alwaysApply (грузить всегда или по условию).

Старый файл при этом не сломается. Cursor его пока читает, удалять сразу не обязательно. Лучше мигрировать по частям: переносите по одной секции в отдельный .mdc, проверяете поведение, потом убираете старый монолит.

Четыре типа правил в Cursor и когда какой брать

В Cursor четыре режима активации правил, и от выбора зависит, сработает правило вовремя или нет. Тип задается в шапке .mdc через поля alwaysApply, globs и description.

Главное правило выбора: не делайте все правила always. Это первая ошибка новичков. Каждый always-токен грузится в каждый запрос, и контекст забивается мусором.

Always Apply для базового контекста проекта

Грузится в каждый чат без исключений. Сюда кладете фундамент: какой стек, что за проект, общие стандарты команды. Поле alwaysApply: true.

Держите такое правило коротким, до 200 слов. Каждый токен тут платится в каждом запросе. Если always-правило раздулось до тысячи слов, Cursor начнет тормозить и упираться в лимит контекста.

Auto Attached по glob-паттернам

Подключается, только когда вы трогаете файлы по заданному пути. Например, правило для схемы базы цепляется к db/schema/**, а правило по стилям к **/*.tsx. Поле globs плюс alwaysApply: false.

Это рабочая лошадка. Три-четыре auto-attach правила, разнесенные по типам файлов, закрывают большую часть конвенций без перерасхода контекста.

Agent Requested когда решает сам агент

Правило доступно агенту, и он сам решает, подключать его или нет, опираясь на description. alwaysApply: false плюс четкое описание.

Тут главное написать внятный description. «Используй для платежей» это не описание. «Применять при генерации Zod-схем для форм и тел API-запросов» это описание. Пишите так, будто объясняете человеку, когда брать правило.

Manual через @имя-правила

Подключается только когда вы явно зовете его через @ruleName. Ни globs, ни description, просто alwaysApply: false. Берите для редких задач: подготовка релиза, разовая миграция, специфичный чеклист.

Как приоритезируются правила при конфликте

Когда два правила говорят разное, Cursor применяет их в определенном порядке. Источники сливаются так: Team Rules, потом Project Rules, потом User Rules. Все подходящие правила объединяются, и при противоречии приоритет у более раннего источника.

Внутри проектных правил порядок такой: сначала локальные ручные через @ruleName, затем auto-attached по совпадению glob. По наблюдениям из практики, при конфликте более раннее правило перебивает позднее.

Есть и нюанс, который ломает людям логику. Если ваш ESLint запрещает default exports, а правило Cursor их поощряет, правило проиграет каждый раз. Не воюйте с линтером, зеркальте его. Агент должен уважать ваш тулчейн, а не обходить его.

Как сгенерировать правило за минуту вместо написания руками

Самый быстрый способ: не пишите правила с нуля. Дайте Cursor проанализировать уже существующий файл и сгенерировать конвенцию по нему. Это занимает меньше минуты и работает точнее ручного описания.

Рабочий паттерн из практики выглядит так. Открываете готовый компонент, который написан как надо. Просите агента: проанализируй этот файл и сгенерируй правило с конвенцией для таких компонентов. Cursor сам опишет структуру, типизацию, обработку ошибок.

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

Еще один прием для документирования стека. Просите Cursor разобрать package.json и собрать правило с описанием зависимостей и лучших практик под актуальные версии. Агент сам вытащит, что у вас за фреймворк и какой версии.

Лиза: «Прикинь, я раньше думала, что правила надо писать вручную часами. А оказалось, кидаешь агенту хороший файл и говоришь "сделай из этого правило". На NeuroScribe мы так за вечер собрали восемь правил под фронт. Вот такие пироги)»

Готовые шаблоны Cursor Rules под популярные стеки

Ниже три шаблона, которые можно скопировать и подогнать под себя. Это база, дальше дополняете под проект. Помните про лимит always-правил в 200 слов.

Шаблон для Next.js и TypeScript

Кладете в .cursor/rules/base.mdc как always-правило. Описывает ядро проекта, которое нужно агенту всегда.

---
alwaysApply: true
description: "Ядро проекта Next.js"
---
# Стек и конвенции
- Next.js 15, только App Router, Pages Router не предлагать
- Server Components по умолчанию, 'use client' только когда нужно
- TypeScript strict, тип any запрещен
- Только named exports, default не использовать
- Все async-функции в try/catch
- Менеджер пакетов pnpm, не npm и не yarn
- Tailwind v4 для стилей, инлайн-стили запрещены
- Тесты рядом с исходником как *.test.ts
- Стиль ответов: короткие фразы, без длинных тире

Шаблон для Python

Кладете в .cursor/rules/python.mdc как auto-attached с глобом на .py файлы. Так оно цепляется только при работе с Python-кодом.

---
globs: "**/*.py"
alwaysApply: false
description: "Конвенции Python"
---
# Python
- Python 3.12, аннотации типов обязательны везде
- Форматирование black, линтер ruff
- Зависимости через uv или poetry, не голый pip
- Функции с docstring в формате Google
- Обработка ошибок через конкретные исключения, не голый except
- Тесты на pytest, фикстуры в conftest.py

Шаблон для 1С

Запрос «cursor rules 1c» есть в поиске, и под платформу 1С тоже можно настроить правила. Кладете в .cursor/rules/1c.mdc как auto-attached, цепляете к файлам выгрузки конфигурации.

---
globs: "**/*.bsl, **/*.os"
alwaysApply: false
description: "Конвенции 1С BSL"
---
# 1С BSL
- Код и комментарии на русском, как принято в команде
- Имена переменных и процедур в стиле проекта, без транслита вперемешку
- Запросы выносить отдельно, не лепить в одну строку
- Обработка ошибок через Попытка-Исключение с записью в журнал регистрации
- Транзакции явно: НачатьТранзакцию, ЗафиксироватьТранзакцию, ОтменитьТранзакцию
- Не предлагать конструкции из других языков, только синтаксис 1С

Сильные стороны Cursor Rules

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

Второй плюс это экономия контекста при правильной настройке. Раздробив монолит на 3-5 auto-attached правил и маленькое always-правило, вы режете расход токенов на запрос на 40-60%, и агент становится точнее на тех срезах, которые реально грузит.

Третий плюс это версионирование. Правила лежат в репозитории рядом с кодом, едут в Git, и вся команда работает по одним конвенциям. Новый разработчик подтянул проект и сразу получил рабочие правила.

Слабые стороны и где правила не помогут

Честно: правила не работают везде. User Rules не применяются к инлайн-правкам через Cmd/Ctrl+K, и на автодополнение в Tab они почти не влияют. Максимальный эффект только в чате и Composer.

Вторая проблема это соблазн сделать все always. Поставили alwaysApply: true на каждое правило, и контекст забился, Cursor затормозил. Аудитьте правила раз в квартал: если always-правил больше двух-трех, вы скорее всего жжете токены впустую.

Третье ограничение это память. Правила и навыки задают поведение, но проектное обучение не накапливается. Какие подходы к отладке лучше работают именно в этой кодовой базе, агент забывает после сессии. Каждый новый чат это снова джун по знанию вашего проекта.

И последнее: правило-документация это пустая трата токенов. Правило, которое объясняет, что такое Drizzle, бесполезно. Модель и так знает. А вот правило, которое предписывает, как именно этот репозиторий использует Drizzle, свое место отрабатывает.

Rules, Skills и Subagents в Cursor 2026

С версии 2.4 (январь 2026) Cursor поддержал Skills и Subagents, и тут люди путаются, что вместо чего. Правила не отменили. У них активная страница в документации и четыре типа: project, user, team и AGENTS.md.

Разница простая. Правила это конституция проекта: декларативные, всегда на месте, «используй TypeScript strict». Skills это датчик движения: подключаются по необходимости, процедурные, «вот как задеплоить на AWS». Лампочка горит всегда и тратит ток, датчик включается, когда есть движение.

Skills грузятся лениво. Когда агент стартует, он видит только заголовки и описания доступных навыков, а полный текст подтягивает, только если задача совпала. Это экономит контекст.

Есть команда /migrate-to-skills, но она конвертирует динамические правила и слэш-команды в навыки, а не все правила подряд. Декларативные always-правила остаются правилами.

Subagents это отдельные специализированные агенты со своим контекстным окном и выбором модели, которые работают параллельно. Дорогая модель планирует, быстрая реализует. Один типичный паттерн: исследовательский subagent читает доки и миграционные гайды нового фреймворка, а основной агент в это время рефакторит код, опираясь на его находки.

Подробные обзоры Cursor и сравнения с Windsurf, Claude Code и GitHub Copilot собраны в нашем каталоге AI-инструментов.

FAQ по настройке Cursor Rules

Где лежат cursor rules в 2026 году?

В папке .cursor/rules/ внутри проекта, каждое правило отдельным .mdc файлом. Старый .cursorrules в корне устарел, но пока читается. User Rules задаются глобально в настройках Cursor через Settings, Rules.

Чем .mdc отличается от обычного .md?

.mdc поддерживает YAML-шапку с полями description, globs и alwaysApply, которые включают условную загрузку. Обычный .md в папке правил тоже работает, но без метаданных, то есть без условного подключения. Для гибкости берите .mdc.

Сколько правил оптимально держать в проекте?

Пять-восемь это золотая середина. Одно базовое always-правило, три-четыре auto-attached по типам файлов, одно-два ручных под особые задачи. Больше десяти обычно значит, что часть можно объединить или удалить.

Почему агент игнорирует мое agent-requested правило?

Скорее всего размытое описание. «Используй когда нужно» агенту ничего не говорит. Пишите конкретно: «применять при генерации Zod-схем для форм и тел API-запросов». Описание должно четко объяснять сценарий, когда правило брать.

Можно ли настроить cursor rules под 1С?

Да. Создаете .mdc с глобом на файлы выгрузки конфигурации (.bsl, .os) и прописываете конвенции: язык комментариев, работа с транзакциями, обработка ошибок через Попытка-Исключение. Шаблон выше можно скопировать и подогнать под вашу конфигурацию.

Нужно ли мигрировать на Skills, если уже есть rules?

Не обязательно и не все сразу. Декларативные правила вроде «используй strict mode» оставляйте правилами. На Skills переносите процедурные многошаговые штуки: процесс код-ревью, деплой, валидация миграций. Команда /migrate-to-skills сама конвертирует подходящие правила.

Влияют ли правила на автодополнение Tab?

Почти нет. Правила работают в чате и Composer. На инлайн-правки через Cmd/Ctrl+K и на подсказки Tab они практически не влияют. Если ждете от них магии в автодополнении, ждете зря.

Глоссарий терминов

Cursor Rules это файлы инструкций, которые подгружаются в запросы к AI-агенту, чтобы он знал ваш стек и конвенции без повторов.

.mdc это формат файла правила: markdown плюс YAML-блок метаданных сверху.

.cursor/rules/ это папка проекта, где лежат правила в актуальном формате 2026 года.

.cursorrules это старый одиночный файл правил в корне проекта, устарел, но пока поддерживается.

glob это паттерн пути к файлам (например **/*.tsx), по которому правило цепляется к нужным файлам.

alwaysApply это поле в шапке правила: грузить его в каждый запрос (true) или по условию (false).

Always / Auto Attached / Agent Requested / Manual это четыре типа активации правил по способу подключения.

token-tax это расход контекста на always-правила: каждый их токен платится в каждом запросе.

Skills это процедурные навыки в формате SKILL.md, подключаются лениво по необходимости, появились в Cursor 2.4.

Subagents это отдельные специализированные агенты со своим контекстом, работают параллельно, появились в Cursor 2.4.

AGENTS.md это файл иерархических инструкций для агента, поддерживается в корне и подкаталогах.

С чего начать прямо сегодня

Сделайте минимальный набор за один вечер. Создайте папку .cursor/rules/, положите туда одно always-правило под 200 слов с описанием стека по шаблону выше. Этого уже хватит, чтобы агент перестал спорить с вашим проектом.

Дальше добавляйте auto-attached правила по типам файлов, когда замечаете, что объясняете Cursor одно и то же третий раз. Это сигнал, что пора зафиксировать конвенцию в правиле.

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

Обновлено: май 2026. Данные по версиям Cursor и формату правил актуальны на момент публикации.