Cursor Rules: как настроить правила проекта и файл AGENTS.md

Быстрый ответ:

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

Где хранятся правила Cursor

Проектные правила располагаются в папке .cursor/rules и могут быть версионированы с репозиторием. Для них используется формат .mdc, позволяющий задавать область действия. Дополнительно поддерживаются пользовательские и командные правила. Файл AGENTS.md — простой Markdown-вариант инструкций, который может применяться агентом без особых настроек проекта.

Как написать первое правило

  1. Создайте в корне проекта папку .cursor/rules.
  2. Добавьте правило для языка и тестов, например testing.mdc.
  3. Запишите короткие обязательные требования: фреймворк, стиль и проверку.
  4. Настройте область действия на нужные файлы, если правило специализировано.
  5. Попросите агента объяснить, какие правила относятся к текущей задаче.
  6. Проверьте, соблюдаются ли они при небольшой тестовой правке.

Пример полезного требования: «При изменении функции обработки оплаты сохраняй публичные типы. Добавляй тест на отказ сети. Не изменяй схему БД без отдельного подтверждения». Это яснее размытых просьб писать «идеальный код». Правило можно проверить по diff и тестам.

Когда использовать AGENTS.md

Если нужны простые общие инструкции для проекта, подойдет файл в корне репозитория. Например: «Для установки зависимостей используем pnpm», «Публичные методы документируем», «Миграции выполняются человеком». Для разных зон крупного репозитория полезнее целевые правила, чтобы требования фронтенда не попадали к серверным задачам.

Как избежать конфликтов правил

Конфликт возникает, когда одно правило требует форматирование Prettier, а другое запрещает менять формат файла; либо глобальная настройка допускает установку пакетов, а проектное правило запрещает. Найдите такие противоречия и определите, какая инструкция приоритетна для команды. Не полагайтесь на то, что модель сама правильно выберет из двух несовместимых утверждений.

Правило Хорошая формулировка
Тесты Запускать тесты затронутого модуля
Зависимости Не добавлять пакеты без согласования
Стиль Использовать существующий линтер
База Не запускать миграции автоматически
Секреты Не читать и не выводить токены

Как проверить, что правило действительно работает

Сначала выберите задачу, которая однозначно затрагивает правило. Попросите агента добавить небольшую функцию и тест. Сверьте результат с требованиями: правильный менеджер пакетов, стиль импортов, отсутствие ненужных зависимостей. Если правило игнорируется, убедитесь, что файл лежит в нужной папке и его область действия совпадает с изменяемыми путями.

Что нельзя превращать в Rules

Не записывайте туда действующие API-ключи, пароли, персональные данные и конфиденциальные инструкции, не предназначенные для передачи выбранной модели. Правило про безопасность должно устанавливать запрет на раскрытие секретов, а не содержать их. Также не стоит включать туда многостраничную документацию: лучше указывать путь к нужному файлу.

Как обновлять правила в команде

Храните проектные правила в Git и принимайте изменения через code review. Назначьте владельца, который удаляет устаревшие требования после изменений архитектуры. Если агент повторяет неправильный паттерн, исправьте правило и подготовьте минимальный тест, подтверждающий новое поведение.

Связь с промптами и Agent

Разовые требования, критерии приёмки и конкретные файлы остаются в запросе. Повторяемые требования — в Rules. Примеры запросов собраны в подборке промптов Cursor, а безопасное выполнение многофайловых изменений — в инструкции Cursor Agent.

Полный пример правила Cursor .mdc

Создайте файл .cursor/rules/typescript-tests.mdc. Frontmatter задаёт область действия, а тело файла — конкретные требования к Agent. Это пример для файлов TypeScript; перед применением проверьте маску для своего проекта.

---
description: Тесты и стиль TypeScript
globs: "**/*.ts"
alwaysApply: false
---
- Используй существующий менеджер пакетов.
- Не устанавливай новые зависимости без подтверждения.
- Добавляй тест для изменённой функции.
- Не изменяй схему БД.
- Показывай diff и результат тестов.

Для создания через интерфейс откройте палитру команд, выберите New Cursor Rule, задайте имя и режим применения. Затем выполните короткую задачу в подходящем файле и проверьте соблюдение правил. Если правило не применяется, проверьте тип правила и шаблон globs.

Простой пример AGENTS.md

Когда правила применяются ко всему проекту, используйте обычный Markdown-файл AGENTS.md в корне репозитория:

# Project instructions
- Use pnpm for dependencies.
- Run tests for changed modules.
- Never commit credentials or passwords.
- Ask for approval before database migrations.

Файл не требует frontmatter. Правила влияют на Agent, но не изменяют работу Cursor Tab. Настройки автодополнения разобраны в отдельной статье про Tab.

Что делать, если правила не подхватываются?

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

🙂+
👁 10
👍 ❤️ 🔥 🤔 😂 😱 😢 👏 😡
Не нашли ответ?
Спросите автора или предложите отдельную тему — разберём подробнее.
История обновлений
15 ноября 2026 — статья опубликована.

Оставьте комментарий