AIエージェントのためのクリーンアーキテクチャ：エンジニアリングハーネスの設計

Habrの記事は、OpenAIの「ハーネスエンジニアリング」のコンセプトに基づき、コーディングエージェント用のエンジニアリングハーネスを設計する方法について論じています。ハーネスは、人間の意図を、境界が定められ、再現可能で、検証済みの製品変更に変換する、リポジトリローカルなエンジニアリングシステムと定義されます。これは、オーケストレーション（プロセス管理）、セマンティック（製品モデルの提供）、検証（エビデンスと独立したレビューの確保）という3つの層で構成されています。この記事は、ロバート・マーティンのクリーンアーキテクチャの原則をこのハーネスに適用し、アーキテクチャの目標がシステムの寿命全体にわたる人的労力を最小限に抑えることであると強調しています。重要な指標は、信頼性の高い変更の総コストであり、速度やトークンコストだけではありません。ハーネスには独自のポリシー（権限、ライフサイクル、許可）と詳細（モデル、Git、CI）があり、依存関係は内側に向く必要があります。この記事では、トップレベルの構造が変更ライフサイクルを反映し、メカニズムを反映しない「スクリーミングアーキテクチャ」を提案しています。実際的なテストは、詳細がユースケースの契約に影響を与えずに置き換え可能かどうかです。