4章 §2-A・マルチエージェントチーム実習 (Claude中心)

ターミナルや別のエディタで事前にファイルを作成しません。以下の3ステップをそのまま実行します — 灰色のコードボックスはすべて「コピー」ボタンでそのままコピーして貼り付ければよい内容です。

1. ① Claude Desktop Appでプロジェクトを開く

   Claude Desktop Appを実行し、さっき作成したharness-lab/フォルダをプロジェクトとして開きます。

2. ② サブエージェント作成リクエスト — チャットウィンドウに以下の文をそのまま貼り付けて送信

   AGENTS.mdに記載されているreviewer役割仕様に従って、.claude/agents/reviewer.mdにreviewerサブエージェントを作成してください。toolsはRead、Grepのみを許可し、modelはsonnetに設定してください。

   コピー

   Claude Desktop AppはAGENTS.mdの「役割/入力/出力/権限」仕様を読み取り、その内容を.claude/agents/reviewer.mdのYAML frontmatter(description、tools)とシステムプロンプトに移してWriteツールで直接生成します。仕様はそのままで、表現形式だけがツールに合わせて変わったのです — 生成が終わったら、チャットに表示されたファイル内容をAGENTS.mdと比較してみてください。
3. ③ レビュー対象ファイルの作成 + サブエージェントの呼び出し — 同じチャットウィンドウに続けて貼り付けて送信

   notes.txtファイルを作成し、「このプロジェクトは非常に良い。これはとても良い。」と書き込んだ後、reviewerサブエージェントでnotes.txtをレビューしてください。

   コピー

   Claude Desktop AppはAgent(Task)ツールをdescription="notes.txtのレビュー"、subagent_type="reviewer"で呼び出します。画面にはサブエージェントがスポーンされる過程と、作業を終えた後にメインセッションに戻る要約結果が順番に表示されます。

Claude Code(CLI)でも同様に — ターミナルでclaudeを実行した後、②③の文をそのままチャットに貼り付ければ、コマンドラインインターフェース(CLI)が同じようにAGENTS.md仕様を読み取り.claude/agents/reviewer.mdを直接生成・呼び出します。CLIでは追加でPostToolUseなどの自動化フックが発火するという違いがあります（Appではフックは発火しません）。

G-1と同様にファイルを事前に準備しません。G-1で開いておいた同じharness-lab/チャットで続けて進めます。

1. ① writerサブエージェント作成リクエスト — チャットウィンドウにそのまま貼り付けて送信

   AGENTS.mdに記載されているwriter役割仕様に従って、.claude/agents/writer.mdにwriterサブエージェントを作成してください。toolsはWrite、Readを許可し、modelはsonnetに設定してください。

   コピー

   Claude Desktop AppはAGENTS.mdのwriter仕様を読み取り、Writeツールで.claude/agents/writer.mdを直接生成します。G-1で既に作成しておいたreviewer.mdと同じ.claude/agents/フォルダ内に並んで配置されます — AGENTS.mdのhandoff_to: reviewerが次のステップで実際に繋がります。
2. ② writer → reviewer 順次パイプライン実行リクエスト — 同じチャットウィンドウに続けて貼り付けて送信

   writerサブエージェントでdraft.txtに「リモートワークの利点」というトピックの草稿を書かせ、完了したらreviewerサブエージェントでdraft.txtをレビューしてください。二つのステップを順番に進めてください。

   コピー

   メインセッションはまずsubagent_type="writer"でAgentを呼び出してdraft.txtを生成させ、その結果が戻ってきてから初めてsubagent_type="reviewer"呼び出しを送ります。二つの専門家間の依存関係を調整するのは、サブエージェントではなくメインセッションの役割です。

Claude Code(CLI)でも同様に — 同じwriter.md/reviewer.mdをそのまま使用し、ターミナルで①②の文をそのまま貼り付ければ同様に順次ディスパッチされます。

D-1を終えた同じチャットで続けて進めます。毎回どのサブエージェントが何回呼び出されるか、画面に表示される過程に注目します。

1. ① 単純リクエスト — reviewer一つだけが必要な場合

   draft.txtの誤字だけをざっと見てください。

   コピー

   オーケストレーターは今回のリクエストにwriterが必要ないと判断し、reviewer一つだけを呼び出します。同じチーム(writer+reviewer)が定義されていても、実際に投入される要員はリクエスト毎にオーケストレーターがその都度決定するということを示す最も単純な例です。
2. ② 複合リクエスト — writerとreviewerを二視点で組み合わせ

   draft2.txtに「週4日勤務制」というトピックで新しい草稿を書いてください。草稿が完了したら、その草稿を文法視点と論理視点の二つでそれぞれ独立して同時にレビューしてください。

   コピー

   今回はwriter一回（パイプラインの最初のステップ）の後に、reviewerが「文法視点」と「論理視点」という異なる指示を受けて二回同時に（ファンアウト）呼び出されます。パイプライン(writer → reviewer)とファンアウト(reviewer ×2同時実行)という二つのオーケストレーションパターンが一つのリクエスト内で組み合わされることを確認できます — 同じ二つのサブエージェントで①とは完全に異なる形状のワークフローが作られました。

Claude Code(CLI)でも同様に — 同じwriter.md/reviewer.mdをそのまま使用し、ターミナルで①②の文をそのまま貼り付ければ同様に動作します。

同じharness-lab/フォルダで実験的機能であるAgent Teamsを有効化します。Desktop AppではteammateModeは必ずin-processでなければなりません（tmuxはサポートされていません）。

1. ① 設定ファイルの作成 (ターミナル) — .claude/settings.jsonがない場合は新規作成、ある場合は以下の二つのキーをマージ

   macOS/Linux/Git Bashでは以下のコマンドをそのまま使用します。

   このコマンドは.claude/settings.jsonファイル全体を上書きします。既に他の設定が入っているファイルの場合は、既存の内容がすべて消えるため、必要な設定がある場合は事前にバックアップするか、以下の内容を手動でマージしてください。

   cat > .claude/settings.json << 'EOF'
   {
     "env": {
       "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
     },
     "teammateMode": "in-process"
   }
   EOF

   コピー

   Windows PowerShellでは here-stringで同じファイルを作成します。

   @'
   {
     "env": {
       "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
     },
     "teammateMode": "in-process"
   }
   '@ | Set-Content .claude/settings.json

   コピー
2. ② Claude Desktop Appの再起動

   設定を適用するには、Claude Desktop Appを完全に終了してから再度開きます。

3. ③ チームメイト並列スポーンリクエスト — チャットウィンドウに以下の文をそのまま貼り付けて送信

   writerチームメイト二名を並列でスポーンして、一つはtopic-a.txtに「在宅勤務」、もう一つはtopic-b.txtに「週4日勤務制」の草稿を同時に書かせてください。各ファイルが完了したらreviewerチームメイトがレビューするようにし、共有作業リストも表示してください。

   コピー

Claude Code(CLI)でも同様に — 同じ設定と同じリクエスト文がそのまま動作します。CLIではのみteammateMode: "tmux"を追加で選択でき、tmux分割ウィンドウで各チームメイトの画面を並べて見ることができる点がDesktop Appと異なります。

G-1のnotes.txtより少し複雑で、論理的欠陥がある文章を用意します。チャットウィンドウに以下の文をそのまま貼り付けます。

1. ① レビュー対象ファイルの準備

   argument.txtファイルを作成し、以下の内容を書き込んでください: 「在宅勤務は常にオフィス勤務より生産的である。なぜなら、在宅勤務をしている人々が在宅勤務が良いと言っているからである。したがって、すべての会社は在宅勤務のみを行うべきである。」

   コピー
2. ② haikuティアでレビュー

   チャットウィンドウに以下の文をそのまま貼り付けます。Claude Desktop Appはreviewer.mdのmodelフィールドをhaikuに変更した後、レビューを実行します。

   .claude/agents/reviewer.mdのmodelフィールドをhaikuに変更してください。そしてargument.txtをreviewerサブエージェントでレビューしてください。

   コピー
3. ③ sonnetティアで同じリクエストを繰り返す

   同じ方式でmodelをsonnetに変更してからレビューします。循環論法(circular reasoning)などの論理的欠陥を正確に指摘できるか、haiku結果と比較します。

   .claude/agents/reviewer.mdのmodelフィールドをsonnetに変更してください。そしてargument.txtをreviewerサブエージェントでレビューしてください。

   コピー
4. ④ opusティアで同じリクエストを繰り返す

   同じ方式でmodelをopusに変更してからレビューします。応答時間と指摘の深さが②③とどう異なるか記録します。

   .claude/agents/reviewer.mdのmodelフィールドをopusに変更してください。そしてargument.txtをreviewerサブエージェントでレビューしてください。

   コピー