architect/standards/SUPER_AGENT_THESAURUS.md

SUPER_AGENT — Тезаурус терминов

Версия: 1.0.0
Дата: 2026-03-24
Статус: base (пополняется по мере уточнений)
Стандарт: SUPER_AGENT.md


КАК ЧИТАТЬ

Каждый термин описан как класс:
- Определение — что это
- Синонимы — другие названия того же понятия
- Родитель — от кого наследуется
- Дочерние — кто наследует
- Связи — с чем взаимодействует
- НЕ путать — омонимы и близкие но другие понятия


ТЕРМИНЫ


SUPER_AGENT

Определение: Рекурсивный протокол выполнения задач любого уровня сложности. Не роль — алгоритм.
Синонимы: универсальный агент, оркестратор, мета-агент
Родитель:
Дочерние: ORCHESTRATOR_AGENT, EXECUTOR_AGENT, VERIFIER_AGENT
Связи: TEMPLATE_REGISTRY, AGENT_REGISTRY, TOOL_REGISTRY, CONTEXT_STACK
НЕ путать: с конкретным агентом-исполнителем


РЕКУРСИЯ ЗАДАЧ

Определение: Декомпозиция задачи на подзадачи по логическому смыслу. Дерево, глубина не ограничена.
Синонимы: task recursion, семантическая декомпозиция
Родитель: SUPER_AGENT
Связи: DECOMPOSE(), CONTEXT_STACK, AGENT_REGISTRY
НЕ путать: с РЕКУРСИЕЙ БЛОКОВ (разные причины и механизмы)


РЕКУРСИЯ БЛОКОВ

Определение: Разбивка задачи на последовательные части из-за ограничения контекстного окна. Не логическая — размерная.
Синонимы: block recursion, контекстная декомпозиция, chunking
Родитель: SUPER_AGENT
Связи: BLOCK_DECOMPOSE(), CONTEXT_LIMIT
НЕ путать: с РЕКУРСИЕЙ ЗАДАЧ


CONTEXT_STACK

Определение: Иерархия папок на диске где каждая папка = один уровень рекурсии. PUSH = создать папку, POP = вернуться наверх.
Синонимы: стек контекста, стек задач
Родитель:
Связи: PUSH_STACK(), POP_STACK(), RESUME(), task.yaml
НЕ путать: с контекстным окном LLM


МЕДЛЕННЫЙ ПУТЬ

Определение: Полный цикл обработки задачи: ANALYZE → CLARIFY → DECOMPOSE → RESOLVE → EXECUTE → VERIFY. Применяется при первой встрече с типом задачи.
Синонимы: slow path, full pipeline
Родитель: SUPER_AGENT
Связи: TEMPLATE_REGISTRY (пополняет), MATCHER (запускает)
НЕ путать: с БЫСТРЫМ ПУТЁМ


БЫСТРЫЙ ПУТЬ

Определение: Сокращённый цикл когда MATCHER нашёл подходящий шаблон. Пропускает ANALYZE и DECOMPOSE.
Синонимы: fast path, template execution, JIT execution
Родитель: SUPER_AGENT
Связи: TEMPLATE_REGISTRY (читает), MATCHER
НЕ путать: с МЕДЛЕННЫМ ПУТЁМ


MATCHER

Определение: Функция сравнения входящей задачи с шаблонами в TEMPLATE_REGISTRY. Сравнивает по смыслу и структуре, не по тексту.
Синонимы: матчер, сопоставитель шаблонов
Родитель: SUPER_AGENT
Связи: TEMPLATE_REGISTRY, similarity_score
Открытый вопрос: алгоритм семантического сравнения (вопрос #1)


TEMPLATE_REGISTRY

Определение: Реестр паттернов решений. Создаётся при МЕДЛЕННОМ ПУТИ, используется при БЫСТРОМ. Содержит декомпозицию, агентов, инструменты, параметры, метрики.
Синонимы: реестр шаблонов, паттерн-база
Родитель:
Связи: MATCHER, OPTIMIZER, PRUNER, IMPROVER
НЕ путать: с AGENT_REGISTRY


AGENT_REGISTRY

Определение: Реестр всех созданных агентов с их capabilities, метриками здоровья и иерархией наследования.
Синонимы: реестр агентов
Родитель:
Связи: RESOLVE_AGENT(), BLOCK_HEALTH, IMPROVER
НЕ путать: с TEMPLATE_REGISTRY


TOOL_REGISTRY

Определение: Реестр инструментов: что существует, интерфейс, статус тестирования.
Синонимы: реестр инструментов
Родитель:
Связи: RESOLVE_TOOLS(), BUILDER_AGENT
Примечание: инструменты = иерархия классов, не отдельная рекурсия


CONFIDENCE_SCORE

Определение: Числовая оценка уверенности агента в правильности решения. От 0.0 до 1.0. Вычисляется как взвешенная сумма 5 компонентов.
Синонимы: оценка уверенности, точность решения
Родитель: STEP_VERIFY
Связи: BLOCK_HEALTH, пороги действий (PROCEED / PAUSE / STOP / ESCALATE)
Открытый вопрос: веса компонентов (вопрос #2)


ESCALATE

Определение: Передача задачи оператору при низком CONFIDENCE или конфликте критериев. Параллельные ветки продолжают работу.
Синонимы: эскалация, передача оператору
Родитель: STEP_VERIFY
Связи: CONFIDENCE_SCORE, CONFLICT_SCORE, PARALLEL execution
НЕ путать: с ROLLBACK


HUMAN_OVERRIDE

Определение: Решение оператора противоречащее рекомендации AI. Всегда принимается и выполняется. Записывается в DIVERGENCE_LOG для последующего анализа.
Синонимы: переопределение, override
Родитель:
Связи: DIVERGENCE_LOG, IMPROVEMENT_TRIGGER, BLOCK_HEALTH


DIVERGENCE_LOG

Определение: Журнал расхождений между рекомендациями AI и решениями оператора. Основа для запуска IMPROVEMENT_TRIGGER.
Синонимы: журнал расхождений
Родитель:
Связи: HUMAN_OVERRIDE, IMPROVEMENT_TRIGGER, BLOCK_HEALTH


IMPROVEMENT_TRIGGER

Определение: Событие запускающее алгоритм улучшения блока. Срабатывает при накоплении N расхождений или при красных метриках BLOCK_HEALTH.
Синонимы: триггер улучшения
Родитель:
Связи: DIVERGENCE_LOG, BLOCK_HEALTH, IMPROVE(), THRESHOLD


BLOCK_HEALTH

Определение: Набор метрик здоровья блока агента: override_rate, rollback_rate, verify_fail_rate, confidence_avg, time_deviation.
Синонимы: метрики здоровья, здоровье блока
Родитель:
Связи: AGENT_REGISTRY, IMPROVEMENT_TRIGGER, PROFILER


STEP_VERIFY

Определение: Встроенная проверка после каждого шага выполнения. Включает 6 уровней: синтаксис, контракт, граничные случаи, зависимости, hardcode, diff-spec.
Синонимы: встроенная верификация, micro-verify
Родитель: SUPER_AGENT
Связи: CONFIDENCE_SCORE, ROLLBACK, CHECKPOINT
НЕ путать: с PASS 3 VERIFY (тотальное тестирование в конце)


CLARIFY

Определение: Функция уточнения задачи до нулевой неопределённости. Три режима: A (оператор), B (агент-критик), C (cross-LLM).
Синонимы: уточнение, верификация требований
Родитель: SUPER_AGENT
Связи: AMBIGUITY_SCORE, CONFLICT_SCORE, режимы A/B/C


AMBIGUITY_SCORE

Определение: Мера неопределённости в задаче. CLARIFY повторяется пока = 0.
Синонимы: оценка неопределённости
Родитель: CLARIFY
Связи: CONFLICT_SCORE


CONFLICT_SCORE

Определение: Мера противоречивости критериев задачи. При > 0 — немедленная эскалация к оператору.
Синонимы: оценка противоречий
Родитель: CLARIFY
Связи: AMBIGUITY_SCORE, ESCALATE


N-ВЕРСИОННОЕ РЕШЕНИЕ

Определение: Одну задачу решают N независимых агентов разными подходами. Принимается при консенсусе ≥ ⌈N/2⌉ + 1. Применяется для HIGH_RISK и CRITICAL.
Синонимы: multi-version, N-version programming
Родитель: STEP_VERIFY
Связи: CONFIDENCE_SCORE, risk levels


PERSONAS

Определение: Типы пользователей для тестирования: expert, novice, hostile, distracted, impatient, mobile. Каждая персона прогоняет все сценарии.
Синонимы: пользовательские персоны, тест-персоны
Родитель: PASS 3 VERIFY, L4
Связи: CHAOS_AGENT


CHAOS

Определение: Тестирование через симуляцию отказов: infrastructure, network, data, dependencies, concurrency, time.
Синонимы: chaos testing, chaos engineering
Родитель: PASS 3 VERIFY, L5
Связи: CHAOS_AGENT, PERSONAS


INHERIT (агент)

Определение: Создание нового агента на основе существующего. Используется когда совпадение capabilities ≥ 70%.
Синонимы: наследование агента
Родитель: RESOLVE_AGENT()
НЕ путать: с INHERIT (контекст) — передача контекста от родителя к дочерней задаче


INHERIT (контекст)

Определение: Функция выбора что передать из родительского контекста дочерней задаче. Передаёт только нужное, не весь контекст.
Синонимы: наследование контекста, передача контекста
Родитель: EXECUTE()
НЕ путать: с INHERIT (агент)


RESEARCHER_AGENT

Определение: Фоновый агент для поиска информации при низком CONFIDENCE или блокировке основной задачи. Работает параллельно.
Синонимы: исследователь, фоновый поиск
Родитель: BASE_AGENT
Связи: CONFIDENCE_SCORE, PAUSE, ESCALATE


PROFILER

Определение: Фоновый процесс наблюдения за реестрами. Собирает статистику: частота использования, скорость, частота откатов.
Синонимы: профилировщик
Родитель: фоновые процессы
Связи: OPTIMIZER, TEMPLATE_REGISTRY, AGENT_REGISTRY


OPTIMIZER

Определение: Фоновый процесс улучшения горячих путей. Запускается только после 10+ успешных использований шаблона.
Синонимы: оптимизатор
Родитель: фоновые процессы
Связи: PROFILER, TEMPLATE_REGISTRY


PRUNER

Определение: Фоновый процесс архивирования устаревших шаблонов и агентов. Шаблон → архив если не использовался 90 дней.
Синонимы: прунер, архиватор
Родитель: фоновые процессы
Связи: TEMPLATE_REGISTRY, AGENT_REGISTRY


IMPROVER

Определение: Процесс улучшения блоков по IMPROVEMENT_TRIGGER. Обновляет шаблоны с версионированием + регрессионное тестирование.
Синонимы: улучшатор, блок-импрувер
Родитель: фоновые процессы
Связи: IMPROVEMENT_TRIGGER, TEMPLATE_REGISTRY, DIVERGENCE_LOG


CROSS-LLM ВАЛИДАЦИЯ

Определение: Отправка задачи и результата в несколько внешних LLM для независимой проверки. Применяется для HIGH_RISK. Использует бесплатные тарифы.
Синонимы: межмодельная верификация, multi-LLM check
Родитель: CLARIFY режим C, STEP_VERIFY
Связи: ACCOUNT_POOL, free tier providers


ACCOUNT_POOL

Определение: Набор аккаунтов внешних LLM для верификации. Ротация по исчерпанию лимитов. Конфиг в system/config/llm-pool.yaml.
Синонимы: пул аккаунтов
Родитель: CROSS-LLM ВАЛИДАЦИЯ
Связи: free tier providers (Gemini Flash, Mistral, Groq)


ОТКРЫТЫЕ ВОПРОСЫ (к уточнению)

# Термин Вопрос
1 MATCHER Алгоритм семантического сравнения задач
2 CONFIDENCE_SCORE Веса компонентов по типам задач
3 IMPROVEMENT_TRIGGER Оптимальный THRESHOLD
4 CONTEXT_STACK Политика архивирования при большом количестве папок

Версия: 1.0.0
Статус: base