MadoHub Docs

Claude Dynamic Workflows

MadoHub が Claude Code 自身の並列サブエージェント機能をどう検出し、可視化し、手懐けるか。

Dynamic Workflows は Claude Code 自身 の研究プレビュー機能であり、Anthropic が提供する独自のマルチエージェントオーケストレーション機構であって、MadoHub が構築したものではありません。Claude Code は単一のセッションを、同じ問題に取り組む多数の並行サブエージェントへファンアウトできます。

MadoHub はその上に互換レイヤーを同梱しています。MadoHub はこれらのサブエージェントを作成・実行するわけではなく、検出し、ワークフロー実行中も自身のエージェント状態モデルを正しく保ち、素朴な統合が生むようなノイズの洪水なしに進捗を見せる手段を提供します。このレイヤーがないと、65 個のサブエージェントを持つワークフローは 1 つのタイルに 65 個の完了バッジが積み上がり、それぞれを個別に消さなければならなくなります。

Dynamic Workflows には Claude Code セッション内からアクセスします — プロンプトで ultracode と打つか、/effort ultracode を実行するか、Pro プランで /config の Workflows トグルをオンにします。最近の Claude Code バージョンが必要です。自然言語トリガーはさらに新しいバージョンが必要です。

MadoHub がこの機能でやること

  • ワークフロー実行を検出 し、サブエージェントごとのバッジではなくタイルごとに 1 つの進捗カウンタにサブエージェントイベントを集約します。
  • 3 箇所で進捗を表示 — Context Gauge のアクティブインジケータ(小さなパルスドット)がタイルに点灯、Fleet パネルに行の下に workflow · 3/5 agents 行を表示、Context Gauge のツールチップに集計ワークフロートークン数を表示します。
  • ワークフローのトークン使用量をメインゲージのパーセンテージと分離 — サブエージェントはメインセッションのウィンドウではなく独自のコンテキストで動くため、そのトークン使用量はメインセッションのフィルとは別に追跡されます。
  • 同じタイルで新しいランが始まるとカウンタをリセット — 2 回目のワークフローが 1 回目の計数を引き継ぐことはありません。

使い方

MadoHub の互換レイヤーを直接「使う」わけではありません — Claude Code タイルの中で Claude Code の Dynamic Workflows 機能を使うと、MadoHub が自動的に進捗を表示します。

  1. Claude Code タイルを開き、セッション内からワークフローをトリガーします(ultracode と打つ、/effort ultracode を実行する、/config の Workflows トグルを切り替える)。
  2. ワークフロー実行中はタイルの Context Gauge アクティブインジケータが点灯するのを確認します。
  3. Fleet パネルでそのタイルの行の下に workflow · {done}/{seen} agents 行があるか確認し、タイルまで飛ばずにファンアウトの進行を見ます。
  4. タイルの Context Gauge をホバーすると、メインのパーセンテージとは別に集計ワークフロートークン数が表示されます。
  5. ワークフローが終わると、アクティブインジケータが消灯し、進行行も自動的に消えます。

Claude 自身の制限

以下は MadoHub ではなく Claude Code の制限であり、MadoHub は変更できません:

制限値
同時サブエージェントの最大数16(CPU 制限のマシンではより少ない)
1 ランあたりのサブエージェント最大数1,000
実行中のユーザー入力受け付けません — 許可プロンプトのみランを一時停止できます

よくあるユースケース

  • 「大きい研究タスクを多数のサブエージェントで回す」 — Claude Code 内でワークフローをトリガーし、作業を離れずに Fleet パネルからファンアウトの進行を見ます。
  • 「あのワークフロー、まだ動いてる?」 — Context Gauge のパルスドットとツールチップの (active) 接尾辞で一目でわかります。
  • 「ワークフローがどれくらいトークンを消費している?」 — Context Gauge をホバーします。ワークフローのトークン数がメインセッションのフィルとは別に表示されます。

ヒントとベストプラクティス

  • ファンアウトの進行はタイルまで飛ばずに Fleet パネルの workflow · {done}/{seen} agents 行を見ましょう — 互換レイヤーの目的は、サブエージェントごとのバッジに溺れないようにすることです。
  • ワークフローのトークン数は意図的にメインゲージのパーセンテージとは別に追跡されています。合計して「総コンテキスト」を見積もらないでください — サブエージェントは独自のコンテキストで動いています。
  • 立ち上がったばかりのワークフローは、最初の usage ブロックが到着する前に、アクティブ表示でトークン計数ゼロになることがあります。少し待ってください。
  • ワークフローが終わると Claude Code が権威ある合計値を書き出します。MadoHub はサブエージェントファイルを再合計せずにそれを読むため、最終値はラン中の値よりも正確です。

関連機能

  • Context Gauge — アクティブインジケータとツールチップでワークフロー進行を表示するタイルごとのフィルバーです。
  • Fleet — 行ごとに workflow · {done}/{seen} agents を表示するパネルです。
  • MadoAgent — MadoHub 自身のマルチエージェントパターン(Ensemble Exploration、Orchestrator Mode)はこちら。

制限事項

  • Dynamic Workflows は Claude Code の研究プレビュー機能です。MadoHub はこれを検出・可視化しますが、実装するわけではありません。
  • MadoHub がここで読んでいるものはすべて、Claude Code が自身の目的で書き出した観察動作であり、公開された契約ではありません。Anthropic はこの機能が研究プレビューを離れるにあたり、予告なくフォーマットを変更する可能性があります。
  • ワークフロー実行中はユーザー入力を受け付けません — 許可プロンプトのみがランを一時停止できます。トリガーする前に計画を立ててください。

On this page