学習目標:
- 単一の会話とワークフローの根本的な違いを理解する
- ワークフローに適したタスクの特性を認識する
- ワークフローオーケストレーションの核心的価値を把握する
前提: Claude Codeや類似のAIツールを使用したことがある | 次: レッスン2 >>
Claude Codeに大規模なコードベースのリファクタリングを依頼します。「この5,000行のモノリスをマイクロサービスに分割して」
Claudeは作業を開始します。ファイルを読み、モジュールの境界を特定し、依存関係を抽出し、そしてファイル47あたりで、コンテキストウィンドウがいっぱいになります。以前の作業を忘れ、最初からやり直し、ループに陥ります。1
あるいは「すべてのオープンなPRをレビューして、今週のリリースノートを書いて」と依頼します。Claudeは一度に1つのPRしか処理できないため、手動で20回実行し、毎回フォーマットルールを再説明することになります。
これが単一の会話の上限です。1つの会話、1つのコンテキストウィンドウ、1つの推論チェーン。複雑なタスクに対して、このパターンは破綻します。2
ワークフローは、複雑なタスクをステップに分解し、各ステップを新しいエージェントに委譲し、全体を自身で調整する実行可能なスクリプトです。3
主な違い:
例えば、リファクタリングワークフローは次のようになります:
スクリプトがループ、分岐、中間結果を保持し、Claudeのコンテキストは最終的な答えだけを見ます。オーケストレーションは決定論的で、各ステップ内の作業のみがモデル駆動です。3
ワークフローに適したタスクを示す4つの特性:
公式ドキュメントは明確に述べています: "Reach for a workflow when a task needs more agents than one conversation can coordinate, or when you want the orchestration codified as a script you can read and rerun."（1つの会話が調整できる以上のエージェントが必要なタスク、またはオーケストレーションを読み、再実行できるスクリプトとして成文化したい場合にワークフローを選択してください）2
典型的なシナリオ:
ワークフローが間違ったツールである場合:
ワークフローは突然現れたわけではありません。Claude Codeのオーケストレーション能力の第4段階です:1
段階1: モノリシックエージェント
段階2: サブエージェントファンアウト（Agentツール）
段階3: エージェントチーム
段階4: ワークフローオーケストレーション
ワークフローの核心的革新は制御フローの反転です: エージェントに「次に何をすべきか」を決めさせる代わりに、スクリプトが「次にどのエージェントを呼び出すか」を決定します。3
オーケストレーションは文字通りの意味です: "Orchestration is exactly what it sounds like: one score, many musicians. A script deciding it — for loop, if statement — is orchestration."（オーケストレーションはまさにその通りの意味です: 1つの楽譜、多数の演奏者。スクリプトがそれを決定する — forループ、if文 — それがオーケストレーションです）1
ワークフローにおいて:
forループ、if文、Promise.all呼び出し。agent()呼び出しが起動するサブエージェント。これがその区別を、それを命名したガイドの言葉で: "A normal agent decides the control flow as it goes. A workflow inverts that. You write the control flow as plain code, and each individual step is delegated to a fresh subagent."（通常のエージェントは進むにつれて制御フローを決定します。ワークフローはそれを反転させます。制御フローをプレーンなコードとして書き、個々のステップは新しいサブエージェントに委譲されます）
通常のエージェントは実行時に即興します: 「最初にAを実行し、その後BかCのどちらを実行するか決定」。ワークフローは制御フローをコードで固定します: 「A1〜A10を並列実行し、すべて完了したらBを実行。Bがscore > 0.8を返せばCを実行、そうでなければD」。
決定論的オーケストレーションが得られるもの:
.claude/workflows/に存在し、名前で呼び出せる。実際のケースを見てみましょう。チームには15個のPRがレビュー待ちで、各PRには4つのチェックが必要です:
単一の会話では、15回実行し、毎回手動でPRを切り替えます。
ワークフローでは:
このワークフローが得られるもの:
次: レッスン2 >> — ワークフロー構成要素: ステップ、状態、分岐、ループ
ClaudeWorld: What Is a Workflow? Multi-Agent Orchestration Explained — https://claude-world.com/articles/what-is-a-workflow-multi-agent-orchestration/ ↩ ↩2 ↩3
Claude Code 公式ドキュメント: Workflows — https://code.claude.com/docs/en/workflows ↩ ↩2 ↩3
Alex Op: Claude Code Workflows and Deterministic Orchestration — https://alexop.dev/posts/claude-code-workflows-deterministic-orchestration/ ↩ ↩2 ↩3 ↩4
基準:
記述内容:
シナリオA: 明確なロジックを持つ50行の関数のバグを修正する。
シナリオB: 30個のコンポーネントのUIライブラリをMaterial-UI v4からv5にアップグレードする。
判断と理由を記述してください（各シナリオ2〜3文）。
// 疑似コード例
async function refactorWorkflow(codebase) {
// ステップ1: すべてのモジュールを並列解析
const modules = await Promise.all(
codebase.files.map(file =>
agent({ task: `${file}の責務と依存関係を解析` })
)
);
// ステップ2: マイクロサービスの境界を提案
const plan = await agent({
task: '解析結果からマイクロサービスの境界を設計',
context: modules
});
// ステップ3: 各サービスを並列抽出
const services = await Promise.all(
plan.services.map(svc =>
agent({ task: `${svc.name}サービスのコードを抽出` })
)
);
// ステップ4: すべてのサービスのテストが通ることを検証
return await agent({
task: 'すべてのサービスのテストスイートを実行',
context: services
});
}
┌─────────┐│ Claude │ 1つのコンテキストウィンドウがすべてを実行:└─────────┘ 読み込み、計画、編集、テスト┌─────────┐│ Claude │──→ agent: "コードベースを検索"│ (main) │──→ agent: "これら40ファイルを読む"└─────────┘ 結果が親エージェントに返る┌─────────┐ ┌─────────┐ ┌─────────┐│ Planner │───→│ Coder │───→│ Tester │└─────────┘ └─────────┘ └─────────┘ 各エージェントが独自の役割とコンテキストを保持 ┌─────────────────┐ │ Workflow Script │ ループ、分岐、状態を保持 └────────┬────────┘ ┌───┴───┬───────┬───────┐ ↓ ↓ ↓ ↓ agent() agent() agent() agent() 各呼び出しが独立したサブエージェントを起動async function reviewPRsWorkflow(prList) {
// フェーズ1: すべてのPRを並列レビュー
const reviews = await Promise.all(
prList.map(pr =>
agent({
task: `PR #${pr.number}をレビュー`,
prompt: `コードスタイル、潜在的バグ、テスト、ドキュメントをチェック。
JSON出力: { style: score, bugs: [],
coverage: number, docs: boolean }`
})
)
);
// フェーズ2: レポート集約
return await agent({
task: '週次レポート生成',
prompt: `${reviews.length}個のPRのレビュー結果に基づいて、
今週のコード品質レポートを作成し、
問題を重大度順にソート`
});
}