Cursor Project Rules (.cursor/rules/*.mdc): waar het staat en hoe tools het lezen

Cursor Project Rules zijn .mdc-bestanden in .cursor/rules/ waarvan de frontmatter bepaalt wanneer elke regel wordt toegevoegd. Cursor leest ook AGENTS.md, plus User Rules en Team Rules die buiten de repository zijn ingesteld.

Locatie

• .cursor/rules/**/*.mdc; submappen zijn toegestaan. Gewone .md-bestanden in .cursor/rules worden genegeerd.
• AGENTS.md in de hoofdmap en in geneste mappen.
• User Rules, ingesteld in de Cursor-instellingen.
• Team Rules, ingesteld in het teamdashboard.

Indeling

Markdown met YAML-frontmatter; de extensie .mdc is verplicht. Met alwaysApply: true wordt de regel altijd opgenomen. Globs met alwaysApply: false voegen de regel toe wanneer een overeenkomend bestand in de context staat. Met alleen een description beslist de Agent zelf. Zonder deze instellingen geldt de regel alleen wanneer je ernaar verwijst met @.

Frontmatter-sleutels: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Prioriteit en samenvoegen

Eerst Team Rules, dan Project Rules en daarna User Rules. Alle toepasselijke regels worden samengevoegd; bij conflicten krijgt de eerdere bron voorrang. Enforced Team Rules kunnen niet worden uitgeschakeld. Geneste AGENTS.md-bestanden worden gecombineerd met die van hun bovenliggende mappen; het meest specifieke bestand krijgt voorrang.

Tools die het bestand lezen

Tips

• Scheid meerdere globs met komma's in het veld globs.
• Houd elke regel onder de 500 regels en verwijs naar bestanden met @filename in plaats van ze te kopiëren.
• Regels zijn niet van toepassing op Cursor Tab en User Rules zijn niet van toepassing op Inline Edit.
• Het verouderde bestand .cursorrules wordt niet meer genoemd in de documentatie van Cursor; verplaats het naar .cursor/rules/.

Andere instructiebestanden