# Бандлы, слои, записи

*Построение мета-модели · урок 2 из 6 · ~15 мин*

## Что вы узнаете

Как содержимое модели на самом деле организовано и написано: иерархия бандл → слой → запись, именование, несущее смысл, и что делает запись хорошей.

## Иерархия

- **Бандл** - это одна смысловая ответственность: "зачем существует продукт", "проектирование системы", "качество и риски". Бандлы упорядочены: основания первыми, чтобы при одном последовательном чтении определения встречались раньше их использования.
- **Слой** - это один вопрос внутри бандла: "кто стейкхолдеры?", "какие есть API?". В каталоге слоя лежит `README.md`, где сформулированы вопросы, на которые слой отвечает: этот README *и есть* объявление смысла слоя.
- **Запись** - это одно независимо адресуемое утверждение: одно требование, одно решение, один контракт API, один риск. Одна запись - один файл.

Флагманская предметная мета-модель AISMM фиксирует для области "программный продукт" тринадцать бандлов (от b0 ядро продукта до b12 экономика) и около 90 слоёв. У вашей области будут свои бандлы; механика та же самая.

## Имена, которые читает машина

Записи следуют соглашению об именовании, которое несёт классификацию прямо в имени файла:

```text
{record_kind}-{YYMMDDNNNNN}-{memo}.md
   req-26071800001-minor-parental-consent.md
   decision-26061500001-concept-decisions.md
   i18n-26060300001-languages-roster.md
```

Префикс - это вид записи (требование, решение, api, риск...), цифры - сортируемый идентификатор на основе даты, памятка - для людей. Поскольку вид указан в имени, одно объявленное правило в манифесте классифицирует тысячи файлов (следующий урок). Две выстраданные подробности: префиксы могут содержать цифры (`i18n`), а идентификатор никогда не меняется после рождения, даже если поменялись памятка или содержимое: устойчивость ссылки важнее красоты.

## Что внутри записи

У записи две части: машинный блок и человеческое тело. Машинный блок (front matter) несёт идентичность (идентификатор документа, слой, продукт), классификацию (`kind_class`: это *нормативное* для продукта, *описательное* о нём или *проекция* чего-то другого?) и, что критично, **происхождение**: если запись произвёл агент из источников, блок говорит, из чего именно, кем, как преобразовано и подтвердил ли это владелец. Тело - обычная, хорошо написанная проза и структурированные данные: у стандарта нет мнения о вашем стиле письма, только о вашей прослеживаемости.

Именно тройка `kind_class` + `derivation` + `validation_status` позволяет смешанным командам людей и агентов доверять модели: вы всегда отличите подтверждённое владельцем нормативное утверждение от неподтверждённого пересказа вики, сделанного агентом.

## Что делает запись хорошей

- **Одна забота.** Если вы не можете озаглавить её без "и", разделите.
- **Адресуемость.** Тому, кому поручили "разобраться с req-26071800001", больше ничего не нужно, чтобы найти свою работу.
- **Ссылка, а не повтор.** Записи ссылаются на канон, на свидетельства в `raw/` и друг на друга; один и тот же факт, изложенный дважды, рано или поздно окажется верным один раз.
- **Честность о статусе.** Черновик, не подтверждено, заменено: состояния - это метаданные, а не секреты.

## Главное

- Бандл = ответственность, слой = вопрос, запись = одно адресуемое утверждение.
- Имя файла несёт вид; front matter несёт идентичность, классификацию и происхождение.
- Прослеживаемость (кто из чего это вывел, кто подтвердил) - это то, что делает написанное агентом пригодным к использованию.

## Копнуть глубже

- [Ядро архитектуры MMAS](/spec/#02-architecture/MMAS-Core.md) · [Соглашения об именовании](/spec/#02-architecture/Naming-Conventions.md)
- [Создание новой мета-модели](/spec/#07-guides/Create-a-New-Meta-Model.md)
- AISMM, флагманская предметная мета-модель: [github.com/orkestron-ai/software-meta-model](https://github.com/orkestron-ai/software-meta-model)

Дальше: [Обход без потерь](03-walk.md)