← Alla artiklar Metodologi

Röst på gammal kod: prata bort teknikskulden

Röst på gammal kod: prata bort teknikskulden

Röst på gammal kod: prata bort teknikskulden

De flesta team riktar AI mot greenfield — nya features, färska repon, snabba prototyper. Den svåraste skulden sitter i andra riktningen: i legacy-systemen som faktiskt driver verksamheten och som ingen vill röra. De fungerar, de fakturerar, och dokumentationen är antingen inaktuell eller obefintlig. Alla behandlar dem som en svart låda med en skylt på: rör inte.

Det finns ett sätt att använda AI mot de systemen som nästan ingen provar, och det är det minst glamorösa i verktygslådan — låt en utvecklare prata sig igenom koden, högt, under inspelning.

Metoden

Tre steg, och inget av dem skriver om en rad.

1. Spela in genomgången. Sätt utvecklaren som kan systemet framför en inspelning och låt hen berätta om det. Vad gör det här? Var går det sönder? Vad kontrollerar du alltid innan du ändrar det? Vilket antagande ligger begravt i den här funktionen som ingen kommer ihåg? Utvecklare är inte vana att prata om sin kod — de skriver den. Efter en minut lossnar det.

2. Kör transkriptet mot kodbasen. Det är här det blir användbart. Transkriptet blir strukturerad text, och du ställer den bredvid den faktiska koden. Modellen lyfter fram diffarna — där det utvecklaren sa att koden gör skiljer sig från vad den faktiskt gör. Den lyfter fram dokumentationsluckorna, eftersom det nu äntligen finns en beskrivning att jämföra mot. Den lyfter fram de i förbifarten uttalade antaganden som hela systemet vilar på.

3. Producera artefakterna. Dokumentation som inte fanns. En karta över var skulden faktiskt bor. En lista över de ställen där utvecklarens mentala modell och koden har glidit isär — vilket är precis där nästa incident gömmer sig.

Du har inte refaktorerat någonting. Men du har flyttat en verklig bit teknikskuld från ingen-vet till någon-vet — ofta runt en femtedel av den — genom att använda AI i den gamla processen, inte i ett nytt bygge.

Varför röst, specifikt

Kunskapen om ett legacy-system finns sällan i repot. Den finns i huvudet på den som har levt med det: felsökningen klockan tre på natten, gångerna det gick sönder, de tysta reglerna om vad man inte rör. Inget av det är incheckat någonstans.

En språkmodell kan bara arbeta med det som finns i kontextfönstret. Det enda en legacy-kodbas saknar är precis det som utvecklaren bär runt på. Röst är det enda praktiska sättet att få ut det — tio minuters prat rymmer mer av den verkliga modellen av systemet än någon skriver ner på en vecka.

Linjen du inte korsar

Utvecklaren förblir ägaren av det som är sant. Modellen strukturerar det som sades och pekar på var det skaver mot koden. Utvecklaren avgör vad som faktiskt håller. Det här är inte automatiserad dokumentation som ingen har godkänt — om ingen människa äger den är det inte dokumentation, det är en risk. Modellen lyfter fram; människan validerar. Den disciplinen är icke förhandlingsbar på ett system folk är beroende av.

Det är inte nytt, och det är poängen

Det här fungerade med transkription för flera år sedan. Tekniken var aldrig hindret. Hindret var att någon måste komma på att rikta röstpipelinen bakåt — mot det gamla systemet — i stället för bara framåt mot det nya bygget.

Det är brunt och tråkigt och det demar inte bra. Det är troligen därför skulden fortfarande ligger kvar.


Relaterat: Från röst till strukturerad mötesdokumentation och Produktionsverklighetens gap.