AnswersPublished9 sources
Porządek w dokumentacji i testach bez utraty regresji
Proponowany podział ma oddzielić nawigację po projekcie, aktualne specyfikacje, decyzje architektoniczne i plany wdrożenia. Trwałe testy regresyjne mają pozostać częścią projektu; tymczasowe próby i ich wyniki należy oceniać osobno.
Opublikowane przezObrazy wygenerowane za pomocą GPT Image 2
Research answer
Key takeaways
- Proponowany podział ma oddzielić nawigację po projekcie, aktualne specyfikacje, decyzje architektoniczne i plany wdrożenia.
- Trwałe testy regresyjne mają pozostać częścią projektu; tymczasowe próby i ich wyniki należy oceniać osobno.
- Dokumentacja Cline opisuje tryb Plan jako eksplorację i planowanie, a Act jako realizację — ale nie potwierdza, jak zachowa się każda wersja i konfiguracja hosta.
- Propozycja ma status PROPOSED. Migracji, testów wdrożeniowych ani akceptacji nie przeprowadzono.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/nzMhQ6wEefYpIEeZmiHsW3GCRyJ2/images/4DFBA6B6FA669F650613/F3119D0DD1A7DF6D3258.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":"apply diff","arguments":{"path":" bmad output/analysis/ANALYSIS 20261022 document test governance.md","diff":"<<<<<<< SEARCH\n:start line:66\n \n项目事实文件本轮保持不写入；不将未经本次读取核实的格式或陈旧信息声明登记为事实。文件缺失、权限拒绝、磁盘错误和. Topic tags: general web, ai, workflow, code, python. 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
Porządkowanie repozytorium łatwo pomylić z porządkowaniem projektu. Przeniesienie plików może poprawić czytelność, ale jeśli przy okazji zniknie test regresyjny, jedyny zapis wyniku albo ważne ograniczenie języka, będzie to kosztowna kosmetyka. Przedstawiona propozycja stawia więc na rozdzielenie ról, a nie na samo zmniejszanie liczby katalogów.
Co ma trafiać do którego miejsca?
W proponowanym układzie plik AGENTS.md pełniłby funkcję stabilnego przewodnika: wskazywałby zasady pracy oraz wejścia do budowania i weryfikacji projektu. Nie miałby zastępować dokumentacji projektu ani stawać się dziennikiem kolejnych zadań.
Bieżące wymagania, interfejsy, niezmienniki i kryteria odbioru trafiałyby do specyfikacji domenowych. ADR-y — dokumenty zapisujące decyzje architektoniczne — przechowywałyby ich uzasadnienie, rozważane warianty i konsekwencje. Plan wdrożenia miałby osobno określać zakres, uprawnienia, zależności i kryteria akceptacji. To rozdzielenie ma ułatwić odnalezienie aktualnych zasad bez kasowania historii decyzji.
Testy trwałe, próby tymczasowe i dowody
Kluczowe rozróżnienie dotyczy testów, jednorazowych sprawdzeń i wyników ich uruchomienia. Propozycja nie traktuje ich jako wymiennych rzeczy: testy regresyjne i potrzebne testy międzykomponentowe mają pozostać, jeśli chronią ważne zachowanie. Z kolei tymczasowa sonda nie staje się automatycznie trwałym elementem projektu.
Podobnie należy podchodzić do wyników. Przed usunięciem pliku trzeba sprawdzić, czy nie jest cytowany, czy nie stanowi jedynego dowodu wykonania i czy nie będzie potrzebny do odtworzenia decyzji. Streszczenie przygotowane przez model nie zastępuje oryginalnego wyniku, jeśli to on jest jedynym zachowanym zapisem.
Propozycja uwzględnia też różnice między językami. W Pythonie preferuje ponowne wykorzystanie wspólnego katalogu testów. W Go testy „białoskrzynkowe”, które potrzebują dostępu do nieeksportowanych elementów pakietu, mogą pozostać w tym samym pakiecie. Przenoszenie ich za cenę eksportowania wewnętrznych szczegółów albo osłabiania asercji byłoby złym kompromisem.
Co zmienia praca z agentem AI?
Dokumentacja Cline przedstawia tryby Plan i Act jako rozdzielenie planowania od działania: Plan służy eksploracji i strategii bez zmian w plikach, a Act realizuje plan.2 Propozycja wykorzystuje tę różnicę jako wskazówkę, by analizę oddzielać od osobno zatwierdzonych zapisów. Nie dowodzi to jednak, że każda wersja, integracja czy konfiguracja hosta ma identyczne ograniczenia. Szczegóły środowiska docelowego pozostają do sprawdzenia.
Także reguły i umiejętności narzędzia mają być traktowane osobno. Dokumentacja wskazuje odrębne miejsca ich konfiguracji, ale sam ten fakt nie potwierdza, że konkretne środowisko automatycznie je załaduje lub uruchomi.3 Dlatego propozycja zakłada cienką warstwę adaptacyjną dla hosta zamiast kopiowania całego kontekstu projektu do kilku miejsc.
Inspiracją dla jednej z zasad jest wpis Geoffreya Huntleya o przenoszeniu oprogramowania między językami. Autor opisuje w nim wyprowadzanie specyfikacji domenowych z testów właśnie w kontekście takiej migracji.7 To nie jest jednak podstawa do usuwania codziennych testów regresyjnych — i propozycja wyraźnie odrzuca takie rozszerzenie tej metody.
Nadal tylko propozycja
Rekomendowany kierunek to wspólna nawigacja, jasny podział odpowiedzialności, cienka adaptacja do narzędzi i stopniowe zmiany. Radykalne scalanie dokumentów, mechaniczne przenoszenie testów czy usuwanie jedynych zapisów wyników zostały odrzucone.
Ważne zastrzeżenie: dokument ma status PROPOSED. Powiązany wcześniejszy plan pozostaje zablokowany, a rzeczywistej weryfikacji w docelowym środowisku, migracji ani testów wdrożeniowych nie przeprowadzono. Opisuje więc zasady do dalszego rozważenia — nie gotową zmianę ani potwierdzenie, że nowy układ już działa.
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 "Porządek w dokumentacji i testach bez utraty regresji"?
Proponowany podział ma oddzielić nawigację po projekcie, aktualne specyfikacje, decyzje architektoniczne i plany wdrożenia.
What are the key points to validate first?
Proponowany podział ma oddzielić nawigację po projekcie, aktualne specyfikacje, decyzje architektoniczne i plany wdrożenia. Trwałe testy regresyjne mają pozostać częścią projektu; tymczasowe próby i ich wyniki należy oceniać osobno.
What should I do next in practice?
Dokumentacja Cline opisuje tryb Plan jako eksplorację i planowanie, a Act jako realizację — ale nie potwierdza, jak zachowa się każda wersja i konfiguracja hosta.