Facade Code ドキュメント
連携パターン

Facade パターン:1 つのエージェントにチームを任せる

1 つのエージェントに、機能開発を担当する各エージェントの進捗を確認させ、質問をあなたに届けさせます。席を外すときは、そのマネージャーとスマートフォンから会話を続けます。

このパターンを使う場面

複数のエージェントが機能を開発していて、進捗の確認と質問への対応を 1 か所にまとめたいときに使います。すべてをローカルで実行しても、一部を SSH 経由のリモートマシンで動かしてもかまいません。マネージャーはチームの窓口として、各エージェントが作業を続ける間、状況報告を集約します。

この分業が役立つ理由

  • 複数の機能を 1 つの会話で追える。 マネージャーに全体像を尋ねると、機能エージェントから状況報告を集めて、各機能の状況を教えてくれます。
  • 対応が必要なことを把握できる。 マネージャーがターミナルでエラー、クォータのメッセージ、未回答の質問を確認します。必要に応じて該当するエージェントに詳細を尋ねます。
  • 席を外している間も状況を把握できる。 スマートフォンをマネージャーのセッションに接続し、進捗の確認、質問への回答、新しい指示の送信ができます。

1. マネージャーを起動する

  • 追跡したいプロジェクトのエディターを開いたままにします。リモートマシンのエージェントについては、SSH 接続を有効に保ちます。
  • 既存の Claude Code エージェントをマネージャーとして使うか、New Agent で作成します。

この例では Claude Code をマネージャーとして使います。機能エージェントはすでに実行中で、それぞれの CLI とモデルを維持します。

役割CLIモデルeffort
マネージャーClaude Code (claude)opushigh
機能 A — ローカルで実行中Codex (codex)gpt-6-solhigh
機能 B — SSH 経由で実行中Codex (codex)deepseek-v4.1-flashxhigh
機能 C — SSH 経由で実行中Muse Code (muse)muse-spark-1.3high

プロジェクトで Facade を開き、New Agent をクリックして、マネージャー用に Claude Code を選びます。モデルは /model opus、effort は /effort high で設定します。

YOLO が有効な場合、マネージャーは Facade ホームを通じて接続されたすべてのエージェントに到達できます。この設定は CLI の承認動作も変えます。詳細はエージェントの権限を参照してください。

2. 他のエージェントを追跡させる

次のプロンプトをマネージャーに送ります。

プロンプト
Facade を使って他のエージェントを追跡してください。
5 分ごとに各エージェントのターミナルを読み、進捗を確認してください。不明な点があれば、エージェントに直接尋ねてください。
エージェントでエラーが起きたとき、行き詰まったとき、または私の判断が必要なときは知らせてください。
進捗を尋ねたら、各機能の状況をまとめてください。

3. チームを追跡する仕組み

  1. 機能エージェントを見つける
  2. 定期的に進捗を確認
  3. 質問して問題を報告
  4. スマートフォンから続ける
  1. マネージャーは機能エージェントを見つけ、5 分ごとに確認をスケジュールします。
  2. 各確認では、エージェントのターミナルを読みます。進捗が不明な場合は、該当するエージェントに尋ねます。
  3. 問題を報告し、判断が必要な質問をあなたに届けます。
  4. マネージャーのセッションで答えると、その回答を機能エージェントに伝えます。いつでも全体の進捗レポートを求められます。

確認のスケジュールが決まったら、マネージャーが知らせます。マネージャーのセッションは実行したままにしてください。マネージャーが忙しい間は、確認が遅れることがあります。

Claude Code のスケジュールされたタスク ↗

4. スマートフォンから続ける

マネージャーの Claude Code セッションで次を実行します。

スマートフォンからマネージャーに接続する
/remote-control

プロンプトに従い、スマートフォンでセッションリンクを開くか QR コードをスキャンします。

マネージャーに進捗を尋ねたり、質問に答えたり、要件の更新を送ったりできます。マネージャーは引き続き Facade を通じて機能エージェントを追跡します。

マネージャーのコンピューターはスリープさせず、オンラインのまま Claude Code を起動しておいてください。アカウントの要件と接続のヘルプはスマートフォンから作業を続けるを参照してください。

任意:プロジェクトの意思決定のために PM やテックリードを追加する

日常的な判断には、プロダクトマネージャー(PM)またはテックリード(TL)のエージェントを起動し、Facade でピン留めしておく方法があります。プロジェクトの方向性、優先順位、技術的な制約、過去の決定について相談してください。実装とデバッグは機能エージェントに任せ、これらの会話を意思決定に集中させます。

両方を追加する場合は、マネージャーにどう関与させるかを伝えます。

日常的な判断は PM と TL に任せる
Facade を使って、日常的なプロダクトの質問は @PM に、技術的な質問は @TL に送ってください。
合意したプロジェクトの方向性に基づいて判断させ、その回答を機能エージェントに伝えてください。
その方向性を変える判断が必要な場合や、2 人の意見がまとまらない場合は、私に確認してください。

PM や TL のセッションが長くなったら、プロジェクトの方向性、過去の決定とその理由、未解決の質問をまとめた引き継ぎを依頼します。引き継ぎを新しい PM または TL に渡し、マネージャーに連絡すべきエージェントを伝えます。

自分のプロジェクトで使う

  • 確認の間隔を調整したり、注意が必要な機能に集中するようマネージャーに依頼したりできます。
  • 機能エージェントは現在のマシンで作業を続けられます。マネージャーはそのターミナルを読み、Facade 経由でメッセージを送ります。
  • プロジェクトごとに専用のマネージャーを置きます。各マネージャーはそのプロジェクトのエージェントを追跡し、あなたは各マネージャーに確認します。

Remote Control を使う場合、マネージャーは Claude Code のままにしてください。機能エージェント、PM、TL は他の CLI やモデルを使えます。保存した起動設定と他のプロバイダーについては、エージェント設定、別のプロバイダーを使う Claude Code、別のプロバイダーを使う Codexを参照してください。

Markdown で表示 ↗ドキュメント

ドキュメントを検索

このガイド内を検索します。↑ ↓ で移動、Enter で開き、Esc で閉じます。