AnswersPublished13 sources
Mindre skräp i V4 – utan att tappa viktiga tester
Overalls beskriver både tillfälliga miljöer för kodagentuppgifter och bestående utvecklingsmaskiner. V4 har redan regler för långsiktiga tester och dokumentens olika roller, men behöver tydligare villkor för vad som ska sparas, checkas in och distribueras.
Publicerad avBilder genererade med GPT Image 2
Research answer
Key takeaways
- Overalls beskriver både tillfälliga miljöer för kodagentuppgifter och bestående utvecklingsmaskiner.
- V4 har redan regler för långsiktiga tester och dokumentens olika roller, men behöver tydligare villkor för vad som ska sparas, checkas in och distribueras.
- Skilj mellan tester som ska leva vidare och tillfälliga kontroller. Styr sedan separat vad som hamnar i Git och i en leverans.
- Låt dokumentationens syfte avgöra var den hör hemma. Färre filer är inte automatiskt bättre om viktig kontext eller bevis går förlorade.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/Ct73VtXRvYVtxLOrIWogs8h8njx2/images/14A07FDFEAF32EEE32FC/0F2CDBA675F3E1798D02.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":"这两个痛点应该纳入 V4 的“产物背压”，但治理目标应是减少无价值产物、隔离临时材料、控制提交与分发，而不是取消长期测试或把所有文档合并。前面回答中的部分来源编号没有对应真实检索证据，相关归因撤回；以下仅依据本次真实检索和已经返回的仓库读取结果。\n\n 1.. Topic tags: general web, llm, agents, ai, code. 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 with fake numbers, clickbait thumbna
Vad Overalls faktiskt verkar erbjuda
Systemet du syftar på är troligen Overalls. I en artikel skriver Geoffrey Huntley att projektet tidigare hette loom och beskriver hur det används för att skicka kodagentuppgifter till tillfälliga Firecracker-virtuella maskiner.10
Projektets egen beskrivning handlar om en plattform för utvecklingsmaskiner och AI-agenter där varje maskin är en bestående Firecracker-mikro-VM.12 Det är två olika beskrivningar av miljöer och användning. Underlaget räcker inte för att slå fast exakt hur deras livscykler hänger ihop – och visar inte att Overalls automatiskt städar testfiler, reglerar dokumentmappar eller hindrar material från att följa med i en leverans.
Slutsats: det går att hämta inspiration från idén att isolera kodagenters arbetsmiljö, men det är inte samma sak som regler för teststruktur, Git eller dokumenthantering.
V4 har redan struktur – men saknar enhetliga livscykelregler
Enligt den tillgängliga genomgången av repot finns redan flera relevanta ramar:
- Långsiktiga tester hanteras samlat.
.github/workflows/ci.ymlsamlar bland annat kontraktstester och senare även kontroller för bevarande av tillgångar och distribution. Att ta bort testfiler utan vidare kan därför bryta befintlig verifiering. Att en CI-kontroll finns konfigurerad betyder däremot inte att den har körts eller godkänts i den här genomgången. - Dokumentationen har olika roller.
bmad-core.mdskiljer mellan analys, ADR:er, planer, specifikationer och faktaunderlag. Den anger också att man inte ska skapa en ny sökväg på eget initiativ när det är oklart var något hör hemma. - Reglerna för tillfälliga filer är splittrade.
.gitignoretäcker vissa körningskataloger, sandlådor och temporära filer, men ger inte en komplett bild av när utkast och verifieringsunderlag ska sparas. - Distributionsgränsen kan behöva bli tydligare. Funktionen
collect_source()samlar vanliga filer rekursivt från källmaterialet för paketet och mappar dem till en plugin-katalog. En kontroll av obligatoriska filer är inte samma sak som en tillåtelselista för allt som får distribueras. Om tillfälligt material hamnar bland paketets källfiler finns alltså en risk att det följer med – men underlaget visar inte att det redan har hänt.
Det rimliga nästa steget är därför inte att skapa ett nytt parallellt katalogsystem. V4 behöver främst tydliggöra om en fil ska skapas, sparas, checkas in och distribueras – och när den kan tas bort.
Testfiler: behåll regressionstester, isolera tillfälliga kontroller
Många tester och en rörig källkodsvy är två olika problem. Lösningen bör inte vara att sortera bort filer enbart för att de ser ut som tester.
| Typ av material | Lämplig hemvist | Förslag för Git och distribution |
|---|---|---|
| Enhetstester, regressionstester och kontraktstester som behövs över tid | Projektets befintliga teststruktur | Vanligen versionshanterade; distribution avgörs av vad leveransen ska innehålla |
| Engångsskript för felsökning eller tillfällig kontroll | En godkänd temporär arbetsyta | Som utgångspunkt varken incheckade eller distribuerade |
| Loggar, täckningsdata och genererade rapporter | Plats för körnings- och verifieringsunderlag | Sparas när det krävs för granskning eller godkännande, inte automatiskt i källkodshistoriken |
| Viktiga motexempel och reproducerbara testfixturer | Projektets långsiktiga testunderlag efter granskning | Bevaras om de skyddar mot återkommande fel |
Tre enkla frågor kan fungera som grindar:
- Innan du skapar filen: Går det att utöka ett befintligt test? Täcker den nya filen ett eget beteende, eller upprepar den bara en kontroll?
- Innan du checkar in: Är detta en långsiktig del av projektet? Innehåller det lokala sökvägar, hemligheter eller engångsdebuggning?
- Innan du distribuerar: Ingår filen i det som användaren faktiskt behöver? Att något finns i repot betyder inte automatiskt att det ska installeras.
Teststrukturen behöver också passa språket. Go skiljer i sin verktygsdokumentation mellan testfiler i själva paketet och testfiler i ett externt testpaket.13 Därför går det inte att pressa alla språk in i samma katalogregel. En gemensam testkatalog kan vara värd att överväga för Python, medan Go kräver att man först kontrollerar paketåtkomst, testupptäckt och beroenden.
Börja med att precisera problemet: Ska testerna inte följa med till användarna? Då är det distributionsreglerna som behöver ses över. Är det tillfälliga skript som inte ska checkas in? Då handlar det om versionshantering. Störs du bara av hur källkoden visas? Då kan en annan placering eller vy räcka.
Dokumentation: håll isär syften, inte varje arbetsmoment
V4 kan använda sina befintliga dokumentroller i stället för att skapa en ny fil för varje diskussion:
- Analys från en enskild arbetsomgång: lämnas som svar i sessionen om det inte finns skäl att spara den.
analysis/: för godkänd analys, belägg, jämförelser och osäkerheter – inte som en allmän låda för utkast.adrs/: för betydelsefulla beslut och motiveringar, inte för att kopiera hela analysen eller en aktivitetslogg.pending_implementation_plan.md: för mål, mandat, steg, beroenden och acceptanskriterier. Lägg inte på löpande loggar, och skriv inte över en redan pågående plan med ett förslag.scratch/: kan utvärderas som gemensam temporär yta, men katalogen i sig ger inte tillstånd att skriva, köra eller radera filer.verification/: för nödvändiga verifieringsbelägg. Bestäm separat vad som ska checkas in och hur länge det ska sparas.
Även driftsmaterial kan sorteras efter funktion: en bestående driftguide är dokumentation, medan kvittot från en enskild driftsättning är körningsunderlag. Det behövs inte automatiskt en ny mapp bara för att båda handlar om drift.
För att undvika att enskilda dokument växer utan kontroll:
- Dela upp efter ämne eller beslut, inte efter varje samtalsrunda.
- Låt analys, beslut och planering fylla olika funktioner och hänvisa mellan dem i stället för att kopiera samma innehåll.
- Läs bara in den aktuella överenskommelsen och relevant underlag när arbetet tas över; mata inte rutinmässigt in hela historiken igen.
- Markera tydligt vad som är belagt, vad som är en tolkning och vad som återstår att kontrollera. En sammanfattning får inte förvandla ett antagande till ett faktum.
Påståendet att färre filer i sig skulle minska hallucinationer är ännu en hypotes, inte ett belagt orsakssamband här. Börja med att minska dubblerat, inaktuellt och irrelevant sammanhang i stället för att införa godtyckliga gränser för antal rader eller lova en viss effekt.
En liten regel med stor räckvidd
V4 kan införa en gemensam princip: Varje nytt material ska ha ett tydligt syfte, en hemvist och ett beslut om huruvida det behöver sparas, checkas in eller distribueras – samt villkor för bevarande eller rensning. Återanvänd befintliga tillgångar när det går. Kräv inte en ny fil för varje verifiering eller ett nytt dokument för varje analys.
Om förslaget senare får klartecken att genomföras bör acceptanskriterierna bland annat säkerställa att:
- långsiktiga tester fortfarande upptäcks av relevanta CI-kontroller;
- viktiga regressionstester inte försvinner vid en flytt;
- tillfälliga filer inte hamnar i onödiga incheckningar eller installationer;
- dokumentlänkar fungerar och pågående arbete eller historiska belägg inte raderas av misstag;
- rensning har ett avgränsat omfång och tydliga bevaranderegler – och inte framställs som en säkerhetsisolering på körningsnivå.
Det här är en analys och ett villkorat förslag, inte ett genomförande. Inga filer har ändrats, tester körts eller material rensats i den här genomgången. Den efterfrågade bilden och det angivna X-inlägget gick inte att verifiera, så Overalls konkreta lösning på just test- och dokumenthantering är fortfarande okänd.
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 "Mindre skräp i V4 – utan att tappa viktiga tester"?
Overalls beskriver både tillfälliga miljöer för kodagentuppgifter och bestående utvecklingsmaskiner.
What are the key points to validate first?
Overalls beskriver både tillfälliga miljöer för kodagentuppgifter och bestående utvecklingsmaskiner. V4 har redan regler för långsiktiga tester och dokumentens olika roller, men behöver tydligare villkor för vad som ska sparas, checkas in och distribueras.
What should I do next in practice?
Skilj mellan tester som ska leva vidare och tillfälliga kontroller. Styr sedan separat vad som hamnar i Git och i en leverans.