Cursor rule

1---
2description: Cursor Rules Location
3globs: *.mdc
4---
5# Cursor Rules Location
6 
7Rules for placing and organizing Cursor rule files in the repository.
8 
9<rule>
10name: cursor_rules_location
11description: Standards for placing Cursor rule files in the correct directory
12filters:
13  # Match any .mdc files
14  - type: file_extension
15    pattern: "\\.mdc$"
16  # Match files that look like Cursor rules
17  - type: content
18    pattern: "(?s)<rule>.*?</rule>"
19  # Match file creation events
20  - type: event
21    pattern: "file_create"
22 
23actions:
24  - type: reject
25    conditions:
26      - pattern: "^(?!\\.\\/\\.cursor\\/rules\\/.*\\.mdc$)"
27        message: "Cursor rule files (.mdc) must be placed in the .cursor/rules directory"
28 
29  - type: suggest
30    message: |
31      When creating Cursor rules:
32 
33      1. Always place rule files in PROJECT_ROOT/.cursor/rules/:
34```
35         .cursor/rules/
36         ├── your-rule-name.mdc
37         ├── another-rule.mdc
38         └── ...
39```
40 
41      2. Follow the naming convention:
42         - Use kebab-case for filenames
43         - Always use .mdc extension
44         - Make names descriptive of the rule's purpose
45 
46      3. Directory structure:
47```
48         PROJECT_ROOT/
49         ├── .cursor/
50         │   └── rules/
51         │       ├── your-rule-name.mdc
52         │       └── ...
53         └── ...
54```
55 
56      4. Never place rule files:
57         - In the project root
58         - In subdirectories outside .cursor/rules
59         - In any other location
60 
61examples:
62  - input: |
63      # Bad: Rule file in wrong location
64      rules/my-rule.mdc
65      my-rule.mdc
66      .rules/my-rule.mdc
67 
68      # Good: Rule file in correct location
69      .cursor/rules/my-rule.mdc
70    output: "Correctly placed Cursor rule file"
71 
72metadata:
73  priority: high
74  version: 1.0
75</rule>