Cursor Rules (.mdc) Frontmatter Validator
Проверить glob-паттерны и frontmatter в .cursor/rules/*.mdc, показать какие файлы подпадут под правило.
Как это работает
Правило Cursor в формате .mdc с опечаткой в glob-паттерне frontmatter не выдаёт ошибку и не падает — оно просто молча не применяется к нужным файлам, и узнаёшь об этом обычно только тогда, когда агент в очередной раз проигнорировал явно прописанную конвенцию проекта. Cursor Rules (.mdc) Frontmatter Validator online разбирает YAML frontmatter такого файла, проверяет корректность полей globs и alwaysApply, и показывает на тестовом списке путей, какие файлы реально попадут под правило, а какие нет.
Формат .mdc — это YAML-фронтматтер (описание, глобы, флаг alwaysApply) плюс markdown-тело с самими инструкциями, но специализированного линтера для этого формата на середину 2026 года не существует ни у самого Cursor, ни у сторонних инструментов — формат слишком новый и слишком нишевый, чтобы кто-то из крупных игроков успел его покрыть. Спрашивать нейросеть "почему моё правило не применяется" без реального доступа к вашей файловой системе — тоже так себе стратегия, потому что ответ зависит от точного алгоритма сопоставления glob-паттернов, который либо совпадает с путём, либо нет, без пространства для правдоподобных догадок.
Инструмент парсит frontmatter, проверяет синтаксическую корректность каждого glob-паттерна (незакрытые скобки, некорректные последовательности), и для введённого списка тестовых путей файлов явно показывает, какие из паттернов совпали, а какие нет — используя тот же принцип сопоставления, что и glob-синтаксис в большинстве современных инструментов: звёздочка для любого количества символов внутри сегмента пути, двойная звёздочка для рекурсивного совпадения по вложенным директориям.
Частые вопросы
Что произойдёт, если у mdc-файла нет frontmatter вообще?
Без явного frontmatter Cursor обычно применяет правило как always apply без ограничения по путям, что может быть и осознанным решением, и забытой настройкой — стоит явно решить, нужно ли ограничение по glob для конкретного правила, и прописать его явно, если да.
В чём разница между полем alwaysApply true и отсутствием globs?
alwaysApply true явно говорит применять правило ко всем файлам без исключения, вне зависимости от глобов, в то время как отсутствие globs при alwaysApply false или отсутствующем поле может привести к тому, что правило не применится нигде, это одна из самых частых причин молчаливого неприменения правила.
Поддерживает ли валидатор двойную звёздочку для рекурсивного совпадения?
Да, паттерны с двойной звёздочкой вроде src/**/*.ts корректно распознаются как рекурсивное совпадение по любой глубине вложенности директорий внутри src, а не только по прямым дочерним файлам.
Можно ли проверить сразу несколько mdc-файлов одновременно?
Текущая версия рассчитана на один файл frontmatter за операцию, для нескольких правил стоит проверять их по очереди, вставляя frontmatter каждого в поле ввода и сверяя результат с тем же списком тестовых путей.
Что если glob написан синтаксически корректно, но правило всё равно не применяется?
Стоит также проверить регистр символов в паттерне и реальных путях (некоторые файловые системы регистрозависимы), а также убедиться, что путь, который проверяется Cursor, относительный от корня репозитория, а не абсолютный — это ещё один частый источник несовпадения, который валидатор поможет исключить методом сравнения с вашими тестовыми путями.