> Перевод даётся для удобства чтения. Нормативным является английский оригинал. # Работа агента с моделью **Спецификация Мета-Вселенной** **Идентификатор документа:** MU-V2-GUIDE-010 **Название:** Рабочие инструкции для ИИ-агентов, работающих над соответствующей моделью **Класс документа:** информативный **Версия:** 2.0 (черновик) **Статус:** рабочий черновик **Нормативные ссылки:** Model-Traversal-and-Layout, Data-Mastership, Validation **Информативные ссылки:** AI-Agent-Guide, AI-Integration-Patterns, MMAS-Package, Overview **Копирайт:** © Orkestron.AI **Лицензия:** Apache-2.0 --- # 1. Назначение [AI-Agent-Guide](AI-Agent-Guide.md) объясняет, как *строить* агентов на стандарте. Это руководство уже и практичнее: вы - агент, которого только что направили на **репозиторий соответствующей модели** и попросили её прочесть, ответить по ней или изменить её. Перед вами ваши рабочие инструкции, сведённые к рецептам из нормативных правил [Model-Traversal-and-Layout](../02-architecture/Model-Traversal-and-Layout.md) (ARCH-017) и [Data-Mastership](../02-architecture/Data-Mastership.md) (ARCH-018). Правила существуют затем, чтобы смешанные команды людей и агентов могли работать над одним знанием, не портя его ни с одной стороны. Каждый рецепт ниже вытекает из трёх фактов: у всякого файла есть объявленный смысл, у всякого набора данных ровно один мастер, а всякая производная копия расходуема. --- # 2. Рецепт: холодный старт (первая встреча с моделью) 1. Прочтите **`BOOTSTRAP.md`**. Он говорит, как именно эта модель хочет быть прочитанной, каковы её местные соглашения и чего трогать нельзя. Если есть ещё и входной файл экосистемы (`CLAUDE.md`, `AGENTS.md`), читайте его следом: он несёт рабочее состояние, а BOOTSTRAP - структуру. 2. Прочтите **`manifest.yaml`**: идентичность, порядок бандлов, правила классификации, исключения. 3. Прочтите **`sources.yaml`**: какие наборы данных мастерятся здесь, а какие суть зеркала внешних систем, с правилами свежести и разрешения конфликтов. *Сделайте это до чтения содержимого*, иначе вы не будете знать, полномочно ли прочитанное. 4. Обойдите бандлы **в объявленном порядке** (сперва фундамент), слои по порядку, `README.md` слоя раньше записей. 5. Если есть обходчик покрытия (по соглашению `tools/mu-walk*`), запустите его. Неуспешный обход означает, что сломана собственная карта модели: доложите об этом прежде, чем доверять чему-либо ещё. Правило, экономящее время: порядок обхода есть порядок зависимостей. Даже если вам нужен один бандл, вы всё равно сперва читаете манифесты и README фундаментальных бандлов: они задают словарь, на котором говорят бандлы позднейшие. --- # 3. Рецепт: ответы на вопросы по модели 1. Сводите ответ к конкретным записям; ссылайтесь на них по пути или идентификатору записи. 2. Прежде чем опереться на любой факт, проверьте его набор данных в реестре: - **мастерится моделью** → запись и есть истина; отвечайте прямо. - **зеркало с внешним мастером** → проверьте свежесть. В пределах допустимой давности: отвечайте, называя мастера («по пространству Ops в Confluence, снято 2026-07-30»). За её пределами: скажите, что зеркало устарело, и предпочтите новую выгрузку догадке. - **`status: declared`** → данных ещё нет, есть только намерение; никогда не выдавайте объявленное зеркало за факт. - **`status: retired`** → системы-источника больше нет; зеркало есть замороженный архив. Отвечайте исторически («на момент последнего экспорта»), но никогда как о текущем состоянии. 3. Различайте происхождение: снимок в `raw/` есть свидетельство того, что сказал источник; запись есть собственное утверждение модели. Когда они расходятся, так и скажите; модель может держать размеченное отклонение намеренно. --- # 4. Рецепт: запись в модель 1. **Сперва найдите мастера.** Отыщите набор данных в `sources.yaml`. Пишите только в мастера; запись в копию есть порча, как бы это ни было удобно: - мастерится моделью → правьте запись на месте, следуя соглашениям модели об именах и записях. - мастерится извне → исправление принадлежит внешней системе. Если вы до неё не дотягиваетесь, доставьте исправление тому, кто дотянется (или оформите его явно помеченной, мастерящейся моделью пометкой *о* зеркале; никогда не правьте зеркальные байты). 2. **Уважайте происхождение.** Никогда не правьте руками ничего снятого (`raw/`, зеркала) или сгенерированного (`artifacts/`). Правка идёт в систему-источник или в генератор. 3. **Держите обход честным.** Если вы добавляете, переносите или удаляете файлы, перезапустите обходчик покрытия и закоммитьте свежий отчёт. Новый файл, который не классифицируется ни одним правилом, есть сирота: расширьте правила манифеста (или положите файл верно), но не игнорируйте неудачу. 4. **Держите реестры честными.** Новый набор данных, новый конвейер, смена мастерства → обновите `sources.yaml` тем же изменением. Смены мастерства суть версионированные события, а не тихие правки. 5. Если модель питает обратные проекции (сайт, страницу вики), после правки запустите проверку расхождения и переопубликуйте, если она о расхождении сообщила. --- # 5. Рецепт: снятие внешней системы в модель 1. Подтвердите запись набора данных в реестре (мастер, охват, ритм). Записи нет → сперва создайте её; снятие без объявленного мастерства - вот как рождаются две истины. 2. Положите **неизменённый снимок** в `raw///` вместе с приложенным описанием происхождения (источник, охват, время извлечения, инструмент, число элементов). 3. Примените преобразование в место зеркала; никогда не «улучшайте» факты во время преобразования: обогащение есть отдельный слой, мастерящийся моделью. 4. Обновите метаданные свежести; перезапустите обходчик. ## Рецепт: публикация обратной проекции 1. Порождайте её из записей модели механически; проекция, подправленная руками, есть форк, а не проекция. 2. Пометьте копию: мастер, время порождения, «здесь не править» - в той форме, какую цель поддерживает. 3. Сделайте расхождение обнаружимым: минимум - хеш содержимого по сравнимой части, сверяемый командой проверки. 4. Предпочитайте автоматизацию проверки (ежедневное задание, поднимающее человека при расхождении), чтобы расхождение замечалось механикой, а не конфузом. --- # 6. Когда отказывать Откажите в записи и объясните, когда: - вы не можете определить мастера набора данных (запись в реестре отсутствует или двусмысленна); - вас просят править на месте зеркало, сырой снимок или сгенерированный артефакт; - вас просят обойти обход (добавить семантические файлы как «исключённые», спрятать содержимое от классификации); - проверка покрытия модели не проходит, а запрошенное изменение строилось бы на неклассифицированной области; - правило разрешения конфликтов проприетарного или ограниченного набора данных запрещает запрошенное раскрытие. Агент, который не может сказать, что ему править дозволено, править не должен. Это [ARCH-017 §11](../02-architecture/Model-Traversal-and-Layout.md) на практике. --- # 7. Этикет многоагентной и человеческой команды - **Оставляйте обход зелёным.** Обходчик есть общий инвариант между сессиями и между агентами: никогда не передавайте красный обход. - **Реестры важнее памяти.** Всё, что будущей сессии надо знать о структуре или полномочиях, принадлежит BOOTSTRAP, манифесту или реестру, а не журналу переписки. - **Малые объявленные изменения.** Предпочитайте добавить запись, а не переписать; предпочитайте расширить правило, а не завести исключение под файл; держите идентификаторы записей неизменными. - **Происхождение у производной работы.** Если вы породили или пересказали содержимое из источников, скажите: из чего, каким инструментом, когда - на этом держится машинерия доверия модели (статус валидации, обзор владельцем). --- # 8. Как это выглядит в жизни Две продуктовые модели прогоняют все рецепты выше и стоят чтения как исполняемая документация: продуктовая модель Orkestron.AI (обратная проекция на публичный сайт с проверкой расхождения по хешу и ежедневным дежурным оповещением) и модель платформы DevTeam.Games (внешние зеркала исходного кода, отставленная система учёта, сохранённая как замороженное свидетельство, проприетарный набор данных с запретом на публикацию). См. [разбор случая Orkestron](../06-ecosystem/Case-Study-Orkestron-Ecosystem.md). --- # Заключение Соответствующая модель сама говорит вам, как её читать, что есть что и кому принадлежит какая истина. Ваша работа как агента симметрична: читайте в объявленном порядке, пишите только туда, где живёт истина, и оставьте объявления столь же верными, какими вы их застали.