Правила задают системные инструкции для 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
globs:
alwaysApply: false
---

- Используй наш внутренний RPC-паттерн при определении сервисов
- Всегда используй snake_case для названий сервисов.

@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 строк
  • Делай крупные правила составными — разбивай их на несколько правил
  • Приводи конкретные примеры или ссылки на файлы
  • Избегай расплывчатых формулировок. Пиши правила как понятную внутреннюю документацию
  • Переиспользуй правила, когда повторяешь подсказки в чате

​
Примеры

Это правило задаёт стандарты для фронтенд‑компонентов:При работе в директории components:
  • Всегда используй Tailwind для оформления
  • Используй Framer Motion для анимаций
  • Соблюдай соглашения по именованию компонентов
Это правило требует валидацию для API‑эндпоинтов:В директории api:
  • Используй zod для всей валидации
  • Определяй возвращаемые типы с помощью схем zod
  • Экспортируй типы, сгенерированные из схем
Это правило предоставляет шаблон для сервисов Express:Используй этот шаблон при создании сервиса Express:
  • Следуй принципам REST
  • Подключай middleware для обработки ошибок
  • Настраивай корректное логирование
@express-service-template.tsЭто правило определяет структуру компонента React:Компоненты React должны придерживаться такой структуры:
  • Интерфейс props сверху
  • Компонент как именованный экспорт
  • Стили внизу
@component-template.tsx
Это правило автоматизирует анализ приложения:Когда просят проанализировать приложение:
  1. Запусти dev‑сервер командой npm run dev
  2. Собери логи из консоли
  3. Предложи оптимизации производительности
Это правило помогает генерировать документацию:Помоги подготовить документацию, выполняя:
  • Извлечение комментариев из кода
  • Анализ README.md
  • Генерацию документации в Markdown
Сначала создай свойство для переключателя в @reactiveStorageTypes.ts.Добавь значение по умолчанию в INIT_APPLICATION_USER_PERSISTENT_STORAGE в @reactiveStorageService.tsx.Для бета‑фич добавь переключатель в @settingsBetaTab.tsx, иначе — в @settingsGeneralTab.tsx. Переключатели можно добавлять как <SettingsSubSection> для обычных чекбоксов. Посмотри остальные части файла для примеров.
<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>
Чтобы использовать в приложении, импортируй reactiveStorageService и обращайся к свойству:
const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty
Много примеров доступно от поставщиков и фреймворков. Правила, созданные сообществом, можно найти в краудсорсинговых подборках и репозиториях онлайн.

​
AGENTS.md

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

## Стиль кода
- Используй TypeScript для всех новых файлов
- Предпочитай функциональные компоненты в React
- Используй snake_case для столбцов в базе данных

## Архитектура
- Следуй паттерну репозитория
- Размещай бизнес-логику в сервисных слоях

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

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

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

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

​
FAQ

Проверь тип правила. Для Agent Requested убедись, что задано описание. Для Auto Attached убедись, что шаблон файла соответствует используемым файлам.
Да. Используй @filename.ts, чтобы добавить файлы в контекст правила.
Да, сгенерируй правила проекта из чата командой /Generate Cursor Rules. Если Memories включены, они создаются автоматически.
Нет. Правила применяются только к Agent и Inline Edit.