Skriv sidan som agenten läser först.
En kodagent är nyanställd på dag ett, varje dag — och frågar inte i Slack. Allt den inte hittar i repot gissar den sig till. Nio frågor här blir en AGENTS.md: en sida, länkar till filer, inga romaner.
9 frågor · 5 minuter · Inget sparas
”Länka till filer i stället för att beskriva dem. Agenten läser hellre Makefilen än ett stycke om Makefilen.”
Repot
Skriv för någon som aldrig sett repot. Det är precis vad agenten är.
Kommandon
Exakt som de skrivs i terminalen. Tomma fält utelämnas ur filen.
Kontrollerna
Om CI är det enda stället där sanningen finns kommer agenten att lära sig genom att pusha.
Vägen till produktion
Grenar, miljöer, vem som trycker på knappen. Agenten ska veta vad en merge faktiskt gör.
Det som ”alla vet”
En rad per punkt. Det här är avsnittet som ersätter Slack-frågan.
Sökväg, tankstreck, varför. En per rad. Länka hellre än förklara.
Det som får en senior att sucka i code review. En per rad.
Beslut som ska tas av en människa. En per rad.
Vad agenten får göra utan att fråga
Det som inte är tillåtet hamnar automatiskt under „Fråga innan du”.
Er fil
# AGENTS.md
Read this before touching anything. Everything below is the short version — the files linked are the source of truth.
## Before you push
Run the same checks CI runs before you push. If they fail locally they will fail in CI.
## Branches and commits
Trunk-based: small changes straight to the main branch, never long-lived branches.
## Ask before you
- Add a dependency.
- Change the CI configuration.
## Allowed without asking
- Run tests and lint.
## When something is unclear
Stop and ask instead of guessing. Say which file you read and what you could not find.
<!-- Generated with paperphyte.com/agents-md-generatorn — keep it short, keep it true. -->
≈ 27 rader — det får plats på en sida.
Nästa steg
Lägg filen i repots rot och committa den. Be sedan en agent göra något litet på riktigt — och anteckna varje gissning den ändå gör. Varje gissning är en rad som saknas. Varför filen behövs står i Er nästa plattformsanvändare är en agent, och AI-redo-kollen mäter om kodbasen håller för det agenten nu vet hur den ska göra. Vill ni ha hjälp att bygga hela vägen är Developer Experience åtagandet.
Genereras lokalt i din webbläsare — inget skickas någonstans.