I Er nästa plattformsanvändare är en agent skrev vi att en kodagent bara läser det som finns i repot, och att steg två är enkelt att skriva och tråkigt att göra: ”Skriv en AGENTS.md. En sida. Länka till filer.” I dag lanserar vi verktyget som gör det tråkiga på fem minuter: AGENTS.md-generatorn.
Vad filen är — och inte är
AGENTS.md — Claude Code läser den som CLAUDE.md, andra verktyg under andra namn — är filen en kodagent läser innan den gör något. Den är inte dokumentation. Den är ett kontrakt: så här bygger, testar och deployar man här, det här rör du inte, det här frågar du om först.
Den bästa versionen vi sett är kort. En sida. Kommandon exakt som de skrivs i terminalen, länkar till filerna som är sanningen, och en lista över det som ”alla vet” men ingen skrivit ner. Den sämsta är en README-kopia på fyrtio stycken som agenten läser en gång och sedan ignorerar — precis som människorna.
Så fungerar den
Nio frågor. Vad repot är, vilka kommandon som gäller, om CI:s kontroller går att köra lokalt, hur koden når produktion, hur ni grenar och committar, vilka filer man ska läsa först, vilka regler som aldrig bryts, vad agenten ska fråga om — och vad den får göra utan att fråga.
Ut kommer en färdig fil, på engelska eller svenska, som AGENTS.md eller CLAUDE.md. Kopiera eller ladda ner, lägg den i repots rot, committa. Tomma fält utelämnas: en tom rubrik ”Regler” lär agenten att regler är valfria.
En detalj vi tycker om: verktyget räknar rader. Går filen över en sida säger den till. Mer än en sida läses sämre — av agenter och av människor — och det rätta svaret är nästan alltid att länka till en fil i stället för att beskriva den.
Varför inte bara låta agenten skriva den?
Det går, och många gör det. Problemet är att agenten då skriver ner vad den kan se: filstrukturen, package.json, namnen på testfilerna. Det den inte kan se är precis det filen ska innehålla — att kontraktstesterna bara körs i CI för att de behöver VPN, att migrationer som är mergade aldrig ändras, att ingen rör infra/ utan att fråga. Det är tyst kunskap. Den sitter i människor, och det är människor som ska skriva ner den. Verktyget ställer bara frågorna i rätt ordning.
Vad det inte gör
Det sparar ingenting och skickar ingenting — filen genereras i din webbläsare och finns bara där tills du kopierar den. Det gissar inte heller något om ert repo. Fälten ni lämnar tomma förblir tomma, för en gissning i en AGENTS.md är värre än ett tomt fält: agenten litar på filen.
Vårt korta svar
En kodagent läser AGENTS.md innan den rör något. Skriv den som ett kontrakt på en sida — kommandon, kontroller, vägen till produktion, det som aldrig bryts och det som ska frågas om — och länka till filer i stället för att beskriva dem. Generatorn ställer frågorna; ni har svaren.
Har ni redan gjort AI-redo-kollen vet ni om kodbasen håller för det agenten nu vet hur den ska göra. Vill ni ha hjälp med resten av vägen — scaffolding, kontroller lokalt, felmeddelanden som säger vad man ska göra — är Developer Experience åtagandet.