cursor-rules

Cursor rules files (.mdc) combine YAML frontmatter with markdown content in the .cursor/rules directory. Include frontmatter fields like description, globs for file matching, and alwaysApply to control when rules attach to your project, then write actionable instructions below.

Cursor supports four rule types: Always (applies universally), Auto Attached (triggers based on glob patterns), Agent Requested (invoked by the user), and Manual (attached explicitly). Choose based on whether rules should auto-trigger, require user action, or apply globally to your codebase.

Write concise, actionable instructions in markdown after the frontmatter. Focus on specific standards and practices you want the AI to follow. Clear, direct language maximizes comprehension and ensures the AI applies your project's conventions consistently.

Yes. Define glob patterns in the frontmatter's globs field to automatically attach rules to matching files. This enables Auto Attached rule types that apply your standards only to relevant file types and directories without manual intervention.

The frontmatter description should concisely explain the rule's purpose and which project standards or AI behaviors it enforces. This helps you and your team quickly identify what each rule does when browsing the .cursor/rules directory.

Rules can be automatic or manual depending on type. Set alwaysApply to true or use Auto Attached with glob patterns for automatic triggering. Manual or Agent Requested rules require explicit user action, giving you fine-grained control over when rules activate.