← Tilbake til bloggen

AGENTS.md & CLAUDE.md: Den Nye README for AI Kodingsagenter

· Save Team
markdownaiagents-mdclaude-mdcodingdeveloper-tools

Hvis du har brukt en AI-kodingsassistent nylig, har du sannsynligvis lagt merke til noe: de vil alle ha en Markdown-fil.

GitHub Copilot leser .github/copilot-instructions.md. Cursor leser .cursor/rules/. Claude Code leser CLAUDE.md. Windsurf leser .windsurf/rules. Googles Jules leser JULES.md. Og den universelle standarden? AGENTS.md --- nå brukt av over 60.000 åpen kildekode-repositorier og forvaltet av Linux Foundations Agentic AI Foundation.

Markdown har gått fra et dokumentasjonsformat til operativsystemet for AI-kodingsagenter.

Hva Er AGENTS.md?

AGENTS.md er en enkel, åpent formatert Markdown-fil som lever i repositoriet ditt og fungerer som en informasjonspakke for AI-kodingsagenter. Tenk på det som motparten til README.md:

  • README.md er for mennesker: hurtigstarter, prosjektbeskrivelser, merker
  • AGENTS.md er for AI-agenter: byggetrinn, testkommandoer, kodingskonvensjoner, arkitektoniske beslutninger

Agenten leser den nærmeste filen i katalogtreet, så den nærmeste tar forrang. Hvert delprosjekt kan levere tilpassede instruksjoner.

Hva Er CLAUDE.md?

CLAUDE.md er spesifikt for Anthropics Claude Code. Den leses automatisk ved starten av hver økt og inneholder prosjektspesifikke instruksjoner du ellers ville gjentatt i hver prompt.

En god CLAUDE.md inkluderer vanligvis:

  • Prosjektkontekst: En enlinje som orienterer Claude om hva prosjektet gjør
  • Kodestil: Formateringsinnstillinger, navnekonvensjoner, mønstre å følge
  • Kommandoer: Hvordan kjøre tester, bygge, lint og distribuere
  • Arkitekturnotater: Viktige beslutninger Claude bør respektere

Den anbefalte tilnærmingen: legg delte instruksjoner i AGENTS.md (slik at alle AI-verktøy drar nytte), og legg deretter til Claude-spesifikke funksjoner i CLAUDE.md.

Det Fulle Landskapet av AI Instruksjonsfiler

Her er hvert viktige AI-kodingsverktøy og dets Markdown-konvensjon:

VerktøyFilFormat
GitHub Copilot.github/copilot-instructions.mdMarkdown
Cursor.cursor/rules/*.mdMarkdown
Claude CodeCLAUDE.mdMarkdown
Windsurf.windsurf/rulesMarkdown
Google JulesJULES.mdMarkdown
UniversellAGENTS.mdMarkdown

Legg merke til mønsteret? Det er alt Markdown. Hvert eneste ett.

Hvorfor Markdown Vant

Markdown er det perfekte formatet for AI-instruksjonsfiler fordi:

  1. LLM-er forstår det naturlig --- det er det vanligste formatet i treningsdataene deres
  2. Det er mennesklesbart --- utviklere kan gjennomgå og redigere instruksjoner enkelt
  3. Det er versjonskontrollerbart --- lever i git ved siden av koden din
  4. Det er lett --- ingen analyse-overhead, ingen spesielle verktøy nødvendig
  5. Det er universelt --- fungerer på tvers av hvert AI-verktøy, editor og plattform

Som Visual Studio Magazine sa det: i agentisk AI handler alt om Markdown.

Beste Praksis for Skriving av Agentinstruksjoner

Basert på analyse av tusenvis av repositorier:

Start minimalt. Legg til regler bare når du legger merke til at agenten gjentatte ganger gjør den samme feilen. Overspesifiserte instruksjoner kan forvirre mer enn de hjelper.

Vær spesifikk om kommandoer. Ikke si “kjør testene” --- si pnpm test eller pytest -x tests/.

Dokumenter arkitekturen din. Hvis prosjektet ditt bruker et spesifikt mønster (som meldingssending mellom et innholdsskript og service worker), forklar det. Agenten kan ikke utlede arkitektoniske beslutninger fra kode alene.

Inkluder hva du IKKE skal gjøre. Negative instruksjoner er overraskende effektive: “Aldri modifiser databaseskjemaet direkte” eller “Ikke bruk klassekomponenter, bruk alltid hooks.”

Hvordan Save Passer Inn i Denne Verden

Hvis du bygger agentinstruksjonsfiler, lagrer du sannsynligvis også referansemateriale fra nettet: dokumentasjonssider, Stack Overflow-svar, GitHub-README-er, API-referanser.

Save konverterer enhver av disse nettkilder til ren Markdown med ett klikk --- perfekt for å bygge konteksten AI-agentene dine trenger. Lagre en dokumentasjonsside, lim Markdown inn i AGENTS.md eller referansedokumentene dine, og AI-kodingsassistenten din har umiddelbart den nødvendige konteksten.

Arbeidsflyten:

  1. Finn nyttig dokumentasjon eller kodeeksempler på nettet
  2. Klikk Save for å konvertere til Markdown
  3. Referer eller inkluder i agentinstruksjonsfilene dine
  4. AI-kodingsassistenten din fungerer bedre med hvert lagring

Fremtiden: Markdown som AIs Kontrollflate

Microsoft og GitHub behandler nå Markdown som en stabil, reviderbar kontrollflate for AI-atferd. Det er ikke bare dokumentasjon lenger --- det er grensesnittet mellom menneskelig intensjon og AI-utførelse.

Vi ser Markdown-filer tjene tre distinkte roller:

  1. Dokumentasjon: Forklarer et system for mennesker
  2. Instruksjon: Begrenser og styrer AI-atferd
  3. Ferdighet: Bunter instruksjoner med ressurser slik at agenter kan gjenta arbeidsflyter

Denne trenden akselererer bare. Etter hvert som AI-kodingsassistenter blir mer kapable, blir Markdown-filene som veileder dem viktigere.


Save konverterer enhver nettside til ren Markdown med ett klikk. Perfekt for å bygge referansebiblioteker, fange dokumentasjon og lage kontekst for AI-kodingsarbeidsflytene dine. Prøv Save gratis.