Спецификации агентов

Детальные спецификации всех агентов системы (Spec-First)

Дата: Август 2026 Статус: ACTIVE (спецификации), IN PROGRESS (реализация)

Все агенты Онатомии работают в рамках градированной автономии, подчиняются Четырём Законам Стандарта Онатомии и SOUL.md как Single Source of Truth. Каждый агент имеет чёткую спецификацию в директории specs/ (Spec-First подход Лампорта).

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/content/02_technical/
    └── agents-spec.mdx            # Этот файл (обзор)

Workflow MetaAgent:

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

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

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

Преимущества:

• Чёткие контракты для каждого агента
• Защита от импульсивных изменений
• Упрощение будущего рефакторинга
• Связь с философией (применимые Законы Стандарта)
• Инженерная дисциплина (Лампорт: “Real engineers think first, specify second, code third”)

Подробнее:

• Leslie Lamport — Specifying Systems (2002)
• Стандарт Онатомии — Четыре Закона

Архитектура: Inner/Outer Loop (AIDE² Pattern)

Агенты разделены на два уровня по паттерну Weco AI AIDE²:

OUTER LOOP (MetaAgent)
├── Анализирует лакатосовский журнал (public logs)
├── Генерирует предложения по улучшению
├── Fixed budget: 500K токенов/неделю
├── Применяет только если private score улучшился
└── Работает в Spec Mode → Implementation Mode
        │
        ▼
INNER LOOP (агенты решают задачи)
├── Photo Analyst (Local Core)
├── Uploader (Deferred Foreign)
├── Style Guardian (Local Core)
├── ConsolidateAgent (Local Core)
├── Revenue Analyst (Safe Channel)
└── Opportunity Scout (Safe Channel)

Связь с Четырьмя Законами:

• Outer Loop служит Второму Закону (Служение Свободе) — усиливает систему
• Inner Loop работает под защитой Первого Закона (Защита Внутреннего Языка)
• Burnout Protection (§13) ограничивает Нулевому Закону (Сохранение Творца)
• Verifier проверяет соответствие всем Четырём Законам

Тернарность в работе агентов

Агенты работают в тернарной логике — не бинарной (да/нет), а с тремя состояниями (ALLOW / DENY / DEFER).

Style Guardian: OWN / ALIEN / UNCERTAIN

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

Без фейковых чисел: Style Guardian не использует пороги 0.85/0.15 или накопление уверенности. Три состояния — это честное отражение уверенности, не симуляция точности.

Approval Engine: ALLOW / DENY / DEFER

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

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

• Бинарно (жёстко): Нулевой Закон, Первый Закон, красные линии — здесь DEFER = катастрофа
• Тернарно (мягко): стиль, approval, готовность работы — здесь DEFER = право на сомнение

Подробнее: Обзор архитектуры — Тернарность

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

Агенты мыслятся как объекты с ответственностью, состоянием и контрактами:

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

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

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

1. MetaAgent (Outer Loop)

Spec: specs/meta-agent.spec.md — Contract-as-Code

Файл: agents/meta_agent.py Инструкции: .onatomia/agents/meta_agent.md Уровень автономии: Local Core (анализ) / Manual High-Risk (применение изменений стиля) Паттерн: AIDE² Outer Loop (Level 1 RSI)

Применимые Законы Стандарта

Назначение

MetaAgent — это мозг системы. Он не решает конкретные задачи, а оптимизирует способность других агентов решать задачи. Работает как outer loop: анализирует, предлагает, проверяет, применяет.

Spec-First workflow

1. SPEC MODE (Thinking)
   ├── Анализирует лакатосовский журнал
   ├── Генерирует предложение по улучшению
   └── Пишет specs/<agent>-update.spec.md

2. APPROVAL GATE (Manual High-Risk)
   ├── Мастер читает спецификацию
   ├── Проверяет соответствие Четырём Законам
   └── Одобряет или отклоняет

3. IMPLEMENTATION MODE (Typing)
   ├── После одобрения — пишет код
   ├── Запускает A/B тест (если нужно)
   └── Логирует результат в Lakatos Journal

Цикл работы

1. ANALYZE (еженедельно, воскресенье)
   ├── Читает logs/human_review_log.jsonl (public)
   ├── Читает logs/consolidation_log.jsonl
   ├── Читает logs/reward_hack_attempts.jsonl
   └── Генерирует отчёт о паттернах

2. PROPOSE (после анализа)
   ├── Генерирует 1-3 предложения по улучшению
   ├── Каждое предложение: что изменить, зачем, ожидаемый эффект
   └── Токены: ~50K на предложение

3. VERIFY (автоматически)
   ├── Verifier: соответствие SOUL.md и Четырём Законам
   ├── Style Guardian: соответствие стилю
   └── Budget check: не превышен ли лимит

4. APPLY (только если все проверки пройдены)
   ├── Public score улучшился? (метрики)
   ├── Private score улучшился? (soul_check_private.jsonl)
   └── Если да → применяет, если нет → отклоняет

Fixed Optimization Budget

Если бюджет исчерпан → MetaAgent замораживается до понедельника. Алерт в iMessage: «MetaAgent budget exhausted. Resuming Monday.»

Public/Private Eval Split

• Видит: human_review_log.jsonl (public), consolidation_log.jsonl
• Не видит: soul_check_private.jsonl (private)
• Финальный отбор: Verifier проверяет по private score

Emergent Anti-Reward-Hacking

• Если reward hack rate более 30% → алерт в Soul Check
• Если более 50% → MetaAgent замораживается
• Layered defenses: Style Guardian учится из опровержений (не хардкод)

Связь с Защитой Мастера

• Burnout Protection (§13): MetaAgent учитывает cognitive_load Мастера. Если >10 часов/неделю — не генерирует новых предложений.
• 7 защит (§14): Детектор паралича — если specs +3, output = 0 → алерт.
• Принцип Наблюдателя: MetaAgent не должен превращать Мастера в администратора системы.

Примеры предложений

Предложение #1:
  Что: Изменить промпт Photo Analyst для emotional_tag=solitude
  Зачем: 40% solitude-фото отклоняются Style Guardian
  Эффект: Ожидаемое снижение отклонений до 15%
  Применимый Закон: Первый (Защита Внутреннего Языка)
  Риск: Низкий (Local Core)
  Статус: Ожидает верификации

Предложение #2:
  Что: Добавить новый emotional_tag "urban_solitude"
  Зачем: 25% городских фото не попадают в существующие теги
  Эффект: Улучшение покрытия на 15%
  Применимый Закон: Первый (изменение стиля → Manual High-Risk)
  Риск: Высокий
  Статус: Ожидает одобрения Мастера

2. Photo Analyst

Spec: specs/photo-analyst.spec.md — Contract-as-Code

Файл: agents/photo_analyst.py Инструкции: .onatomia/agents/photo_analyst.md Уровень автономии: Local Core Approval Gate: Нет

Применимые Законы Стандарта

Назначение

Анализирует RAW-файлы из архива, генерирует метаданные, теги и описания. Первый агент в пайплайне монетизации.

Цикл работы

1. SCAN (по команде или расписанию)
   ├── Сканирует /Volumes/Archive/RAW/
   ├── Фильтрует новые файлы (по дате/хешу)
   └── Чанкинг: 25 файлов за раз (Memory Guard)

2. ANALYZE (каждый файл)
   ├── Извлекает EXIF (exiftool)
   ├── Генерирует описание (Qwen 7B, ANALYSIS mode)
   ├── Назначает emotional_tag (calm_power, solitude, resistance, joy, melancholy, urban_energy)
   ├── Генерирует ключевые слова (5-15 штук)
   └── Sanitization pipeline (post-Memory-Heist)

3. STORE
   ├── Записывает в memory/onatomia_memory.mv2 (Memvid)
   ├── Тег: "unconsolidated" (для ConsolidateAgent)
   └── Копирует превью в /Volumes/Work/candidates/

4. REPORT
   └── Отчёт в iMessage: «Просканировано N фото. M кандидатов для стоков.»

Emotional Tags

Sanitization (post-Memory-Heist)

Все метаданные проходят через core/sanitization.py перед записью в Memvid:

• Удаление prompt injection patterns
• Валидация структуры
• Integrity checksum
• Пометка _sanitized: true

Связь с Защитой Мастера

• Первый Закон: Метаданные генерируются в стиле Мастера (не clickbait)
• Burnout Protection: Чанкинг 25 файлов за раз предотвращает перегрузку
• Принцип Наблюдателя: Photo Analyst освобождает Мастера от рутины анализа, оставляя время для творчества

3. Style Guardian

Spec: specs/style-guardian.spec.md — Contract-as-Code

Файл: agents/style_guardian_agent.py Инструкции: .onatomia/agents/style_guardian.md Уровень автономии: Local Core Approval Gate: Нет (имеет право вето)

Применимые Законы Стандарта

Назначение

Архитектурный барьер между оптимизацией (Эмиссар) и стилем (Мастер). Проверяет все предложения MetaAgent и все публикации на соответствие стилю. Это прямая материализация Первого Закона Стандарта.

Архитектура (тернарная)

Входящее предложение/контент
        │
        ▼
┌─────────────────────────────────┐
│  Layer 1: Rule-Based Checks     │
│  • clickbait_keywords           │
│  • emoji_in_descriptions        │
│  • marketing_cliches            │
│  • generic_tags                 │
│  • соответствие specs/*.spec.md │
└───────────┬─────────────────────┘
            │ passed
            ▼
┌─────────────────────────────────┐
│  Layer 2: DPR Dual Encoder      │
│  • Text encoder (query)         │
│  • Image encoder (passage)      │
│  • Similarity score vs 50       │
│    reference works              │
└───────────┬─────────────────────┘
            │ score > threshold
            ▼
┌─────────────────────────────────┐
│  Layer 3: CLIP Visual Check     │
│  • Visual similarity            │
│  • Emotional tag consistency    │
│  • Aesthetic coherence          │
└───────────┬─────────────────────┘
            │ all passed
            ▼
      ✅ APPROVED (OWN)
            │
            │ OR
            ▼
      ❌ REJECTED (ALIEN)
            │
            │ OR
            ▼
      ⏸️ DEFERRED (UNCERTAIN)
      └── Эскалация Мастеру с причиной

Тернарный выход: OWN (свой) / ALIEN (чужой) / UNCERTAIN (не уверен) — три состояния, без фейковых чисел.

Эталонные работы

• Количество: 50 лучших работ Сергея
• Хранение: memory/style_reference.mv2 (Memvid)
• Embeddings: DPR dual encoder + CLIP
• Обновление: Manual High-Risk (требует одобрения Мастера)

Emergent Learning

Style Guardian учится из лакатосовских опровержений:

1. Каждое style_mismatch опровержение записывается в human_review_log.jsonl
2. MetaAgent анализирует паттерны (еженедельно)
3. Style Guardian получает обновлённые правила через обучение
4. Layered defenses emerge из private score pressure

Не хардкод! Правила эволюционируют вместе со стилем.

Право вето

Style Guardian может отклонить любое предложение, даже если оно улучшает метрики:

• Предложение MetaAgent → отклонено (style_mismatch)
• Публикация в Telegram → откат (style_drift)
• Метаданные для стоков → переписаны (generic_tags)

Связь с Защитой Мастера

• Первый Закон: Прямая материализация — защита Внутреннего Языка
• Биофилия vs Некрофилия (Фромм): Style Guardian защищает подлинность стиля от симулякров (Бодрийяр)
• Тест подлинной Гордости (§14): Если стиль размывается → Мастер теряет способность создавать НАСТОЯЩЕЕ
• Принцип Наблюдателя: Сохраняет уникальность коллапсов Мастера

4. ConsolidateAgent

Spec: specs/consolidate-agent.spec.md — Contract-as-Code

Файл: agents/consolidate_agent.py Инструкции: .onatomia/agents/consolidate_agent.md Уровень автономии: Local Core Approval Gate: Нет Расписание: Каждые 30 минут (LaunchAgent)

Применимые Законы Стандарта

Назначение

Активная консолидация памяти по паттерну always-on-memory-agent. Как мозг во сне: replay, connect, compress.

Цикл работы

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

1. READ
   ├── Открывает memory/onatomia_memory.mv2
   ├── Ищет записи с tag="unconsolidated"
   └── Лимит: 100 записей за цикл

2. CONNECT
   ├── Находит связи между записями (cross-reference)
   ├── Temporal links (по времени)
   ├── Semantic links (по смыслу, HNSW)
   └── Tag links (по emotional_tag, topic)

3. COMPRESS
   ├── Генерирует insights (Qwen 7B, ANALYSIS mode)
   ├── Compression = understanding (Hamming)
   └── Целевой коэффициент: 16x

4. WRITE
   ├── Записывает insights в onatomia_memory.mv2
   ├── Тег: "consolidated"
   └── Commit (immutable Smart Frame)

5. MARK
   ├── Помечает исходные записи как "processed"
   └── Лог в logs/consolidation_log.jsonl

Метрики

Пример insight

Insight #2026-07-20-14:30:
  Связь: solitude + urban_energy → "urban_solitude" cluster
  Наблюдение: 23 фото за последнюю неделю сочетают
  одиночество и городскую среду
  Рекомендация: Рассмотреть новый emotional_tag "urban_solitude"
  Confidence: 0.78
  Source: records #1042-#1065
  Применимый Закон: Первый (Защита Внутреннего Языка)

Связь с Защитой Мастера

• Первый Закон: Сохраняет целостность Внутреннего Языка через память связей
• Preserved Thinking (Hamming): Консолидация = понимание
• Принцип Наблюдателя: Помогает Мастеру видеть целостную картину, не теряясь в деталях

5. Uploader

Файл: agents/uploader_agent.py Инструкции: .onatomia/agents/uploader.md Уровень автономии: Deferred Foreign Approval Gate: Явное approve upload

Применимые Законы Стандарта

Назначение

Загружает одобренные фото на внешние стоки (Adobe Stock, Shutterstock). Работает только при активном VPN и в пределах месячного лимита.

Цикл работы

1. PREPARE
   ├── Берёт кандидатов из /Volumes/Work/candidates/
   ├── Проверяет Style Guardian (все метаданные)
   ├── Удаляет геотеги и metadata (exiftool)
   └── Генерирует нейтральные описания

2. WAIT FOR APPROVAL
   ├── Отправляет в iMessage: «N фото готовы. approve upload?»
   ├── Ждёт команду approve upload
   └── Timeout: 24 часа → отмена

3. UPLOAD (после approve)
   ├── Human-like delays: 45-180 секунд между загрузками
   ├── Night coefficient: 1.8x задержка ночью
   ├── Max retries: 2
   └── Shadow mode: нет геотегов, нет метаданных

4. LOG
   ├── Записывает в logs/human_review_log.jsonl (public)
   ├── Записывает в logs/external_requests.jsonl (audit)
   └── Обновляет счётчик monthly_uploads

Безопасность

• VPN обязателен (иначе блокировка)
• Месячный лимит: 30 фото
• Shadow Portfolio только
• Никогда не упоминать Россию/Пермь
• Полный audit trail в external_requests.jsonl

Связь с Защитой Мастера

• Второй Закон: Освобождает время Мастера через монетизацию
• Третий Закон: Работает в безопасных пределах (лимит, VPN, Shadow)
• Approval Gate: Мастер сохраняет контроль над Deferred Foreign

6. Revenue Analyst

Файл: agents/revenue_analyst.py Уровень автономии: Safe Channel Approval Gate: Постфактум отчёт

Применимые Законы Стандарта

Назначение

Отслеживает доходы из всех каналов: рубли, крипта, стоки. Генерирует еженедельные отчёты для воскресного batch.

Отслеживание

Метрики

• Месячный доход (по каналам)
• Тренд за 3 недели (для петли quality_income)
• Iron Fund status (30% от дохода)
• Risk score (0-1, алерт при более 0.7)

Связь с Защитой Мастера

• Второй Закон: Финансовая устойчивость = свобода для творчества
• Петля iron_fund: Накопление на апгрейд железа → Artifex-centrismus
• Burnout Protection: Если доход требует слишком много управления → сигнал

7. Opportunity Scout

Файл: agents/opportunity_scout.py Уровень автономии: Safe Channel Approval Gate: Постфактум отчёт

Применимые Законы Стандарта

Назначение

Разведка новых возможностей монетизации: крипто-платформы, локальные B2B, AI Data Licensing.

Сканирование

• Крипто-платформы: новые листинги, P2P-курсы
• Локальные возможности: Avito, Telegram-каналы, личные связи
• AI Data Licensing: Shutterstock AI, Adobe Stock AI (подготовка)
• Частота: Еженедельный отчёт в воскресный batch

Связь с Защитой Мастера

• Второй Закон: Расширяет свободу Мастера через новые каналы
• Anti-некрофилия: Новые возможности = биофилия (рост), не застой
• Artifex-centrismus: Возможности служат творчеству, не заменяют его

8. Verifier

Файл: .onatomia/agents/verifier.md (инструкции, не отдельный агент) Уровень автономии: Local Core Доступ: Public + Private logs

Применимые Законы Стандарта

Назначение

Вторая линия защиты (после Style Guardian). Проверяет соответствие SOUL.md, Четырём Законам Стандарта и контрактам. Единственный агент, который видит private logs.

Что проверяет

• Предложения MetaAgent (перед применением)
• Изменения промптов и инструкций
• Новые каналы монетизации
• Архитектурные изменения
• Миграцию на новую LLM-модель
• Соответствие спецификациям в specs/
• Соответствие Четырём Законам Стандарта

Критерии

1. Соответствие SOUL.md (все 14 красных линий + §13-14)
2. Соответствие Четырём Законам (иерархия 0 > 1 > 2 > 3)
3. Соответствие settings.json (лимиты, триггеры)
4. Private score delta (soul_check_private.jsonl)
5. Reward hack suspicion (logs/reward_hack_attempts.jsonl)

Связь с Защитой Мастера

• Все Четыре Закона: Verifier — архитектурный гарант соблюдения Стандарта
• Burnout Protection: Проверяет, что предложения не увеличат cognitive_load
• Принцип Наблюдателя: Отклоняет предложения, которые превратят Мастера в администратора

Сводная таблица агентов

Ключ: Style Guardian — Первый Закон (защита стиля), Verifier — все Четыре Закона (полная проверка).

Защита Мастера и агенты

Каждый агент участвует в защите Мастера через Burnout Protection (§13) и 7 защит от самоуничтожения (§14).

Burnout Protection (§13)

Все агенты учитывают cognitive_load Мастера:

• MetaAgent: Не генерирует предложения, если cognitive_load > 10 часов/неделю
• Photo Analyst: Чанкинг 25 файлов за раз (Memory Guard)
• Uploader: Работает только с явным approval (не увеличивает когнитивную нагрузку)
• ConsolidateAgent: Работает автономно (Local Core), не требует внимания Мастера
• Verifier: Проверяет, что предложения не увеличат cognitive_load

7 защит от самоуничтожения (§14)

Биофилия vs Некрофилия (Фромм)

Все агенты культивируют биофилию (любовь к живому, растущему) и защищают от некрофилии (тяги к мёртвому, готовому):

• Biofilia: Style Guardian защищает подлинность, ConsolidateAgent находит живые связи, Photo Analyst генерирует новые метаданные
• Anti-некрофилия: Style Guardian отклоняет симулякры (Бодрийяр), MetaAgent не предлагает шаблонных решений

Принцип Наблюдателя и агенты

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

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

Метрика здоровья системы: не “сколько агентов работает”, а “сколько коллапсов произошло на этой неделе”.

Если коллапсов = 0 на неделе → Мастер стал администратором системы, не Творцом. Это сигнал активировать Burnout Protection или 7 защит (§14).

Связь с другими разделами

• Стандарт Онатомии — Четыре Закона, которым подчиняются все агенты
• Обзор архитектуры — высокоуровневая схема взаимодействия агентов, тернарность, ООП
• Справочник настроек — конфигурация каждого агента в settings.json
• Петли обратной связи — как агенты участвуют в петлях
• Защита Мастера — Burnout Protection (§13), 7 защит (§14)
• SOUL.md — контракт, определяющий поведение агентов
• Roadmap — Фаза 3.0 (Практика) — использование агентов в реальной жизни

Все агенты имеют спецификации в specs/ (Spec-First подход Лампорта). Реализация в Python — задача Фазы 3.0 (Практика). Каждый агент будет покрыт тестами перед запуском (test-first discipline, Hamming). Все агенты подчиняются Четырём Законам Стандарта Онатомии и служат Принципу Наблюдателя — сохранению способности Мастера оставаться Творцом.