Getting Clear About Cursor Rules

The docs are not very clear and do not provide examples / explanations of all possible permutations.

Possible inputs:

description?: string
globs?: string[]
alwaysApply: bool

If alwaysApply is true, then the other two values are irrelevant.

If alwaysApply is false, then I get confusing signals from the IDE:

  • if description is set I always get “Apply Intelligently” even if globs are set.
  • if description is null, and globs are set I get “Apply to Specific Files”
  • if descrption is null and globs are null I get “Apply Manually”

Creating a rule via the IDE settings provides no “Apply Intelligently” option… if I choose “specific files” no description gets written to the rule.

If I add a description, the IDE reports “Apply Intelligently”… thus making me think my globs are now being ignored and the AI will decide whether to apply.

My bottomline question:

If alwaysApply is false, does the presence of a “Description” override the presence of any globs?

Nevermind… the issues was that the agent was creating globs like this:
globs:

  • one
  • two

Which is not recognized / accepted. If I define globs like
globs: one, two

Then “description” and “globs” play nice together.