AnswersPublished13 sources
Тимчасові артефакти — окремо, важливі тести — у проєкті
Мета — не прибрати важливі тести й не звести всі документи в один файл, а скоротити зайві артефакти та чітко визначити їхній життєвий цикл. Overalls описує ізольовані середовища для роботи агентів, але наявні джерела не підтверджують, що він автоматично впорядковує тестові файли чи документацію.
ОпублікувавЗображення створено за допомогою GPT Image 2
Research answer
Key takeaways
- Мета — не прибрати важливі тести й не звести всі документи в один файл, а скоротити зайві артефакти та чітко визначити їхній життєвий цикл.
- Overalls описує ізольовані середовища для роботи агентів, але наявні джерела не підтверджують, що він автоматично впорядковує тестові файли чи документацію.
- У V4 вже є правила для тестів і документів; найбільше бракує узгоджених вимог до тимчасових матеріалів, комітів і дистрибуції.
- Перш ніж додавати або прибирати файли, слід визначити, для чого вони потрібні, де мають зберігатися та як довго їх треба утримувати.
![[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
Ці два проблемні місця варто включити до V4 як частину політики керування артефактами. Але мета — не позбутися довготривалих тестів і не зібрати всю документацію в одному файлі. Потрібно зменшити кількість матеріалів без тривалої цінності, ізолювати тимчасові напрацювання та визначити, що потрапляє до коміту й дистрибутива.
У попередній відповіді частина посилань на джерела не мала підтвердження в результатах пошуку, тож відповідні твердження відкликаються. Нижче наведено висновки на основі цього пошуку й отриманих результатів читання репозиторію.
Що саме вирішує Overalls
Система, про яку йдеться, імовірно, — Overalls. У статті Хантлі зазначено, що раніше проєкт мав назву loom, а серед його призначень — запуск завдань для агентів-кодерів у тимчасових віртуальних машинах Firecracker.10
- В офіційному описі Overalls представлено як платформу для власних середовищ розробки та AI-агентів. Кожна машина — це постійна мікровіртуальна машина Firecracker з NixOS.
12
- Тимчасові середовища завдань і постійні машини розробки описані окремо. Наявних матеріалів недостатньо, щоб пояснити весь життєвий цикл обох — і, зокрема, стверджувати, що після завершення завдання репозиторій автоматично очищується.
10
- Знайти допис у X, про який ідеться, і отримати його зображення не вдалося. Чи автоматизує Overalls ізоляцію тестових файлів, упорядкування чернеток і стримування розростання документації — доказів недостатньо.
Отже, варто розглядати ізоляцію середовищ як напрям для наслідування, але не ототожнювати її з правилами розміщення тестів, комітів або документації. Конкретних висновків про робочий процес тестування чи методи скорочення документації в Overalls ці матеріали не підтверджують.
У V4 уже є правила — бракує узгодженої політики життєвого циклу
Статичний огляд репозиторію дає змогу зробити такі висновки:
- Довготривалі тести вже зібрані в керовану структуру. У ci.yml явно передбачено збирання контрактних тестів; далі також збираються тести захисту артефактів і регресійні перевірки дистрибуції. Бездумне видалення таких файлів може порушити наявний процес перевірки. Водночас сама наявність конфігурації не означає, що CI пройшов під час цього огляду.
- Документи вже мають різні ролі. У bmad-core.md розрізнено аналіз, ADR, плани, специфікації та базові факти. Також зазначено, що за невизначеності щодо призначення не слід самостійно вигадувати новий шлях.
- Правила для тимчасових матеріалів неповні.
.gitignoreохоплює деякі робочі каталоги, пісочниці й тимчасові файли, але не визначає повністю, за яких умов зберігати чернетки та докази перевірок. Сам запис у файлі ігнорування також не підтверджує фактичного статусу файлів у Git. - Межі дистрибуції варто уточнити.
collect_source()рекурсивно збирає звичайні файли з каталогу джерел комплекту й зіставляє їх із каталогом плагіна. Перевірка наявності обов’язкових файлів — не те саме, що список дозволеного до дистрибуції. Якщо тимчасові матеріали опиняться в джерелах комплекту, є статичний ризик, що вони потраплять до поставки, хоча доказів, що це вже сталося, немає.
Отже, пріоритет — доповнити правила про те, чи створювати артефакт, чи комітити його, чи поширювати та як довго зберігати, а не запроваджувати ще одну систему каталогів.
Тимчасові перевірки — окремо, регресійні тести — на місці
Не варто зводити «забагато тестів» і «неохайний код» до однієї проблеми або ухвалювати рішення лише за назвою файла.
| Тип матеріалу | Рекомендоване місце | Коміт і дистрибуція |
|---|---|---|
| Довготривалі модульні тести, регресії дефектів і контрактні тести | Наявна структура тестів проєкту | Зазвичай зберігати у версійованому коді; потребу включати до дистрибутива визначати за його призначенням |
| Одноразова діагностика й тимчасові скрипти перевірки | Дозволена тимчасова зона для завдання | Типово не комітити й не поширювати |
| Журнали, дані про покриття й згенеровані звіти | Зона доказів виконання | Зберігати відповідно до вимог приймання та строку зберігання; не додавати автоматично до історії вихідного коду |
| Важливі контрприклади й відтворювані тестові дані | Після перевірки — до довготривалих тестових матеріалів | Зберігати їхню регресійну цінність, а не залишати лише в тимчасовій зоні |
Передбачте три контрольні етапи:
- Перед створенням: чи можна розширити наявний тест? Чи перевіряє новий файл окрему поведінку, а не повторює вже наявну перевірку?
- Перед комітом: чи є матеріал довготривалим активом проєкту? Чи містить він локальні шляхи, облікові дані або одноразовий налагоджувальний вміст?
- Перед дистрибуцією: чи входить матеріал до чітко визначеного складу поставки? Наявність файла в репозиторії не означає, що його потрібно встановлювати.
Сумісність із мовою програмування — обов’язкова умова. В офіційній документації Go команди описано окремі метадані для тестових файлів усередині пакета та зовнішнього тестового пакета. Тому не можна механічно уніфікувати структуру тестів у різних мовах.13 Для Python можна розглянути окремий спільний каталог тестів. У Go перед зміною слід перевірити доступ до символів пакета, виявлення тестів і залежності між викликами — не варто ламати межі перевірок заради однакового вигляду каталогів.
Також потрібно уточнити, що саме заважає: якщо тестів не має бути в інсталяційному пакеті, змінюйте склад дистрибутива; якщо заважають тимчасові матеріали в комітах — правила коміту; якщо відволікає вигляд коду під час перегляду — структуру або спосіб відображення. Це різні завдання.
Документи варто розподіляти за ролями, а не зливати в один файл
Доцільно спиратися на наявний поділ і не створювати окремий документ на кожну розмову:
- Аналіз сесії: за замовчуванням залишається результатом розмови й не записується на диск.
analysis/: лише погоджені аналізи, докази, порівняння та невідомі факти — не кошик для щоденних чернеток.adrs/: важливі рішення та їхні підстави, а не повна копія дослідницького звіту чи журналу виконання.pending_implementation_plan.md: мета, дозвіл, етапи, залежності й критерії приймання. Не потрібно постійно дописувати сюди журнал подій; чинний план не можна перезаписувати лише через нову рекомендацію.scratch/: можна розглянути як спільну тимчасову зону. Але її наявність сама собою не надає дозволу записувати туди дані, очищати їх чи запускати вміст.verification/: потрібні первинні докази з окремими правилами коміту й строку зберігання. Не слід за замовчуванням зберігати кожен повторний результат надовго.
Матеріали з розгортання теж варто класифікувати за призначенням: постійна інструкція для супроводу — це документація, а квитанція конкретного розгортання — доказ виконання. Не потрібен новий каталог лише тому, що в назві файла є слово «розгортання». Переміщення матеріалів має зберігати посилання й невиконані завдання — не можна просто переносити або видаляти історичні записи.
Щоб один файл не розростався без потреби:
- розділяйте документи за незалежними темами або рішеннями, а не за кожним кроком розмови;
- доручайте аналізу, ADR і плану різні завдання та пов’язуйте їх посиланнями, не копіюючи цілі розділи;
- під час продовження роботи завантажуйте актуальні вимоги й релевантні фрагменти доказів, а не всю історію;
- у стислих викладах розрізняйте факти, висновки та те, що ще треба перевірити, — припущення не повинні перетворюватися на «факти» під час скорочення.
Твердження, що «чим менше файлів, тим легше виникають галюцинації», наразі є гіпотезою, а не встановленим причинно-наслідковим зв’язком. Спершу варто впорядкувати дублікати, застарілий і нерелевантний контекст — без довільного ліміту рядків чи обіцянок ефекту.
Мінімальне правило й межі перевірки
Для V4 варто запровадити єдине правило: кожен новий артефакт має мати визначені призначення, місце зберігання, обґрунтування тривалого зберігання, межі коміту й дистрибуції, а також умови збереження або видалення. Спершу слід перевіряти, чи можна повторно використати наявні матеріали. Не потрібно вимагати нового файла для кожної перевірки чи документа для кожного аналізу.
Якщо надалі буде надано дозвіл на впровадження, мінімальні критерії приймання мають охоплювати:
- довготривалі тести й далі правильно виявляються відповідними перевірками CI, а потрібні регресії не губляться під час переміщення;
- тимчасові матеріали не потрапляють до зайвих комітів чи інсталяційного дистрибутива;
- ролі документів і посилання залишаються чинними, а активні завдання та історичні докази не видаляються помилково;
- очищення має чіткі межі й умови збереження, а ізоляція каталогів не видається за безпекову ізоляцію під час виконання.
Цей матеріал — лише аналіз у режимі читання: файли не змінювалися, тести не запускалися, артефакти не очищувалися, а план не перезаписувався. Зображення та зазначений допис у X отримати не вдалося; конкретний спосіб, яким Overalls розв’язує обидва питання, не перевірено. Наведені рекомендації — умовна пропозиція для керування артефактами у V4, а не дозвіл на впровадження.
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 "Тимчасові артефакти — окремо, важливі тести — у проєкті"?
Мета — не прибрати важливі тести й не звести всі документи в один файл, а скоротити зайві артефакти та чітко визначити їхній життєвий цикл.
What are the key points to validate first?
Мета — не прибрати важливі тести й не звести всі документи в один файл, а скоротити зайві артефакти та чітко визначити їхній життєвий цикл. Overalls описує ізольовані середовища для роботи агентів, але наявні джерела не підтверджують, що він автоматично впорядковує тестові файли чи документацію.
What should I do next in practice?
У V4 вже є правила для тестів і документів; найбільше бракує узгоджених вимог до тимчасових матеріалів, комітів і дистрибуції.