AnswersPublished14 sources
Giv AI-agenten klare regler – uden at gøre projektmappen til et arkiv
Organisér efter informationens ansvar og livscyklus – ikke efter én universel mappestruktur. Bevar færdige planers status og sporbarhed, også når de ikke længere skal vises som aktuelle.
Udgivet afBilleder genereret med GPT Image 2
Research answer
Key takeaways
- Organisér efter informationens ansvar og livscyklus – ikke efter én universel mappestruktur.
- Bevar færdige planers status og sporbarhed, også når de ikke længere skal vises som aktuelle.
- Se indlæsning på tværs af AI værktøjer som noget, der skal testes, ikke som noget en fælles fil automatisk garanterer.
- Hold instruktioner, opgavestatus og dokumentation for udført arbejde tydeligt adskilt.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/r4PONBDeiygm6rkyQ1INhTEQyyP2/images/C7AB80FC077AFBDCC74B/E16B680C3CF0FB35FFC8.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":"attempt completion","arguments":{"result":"建议统一“信息职责、权威来源、生命周期和读取契约”，而不是强制所有项目采用同一套目录。BMAD 的任务治理与蓝图的知识分层可以结合，但计划保留、跨宿主加载、测试隔离和文档预算必须分别定义，不能由目录名称代替。\n\n 保留蓝图的职责分离，调整其绝对化规则。\n 借鉴 BMAD 的稳定身份、渐进细化、来源追溯和历史. Topic tags: general web, ai safety, openai, chatgpt, llm. 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
Når AI-agenter arbejder i et softwareprojekt, er det fristende at lede efter den perfekte mappestruktur: én fil med regler, en mappe med planer og et arkiv til resten. Men struktur alene afgør ikke, om agenten finder de rigtige oplysninger, om teamet kan følge beslutningerne, eller om historiske planer bliver forvekslet med aktuelle opgaver.
Et bedre udgangspunkt er at fastlægge, hvem der har ansvaret for hver oplysning, hvor den autoritative version findes, hvor længe den skal gemmes, og hvordan agenten forventes at finde den.
Det nyttige ved BMAD: ejerskab, identitet og historik
Den lokale BMAD-gennemgang beskriver et system, hvor standardmateriale holdes adskilt fra teamets og den enkeltes tilpasninger. Tanken er at gemme målrettede ændringer frem for at kopiere hele standardgrundlaget og risikere at skærme sig fra senere opdateringer.
Arbejdet organiseres desuden omkring opgaver og deres tilhørende planer, designmateriale og evalueringer. Detaljer kan føjes til gradvist, efterhånden som en opgave bliver konkret. Dermed behøver man ikke udarbejde store mængder detaljeret materiale, før der er brug for det.
Et vigtigt princip er at bevare afsluttede planer som dokumentation for status, version, arbejde og gennemgang. De behøver ikke være en del af agentens daglige læsning, men hvis de slettes eller overskrives, kan sporbarheden forsvinde – og en afsluttet opgave risikere at fremstå som uafsluttet.
Kort sagt er den overførbare idé ikke en bestemt mappestruktur, men at hvert dokument har en ejer, hver vigtig oplysning har en autoritativ kilde, og afsluttet arbejde efterlader dokumentation.
Én løsning passer ikke til alle projekter
Et projekt med én udvikler og få opgaver kan klare sig med et enkelt aktuelt fokus og dokumentation, der læses efter behov. Men den aktuelle oversigt bør pege på opgavehistorikken frem for at overskrive den eneste registrering af beslutninger og status.
I teams med samtidige opgaver eller flere repositories er stabile opgave-id’er og særskilte planer ofte mere hensigtsmæssige. En “aktiv plan” kan være det, én arbejdssession fokuserer på – den behøver ikke være den eneste plan, hele teamet må have.
Et projekt, der bruger en indbygget agentfunktion, kan have brug for få, tydelige regler og en præcis vej til relevant dokumentation. Det er ikke ensbetydende med, at projektet skal indføre et helt metodeframework. Omvendt bør særlige funktioner som automatisk kontrol eller arkivering ikke beskrives som eksisterende, medmindre de faktisk er implementeret.
Fem regler, der er værd at gentænke
1. Overskriv ikke historikken, når en opgave er færdig. Lav i stedet en kort, aktuel oversigt, mens den oprindelige plan bevares med status og henvisninger til dokumentation.
2. Antag ikke, at én fælles instruktion indlæses ens overalt. Værktøjer kan genkende forskellige filnavne og have forskellige regler for, hvornår og hvordan vejledninger indlæses. Codex beskriver for eksempel AGENTS.md som en fil, værktøjet genkender, mens de øvrige filer i det viste workflow er anbefalede konventioner, der kan tilpasses 6. Behandl derfor kompatibilitet som en egenskab, der skal kontrolleres i hvert værktøj.
3. Brug ikke en fast grænse for antal linjer som garanti mod fejl. En kort fil kan stadig være uklar, mens en længere opgaveplan kan være nødvendig ved komplekst arbejde. Se i stedet på, hvad agenten faktisk får indlæst, om oplysninger gentages, og om opsplitning gør nødvendige sammenhænge sværere at finde.
4. Skeln mellem testmateriale og testresultater. Faste, anonymiserede testdata, der kan genskabes, er noget andet end output fra en enkelt kørsel. Beskriv også, om en test er enhedstest, integrationstest, end-to-end-test eller en kontrol i et reelt miljø – og hvilke sideeffekter den kan have.
5. Brug ikke en ignoreret mappe som erstatning for et historisk arkiv. At en mappe ikke indgår i Git, at agenten normalt ikke læser den, og at agenten ikke må tilgå den, er tre forskellige regler. Hvis historik skal kunne findes på tværs af maskiner, skal opbevaring og adgang være gennemtænkt særskilt.
Hvad Ralph-arbejdsgange kan lære os
Geoffrey Huntley beskriver Ralph som en arbejdsgang, hvor en proces løser én opgave ad gangen, og fremhæver betydningen af at give hver runde et afgrænset mål 14. En guide under hans navn viser også, hvordan krav kan opdeles efter emne, mens
AGENTS.md bruges til praktiske erfaringer om bygning og test af projektet 11.
Det peger på en brugbar kombination: små, tydelige opgaver, relevante krav, begrænset kontekst og feedback fra faktiske kontroller. Det er ikke dokumentation for, at alle projekter bør følge den samme struktur.
Codex’ eksempel på planer til større opgaver viser samtidig, at korte, vedvarende instruktioner godt kan suppleres med en grundig plan, når arbejdet kræver det 5. Reglerne, agenten altid skal have, behøver altså ikke indeholde alle detaljer fra hver opgave.
Ti principper for projektviden til AI-agenter
- Klassificér efter oplysningens rolle. Skeln mellem politik, verificerede fakta, forslag, opgavestatus, dokumentation og foreløbige noter. En tekst bliver ikke automatisk sand, fordi et menneske har skrevet den – eller kortvarig, fordi den er genereret af et værktøj.
- Udpeg én redigerbar autoritativ kilde for hver vigtig oplysning. Oversigter må gerne gengive oplysninger, men bør vise, hvor de kommer fra, og hvornår de ikke længere gælder.
- Gem den viden, som kildekoden ikke kan fortælle. Det kan være hensigter, fravalg, eksterne begrænsninger eller ansvar på tværs af komponenter. En scanning af kode kan vise struktur, men beviser ikke alene, hvorfor en beslutning blev truffet.
- Lad startfilen sætte rammer og vise vej. Den bør ikke forsøge at rumme hele projektets vidensbase. Brug konkrete signaler, som opgavetype, grænseflade eller berørte filer, til at angive, hvad der skal læses.
- Skeln mellem krav, status og bevis. Krav beskriver, hvad der skal være opfyldt; status beskriver, hvor arbejdet står; dokumentation viser, hvorfor man mener, at kravet er opfyldt.
- Bevar det, der skal til for at genoptage arbejdet. Ved komprimering skal uløste opgaver, blokeringer, afhængigheder, tilladelser og henvisninger til dokumentation stadig kunne findes.
- Gør historik sporbar og gældende regler tydelige. Ældre beslutninger kan erstattes, men forbindelsen til begrundelsen bør bevares. Aktuelle retningslinjer behøver ikke gentage hele historikken.
- Hold testkilder adskilt fra testoutput. Følg projektets eksisterende praksis for testkode, og håndtér genererede resultater efter størrelse, følsomhed og opbevaringstid.
- Lad værktøjer håndhæve regler, når det er muligt. Formatering og andre entydige krav kan kontrolleres mekanisk. En regel, der flyttes til en fil, ingen læser, er ikke blevet lettere at efterleve.
- Forveksl ikke en mappe med en sikkerhedsgrænse. Dokumentation, kommandoer, netværksadgang, udrulning og arkivering kræver hver sin afklaring af tilladelser.
En fornuftig rækkefølge er derfor at afklare dokumenternes ansvar og autoritet først, teste hvordan de enkelte værktøjer indlæser dem bagefter og først derefter tilpasse oversigter og opbevaring. Der er sjældent grund til at begynde med at flytte hele projektets dokumentation.
Hvad vurderingen ikke viser
Den lokale gennemgang beskriver en BMAD-version som en V7-forhåndsvisning og v6.12 som den stabile linje. Det er en beskrivelse af det undersøgte lokale øjebliksbillede – ikke en påstand om, hvad der er nyeste version i dag.
Vurderingen er rådgivning om organisering, ikke dokumentation for, at løsningen er implementeret eller testet. Den bygger heller ikke på en gennemført kontrol af konkrete indlæsningsegenskaber på tværs af værktøjer. Derfor bør anbefalinger om mappestruktur og kompatibilitet afprøves i det miljø, hvor agenten faktisk skal arbejde.
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 "Giv AI-agenten klare regler – uden at gøre projektmappen til et arkiv"?
Organisér efter informationens ansvar og livscyklus – ikke efter én universel mappestruktur.
What are the key points to validate first?
Organisér efter informationens ansvar og livscyklus – ikke efter én universel mappestruktur. Bevar færdige planers status og sporbarhed, også når de ikke længere skal vises som aktuelle.
What should I do next in practice?
Se indlæsning på tværs af AI værktøjer som noget, der skal testes, ikke som noget en fælles fil automatisk garanterer.
Sources
developers.openai.comdevelopers.openai.com › cookbook › examplesdevelopers.openai.com
ghuntley.comRalph Wiggum as a "software engineer" - Geoffrey Huntley
github.comhow-to-ralph-wiggum/README.md at main - GitHub