cursor-rules

Rules are how you bake context into a project so every Agent run starts with the right instructions. The SDK reads them through local.settingSources — see [[../cursor-sdk/references/local-options]].

When to use

Adding repo-level coding conventions an SDK agent should follow
Writing per-folder AGENTS.md for nested context
Migrating from .cursorrules to .cursor/rules/*.mdc
Choosing between always-on, auto-attached, agent-requested, and manual rules

File locations

[[references/file-locations]] — .cursor/rules/, AGENTS.md, legacy .cursorrules
[[references/scope-and-precedence]] — team / project / user, hierarchy