Köket där varje beslut sitter på väggen: spårbarhet när Claude bygger åt dig

Sammanfattning

Den som låtit Claude bygga några timmar känner igen läget. Koden fungerar, testerna är gröna, och någonstans längs vägen byttes ett bibliotek, en tabell fick tre nya kolumner och en regel började tolkas annorlunda. Förklaringen fanns i chatten. Chatten är borta.

Anthropic publicerade i augusti The AI-Native SDLC Playbook, ett arbetssätt där varje steg lämnar en fil i repot som nästa steg läser. Jag har gjort om det till en plugin för Claude Code. Det enklaste sättet att förklara vad den gör är ett restaurangkök, där ingen lagar något innan beställningen, menyn och körschemat sitter på väggen.

Köket och rollerna

I ett välskött kök har alla sin plats.

• Värden tar emot beställningen och står för vad gästen får. I ett mjukvaruprojekt är det produktägaren.
• Köksmästaren bestämmer hur köket arbetar och godkänner schemat. Det är du.
• Kocken lagar maten, snabbt och skickligt. Det är Claude.

Kocken är duktig nog att laga nästan vad som helst på egen hand. Därför behöver köket papper på väggen som visar vad som är beställt och varför.

Beställningen: intent.md

Allt börjar med att värden skriver ned beställningen. Här står varför middagen ska hållas, vad den ska åstadkomma och vilka ramar som gäller. Inga rätter nämns än.

I ett mjukvaruprojekt beskriver intent.md problemet, önskat utfall, begränsningar och vilka system som berörs. Claude intervjuar dig för att få fram den och säger ifrån om du börjar beskriva en lösning. Filen gäller när värden har godkänt den.

Menyn och recepten: spec.md

När beställningen är godkänd sätter värden och köksmästaren menyn. Vilka rätter blir det, vad ingår i dem och vilka av kökets regler gäller för kvällen?

I ett mjukvaruprojekt beskriver spec.md hur lösningen ska fungera, med krav och design i samma dokument. Kökets regler motsvarar organisationens policys för säkerhet, varumärke eller tillgänglighet. Claude läser in dem medan specen skrivs, så att en krock syns direkt och inte först när maten redan är på väg ut.

Körschemat: plan.md

Sist gör kocken ett körschema tillsammans med köksmästaren: vad som förbereds när, vad som går in i ugnen och i vilken ordning rätterna går ut. Ingen kniv rör en grönsak förrän köksmästaren har godkänt schemat.

I ett mjukvaruprojekt tas plan.md fram i Claude Codes plan mode, där Claude bara får läsa och fråga. Planen listar vilka filer som ändras, i vilken ordning och hur man ser att det fungerar. Längst ned finns en tom rubrik för avvikelser. Den fylls under kvällen.

Under kvällen

Inget körschema överlever servicen oförändrat. Det som gör köket spårbart är vad som händer när något ändras.

Klockan 16.10 visar det sig att leverantören inte har några enbär. Kocken vill smaksätta skyn med rosmarin i stället. Rätten är fortfarande den som står på menyn, så det räcker att köksmästaren säger ja. Ändringen skrivs in längst ned i körschemat:

När	Avvikelse	Varför	Godkänd av
16.10	Skyn smaksätts med rosmarin i stället för enbär	Leverantören saknade enbär	Köksmästaren

Klockan 19.20 kommer värden in i köket och vill ha en extra förrätt till VIP-bordet. Det ändrar vad gästerna får, och därför går det tillbaka till beställningen. Kocken börjar inte improvisera. Önskemålet blir en ny intent.md som tar ett eget varv genom meny och körschema.

Med pluginen fungerar Claude på samma sätt. När den vill göra något annat än planen säger stannar den, förklarar och väntar på ditt ja. Ryms ändringen i det beställda blir den en rad i plan.md. Ändrar den beställningen föreslår Claude en ny intent. Tre månader senare kan vem som helst läsa varför skyn smakar rosmarin, och vem som sa ja.

Nästa pass

När nästa pass tar över köket behöver ingen återberätta gårdagen. Beställningarna, menyn och körschemat sitter på väggen, med status på varje papper.

Samma sak gäller för Claude. En helt ny session vet ingenting om förra kvällen, men frågan "vad är nästa steg" räcker. Claude läser filerna, ser vilka som är godkända och svarar med läget: beställningen klar, menyn klar, körschemat godkänt, nästa steg att laga. Minnet sitter i köket och följer inte med någon enskild kock.

Så håller köket ordning

Ett arbetssätt på papper glöms bort efter några timmars intensiv service, både av människor och av Claude. Pluginen använder fyra mekanismer för att hålla det levande.

Genomgången före service. Projektets CLAUDE.md läses in varje gång en session börjar, och där står att arbetssättet gäller. Claude börjar därför alltid med att titta på väggen.

Kökets rutiner. Pluginen har en skill per papper: en för beställningen, en för menyn och en för körschemat. Skillen för beställningen intervjuar dig om varför och säger ifrån om du hoppar till rätterna. Skillen för körschemat lagar ingenting förrän schemat är godkänt.

Spisvakten. Små skript, så kallade hooks, körs automatiskt innan Claude gör vissa saker. De stoppar en push direkt till huvudgrenen, försök att ändra reglerna som styr Claude själv och ett "klart" medan testerna är röda. Precis som spisvakten stänger de av plattan oavsett hur säker kocken känner sig.

Värden och köksmästaren. Beställningen, schemat, varje avvikelse och varje leverans till gästerna väntar på ett ja från en människa. Kocken får föreslå, men aldrig godkänna sin egen mat.

Prova själv

Pluginen heter ai-native-sdlc och ligger öppet på GitHub:

claude plugin marketplace add mikaelsjovind/claude-plugins
claude plugin install ai-native-sdlc@mikaelsjovind

Kör /ai-native-sdlc:sdlc-start i ett repo och börja med en liten förändring. Claude intervjuar dig om varför, och den första beställningen hamnar i intent/.

Omslagsbilden är genererad med Google Gemini.