Dynamic workflows

Dynamic workflows は、Qoder CLI で構造化された multi-agent プロセスをバックグラウンド実行するための機能です。段階的な実行、大きな fan-out、クロスチェック、再利用可能な手順が必要なタスクに適しています。 Workflow は orchestration plan を JavaScript スクリプトに移します。スクリプトは、どの子 Agent を起動するか、作業をどのフェーズに分けるか、中間結果をどう統合するか、最終的に何をセッションへ返すかを決定します。

Workflows を使う場面

使い方	適した場面
Subagent	1つの集中的なサブタスク。メイン会話には要約だけ返せばよい場合。
Skill	再利用可能な指示、ドメイン知識、またはメイン Agent が従うべき手順。
Workflow	多数の子 Agent、フェーズ、分岐、検証パスを含む再利用可能な orchestration。

単一の Agent 呼び出しより大きいタスクには workflow を使います。たとえば、リポジトリ監査、広範な調査、移行計画、リリースチェック、複数ファイルのスイープ、複数の独立した視点を統合するレビューです。

Workflows でできること

機能	説明
Scripted orchestration	ループ、分岐、フェーズ、中間状態を workflow script に保持します。
Multi-agent fan-out	独立した作業単位に対して複数の子 Agent を起動します。
段階的な実行	scan、analyze、verify、summarize などの名前付きフェーズで進捗を表示します。
並列または pipeline 処理	独立した分岐を並列実行するか、各項目を段階的に処理します。
バックグラウンド実行	workflow を起動した後も Qoder CLI を使い続けられます。
再利用	よく使う手順を project、user、plugin、built-in workflow として保存できます。

Workflow を実行する

自然言語で Qoder CLI に workflow の使用を依頼できます。

Use a workflow to review this repository for security risks and summarize findings.

保存済みまたは built-in workflow を名前で依頼することもできます。

Use the deep-research workflow to investigate the tradeoffs of this architecture decision.

Qoder CLI は現在の依頼に合わせて workflow を作成するか、タスクに合う保存済み workflow を使用します。動的に生成された workflow は、実行前に計画が表示されます。実行、raw script の確認、フィードバック付き拒否、キャンセルを選べます。 Workflow はバックグラウンドタスクとして実行されます。起動後、Qoder CLI は workflow run ID を返し、進捗をタスク UI に表示します。

Deep Research

deep-research は、広範な Web 調査、複数ソースの比較、claim 単位の検証が必要な質問に向けた built-in workflow です。焦点を絞った調査質問を指定して直接実行できます。

/deep-research 2026 年の消費者向け Web アプリで、パスキーとパスワードを採用する場合のセキュリティと運用上のトレードオフを比較してください。

依頼が広すぎてそのまま調査できない場合、Qoder CLI は先に確認質問を行い、絞り込んだ質問を workflow に渡します。 Workflow は次の 5 フェーズで実行されます。

フェーズ	処理内容
Scope	質問を相互補完的な検索観点へ分解し、質問の分野に合わせて観点を選択します。
Search	観点ごとに Web 検索 Agent を 1 つ並列実行します。各 Agent は元の質問に対する関連性で結果を順位付けし、明らかに低品質または無関係なページを除外します。
Fetch	URL を重複排除し、関連する公開ページを取得してソース品質を評価し、引用で裏付けられた検証可能な具体的 claim を抽出します。
Verify	複数の独立 Agent が抽出された claim を検証します。クロスチェックを通過しなかった claim は除外され、検証を完了できなかった claim は反証済みではなく未検証として扱われます。
Synthesize	意味が重複する claim を統合し、関連 findings を整理して confidence を付け、エグゼクティブサマリー、注意事項、未解決の質問、ソース引用を含むレポートを生成します。

最終レポートでは、主要 findings に証拠、confidence、ソース URL が付与されます。検証に失敗した claim は主要 findings に含まれません。Agent またはネットワークリクエストが検証完了前に失敗した場合、その claim は反証済みではなく未検証として記載されます。 Deep Research は子 Agent を通じて Web 検索と Web コンテンツ取得ツールを使用します。認証が必要なページ、非公開ページ、ペイウォールのあるページ、アクセスできないページからは、有効なコンテンツを取得できない場合があります。複数の Agent を起動するため token 消費が速くなる可能性があります。具体的な質問から始め、必要に応じて期間、地域、対象者、判断基準を限定してください。

Workflow を確認する

TUI で /workflows を使うと workflow タスクパネルを開けます。

/workflows

パネルでは、実行中および完了済みの workflow、状態、フェーズ、Agent、ログ、出力パス、エラー、最終結果を確認できます。/tasks でも他のバックグラウンドタスクと一緒に workflow タスクが表示されます。 Workflow の実行中は、詳細画面で個々の Agent を確認できます。選択中の Agent がまだ制御可能な場合は、その Agent を skip または retry できます。

Workflow を保存する

保存済み workflow は名前で再利用できます。Qoder CLI は次の場所から workflow を検出します。

スコープ	場所	用途
Project	`.qoder/workflows`	現在のリポジトリまたはチーム向けの workflow。
User	`~/.qoder/workflows`	個人用で、複数プロジェクトから使う workflow。
Plugin	Plugin が提供する workflows	プラグインと一緒に配布される workflow。
Built-in	Qoder CLI built-ins	Qoder CLI が提供する workflow。

同じ名前がある場合、project workflow は plugin や built-in workflow より優先されます。チームで共有する手順は project workflow に、リポジトリへコミットしない個人用手順は user workflow に置きます。保存済み workflow は、先頭で meta オブジェクトを export する JavaScript ファイルです。metadata は名前、説明、フェーズ、任意の使用場面や input schema を Qoder CLI に伝えます。

export const meta = {
  name: "repo-audit",
  description: "Audit a repository area and summarize risks",
  whenToUse: "Use when the user asks for a structured repository audit",
  phases: [
    { title: "Scan", detail: "Find relevant files and areas" },
    { title: "Analyze", detail: "Run focused analysis agents" },
    { title: "Summarize", detail: "Merge findings into a final report" }
  ]
};

.qoder/workflows/repo-audit.js に保存した後、次のように依頼できます。

Run the repo-audit workflow for the authentication module.

保存済み workflow は args で入力を受け取れます。対象パス、issue ID、調査質問、オプションなど、実行ごとに変わる値を script を編集せずに渡せます。

Workflow の実行方式

Workflow scripts は通常の JavaScript です。agent()、parallel()、pipeline()、phase()、log()、workflow()、args などの workflow helper を使えます。

Qoder CLI がタスクに対して保存済み workflow を選択するか、動的 workflow を作成します。
確認が必要な場合、workflow 名、フェーズ、script、実行オプションが表示されます。
Workflow がバックグラウンドタスクとして起動します。
Script が子 Agent を起動し、フェーズにグループ化します。
中間結果はメイン会話ではなく workflow runtime に保持されます。
最終結果は workflow run output に書き込まれ、現在のセッションに要約されます。

Workflow の scripts、manifest、journal、transcripts、出力は .qoder/sessions 配下の現在のセッションディレクトリに保存されます。

権限と安全性

Dynamic workflows は複数の子 Agent を実行し、token を速く消費する場合があります。大きい workflow や高コストな workflow を検証する場合は、小さい範囲から始めてください。 Workflow スクリプトは shell、ファイルシステム、ネットワーク、Node.js API、MCP サーバーへ直接アクセスできません。副作用は子 Agent を通じて発生し、その Agent は Qoder CLI のツール、権限、Hooks、サンドボックス設定を通過します。 workflow の子 Agent が実行できる内容は Permissions で制御できます。ツール呼び出しの前後に組織固有のポリシーを適用するには Hooks を使用してください。