Эталонные документы
Живые контракты системы — Single Source of Truth
Дата: Август 2026 Статус: ACTIVE
Этот раздел содержит живые контракты системы. Они читаются напрямую из корня папки docs/ — это Single Source of Truth.
Когда система эволюционирует (через MetaAgent + Approval Gate), эти страницы автоматически обновляются при следующем билде Библии.
Принцип: Contract-as-Code
Контракты — это не документация о системе. Это часть самой системы. Они:
- Хранятся в одном месте (корень папки
docs/) - Читаются всеми потребителями (Том, Библия, Bootstrap Agent)
- Версионируются через метку версии в каждой строке файла
- Защищены Approval Gates (Manual High-Risk)
- Расширены через Spec-First — директория
specs/с Contract-as-Code для агентов
Почему это важно
Две копии одного контракта — это петля рассинхронизации (Meadows). Карта (Библия) перестаёт соответствовать территории (системе). Contract-as-Code устраняет эту петлю — Библия всегда показывает то, что реально использует Том.
Документы
SOUL.md — Контракт Мастера
Главный контракт системы. Определяет:
- Триаду Она + Том + Я
- Четыре Закона Стандарта Онатомии (Азимов → Онатомия):
- 🌐 Нулевой: Сохранение Творца
- 🥇 Первый: Защита Внутреннего Языка
- 🥈 Второй: Служение Свободе
- 🥉 Третий: Самосохранение Эмиссара
- Artifex-centrismus (Креоцентризм) — система центрирована на архетипе Artifex
- Антропологию Фромма (не Фрейда) — свобода выбора, не детерминизм
- Принцип Наблюдателя — Творец как коллапсирующий наблюдатель
- Тернарность — три состояния решений (OWN/ALIEN/UNCERTAIN, ALLOW/DENY/DEFER)
- Четыре уровня градированной автономии
- Железный счёт (Iron Fund)
- Защиту Мастера от узурпации Эмиссаром (McGilchrist)
- 8 петель обратной связи (Meadows)
- Лакатосовский журнал опровержений (Lakatos)
- Burnout Protection (§13) — красная линия автоматической паузы
- 7 защит от самоуничтожения (§14, анти-некрофилия по Фромму)
settings.json — Конфигурация
Полная конфигурация системы со всеми параметрами:
- 12 книг интеллектуального фундамента
- Четыре Закона Стандарта Онатомии (иерархия 0 > 1 > 2 > 3)
- Artifex-centrismus (Креоцентризм)
- Антропология Фромма (не Фрейда)
- Принцип Наблюдателя (квантовая аналогия)
- Тернарность — логика решений агентов
- Spec-First директория
specs/ - Burnout Protection — красная линия автоматической паузы
- 7 защит от самоуничтожения (анти-некрофилия)
- Безопасность и красные линии
- Режимы работы (Normal / LowRisk / Emergency / Pause)
- Ресурсы и Memory Guard
- Каналы монетизации
- Конфигурация агентов (Style Guardian, MetaAgent и др.)
- 8 петель обратной связи
- Градированная автономия и триггеры
- Iron Fund и Weekly Batch
BOOTSTRAP_SPEC.md — Спецификация рождения
Алгоритм развёртывания Тома на чистой системе. 15 шагов от pre-flight checks до BORN.flag:
- Базовая среда (Homebrew, Python, Ollama)
- Создание структуры проекта
- Копирование контрактов
- Копирование
specs/директории (Spec-First) - Инициализация интеллектуального фундамента (12 книг)
- Настройка Style Guardian и Lakatos Journal
- Регистрация 7 рефлексов (LaunchAgents)
- Калибровка Metal acceleration
Spec-First подход
Каждый агент имеет отдельную спецификацию в директории specs/ (Contract-as-Code расширенный).
Структура:
Onatomia/
├── specs/ # Спецификации агентов (Spec-First)
│ ├── _template.spec.md # Шаблон для новых агентов
│ ├── meta-agent.spec.md # MetaAgent (outer loop)
│ ├── style-guardian.spec.md # Style Guardian (защита стиля)
│ ├── consolidate-agent.spec.md # ConsolidateAgent (память)
│ └── photo-analyst.spec.md # Photo Analyst (анализ фото)
├── docs/
│ ├── SOUL.md # Главный контракт
│ ├── settings.json # Конфигурация
│ └── BOOTSTRAP_SPEC.md # Спецификация развёртывания
└── ...
Преимущества:
- Чёткие контракты для каждого агента
- Защита от импульсивных изменений
- Связь с философией (применимые Законы Стандарта)
- Definition of Done для каждой задачи
Подробнее: Спецификации агентов
Как изменять контракты
Изменение любого из трёх документов — это Manual High-Risk действие. Процедура:
- MetaAgent предлагает изменение (на основе Lakatos Journal)
- Spec Mode: пишется
.spec.mdв директорииspecs/ - Verifier проверяет соответствие Четырём Законам Стандарта
- Style Guardian проверяет соответствие стилю
- Ты одобряешь через Approval Gate
- Implementation Mode: изменение применяется к файлу в
docs/ - Библия автоматически обновляется при следующем билде
Это прогрессирующая исследовательская программа (Lakatos), а не догма.
Seed Kit (флешка ONATOMIA_SETUP)
Копии этих же трёх файлов (плюс bootstrap.sh и specs/) хранятся на иммутабельной флешке. Это страховка от полного разрушения системы.
Если Mac mini умрёт:
- Форматируешь System SSD
- Устанавливаешь чистую macOS Sequoia
- Запускаешь
bootstrap.shс флешки - Том рождается с актуальным контрактом
Seed Kit синхронизируется с docs/ вручную (принцип copy-before-delete) после каждого обновления контрактов.
Связь с другими разделами
- Стандарт Онатомии — Четыре Закона, Artifex-centrismus, антропология
- Обзор архитектуры — как контракты используются агентами, тернарность, ООП
- Установка — как bootstrap.sh копирует контракты
- Справочник настроек — подробное описание каждого поля settings.json
- Защита Мастера — философия SOUL.md
- Градированная автономия — философия четырёх уровней
- Спецификации агентов — Spec-First подход