📅 2026年04月08日 20:24
How to Supervise AI Coding Agents Without Losing Your Mind - AIコーディングエージェントをどう監督するか(気が狂わないために)
複数のAIエージェントを走らせても混乱しない、現場で使える3つの監督ルール
要約
並列で動くAIコーディングエージェントは「ファイル競合」「品質ゲート不在」「運用コスト増」で崩壊する。解決は既存ツールで可能:作業分離(git worktrees)、テストゲート、タスクの明確な割当。
この記事を読むべき理由
日本の開発現場でも、AI支援開発が進む中で「複数エージェント化」は現実的な選択肢。失敗パターンと簡単に導入できる対処法を知っておけば、手戻りやデグレを減らし効率化できる。
詳細解説
問題点
- ファイル競合:同じファイルを書き換えて上書きされる
- 品質ゲート欠如:生成が終わった=完了、ではない(テスト通らない)
- 監督工数:人がディスパッチャーになってしまう
提案する3つの対策
- 作業を完全に分離する(git worktrees)
- 各エージェントに独立したワークツリーとブランチを割り当て、並列編集の衝突を回避する。
- 例:
# bash git worktree add .worktrees/agent-1 -b agent-1/task-1 git worktree add .worktrees/agent-2 -b agent-2/task-2
- 成果物はテストを通すまで受け入れない(テストゲート)
- 各エージェントが「完了」を主張したら、そのワークツリーで既存のテストスイートを実行。0(成功)ならマージ候補、失敗ならフィードバックを返して修正させる。
# bash (例) cd .worktrees/agent-1 cargo test # または npm test / pytest echo $? # 0 = OK
- 各エージェントが「完了」を主張したら、そのワークツリーで既存のテストスイートを実行。0(成功)ならマージ候補、失敗ならフィードバックを返して修正させる。
- タスク割当を明確にする(Markdownカンバン等で一元管理)
- 1タスク=1エージェント、状態はTodo→In Progress→Doneで可視化。重複作業や優先度逆転を防ぐ。
```markdown
Todo
- [ ] Add JWT authentication (#12)
- 1タスク=1エージェント、状態はTodo→In Progress→Doneで可視化。重複作業や優先度逆転を防ぐ。
```markdown
In Progress
- Refactor database layer (#11) — agent-1
Done
- Fix login redirect (#10) — agent-2 ```
運用上の注意
- 並列数は実用的には3〜5程度。増やすほどマージ/レビューコストが跳ね上がる。
- テストカバレッジが低いとエージェントの「見た目は正しい」コードを見落とすため、まずテスト整備が重要。
- セキュリティ(権限や外部アクセス)やデータ漏洩は別途ガバナンスが必要。
実践ポイント
- 今あるリポジトリでまず1エージェント→2エージェントと段階的に導入して、worktreeパターンとテストゲートを試す。
- Markdownの簡易カンバンをリポジトリに置き、エージェントがそれを読み書きするルールを作る(可視化と排他のため)。
- CI(GitHub Actions/GitLab CI)に「マージ前テスト」を仕込んで、人が見る前に自動で不合格を弾く流れを作る。
- 日本企業向けには、コードレビュー・承認フローや社内ガイドラインへの落とし込みを早めに行うこと(監査・履歴保持の観点から重要)。
以上の3つの制約(隔離・テストゲート・構造化された割当)を運用に取り入れれば、複数エージェントは「混乱の元」ではなく「並列戦力」になります。