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

# Структура репозитория

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

**Идентификатор документа:** MU-V2-GUIDE-002  
**Название:** Архитектура семантического репозитория  
**Класс документа:** информативный  
**Версия:** 2.0 (черновик)  
**Статус:** рабочий черновик  
**Нормативные ссылки:** MMAS  
**Информативные ссылки:** Getting-Started, Create-a-New-Meta-Model  
**Копирайт:** © Orkestron.AI  
**Лицензия:** Apache-2.0  

---

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

Это руководство объясняет рекомендуемую структуру репозитория Мета-Вселенной и роль каждой основной папки.

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

Нормативные соответствия этого руководства - [MMAS-Package](../02-architecture/MMAS-Package.md) (каноническая раскладка), [Model-Traversal-and-Layout](../02-architecture/Model-Traversal-and-Layout.md) (контракт обхода без потерь и зарезервированные места для бутстрапов, канона, сырых данных и артефактов) и [Data-Mastership](../02-architecture/Data-Mastership.md) (какая система есть мастер каждого набора данных).

---

# 2. Цели проектирования

От репозитория Мета-Вселенной ожидается, что он:

- родной для Git;
- модульный;
- семантически организованный;
- версионированный;
- прослеживаемый;
- лёгкий в обходе.

Организация репозитория отражает семантическую архитектуру, а не технологию реализации.

---

# 2a. Архитектура семантического репозитория

Определяющая мысль репозитория Мета-Вселенной та, что он организован **по семантике, а не по типу файлов или технологии**. Обычные программные репозитории собирают файлы по тому, чем они *являются*: `src/`, `docs/`, `tests/`, `lib/`, `config/`. Репозиторий же Мета-Вселенной собирает документы по *вопросу, на который они отвечают*. Всякая папка верхнего уровня есть вопрос; её содержимое есть ответ.

- `00-foundation` - **зачем** стандарт существует;
- `01-constitution` - **каким законам** он подчиняется;
- `02-architecture` - **как** он устроен;
- `03-federation` - **как** он взаимодействует с другими;
- `04-core-concepts` - **какими основными понятиями** он пользуется;
- `05-reference-architecture` - **как** его прилагать;
- `06-ecosystem` - **как** он живёт в широкой экосистеме;
- `07-guides` - **как** начать;
- `examples` - **как** это выглядит на практике.

Поскольку всякая папка отвечает вопросу, а не технологии, репозиторий становится **семантическим пространством**, а не деревом файлов. Новичок может двигаться по намерению («мне надо знать, как эта модель объединяется» → `03-federation`), и точно так же может ИИ-агент, который сопоставляет папки вопросам и находит нужное знание, не разбирая расширений файлов. Переорганизация по технологии рассыпала бы ответ на один вопрос по многим папкам; организация по семантике держит всякий ответ целым. Это тот же принцип, который стандарты прилагают к мета-моделям - сперва моделируй смысл, - приложенный к самому репозиторию.

---

# 3. Рекомендуемая структура

```
Repository/
├── README.md
├── LICENSE
├── CHANGELOG.md
├── archive/
├── 00-foundation/
├── 01-constitution/
├── 02-architecture/
├── 03-federation/
├── 04-core-concepts/
├── 05-reference-architecture/
├── 06-ecosystem/
├── 07-guides/
├── examples/
└── schemas/ (optional)
```

---

# 4. Файлы в корне

**README.md**

Точка входа в репозиторий.

**LICENSE**

Условия публикации и переиспользования.

**CHANGELOG.md**

История выпущенных версий.

---

# 5. archive/

Хранит прежние выпуски, остающиеся доступными для исторической справки.

Содержимое после архивации не изменяется.

---

# 6. 00-foundation/

Содержит понятийное основание:

- Видение
- Принципы
- Терминология
- Глоссарий

Эти документы читайте первыми.

---

# 7. 01-constitution/

Задаёт конституционные правила экосистемы:

- Конституция
- Управление
- Процесс изменений
- Соответствие

Эти документы отвечают на вопрос, *что должно оставаться истинным всегда*.

---

# 8. 02-architecture/

Содержит спецификации MMAS, описывающие, как строятся мета-модели.

К типичным темам относятся:

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

---

# 9. 03-federation/

Содержит спецификации MUFP, описывающие семантическое сотрудничество независимых Вселенных.

К типичным темам относятся:

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

---

# 10. 04-core-concepts/

Задаёт общий семантический словарь, разделяемый всеми мета-моделями.

Включает такие понятия, как:

- Вселенная;
- Объект;
- Связь;
- Проекция;
- Контекст;
- Событие;
- Жизненный цикл.

---

# 11. 05-reference-architecture/

Даёт переиспользуемые архитектурные указания.

К типичным документам относятся:

- архитектура;
- стек;
- паттерны взаимодействия;
- паттерны федерации;
- паттерны жизненного цикла;
- эталонные схемы.

---

# 12. 06-ecosystem/

Описывает возможности уровня экосистемы.

К типичным темам относятся:

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

---

# 13. 07-guides/

Содержит практические указания.

Примеры:

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

Руководства дополняют нормативные спецификации.

---

# 14. examples/

Содержит показательные примеры, демонстрирующие правильное приложение стандартов.

Примеры держатся в согласии с текущими спецификациями.

---

# 15. schemas/ (необязательно)

Может содержать машиночитаемые активы:

- JSON Schema;
- YAML;
- OpenAPI;
- OData;
- артефакты валидации.

Схемы ссылаются на нормативные документы.

---

# 16. Стратегия обхода

Рекомендуемый порядок чтения:

1. README
2. Основание
3. Конституция
4. Архитектура
5. Федерация
6. Основные понятия
7. Эталонная архитектура
8. Экосистема
9. Руководства
10. Примеры

---

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

Сопровождающим репозитория стоит:

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

---

# 18. Заключение

Хорошо построенный репозиторий существен для находимости, совместимости и долгосрочной поддерживаемости.

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