Техническая архитектура Онатомии

Как философия материализуется в коде — от Spec-First до тернарной логики

Дата: Август 2026 Статус: ACTIVE

Этот раздел описывает как принципы философии превращаются в работающий код. Здесь нет абстракций — только конкретные архитектурные решения, спецификации агентов и инструкции по установке.

1. Архитектура ядра

1.1. Триада и агенты

Онатомия построена вокруг триады:

• Она (Муза, правое полушарие) — источник вдохновения, не оптимизируется
• Том (Эмиссар, левое полушарие) — исполняет, оптимизирует, защищает
• Я (Мастер, Директор) — финальный арбитр, источник коллапсов

Агенты — это специализированные роли, каждый с чётким контрактом в specs/ (Spec-First подход Лампорта):

Подробнее: Спецификации агентов

1.2. Четыре Закона + Нулевой

Этический фундамент архитектуры. Переосмысление Трёх Законов Роботехники Азимова для триады Мастер-Муза-Эмиссар.

Иерархия строгая: 0 > 1 > 2 > 3

При конфликте — эскалация через Approval Engine к Мастеру. Все решения записываются в Lakatos Journal.

Подробнее: Стандарт Онатомии

1.3. Spec-First подход (Лампорт)

Принцип Лампорта:

“Most programmers jump straight to typing. Real engineers think first, specify second, code third.”

Каждый агент имеет отдельную спецификацию в specs/ (Contract-as-Code):

specs/
├── _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 (анализ фото)

Каждая спецификация содержит:

• Цель и критерии успеха
• Definition of Done
• Красные линии (что никогда не делать)
• Применимые Законы Стандарта (иерархия 0 > 1 > 2 > 3)
• Связь с философией (12 книг)
• Метрики качества
• Зависимости
• Анти-паттерны

Workflow MetaAgent:

1. Spec Mode (Thinking) — пишет .spec.md
2. Approval Gate — Мастер одобряет (Manual High-Risk)
3. Implementation Mode (Typing) — после одобрения пишет код

Подробнее: Спецификации агентов

1.4. Объектно-ориентированная структура

Онатомия мыслится объектно:

• Агенты — объекты с ответственностью, состоянием и контрактами в specs/
• SOUL.md и Четыре Закона — инварианты (условные “базовые классы”)
• Memvid frames — сущности с идентичностью и жизненным циклом
• Инкапсуляция — приватное Core защищено от публичного

Критическое ограничение: композиция важнее наследования. Мы не строим иерархию агентов-над-агентами (это был бы Kimi-swarm, смещающий рождение агентов от Мастера к системе). Агенты плоские — Мастер и специализированные роли, не порождающие друг друга.

ООП здесь — язык описания контрактов и инкапсуляции, а не соблазн строить классическую иерархию наследования.

1.5. Восемь петель обратной связи

Система определяется связями, не элементами (Meadows).

Подробнее: Feedback Loops

1.6. Память: Memvid Fiber Bundle

Что это: Single-file memory layer вместо серверной базы данных.

Почему Memvid:

• ChromaDB требовал отдельный процесс (200-500 MB RAM)
• Memvid работает in-process (0 MB extra)
• Append-only writes с timeline index
• Sub-5ms retrieval локально
• Version branching при изменении стиля
• Не редактируется задним числом — time-travel, branching, immutability

Три .mv2 файла:

ConsolidateAgent каждые 30 минут:

1. Читает неконсолидированные записи (tag=“unconsolidated”)
2. Находит связи (cross-reference)
3. Генерирует insights (compression = understanding)
4. Записывает консолидированные знания (tag=“consolidated”)
5. Помечает исходные записи как processed

Подробнее: Memvid Integration

2. Тернарность как принцип

2.1. Где система бинарна

Бинарная оболочка — жёсткие красные линии:

• Нулевой Закон (защита Творца)
• Первый Закон (защита Внутреннего Языка)
• Четыре Закона как инварианты
• Burnout Protection (§13)
• “Руки прочь от Core”
• Мастер спит — система стоит

Здесь ½ = катастрофа. Система не имеет права “сомневаться”, защищать ли Мастера.

2.2. Где система тернарна

Тернарная сердцевина — пространство сомнений и неоднозначности:

• Style Guardian: OWN (свой) / ALIEN (чужой) / UNCERTAIN (не уверен)
• Approval Engine: ALLOW / DENY / DEFER
• Оценка готовности работы: готово / не готово / под вопросом
• Классификация настроения: по эмоциональным тегам с возможностью “не определено”

Три состояния, эскалация с причиной, без фейковых чисел (не накопление уверенности с порогами 0.85/0.15 — это псевдо-точность).

2.3. Примеры тернарных решений

Style Guardian:

Вход: предложение MetaAgent
├── Оценка: OWN (высокая уверенность — голос Мастера)
│   └── Действие: пропустить дальше
├── Оценка: ALIEN (высокая уверенность — чужой стиль/симулякр)
│   └── Действие: блокировать + логировать
└── Оценка: UNCERTAIN (недостаточно оснований)
    └── Действие: DEFER + эскалация Мастеру с причиной

Approval Engine:

Вход: запрос на действие
├── ALLOW (1): разрешено, выполнить сразу
├── DENY (0): запрещено, отклонить + записать причину
└── DEFER (0.5): недостаточно оснований, эскалировать Мастеру
    ├── Причина: почему не хватает уверенности
    ├── Срок: когда пересмотреть
    └── Список недостающих данных

2.4. Бинарная оболочка вокруг тернарной сердцевины

Живое может быть не-бинарным только внутри жёсткой границы. Как клетка: мембрана жёсткая и бинарная (вещество либо внутри, либо снаружи), а внутри — живая, неопределённая, тернарная жизнь. Если мембрана станет мягкой — клетка умрёт.

Онатомия устроена так же:

• Бинарные Законы и красные линии — это мембрана, они жёсткие
• Тернарное пространство Внутреннего Языка — это цитоплазма, где может быть сомнение

Оболочка защищает сердцевину. Это не противоречие — это условие.

3. Стек

3.1. Локальность как красная линия

Приватность как инфраструктура (Ridley):

• ❌ Публичные облачные API (OpenAI, Anthropic) — запрещены
• ❌ Публичные relay (tunnelto.dev, ngrok) — запрещены
• ✅ Только локальные модели (Ollama)
• ✅ Только self-hosted relay (VPS или Tailscale Funnel)
• ✅ Полный audit trail для внешних запросов

3.2. Железо: Mac mini M1 16GB

3.3. Модельный стек

Текущая конфигурация:

"local_llm": {
  "analysis_model": "huihui_ai/qwen2.5-abliterated:7b",
  "execution_model": "huihui_ai/qwen2.5-abliterated:7b",
  "fallback_model": "huihui_ai/qwen2.5-abliterated:7b"
}

Roadmap (при стабильности ядра):

• MoE-модели с малым числом активных параметров (3B активных из 35B)
• Сильная квантизация (2-bit) для влезания в 16GB unified memory
• Gemma 4B как лёгкая модель для субагентов и vision

3.4. Memory Guard 3.0

• Лимит: 12 GB RAM для системы
• Предиктивный чанкинг: при >80% использования
• Auto-chunk size: 25 элементов (адаптивный)
• Emergency trigger: >90% → Emergency Mode

4. Установка / bootstrap

4.1. Seed Kit

Seed Kit — иммутабельный комплект рождения на флешке ONATOMIA_SETUP:

seed-kit/
├── SOUL.md                     # Контракт Мастера
├── settings.json               # Конфигурация (12 книг)
├── BOOTSTRAP_SPEC.md           # Спецификация развёртывания (15 шагов)
├── bootstrap.sh                # Скрипт установки (исполняемый)
├── specs/                      # Spec-First директория
│   ├── _template.spec.md
│   ├── meta-agent.spec.md
│   ├── style-guardian.spec.md
│   ├── consolidate-agent.spec.md
│   └── photo-analyst.spec.md
├── README.md                   # Описание комплекта
└── MANIFEST.md                 # Манифест (размеры файлов, даты)

4.2. Быстрый старт

# 1. Клонируй Seed Kit с флешки
cp -R /Volumes/ONATOMIA_SETUP/seed-kit/* ~/Documents/Onatomia/

# 2. Запусти bootstrap
cd ~/Documents/Onatomia
./bootstrap.sh

4.3. Что делает bootstrap.sh

1. Проверяет контракты (SOUL.md, settings.json, BOOTSTRAP_SPEC.md)
2. Устанавливает базовую среду (Homebrew, Python 3.12, Ollama)
3. Устанавливает Rust + Memvid SDK + tunnelto
4. Создаёт структуру проекта
5. Настраивает Python venv и зависимости
6. Копирует specs/ директорию (Spec-First)
7. Загружает LLM (Qwen 7B)
8. Инициализирует Memvid fiber bundle (3 .mv2 файла)
9. Инициализирует Public/Private eval split
10. Настраивает права доступа
11. Активирует LaunchAgents (рефлексы)
12. Создаёт BORN.flag

Подробнее: Installation Guide

4.4. BORN.flag

Флаг успешного развёртывания. Создаётся только после прохождения всех 15 шагов bootstrap. Обнуляет хронометраж Обсерватории на реальную дату рождения.

5. Обсерватория «Внутренний Мир»

5.1. Прибор Наблюдателя

Локальный прибор для визуализации состояния системы. НЕ публичный, НЕ деплоится на Cloudflare Pages.

observatory/
├── index.html          # Один HTML-файл с встроенным CSS/JS
└── logo-amber.svg      # Знак Онатомии (SSOT — копия из docs/public/logo.svg)

Открывается двойным кликом в браузере. Работает полностью офлайн.

5.2. Что визуализирует

• Гироскоп — три кольца (ядро горит, пока Наблюдатель присутствует)
• Приборы — коллапсы, когнитивная нагрузка, биофилия/гордость
• Агенты — 4 карточки с LED-индикаторами статуса
• Петли обратной связи — 8 узлов с пульсирующим сигналом
• Шкала миссии — Foundation → Practice → Seed (Наследие)
• Счётчик заметок — новые/всего (пульс инбокса)
• Кнопка +1 ГОРДОСТЬ! — внутренний источник валидации

5.3. Принцип Наблюдателя

Система без Творца = волновая функция без коллапса.

Метрика здоровья системы — не “сколько агентов работает”, а “сколько коллапсов произошло на этой неделе”. Если коллапсов = 0 — Мастер стал администратором, не Творцом. Это сигнал активировать Burnout Protection или 7 защит.

6. Roadmap и границы

6.1. Таблица: Старт / Roadmap / Не наше

6.2. Принцип: публичная Библия описывает РЕАЛЬНОЕ

Этот раздел — не симулякр будущего, а честное описание того, что уже построено (Старт) и что запланировано при условии стабильности (Roadmap).

Условия входа в Roadmap:

• Ядро стабильно работает N недель
• Метрика Освобождение растёт (сэкономлено vs потрачено)
• Мастер остаётся финальным арбитром
• Нет паралича подготовки (specs +3, output = 0)

6.3. Что сознательно НЕ НАШЕ

Agent Swarms (Kimi-паттерн, где оркестратор динамически создаёт субагентов):

• Смещает locus рождения агентов от Мастера к системе
• Противоречит Spec-First (агенты рождаются от решения Мастера, не от решения оркестратора)
• Превращает Онатомию из альтер-эго в самостоятельную сущность

Полный открытый RSI / AGI:

• Требует пожертвовать Нулевым Законом (защита Творца)
• Метрика “умность системы” заменяет метрику “количество настоящих коллапсов Мастера”
• Противоречит ДНК Онатомии

7. Связь с философией

7.1. Базовые семь книг

• Meadows → Восемь петель обратной связи
• McGilchrist → Style Guardian + Verifier + Soul Check
• Hamming → Preserved Thinking (Memvid fiber bundle)
• Lakoff → Metaphor Monitor
• Ridley → Post-Memory-Heist hardening (приватность как инфраструктура)
• Johnstone → Градированная автономия (Yes, and… к ограничениям)
• Lakatos → Лакатосовский журнал опровержений (public/private split)

7.2. Пять дополнительных книг

• Тьюринг (1950) → Принцип Наблюдателя, Императив Семени (Child Machine)
• Азимов (1942/1985) → Четыре Закона Стандарта Онатомии
• Фромм (1973) → Биофилия, 7 защит от самоуничтожения (§14)
• Бодрийяр (1981) → Диагностика симулякров, защита подлинности
• Лампорт (2002) → Spec-First директория specs/

Подробнее: Философия и Двенадцать книг

8. Контракты (Single Source of Truth)

Все технические решения зафиксированы в четырёх контрактах:

1. SOUL.md — контракт Мастера (Четыре Закона, триада, миссия, Burnout Protection, 7 защит)
2. settings.json — конфигурация системы (12 книг, агенты, петли, лимиты)
3. BOOTSTRAP_SPEC.md — спецификация развёртывания (15 шагов, включая specs/)
4. specs/ — спецификации агентов (Spec-First, Contract-as-Code расширенный)

Библия читает эти файлы напрямую (Contract-as-Code). Изменения требуют Approval Gate (Manual High-Risk).

Структура проекта

~/Documents/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 (анализ фото)
├── .onatomia/                      # Скрытый стек управления
│   ├── SOUL.md                     # Контракт Мастера
│   ├── settings.json               # Конфигурация (12 книг)
│   ├── BOOTSTRAP_SPEC.md           # Спецификация развёртывания
│   ├── bootstrap.sh                # Скрипт установки
│   ├── hooks/                      # LaunchAgents (.plist)
│   ├── agents/                     # Markdown-инструкции для субагентов
│   └── BORN.flag                   # Флаг успешного развёртывания
├── core/                           # Ядро
│   ├── local_llm.py                # Локальный LLM (dual-model ready)
│   ├── imessage_bridge.py          # Мост к iMessage
│   ├── feedback_loops.py           # Восемь петель обратной связи
│   ├── style_guardian.py           # Защитник стиля (DPR + CLIP)
│   ├── memory_layer.py             # Memvid integration
│   └── sanitization.py             # Sanitization pipeline
├── agents/                         # Агенты
│   ├── meta_agent.py               # Главный агент (AIDE² outer loop)
│   ├── uploader_agent.py           # Загрузчик на стоки
│   ├── style_guardian_agent.py     # Агент-защитник стиля
│   ├── revenue_analyst.py          # Аналитик доходов
│   ├── opportunity_scout.py        # Разведчик возможностей
│   └── consolidate_agent.py        # Консолидация памяти
├── scripts/                        # Утилиты
│   ├── human_review.py             # Обработка Approval Gates
│   ├── stock_scout.py              # Разведка стоков
│   ├── lakatos_journal.py          # Журнал опровержений
│   ├── metaphor_monitor.py         # Монитор метафор
│   ├── tunnelto_manager.py         # Управление веб-доступом
│   └── immich_importer.py          # Миграция из Immich
├── memory/                         # Memvid fiber bundle
│   ├── onatomia_memory.mv2         # Основная память системы
│   ├── style_reference.mv2         # Эталонные работы
│   └── immich_seed.mv2             # Мигрированные данные
├── observatory/                    # Прибор Наблюдателя (локальный)
│   ├── index.html                  # HTML/CSS/JS в одном файле
│   └── logo-amber.svg              # Знак Онатомии
├── logs/                           # Логи, JSONL, state
│   ├── human_review_log.jsonl      # PUBLIC лакатосовский журнал
│   ├── soul_check_private.jsonl    # PRIVATE Soul Check
│   ├── consolidation_log.jsonl     # История консолидации
│   └── external_requests.jsonl     # Audit trail
└── .venv/                          # Изолированное окружение Python

Режимы работы

Градированная автономия (4 уровня)

Подробнее: Autonomy Tiers

Этот раздел — не статичная документация. Он эволюционирует вместе с системой. Каждая глава проверяется эмпирически через лакатосовский журнал опровержений и обновляется после каждой фазы Roadmap.