Claude Code オーケストレーターが有用であるための4つの要素

Claude Codeでオーケストレーターエージェント（他のエージェントを管理するエージェント）を構築する場合、4つのコンポーネントが、役立つものと混沌としたものを分けます。以下は、数ヶ月にわたってそれらを構築して得た教訓です。

1. ミッションドキュメント

オーケストレーターをデフォルトのモデル知能に頼らせないでください。「ミッションドキュメント」、つまり何をすべきか、どのように行うか、いつエスカレーションするかを定義するジョブ記述を作成します。バグレポート用オーケストレーターの場合、次のようになります：

• 件名に「カスタマーフィードバック」があるメールをチェック
• ローカルにチケットを登録
• 子エージェントを起動してバグを再現し、複合エンジニアリング（またはsuperpowersやGSDなどの他のプラグイン）を使用して修正を実装
• QA準備ができたらアラート

ステップ4まで触れる必要はありません。最良の場合、時間を節約でき、最悪の場合、コードは破棄されます。

2. ハートビート（ループ）

ループのないオーケストレーターは単なるワンショットスクリプトです。本当の力は周期にあります—スケジュール（10分ごと、1時間ごとなど、適切な間隔）でミッションドキュメントを再読み込みします。ほとんどのエージェントCLIはループまたはcronプリミティブを提供しています。各ティックで、オーケストレーターは新しい作業をチェックし、既存タスクの進捗を監視し、ミッションに従って次にすべきことを実行します。

3. エージェント間通信

オーケストレーターは子エージェントにロードしなかったコンテキストを保持しています。子エージェントの質問に答えたり、間のアプローチを調整したり、あるエージェントが別のエージェントの作業をチェックする敵対的レビューを実行したりできます。実装は簡単で、構造化ルール付きの共有マークダウンファイル、メッセージパッシングツール、バックチャネルシステムなどがあります。メカニズムよりも、チャネルが存在することを確認する方が重要です。

4. 監査可能な制御

オーケストレーターが記録を生成するように構築します：決定したこと、起動した子エージェント、子エージェントが生成したもの。任意の子エージェントにジャンプインして作業をレビューし、いつでも中断できる必要があります。すべての可視性が出力に自信を持つ唯一の方法です—あなたはすべてに責任があります。

これらの原則は、元のビデオで示されたツールや他のエージェントツールを使用するかどうかに関係なく適用されます。既に使用しているものでオーケストレーターを構築できます。