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

AGENT LAUNCHER - Управление агентами и контроль процессов 
=======================================================

 Запускает и управляет агентами BACH (босс-агентами и экспертами) как независимыми.
Процессы Claude с параметризацией модели и режима.


ОПИСАНИЕ
------------

Обработчик агента_launcher позволяет управлять жизненным циклом агентов. агенты
запускаются и контролируются как отдельные процессы. Каждый агент получает один
временный файл CLAUDE.md с его SKILL.md в качестве определения личности.
Идентификаторы процессов сохраняются для мониторинга и управления.


ОПЕРАЦИИ
-----------

  bach agent list                               Перечислить все доступные агенты

  bach agent start <name> [OPTIONS]             Запустить агент как новый процесс
    --mode Режим РЕЖИМА: план (режим планирования) или
                                                  по умолчанию (по умолчанию, по умолчанию)
    --model МОДЕЛЬ Модель: сонет, опус или хайку
                                                  (по умолчанию: сонет)
    --dry-run Только проверять, не запускать

  bach agent stop <name>                        Остановить работающий агент (завершить процесс
, PID-файл очищен)

  bach agent status                             Показать все работающие агенты
                                                с PID, моделью, временем начала


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

  # Показать доступных агентов
  bach agent list
  Вывод: Таблица с именем, типом (босс/эксперт), статусом [РАБОТАЕТ:pid]/[ОСТАНОВЛЕНО]

  # Запуск агента в стандартном режиме (сонет)
  bach agent start ati
  Вывод: [OK] Агент 'ati' запущен, отображаются PID и папка Temp

  # Агент запуска с определенной моделью и режимом
  bach agent start research --model opus --mode plan
  Суд над Клодом Опусом в режиме плана

  # Только симулировать запуск
  bach agent start ati --dry-run
  Вывод: [DRY-RUN] Запустит агент 'ati' ...

  # Показать запущенные агенты
  bach agent status
  Вывод: Таблица всех запущенных процессов с PID, временем запуска, статусом 

  # конечный агент
  bach agent stop ati
  Вывод: [OK] Агент 'ati' (PID xyz) остановлен


ДЕТАЛИ
-------

Сканирование агента:
  - Агенты-боссы: Agents/ (каталоги с SKILL.md)
  - Эксперты: агенты/_experts/ (каталоги со SKILL.md)
  - Игнорирует записи с префиксами подчеркивания

Выполнение процесса:
  - Windows: start.bat в папке Temp, новое окно CMD.
  - Unix/Linux: отдельный процесс с start_new_session.
  - Варианты модели: сонет (по умолчанию), опус, хайку.
  - Параметры режима: по умолчанию (по умолчанию), план

Постоянство:
  - Файл PID: data/agent_pids/<имя>.pid (JSON)
  - Содержимое: pid, имя, тип, модель, режим, запуск, temp_dir.
  - Автоматическая очистка мертвых процессов во время проверки статуса.
  - Обработка CLAUDE.md: data/temp/agent_<имя>/CLAUDE.md


ОБРАБОТКА ОШИБОК
----------------

  [ОШИБКА] Требуется имя агента. Отсутствует операнд (список и статус).
                                                 не нужно имя)

  [WARN] Агент «<имя>» уже запущен (PID..) Агент уже активен

  [ОШИБКА] Агент '<имя>' не найден. Не найден SKILL.md или
                                                Каталог не существует

  [ОШИБКА] Неверный режим: X Разрешен только «план» или «по умолчанию»

  [ОШИБКА] Неверная модель: X Только «сонет», «опус», «хайку»

  [ОШИБКА] CLI 'claude' не найден. Код Claude не установлен


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

  Обработчик:hub/agent_launcher.py
  Агенты: агенты/*/SKILL.md
  Эксперты: агенты/_experts/*/SKILL.md
  Реестр PID: data/agent_pids/*.pid (JSON)
  Временные файлы: data/temp/agent_*/


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

  обзор агентов помощи (босс, эксперты, структура)
  Путь справки Структура каталогов и пути
  помочь в разработке. Разработать новых агентов.
