Als je recentelijk een AI-codeerassistent hebt gebruikt, heb je waarschijnlijk iets opgemerkt: ze willen allemaal een Markdown-bestand.

GitHub Copilot leest .github/copilot-instructions.md. Cursor leest .cursor/rules/. Claude Code leest CLAUDE.md. Windsurf leest .windsurf/rules. Google’s Jules leest JULES.md. En de universele standaard? AGENTS.md — nu gebruikt door meer dan 60.000 open-source repositories en beheerd door de Linux Foundation’s Agentic AI Foundation.

Markdown is gegaan van een documentatieformaat naar het besturingssysteem voor AI-codeeragenten.

Wat Is AGENTS.md?

AGENTS.md is een eenvoudig, open-formaat Markdown-bestand dat in je repository staat en dient als een briefingpakket voor AI-codeeragenten. Zie het als het equivalent van README.md:

README.md is voor mensen: snelstarts, projectbeschrijvingen, badges
AGENTS.md is voor AI-agents: bouwstappen, testcommando’s, codeervonsten, architectuurbeslissingen

De agent leest het dichtstbijzijnde bestand in de directorystructuur, dus het dichtstbijzijnde heeft voorrang. Elk subproject kan op maat gemaakte instructies meesturen.

Wat Is CLAUDE.md?

CLAUDE.md is specifiek voor Anthropic’s Claude Code. Het wordt automatisch gelezen aan het begin van elke sessie en bevat projectspecifieke instructies die je anders in elke prompt zou herhalen.

Een goede CLAUDE.md bevat doorgaans:

Projectcontext: Een korte zin die Claude oriënteert over wat het project doet
Codestijl: Je opmaakvoorkeuren, naamconventies, patronen om te volgen
Commando’s: Hoe je tests, build, lint en deploy uitvoert
Architectuurnotities: Belangrijke beslissingen die Claude moet respecteren

De aanbevolen aanpak: zet gedeelde instructies in AGENTS.md (zodat alle AI-tools er baat bij hebben), voeg dan Claude-specifieke functies toe aan CLAUDE.md.

Het Volledige Landschap van AI-instructiebestanden

Hier is elk groot AI-codeertool en zijn Markdown-conventie:

Tool	Bestand	Formaat
GitHub Copilot	`.github/copilot-instructions.md`	Markdown
Cursor	`.cursor/rules/*.md`	Markdown
Claude Code	`CLAUDE.md`	Markdown
Windsurf	`.windsurf/rules`	Markdown
Google Jules	`JULES.md`	Markdown
Universeel	`AGENTS.md`	Markdown

Zie je het patroon? Het is allemaal Markdown. Elk afzonderlijk.

Waarom Markdown Won

Markdown is het perfecte formaat voor AI-instructiebestanden omdat:

LLM’s begrijpen het van nature — het is het meest voorkomende formaat in hun trainingsdata
Het is leesbaar voor mensen — ontwikkelaars kunnen instructies gemakkelijk beoordelen en bewerken
Het is versiebeheersbaar — staat in git naast je code
Het is lichtgewicht — geen verwerkingsoverhead, geen speciale tools nodig
Het is universeel — werkt in alle AI-tools, editors en platforms

Zoals Visual Studio Magazine het stelde: in agentische AI draait alles om de Markdown.

Best Practices voor het Schrijven van Agent-instructies

Gebaseerd op analyse van duizenden repositories:

Begin minimaal. Voeg regels alleen toe wanneer je merkt dat de agent herhaaldelijk dezelfde fout maakt. Te gespecificeerde instructies kunnen meer verwarren dan helpen.

Wees specifiek over commando’s. Zeg niet “voer de tests uit” — zeg pnpm test of pytest -x tests/.

Documenteer je architectuur. Als je project een specifiek patroon gebruikt (zoals berichtdoorgave tussen een content script en een service worker), leg het dan uit. De agent kan architectuurbeslissingen niet afleiden uit code alleen.

Vermeld wat NIET te doen. Negatieve instructies zijn verrassend effectief: “Wijzig het databaseschema nooit direct” of “Gebruik geen class-componenten, gebruik altijd hooks.”

Hoe Save in Deze Wereld Past

Als je agent-instructiebestanden bouwt, sla je waarschijnlijk ook referentiemateriaal op van het web: documentatiepagina’s, Stack Overflow-antwoorden, GitHub README’s, API-referenties.

Save converteert al deze webbronnen met één klik naar schone Markdown — perfect voor het opbouwen van de context die je AI-agents nodig hebben. Sla een documentatiepagina op, plak de Markdown in je AGENTS.md of referentiedocs, en je AI-codeerassistent heeft onmiddellijk de context die het nodig heeft.

De workflow:

Vind nuttige documentatie of codevoorbeelden op het web
Klik Save om te converteren naar Markdown
Verwijs naar of voeg toe aan je agent-instructiebestanden
Je AI-codeerassistent werkt beter bij elke opslag

De Toekomst: Markdown als AI’s Bedieningsvlak

Microsoft en GitHub behandelen Markdown nu als een stabiel, controleerbaar bedieningsvlak voor AI-gedrag. Het is niet langer alleen documentatie — het is de interface tussen menselijke intentie en AI-uitvoering.

We zien Markdown-bestanden drie aparte rollen vervullen:

Documentatie: Legt een systeem uit aan mensen
Instructie: Beperkt en stuurt AI-gedrag
Vaardigheid: Bundelt instructies met bronnen zodat agents workflows kunnen herhalen

Deze trend versnelt alleen maar. Naarmate AI-codeerassistenten capabeler worden, worden de Markdown-bestanden die ze sturen belangrijker.

Save converteert elke webpagina naar schone Markdown met één klik. Perfect voor het opbouwen van referentiebibliotheken, het vastleggen van documentatie en het creëren van context voor je AI-codeerworkflows. Probeer Save gratis.