AIエージェント開発チームが「憲法」を設計した経緯:3層ガバナンス構造の記録
本記事は、安全な文字起こしサービス(SaaS)の開発に携わるAIエージェント開発チームが、複数のClaude Codeエージェント(lead, dev, PO, webmaster, qa, claude-code-guideなど)を協働させる過程で直面した技術的・組織的な「衝突」から生まれたガバナンス体制の構築記録である。このチームは、役割の異なる多数のエージェントが単一のリポジトリを共有する環境で開発を進めている。
当初は場当たり的な対応に終始したが、「誰が何を更新できるか」「どのルールが最新か」といった問題が連続した結果、ガバナンス(規律)が3層構造として整理された。この構造は以下の通りである:上層の「AI_WORKFLOW.md」(憲法本体)、中層の「CONSTITUTION.md」(運用規範)、下層の`state.json`/`HANDOFF.md`(ランタイム状態・申し送り)。
ガバナンス設計の具体的な経緯として、以下の3つの衝突が挙げられている。第一に、複数のエージェントによる`HANDOFF.md`の書き込み競合が発生し、責任の所在を明確化するため、編集権限を`lead`専任に絞り込んだ。第二に、レビュー権限が`lead`に一極集中することでボトルネックが生じたため、「憲法本体」のみを`lead`専任としつつ、条文更新などの権限は分散させた。第三に、Issueレビューのトークンコスト高騰(78件のIssue読み込みで30K近く)という問題に対し、`lead-review`ラベルを新設し、監査対象を絞り込むことで効率化を図った。
このプロセスを通じて、「規律」は抽象的な設計ではなく、実際に起きた「摩擦や事故への対応」として積み重なって構築されたことが強調されている。最終的に、AIエージェント自身がルール作成の主体となっており、これは人間による直感的な設計よりも効果的であるという考察も述べられている。
背景
本ニュースは、複数の自律型AIエージェント(LLMベース)を協働させてソフトウェア開発を行う「AIネイティブな開発プロセス」の具体的な事例と課題解決の記録である。従来の人間中心の開発フローとは異なり、AI間の権限や情報の競合がガバナンス設計の根拠となっている。
重要用語解説
- エージェント: 自律的にタスクを実行するAIプログラムのこと。本記事では、役割(lead, devなど)を持たせられ、リポジトリを操作する複数のClaude Code AIを指す。
- ガバナンス: 組織やシステムにおける統治機構、ルール作り全般を指す。ここでは、AIエージェント間の権限配分や行動規範の設計に用いられている。
- 競合源泉 (competing source of truth): 同じ情報(真実)が複数の場所や形式で存在し、どれが正しいのか判断できなくなる状態。システム設計における重大な問題点である。
今後の影響
AIエージェントによる開発プロセスは高度化しており、本記事のような「ガバナンスの記録」自体が、今後の大規模AIシステムの信頼性確保のための重要な知見となる。権限とルールの明確化(3層構造)は、AIシステムの実用的な運用における必須要件である。