> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynamic workflows

Dynamic workflows は、Qoder CLI で構造化された multi-agent プロセスをバックグラウンド実行するための機能です。段階的な実行、大きな fan-out、クロスチェック、再利用可能な手順が必要なタスクに適しています。

Workflow は orchestration plan を JavaScript スクリプトに移します。スクリプトは、どの子 Agent を起動するか、作業をどのフェーズに分けるか、中間結果をどう統合するか、最終的に何をセッションへ返すかを決定します。

<div id="when-to-use-workflows">
  ## **Workflows を使う場面**
</div>

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

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

<div id="what-workflows-do">
  ## **Workflows でできること**
</div>

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

<div id="run-a-workflow">
  ## **Workflow を実行する**
</div>

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

```text theme={null}
Use a workflow to review this repository for security risks and summarize findings.
```

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

```text theme={null}
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 に表示します。

<div id="monitor-workflows">
  ## **Workflow を確認する**
</div>

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

```text theme={null}
/workflows
```

パネルでは、実行中および完了済みの workflow、状態、フェーズ、Agent、ログ、出力パス、エラー、最終結果を確認できます。`/tasks` でも他のバックグラウンドタスクと一緒に workflow タスクが表示されます。

Workflow の実行中は、詳細画面で個々の Agent を確認できます。選択中の Agent がまだ制御可能な場合は、その Agent を skip または retry できます。

<div id="saved-workflows">
  ## **Workflow を保存する**
</div>

保存済み 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 に伝えます。

```js theme={null}
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` に保存した後、次のように依頼できます。

```text theme={null}
Run the repo-audit workflow for the authentication module.
```

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

<div id="how-workflows-run">
  ## **Workflow の実行方式**
</div>

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` 配下の現在のセッションディレクトリに保存されます。

<div id="permissions-and-safety">
  ## **権限と安全性**
</div>

Dynamic workflows は複数の子 Agent を実行し、token を速く消費する場合があります。大きい workflow や高コストな workflow を検証する場合は、小さい範囲から始めてください。

Workflow スクリプトは shell、ファイルシステム、ネットワーク、Node.js API、MCP サーバーへ直接アクセスできません。副作用は子 Agent を通じて発生し、その Agent は Qoder CLI のツール、権限、Hooks、サンドボックス設定を通過します。

workflow の子 Agent が実行できる内容は [Permissions](/ja/cli/permissions) で制御できます。ツール呼び出しの前後に組織固有のポリシーを適用するには [Hooks](/ja/cli/hooks) を使用してください。