Cursor Project Rules (.cursor/rules/*.mdc): расположение и чтение инструментами

Project Rules в Cursor — это файлы .mdc в .cursor/rules/, frontmatter которых определяет, когда добавляется каждое правило. Cursor также читает AGENTS.md, а ещё User Rules и Team Rules, заданные за пределами репозитория.

Расположение

• .cursor/rules/**/*.mdc; вложенные каталоги разрешены. Обычные файлы .md в .cursor/rules игнорируются.
• AGENTS.md в корневом и вложенных каталогах.
• User Rules, заданные в настройках Cursor.
• Team Rules, заданные на командной панели.

Формат

Markdown с YAML frontmatter; расширение .mdc обязательно. Значение alwaysApply: true добавляет правило всегда. Если задано globs и alwaysApply: false, правило добавляется, когда в контексте есть подходящий файл. При наличии только description решение принимает Agent. Если не задано ни одно из этих полей, правило применяется только при упоминании через @.

Ключи frontmatter: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Приоритет и объединение

Сначала Team Rules, затем Project Rules, затем User Rules. Все применимые правила объединяются; при конфликте приоритет у источника, указанного раньше. Отключить принудительно применяемые Team Rules нельзя. Вложенные файлы AGENTS.md объединяются с файлами из родительских каталогов; приоритет у более конкретного файла.

Инструменты, которые его читают

Советы

• Разделяйте несколько glob-шаблонов запятыми в поле globs.
• Ограничивайте каждое правило 500 строками и указывайте файлы через @filename, а не вставляйте их содержимое.
• Правила не влияют на Cursor Tab, а User Rules не применяются к Inline Edit.
• Устаревший файл .cursorrules больше не упоминается в документации Cursor; перенесите его в .cursor/rules/.

Другие файлы с инструкциями