Cursor rules of AGENTS.md: wat zet je waar als je ook andere AI-tools gebruikt?

Kort antwoord

AGENTS.md is gewone markdown die Cursor leest, en Claude Code via een import in CLAUDE.md of rechtstreeks in recente versies; .cursor/rules/*.mdc leest alleen Cursor. Gebruik je meerdere AI-tools, zet dan de gedeelde afspraken in AGENTS.md en gebruik Cursor rules alleen waar je hun extra's nodig hebt: globs per bestandstype, een rule die de agent zelf kiest, of een rule die je met @ aanroept.

Wat elke tool leest

Het verschil zit niet in wat je kunt schrijven, maar in wie het leest:

Bestand Cursor Claude Code
AGENTS.md (root en submappen) Ja Via @AGENTS.md in CLAUDE.md; rechtstreeks vanaf v2.1.277 als er geen CLAUDE.md of CLAUDE.local.md is
.cursor/rules/*.mdc Ja Nee
CLAUDE.md in de projectroot Ja Ja
.claude/rules/ Niet gedocumenteerd Ja
Skills in .claude/skills/ Ja, voor compatibiliteit Ja
Skills in .cursor/skills/ Ja Nee

AGENTS.md is gewone markdown zonder velden bovenin. Cursor rules zijn .mdc-bestanden met description, globs en alwaysApply. Die velden zijn precies wat AGENTS.md mist: een rule kan alleen gelden voor bepaalde bestanden, kan door de agent gekozen worden als hij relevant is, of kan alleen meekomen als je hem met @ noemt. AGENTS.md geldt altijd voor de map waar hij staat.

De verdeling die werkt

  1. AGENTS.md in de root: alles wat elke AI-tool en elke nieuwe collega moet weten. Hoe je bouwt en test, de structuur van de repository, naamgeving, wat nooit mag.
  2. AGENTS.md in een submap: afspraken die alleen voor dat deel gelden, bijvoorbeeld frontend/AGENTS.md. Cursor combineert hem met de root; de specifiekere instructie wint.
  3. Skills in .claude/skills/: werkwijzen met stappen of scripts die je in beide tools wilt hebben. Cursor laadt deze map ook.
  4. .cursor/rules/*.mdc: alleen wat de extra’s van Cursor nodig heeft. Een rule met globs voor testbestanden, een rule die je met @ aanroept voor een zeldzame klus.
  5. CLAUDE.md: één regel @AGENTS.md bovenaan en daaronder zo weinig mogelijk. Let op: Cursor leest CLAUDE.md in de projectroot ook, dus wat daar staat, geldt in Cursor net zo goed. Instructies die echt alleen voor Claude Code zijn, passen beter in .claude/rules/.

Zo staat elke afspraak op één plek. Als je hem wijzigt, wijzigt hij voor iedereen.

Overstappen van rules naar AGENTS.md

Heb je al veel Cursor rules en komt er een tweede tool bij:

  1. Zoek de rules met alwaysApply: true. Die gelden toch altijd en kunnen meestal zo naar AGENTS.md.
  2. Rules met globs die één map betreffen, passen vaak in een AGENTS.md in die map.
  3. Rules die de agent zelf kiest op basis van de description (zonder globs en zonder alwaysApply) kun je met /migrate-to-skills omzetten naar skills. Verplaats die daarna naar .claude/skills/ als Claude Code ze ook moet zien.
  4. Laat in .cursor/rules/ alleen staan wat echt Cursor-specifiek is.

Het misverstand: Cursor rules zijn de standaard

Wie met Cursor begon, ziet .cursor/rules als de plek voor alle afspraken. Maar het is een formaat van één tool. Komt er later Claude Code, Codex of een eigen agent bij, dan lezen die je rules niet, en je team gaat dezelfde afspraken op twee plekken bijhouden. Dubbel bijgehouden afspraken kunnen uiteenlopen. AGENTS.md is bedoeld om in een repository te staan die met verschillende coding-agents werkt; Claude Code noemt het expliciet zo.

Een tweede misverstand: dat je gewone markdown in .cursor/rules kunt zetten om het voor andere tools leesbaar te houden. Cursor negeert een .md-bestand in die map. Daar is AGENTS.md voor.

Wat dit voor een team betekent

Hoe meer tools een team gebruikt, hoe meer de verdeling ertoe doet. Wat in een toolspecifiek bestand staat, helpt alleen de collega die dezelfde tool gebruikt. Voor de vergelijking tussen de twee tools zelf: Cursor of Claude Code. Voor de regels die je in Cursor voor het hele team afdwingt: Hoe deel je context en regels met je hele team in Cursor.

Waar Bombos past

AGENTS.md lost het delen op voor wat in de repository staat en wat je zelf opschrijft. Bombos is een plugin die verder gaat: elke AI-tool van je team, van Cursor en Claude Code tot ChatGPT, Copilot en eigen agents, krijgt één gedeeld geheugen met teamkennis, regels die het leert uit correcties en wat er al ligt in mail en documenten, navolgbaar, in de cloud of op je eigen server. Eén ontwikkelaar kan het eerst zelf proberen.

Vragen die hierbij horen

Leest Claude Code AGENTS.md als er ook een CLAUDE.md is?

Standaard niet: rechtstreeks lezen kan vanaf Claude Code v2.1.277 met passende instellingen, en een CLAUDE.md of CLAUDE.local.md blokkeert die standaardroute. Zet daarom @AGENTS.md bovenaan je CLAUDE.md, dan komt AGENTS.md altijd mee.

Kan ik een AGENTS.md per submap maken?

Ja. Cursor ondersteunt AGENTS.md in de root en in submappen; geneste bestanden worden met de bovenliggende gecombineerd en de specifiekere instructie wint. Claude Code leest de AGENTS.md van een submap als het daar een bestand opent.

Kan ik een gewone .md in .cursor/rules zetten zodat andere tools hem ook lezen?

Nee. Cursor negeert een gewoon .md-bestand in .cursor/rules; project rules moeten .mdc zijn. Gebruik voor gedeelde markdown AGENTS.md.

Bronnen

  1. Cursor docs: Rules
  2. Claude Code docs: How Claude remembers your project
  3. 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.