← Tilbage til blog

AGENTS.md & CLAUDE.md: Den nye README til AI-kodningsagenter

· Save Team
markdownaiagents-mdclaude-mdcodingdeveloper-tools

Hvis du har brugt en AI-kodningsassistent for nylig, har du sikkert bemærket noget: de vil alle gerne have en Markdown-fil.

GitHub Copilot læser .github/copilot-instructions.md. Cursor læser .cursor/rules/. Claude Code læser CLAUDE.md. Windsurf læser .windsurf/rules. Googles Jules læser JULES.md. Og den universelle standard? AGENTS.md — nu brugt af over 60.000 open-source repositories og forvaltet af Linux Foundations Agentic AI Foundation.

Markdown er gået fra at være et dokumentationsformat til at blive operativsystemet for AI-kodningsagenter.

Hvad er AGENTS.md?

AGENTS.md er en simpel, åben-format Markdown-fil, der lever i dit repository og fungerer som en briefingpakke til AI-kodningsagenter. Tænk på det som README.mds modstykke:

  • README.md er til mennesker: hurtigstarter, projektbeskrivelser, badges
  • AGENTS.md er til AI-agenter: byggeskridtene, testkommandoer, kodningskonventioner, arkitektoniske beslutninger

Agenten læser den nærmeste fil i mappetreet, så den nærmeste tager forrang. Hvert delprojekt kan levere skræddersyede instruktioner.

Hvad er CLAUDE.md?

CLAUDE.md er specifikt til Anthropics Claude Code. Den læses automatisk i starten af hver session og indeholder projektspecifikke instruktioner, du ellers ville gentage i hver prompt.

En god CLAUDE.md indeholder typisk:

  • Projektkontekst: En enkelt linje der orienterer Claude om, hvad projektet gør
  • Kodestil: Dine formateringspræferencer, navnekonventioner, mønstre at følge
  • Kommandoer: Sådan kører du test, bygger, linter og deployer
  • Arkitekturnoter: Nøglebeslutninger som Claude bør respektere

Den anbefalede tilgang: læg delte instruktioner i AGENTS.md (så alle AI-værktøjer drager fordel), tilføj derefter Claude-specifikke funktioner til CLAUDE.md.

Det fulde landskab af AI-instruktionsfiler

Her er hvert større AI-kodningsværktøj og dets Markdown-konvention:

VærktøjFilFormat
GitHub Copilot.github/copilot-instructions.mdMarkdown
Cursor.cursor/rules/*.mdMarkdown
Claude CodeCLAUDE.mdMarkdown
Windsurf.windsurf/rulesMarkdown
Google JulesJULES.mdMarkdown
UniverselAGENTS.mdMarkdown

Læg mærke til mønsteret? Det er alt Markdown. Hvert eneste.

Hvorfor Markdown vandt

Markdown er det perfekte format til AI-instruktionsfiler fordi:

  1. LLM’er forstår det nativt — det er det mest almindelige format i deres træningsdata
  2. Det er menneskeligt læsbart — udviklere kan gennemgå og redigere instruktioner nemt
  3. Det er versionsstyreligt — lever i git ved siden af din kode
  4. Det er letvægt — ingen parsingoverhead, intet særligt værktøj nødvendigt
  5. Det er universelt — fungerer på tværs af alle AI-værktøjer, editorer og platforme

Som Visual Studio Magazine udtrykte det: i agentic AI handler det hele om Markdown.

Bedste praksis til at skrive agentinstruktioner

Baseret på analyse af tusindvis af repositories:

Start minimalt. Tilføj kun regler, når du bemærker, at agenten gentagne gange laver den samme fejl. Overspecificerede instruktioner kan forvirre mere end hjælpe.

Vær specifik om kommandoer. Sig ikke “kør testene” — sig pnpm test eller pytest -x tests/.

Dokumenter din arkitektur. Hvis dit projekt bruger et bestemt mønster (som meddelelsesudveksling mellem et indholdsscript og service worker), forklar det. Agenten kan ikke udlede arkitektoniske beslutninger fra kode alene.

Inkluder hvad man IKKE skal gøre. Negative instruktioner er overraskende effektive: “Modificer aldrig databaseskemaet direkte” eller “Brug ikke klassekomponenter, brug altid hooks.”

Sådan passer Save ind i denne verden

Hvis du bygger agentinstruktionsfiler, gemmer du sandsynligvis også referencemateriale fra nettet: dokumentationssider, Stack Overflow-svar, GitHub READMEs, API-referencer.

Save konverterer enhver af disse webkilder til ren Markdown med ét klik — perfekt til at bygge den kontekst dine AI-agenter har brug for. Gem en dokumentationsside, indsæt Markdown i din AGENTS.md eller referencedokumenter, og din AI-kodningsassistent har øjeblikkeligt den kontekst, den har brug for.

Arbejdsgangen:

  1. Find nyttig dokumentation eller kodeeksempler på nettet
  2. Klik Save for at konvertere til Markdown
  3. Referer til eller inkluder i dine agentinstruktionsfiler
  4. Din AI-kodningsassistent fungerer bedre med hvert gem

Fremtiden: Markdown som AI’s kontrolflade

Microsoft og GitHub behandler nu Markdown som en stabil, reviderbar kontrolflade for AI-adfærd. Det er ikke bare dokumentation længere — det er grænsefladen mellem menneskelig intention og AI-udførelse.

Vi ser Markdown-filer tjene tre tydelige roller:

  1. Dokumentation: Forklarer et system for mennesker
  2. Instruktion: Begrænser og styrer AI-adfærd
  3. Færdighed: Bundler instruktioner med ressourcer, så agenter kan gentage workflows

Denne tendens accelererer kun. Efterhånden som AI-kodningsassistenter bliver mere kapable, bliver de Markdown-filer der guider dem vigtigere.


Save konverterer enhver webside til ren Markdown med ét klik. Perfekt til at bygge referencebiblioteker, indfange dokumentation og skabe kontekst til dine AI-kodningsworkflows. Prøv Save gratis.