myYouTube/AGENT_TEAM.md
vrubelroman f0ca7b97ca Add Analyst subagent: task analytics docs and targeted README updates
Analyst runs before Coder: records each task in analytics/*.md (appending
journal entries and revising only affected sections), updates README where
necessary, and reports ANALYST_DONE. Orchestrator flow updated:
task -> Analyst -> Coder -> Reviewer/Tester -> deploy -> report.
2026-09-17 21:18:36 +00:00

3.5 KiB
Raw Blame History

Агентская команда opencode

Одна сессия opencode в роли Orchestrator и четыре субагента — Analyst, Coder, Reviewer, Tester, которых Orchestrator вызывает через Task tool. Роли лежат в .opencode/agent/, Orchestrator назначен агентом по умолчанию в opencode.json.

Запуск и работа

В корне репозитория запусти opencode. Каждая новая сессия стартует Orchestrator'ом: задачу пиши обычным сообщением. Он сам:

  • декомпозирует задачу и сначала отправляет её Analyst'у (фиксирует в analytics/*.md), затем Coder'у через Task tool;
  • после Coder'а запускает Reviewer (только чтение) и Tester (проверка без правок) параллельно;
  • возвращает Coder'у actionable findings; при существенном изменении скоупа перед follow-up просит Analyst'а дополнить аналитику (журнал), повторяет цикл, пока Critical/Major не закрыты;
  • когда Critical/Major закрыты и проверки зелёные — без вопроса деплоит на тестовый сервис (docker compose up -d --build, затем curl http://localhost:8080/api/health);
  • отдаёт финальный отчёт уже после деплоя: что написано, просмотрено и протестировано, оставшиеся риски и просьба проверить в браузере с очисткой кэша (Ctrl+Shift+R).

Вручную писать субагентам не нужно — их вызывает только Orchestrator.

Роли

  • Orchestrator (primary, агент по умолчанию) — единственный общается с пользователем; сам код не правит.
  • Analyst (subagent) — перед Coder'ом фиксирует задание в analytics/*.md, дополняет его по ходу работы (правки только затронутых секций, документ целиком не переписывается), при необходимости актуализирует README.md; отчитывается ANALYST_DONE.
  • Coder (subagent) — единственный меняет код продукта; отчитывается CODER_DONE.
  • Reviewer (subagent, edit: deny) — read-only review; отчитывается REVIEW_DONE.
  • Tester (subagent, edit: deny) — прогоняет проверки; может создавать игнорируемые артефакты, но не меняет отслеживаемые файлы; отчитывается TEST_DONE.

Файлы

  • .opencode/agent/{orchestrator,analyst,coder,reviewer,tester}.md — определения агентов команды;
  • analytics/ — аналитика задач агентской команды (по одному файлу на задачу; конвенция в analytics/README.md);
  • opencode.json — default_agent: orchestrator.

Конфиг и агенты читаются при старте opencode: после изменений перезапусти сессию.