AnswersPublished13 sources
Mniej zbędnych artefaktów, bez wyrzucania testów i wiedzy
Overalls opisuje zarówno tymczasowe środowiska do zadań agentów, jak i trwałe maszyny deweloperskie. V4 ma już zasady dotyczące testów i podziału dokumentów, ale brakuje spójnych reguł cyklu życia tymczasowych materiałów oraz ich dystrybucji.
Opublikowane przezObrazy wygenerowane za pomocą GPT Image 2
Research answer
Key takeaways
- Overalls opisuje zarówno tymczasowe środowiska do zadań agentów, jak i trwałe maszyny deweloperskie.
- V4 ma już zasady dotyczące testów i podziału dokumentów, ale brakuje spójnych reguł cyklu życia tymczasowych materiałów oraz ich dystrybucji.
- Najrozsądniej rozdzielić testy utrwalające regresje od jednorazowej diagnostyki, a dokumenty porządkować według funkcji, nie według kolejnych sesji pracy.
![[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
Overalls: inspiracja, ale nie gotowa recepta na porządek w repozytorium
System, o który chodzi, to najpewniej Overalls. Geoffrey Huntley pisze, że projekt wcześniej nosił nazwę loom i służy m.in. do uruchamiania zadań agentów kodujących w tymczasowych maszynach Firecracker. 10 Z kolei oficjalny opis przedstawia Overalls jako samodzielnie hostowaną platformę dla maszyn deweloperskich i agentów; maszyny mogą być trwałymi mikromaszynami wirtualnymi Firecracker z systemem NixOS, Ubuntu lub Windows.
12
To dwa różne zastosowania: tymczasowe środowisko zadania i trwała maszyna deweloperska. Dostępne opisy nie pokazują, że Overalls automatycznie segreguje pliki testowe, porządkuje katalogi szkiców albo zapobiega rozrostowi dokumentacji. Nie udało się też zweryfikować wskazanego wpisu na X ani jego grafiki. Dlatego wnioski o takich funkcjach byłyby na tym etapie niepotwierdzone.
Można natomiast potraktować izolację środowiska jako użyteczną inspirację. Nie należy jednak mylić jej z zasadami dotyczącymi układu testów, commitów czy dystrybucji plików.
Co już działa w V4, a czego brakuje
Dostępne odczyty repozytorium wskazują, że V4 nie jest pozbawione zasad — problemem jest raczej niepełny opis tego, jak artefakty mają być używane i przechowywane.
- Testy długoterminowe są uwzględnione w CI. W
.github/workflows/ci.yml:60skonfigurowano zbieranie testów kontraktowych, a dalej także testów ochrony zasobów i regresji dystrybucji. Usunięcie takich testów mogłoby naruszyć istniejący zakres weryfikacji. Sama obecność konfiguracji nie dowodzi jednak, że CI przeszło w tej rundzie. - Dokumenty mają określone role.
bmad-suite-v4/rules/bmad-core.md:129rozróżnia m.in. analizę, ADR-y, plany, specyfikacje i bazę faktów. Zasada mówi też, by nie tworzyć nowej ścieżki bez pewności, gdzie dany materiał należy. - Zasady dla materiałów tymczasowych są niepełne.
.gitignoreobejmuje część katalogów roboczych, piaskownic i plików tymczasowych, ale nie określa całościowo, kiedy szkice i dowody weryfikacji należy zachować. Sam wpis w.gitignorenie potwierdza też, jaki jest faktyczny status śledzenia pliku w Git. - Warto doprecyzować granice dystrybucji.
scripts/deployment_source.py:29opisuje funkcjęcollect_source(), która rekurencyjnie zbiera zwykłe pliki ze źródła pakietu i mapuje je do katalogu wtyczki. Kontrola wymaganych plików nie jest tym samym co jawna lista dozwolonych plików. Tymczasowy materiał umieszczony w źródle pakietu mógłby więc trafić do dostarczanego zestawu — to ryzyko wynikające z konfiguracji, a nie potwierdzony przypadek.
Wniosek: zamiast tworzyć kolejny równoległy system katalogów, lepiej dopisać jasne zasady mówiące, czy coś należy utworzyć, commitować, dystrybuować i jak długo przechowywać.
Testy: zachowaj regresje, odseparuj jednorazową diagnostykę
Duża liczba testów i zaśmiecony kod źródłowy to niekoniecznie ten sam problem. Nie warto usuwać plików wyłącznie dlatego, że wyglądają na testowe — część może chronić istotne zachowania.
| Rodzaj materiału | Zalecane miejsce | Zasada dotycząca commitów i dystrybucji |
|---|---|---|
| Testy jednostkowe, regresyjne i kontraktowe utrzymywane na stałe | Istniejący układ testów projektu | Zwykle należą do kontroli wersji; dystrybucja zależy od przeznaczenia pakietu |
| Jednorazowe skrypty diagnostyczne i tymczasowe próby | Zatwierdzony obszar roboczy zadania | Domyślnie bez commita i bez dystrybucji |
| Logi, raporty pokrycia i wygenerowane wyniki | Obszar dowodów uruchomienia | Zachowywać zgodnie z wymaganiami odbioru i retencji; nie dodawać automatycznie do historii źródeł |
| Ważne przypadki brzegowe i odtwarzalne dane testowe | Po przeglądzie — jako trwały zasób testowy | Zachować wartość regresyjną zamiast zostawiać je wyłącznie w katalogu tymczasowym |
Praktyczne mogą być trzy punkty kontrolne:
- Przed utworzeniem: czy można rozszerzyć istniejący test? Czy nowy plik sprawdza odrębne zachowanie, czy tylko powtarza istniejący dowód?
- Przed commitem: czy to trwały zasób projektu? Czy materiał zawiera lokalne ścieżki, dane dostępowe lub jednorazowe poprawki diagnostyczne?
- Przed dystrybucją: czy plik należy do jawnie określonego zakresu dostawy? Sama obecność w repozytorium nie powinna automatycznie oznaczać, że plik trzeba instalować.
Układ musi uwzględniać używany język i narzędzia. Dokumentacja Go rozróżnia pliki testowe należące do pakietu oraz pliki zewnętrznego pakietu testowego, więc nie należy ujednolicać struktury testów wyłącznie dla estetyki. 13 W Pythonie można rozważyć osobny katalog testów; w Go najpierw trzeba sprawdzić widoczność pakietów, wykrywanie testów i zależności.
Warto też nazwać właściwy problem: jeśli testów nie powinien otrzymywać użytkownik instalujący pakiet, trzeba dopracować zakres dystrybucji. Jeśli przeszkadzają tymczasowe skrypty, potrzebne są zasady commitowania. Jeśli problemem jest czytelność repozytorium, można zmienić układ lub sposób prezentacji. To trzy różne kwestie.
Dokumentacja: porządek według funkcji, nie według każdej sesji
Najprościej oprzeć się na istniejącym podziale i unikać tworzenia osobnego pliku po każdej rozmowie czy analizie:
- Wynik sesji — domyślnie może pozostać w odpowiedzi; nie każda analiza wymaga zapisu do repozytorium.
_bmad-output/analysis/— na zatwierdzone analizy, dowody, porównania i nierozstrzygnięte kwestie; nie jako ogólny kosz na szkice._bmad-output/adrs/— na istotne decyzje i ich uzasadnienia, nie na kopię całego raportu ani dziennik wykonania._bmad-output/pending_implementation_plan.md:1— na cel, zakres upoważnienia, etapy, zależności i kryteria odbioru, a nie na stale dopisywany dziennik. Sugestia porządkowa nie upoważnia do nadpisania aktywnego planu._bmad-output/scratch/— można rozważyć jako wspólną przestrzeń tymczasową. Samo jej istnienie nie daje jednak zgody na zapis, czyszczenie ani uruchamianie zawartych tam materiałów._bmad-output/verification/— na niezbędne dowody weryfikacji, z osobno określonym zakresem commitowania i retencji. Nie każdy powtarzalny wynik musi być przechowywany bezterminowo.
Materiały wdrożeniowe warto klasyfikować według zastosowania: trwały poradnik obsługi to dokumentacja utrzymaniowa, a potwierdzenie konkretnego wdrożenia — dowód operacyjny. Nie trzeba tworzyć nowego katalogu tylko dlatego, że w nazwie pliku pojawia się słowo „wdrożenie”. Zmiana ścieżek powinna też zachować działające odwołania i informacje o niedokończonych zadaniach.
Żeby ograniczyć rozrost dokumentów bez utraty kontekstu:
- dziel materiały według odrębnych tematów lub decyzji, a nie kolejnych rund rozmowy;
- rozdziel analizę, decyzję i plan, łącząc je odnośnikami zamiast kopiować całe fragmenty;
- przy przejmowaniu zadania ładuj aktualne zasady i potrzebne wycinki dowodów, nie całą historię;
- w podsumowaniach odróżniaj fakty, wnioski i kwestie do sprawdzenia — skrócenie tekstu nie może zmieniać założenia w fakt.
Teza, że „mniej plików zwiększa skłonność do halucynacji”, pozostaje hipotezą, a nie potwierdzonym związkiem przyczynowym. Rozsądniej najpierw ograniczać duplikaty, nieaktualne materiały i nieistotny kontekst niż narzucać bez uzasadnienia wspólny limit długości dokumentów.
Minimalna zasada dla V4
Każdy nowy artefakt powinien mieć określone: po co powstaje, gdzie należy, czy musi być trwały, czy podlega commitowaniu i dystrybucji oraz kiedy można go usunąć. Warto preferować rozszerzenie istniejącego zasobu zamiast tworzenia następnego pliku. Nie każda weryfikacja wymaga nowego artefaktu, a nie każda analiza — dokumentu.
Jeśli zasady zostaną wdrożone, odbiór powinien sprawdzić, czy długoterminowe testy nadal są wykrywane przez właściwe CI, tymczasowe materiały nie trafiają do niepotrzebnych commitów ani instalacji, a odnośniki, aktywne zadania i istotne dowody pozostają dostępne. Czyszczenie musi mieć określony zakres i warunki retencji; sama separacja katalogów nie jest zabezpieczeniem wykonawczym.
To propozycja oparta na statycznym odczycie repozytorium, a nie raport z wdrożenia. W tej analizie nie zmieniano plików, nie uruchamiano testów, nie usuwano materiałów i nie nadpisywano planu. Konkretne rozwiązania Overalls dla organizacji testów i dokumentacji pozostają niezweryfikowane.
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 "Mniej zbędnych artefaktów, bez wyrzucania testów i wiedzy"?
Overalls opisuje zarówno tymczasowe środowiska do zadań agentów, jak i trwałe maszyny deweloperskie.
What are the key points to validate first?
Overalls opisuje zarówno tymczasowe środowiska do zadań agentów, jak i trwałe maszyny deweloperskie. V4 ma już zasady dotyczące testów i podziału dokumentów, ale brakuje spójnych reguł cyklu życia tymczasowych materiałów oraz ich dystrybucji.
What should I do next in practice?
Najrozsądniej rozdzielić testy utrwalające regresje od jednorazowej diagnostyki, a dokumenty porządkować według funkcji, nie według kolejnych sesji pracy.