はじめに
AIコーディングで設計と実装を別々のエージェントに担当させたい場合、いくつか方法があります。
| 方法 | 特徴 |
|---|---|
| チャットアプリでコピペ | シンプルだが、人間が仲介する必要がある |
| サブエージェント | 連携は簡単だが、実行状況や操作方法は親エージェント側の仕組みに依存 |
| 別プロセスを起動 | 柔軟だが、プロセス管理や通信の仕組みが必要 |
| tmuxなどで複数セッション | 進捗が見えるが、エージェント間通信には工夫が必要 |
| ワークフローエンジン | 自動化しやすいが、構築の手間がかかる |
個人的には、設計と実装を分ける程度なら、複雑なオーケストレーションは必要ないと思っています。
今回はHerdrを使って、独立したAIエージェント同士を連携させる方法を紹介します。
Herdrとは
HerdrはAIコーディングエージェント向けのターミナルマルチプレクサです。
tmuxやZellijに近いツールですが、以下のような特徴があります。
- ゼロコンフィグ:エージェントの状態検知やセッション管理などが標準で利用できる
- マウス操作ファースト:Paneの分割、リサイズ、切り替えをマウスで操作できる
- エージェントの状態表示:作業中・入力待ち・完了などをサイドバーで確認できる
- エージェント間通信:CLIやSocket APIから別のPaneを操作できる
- セッションの永続化:接続を切ってもプロセスを維持できる
tmuxでも同じような構成は作れますが、プラグインやスクリプト、キーバインドなどの設定が必要になることがあります。
Herdrは初期状態でほとんどの機能が使えるので、導入が簡単です。
設計と実装を分ける
今回は次の構成にします。
Herdr
├── Pane 1: Claude Code(設計)
└── Pane 2: Codex(実装)
それぞれ独立したセッションで起動するため、コンテキストも分離されます。
1. Herdrをインストール
curl -fsSL https://herdr.dev/install.sh | sh
herdr
Paneを2つ用意して、それぞれでClaude CodeとCodexを起動します。
2. HerdrのSkillをインストール
Herdrにはエージェント間通信のための公式Skillが用意されています。
npx skills add herdrdev/herdr --skill herdr -g
このSkillによって、エージェントがHerdrのCLIを利用できるようになります。
具体的には、次の操作が可能です。
- Paneの一覧取得、作成
- 別Paneへのコマンド送信
- 別Paneの出力取得
- エージェントの状態確認、完了待機
通信自体はHerdrのCLI/Socket APIが担当します。Skillは、その使い方をエージェントに伝えるものです。
3. エージェントに役割を与える
設計担当のClaude Codeには、例えば次のように指示します。
あなたは設計担当です。
実装は別PaneのCodexに担当させてください。
HerdrのSkillを使って実装担当と通信し、
設計、実装依頼、レビューを行ってください。
実装担当には次のように指示します。
あなたは実装担当です。
設計担当からの指示に基づいて実装してください。
不明点はHerdrを使って設計担当に確認し、
実装とテストの結果を報告してください。
これで、次のような構成になります。
人間
│ 要求
▼
Claude Code(設計)
│
│ Herdr経由で実装依頼
▼
Codex(実装・テスト)
│
│ Herdr経由で結果を報告
▼
Claude Code(レビュー)
エージェント同士の通信部分を自分で実装しなくていいのがポイントです。
独立したセッションにするメリット
AnthropicのBuilding effective agentsでは、エージェントシステムの設計について、シンプルな構成から始め、必要な場合にのみ複雑さを追加することを推奨しています。
Herdrを使った今回の構成も、設計と実装を分離し、必要な通信だけを追加するというシンプルなものです。
独立したセッションにするメリットは、各エージェントがどんな動作をしているのか、そのまま見えることです。
サブエージェントの実行結果だけでなく、実際にどのファイルを読んでいるのか、どんなコマンドを実行しているのか、どこで止まっているのかを各ターミナルで確認できます。
また、Herdrではエージェントの状態もサイドバーに表示されます。
各セッションは人間からも操作できるため、必要なときだけ直接指示を出すこともできます。
エージェント間通信は自動化しつつ、実行過程は可視化しておくという構成です。
さらに、セッション単位でモデルやツールを変更できるため、設計はClaude Code、実装はCodexやOpenCodeといった使い分けもできます。
まとめ
Herdrを使うと、複数のAIコーディングエージェントを独立したセッションとして起動し、Skill経由で連携させることができます。
- 各エージェントの動作と進捗がそのまま見える
- 必要に応じて各セッションへ直接指示できる
- エージェント間通信を自作する必要がない
- tmuxのような細かい初期設定がほぼ不要
ハーネスエンジニアリングと書くと大げさですが、最初から複雑な仕組みを構築する必要はありません。
設計と実装を分ける程度であれば、このくらいの構成から始めるのがよいと思っています。