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
- 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.
- 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. - Skills in
.claude/skills/: werkwijzen met stappen of scripts die je in beide tools wilt hebben. Cursor laadt deze map ook. .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.- CLAUDE.md: één regel
@AGENTS.mdbovenaan en daaronder zo weinig mogelijk. Let op: Cursor leestCLAUDE.mdin 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:
- Zoek de rules met
alwaysApply: true. Die gelden toch altijd en kunnen meestal zo naar AGENTS.md. - Rules met globs die één map betreffen, passen vaak in een AGENTS.md in die map.
- Rules die de agent zelf kiest op basis van de description (zonder globs en zonder alwaysApply) kun je met
/migrate-to-skillsomzetten naar skills. Verplaats die daarna naar.claude/skills/als Claude Code ze ook moet zien. - 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.
