開発チーム全体でAIコーディングエージェントをスケールする方法

コーディングエージェントを持つ開発者1人は、生産性の物語です。これは簡単に語ることができ、デモも良く、実際に真実です。

しかし、5人の開発者が20のエージェントを持つことはまったく異なる問題です。これは調整の問題であり、調整の問題はそれを生み出したツールでは解決されません。これは誰も書かない部分です。なぜなら、熱意のフェーズが終わった後にしか現れないからです：個々の利益は実際に存在し、すぐに現れますが、3人目または4人目の開発者の周辺で、チームは新しいスピードを自分たちの後始末に使い始めます。

以下は失敗の順序です。抽象的なベストプラクティスのリストではなく、実際に物事が壊れる順序です。なぜなら、間違った順序で修正すると、四分の一の時間を無駄にするからです。

最初に壊れるもの：共有コンテキスト

エージェントを実行しているすべての開発者は、自分自身のコードベースのバージョンを静かに教えています。

ある人は、自分のエージェントにプロジェクトがサーバーアクションを使用し、APIルートは使用しないと伝えます。別の人はそれについて言及せず、そのため彼らのエージェントはAPIルートを書きます。三人目は、3日前に終了したセッションで一度だけ言及します。誰も間違っていないし、誰も嘘をついていません。そして、リポジトリには同じ規約の3つの解釈が含まれています。これはレビューキューで気づくことになりますが、それは気づくべきではない場所です：その時点でコードは存在します。

修正は退屈で、このページで最も影響力のあることです。規約をファイルに入れ、そのファイルをコミットしてください。

CLAUDE.mdはClaude Code用、AGENTS.mdはCodexおよびほとんどの他のCLIエージェント用で、実際には多くのチームが1つのポータブルコンテキストファイルを保持し、2つのファイルを維持するのではなく、互いに離れていくのを避けています。メカニズムはファイル名よりも重要です：指示はリポジトリに存在するため、誰がその部屋にいたかに関係なく、git pullで到着します。

それに含まれるべきもの：

• エージェントがコードを読むことで推測できない規約、特に現在コードベースが違反している場所
• コマンド：テスト、ビルド、リンターの実行方法、そしてどれが自動的に実行されることを許可されているか
• 触れるのが危険なリポジトリの部分とその理由
• チームが望まないこと：誰も求めていないリファクタリング、追加してはいけない依存関係、移行中のパターン

含まれるべきでないもの、そしてここでチームが痛い目に遭うもの：1台のマシンに特有の何か。絶対パス、個人のAPIトークン、ローカルポート、誰かの好みのエディタ。コミットされたコンテキストファイルにマシン特有の値が入った瞬間、他のすべての開発者は自分には間違った設定を継承し、エージェントはもはや適用されない指示に忠実に従うのが得意です。

行を追加する前に有用なテスト：もしチームメイトがこれを引き出したら、彼らにとって助けになりますか、それとも壊れますか？

次に壊れるもの：2つのエージェント、1つのファイル

エージェントは交渉しません。他の誰かが編集中かどうかを確認しません。同じモジュールを指す2つのエージェントは互いに上書きし、どちらもそれを言及しません。なぜなら、各エージェントの視点からは作業が成功裏に完了したからです。

単独では、これは目に見えません。1つのエージェントを1回実行するか、複数を実行して異なるものに触れることができます。チームでは、これは構造的な問題となり、最悪のクラスのバグを生み出します：2つの緑のテスト実行の間に静かに消える作業です。

これを修正するための2つのメカニズムがあり、両方を望みます。

隔離。 Gitワークツリーは、各タスクにリポジトリの独自のチェックアウトを提供するため、並行するエージェントは物理的に衝突できません。これは解決策の安価な部分であり、実行しない理由はありません。

所有権。 隔離は上書きを防ぎますが、2人が同じ問題を2つのブランチで、2つの互換性のない方法で解決するのを止めることはできません。それは、各タスクをファイルのセットにスコープし、タスク自体でそれを明示することによって解決されます。「チェックアウトフローを改善する」ではなく、「この3つのファイルで支払いステップを変更し、カートには触れない」とします。

後者はチームがスキップする部分であり、マージが形式的なものか午後の作業かを決定します。

第三に壊れるもの：レビュー

チーム規模でのレビューに関するすべては、1つの数字から派生します：1時間あたりに到着するdiffの量です。

1人の開発者がすべての行を読むのは問題ありません。5人の開発者がそれぞれ4つのエージェントを実行すると、チームが読むことができる以上のdiffが1日に生成され、正直な結果は慎重なレビューではなく、承認の演技です。午後6時に900行のdiffをざっと見る人間は、知識を生み出さずに署名を行い、これはレビューを行わないよりも悪いです。なぜなら、それは何もないところに保証を生み出すからです。

生き残るポリシーは「すべてをレビューする」でも「エージェントを信頼する」でもありません。作業の2つの境界にレビューを移動することです：エージェントが開始する前に計画を読みます。なぜなら、間違った計画が完璧に実行されることは、最も高価な失敗モードだからです。そして、変更が壊す可能性のあるものに比例してdiffを読みます。マーケティングコピーやCSSはざっと見ます。認証、支払い、権限、個人データ、移行は、毎回人間が行単位で読みます。diffがどれほどクリーンに見えても関係ありません。

これは独自の会話に値します。私たちはそれを別途書きました：AIエージェントのコードをまだレビューすべきかでは、変更が間違っていた10の客観的な兆候と、チームがそのまま採用できる爆風半径テーブルを説明しています。

1つのチーム特有の追加事項。複数のエージェントがリポジトリを共有する場合、レビューには帰属が必要です：どのエージェント、どのタスク、どの開発者。これがなければ、diffには著者がなく、レビューは考古学に変わります。これは、3つまたは4つの同時エージェントを超えた後に設定を修正するために最も有用なことです。

第四に壊れるもの：コスト、そしてコストに関する会話

トークンの支出は、チームの請求書に表示される瞬間から個人的な詳細ではなくなります。

罠は、請求書が月次で集計されているため、生成される会話も月次で集計され、修正ではなくポリシーを生み出すことです。誰かが全員のために安価なモデルを提案します。別の誰かがセッションを制限することを提案します。どちらも推測です。

実際の分布はほとんど均一ではありません。1つまたは2つのプロジェクトで長時間実行されるセッションが少数あり、コンテキストは一日中成長し、リセットされることはありません。これは修正可能な行動であり、月ごとではなく、セッションごとおよびプロジェクトごとの支出を見えるようにすることでのみ修正できます。このメカニズムについては、トークン使用量を確認する方法および遅くせずに削減する方法で説明しました。

生成する人々にその数を見えるようにしてください。それが管理のトピックになる前に。1つのセッションが彼らの前の1日全体のコストを超えたことを見た開発者は、自分の習慣を自発的に変え、チームにとって政治的に何のコストもかかりません。

チームの儀式で実際に変わること

私たちの経験とチームの報告によれば、3つのことです。

スタンドアップはステータスからブロッキングにシフトします。 各人が昨日何をしたかは、ブランチで大体見えています。5分の価値があるのは、どのエージェントが詰まっているか、そして何に詰まっているかです。

プロンプトは共有資産になります。 1人の開発者に良い結果をもたらした指示は、生成されたコードよりもチームにとって価値があり、プライベートターミナルの履歴では消えてしまうようなものです。共有プロンプトライブラリをリポジトリに保持するチームは、毎週同じフレーズを再発見するのを止めます。

専門化は人から役割に移ります。 エージェントが執筆を担当するようになると、興味深い質問は誰が何をレビューするかです。チームは自然に、エージェントに役割を割り当てることに向かいます。実装に1つ、レビューに1つ、テストに1つです。これはエージェントチームの背後にあるアイデアであり、タスクはDev役割からQA役割に渡され、diff、リスク、テストのヒントが添付され、品質ゲートはエージェント自身の作業に対する意見ではなく、テストスイートによって決定されます。

維持されるセットアップ

重要な順序で要約します：

最初の4つは合意以外のコストはかかりません。最後の2つは、チームが最終的にターミナル以上のものを望む理由です。ターミナルが悪いからではなく、ターミナルは1つのエージェントしか表示せず、「誰が何を、どのプロジェクトで、今何をしているのか」という質問に答える方法がないからです。

それがチーム向けのAgentsRoomが構築されている問題です：すべてのプロジェクトにわたるすべてのエージェントを1つのビューで、役割、ステータス、コストを添付し、チームがデスクにいないときのためのモバイルコンパニオンを提供します。これはClaude CodeとCodexの両方で同じ方法で機能します。これは聞こえるよりも重要です：ほとんどのチームは両方を実行することになり、1つのプロバイダーを前提としたセットアップは静かに次に壊れるものになります。

ただし、コンテキストファイルから始めてください。それは無料で、午後を要し、今四半期にインストールできるどのツールよりも摩擦を取り除きます。