Claude Agent Teams を役に立たないと感じさせる近道は、間違った相手にメッセージを送り続けることです。

これは気づきにくい問題です。

チームメイトにテストを実行するよう伝えたつもりが、リードに伝えていた。

全体の制約をブロードキャストしたつもりが、チームメイト1人に送っていた。

その結果、チームが防ぐはずだったことをする羽目になります。

• コンテキストを説明し直す
• 同じことを繰り返す
• 誰かに伝わったのか疑う

このガイドは振り分けの手引きです。リード、チームメイト、ブロードキャストの使い分けと、メッセージを意図した相手に届けるための小さな習慣を扱います。

要点

1. Claude Agent Teams では、何を言うかを決める前に、必ず誰に話すかを決めます。
2. 使い分け:
   • 調整と最終判断には リード
   • 具体的な作業には チームメイト
   • 全体の制約には ブロードキャスト
3. 確認できるメッセージを優先します:
   • 1行の受領確認を頼む（「了解と現在のステップ」）
   • リスクのある操作の前にチェックポイントの要約を頼む
4. 振り分けを明示するインターフェースが欲しいなら、Happier は役立つ選択肢の1つです。送信先（Send to）チップがあり、振り分けたメッセージを 宛先（To）付きのカードで表示します。

課題

振り分けは、チームの隠れたコストです。

単一スレッドのセッションでは、すべてのメッセージは1か所に届きます。

チームでは、メッセージは宛先のある操作です。

その宛先をはっきりさせないと、次のことが起きます。

• 作業の重複
• 制約の見落とし
• 「なぜこのチームメイトは違うことをしているの？」という混乱

よくある方法とトレードオフ

• 常にリードに話す: 安全ですが、チームが1つのエージェントにつぶれてしまいます。
• チームメイトにだけ話す: 速く感じますが、調整の層を失います。
• すべてをブロードキャストする: ノイズが増え、責任があいまいになります。

うまくいく振り分けの地図

リード（調整）

リードを使うのは、次が欲しいときです。

• 計画
• 要約
• チームメイトの出力どうしの食い違いの解決
• 最終判断

アプリ上ではリードは メイン（Lead）と表示されます。

よいリード向けメッセージの型:

各チームメイトがわかったことを要約し、意見の食い違いを挙げ、判断を1つ提案してください。

チームメイト（実行）

チームメイトを使うのは:

• タスクが明確で範囲が決まっている
• 入力と出力をすっきり説明できる

よいチームメイト向けメッセージの型:

X をしてください。終わったら止まってください。返信には次を含めてください: (1) 変更した内容、(2) 変更していない内容、(3) 私に必要なこと。

ブロードキャスト（全体の制約）

ブロードキャストを使うのは:

• 全員に当てはまる制約のメッセージ
• 調整のメッセージ（「一時停止」「チェックポイント」「次のステップで止まって」）

よいブロードキャストメッセージ:

• 「マイグレーションには触れないでください。」
• 「次のステップが終わったら止まって要約してください。」
• 「依存関係をインストールしそうなら、先に確認してください。」

よくないブロードキャストメッセージ:

• 「このファイルをリファクタリングして」（担当があいまい）
• 「このテストを直して」（誰の責任？）

実例（コピー用）

例 1: 安全のための制約をブロードキャストする

マイグレーションや認証には触れないでください。必要だと思ったら、止まって確認してください。

例 2: テストのタスクを1人のチームメイトに振る

この変更に対する最小限のテスト計画を実行してください。

返信には次を含めてください:

• 実行したコマンドそのもの
• 失敗（エラー全文）
• 修正案を1つ（あれば）

例 3: 裁定をリードに振る

2人のチームメイトの意見が分かれました。両方の立場を5つの箇条書きで要約し、1つを推奨してください。

メッセージがどこに届いたかを確かめる方法

大事なのは、あとから振り分けを確認できることです。

インターフェースが振り分けを表示しないと、推測するしかありません。

Happier では、振り分けた送信は構造化された参加者メッセージとして保存され、受信者がはっきりわかるラベル（「宛先: …」）付きのメッセージカードとして表示されます。

チームが3人以上になったら、このくらいの明示性が欲しくなります。

トラブルシューティング

メッセージを送ったら、違うエージェントが動いた

よくある原因:

• 明示的に振り分けていなかった
• ブロードキャストを「リード」だと思い込んでいた

対処:

• 意図した相手にメッセージを送り直す
• 意図しなかった相手には、止まって何をしたか要約するよう頼む

ブロードキャストがうるさく感じる

ブロードキャストは制約と調整のためのもので、タスクの割り当てには使いません。

ブロードキャストがタスクだらけなら、振り分けが機能していません。

チームメイトが同じ質問を繰り返す

チェックポイントのルールを加えます:

確認の質問を1つしてから、慎重な解釈で進めてください。

よくある質問

すべてのメッセージを振り分けるべきですか？

いいえ。

振り分けが特に重要なのは:

• チームメイトが2人以上いる
• 全員に当てはめるべきでない指示を出す

安全なデフォルトの送信先は？

リードです。

誰がタスクを担当すべきかわからなければ、リードに送って振り分けを頼みましょう。

よくある間違い

• 細かいタスクにブロードキャストを使う
• 1人のチームメイトに送るべき修正をリードに送る
• 受領確認やチェックポイントを頼み忘れる

関連ガイド

• Claude Agent Teams の管理方法（チームメイトの作成、メッセージ送信、進捗の追跡）