Rules — это системные инструкции для Agent и Inline Edit. Думай о них как о постоянном контексте, предпочтениях или рабочих процессах для твоих проектов. Cursor поддерживает четыре типа правил:

Project Rules

Хранятся в .cursor/rules, находятся под контролем версий и привязаны к твоей кодовой базе.

User Rules

Глобальны для твоего окружения Cursor. Задаются в настройках и применяются всегда.

AGENTS.md

Инструкции для Agent в формате Markdown. Простая альтернатива .cursor/rules.

.cursorrules (Legacy)

Всё ещё поддерживается, но устарело. Используй Project Rules вместо него.

​
Как работают правила

Крупные языковые модели не запоминают контекст между завершениями. Правила дают постоянный, многократно используемый контекст на уровне промпта. Когда правило применяется, его содержимое добавляется в начало контекста модели. Это даёт ИИ последовательные ориентиры для генерации кода, интерпретации правок и помощи с рабочими процессами.
Правило применено в контексте чата
Правила действуют в Chat и Inline Edit. Активные правила отображаются в боковой панели Agent.

​
Правила проекта

Правила проекта хранятся в .cursor/rules. Каждое правило — это отдельный файл и находится под управлением версий. Их можно ограничивать по шаблонам путей, вызывать вручную или подключать по релевантности. Вложенные каталоги могут содержать свой .cursor/rules, действующий в пределах этой папки. Используй правила проекта, чтобы:
  • Зафиксировать доменные знания о твоей кодовой базе
  • Автоматизировать проектные рабочие процессы или шаблоны
  • Стандартизировать решения по стилю и архитектуре

​
Структура правила

Каждый файл правила пишется в формате MDC (.mdc), который поддерживает метаданные и контент. Управляй применением правил через выпадающий список типа, который меняет свойства description, globs, alwaysApply.
Тип правилаОписание
AlwaysВсегда включается в контекст модели
Auto AttachedПодключается, когда упоминаются файлы, совпадающие с glob-шаблоном
Agent RequestedДоступно ИИ, который решает, включать ли его. Нужно указать описание
ManualВключается только при явном упоминании через @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

​
Вложенные правила

Организуй правила, размещая их в директориях .cursor/rules по всему проекту. Вложенные правила автоматически подключаются, когда упоминаются файлы из их директории. 
project/
  .cursor/rules/        # Правила для всего проекта
  backend/
    server/
      .cursor/rules/    # Правила для backend
  frontend/
    .cursor/rules/      # Правила для frontend

​
Создание правила

Создавай правила командой New Cursor Rule или через Cursor Settings > Rules. Это создаст новый файл правила в .cursor/rules. В настройках ты можешь посмотреть все правила и их статус.
Сравнение кратких и подробных правил

​
Генерация правил

Генерируй правила прямо в диалогах с помощью команды /Generate Cursor Rules. Полезно, когда ты принял решения о поведении агента и хочешь переиспользовать их.

​
Лучшие практики

Хорошие правила должны быть сфокусированными, применимыми на практике и чётко ограниченными по области.
  • Держи правила короче 500 строк
  • Разбивай большие правила на несколько составных правил
  • Приводи конкретные примеры или ссылки на файлы
  • Избегай расплывчатых рекомендаций. Пиши правила как понятные внутренние доки
  • Переиспользуй правила, если в чате повторяются промпты

​
Примеры

Много примеров доступно от поставщиков и фреймворков. Правила от сообщества можно найти в краудсорсинговых подборках и репозиториях онлайн.

​
AGENTS.md

AGENTS.md — это простой markdown-файл для задания инструкций агенту. Положи его в корень проекта как альтернативу .cursor/rules для простых сценариев. В отличие от Project Rules, AGENTS.md — это обычный markdown-файл без метаданных и сложных конфигураций. Он отлично подходит для проектов, где нужны простые, читаемые инструкции без накладных расходов на структурированные правила. 
# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

​
Текущие ограничения

  • Только в корне: AGENTS.md должен лежать в корне проекта (v1.5)
  • Без областей: Инструкции применяются глобально ко всему проекту
  • Один файл: В отличие от .cursor/rules, ты не можешь разбить инструкции на несколько файлов
Поддержка вложенных AGENTS.md в поддиректориях запланирована для v1.6.

​
Правила пользователя

Правила пользователя — это глобальные настройки, заданные в Cursor Settings → Rules, которые действуют во всех проектах. Это обычный текст — идеально подходит, чтобы задать предпочитаемый стиль общения или договорённости по коду: 
Пожалуйста, отвечай кратко. Избегай лишних повторов и пустых фраз.

​
.cursorrules (устаревшее)

Файл .cursorrules в корне твоего проекта всё ещё поддерживается, но будет вскоре снят с поддержки. Рекомендуем перейти на Project Rules — так у тебя будет больше контроля, гибкости и прозрачности.

​
FAQ