Varje AI-kodningsverktyg vill ha en Markdown-fil med ditt projekts regler. Men de vill alla ha en annan Markdown-fil.

Om du använder flera AI-verktyg (och de flesta utvecklare gör det) blir detta förvirrande snabbt. Här är den definitiva guiden till vilka filer du behöver och vad som går in i var och en.

Filerna i Korthet

Fil	Verktyg	Plats	Omfång
`AGENTS.md`	Universell (alla verktyg)	Projektrot	Delade regler för alla AI-agenter
`CLAUDE.md`	Claude Code	Projektrot	Claude-specifika instruktioner
`.cursor/rules/*.md`	Cursor	`.cursor/rules/`-mapp	Cursor-specifika regler
`.github/copilot-instructions.md`	GitHub Copilot	`.github/`-mapp	Copilot-specifika instruktioner
`.windsurf/rules`	Windsurf	`.windsurf/`-mapp	Windsurf-specifika regler
`JULES.md`	Google Jules	Projektrot	Jules-specifika instruktioner

AGENTS.md: Den Universella Standarden

Bäst för: Team som använder flera AI-verktyg, open source-projekt

AGENTS.md är det närmaste vi har en universell standard. Det används nu av över 60 000 repositories och förvaltas av Linux Foundation’s Agentic AI Foundation (tillsammans med MCP och goose).

Sätt dina delade instruktioner här --- saker varje AI-verktyg bör veta:

Projektstruktur och arkitektur
Build- och testkommandon
Kodstilskonventioner
Vanliga mönster och anti-mönster
Beroenden och installationssteg

Varje större AI-kodningsverktyg läser AGENTS.md, vilket gör det till den enda sanningskällan för ditt projekts AI-instruktioner.

CLAUDE.md: Claude Codes Minne

Bäst för: Claude Code-användare, team som standardiserar på Anthropic

CLAUDE.md läses automatiskt i början av varje Claude Code-session. Det stöder några Claude-specifika funktioner som minnesbeständighet och sessionskontext.

Använd CLAUDE.md för:

Claude-specifika beteendetweaks
Funktioner som bara Claude Code stöder
Åsidosätta eller utöka AGENTS.md för Claude

Det rekommenderade mönstret: delade regler i AGENTS.md, Claude-specifika tillägg i CLAUDE.md.

.cursorrules / .cursor/rules/: Cursors Tillvägagångssätt

Bäst för: Cursor-användare, team som använder Cursor som primär IDE

Cursor använde ursprungligen en enda .cursorrules-fil, sedan utvecklades det till en .cursor/rules/-mapp för mer detaljerad kontroll. Varje fil i mappen är en separat regel som Cursor tillämpar.

Använd Cursor-regler för:

Cursor-specifikt agentbeteende
Regler för Cursors Composer- och Agent-lägen
Filtypespecifika instruktioner (t.ex. olika regler för .tsx vs .py)

copilot-instructions.md: GitHubs Konvention

Bäst för: GitHub Copilot-användare, GitHub-centrerade arbetsflöden

GitHub Copilot läser .github/copilot-instructions.md för instruktioner på projektnivå. Det följer GitHubs konvention att lägga konfiguration i .github/-mappen.

Den Rekommenderade Inställningen

För de flesta projekt behöver du max två filer:

Om du använder ett AI-verktyg:

Använd bara det verktygets native fil (CLAUDE.md för Claude Code, .cursor/rules/ för Cursor, etc.).

Om du använder flera AI-verktyg:

AGENTS.md --- alla delade regler (arkitektur, build-kommandon, konventioner)
Verktygsspecifik fil --- bara för funktioner unika för det verktyget

Exempelstruktur:

ditt-projekt/
  AGENTS.md              # Delat: build-kommandon, arkitektur, konventioner
  CLAUDE.md              # Claude-specifikt: minnesinställningar, verktygsanvändning
  .cursor/rules/style.md # Cursor-specifikt: composer-beteende
  .github/copilot-instructions.md  # Copilot-specifikt

Vad Som Ska Ingå i Dina Regler

Baserat på analys av tusentals repositories innehåller de mest effektiva instruktionsfilerna:

Inkludera alltid:

Hur man bygger och kör projektet
Hur man kör tester
Arkitekturella nyckelsbeslut
Kodstilsinställningar

Ofta hjälpsamt:

Vad man INTE ska göra (negativa instruktioner fungerar förvånansvärt bra)
Förklaringar av filstruktur
Vanliga felsökningssteg
Kommandon för beroendehantering

Hoppa över:

Uppenbara språkfunktioner
Saker AI:n redan vet
Alltför detaljerade regler (börja minimalt, lägg till vid behov)

Bygga Dina AI-regler med Webbkontext

Att skriva bra AI-instruktionsfiler kräver ofta referens till extern dokumentation, stilguider eller arkitekturmönster. Det är här att ha webbinnehåll i Markdown-format hjälper.

Om ditt projekt till exempel följer ett specifikt API-mönster från en dokumentationssida kan du:

Använda Save för att konvertera den dokumentationssidan till Markdown
Referera eller citera de relevanta sektionerna i din AGENTS.md
Din AI-kodningsassistent har nu full kontext

Detsamma gäller för ramverksdokumentation, stilguider, artiklar om bästa praxis och Stack Overflow-lösningar. Ren Markdown är formatet som både du och dina AI-verktyg kan arbeta med mest effektivt.

Slutsatsen

Ekosystemet för AI-kodningsregler är fortfarande under utveckling, men mönstret är tydligt: det är allt Markdown. Oavsett om du använder ett verktyg eller fem, lever ditt projekts AI-instruktioner i Markdown-filer som är versionskontrollerade, mänskligt läsbara och maskinparserbara.

Börja med AGENTS.md för universella regler, lägg till verktygsspecifika filer vid behov, och håll allt minimalt tills du ser ett upprepat problem värt att lösa.

Save konverterar vilken webbsida som helst till ren Markdown --- perfekt för att bygga referensmaterialet och dokumentationskontexten som dina AI-kodningsassistenter behöver. Prova Save gratis.