> Перевод даётся для удобства чтения. Нормативным является английский оригинал.

# Хорошие практики

**Спецификация Мета-Вселенной**

**Идентификатор документа:** MU-V2-GUIDE-006  
**Название:** Хорошие практики  
**Класс документа:** информативный  
**Версия:** 2.0 (черновик)  
**Статус:** рабочий черновик  
**Нормативные ссылки:** MUC, MMAS, MUFP  
**Информативные ссылки:** Design-Recommendations, Create-a-New-Meta-Model, Federation-Guide  
**Копирайт:** © Orkestron.AI  
**Лицензия:** Apache-2.0  

---

# 1. Назначение

Это руководство сводит воедино рекомендуемые практики проектирования, публикации и развития мета-моделей, соответствующих Мета-Вселенной.

Рекомендации выведены из принципов MUC, MMAS и MUFP и представляют собой проверенные архитектурные указания, а не обязательные требования.

---

# 1a. Три уровня знания

Знание Мета-Вселенной существует на **трёх уровнях**, и это руководство занимает третий. Их различение проясняет, что обязательно, что рекомендовано, а что есть лишь опытное суждение:

- **Нормативное** - *чему надлежит подчиняться*. Сами стандарты: MUC, MMAS и MUFP. Соответствие обязательно и проверяемо.
- **Эталонное** - *рекомендуемая архитектура*. Эталонная архитектура и эталонные доменные мета-модели, показывающие заведомо годный способ прилагать стандарты.
- **Хорошие практики** - *как на деле решают опытные архитекторы*. Накопленные эвристики и привычки, которыми пользуются опытные практики там, где стандарты оставляют место суждению.

Уместна аналогия с тем, как задокументирована Всемирная паутина. **RFC на HTTP** задаёт протокол (нормативное); **архитектурные руководства** показывают рекомендуемые способы строить на нём (эталонное); а **практические рекомендации** схватывают то, как бывалые инженеры на деле проектируют настоящие системы (хорошие практики). Нужны все три: протокол ручается за совместимость, архитектура показывает проверенную форму, а практики передают опыт, который никакой спецификации не закодировать полностью. Этот документ есть третий слой - и он никогда не отменяет первого.

---

# 2. Мыслите семантикой, а не технологией

Всегда сперва моделируйте деловую реальность.

DO:

- выделите понятия;
- выделите смысл;
- определите связи.

Избегайте моделировать:

- таблицы базы данных;
- конечные точки REST;
- классы языка программирования;
- структуры хранения.

Технология меняется быстрее семантики.

---

# 3. Предпочитайте небольшие доменные модели

Создавайте сосредоточенные доменные мета-модели.

Удачные примеры:

- Сотрудник
- Организация
- Продукт
- Клиент

Избегайте больших всеобщих моделей, пытающихся описать всякую предметную область.

Федерация предпочтительнее монолитного моделирования.

---

# 4. Переиспользуй, прежде чем создавать

Прежде чем вводить новое понятие:

- поищите среди Зарегистрированных мета-моделей;
- просмотрите импортированные стандарты;
- проверьте Семантические пакеты;
- оцените Профили федерации.

Переиспользуйте существующую семантику всюду, где это возможно.

---

# 5. Делайте идентичность канонической

Разделяйте:

- Каноническую идентичность;
- Локальную идентичность;
- Привязки идентичностей.

Каноническая идентичность остаётся устойчивой на всём протяжении жизненного цикла.

---

# 6. Проектируйте явные связи

Связи лучше всего проектировать так, чтобы они:

- имели ясные имена;
- выражали деловой смысл;
- прослеживались независимо;
- избегали терминологии реализации.

Хорошие связи улучшают рассуждение ИИ.

---

# 7. Моделируйте события явно

Обращайтесь с Событиями как с семантическими артефактами первого класса.

Важные деловые перемены порождают События.

Избегайте восстанавливать историю из одного лишь текущего состояния.

---

# 8. Пользуйтесь проекциями вместо копий

Никогда не выставляйте внутренние модели напрямую.

Создавайте Профили проекций, уместные для:

- аудитории;
- назначения;
- политики раскрытия;
- Контекста.

Обмен через Проекции сводит семантический дрейф к минимуму.

---

# 9. Всегда определяйте контекст

Всякая Проекция и всякое взаимодействие определяют:

- назначение;
- аудиторию;
- допущения;
- видимость.

Смысл зависит от Контекста.

---

# 10. Сохраняйте происхождение

Всякий значимый артефакт сохраняет:

- источник;
- владельца;
- издающую инстанцию;
- версию;
- связанные События.

Доверие держится на происхождении.

---

# 11. Проектируйте под федерацию

Исходите из того, что всякая мета-модель рано или поздно может участвовать в федерации.

Подготовьте:

- Семантические отображения;
- Привязки идентичностей;
- Контракты;
- стратегию синхронизации.

Готовность к федерации не должна быть запоздалой мыслью.

---

# 12. Версионируйте осмотрительно

Пользуйтесь семантическим версионированием.

Избегайте ненужных ломающих изменений.

Держите совместимость всюду, где это осуществимо.

Развитие сохраняет семантическую непрерывность.

---

# 13. Проверяйте непрерывно

Валидация удостоверяет:

- соответствие MUC;
- соответствие MMAS;
- именование;
- прослеживаемость;
- Контекст;
- устройство Проекций;
- совместимость.

Автоматизируйте валидацию всюду, где это осуществимо.

---

# 14. Храните историю

Никогда не переписывайте семантическую историю.

Предпочитайте:

- неизменяемые События;
- заархивированные версии;
- развитие только на дозапись.

История прибавляет объяснимости.

---

# 15. Пишите документацию для людей и для ИИ

Документацию лучше всего держать:

- краткой;
- структурированной;
- машиночитаемой там, где это осуществимо;
- семантически согласованной.

Репозитории потребляют и люди, и ИИ-агенты.

---

# 16. Публикуйте полные метаданные

Опубликуйте:

- поддерживаемые стандарты;
- версии;
- совместимость;
- соответствие;
- управление;
- лицензирование.

Хорошие метаданные улучшают обнаружение и переиспользование.

---

# 17. Пересматривайте регулярно

Время от времени пересматривайте:

- терминологию;
- отображения;
- контракты;
- проекции;
- результаты валидации;
- объявления о совместимости.

Непрерывное улучшение укрепляет долгосрочную совместимость.

---

# 18. Чеклист проектирования

Перед публикацией спросите:

- Хорошо ли очерчена предметная область?
- Канонична ли Идентичность?
- Задан ли Контекст явно?
- Определены ли Проекции?
- Полны ли События?
- Сохранено ли происхождение?
- Возможна ли федерация?
- Может ли ИИ понять модель?
- Может ли модель развиваться безопасно?

---

# 19. Направления развития

По мере того как накапливается свод практического опыта, слой Хороших практик может сгуститься в **Справочник архитектуры Мета-Вселенной** - выверенного спутника нормативных стандартов, собирающего в одном месте проверенные паттерны, антипаттерны, разобранные примеры и решающие эвристики. Такой справочник остался бы твёрдо на третьем уровне знания: он объяснял бы, *как решают опытные архитекторы*, ссылался бы на эталонную архитектуру и [Рекомендации по проектированию](Design-Recommendations.md) и никогда не отменял бы MUC, MMAS или MUFP. Он был бы тем местом, где накопленное суждение сообщества записано и поддерживается в свежести.

---

# Заключение

Удачные мета-модели строятся вокруг устойчивых семантических понятий, а не преходящих подробностей реализации.

Прилагая эти хорошие практики последовательно, организации создают переиспользуемые, объяснимые и совместимые семантические модели, способные развиваться десятилетиями, участвовать в федерации и поддерживать как человеческое сотрудничество, так и ИИ-родные системы знания, не поступаясь идентичностью, доверием и управляемостью.