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

​
Workflows を使う場面

使い方適した場面
Subagent1つの集中的なサブタスク。メイン会話には要約だけ返せばよい場合。
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 に表示します。

​
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。
PluginPlugin が提供する workflowsプラグインと一緒に配布される workflow。
Built-inQoder CLI built-insQoder 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、budget などの workflow helper を使えます。
  1. Qoder CLI がタスクに対して保存済み workflow を選択するか、動的 workflow を作成します。
  2. 確認が必要な場合、workflow 名、フェーズ、script、実行オプションが表示されます。
  3. Workflow がバックグラウンドタスクとして起動します。
  4. Script が子 Agent を起動し、フェーズにグループ化します。
  5. 中間結果はメイン会話ではなく workflow runtime に保持されます。
  6. 最終結果は 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 を使用してください。