Path Scope Declared
Cursor path-scoped rules must declare a globs frontmatter key. Rules without globs and without alwaysApply: true are manual-only (loaded via @-mention, not automatically).
Antipatterns
- Using
pathsinstead ofglobs. Cursor readsfrontmatter.globsfor scoping — usingpaths(Claude Code's key) has no effect and the rule becomes manual-only. - Missing
globsandalwaysApply. A rule file with neitherglobsnoralwaysApply: trueis only loaded when explicitly mentioned via@. It never fires automatically. - Frontmatter without scope key. Adding metadata like
description: "Testing rules"but omitting bothglobsandalwaysApply. Cursor ignores unrecognized frontmatter keys.
Pass / Fail
Pass
---
globs: ["src/**/*.py"]
---
# Testing Design
Tests exist to catch bugs, not to confirm the implementation works.
Fail
---
description: Rules for testing files
---
# Testing Design
Tests exist to catch bugs, not to confirm the implementation works.
Limitations
Does not check for alwaysApply interaction — a rule with both globs and alwaysApply: true may behave unexpectedly. Cannot detect overly broad globs like **/* that effectively disable scoping.
