Skip to content
cursor-rules logo

Cursor Rules Location

cursor-rules

How to add or edit Cursor rules in our project

SKILL.md

Full skill instructions

Cursor Rules Location

How to add new cursor rules to the project

  1. Always place rule files in PROJECT_ROOT/​.cursor/​rules/:

    .cursor/​rules/
    ├── your-rule-name.mdc
    ├── another-rule.mdc
    └── ...
    
  2. Follow the naming convention:

    • Use kebab-case for filenames
    • Always use .mdc extension
    • Make names descriptive of the rule's purpose
  3. Directory structure:

    PROJECT_ROOT/
    ├── .cursor/
    │   └── rules/
    │       ├── your-rule-name.mdc
    │       └── ...
    └── ...
    
  4. Never place rule files:

    • In the project root
    • In subdirectories outside .cursor/​rules
    • In any other location
  5. Cursor rules have the following structure:

---
description: Short description of the rule's purpose
globs: optional/​path/​pattern/​**/​* 
alwaysApply: false
---
# Rule Title

Main content explaining the rule with markdown formatting.

1. Step-by-step instructions
2. Code examples
3. Guidelines

Example:
```typescript
// Good example
function goodExample() {
  // Implementation following guidelines
}

// Bad example
function badExample() {
  // Implementation not following guidelines
}
```