I Från AI-chatt till agentiskt arbete, seriens första del, var instruktionerna en av de fem delarna i en AI-agent: en markdown-fil i projektet som agenten läser varje gång den startar. Vi visade en kort sådan fil för en påhittad webbapp.

Använder du en AI-agent i ett projekt ska du skapa en sådan fil. Agenten kan läsa din kod men inte gissa hur projektet installeras och testas. Det talar några rader i filen om.

En påhittad webbapp och dess fil

Ett påhittat exempel: en utvecklare startar en webbapp med en databas och tester och har en AI-agent som hjälp. Agenten vet ingenting om projektet, så första dagen skriver utvecklaren ner det en ny kollega skulle behöva veta – och inget mer. Resultatet är en markdown-fil som heter AGENTS.md, i projektets översta mapp (roten):

# Instructions for AI agents

## Build and test
- Install dependencies with `npm install`.
- Run `npm test` before you say you are done.

## Rules
- Write a test for every bug you fix.
- Change nothing in the `migrations/` folder.
- Ask before you add a new package.

Raderna under "Build and test" är kommandon som agenten inte kan gissa: hur beroendena installeras och hur testerna körs. Reglerna är de få saker som inte går att läsa ut ur koden. En av dem håller agenten borta från mappen migrations/, där databasens ändringar ligger som filer som kallas migreringar. En annan ser till att ny kod utifrån, så kallade paket, inte tar sig in i projektet obemärkt.

Filen är kort med flit. En lång fil tar mer av det utrymme agenten har att arbeta i och följs sämre. Därför föreslår Anthropic under 200 rader och OpenAI hellre en kort och korrekt fil än en lång full av vaga regler.

En vecka senare behöver databasen en ny kolumn. Filen säger att ingenting i migrations/ får ändras, men inte varför och inte vad agenten ska göra i stället, så agenten lämnar en lös fil med databaskommandon i projektets rot. Utvecklaren läser igenom agentens ändringar, hittar filen och ber agenten lägga ändringen i en ny migrering.

Sedan skriver utvecklaren om regeln så att den ger både skäl och utväg: filerna har redan körts i produktion, alltså mot den riktiga databasen, så ändringen görs i en ny migrering. En regel med sitt skäl hjälper i fall som ingen har tänkt på: när instruktionerna förklarar varför en konvention finns fattar agenten bättre beslut i ovanliga fall.

Två gånger under de följande två veckorna kör agenten alla tester efter en ändring på en enda rad, fast en testfil hade räckt. Andra gången lägger utvecklaren till en rad om hur en enskild testfil körs.

Vid det laget har filen också fått ett stycke om vad varje fil i projektet gör. Det ser hjälpsamt ut men klarar inte testet Anthropic föreslår för vad som ska skrivas ner: kan agenten hitta det genom att läsa koden – och skulle den faktiskt gå och titta? Om båda svaren är ja lämnas raden bort. Utvecklaren tar bort stycket.

Två versioner av samma instruktionsfil sida vid sida. Första dagen har den åtta rader.Första dagenAGENTS.md# Instructions for AI agents## Build and test- Install dependencies with `npm install`.- Run `npm test` before you say you are done.## Rules- Write a test for every bug you fix.- Change nothing in the `migrations/` folder.- Ask before you add a new package.Efter några veckor har en rad om att köra en enskild testfil lagts till. Regeln om migreringar har fått sitt skäl och en utväg. Ett stycke som beskriver varje fil är struket. Mappen web/ har fått en egen fil med en rad.Några veckor senareAGENTS.md# Instructions for AI agents## Build and test- Install dependencies with `npm install`.+- Run a single test file with`npm test -- <file>`.- Run `npm test` before you say you are done.## Rules- Write a test for every bug you fix.~- Change nothing in the `migrations/` folder:those files have already run in production.Add a new migration instead.- Ask before you add a new package.−## What each file in the project doesweb/AGENTS.md- Also run `npm run test:web` before yousay you are done.+Tillagd~Ändrad: skäl och utväg tillagda−Struken: agenten läser filerna självNy fil i web/
Den påhittade exempelfilen första dagen och några veckor senare. Historien och filen är påhittade.

Till sist ingår inte testerna för den del av appen som körs i webbläsaren i npm test. Mappen web/ får en egen AGENTS.md med en enda rad som lägger till dem:

- Also run `npm run test:web` before you say you are done.

Då finns det två filer, två av de nivåer som del 1 beskrev: en för hela projektet och en för en enskild mapp. När agenten arbetar i web/ läser den rotfilen först och filen i web/ efter den. Den närmaste filen har sista ordet, som del 1 beskrev: i Codex till exempel går filer närmare den mapp det arbetar i före tidigare riktlinjer.

Ett projekt som ett mappträd och de verktyg som läser varje fil. Översta mappen har AGENTS.md, som Codex och GitHub Copilot läser och som Claude Code läser när det inte finns någon CLAUDE.md; en valfri CLAUDE.md, som Claude Code läser och vars enda rad, @AGENTS.md, hämtar in AGENTS.md; och en mapp .github med copilot-instructions.md, som GitHub Copilot läser. Mappen web har en egen AGENTS.md, som läses när verktyget arbetar i den mappen, av Codex, av GitHub Copilot i VS Code och av Claude Code när det inte finns någon CLAUDE.md. Den närmaste filen har sista ordet.Projektets mapparprojektetläses vid varje startAGENTS.mdCodexCopilotClaude Codeom CLAUDE.md saknasCLAUDE.mdvalfriClaude Code@AGENTS.mdhämtar in.github/copilot-instructions.mdCopilotweb/läses när verktyget arbetar härAGENTS.mdsista ordetCodexCopiloti VS CodeClaude Codeom CLAUDE.md saknas
Vilket verktyg som läser vilken fil i ett projekts mappar, så som dokumentationen såg ut den 30 oktober 2026. Den närmaste filen har sista ordet.

Regeln om migrations/ blir kvar i rotfilen, eftersom den gäller hela projektet. Rotfilen ser nu ut så här:

# Instructions for AI agents

## Build and test
- Install dependencies with `npm install`.
- Run a single test file with `npm test -- <file>`.
- Run `npm test` before you say you are done.

## Rules
- Write a test for every bug you fix.
- Change nothing in the `migrations/` folder: those files have already
  run in production. Add a new migration instead.
- Ask before you add a new package.

Vad studierna visar

Det finns inte mycket som visar att en instruktionsfil ger bättre resultat. En studie från ETH Zürich lät AI-agenter lösa verkliga uppgifter med och utan instruktionsfil. Filer som utvecklarna själva hade skrivit höjde andelen lösta uppgifter med 2,4 procentenheter i genomsnitt, till exempel från 60 uppgifter av 100 till ungefär 62.

Det är en liten vinst som studien inte kan skilja från slumpen. Forskare kallar en skillnad "statistiskt säkerställd" när den knappast skulle uppstå av en slump, så ordet betyder inte att skillnaden är stor. Jämfört med ingen fil alls var ingen av skillnaderna i andelen lösta uppgifter säkerställd. Filer som utvecklarna skrev klarade sig säkerställt bättre än filer som en språkmodell skrev.

Filer som en språkmodell hade skrivit sänkte andelen något i genomsnitt och forskarna föreslår att man tills vidare undviker sådana filer. Filer av båda slagen gjorde körningarna dyrare, med ungefär en femtedel i genomsnitt. Ökningarna var säkerställda.

Studien tittade också på översikter av projektet, som det stycke utvecklaren tog bort. Forskarna fann att sådana översikter, fast populära, inte hjälpte i projekt som redan hade dokumentation.

När all annan dokumentation hade tagits bort fann forskarna att filer som en språkmodell hade skrivit "kan fungera som effektiva översikter när ingen dokumentation finns" (vår översättning). Sådana filer höjde andelen lösta uppgifter med 2,7 procentenheter i genomsnitt. Studien redovisar inget test av om höjningen är säkerställd och Claude Code lämnades utanför av kostnadsskäl.

En annan, mindre studie tittade på 124 pull requests, alltså föreslagna ändringar i ett projekts kod. En typisk körning med en AGENTS.md gick mer än en fjärdedel snabbare.

Studien mätte inte om svaren blev bättre. Forskarna granskade 50 av uppgifterna och fann riktiga kodändringar, inte avbrutna körningar. Studien visar alltså att agenten blev klar snabbare, inte att svaren var bättre eller sämre. Den mätte ingen kostnad i pengar, så den kan inte ställas mot den första studien.

Forskarna bakom den första studien finner en fil användbar för ett projekts arbetssätt som avviker från standard och rekommenderar att den bara innehåller det agenten inte kan få fram ur koden. Det stämmer med filen i exemplet: kommandona och de få reglerna är sådant agenten inte kan räkna ut själv. Studierna ger ingen anledning att lägga till mer.

När agenten gör fel

Om filen inte säger något om misstaget säger du till agenten och går vidare, eftersom ett enstaka misstag kan vara en engångsgrej. Gör agenten samma misstag en andra gång lägger du till en rad i filen, som utvecklaren gjorde med den enskilda testfilen.

Ibland finns raden redan och agenten gör ändå fel. Kontrollera först att verktyget läser filen över huvud taget: Claude Code, vars egen fil heter CLAUDE.md, läser AGENTS.md som standard bara där det inte finns någon CLAUDE.md. Vill du se om det har läst din fil, kör /memory i Claude Code och leta efter AGENTS.md i listan. Avsnittet om verktygen längre ner säger vad varje verktyg läser.

Titta sedan på raden. En rad som ger sitt skäl och en utväg fungerar bättre, som regeln om migrations/ efter omskrivningen. Där väntade utvecklaren inte på ett andra misstag, eftersom felet låg i raden: den saknade sitt skäl.

Agenten försöker följa filen men även en bra rad fungerar för det mesta, inte varje gång. En regel som aldrig får brytas behöver därför något utanför filen. Ett sätt är ett test i projektet som misslyckas när regeln bryts: för migrations/ ett test som misslyckas när en migrering som redan finns i projektet ändras. Agenten kan skriva testet åt dig om du ber den.

Det andra sättet är en inställning i verktyget som blockerar ändringen. I Claude Code är en sådan inställning en hook, ett kommando som verktyget kör av sig självt. Anthropics eget exempel är en hook som blockerar ändringar i mappen med migreringar. Du kan be Claude skriva den åt dig.

Det som aldrig får hända stoppas utanför modellen, som del 1 beskrev. Del 7 i serien tar upp det igen.

En fil för tre verktyg

Med flera verktyg i projektet räcker en AGENTS.md i översta mappen om varje verktyg hittar den. Det stämmer med VS Codes dokumentation, som rekommenderar ett gemensamt format som alla verktygen stöder, när det går. Verktygen beskriver vi så som dokumentationen såg ut den 30 oktober 2026. Det vi skriver kan ha ändrats sedan dess.

Filen i översta mappen läses vid varje start, som del 1 beskrev.

Tre verktyg och de filer de läser. Codex läser AGENTS.md. GitHub Copilot läser AGENTS.md och .github/copilot-instructions.md. Claude Code läser AGENTS.md också när det inte finns någon CLAUDE.md. Där det finns en hämtar en enda rad i den, @AGENTS.md, in den delade filen.Filer i projektet.github/copilot-instructions.mdAGENTS.mdCLAUDE.md@AGENTS.mdom projektet har en CLAUDE.mdGitHub CopilotCodexClaude Codeom det inte finns någonCLAUDE.md
Vilka av projektets filer varje verktyg läser, så som dokumentationen såg ut den 30 oktober 2026.

Claude Code har CLAUDE.md som egen instruktionsfil och läser som standard AGENTS.md bara där det inte finns någon CLAUDE.md. Där det läser AGENTS.md läser det en fil i en undermapp när det öppnar en fil där. Finns det en CLAUDE.md kan den hämta in AGENTS.md med en enda rad, så att AGENTS.md förblir den fil som alla verktyg delar:

@AGENTS.md

För den här regeln räknas en CLAUDE.local.md, en fil för egna anteckningar, som en CLAUDE.md. Lägger du till en i ett projekt som bara har en AGENTS.md slutar Claude Code därför läsa AGENTS.md, om inte en inställning säger något annat.

I OpenAI:s Codex är AGENTS.md själva instruktionsfilen: Codex läser den innan det gör något arbete, en fil per mapp från projektets rot ner till den mapp det arbetar i. Som standard slutar det lägga till filer när de tillsammans når 32 KiB, ungefär 32 000 tecken.

GitHub Copilot läser AGENTS.md också, både på GitHub och i VS Code. Det läser dessutom .github/copilot-instructions.md och skickar alla instruktioner som gäller till modellen. I VS Code hittar det en fil i en undermapp när det arbetar med filer där.

Börja litet

Vi skulle börja med en markdown-fil som heter AGENTS.md i projektets översta mapp: kommandona för att installera, bygga och testa först och sedan de få regler som agenten inte kan läsa ut ur koden, var och en med sitt skäl. Översikter och beskrivningar av vad varje fil gör skulle vi lämna utanför.

Du kan skriva filen själv eller be agenten skriva ett utkast. Skriver ett verktyg ett utkast åt dig, redigera det: både Anthropic och OpenAI säger att utkastet ska redigeras. Studien ovan är ett skäl att korta ner utkastet till kommandona och de få reglerna, eftersom genererade filer ökade kostnaden och inte gav någon tydlig vinst där det fanns dokumentation.

När du byter till en nyare modell, läs filen igen. I oktober 2026 står det i Anthropics promptguide att två av de modeller den nämner kan använda ett verktyg för ofta om betoning som MUST med versaler lades till för att få en äldre modell att använda det oftare. Guidens råd är att mjuka upp hårda formuleringar.

Vad som kommer härnäst

Arbetstitlarna kan ändras på vägen.

  1. Från AI-chatt till agentiskt arbete
  2. Instruktionsfilen (den här delen)
  3. Ge varje AI-agent ett eget jobb
  4. Skills, när arbetet ska göras likadant varje gång
  5. MCP, så når AI-agenten andra system
  6. Var AI-agenten körs och vem som startar den
  7. Sätt gränserna i förväg
  8. Vad som har ändrats på vägen – de senaste modellerna behöver mindre styrning än de förra, men fortfarande en del