Cursor Rules — это постоянные инструкции для Agent: стиль кода, архитектура, запреты и шаблоны workflow. Модель не помнит прошлые чаты, поэтому rules подмешиваются в контекст как system-level guidance. Канон: cursor.com/docs/rules, help: Rules help. Не путать с Skills (процедуры по запросу) и Hooks (скрипты на событиях агента).

Соседи: Cursor для начинающих, Cursor CLI, Bugbot, Background / Cloud Agents. Pillar — n8n / автоматизация.

Для кого Cursor Rules

Берите rules, если Agent снова и снова ломает одни и те же соглашения проекта. Если нужен длинный пошаговый сценарий «как деплоить» — лучше skill. Если нужно заблокировать shell/MCP скриптом — hooks.

Тип Где живёт Когда включается Формат
Project Rules .cursor/rules/*.mdc always / globs / description / @mention markdown + frontmatter
User Rules Customize → Rules (аккаунт) Agent Chat во всех проектах свободный текст
Team Rules dashboard (Team/Enterprise) команда; можно enforce свободный текст + optional globs
AGENTS.md корень / вложенные папки автоматически в зоне папки plain markdown

*По cursor.com/docs/rules и help/customization/rules (август 2026). Цены планов Team/Enterprise в статье не фиксируем — смотрите кабинет Cursor.

Как пользоваться: маршрут на 1 вечер

  1. Создайте правило через /create-rule в Agent или Customize → Rules → Add Rule.
  2. Сохраните в .cursor/rules/имя.mdc (расширение .mdc обязательно для project rules).
  3. Выберите тип apply: Always / Intelligently (нужен description) / Specific Files (globs) / Manually (@mention).
  4. Напишите конкретику: запреты, шаблоны, ссылки @filename вместо копипасты гайда.
  5. Проверьте в чате: Agent должен следовать правилу; при сбое уточните текст rules, а не только промпт.
  6. Закоммитьте в git — rules полезны всей команде.
---
description: Конвенции React-компонентов в src/components
globs: src/components/**/*.tsx
alwaysApply: false
---

- Named exports, не default export
- Стили рядом с компонентом (CSS module)
- Компонент < 200 строк; дробите на соседей в той же папке

Frontmatter и типы apply

Под капотом важны три поля: alwaysApply, description, globs. Если alwaysApply=true — правило всегда в контексте. Если false и заданы globs — автоподхват при файлах в контексте. Если false и есть description без globs — Agent решает по релевантности. Без description и globs — только ручной @mention.

Nested AGENTS.md в подпапках поддерживаются: инструкции складываются с родительскими, более локальные сильнее. CLAUDE.md Cursor читает так же, как AGENTS.md.

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

  • Один раз описали — Agent не «забывает» стиль между чатами.
  • Scope по файлам через globs без перегруза контекста.
  • Team Rules с enforce для оргстандартов.
  • Импорт remote rules с GitHub в .cursor/rules/imported/.
  • Совместимость с простым AGENTS.md для лёгких репозиториев.

Типичные ошибки

  • Класть .md в .cursor/rules/ без frontmatter — система rules их игнорирует.
  • Копировать весь style guide в одно правило вместо линтера + коротких запретов.
  • Путать rules с Bugbot: для PR-ревью нужен BUGBOT.md, не только .cursor/rules.
  • Ждать, что User Rules сработают в Inline Edit (Cmd/Ctrl+K) — не сработают.
  • Делать одно правило на 2000 строк вместо нескольких focused .mdc.

FAQ: Cursor Rules

Что такое Cursor Rules?

Cursor Rules — постоянные инструкции для Agent: стиль, паттерны, запреты. Применяются как system-level контекст. Канон: cursor.com/docs/rules.

Где хранятся project rules?

В .cursor/rules/ как файлы .mdc с frontmatter (description, globs, alwaysApply). Обычный .md в этой папке система rules игнорирует — для простого markdown используйте AGENTS.md.

Чем Always Apply отличается от Apply Intelligently?

Always Apply (alwaysApply: true) включается в каждый чат. Apply Intelligently смотрит на description и подтягивает правило, когда Agent считает его релевантным. Apply to Specific Files — по globs; Apply Manually — по @mention.

Нужен ли AGENTS.md, если уже есть .cursor/rules?

AGENTS.md — простой markdown без метаданных, удобен для коротких инструкций. Для контроля scope (globs, alwaysApply) лучше .mdc в .cursor/rules/. Можно комбинировать.

Какой порядок приоритета у правил?

По доке Cursor: Team Rules → Project Rules → User Rules. При конфликте раньше по списку имеют приоритет. Team Rules доступны на Team/Enterprise.

Работают ли Rules с Cursor Tab и Inline Edit?

Нет. Rules не влияют на Tab. User Rules не применяются к Inline Edit (Cmd/Ctrl+K) — только к Agent Chat.

Вывод

Cursor Rules — слой постоянных инструкций для Agent, не замена skills и hooks. Старт: одно focused .mdc под боль проекта → проверка в чате → git. Для процедур смотрите Cursor Skills; для контроля shell/MCP — Hooks; общий вход — гайд новичка.

Артём Денисов эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Помогает настроить правила агента без хаоса в промптах.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.