Be Claude Code — eller vilken kodagent ni nu använder — om något enkelt: ”skapa en ny intern tjänst enligt vår standard och få den deployad till testmiljön”. Sätt dig sedan bredvid och titta. Inte för att rätta, utan för att anteckna.
Det som händer är förutsägbart. Agenten läser README, hittar en mening om att ”konventioner finns på Confluence” och kan inte följa länken. Den tittar på tre befintliga repon som var och en gör saker på sitt eget sätt och väljer ett av dem, eller inget. Den skriver en Dockerfile som ser ut som alla andra Dockerfiles på internet — inte som er. Den pushar, pipelinen faller på steg tre med exit code 1, och resten av förmiddagen går åt till att en människa förklarar vad pipelinen egentligen ville.
Agenten gjorde exakt vad en nyanställd gör första veckan. Med en skillnad: den nyanställda hade frågat i Slack.
Den ärligaste DX-mätaren ni har
Varje organisation bär på ett lager av tyst kunskap — saker som ”alla vet”: att deploymentet måste ha en viss etikett, att testmiljön kräver ett VPN som inte står någonstans, att den där modulen i mall-repot inte ska användas längre. Människor kompenserar för det lagret utan att tänka på det. De frågar, de kommer ihåg, de lär sig av kollegan intill.
En agent kompenserar inte. Den är nyanställd på dag ett, varje dag, och den har ingen kollega intill. Allt ni har tolererat för att människor pysslar runt det blir plötsligt synligt — inte som en åsikt i en retro, utan som en gissning i en pull request.
Det är obekvämt. Det är också den mest ärliga mätning av er developer experience ni kan få för priset av en förmiddag. Om golden path:en bara fungerar för den som varit med i ett år är det ingen väg. Det är ett minne.
Fyra sätt en agent skiljer sig från en människa som användare
- Den läser allt — men bara det som finns i repot. Wikin, Confluence-sidan, Slack-tråden där beslutet togs: allt det är osynligt. Om konventionen inte ligger bredvid koden finns den inte.
- Den frågar inte, den gissar. En människa som är osäker stannar upp. En agent går vidare med det mest sannolika svaret, och det mest sannolika svaret är internets genomsnitt. Er konvention förlorar mot genomsnittet varje gång den inte är nedskriven.
- Den kör kommandon, inte klickar. Allt som ligger bakom en portal, en wizard eller ett formulär i ett verktyg är utom räckhåll. Det som inte går att göra från terminalen eller ett API är inte en del av vägen.
- Den lär sig av felmeddelanden. ”Exit code 1” lär ingen någonting. ”Deploymentet saknar etiketten cost-center, se deploy/README.md” är en specifikation som agenten — och människan — kan agera på i nästa försök.
Vad det betyder för en golden path
Vi skrev i Sluta skriva wiki-sidor, börja bygga golden paths att scaffolding ska vara ett kommando, inte en wiki-sida med fjorton steg. Det var ett gott råd då. Med agenter som användare är det inte längre ett råd — det är ett krav. Utöver det behöver vägen fyra saker:
- En kontraktsfil i repot. En AGENTS.md eller CLAUDE.md i roten av mall-repot, max en sida: så här bygger, testar och deployar man här. Länka till filer i stället för att beskriva dem — agenten läser hellre Makefilen än ett stycke om Makefilen.
- Sanningen körbar lokalt. Om CI är det enda stället där kontrollerna finns kommer agenten att lära sig genom att pusha. Lint, tester och policykontroller ska gå att köra med ett kommando innan koden lämnar maskinen — och ge samma svar som pipelinen.
- Felmeddelanden som specifikation. Gå igenom de vanligaste sätten pipelinen fallerar på och byt ut varje ”misslyckades” mot ”det här saknas, så här fixar du det”. Det är den billigaste dokumentation ni någonsin kommer att skriva, och den enda som läses exakt när den behövs.
- En sandlåda med begränsad sprängradie. En agent som får försöka behöver någonstans att försöka: kortlivade miljöer och kortlivade rättigheter, hellre än ett delat testkonto med nycklar som aldrig roteras. Vi har beskrivit ett sätt att komma bort från långlivade nycklar i guiden om IAM Roles Anywhere.
Och människorna då?
Läs listan en gång till och stryk ordet agent. Dokumentation bredvid koden. Kontroller som går att köra lokalt. Felmeddelanden som säger vad man ska göra. Miljöer man får ha sönder. Ingenting på listan är till för maskinen. Allt på listan är sådant som den nyanställda, konsulten och du själv första dagen efter semestern har velat ha i åratal.
Det agenten gör är att ta bort möjligheten att skjuta upp det. Så länge bara människor använde plattformen kunde man lita på att de pysslade runt bristerna. Nu står det en användare i kön som inte pysslar runt någonting — och som i gengäld gör exakt som vägen säger, om vägen bara säger något.
Det är samma tanke som i Plattform som produkt: en plattform har kunder, och kunderna avgör om den fungerar. Ni har just fått en ny kund. Den är oändligt tålmodig, ber aldrig om ursäkt och lämnar aldrig feedback i ord — bara i pull requests.
Så börjar du
- Ge en agent uppgiften ”skapa en ny tjänst enligt vår standard och deploya till test” i ett tomt repo. Sitt bredvid och anteckna varje gissning den gör. Varje gissning är ett hål i vägen.
- Skriv en AGENTS.md eller CLAUDE.md i ert vanligaste mall-repo. En sida. Länka till filer. AGENTS.md-generatorn ställer frågorna i rätt ordning.
- Gör pipelinens kontroller körbara lokalt med ett kommando — och se till att de ger samma svar som CI.
- Byt ut de tre vanligaste felmeddelandena i pipelinen mot meddelanden som säger vad man ska göra.
- Mät samma sak som förut: tiden från tomt repo till första deploy i produktion. Men mät den nu med en agent vid tangentbordet.
Har ni gjort AI-redo-kollen vet ni redan om kodbasen är redo för en agent. Det här är nästa fråga: är plattformen det?
Vårt korta svar
En kodagent är en nyanställd på dag ett, varje dag, utan kollega att fråga. Allt ni inte skrivit ner bredvid koden gissar den sig till — och gissar fel. Bygg golden path:en så att den fungerar utan tyst kunskap: kontrakt i repot, kontroller lokalt, felmeddelanden som säger vad man ska göra. Människorna får samma väg på köpet.
Wikin var alltid till för människor som redan visste var de skulle leta. Vägen ska fungera för den som inte gör det.