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

# AGENTS.md - чтение Мета-Вселенной глазами ИИ-агента

Этот файл есть точка входа для ИИ-агента (или всякого автоматического
инструмента), поглощающего этот репозиторий. Он говорит вам, что читать первым и
какие артефакты машиночитаемы.

## Что это такое

Мета-Вселенная есть **семейство открытых стандартов** для федеративных
семантических систем: как независимые «вселенные» смысла описывают реальность,
строят мета-модели и объединяют знание, сохраняя идентичность, контекст,
владение, доверие и прослеживаемость. Это спецификация, а не среда исполнения.

## Читайте в таком порядке

1. **`spec-index.yaml`** - машиночитаемый указатель всех документов (id, класс,
   статус, путь). Начните отсюда, чтобы перечислить спеку.
2. **`00-foundation/Terminology.md`** - нормативный словарь. Разрешайте термины
   здесь, а не по прозе.
3. **`01-constitution/Meta-Universe-Constitution.md`** - основные законы
   (21 статья). У всякого нормативного утверждения есть идентификатор
   (`MUC-Rnn`).
4. **`REQUIREMENTS-INDEX.md`** - всякое требование RFC 2119 по всем нормативным
   документам, с устойчивыми идентификаторами. Ссылайтесь на них.
5. **`02-architecture/MMAS-Interchange.md`** + **`schemas/`** - сериализация MUIF
   и схемы JSON: конкретное, проверяемое лицо модели.
6. **`03-federation/MUFP-Messages.md`** - протокол на проводе (конверты, автомат
   состояний, ошибки) для объединения.

## Машиночитаемые артефакты

| Артефакт | Применение |
|----------|-----|
| `spec-index.yaml` | Перечислить документы и их статус. |
| `schemas/*.schema.json` | Проверять модели MUIF, конверты MUFP, документы обнаружения и отчёты валидации (JSON Schema 2020-12). |
| `REQUIREMENTS-INDEX.md` | Обращаться к отдельным нормативным требованиям по идентификатору. |
| `mu-fingerprint` (см. `tools/`) | Вычислить воспроизводимый Семантический отпечаток модели. |
| `mu-validate` (см. `tools/`) | Проверить модель MUIF по проверкам V0-V2. |
| `/.well-known/meta-universe.json` | Документ обнаружения Вселенной (см. `examples/well-known/`). |

## Разобранные примеры

- `examples/minimal-person/` - наименьшая модель и воспроизводимость отпечатка.
- `examples/federation-acme-govtax/` - две вселенные объединяются от начала до конца.
- `examples/federation-handshake/` - расшифровка сообщений MUFP.
- `examples/interop/` - отображение на RDF/OWL, Schema.org, FHIR, FOAF.

## Работа НАД соответствующей моделью (а не над этим репозиторием спеки)

Если вас направили на *репозиторий модели* (в нём есть `BOOTSTRAP.md`,
`manifest.yaml`, `sources.yaml`), ваши рабочие инструкции -
**`07-guides/Agent-Operations.md`**: читайте BOOTSTRAP → манифест → источники до
содержимого; обходите бандлы в объявленном порядке; пишите **только** в
объявленного мастера набора данных; никогда не правьте руками `raw/`, зеркала
или `artifacts/`; после структурных изменений перезапускайте обходчик покрытия;
отказывайте в записи, когда мастерство не объявлено. Связная, читаемая человеком
карта всего стандарта - **`00-foundation/Overview.md`**.

## Построение агента на Мета-Вселенной

См. **`07-guides/AI-Integration-Patterns.md`** и
**`07-guides/AI-Agent-Guide.md`**: загружайте мета-модели как схемы инструментов,
извлекайте смысл через Проекции и События (а не сырые строки), приводите в
исполнение Исполнимый семантический контракт внутри цикла и выдавайте
прослеживаемые результаты.

## Правила поведения

- Считайте **Терминологию** и **Конституцию** полномочными; не выводите
  нормативного смысла из информативной прозы.
- Модель «значит то же самое» тогда и только тогда, когда совпадает её
  **Семантический отпечаток**.
- Никогда не принимайте обнаружимость схемы за доступ к данным.