コードの清潔さはコーディングエージェントに影響するか?制御された最小ペアスタディ
Does Code Cleanliness Affect Coding Agents?
本研究では、自律型コーディングエージェントの評価において、コードの構造的・様式的な品質(コードの清潔さ)がエージェントのナビゲーションおよび修正能力に影響を与えるかを調査した。エージェントの能力からコードの清潔さの影響を分離するため、アーキテクチャ、依存関係、外部の動作は一致するが、静的解析ルールの違反や認知的複雑さが異なるリポジトリのペア(最小ペア)を用いた評価プロトコルを導入した。33のタスクでClaude Codeを用いた660回の試行の結果、コードの清潔さはエージェントのタスク完了率に影響を与えなかった。しかし、エージェントの運用フットプリントには substantial な変化が見られ、よりクリーンなコードで作業する場合、トークン使用量が7~8%減少し、ファイル再訪率が34%減少した。これらの結果は、保守性の原則がAI駆動開発時代においても依然として重要であり、コーディングエージェントの計算コストとナビゲーション効率に影響を与えることを示唆している。
- コードの清潔さはAIコーディングエージェント(Claude Code)のタスク完了率に有意な影響を与えなかった(33タスク・660試行)
- クリーンなコードで作業する場合、トークン使用量が7-8%減少し、ファイル再訪率が34%減少した
本研究は、コードの清潔さ(静的解析ルールの遵守・認知的複雑さの低さ)がAIコーディングエージェントのタスク完了率には影響しないものの、トークン使用量(7-8%減)やファイル再訪率(34%減)といった運用コストに有意な差をもたらすことを示した点が重要。この結果は、AIエージェントの効率的な運用を考える上で、コード品質の維持が単なるベストプラクティスではなく、クラウドコストやレイテンシに直結する投資判断材料になることを示唆する。特にClaude Codeのようなエージェント型コーディングツールを活用する企業にとって、保守的なコードベース管理方針がAI時代においても経済的合理性を持つというエビデンスとして価値がある。