.cursorrules или .cursor/rules: куда писать инструкции

В Cursor теперь два места для инструкций, и это путает. Старый файл .cursorrules лежит в корне и работает везде. Новая папка .cursor/rules поддерживает несколько файлов и условия, при которых каждый включается. В 2026 году новая папка это основной путь, .cursorrules остался для совместимости. Куда что класть, разобрано ниже.

Чем они отличаются

Когда хватает .cursorrules

Для небольшого проекта с одним стеком и общим стилем кода. Кладёте в корень файл с базовыми правилами, и Cursor тянет его всегда:

# .cursorrules
Пиши на TypeScript, строгая типизация.
Комментарии только к нетривиальной логике.
Тесты на Vitest, покрываем публичные функции.
Не добавляй новые зависимости без явной просьбы.

Этого хватает, пока проект один и стек не меняется.

Когда переходить на .cursor/rules

Когда в проекте несколько зон с разными правилами. Например, фронт на React, бэк на FastAPI, скрипты на Bash. В папке .cursor/rules кладёте несколько файлов, и каждый включается по условию:

# .cursor/rules/frontend.mdc
---
description: Правила для фронтенда
globs: src/**/*.tsx, src/**/*.ts
alwaysApply: false
---
Компоненты на функциях, хуки с префиксом use.
Стили через Tailwind, без styled-components.

Файл сработает, только когда агент правит код в src. Бэкенд и скрипты его не увидят. Это экономит контекст и снижает галлюцинации: агент не тащит фронтовые правила в Python.

Рабочий совет

Начните с одного .cursorrules. Когда почувствуете, что правила конфликтуют или агент путает зоны, разбейте их в .cursor/rules по условию. Не плодите файлы заранее, каждое лишнее правило это токены в каждом запросе.

Частые вопросы