hermes-hub/docs/research/agent-orchestrator.md
Hermes Team ef00a64f93 docs(research): каталог разведки — разбор Agent Orchestrator и журнал наблюдений
Наработки из новостных сводок оседали в переписке и терялись. Заведён
docs/research/: что рассмотрено для Hub, с вердиктом и причиной по каждому
пункту — отдельно от ARCHITECTURE (что построено).

Разбор Agent Orchestrator: ближайший архитектурный родственник Hub. Перенять
автоматический возврат замечаний исполнителю (у нас его нет — ревьюер правит
руками), ветку и worktree на работника, доску состояния флота; целиком не брать.

Журнал разведки за 31.08–02.09: Fable 5.1 и AgentsView — брать; Hermes v0.21.0 —
сервер обновлять последним (два бага, но 65536 у нас своё, не путать);
Qwen MTP и свежий llama.cpp — на V100 выигрыша нет, проверено в A52.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-02 19:17:44 +07:00

71 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Разбор: Agent Orchestrator
**Источник:** сводка AI Daily News за 2026-08-31.
**Лицензия по сводке:** Apache 2.0, локальный запуск.
**Вердикт:** разобрать устройство и перенять две идеи; целиком не брать.
**Дата разбора:** 2026-09-02.
> Первоисточник перед внедрением перепроверить: сводка — это пересказ, а не сам
> проект. Ссылку и точное имя репозитория подтвердить.
## Почему он для нас важен
Это ближайший архитектурный родственник того, что строит Hermes Hub. Он тоже
раздаёт работу флоту coding-агентов (Claude Code, Codex, Aider, OpenCode, Cline,
Continue, Goose и другие) и держит постоянную роль оркестратора — планирование,
делегирование, координация, — а работники заняты реализацией, тестами, PR и
исправлениями. Ровно наша схема ролей из `ROUTER.md`.
Ценность не в том, чтобы взять его вместо Hub, а в том, что он уже прошёл путь,
на котором мы сейчас: у нас роли есть, но замечания исполнителю пока возвращает
живой ревьюер вручную.
## Что перенять
### 1. Возврат замечаний исполнителю — то, чего у нас нет
У них отказы CI и замечания ревью **маршрутизируются обратно нужному агенту**, и
петля замыкается автоматически. У нас этого звена нет: агент присылает отчёт,
ревьюер проверяет исполнением, находит расхождение — и передаёт правку заново
руками. За 12 сентября так было трижды (A56, A57, ложный «16/16»).
Стоит спроектировать: результат проверки (прошло / не прошло + причина + номер
задания) возвращается тому исполнителю и в ту ветку, откуда пришла работа. Это
естественное продолжение линии заданий, которую ведёт `agents/inbox`.
### 2. Ветка и worktree на каждого работника
Каждый работник получает отдельный git worktree, отдельную ветку и отдельное
состояние сессии. Мы это уже делаем вручную — каждое задание Antigravity живёт в
своей ветке `antigravity/aNN-*`, ревьюер сливает в `main`. У них это часть
системы, а не ручной обычай. Формализовать наш обычай стоит.
### 3. Отслеживание PR / CI / merge conflicts / состояния работника
Единая доска состояния флота. У нас это разбросано: `agents/inbox`,
`agents/done`, `agents/reports` и git-ветки. Свести в один обзор — понятная
польза, когда исполнителей несколько и они на разных машинах.
## Чего НЕ брать
- **Целиком как замену Hub.** Hub — маршрутизатор провайдеров внутри Hermes
Agent, а не автономная IDE для флота. Задачи пересекаются, но не совпадают.
- **Прямой доступ агентов к рабочему окружению без ограничений.** Здесь держать
в уме вывод из отчёта OpenAI Astra (сводка за 2026-09-02): автономным агентам
ограничения должны обеспечиваться инфраструктурой, а не системным запросом. У
нас противовес уже есть — изоляция из A37 и правило про `agy_profiles`;
ослаблять его ради удобства оркестрации нельзя.
## Что проверить у первоисточника перед любым внедрением
- точное имя и адрес репозитория, реальную лицензию (в коде, не в сводке);
- как именно возвращаются замечания — формат, транспорт, привязка к ветке;
- требования к окружению и зрелость проекта (возраст, тесты, сообщество);
- модель прав: что работник может делать с репозиторием и системой.
## Связанное
- Роли и цепочки: [../ROUTER.md](../ROUTER.md).
- Изоляция агентов и запрет на чужие ключи: A37, `agents/inbox/2026-08-30-A37-*`.
- Наблюдаемость сессий агентов — см. AgentsView в
[scouting-log.md](scouting-log.md).