Claude Code「Dynamic Workflows」徹底ハウツー——並列サブエージェントを使い倒す7つのコツ

Claude・Claude Code

Claude Opus 4.8 リリースと同時に公開された Dynamic Workflows(動的ワークフロー)は、Claude Code 上で 数十〜数百のサブエージェントを並列で走らせる ための新機能です。Jarred Sumner 氏が Bun を Zig → Rust に移植した事例では、約 75 万行・11 日・テスト 99.8% パス という大規模成果が報告されています。本稿では「とりあえず動かす」段階から一歩進んで、実運用で結果を出すための実践的なコツを整理します。

Dynamic Workflows とは何か

公式の説明を要約すると、Dynamic Workflows は JavaScript スクリプトとして表現されるサブエージェントのオーケストレーション機構 です。流れは次のとおり:

  1. ユーザーがゴール(自然言語)を投げる
  2. Claude が その場でスクリプトを書く
  3. ランタイムがバックグラウンドで実行
  4. 実行中もチャットセッションはレスポンシブに保たれる

通常のサブエージェントが「決め打ち」で立つのに対し、Dynamic Workflows は プランニング自体を Claude が動的に行う 点が新しさの核です。

並列サブエージェントの仕組み

1 workflow

ワークフローが起動すると、Claude はプロンプトを読んでサブタスクに分割し、それぞれを並列サブエージェントに割り当て ます。各サブエージェントの出力は メインに統合される前に検証 され、合格したものだけが採用される構造です。

公式ドキュメントでは「単一セッションで 数十〜数百並列」が可能と明記されており、大規模監査やマイグレーション、横断リサーチのような 「人間が手で全部見られない量の作業」 に決定的な威力を発揮します。

いつ使うべきか——5つの典型ユースケース

  1. コードベース監査: 全モジュール横断のセキュリティ/品質チェック
  2. サービス横断バグ調査: マイクロサービス群を並列で精査
  3. 大規模マイグレーション: 言語移行、フレームワーク更新、API バージョン差し替え
  4. クロスチェック付きリサーチ: 同じ問いを別観点で並列調査し合成
  5. 多角的プランニング: 採用前に複数案を並走させて比較

逆に 会話 1 回で済む短いタスクには向きません。サブエージェント起動オーバーヘッドが効くため、「重い・広い・反復多め」がスイートスポットです。

実例:Bun の Zig → Rust 移植(75 万行・11 日)

最も話題になった事例が、Jarred Sumner 氏による Bun の言語移植 プロジェクトです。

  • 規模: 約 750,000 行の Rust コードを生成
  • 期間: 初コミットから本流マージまで 11 日
  • 品質: 既存テストスイートの 99.8% がパス

これは「人間 1 人 + Dynamic Workflows」で達成された数字で、個人 OSS の生産性レンジが 1 桁変わった ことを示す象徴的な事例として広く引用されています。

並列サブエージェントを使い倒す7つのコツ

2 tips

公式ドキュメント・InfoQ・MindStudio 等のレビューから抽出した実践的ノウハウを、優先順に並べます。

1. スコープを明示する

「何が対象か」「何が対象外か」を冒頭で言語化。曖昧だとサブエージェントが暴走する。

2. 終了条件を最初に書く

「最終サマリには 何が変わったか/何をテストしたか/人間レビューが必要な箇所 を必ず含めよ」と明示。

3. 1スクリプト1ゴール

複数の異なる目的を 1 ワークフローに詰め込まない。ゴール別に分けるとデバッグが格段に楽。

4. 既存テストへの非破壊性を担保

「既存テストを壊さない範囲で」と制約を入れる。Bun ポート事例も 99.8% パスが品質ガード。

5. 中間検証ステップを挟む

全並列が終わってから検証ではなく、バッチごとに集約 → 検証 → 次バッチへ のループにする。

6. スクリプトを「読む」習慣を作る

Claude が書いたスクリプトは JavaScript で読める 形になっている。実行前にざっと目を通す癖をつけると事故が減る。

7. 失敗時のフォールバックを定義

「サブエージェントが N 回失敗したら人間にエスカレーション」のようなフェイルセーフを書く。長時間ジョブほど重要。

デバッグと観測:「並列の見える化」が鍵

並列実行は強力な反面、「いま誰が何をしているか」が見えなくなりがちです。Claude Code は実行ログにサブエージェント単位で進行状況を出力しますが、慣れないうちは以下の運用が効きます。

  • マイルストーン区切りでサマリ出力を強制する: 「10 サブタスクごとに進捗ログを出せ」のように指示
  • 失敗ログだけを集約: 成功時は静か、失敗時のみ詳細を吐かせて目を通す対象を絞る
  • dry-run モードを最初に通す: 全体プランだけ出させて、人間がレビューしてから本実行

「全部見ようとしない」ことが、大規模並列ジョブを心理的に運用可能にする最大のコツです。

コスト感覚:「並列度 × トークン量」の罠

Dynamic Workflows は便利な反面、並列サブエージェントの数だけトークン消費が増える 構造です。Opus 4.8 は標準 $5 / $25 per 1M tokens の単価。仮に 50 サブエージェント × 平均 30K トークンを 1 ワークフローで消費すると、入力 1.5M トークン = $7.5、出力 0.3M トークン = $7.5 の合計 $15 / ジョブ という計算になります。

「Bun 75 万行ポート」のような事例では、累積コストは数千ドル規模に達したと推測されます。「人 1 人 + Dynamic Workflows」の価値が出るのは、人件費換算で十分元が取れる範囲のタスクのみ——という線引きは押さえておきましょう。

チームへの展開:「個人で覚えて、組織に持ち込む」

副業や個人 OSS で実戦感を掴んだら、本業のチームに持ち込みやすいのも Dynamic Workflows の良いところです。スクリプトが JavaScript なので そのままレビュー対象 にできますし、CI から Headless 実行することで「人間が承認 → エージェントが並列実行 → 結果を PR にまとめる」ワークフローを完成形として組めます。組織導入のしきい値は、純粋なチャットエージェントよりも一段低いと考えてよいでしょう。

まとめ:「個人 1 人で大規模プロダクト」が現実解に

Dynamic Workflows の登場で、副業・個人開発のスケール感は文字通り桁が変わりました。「考えるのは人間、書くのは並列エージェント」 という新しい分業に慣れることが、これからの個人開発者の競争力に直結します。

まずは小さなリポジトリで「テスト追加ワークフロー」のような 低リスク × 並列性の活きるタスク から試し、自分の手癖と Claude の動き方を合わせていくのが最短ルートです。


参考

タイトルとURLをコピーしました