De vier soorten rules
Cursor kent vier soorten rules, en ze lijken op elkaar tot je ziet wie ze beheert:
| Soort | Waar | Voor wie |
|---|---|---|
| Project Rules | .cursor/rules/ in de repository, als .mdc |
Iedereen die in die repository werkt |
| User Rules | Customize > Rules | Alleen jij, in al je projecten, alleen voor Agent (Chat) |
| Team Rules | Het Cursor-dashboard, beheerd door team-admins | Het hele team, op een Team- of Enterprise-plan |
| AGENTS.md | De root van je project of een submap | Iedereen, en ook andere AI-tools |
Deze pagina gaat over Project Rules, want die stel je zelf in. Team Rules staan op Hoe deel je context en regels met je hele team in Cursor.
Een rule aanmaken
- Typ
/create-rulein de Agent en beschrijf wat de rule moet doen. Of open Customize in de zijbalk, ga naar Rules en klik op Add Rule. - Controleer dat het bestand in
.cursor/rules/staat en eindigt op.mdc. Submappen mogen, bijvoorbeeld.cursor/rules/frontend/. - Kies de toepassingswijze (hieronder). Die zet de velden bovenin het bestand.
- Commit het bestand. Zo heeft iedereen in de repository dezelfde rule.
Een rule, bijvoorbeeld .cursor/rules/api.mdc, ziet er ongeveer zo uit:
---
description: Conventies voor API-routes en foutafhandeling
globs: src/api/**/*.ts
alwaysApply: false
---
Gebruik altijd de foutklasse uit src/lib/errors.ts.
Geef een 4xx terug met een leesbare melding, nooit een stacktrace.
De vier toepassingswijzen
| Wijze | Velden | Wanneer de agent hem gebruikt | Gebruik hem voor |
|---|---|---|---|
| Always Apply | alwaysApply: true |
In elk gesprek | Een paar harde afspraken: taal, stijl, wat nooit mag |
| Apply Intelligently | alwaysApply: false, een description, geen globs |
Als de agent hem relevant vindt op basis van de description | Kennis die soms nodig is, zoals hoe je een migratie schrijft |
| Apply to Specific Files | alwaysApply: false met globs |
Als een bestand overeenkomt met de globs | Regels per deel van de code: tests, API, styling |
| Apply Manually | alwaysApply: false, geen globs, geen description |
Alleen als je hem noemt met @, bijvoorbeeld @api |
Werkwijzen die je af en toe bewust aanroept |
De velden achter die keuze zijn description, globs en alwaysApply. Bij Apply Intelligently is de description alles: de agent ziet alleen die zin om te beslissen. Schrijf dus wanneer de rule geldt, niet wat erin staat. Rules sturen de Agent (Chat); op Tab-aanvullingen hebben ze geen invloed.
Het misverstand: .md of .mdc
Veel uitleg op internet zegt dat je gewone markdown in .cursor/rules kunt zetten. Volgens de documentatie van Cursor klopt dat niet: project rules moeten de extensie .mdc hebben, en een gewoon .md-bestand in .cursor/rules wordt door het rules-systeem genegeerd. Wil je gewone markdown zonder velden, gebruik dan AGENTS.md in de root of in een submap. Geneste AGENTS.md-bestanden worden met de bovenliggende gecombineerd en de specifiekere wint.
Een tweede valkuil: alles op Always Apply zetten. Elke rule die altijd geldt, neemt in elk gesprek ruimte in. Cursor raadt aan rules onder de 500 regels te houden en grote rules op te splitsen. Houd Always Apply voor de paar dingen die echt altijd gelden en laat de rest door globs of een goede description kiezen.
Wanneer een skill beter is
Een rule die alleen soms nodig is en een hele werkwijze beschrijft, met stappen of scripts, past vaak beter als skill: een map met SKILL.md die de agent laadt als hij hem nodig heeft. Met /migrate-to-skills zet Cursor dynamische rules (zonder alwaysApply en zonder globs) om naar skills. Rules met alwaysApply of globs, en user rules, blijven rules.
Wat dit voor een team betekent
Gecommitte Project Rules en AGENTS.md reizen met de repository mee: wie hem kloont, heeft ze. User rules blijven op je eigen account, en een correctie in een los gesprek wordt niet vanzelf een regel. Zet daarom een correctie die je twee keer geeft meteen in een rule en commit hem. Gebruikt een deel van het team een andere tool, lees dan Cursor rules of AGENTS.md.
Waar Bombos past
Rules zijn instructies die je zelf schrijft en bijhoudt. Cursor-projectregels in .mdc zijn toolspecifiek; AGENTS.md kan ook door andere coding-agents worden gelezen. Bombos is een plugin die elke AI-tool van je team, ook Cursor, één gedeeld geheugen geeft: teamkennis, regels die het uit correcties leert en wat er al ligt in mail, documenten en repo’s, navolgbaar en in de cloud of op je eigen server. Eén ontwikkelaar kan het eerst zelf proberen naast zijn eigen rules.
Vragen die hierbij horen
Waarom doet mijn rule niets?
Controleer eerst de extensie: Cursor negeert een gewoon .md-bestand in .cursor/rules, project rules moeten .mdc zijn. Daarna de toepassingswijze: een passende description bij Apply Intelligently en passende globs bij Apply to Specific Files.
Hoe lang mag een rule zijn?
Cursor raadt aan elke rule onder de 500 regels te houden en een grote rule op te splitsen in kleinere rules die je kunt combineren.
Wat is het verschil tussen een project rule en een user rule?
Een project rule staat in de repository en geldt voor iedereen die erin werkt. Een user rule zet je in Customize > Rules, geldt in al je projecten en alleen voor de Agent (Chat).
Zijn rules hetzelfde als skills?
Nee. Een rule is een instructie die in de context komt; een skill is een map met SKILL.md en eventueel scripts die de agent laadt als hij hem nodig heeft. Dynamische rules kun je met /migrate-to-skills omzetten.
