AnswersPublished13 sources
Når AI-agenter skal arbejde i et kodeprojekt, er orden i dokumentationen ikke nok
En projektspecifik analyse fra 22. oktober 2026 anbefaler at skelne tydeligere mellem stabile instruktioner, aktuelle planer, historiske dokumenter og tests.
Udgivet afBilleder genereret med GPT Image 2
Research answer
Key takeaways
- En projektspecifik analyse fra 22. oktober 2026 anbefaler at skelne tydeligere mellem stabile instruktioner, aktuelle planer, historiske dokumenter og tests.
- Gennemgangen fandt, at en ældre opgave stadig var blokeret, at den tilhørende arkitekturbeslutning fortsat var et forslag, og at den virkelige værtsafprøvning ikke var afsluttet.
- Anbefalingen er en fælles projektindgang med tynde tilpasninger til værktøjer som Cline og Roo – ikke en stor, risikabel flytning af filer på én gang.
- Tests bør vurderes efter, hvad de beskytter, og hvordan de opdages og køres; et lavere filtal er ikke i sig selv et tegn på forbedring.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/bXqIw3XxkXZyuu9gdo7NkRTsoKM2/images/96A3E3DABB4B22049019/9A075E9F648E3535ABBA.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"write to file","arguments":{"path":" bmad output/analysis/ANALYSIS 20261022 document test governance.md","content":" 文档、测试与跨宿主入口治理：旧任务对账及新方案裁决\n\n 日期：2026 10 22。\n 交付性质：分析与治理提案；不是实施、冻结、归档或宿主验收回执。\n 旧契. Topic tags: general web, llm, agents, ai, automation. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
Det handler ikke bare om at rydde op
Når et kodeprojekt vokser, kan instruktioner, beslutningsnotater, aktive planer, testfiler og midlertidige forsøgsresultater ende side om side. Det kan gøre det sværere for både udviklere og AI-agenter at se, hvad der gælder nu, hvad der blot er historik, og hvilke kontroller der stadig mangler.
En analyse dateret 22. oktober 2026 undersøger problemet i et konkret V4-projekt. Dens hovedpointe er ikke, at filer skal slettes eller samles for enhver pris. I stedet anbefaler den at adskille dokumenternes formål og ændre strukturen gradvist, mens eksisterende tests, beslutninger og dokumentation bevares.
Det er en vigtig forskel: færre mapper er ikke automatisk lig med bedre styring. Hvis en flytning bryder referencer, får tests til at forsvinde fra værktøjets søgning eller fjerner den eneste originale testkvittering, er oprydningen blevet et nyt problem.
Den gamle opgave var ikke færdig
Gennemgangen konkluderede, at en tidligere opgave ikke kunne afsluttes som gennemført. Den seneste status var stadig blokeret, en tilknyttet arkitekturbeslutning stod fortsat som et forslag, og afprøvningen i den faktiske værtsapplikation var ikke afsluttet.
Nogle lokale kontroller var omtalt i historiske opsummeringer, men analysen havde ikke de oprindelige kørselskvitteringer. Derfor kunne den ikke behandle disse opsummeringer som ny, fuldt efterprøvelig dokumentation. Det betyder ikke, at kontrollerne aldrig blev kørt; det betyder, at de tilgængelige oplysninger ikke var nok til at bekræfte dem på ny.
Analysens praktiske konklusion var at bevare de åbne punkter og lade den ældre opgave forblive uafsluttet. En arkivering eller en ny mappeplacering må ikke få manglende godkendelser til at se ud, som om de var på plads.
Én indgang – men ikke én stor dokumentbunke
Den foreslåede retning er en stabil, fælles projektindgang, som peger videre til de relevante regler, planer, beslutninger og tests. Indgangen bør være kort og vedligeholdes som autoritativ navigation, ikke som en kopi af alle projektets fakta og historik.
I modellen får de forskellige materialer hver deres rolle:
- Projektindgangen samler stabile instruktioner og peger på de rigtige ressourcer.
- Specifikationer beskriver aktuelle krav, grænseflader, invariants og acceptkriterier.
- Arkitekturbeslutninger forklarer vigtige valg og deres status.
- Den aktive plan er den ene gældende kontrakt for igangværende arbejde.
- Historiske planer og analyser bevares som historik, men indlæses ikke automatisk som aktuelle instruktioner.
- Tests bliver i projektets teststruktur, hvor de fortsat kan findes og køres.
- Midlertidige forsøg holdes adskilt fra de kontroller, projektet skal kunne gentage.
Det er et forslag til dette projekt – ikke en universel standard for, hvordan alle kodebaser skal indrettes. Analysen anbefaler, at en eventuel flytning først begynder, når de eksisterende stier, henvisninger, testopdagelse og distributionsregler er forstået.
Tests skal vurderes efter deres funktion
En test med et sagsnummer i filnavnet er ikke dermed værdiløs, og det er heller ikke et krav, at hver kildefil skal have præcis én testfil. Det relevante spørgsmål er, om testen beskytter en fejl, en kontrakt eller en vigtig grænse i systemet – og om den stadig bliver fundet og kørt efter en ændring.
Det gælder også sprog med særlige testbegrænsninger. I Go kan en test, der skal tilgå ikke-eksporterede funktioner eller felter, være nødt til at blive i samme pakke. En flytning alene for at få en pænere mappestruktur kan derfor gøre testen umulig eller føre til, at interne detaljer eksponeres unødigt.
Analysen skelner desuden mellem varige regressionstests og midlertidige sonderinger. En midlertidig undersøgelse kan godt undlades i den permanente testpakke, men hvis den afslører noget vigtigt, bør det enten omsættes til en reproducerbar kontrol eller bevares som dokumentation. Originale kørselsresultater må heller ikke forveksles med tests: en opsummering forklarer resultatet, men erstatter ikke nødvendigvis den oprindelige kvittering.
Feedback hjælper kun, hvis den passer til projektet
Tests, typekontrol, linting og builds kan fungere som automatisk kvalitetsfeedback – ofte omtalt som backpressure. Geoffrey Huntleys materiale beskriver, hvordan sådanne kontroller kan afvise uønskede ændringer, og hvorfor instruktioner bør angive de konkrete kommandoer, der gælder for det enkelte projekt. 6
Det er nyttigt som metode, men det beviser ikke, at et bestemt projekt allerede har de rigtige kontroller, eller at de virker efter en migrering. Den konkrete analyse anbefaler derfor at kontrollere både testernes indhold og deres faktiske opdagelse og afvikling, når stier eller regler ændres.
Huntley beskriver også at komprimere tests til specifikationer som led i portering af software mellem programmeringssprog. 11 Det er en særlig metode til sprogskifte – ikke en generel begrundelse for at fjerne projektets daglige regressionstests.
Plan og Act er ikke det samme som godkendelse
Cline beskriver Plan-tilstanden som et sted til at undersøge og planlægge uden at ændre filer, mens Act udfører planen. 2 Det er en nyttig skelnen mellem forberedelse og handling, men den fortæller ikke alene, hvilke rettigheder en bestemt installeret version faktisk håndhæver, eller hvilke regler og færdigheder den automatisk indlæser.
Derfor anbefaler analysen at behandle værtsintegration som noget, der skal afprøves særskilt. Først skal man kende den konkrete værktøjsversion, dens regler og dens tilladelser. Et klik på Act er heller ikke i sig selv en godkendelse af enhver filflytning, installation eller ændring: tilladelsen skal passe til den konkrete opgave og dens omfang.
Hvis en integration ikke kan bekræftes, er den forsigtige løsning at bevare den eksisterende arbejdsgang og bruge eksplicitte henvisninger – ikke at antage, at en fil på disken automatisk er blevet indlæst af værktøjet.
Trinvis migrering – og mulighed for at stoppe
Forslaget opdeler arbejdet i faser. Først skal den gamle aktive plan bevares fuldstændigt og dens henvisninger gennemgås. Derefter kan regler, skabeloner og kontroller tilpasses. Først senere kan værktøjsintegration og eventuelle dokument- eller testflytninger vurderes særskilt.
For hver flytning bør man kende kilden, målet, ejerskabet, henvisningerne og den måde, arbejdet kan gendannes på. Hvis kilden ændrer sig undervejs, en unik kvittering ikke kan findes, eller værktøjets indlæsning ikke kan bekræftes, er det en grund til at stoppe eller vende tilbage – ikke til at presse planen igennem.
Det overordnede princip er enkelt: Organisering skal gøre projektet lettere at forstå uden at gøre dets beviser, tests eller sikkerhedsgrænser sværere at efterprøve. I det analyserede projekt var den anbefalede retning derfor en fælles indgang og tydeligere ansvarsfordeling, men først efter at den uafsluttede opgave var bevaret korrekt og det nødvendige arbejde var godkendt.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Når AI-agenter skal arbejde i et kodeprojekt, er orden i dokumentationen ikke nok"?
En projektspecifik analyse fra 22. oktober 2026 anbefaler at skelne tydeligere mellem stabile instruktioner, aktuelle planer, historiske dokumenter og tests.
What are the key points to validate first?
En projektspecifik analyse fra 22. oktober 2026 anbefaler at skelne tydeligere mellem stabile instruktioner, aktuelle planer, historiske dokumenter og tests. Gennemgangen fandt, at en ældre opgave stadig var blokeret, at den tilhørende arkitekturbeslutning fortsat var et forslag, og at den virkelige værtsafprøvning ikke var afsluttet.
What should I do next in practice?
Anbefalingen er en fælles projektindgang med tynde tilpasninger til værktøjer som Cline og Roo – ikke en stor, risikabel flytning af filer på én gang.