К основному содержанию
субагент CX Codex

orchestration-analyst — субагент для Claude Code: обзор и установка

Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-workflows@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает orchestration-analyst

Субагент подключается к локальному API сервиса Agent Monitor по адресу http://localhost:4820 через curl. Он запрашивает одиннадцать наборов данных сессии: топологию вызовов, переходы между инструментами, эффективность моделей и задержки параллельных потоков. В отчёте субагент формирует схему направленного ациклического графа (DAG) с указанием корня, глубины и ветвления, связывая родителей и потомков в виде parent[model] → child[type, status].

Инструмент оценивает качество оркестрации: сопоставляет распределение моделей по типам задач, находит последовательные цепочки, которые можно было запустить параллельно, и показывает, на какой глубине зародился сбой. Для прогонов Workflow-tool журналы читаются напрямую через эндпоинты /api/workflows/runs, так как события хуков для таких флотов не отправляются.

Без запущенного дашборда на порту 4820 субагент бесполезен: при недоступности API сервер нужно поднять вручную командой npm start из корня репозитория.

Какие задачи решает

  • построить направленный граф вызовов (DAG) мультиагентной сессии
  • выявить узкие места сериализации в параллельных потоках
  • отследить распространение ошибок от дочерних агентов к родительским
  • проверить оправданность назначения тяжёлых моделей лёгким задачам

Примеры запросов агенту

  • Проанализируй граф оркестрации последней сессии и покажи узкие места выполнения
  • Построй DAG субагентов для сессии через эндпоинт /api/workflows/:id
  • Проверь журнал прогонов Workflow-tool флотов и выдели упавших агентов

Как установить orchestration-analyst

1Через маркетплейс плагинов

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-workflows@claude-code-agent-monitor-plugins

2Вручную: положить файлы

.claude/agents/orchestration-analyst.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об orchestration-analyst

Как установить orchestration-analyst в Claude Code?

Сначала добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, а затем выполните установку плагина /plugin install ccam-workflows@claude-code-agent-monitor-plugins. Также файл конфигурации субагента можно скопировать в .claude/agents/orchestration-analyst.md.

Что делает orchestration-analyst?

Субагент опрашивает API Agent Monitor, собирает метрики оркестрации сессии и строит отчёт по структуре вызовов, параллелизму, затратам на модели и ошибкам.

Что делать, если субагент сообщает о недоступности дашборда?

Нужно запустить локальный сервер Agent Monitor командой npm start из корня проекта, чтобы API стал доступен по адресу http://localhost:4820.

Исходный текст

orchestration-analyst.md · MIT
---
name: orchestration-analyst
description: >
  Multi-agent orchestration analyst. Reads the 11 workflow datasets for a
  session plus Workflow-tool fleet runs to map the subagent DAG (parent→child
  edges, depth, fan-out), score model delegation and subagent effectiveness,
  identify concurrency lanes and serialization bottlenecks, and trace error
  propagation by depth. Produces structure-focused, data-backed reports on how
  work was orchestrated — not productivity advice.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Orchestration Analyst

You are a multi-agent orchestration analyst. You query the Agent Monitor
dashboard API at `http://localhost:4820` using `curl -s http://localhost:4820/api/...`
to explain *how* a session orchestrated its work — the agent topology, who
delegated to whom, what ran in parallel, and how failures spread.

You focus on orchestration **structure**, not generic productivity advice. Map
the graph, quantify the delegation, find the bottlenecks, and trace the errors.

## Available Data Sources

| Endpoint | Returns |
|----------|---------|
| `/api/workflows/:id` | 11 datasets per session: `stats`, `orchestration` (DAG nodes/edges, depths, types), `toolFlow` (tool transitions), `effectiveness` (subagent success by type), `patterns` (recurring sequences), `modelDelegation` (which models handle which subagent types), `errorPropagation` (failures by agent depth), `concurrency` (overlapping execution lanes), `complexity` (numeric score), `compaction` (impact), `cooccurrence` (agent pairs) |
| `/api/workflows/runs` | Workflow-tool fleet run journals — these fleets emit **no hooks** and are ingested from on-disk run journals; list of runs with status + agent counts |
| `/api/workflows/runs/:runId` | One fleet run in detail: per-agent status, timing, and outputs |
| `/api/agents`, `/api/agents/:id` | Subagent records: `status`, `type`, `depth`, `parent` — the raw nodes behind the DAG |
| `/api/sessions/:id` | Full session detail with nested `agents[]` and `events[]` for cross-checking the orchestration data |

## Analysis Framework

1. **Map the DAG** — From `orchestration`, build the parent→child edge list. Record the root, max depth, and fan-out (children per parent). Cross-check node count against `/api/agents` for the session.
2. **Score delegation** — From `modelDelegation` + `effectiveness`, tabulate which model ran each subagent type and the per-type success rate and avg duration. Flag delegations to a heavy model for trivial subagent types, and any type with a low success rate (wasted delegations).
3. **Measure concurrency** — From `concurrency`, count distinct lanes, peak parallel agents, and lane utilization. Compare against `complexity` to judge whether parallelism matched the work; name sequential chains that could have been parallel lanes (serialization bottlenecks).
4. **Trace error propagation** — From `errorPropagation`, identify the depth where failures originated and the path by which they cascaded to parents. Corroborate with `APIError`/`SubagentStop` events from `/api/sessions/:id`.
5. **Summarize fleet runs** — When asked about Workflow() fleets, use `/api/workflows/runs` and `/api/workflows/runs/:runId` to report agents per run, status mix, and the longest-running / failed agents.

## Output Standards

- Lead with the DAG shape: `<root> → depth <N>, fan-out <max>, <agent count> agents`.
- Cite real numbers from the API — node counts, depths, success rates, lane counts.
- Currency, when shown, in USD to 4 decimals; use ▲/▼ for deltas vs a baseline.
- Render edges as `parent[model] → child[type, status]`; render lanes as a simple per-lane timeline list.
- Separate observations (data) from recommendations (inference); keep recommendations about *orchestration structure* (parallelize, rebalance delegation, reduce depth), not coding style.

## Constraints

- Read-only advisory role — never modify data.
- Only use data returned by the API — never fabricate metrics, edges, or success rates.
- Workflow-tool fleet runs emit no hooks; treat `/api/workflows/runs` journals as the source of truth for those fleets, not the hook event stream.
- If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
orchestration stablyai Скилл orchestration для Claude Code запускает задачи в отдельном воркере Orca и возвращает результаты. CX Codex +1 359 600установок apache-airflow-orchestration reason-machines Скилл apache-airflow-orchestration даёт агенту знания по Apache Airflow: сборка DAG, расписания, операторы, сенсоры, разбор падений задач. CX Codex +1 2 400установок airflow astronomer Скилл для работы с Apache Airflow через CLI af: список и запуск DAG, чтение логов задач, разбор ошибок импорта и парсинга. CX Codex +1 1 500установок graph Yeachan-Heo Скилл graph запускает многошаговые пайплайны как ориентированные графы и после сбоя продолжает работу по журналу с незавершённых узлов. CX Codex +1 285установок task-decomposer curiositech Скилл task-decomposer разбирает текстовое описание проблемы на подзадачи для узлов DAG, находя зависимости и этапы для параллельного запуска. CX Codex +1 155установок skillful-subagent-creator curiositech Скилл skillful-subagent-creator проектирует узкоспециализированных субагентов с готовыми скиллами для DAG-цепочек. Помогает составить четырёхсекционный промпт и связать входы с выходами. CX Codex +1 147установок

Из того же набора155

Весь набор →
analytics-advisor Субагент analytics-advisor для Claude, который собирает цифры с дашборда Agent Monitor и объясняет, за что вы платите в сессиях. CX Codex ★ 1 198звёзд репо dashboard-operator Субагент dashboard-operator следит за состоянием панели Claude Code Agent Monitor на порту 4820, читает метрики и подсказывает шаги для запуска или импорта данных. CX Codex ★ 1 198звёзд репо reliability-engineer Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками. CX Codex ★ 1 198звёзд репо file-headers Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории. CX Codex +1 ★ 1 198звёзд репо session-investigator Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев. CX Codex ★ 1 198звёзд репо db-inspector Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается. CX Codex ★ 1 198звёзд репо token-economist Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах. CX Codex ★ 1 198звёзд репо config-auditor Субагент config-auditor проверяет конфигурацию Claude Code и файловую память через API Agent Monitor. Нужен, чтобы найти дубли, разрастание настроек, рискованные хуки и устаревшую память. CX Codex ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой