Cursor rule

1---
2description: A meta-rule for using Cursor to update *.mdc file in this repository.
3globs: *.mdc
4---
5# Cursor Rules
6 
7This document outlines the meta-rules for cursor operations in this repository.
8 
9## Line Ending & Formatting Rules
10 
111. **Line Endings**
12   - Don't modify existing line endings
13   - Preserve CRLF/LF as found in the original file
14 
152. **Whitespace**
16   - Preserve trailing whitespace where it exists
17   - Maintain existing indentation style (spaces vs tabs)
18   - Keep line length consistent with existing code
19 
20## File Handling
21 
221. **MDC Files**
23   - Always commit changes to `*.mdc` files directly
24   - Ensure changes to `*.mdc` files are synchronized with their implementation
25   - Maintain consistent formatting within MDC files
26   - Prefer modifying existing files over creating new ones unless explicitly requested
27   - When adding new content, first check if it fits within an existing rule file
28 
29 
302. **File Creation**
31 
32   - Only create new rule files when:
33     - Explicitly requested by the user
34     - The content doesn't logically fit in any existing rule file
35     - Creating a new file would significantly improve organization and clarity
36   - Document the rationale for creating new files in their README.md
37 
38## Code Style & Structure
39 
401. **Formatting**
41   - Preserve existing code formatting patterns
42   - Maintain consistent naming conventions
43   - Keep indentation consistent with file style
44 
452. **Organization**
46   - Keep file structure consistent
47   - Don't move files without updating all references
48   - Maintain existing import/include order
49 
50## Rule Content
51 
521. **Examples**
53    - Always include "do" and "don't" examples when showing specific changes to files or syntax
54    - Include helpful comments that explain why an example is a "do" or a "don't"
55 
56## Documentation
57 
581. **README.md**
59    - Each `*.mdc` file is lumped into a folder with a `README.md` file explaining what the rule does and when it's used.