結論から言うと: 難しいプロジェクトを2つのコーディングエージェントで分担するには、互いが相手の出力を検証できる役割を割り当てます。片方が調査して学んだことをファイルに書き残し、もう片方がその記録に基づいて構築する。あるいは、両方が同じステップに挑戦し、結果を比較します。共有コンテキストは両方が読む1つのファイルに置き、現実世界に影響を与えるすべての操作には人の承認を挟みます。
ある開発者の1994年式ジープ・チェロキーにはOBD2ポート(後年の車の標準診断コネクタ)がなく、彼いわく「使えるスキャンツールが存在しない」状態でした。エンジンコンピュータ(ECU)を読めるものは何もなかったのです。彼は3ドルのArduino Nanoを診断プラグに配線し、作業をClaude CodeとCodexという2つのコーディングエージェントに任せました。このプロジェクトの動画は今月、Hacker Newsで450ポイントと230件以上のコメントを集めました。
あなたのチームにとって役立つのは、難しく未知のプロジェクトが2つの異なるエージェントと1人の慎重な人間によって進められたその方法です。このガイドではそれを再利用可能なパターンに変え、2つのエージェントがターミナルのタブ2枚では収まらなくなったときにSharklyがどう役立つかを示します。
ジープECUプロジェクトが示す、2つのコーディングエージェントの使い方
ソースに書かれていることだけを述べます。動画の説明文で作者は、約1週間かけてエージェントたちが「コンピュータにライブアクセスし、ドライブを記録し、プログラム全体をコピーし、その中で独自のコードを実行した」と書いています。チャプターリストでは、配線の解明と燃料ポンプのテスト実行はClaudeの功績、コンピュータ内でのコード実行はCodexの功績とされています。あるチャプターのタイトルは「The night drive: the tool was wrong(夜間走行:ツールが間違っていた)」でした。
そこから生まれたxj-scannerリポジトリのほうが、より興味深い成果物です。際立ったポイントは3つ:
- 共有の指示ファイルが1つ。
AGENTS.mdは「このリポジトリで作業するあらゆるエージェント」のエントリーポイントです。CLAUDE.mdはそれへの参照1行だけなので、Claude CodeとCodexが同じルールを読みます。 - 書き残された知識。
docs/フォルダにはプラグのピン配列、プロトコル、スケーリング付きの全パラメータが格納されており、次のエージェントは前のエージェントが学んだことから始められます。 - 人間による停止ポイント。 ルールでは読み取りは安全とされていますが、故障コードの消去、燃料トリムのリセット、「実機のハードウェアを操作する」アクチュエータテストには、それぞれ事前に本人の承認が必要です。
動画では正式な分担方法は公開されていないため、以下で紹介する分担は結果から導いたパターンとして捉え、彼のセッションの文字起こしではない点にご注意ください。
難しいプロジェクトに2つのコーディングエージェントが必要なとき
「自信満々に間違える」ことのコストが高い作業には、2つのエージェントを使いましょう。リバースエンジニアリング、移行、未知のプロトコル、ドキュメントがない状態でのデバッグなどがこれに該当します。異なるモデルを搭載した2つ目のエージェントは独立した読みを与えてくれ、両者の食い違いは対応可能なシグナルになります。
タスクが小さく仕様が明確な場合は、2つ目のエージェントは不要です。Crewsに関するSharklyのドキュメントも、協調全般について同じことを述べています。小さく明確に定義された作業は1つのエージェントに割り当て、誰かがゴールを解釈して結果を統合する必要があるときだけチームを編成する、という考え方です。
コーディングエージェント間でプロジェクトを分担する3つの方法
プロジェクト単位ではなく、フェーズ単位でパターンを選びます。調査、構築、危険なライブテストでは、それぞれ異なる分担が適しています。
| パターン | エージェントA | エージェントB | 使うべき状況 |
|---|---|---|---|
| 調査役と構築役 | 調査を行い、発見をファイルに書き込む | その発見に基づいて構築する | ドメインが未知でドキュメントが乏しいとき |
| 2つの独立した試行 | 単独でステップを解く | 同じステップを単独で解く | 誤った答えのコストが高く、見抜くのが難しいとき |
| 構築役とレビュー役 | 変更を書く | 仕様とデータに照らしてレビューする | 変更内容は明確だがリスクが高いとき |
調査役と構築役:地図は誰が書く?
調査役の出力はコードではなくドキュメントです。xj-scannerではそれがdocs/フォルダにあたります。コネクタを1つのキャビティ単位で測定した記録、プロトコル、パラメータテーブルです。構築役はそのファイルを元に作業するため、ピン配列を再発見する必要がありません。構築役が矛盾にぶつかったらドキュメントを更新するため、地図が常に唯一の信頼できる情報源であり続けます。
2つの独立した試行:どう比較する?
両方のエージェントに同じプロンプトと同じ入力を与え、お互いの回答を見せないようにします。その上で、信頼できるデータを使って出力を比較します。プロトコルデコーダーなら、両方に同じキャプチャログを入力し、デコード結果を差分比較します。公平なセットアップについては同じバグでのClaude Code vs Codexの記事で扱っています。
構築役とレビュー役:レビュー役は何を検証する?
レビュー役はスタイルではなく、主張を証拠と突き合わせて検証します。「燃料トリムが+40%と読まれる」は主張であり、レビュー役は誰かがそれを踏まえて動く前に、スケーリング式が正しいかを問います。xj-scannerのルールはこれを明文化しています:「おかしく見える読み取り値は、スケーリングのクセかもしれません」。より安価なワーカーと強力なレビュー役の組み合わせについては、レビュー役を分離した混合モデルCrewのガイドで深く掘り下げています。
2つのコーディングエージェントがコンテキストを引き継ぐ方法
エージェントはメモリを共有しないため、引き継ぎはファイルとタスクの記録に宿らせる必要があります。大部分を担うのは次の4つ:
- 両方が読む指示ファイルを1つ。 AGENTS.mdはCodexが読むオープンなフォーマットです。Claude Codeは
CLAUDE.mdを読み、そのメモリのドキュメントには他のファイルのインポートが記載されています。AGENTS.mdを指す1行のCLAUDE.mdにすれば、両者が同じルールを共有できます。 - ドメインごとの発見ドキュメント。 ピン配列、プロトコル、クセは、消えてしまうチャット履歴ではなく
docs/に置きます。 - 共有証拠としてのログ。 xj-scannerはすべてのドライブをCSVとして
pc/logs/に書き込むため、どちらのエージェントも同じ実行データを分析できます。 - ステップごとの引き継ぎメモ。 何を試し、何が機能し、何が未検証か、次のコマンドは何か。
引き継ぎメモはこれくらい短くて構いません(値は説明用のもので、ジープのリポジトリからではありません):
## Handoff: SCI read of live sensor data
- Done: Nano bridge sketch flashed, DEMO mode passes on the laptop side
- Confirmed: cavities 2 (ground), 3, 4 measured with key ON
- Unverified: fuel trim scaling; reading looks high on idle
- Next: Codex decodes pc/logs/xj_2026-11-03.csv with both scaling formulas
- Needs a human: any actuator test or code erase
その他のフォーマットについては、コーディングエージェントの引き継ぎテンプレートや、コーディングエージェントを切り替えるときのコンテキスト維持のガイドをご覧ください。
人が結果を確認すべき場所
元に戻すのが難しいステップの前にだけ人を置き、それ以外には置きません。xj-scannerのルールは良いテンプレートです:
- 物理的な操作の前。 「12 Vのキャビティに何かを接続させてはならない」。人が先にすべてのキャビティを測定します。
- 破壊的なコマンドの前。 コードの消去は学習済み燃料データも消去するため、エージェントは尋ねて説明します。
- 診断を信じる前。 「診断を推測しないこと。データが示すことと示さないことを報告する」。
- 予想外の事態の後。 夜間走行のチャプターではツールが間違っていました。実世界のデータこそ、どのエージェントも省略できない検証です。
ソフトウェアチームでも同じルールが当てはまります。mainへのマージ、スキーマ移行、メール送信や課金が発生するものには人のゲートを設けます。それ以外はエージェント間で流して構いません。レビューがすでにボトルネックになっているなら、並列エージェントのためのレビュー設計をお読みください。
Sharklyで2エージェントの分担を運用する
ターミナルでは、この分担はあなたの頭の中にあります。どのタブがどのエージェントを動かしているか、誰があなたの対応を待っているか。Sharklyはそれをタスクの上に載せます。
Computerを接続すると、SharklyはそのComputer上のエージェントツールをClaude CodeやCodexなどのランタイムとして検出します。役割ごとにエージェントを作成します。次にCrewを組み立てます。リーダーエージェントに、調査役・構築役・レビュー役のエージェント、そして承認するPeopleを加えます。
タスクをCrewに割り当てると、Crewsのドキュメントのとおりリーダーが先に実行されます。リーダーはタスクとCrewの指示を読み、必要なエージェントメンバーをメンションします。メンバーは同じタスクに対して実行され、結果をリーダーのチャットに投稿します。リーダーがそれらを統合します。役割の説明がCrewの指示になります。レビュー役をいつ関与させるか、2つの試行をどうマージするか、いつ人が判断するか。
このパターンで重要な細部が2つあります。リポジトリ作業では、実行ごとに別のgit worktreeを使えるため、同じステップに挑む2つのエージェントが互いを上書きしません(タスク実行のドキュメント)。さらに、すべての実行にはタスクの実行ログ上の状態があり、ターミナルを開かなくても、どのエージェントが待機中・実行中・完了かを確認できます。
2エージェントCrewの代替案
他の選択肢もあり、状況によってはそちらが適しています:
- 1つのエージェントで2パス。 同じエージェントに構築させ、その後新しいセッションでレビューさせます。低コストですが、同じモデルは自分の盲点を繰り返しがちです。
- 2つのターミナルと1つの共有リポジトリ。 ジープのような週末プロジェクトなら機能します。タスクが複数になり、チームメイトが加わると追跡が困難になります。1つのコードベースでClaude CodeとCodexを併用する方法を参照してください。
- 別々のタスクで並列エージェント。 スループット向きで、互いの検証には向きません。2つのエージェントが同じファイルを編集すると起こることに注意しましょう。
まとめ
ジープのプロジェクトが機能したのは、知識がファイルに宿り、両方のエージェントが同じルールを読み、あらゆる危険な操作の前に人が立っていたからです。この3つの習慣を真似れば、2つのコーディングエージェントは、自信たっぷりな推測の2つの情報源になるのではなく、互いのチェック機能として働きます。
次のステップ:今週、難しいタスクを1つ選び、そのAGENTS.mdのルールと引き継ぎメモを書き、レビュー役エージェントと承認する人を含めたCrewとしてSharklyで実行してみてください。
FAQ
Claude CodeとCodexは同じプロジェクトで作業できる?
はい。どちらもリポジトリ内の指示ファイルを読みます。CodexはAGENTS.mdを、Claude CodeはCLAUDE.mdを読み、CLAUDE.mdはAGENTS.mdを参照できます。同時に同じファイルを編集しないよう、それぞれに別のworktreeか別のステップを与えましょう。
コーディングエージェントはどうコンテキストを共有する?
メモリではなく、ファイルとタスクの記録を通じて共有します。ルールはAGENTS.mdに、発見はdocsフォルダに、生データはログに、ステップごとの短い引き継ぎメモを添えます。
エージェントの作業を人が承認すべき場所は?
元に戻すのが難しいものの前です。ハードウェア操作、破壊的なコマンド、mainへのマージ、移行、メッセージ送信や課金が発生するもの。それ以外はエージェント間で流して構いません。
Claude CodeとCodexはジープのECUを自力でリバースエンジニアリングしたのか?
いいえ。配線、測定、運転は開発者が行い、リポジトリのルールでは危険なコマンドの前に本人の承認を要求しています。エージェントはコンピュータを読み、ドライブを記録し、プログラムをコピーし、その中でコードを実行したのです。
2つのコーディングエージェントを動かすにはプラットフォームが必要?
いいえ。1つのプロジェクトなら、2つのターミナルと共有リポジトリで足ります。複数のタスク、チームメイト、承認が同時に走り、「誰が何をしたか」の一元的な記録が必要になったときに、プラットフォームが効果を発揮し始めます。



