Elk AI-coderingstool wil een Markdown-bestand met de regels van je project. Maar ze willen allemaal een ander Markdown-bestand.

Als je meerdere AI-tools gebruikt (en de meeste ontwikkelaars doen dat), wordt dit snel verwarrend. Hier is de definitieve gids voor welke bestanden je nodig hebt en wat er in elk staat.

De Bestanden in Één Oogopslag

Bestand	Tool	Locatie	Bereik
`AGENTS.md`	Universeel (alle tools)	Projectroot	Gedeelde regels voor alle AI-agents
`CLAUDE.md`	Claude Code	Projectroot	Claude-specifieke instructies
`.cursor/rules/*.md`	Cursor	`.cursor/rules/`-map	Cursor-specifieke regels
`.github/copilot-instructions.md`	GitHub Copilot	`.github/`-map	Copilot-specifieke instructies
`.windsurf/rules`	Windsurf	`.windsurf/`-map	Windsurf-specifieke regels
`JULES.md`	Google Jules	Projectroot	Jules-specifieke instructies

AGENTS.md: De Universele Standaard

Het beste voor: Teams die meerdere AI-tools gebruiken, open-source projecten

AGENTS.md is het dichtst bij een universele standaard dat we hebben. Het wordt nu gebruikt door meer dan 60.000 repositories en wordt beheerd door de Linux Foundation’s Agentic AI Foundation (samen met MCP en goose).

Zet hier je gedeelde instructies --- dingen die elk AI-tool moet weten:

Projectstructuur en architectuur
Build- en testcommando’s
Codestijlconventies
Veelvoorkomende patronen en anti-patronen
Afhankelijkheden en instalatiestappen

Elk groot AI-coderingstool leest AGENTS.md, wat het de enige bron van waarheid maakt voor de AI-instructies van je project.

CLAUDE.md: Claude Code’s Geheugen

Het beste voor: Claude Code-gebruikers, teams die standaardiseren op Anthropic

CLAUDE.md wordt automatisch gelezen aan het begin van elke Claude Code-sessie. Het ondersteunt enkele Claude-specifieke functies zoals geheugenopslag en sessiecontext.

Gebruik CLAUDE.md voor:

Claude-specifieke gedragsaanpassingen
Functies die alleen Claude Code ondersteunt
AGENTS.md overschrijven of uitbreiden voor Claude

Het aanbevolen patroon: gedeelde regels in AGENTS.md, Claude-specifieke toevoegingen in CLAUDE.md.

.cursorrules / .cursor/rules/: Cursor’s Aanpak

Het beste voor: Cursor-gebruikers, teams die Cursor als primaire IDE gebruiken

Cursor gebruikte oorspronkelijk een enkel .cursorrules-bestand, maar evolueerde naar een .cursor/rules/-map voor meer gedetailleerde controle. Elk bestand in de map is een aparte regel die Cursor toepast.

Gebruik Cursor-regels voor:

Cursor-specifiek agentgedrag
Regels voor de Composer- en Agent-modus van Cursor
Bestandstypespecifieke instructies (bijv. verschillende regels voor .tsx vs .py)

copilot-instructions.md: GitHub’s Conventie

Het beste voor: GitHub Copilot-gebruikers, GitHub-gerichte workflows

GitHub Copilot leest .github/copilot-instructions.md voor instructies op projectniveau. Het volgt GitHub’s conventie van configuratie opslaan in de .github/-map.

De Aanbevolen Instelling

Voor de meeste projecten heb je maximaal twee bestanden nodig:

Als je één AI-tool gebruikt:

Gebruik gewoon het native bestand van die tool (CLAUDE.md voor Claude Code, .cursor/rules/ voor Cursor, etc.).

Als je meerdere AI-tools gebruikt:

AGENTS.md --- alle gedeelde regels (architectuur, build-commando’s, conventies)
Tool-specifiek bestand --- alleen voor functies uniek aan die tool

Voorbeeldstructuur:

jouw-project/
  AGENTS.md              # Gedeeld: build-commando's, architectuur, conventies
  CLAUDE.md              # Claude-specifiek: geheugenvoorkeuren, toolgebruik
  .cursor/rules/style.md # Cursor-specifiek: composer-gedrag
  .github/copilot-instructions.md  # Copilot-specifiek

Wat op te Nemen in je Regels

Op basis van analyse van duizenden repositories bevatten de meest effectieve instructiebestanden:

Altijd opnemen:

Hoe het project te bouwen en uitvoeren
Hoe tests uit te voeren
Architecturale kernbeslissingen
Codeerstijlvoorkeuren

Vaak nuttig:

Wat NIET te doen (negatieve instructies werken verrassend goed)
Bestandsstructuurverklaringen
Veelvoorkomende debugstappen
Afhankelijkheidsbeheercommando’s

Overslaan:

Vanzelfsprekende taalfuncties
Dingen die de AI al weet
Te gedetailleerde regels (start minimaal, voeg toe indien nodig)

Je AI-regels Bouwen met Webcontext

Het schrijven van goede AI-instructiebestanden vereist vaak het verwijzen naar externe documentatie, stijlgidsen of architectuurpatronen. Dit is waar het hebben van webinhoud in Markdown-formaat helpt.

Als je project bijvoorbeeld een specifiek API-patroon volgt van een documentatiepagina, kun je:

Save gebruiken om die documentatiepagina naar Markdown te converteren
De relevante secties refereren of citeren in je AGENTS.md
Je AI-codeerassistent heeft nu de volledige context

Hetzelfde geldt voor frameworkdocumentatie, stijlgidsen, best practices-artikelen en Stack Overflow-oplossingen. Schone Markdown is het formaat waarmee zowel jij als je AI-tools het meest effectief kunt werken.

De Conclusie

Het ecosysteem van AI-coderingsregels is nog in ontwikkeling, maar het patroon is duidelijk: het is allemaal Markdown. Of je nu één tool of vijf gebruikt, de AI-instructies van je project leven in Markdown-bestanden die versie-gecontroleerd, door mensen leesbaar en machineparseerbaar zijn.

Begin met AGENTS.md voor universele regels, voeg tool-specifieke bestanden toe indien nodig, en houd alles minimaal totdat je een terugkerend probleem ziet dat de moeite waard is om op te lossen.

Save converteert elke webpagina naar schone Markdown --- perfect voor het bouwen van het referentiemateriaal en de documentatiecontext die je AI-codeerassistenten nodig hebben. Probeer Save gratis.