Правило Cursor лежит в проекте, но не применяется к файлу

Команда записала правило: для API-обработчиков использовать общий валидатор. Агент меняет apps/api/src/routes/orders.ts и снова пишет ручную проверку полей. Правило лежит в .cursor/rules, но в текущем чате оно не было приложено к контексту. Нужно выяснить, должен ли этот файл вообще активировать данное правило.

Посмотрите тип правила, а не только текст

Текущие Project Rules Cursor — файлы .mdc с frontmatter. Если файл назван api-guidelines.md внутри .cursor/rules, система правил его игнорирует. Тип Apply to Specific Files работает, когда файл в контексте совпадает с globs. Тип Apply Intelligently выбирает агент по description; Apply Manually требует явного @-упоминания; Always Apply включается во всех чатах. Само существование файла правила не означает, что он должен действовать в каждой беседе.

Для маршрутов под apps/api/src/routes/ пример frontmatter: globs: apps/api/src/routes/**/*.ts и alwaysApply: false. Паттерн *.ts в текущей справке Cursor соответствует файлам верхнего уровня, а **/*.ts — вложенным каталогам. Если правило лежит в apps/api/.cursor/rules, область вложенного правила связана с этим каталогом. Откройте конкретный orders.ts или добавьте его в контекст чата и посмотрите список активных правил в боковой панели Agent.

Минимальный тест на применимость

На время теста добавьте в правило безвредное, хорошо заметное требование к ответу, например «в конце объяснения назвать файл проверки схемы». Откройте один подходящий маршрут и один файл вне паттерна, задайте агенту одинаковый вопрос без изменения кода. Для первого правило должно быть активно, для второго — нет. Не делайте вывод только по словам модели «я следую правилу»; проверьте индикатор активного правила в UI и итоговый ответ. После проверки удалите тестовую строку.

Если правило активно, но код всё равно неверный, причина уже в содержании: дайте конкретный путь к общему валидатору и пример применения вместо лозунга «используй лучшие практики». Если правило не активно, перепроверьте расширение, путь, frontmatter и glob. Для общей инструкции без связи с конкретными файлами выберите Always Apply осознанно: длинные глобальные правила занимают контекст каждой задачи. Проверить, что агент понял конкретное требование, помогут явные критерии готовности.

В платном курсе Vibecoding: Claude Code, Codex, Cursor и agentic development вы задаёте агенту контекст и ограничения проекта, затем проверяете его изменения. Настроенное .mdc правило превращает договорённость команды в повторяемый шаг работы Agent. Откройте программу курса, чтобы выстроить этот процесс для реального репозитория.

Продолжить на практике

  • Vibecoding: Claude Code, Codex, Cursor и agentic development ↗

    Практический курс по vibecoding и agentic development: Claude Code, Codex, Cursor и современные coding agents в реальной разработке. Вы научитесь запускать feature workflow через AI, работать с кодовой базой, ускорять debugging, tests и refactoring, делегировать агенту заметную часть разработки и при этом сохранять контроль над качеством, архитектурой и итоговым результатом.