How .mdc Rules Work
What's in a .mdc File
Each .mdc file contains structured coding guidelines:
- Framework-specific best practices
- Naming conventions and patterns
- Common anti-patterns to avoid
- Import/export standards
- Testing conventions
- Performance recommendations
.mdc vs .cursorrules
| Feature | .cursorrules (legacy) | .mdc (current) |
|---|---|---|
| Format | Plain text | Structured markdown |
| Scoping | Project-wide only | Glob-scoped per file type |
| Metadata | None | Frontmatter with description |
| Organization | Single file | Multiple files in .cursor/rules/ |
| Future | Being deprecated | Recommended format |
Generation Pipeline
- Exa Semantic Search — Finds real-world best practices, official docs, community patterns
- LLM Processing — Structures findings into .mdc format (supports Gemini, OpenAI, Anthropic)
- Parallel Processing — Generates multiple libraries simultaneously
- Smart Retry — Failed generations auto-retry on next run
Custom Generation
Generate rules for any library:
uv run src/generate_mdc_files.py --library "next.js"
uv run src/generate_mdc_files.py --tag "python"
uv run src/generate_mdc_files.py --regenerate-allFAQ
Q: What is Awesome Cursor Rules MDC?
A: A collection of 800+ auto-generated .mdc rule files for Cursor AI, created using Exa search + LLM. Drop into .cursor/rules/ for instant framework-specific coding standards.
Q: Is it free? A: CC0 public domain — copy, modify, use for anything.
Q: How do I use a rule?
A: Copy the .mdc file to your project's .cursor/rules/ directory. Cursor auto-loads it.