Claude Code Dynamic Workflows は、単に「複数の agent を並べる機能」ではありません。Claude Code が JavaScript workflow script を書き、バックグラウンド runtime が複数の subagents を調整する仕組みです。使うべきなのは、計画そのものをコードとして読み、保存し、再利用したい場合だけです。通常の Claude Code セッション、1 つの subagent、skill、hook、routine で仕事の owner が足りるなら、まず小さい表面を選びます。
2026年6月3日時点で、Anthropic の公式 docs は Dynamic Workflows を research preview として扱い、Claude Code v2.1.154 以上を条件にしています。workflow run は plan usage と rate limits の対象で、現在の docs では最大 16 concurrent agents、1 run あたり最大 1,000 agents とされています。この数字は強力ですが、同時に最初の判断を慎重にする理由でもあります。
| 目の前の仕事 | Dynamic Workflows が向く時 | 小さい表面でよい時 | 最初の安全な動き |
|---|---|---|---|
| 大きな repo audit や migration | 独立 slice を並列で調べて比較したい | 1 ファイル、1 package、1 reviewer で十分 | 小さい slice と verification bar を指定 |
| 繰り返す research や validation loop | branching plan を script として残したい | 方法だけを再利用したい | skill で始める |
| tool-heavy implementation | subagents に別々の read/write/command context が必要 | deterministic event rule で足りる | hooks を使う |
| scheduled / unattended work | workflow は大きな runtime の一部 | cadence、retry、external state が owner | routine か外部 job system |
| ultracode の探索 | Claude に workflow の必要性を判断させたい | simple session で完了できる | 小さく始めて /workflows を見る |
停止ルールは明確です。最初から whole-repo migration、広い research sweep、高権限 workflow を走らせないこと。小さな範囲を指定し、必要な tools だけを承認し、/workflows で状態と usage を観察し、証拠を見て stop、save、resume、scale を決めます。
計画が script になると何が変わるか
変化の中心は、計画がどこにあるかです。通常の Claude Code では、計画、tool results、修正判断が会話 context に残ります。Dynamic Workflow では Claude が JavaScript orchestration script を書き、runtime がそれを背景で実行します。script は subagents を起動し、branch を分配し、intermediate results を集め、最後に synthesis を返します。
この構造は、独立した確認が価値になる仕事に向きます。security audit、multi-package migration、architecture risk review、claim verification は、複数の clean context からの証拠が役立つことがあります。価値は agent 数ではありません。価値は、分担、独立検証、最後の比較が品質を上げる時にだけ生まれます。
一方で、workflow は会話より強い実行面です。通常のやり取りのように毎ステップで質問して止まるわけではありません。permission prompt は残りますが、走り始めた run は background で進みます。subagents は許可された tools に従って read、write、command execution を行います。だから初回は、小さく、観察でき、止められる形でなければいけません。
| 部品 | 担当 | 見るべきもの |
|---|---|---|
| Claude Code session | request、approval、final review | orchestration が本当に必要か |
| Workflow script | branching、subagent calls、synthesis | 読める、保存できる、再利用できる |
| Subagents | 独立 slice | write、command、重複探索、未検証 |
| /workflows | run 管理と usage visibility | stop、save、resume の判断 |
script が「1 agent に 1 ファイルを直させる」だけなら workflow ではありません。migration、audit、validation harness として再利用できる時に、初めて workflow の意味が出ます。
subagents、skills、hooks、routines との違い
Dynamic Workflows は他の Claude Code 表面を置き換えません。どの layer が owner なのかを先に決めます。
| 表面 | owner | 向く仕事 | workflow にしない理由 |
|---|---|---|---|
| 通常 session | 1 つの live conversation | 1 context で解ける | 複雑そうでも script は不要 |
| Subagent | specialized worker | 1 つの独立 reviewer が必要 | 1 worker で十分なら安い |
| Skill | reusable method | 手順を再利用したい | runtime branching は不要 |
| Hook | deterministic event rule | event 前後に自動実行したい | rule は agent fan-out を必要としない |
| Routine | unattended runtime | schedule や external trigger が owner | workflow は scheduler ではない |
| Dynamic Workflow | JavaScript orchestration script | plan を code にしたい | agent 数だけでは品質にならない |
この exit があるから安全です。method は skill、lifecycle rule は hook、翌朝また起きる仕事は routine、製品選択は別記事です。Dynamic Workflows は、計画を reviewable script として残す価値がある時だけ選びます。
ultracode、deep research、/workflows の役割
入口は複数あります。明示的な workflow request は、最も説明しやすい入口です。Claude に plan、slice、allowed tools、verification bar を先に出させます。/deep-research は research-heavy な探索に向きます。/workflows は run を観察し、token、状態、保存、停止を判断する場所です。
ultracode は session setting です。現在の model configuration docs では、通常の effort level とは別に、very high effort と Dynamic Workflows の orchestration を substantive task で使う可能性が説明されています。これは saved workflow ではなく、固定料金でもなく、すべての task を workflow にする命令でもありません。
| 必要なこと | 始め方 | 理由 |
|---|---|---|
| 明示的な orchestrated run | workflow を直接依頼 | decision が見える |
| research synthesis | /deep-research | research の形に合う |
| 必要性を Claude に判断させる | ultracode | 難しい仕事で候補になる |
| run の観察 | /workflows | usage と状態が見える |
| proven harness の再利用 | saved workflow file | plan が artifact になる |
古い version の挙動を調べる時は、まず upgrade し、同じ environment の /config と /workflows で確認します。
最初の workflow を安全に走らせる
始める前に 3 つ確認します。仕事を独立 slice に分けられるか。比較や検証が品質を上げるか。script が将来も再利用できるか。どれかが弱いなら、普通の session、subagent、skill に戻ります。
良い初回 prompt は小さいものです。repo 全体ではなく、auth package とその tests だけ。目的は migration risks を 3 つ見つけ、patch 案を出し、既存 test command で確認すること。package 外は編集しない。write 前に permission を求める。scale 前に usage と unresolved risks を報告する。
この prompt は scope、tools、verification、scaling condition を指定します。欲しい結果は agent 活動量ではありません。普通の Claude Code session よりよい evidence が出たかどうかです。
run 中は /workflows を開いておきます。tokens が独立作業に使われているか、同じ探索を繰り返していないか、permission が広すぎないか、synthesis が各 subagent の確認内容を説明しているかを見ます。弱いなら stop し、範囲を狭めます。
cost、limits、permissions、disable controls
Dynamic Workflows は無料の parallelism ではありません。公式 docs は workflow runs が usage と rate limits の対象であり、同じ task を single conversation で扱うより多くの tokens を使う可能性があると説明しています。/workflows は workflow usage を見せ、/usage は Claude Code 全体の利用状況を確認する面です。
2026年6月3日時点で、current limits は最大 16 concurrent agents、1 run 最大 1,000 agents です。これは powerful ですが、loose prompt が budget を浪費しやすいという意味でもあります。
permission control は launch 前から始まります。subagents は許可された tools と approval path に従います。初回は target path、allowed commands、review checkpoint を狭くします。team rollout では、/config、disableWorkflows、CLAUDE_CODE_DISABLE_WORKFLOWS=1、managed settings、admin settings のどこが stop control かを決めます。
| 事前確認 | 理由 | 証拠 |
|---|---|---|
| version | old behavior を避ける | local version check |
| feature enabled | availability は変わる | /config と same-day docs |
| smallest slice | broad run を防ぐ | target path と verification bar |
| tools | write と commands の範囲 | approval mode と allowlist |
| usage monitoring | tokens が増えやすい | /workflows、/usage |
| disable owner | kill switch が必要 | settings、env、admin |
この表を埋められないなら、広い workflow はまだ早いです。
向く例と向かない例
向く例は、複数の clean context が evidence を強める仕事です。large migration では packages ごとに分けて test できます。security audit では dependency、auth、data exposure、test coverage を別々に調べられます。claim verification では docs、code、runtime behavior を独立確認できます。
向かない例も多いです。single-file refactor は重要でも workflow ではありません。pre-commit の deterministic behavior は hook です。reusable prompt method は skill です。daily repo sweep は routine に近いです。単純な debugging は、branch が本当に増えるまで conversation のままで十分です。
team risk もあります。各 subagent が何を証明するか言えないなら、workflow は不確実性を隠します。まず verification bar を書き、その後で agents が必要かを決めます。
成功後に保存するもの
saved workflow は transcript ではなく automation artifact です。owner、inputs、allowed tools、stop rule、verification、reuse rule を明確にします。
| 項目 | 書くこと |
|---|---|
| Owner | repo area、team、release job |
| Intent | manual audit、migration slice、research harness |
| Inputs | paths、branch assumptions、test commands |
| Tool boundary | reads、writes、commands |
| Stop rule | いつ止めるか |
| Verification | tests、comparison、review evidence |
| Reuse rule | いつ再実行するか |
成功しただけでは保存しません。普通の prompt より script が読みやすく、再利用しやすく、改善しやすい時だけ保存します。
チーム導入前の確認
チームで Dynamic Workflows を使う時は、agent 数より ownership を先に決めます。owner、allowed tools、stop rule、verification evidence、rollback path がなければ、saved workflow は共有 automation ではなく個人の実験です。
初回 run の evidence は残します。prompt、target paths、approved tools、workflow slices、/workflows の usage、subagents の findings、failed branches、test commands、unresolved risks です。synthesis が各 subagent の検証を返さないなら、scope を広げません。
| 確認項目 | pass signal | 弱い時の対応 |
|---|---|---|
| Owner | repo area または team が明確 | shared workflow にしない |
| Permissions | writes と commands が限定される | scope を縮める |
| Usage | /workflows と /usage を確認 | fan-out を減らす |
| Verification | tests と comparison が明確 | prompt を書き直す |
| Disable path | /config、settings、env、admin owner が明確 | rollout しない |
Dynamic Workflows は review process を置き換えません。migration slice、claim verification、audit harness のような repeatable job で価値を証明し、script と explanation と reuse rule を一緒に保存します。
よくある質問
Dynamic Workflows は subagents と同じですか？
違います。subagents は worker です。Dynamic Workflow は複数の worker を script で調整する orchestration layer です。
ultracode は何をしますか？
ultracode は session setting です。very high effort と、substantive task で Dynamic Workflows を使う可能性を持ちます。saved workflow ではありません。
/deep-research は workflow ですか？
research-heavy な workflow behavior の entry point として使えます。coding migration や audit では scope、tools、verification を明示します。
saved workflows はどこに置きますか？
current docs は .claude/workflows/ と ~/.claude/workflows/ を示しています。reviewable automation artifact として扱います。
後で resume できますか？
current docs は resume を同じ Claude Code session に結びつけています。離れる前に /workflows で状態を確認します。
高くなりますか？
固定価格は出せません。usage と rate limits の対象で、single conversation より tokens を使う可能性があります。小さく始めて /workflows と /usage を見ます。
無効化できますか？
/config、disableWorkflows、CLAUDE_CODE_DISABLE_WORKFLOWS=1、managed settings、admin settings を確認します。team では owner を決めます。
routines、hooks、skills を置き換えますか？
いいえ。workflows は script-owned orchestration、routines は unattended runtime、hooks は deterministic event rules、skills は reusable method です。