ОтветыОпубликовано13 источники
Как навести порядок в тестах и документах, не потеряв важное
Overalls описывается как платформа для разработки в виртуальных машинах Firecracker, но данных о её конкретных правилах для тестов и документации недостаточно. В V4 уже есть структура для тестов и документов; пробел — в правилах жизненного цикла временных материалов и границах поставки.
ОпубликовалИзображения созданы с помощью GPT Image 2
Ответ на исследование
Ключевые выводы
- Overalls описывается как платформа для разработки в виртуальных машинах Firecracker, но данных о её конкретных правилах для тестов и документации недостаточно.
- В 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)
Промпт ИИ
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 — и чего пока нельзя утверждать
Судя по доступным материалам, речь идёт о платформе Overalls. В публикации разработчика говорится, что раньше проект назывался loom и использовался для запуска задач агентного кодирования во временных виртуальных машинах Firecracker.10
Официальное описание проекта называет Overalls самостоятельной платформой для разработки и AI-агентов. Каждая машина — постоянная микроВМ Firecracker с операционной системой NixOS, Ubuntu или Windows.12
Здесь важно не смешивать разные вещи: временные среды для отдельных задач и постоянные машины разработки. Доступные источники не описывают полный жизненный цикл обоих типов окружений, поэтому нельзя заключить, что Overalls автоматически чистит репозиторий после каждой задачи.
Также не удалось найти упомянутую публикацию в X и проверить её изображение. Утверждения о том, что Overalls сам по себе задаёт правила размещения тестов, черновиков или документов, не подтверждены. Из материалов можно сделать вывод о направлении — изоляции рабочих сред, — но не о конкретных практиках управления файлами.
В V4 уже есть структура, но не хватает правил жизненного цикла
Судя по описанию репозитория, проблема не в полном отсутствии правил, а в том, что не для всех материалов понятно, когда их создавать, сохранять, коммитить и включать в поставку.
- В
.github/workflows/ci.ymlпредусмотрен сбор контрактных тестов, а далее — проверки защиты активов и регрессионные проверки дистрибуции. Удаление таких тестов без замены может нарушить существующие требования к проверке. При этом наличие настройки в конфигурации само по себе не означает, что CI запускался или прошёл. - В
bmad-core.mdразличаются анализ, ADR — записи об архитектурных решениях, — планы, спецификации и фактическая базовая информация. Там же указано, что не следует самостоятельно создавать новую директорию, если назначение материала неясно. - В
.gitignoreуже перечислены некоторые рабочие каталоги, песочницы и временные файлы. Но это не полная политика для черновиков и свидетельств проверок. Кроме того, записи в.gitignoreсами по себе не позволяют установить, какие файлы сейчас отслеживаются Git. - Функция
collect_source()рекурсивно собирает обычные файлы из исходной части комплекта и сопоставляет их с каталогом плагина. Проверка обязательных файлов не равна явному списку того, что разрешено распространять. Поэтому случайно помещённые в исходный каталог временные материалы могут попасть в поставку — это статический риск, а не свидетельство, что такое уже происходило.
Практический вывод: прежде чем вводить новые каталоги, стоит определить для каждого типа файла его назначение, срок хранения и правила включения в коммит или дистрибутив.
Тесты: отделять временные проверки, а не отказываться от регрессий
Большое число тестов и беспорядок в исходниках — разные проблемы. Удалять или переносить все файлы с тестами по одному общему правилу нельзя: долгосрочные проверки поддерживают качество продукта, а разовые скрипты часто нужны только для диагностики конкретной задачи.
| Материал | Где хранить | Коммит и поставка |
|---|---|---|
| Долгосрочные тесты, проверки исправленных дефектов и контрактов | В существующей структуре тестов проекта | Обычно хранить в системе контроля версий; включать в поставку в зависимости от её назначения |
| Разовый диагностический скрипт или временная проверка | В разрешённой временной области для задачи | По умолчанию не коммитить и не распространять |
| Логи, отчёты о покрытии и другие результаты запуска | В области для свидетельств выполнения | Хранить согласно требованиям проверки и срокам хранения, а не автоматически добавлять в историю исходников |
| Важный контрпример или воспроизводимая тестовая фикстура | После проверки — в постоянном наборе тестов | Сохранить, если материал приносит долгосрочную регрессионную пользу |
Полезно проверять три вещи на каждом этапе:
- Перед созданием: можно ли расширить существующий тест? Проверяет ли новый файл отдельное поведение или дублирует уже имеющуюся проверку?
- Перед коммитом: это долгосрочный актив проекта или одноразовый материал? Нет ли в нём локальных путей, секретов или отладочного кода, который не должен попасть в историю?
- Перед поставкой: действительно ли файл нужен пользователю или компоненту? Наличие файла в репозитории не означает, что его нужно устанавливать.
Универсальную структуру тестов для всех языков задавать нельзя. Документация Go отдельно описывает тесты внутри пакета и внешний тестовый пакет — это может влиять на доступ к коду и обнаружение тестов.13 Для Python можно рассматривать отдельный каталог тестов, а для Go сначала следует проверить границы пакетов, запуск тестов и зависимости между файлами.
Нужно также уточнить, что именно мешает: если проблема в том, что тесты попадают к пользователям, пересматривать нужно состав поставки; если в Git появляются временные скрипты — правила коммита; если тесты просто мешают ориентироваться в исходниках — размещение или способ просмотра. Это три разных задачи.
Документы: меньше дублирования, яснее назначение
Практичнее опираться на существующие роли документов, а не создавать новый файл после каждого обсуждения.
- Анализ по итогам сессии — обычно достаточно передать в самой сессии; сохранять его в репозитории стоит только при явной необходимости.
analysis/— для утверждённых аналитических материалов, свидетельств и сравнений, а не для повседневных черновиков.adrs/— для значимых решений и причин, по которым они приняты. Полный исследовательский отчёт или журнал исполнения сюда не нужно дублировать.pending_implementation_plan.md— для цели, разрешённого объёма работ, этапов, зависимостей и критериев приёмки, а не для бесконечного журнала событий. Уже существующий активный план нельзя перезаписывать на основании одних этих рекомендаций.scratch/можно рассматривать как единое место для временных материалов. Однако само наличие такой директории не даёт разрешения записывать туда любые данные, запускать процессы или удалять содержимое.verification/может хранить нужные свидетельства проверок. Для них отдельно следует определить правила коммита и срок хранения; нет необходимости автоматически оставлять каждый повторный вывод навсегда.
Документы о длительных процедурах обслуживания и отчёты о конкретном запуске — разные материалы. Первые могут быть постоянными инструкциями, вторые — свидетельствами выполнения. Создавать новую директорию только потому, что в заголовке встречается слово «развёртывание», не обязательно.
Чтобы документы не разрастались и не повторяли друг друга:
- делить их по самостоятельным темам или решениям, а не по каждому этапу переписки;
- разводить анализ, ADR и план по разным функциям, связывая их ссылками вместо копирования целых разделов;
- при передаче контекста загружать актуальные правила и релевантные фрагменты, а не всю историю целиком;
- явно отличать проверенные факты от выводов и вопросов, которые ещё предстоит проверить.
Предположение, что сокращение числа файлов само по себе уменьшает ошибки модели, остаётся гипотезой: приведённых данных недостаточно, чтобы считать такую причинно-следственную связь доказанной. Разумнее сначала убрать дубли, устаревшие материалы и нерелевантный контекст, не устанавливая произвольных лимитов по объёму документов.
Минимальное правило для V4
Для каждого нового материала стоит заранее указать его назначение, место хранения, необходимость постоянного сохранения, правила коммита и распространения, а также условия хранения или удаления. При этом нужно по возможности расширять существующие активы, а не создавать новый файл для каждой проверки или анализа.
Если эти правила будут внедряться, проверка результата должна подтвердить, что долгосрочные тесты по-прежнему обнаруживаются нужными CI-процессами, временные материалы не попадают без необходимости в коммиты и поставку, ссылки на документы остаются рабочими, а активные задачи и важные свидетельства не удаляются по ошибке. Очистка должна иметь ясные границы: изоляция файлов по каталогам сама по себе не является изоляцией среды выполнения.
Это анализ и условное предложение по управлению материалами V4, а не сообщение об уже внесённых изменениях. Файлы не редактировались, тесты не запускались и активные планы не перезаписывались. Конкретный пост в X и практики Overalls для организации тестов и документов проверить не удалось.
Studio Global AI
Продолжайте свое исследование
На этой странице есть ответ, подтвержденный источником, который вы можете продолжить внутри Studio Global.
Люди также спрашивают
Каков краткий ответ на вопрос «Как навести порядок в тестах и документах, не потеряв важное»?
Overalls описывается как платформа для разработки в виртуальных машинах Firecracker, но данных о её конкретных правилах для тестов и документации недостаточно.
Какие ключевые моменты необходимо проверить в первую очередь?
Overalls описывается как платформа для разработки в виртуальных машинах Firecracker, но данных о её конкретных правилах для тестов и документации недостаточно. В V4 уже есть структура для тестов и документов; пробел — в правилах жизненного цикла временных материалов и границах поставки.
Что мне делать дальше на практике?
Долгосрочные тесты стоит сохранять, а разовые скрипты, логи и отчёты — отделять от исходников и включать в коммит или поставку только при необходимости.