Hoe stel je Cursor rules in (.cursor/rules) en wanneer gebruik je welk type?

Kort antwoord

Project rules zijn .mdc-bestanden in .cursor/rules, onder versiebeheer. Met de velden description, globs en alwaysApply kies je een van vier toepassingswijzen: Always Apply, Apply Intelligently, Apply to Specific Files of Apply Manually. Een gewoon .md-bestand in die map negeert Cursor; daarvoor is AGENTS.md.

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

  1. Typ /create-rule in de Agent en beschrijf wat de rule moet doen. Of open Customize in de zijbalk, ga naar Rules en klik op Add Rule.
  2. Controleer dat het bestand in .cursor/rules/ staat en eindigt op .mdc. Submappen mogen, bijvoorbeeld .cursor/rules/frontend/.
  3. Kies de toepassingswijze (hieronder). Die zet de velden bovenin het bestand.
  4. 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.

Bronnen

  1. Cursor docs: Rules
  2. Cursor docs: Agent Skills
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.