Hvorfor AI-kodeagenten din mister oversikten over prosjektet (og hvordan du fikser det)

Du kjenner sikkert følelsen. Du jobber med en AI-assistent over flere dager. Første dag går alt knirkefritt – API-et blir satt opp, tester skrives og dokumentasjonen på plass. Neste dag starter du en ny samtale, og agenten har ingen anelse om hva som skjedde i går. Du ender opp med å forklare prosjektstrukturen på nytt, gang etter gang.

Problemet handler ikke først og fremst om hvor mye kontekst modellen kan ta inn. Det handler om at prosjektinformasjonen ligger på feil sted.

Hvorfor chat-historikk ikke holder som prosjektminne

Chat fungerer fint til å snakke med en AI, men det er en dårlig database. Når beslutninger forsvinner opp i samtalen, må du lete gjennom tusenvis av tokens for å finne dem igjen. Det finnes heller ingen entydig kilde til hva som egentlig gjelder akkurat nå.

Nye samtaler starter alltid fra bunnen av. Ulike agenter tar motstridende valg fordi ingen holder oversikt over hva som allerede er bestemt. Resultatet er at agenten sliter med å forstå hva du bygger og hvorfor.

En enkel løsning som faktisk fungerer

I stedet for å la alt ligge i chat-vinduet, kan du lagre prosjektstatus som vanlige filer i repoet. Ikke som en wiki eller et eksternt verktøy – bare strukturerte Markdown-filer med litt metadata øverst.

En slik fil kan inneholde en tittel, status (aktiv, ferdig, arkivert), hvilken type post det er (spec, logg, beslutning), og koblinger til andre filer. Selve innholdet ligger under. Formatet er bevisst enkelt, uten spesial-syntaks eller eksterne databaser.

CLI-verktøyet som gjør jobben

Med et lite kommandolinjeverktøy kan du opprette, arkivere, flytte og validere disse filene. Verktøyet sørger for at relasjoner oppdateres automatisk og at en indeks genereres uten manuell jobb.

Når agenten trenger å vite hva som foregår, gir du den en kommando i stedet for å be den lese gjennom hele chat-historikken. Den kan spørre etter aktive specs, se hva som er blokkert, eller sjekke at alt henger sammen. Endringer skjer også gjennom kommandoer, ikke ved at agenten redigerer filer direkte.

Frisk agent, kjent tilstand

Når en ny samtale starter, kjører agenten først en liste-kommando for å få oversikt. Den ser hvilke milepæler som er ferdige, hva som er i gang, og hva som ble forsøkt i forrige økt. Chat-historikken blir plutselig uviktig – tilstanden ligger i repoet der den hører hjemme.

Når dette betyr noe

Dette er nyttig hvis du jobber med AI over flere dager, kjører agenter som skal fortsette uten full kontekst, eller jobber i team der alle må vite hva som er bestemt. Det erstatter ikke Git eller tester, men det gjør AI-assistert utvikling sammenhengende over tid.

Det beste med løsningen er hvor lite dramatisk den er. Du bruker verktøy du allerede kjenner – Markdown, Git og CLI – bare på en ny måte.