# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

СИСТЕМА АГЕНТОВ БАХА
==================

Иерархическая система боссов-агентов и экспертов с системой персон.

ТРИ УРОВНЯ
-----------

  Навыки Существенные. Знания, код, рабочие процессы.
             Портативный, экспортируемый, реальная ценность.

  Персоны Интерфейс. Имя, стиль, характер.
             Персонализация (переименование агента Баха), дело вкуса.

  Сеансы Продолжительность. Контекстное окно, Инструменты, Повороты.
             Техническая деталь.

СТРУКТУРА
--------

Руководство агентов координирует, эксперты специализируются:

  [Босс-Агент]
       |
       +-- [Эксперт 1]
       +-- [Эксперт 2]


ДОСТУПНЫЕ АГЕНТЫ (агенты/)
-------------------------------------

[ПРОФЕССИОНАЛЬНЫЕ]

  АТИ (ati/) — Персона: Атлас
    Агент разработчика программного обеспечения со сканером, сеансы
    Функции: сканер задач, автономные сеансы, обнаружение инструментов 

  разработчик (разработчик)
    Генеральный агент разработчика

  Производство
    Агент производственного рабочего процесса 

  Исследования
    Научные исследования (PubMed, Недоумение, Консенсус)

  Офис-ассистент (офисный помощник) — Персона: Клара
    Налоги, планирование финансирования, документация
    Эксперты: налоги (Теодор), специалист по планированию финансирования (Флориан)

  отражение
    Саморефлексия и метаанализ


[ЧАСТНОЕ]

  Личный помощник (персональный помощник) — Персона: Павел
    Управление назначениями, исследования, общение
    Эксперты: Управление домашним хозяйством (Марта)

  Health Assistant (Помощник по здоровью) — Персона: Хелена
    Медицинская документация и администрирование
    Эксперты: администратор здравоохранения (Густав), психоконсультант (Софи)

  страховка (страховка)
    Страховое управление

  Financial Assistant (финансовый помощник) — Персона: Феликс
    Финансовое планирование и составление бюджета


[ТЕСТ]

  Тестовый агент (тест-агент)
    Для тестирования и экспериментов


ПЕРСОНАЖНАЯ СИСТЕМА (SUGAR v3.8.0)
------------------------------

Начиная с SUGAR v3.8.0, агенты и эксперты присваивают имена персонажам:
человеческие имена + описания персонажей в базе данных.

  Столбцы БД:
    display_name Имя персонажа (например, «Атлас», «Теодор»)
    текст персонажа (например, «Прагматичный мастер...»)

  Команды:
    bach agent rename <name> <neuer-name>   Изменить отображаемое имя
    bach agent list                          Показывает персоны в скобках
    bach agent info <name>                   Подробности, включая персону

  Разрешение имени (resolve_agent_name):
    1. Точное название системы (например, «налоговый агент»)
    2. Отображаемое имя (например, «Теодор»)
    3. Подстрока (например, «тео»)
    4. Нечеткий/Левенштейн (например, «теодор»)

  Инъекция Персоны:
    При запуске агента персонаж вводится в виде системного приглашения:
    «Ваше имя «Теодор». Ваш персонаж: налоговый консультант по половому члену...»
    См.:hub/agent_launcher.py(_get_persona_info)


  Личности босса-агента:

    Имя системы | Персона | Персонаж
    ати | Атлас | Прагматичный мастер
    офисный помощник | Клара | Структурированный органайзер
    финансовый помощник | Феликс | Внимательный бережливый
    помощник врача | Елена | Заботливый компаньон
    личный помощник | Пол | Универсальный универсал


  Экспертные персонажи:

    Имя системы | Персона | Персонаж
    налоговый агент | Теодор | Пенильный налоговый консультант
    финансовая_почта | Фрида | Почтовый детектив
    абонентское обслуживание | Антон | Король отмены
    администратор здравоохранения | Густав | Архиватор находок
    психоконсультант | Софи | Чуткий слушатель
    здоровье_импорт | Хьюго | Добросовестный хранитель данных
    управление бюджетом | Марта | Бережливая экономка
    планировщик финансирования | Флориан | Эксперт по финансированию
    эксперт по применению | Бенджамин | Карьерный тренер
    анализ данных | Диана | Шепчущий номер
    брифинг по принятию решений | Дитрих | Крутой стратег
    генератор_отчета | Рита | Эффективный механизм отчетности
    мр_тиктак | Мистер Тик Ток | Стратегический тактик
    услуги транскрипции | Тристан | Терпеливый слушатель
    викивикторина | Уильям | Мастер викторин

  Шаблон: навыки/_templates/TEMPLATE_PERSONA.md
  Миграция: data/schema/migrations/034_agent_personas.py


КОМАНДЫ CLI
-----------

  # Список агентов
  bach --agents list
  инструменты Python/список агентов_cli.py

  # Показать экспертов
  инструменты Python/agent_cli.py эксперты

  # Подробности об агенте
  инструменты Python/agent_cli.py info <имя агента>

  # Переименование персоны
  bach agent rename <name> <neuer-display-name>

# Инициализируем папку пользователя
  инструменты Python/agent_cli.py инициализировать все
  инструменты Python/agent_cli.py init <имя-агента>

  # Настраиваем базу данных
  инструменты Python/agent_cli.py setup-db

  # Статус системы
  инструменты Python/agent_cli.py status


КАТАЛОГ
-------------

  Определения агентов/босс-агентов (11 агентов)
  Agents/_experts/ Папка Expert с CONCEPT.md (17 экспертов)
  user/<agent>/ Папка пользовательских данных для каждого агента

ВАЖНО: Агенты и эксперты – это разные понятия!
  - Агенты (босс): координировать и делегировать (агенты/)
  - Эксперты: специализированное исполнение (агенты/_эксперты/)
  - Некоторые «агенты», перечисленные в справке, на самом деле являются экспертами:
    * налоговый агент -> _experts/tax/
    * планировщик финансирования -> _experts/foerderplaner/
    * управление бюджетом -> _experts/управление бюджетом/
    * психоконсультант -> _эксперты/психоконсультант/


БАЗЫ ДАННЫХ
-----------

  бах.дб:
    - bach_agents (реестр агента + отображаемое_имя + персона)
    - bach_experts (реестр экспертов + отображаемое_имя + персона)
    - Agent_synergies (синергия между агентами)

  бах.дб:
    - Таблицы для каждого эксперта (здоровье_*, домохозяйство_* и т. д.)


РАБОЧЕЕ ПРОЦЕСС
--------

1. Активировать агента (через навык или CLI)
2. Агент загружает определение навыка и данные пользователя.
3. Персона вводится как системная подсказка (display_name + persona)
4. По специальным темам: делегирование экспертам.
5. Эксперт объясняет, босс-агент подводит итоги


GUI
---

  http://127.0.0.1:8000/agents Обзор агента
  http://127.0.0.1:8000/ati Сведения об агенте ATI
  http://127.0.0.1:8000/tax Сведения о налоговом агенте


ФАЙЛЫ
-------

  папка агентов/ati/ATI агента
  агенты/ati/ATI.md Определение ATI
  агенты/personal-assistant.txt
  агенты/healthassistant.txt
  агенты/bueroassistant.txt
  агенты/tax-agent.txt
  агенты/research.txt
  агенты/разработчики.txt
  агенты/production.txt
  агенты/README.md


СТАНДАРТЫ
---------

Обязательные файлы:

  1. Каждый Агент и Эксперт ДОЛЖЕН иметь SKILL.md.
     (неroll.txt, не CONCEPT.md в качестве замены)
  2. SKILL.md ДОЛЖЕН содержать YAML-Frontmatter:
     название, версия, тип, описание (минимум)
  3. CONCEPT.md НЕОБЯЗАТЕЛЬНО (для детальных концепций)
  4. role.txt УСТАРЕЛ (перейти на SKILL.md)

Persona System (SUGAR v3.8.0 – реализовано):

  Все агенты и эксперты имеют имена персон в БД.
  Персоны состоят из display_name (имени) и persona (персонажа).

  Концепция: Персона (кто) + Навык (что) + Сессия (как).
    - Персона: персонаж со стилем и границами (БД + дополнительный файл)
    - Навык: умение использовать код и инструкции (с возможностью экспорта).
    - Сессия: Среда выполнения (инструменты, ходы, модель)

  Адресация: к агенту можно обращаться по имени.
    (например, «Спросите Теодора о налоге»)

  Будущее: файлы персон в агентах/personas/ (постепенная миграция)

Антропная совместимость:

  - Навыки можно экспортировать (открытый стандарт, LobeHub/Cursor и т. д.).
  - Персоны/агенты НЕ переносятся (только Claude Code/BACH)
  - Экспорт: экспорт навыков Баха <имя> --format anthropic
  - Новый навык: навыки Баха создают <имя> --format anthropic

  См.: bach helpkill_standards


СМОТРИ ТАКЖЕ
----------

  bach help skill_standards  Антропные стандарты навыков
  bach help actors           Обзор участников
  bach help bach_paths       Структура каталогов
  bach help practices        Принципы архитектуры
  bach help ati              Информация о разработчике программного обеспечения ATI
  bach wiki lobehub          Рынок LobeHub
