# Portability: SYSTEM
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Следующий экзамен: 13 ноября 2026 г.
# Ресурсы: [hub/agent_launcher.py, Agents/, Agents/_experts/]

AGENT — средство запуска и администрирования агентов
======================================

ДАТА: 09.05.2026

Система агентов позволяет запускать агенты BACH и управлять ими.
как отдельные процессы кода Клода. Каждый агент имеет свой собственный
SKILL.md начинался как фирменный стиль.

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

  [Босс-Агент] -- Координаторы и делегаты
       |
       +-- [Эксперт 1] -- Специализированное исполнение
       +-- [Эксперт 2]

Каталоги агентов:
  агенты/босс-агенты (с SKILL.md)
  агенты/_experts/ Эксперты (с SKILL.md)

КОМАНДЫ CLI (агент bach)
------------------------

  list Список всех доступных агентов
  start <имя> Запустить агент (новое окно терминала)
  stop <имя> Остановить работающий агент
  steer <имя> "..." Сохранить подсказку оператора для запуска агента
  rename <имя> <новое> Изменить отображаемое имя агента/эксперта
  статус Показать все работающие агенты
  врач [имя] Агент предполетные и восстановительные записи
  list --json агенты, включая метаданные времени выполнения в формате JSON
  start <имя> --json Запустить ответ, машиночитаемый как JSON
  stop <имя> --json Остановить ответ, машиночитаемый как JSON
  steer <имя> --json Ответ управления, включая статус очереди, в формате JSON
  status --json Запущенные/зарегистрированные агенты в формате JSON
  доктор [имя] --json Машиночитаемый диагноз в формате JSON

ОПЦИИ ДЛЯ НАЧАЛА
-------------------

  --mode plan|режим по умолчанию (по умолчанию: по умолчанию)
  --model sonnet|opus|haiku AI-модель (по умолчанию: сонет)
  --dry-run Просто проверьте, не запускайте
  --json Машиночитаемый вывод для списка/старта/остановки/статуса/доктора

ПРИМЕРЫ
---------

  # Список всех агентов (включая статус работы)
  bach agent list

  # Запустить агент
  bach agent start ati
  bach agent start research --model opus
  bach agent start entwickler --mode plan
  bach agent start ati --dry-run
  bach agent start ati --dry-run --json

  # Показать запущенные агенты
  bach agent status
  bach agent status --json
  bach agent steer ati "Bitte nur Statusflächen anfassen." --json

  # Проверьте требования к запуску и восстановлению 
  bach agent doctor ati
  bach agent doctor Theodor --json

  # Остановить агента (по имени)
  bach agent stop ati
  bach agent stop ati --json

ДОСТУПНЫЕ АГЕНТЫ (выбор)
-----------------------------

  [ПРОФЕССИОНАЛЬНЫЙ]
    агент разработчика программного обеспечения ati (сканер, сеансы)
    разработчик Генеральный агент разработчика
    агент производственного процесса производства
    исследования Научные исследования
    налоги офисного помощника, планирование финансирования, документация
    рефлексия Саморефлексия и метаанализ

  [ЧАСТНЫЙ]
    управление назначениями личного помощника, исследования
    фельдшер Медицинская документация
    страхование управление страхованием

  [ЭКСПЕРТЫ]
    налоговый эксперт по налогам (в разделе _experts/)
    Специалист по планированию финансирования Эксперт по заявкам на финансирование
    управление бюджетом
    психоконсультант

Текущий список: список агентов Баха

КАК ЭТО РАБОТАЕТ
-------------------

1. `bach Agent start <имя>` находит SKILL.md агента
2. Создается временный файл CLAUDE.md (data/temp/agent_<имя>/)
3. Откроется новое окно терминала с Claude Code.
4. PID хранится в data/agent_pids/<имя>.pid.
5. `bach Agent steer <имя> "..."` записывает примечания оператора в `OPERATOR_NOTES.md`
6. `bach Agent stop <имя>` завершает процесс и удаляет PID

ТРЕБОВАНИЯ
---------------
- Должен быть установлен интерфейс командной строки Claude Code (команда: `claude`)
- Агент должен иметь SKILL.md (agents/<имя>/SKILL.md)

ВОССТАНОВЛЕНИЕ / УСТРАНЕНИЕ НЕИСПРАВНОСТЕЙ
--------------------------

Если `bach агент запускает...` завершается сбоем или окно агента немедленно возвращается
закрывается, сначала запустите диагностику:

  bach agent doctor ati
  bach agent doctor ati --json

`доктор` проверяет:
- найден ли CLI Claude Code в PATH
- доступны ли для записи `data/agent_pids/` и `data/temp/`
- доступны ли чтение запрошенного агента и его `SKILL.md`
- нужно ли очищать устаревшие PID-файлы 

Типичные следующие действия после отчета:
- `bach Agent start <name> --dry-run` для безопасного предварительного теста
- статус агента bach --json для запуска или зависания сеансов
- Установите Claude Code CLI или проверьте вход/настройку локально

БАЗА ДАННЫХ
---------
  бах.дб:
    реестр агентов агентов
    Agent_synergies Взаимодействие между агентами

ФАЙЛЫ
-------
  hub/agent_launcher.py реализация обработчика
  папка агентов/агента босса
  папка агенты/_experts/Experts
  data/agent_pids/ PID-файлы работающих агентов
  data/temp/agent_*/ Временный CLAUDE.md для каждого агента

ОТЛИЧИЕ ОТ Agents.txt
--------------------------
В этом документе описан AgentLauncherHandler (агент bach ...).
Для обзора всех агентов и экспертов:
  bach --help agents

СМОТРИТЕ ТАКЖЕ
----------
  bach --help agents      Обзор агентов (все агенты)
  bach --help skills      Система SKILL.md
  bach --help ati         Информация о разработчике программного обеспечения ATI
