AI 에이전트를 위한 클린 아키텍처: 엔지니어링 하네스 설계

Habr에 게재된 이 글은 OpenAI가 제시한 '하니스 엔지니어링(Harness engineering)' 개념을 바탕으로, 코딩 에이전트를 위한 엔지니어링 하니스를 어떻게 설계할 것인지를 다룬다. 여기서 하니스란 인간의 의도를 제한적이고 재현 가능하며 검증된 제품 변경으로 전환하는, 리포지토리 단위의 엔지니어링 시스템으로 정의된다. 이 하니스는 세 가지 계층으로 구성된다: 프로세스를 관리하는 오케스트레이션 계층, 제품 모델을 제공하는 시맨틱 계층, 그리고 근거와 독립적인 검토를 보장하는 검증 계층이다. 이 글은 Robert Martin의 클린 아키텍처(Clean Architecture) 원칙을 이 하니스에 적용하면서, 아키텍처의 목표는 시스템의 생애 전반에 걸쳐 인간의 노력을 최소화하는 데 있다고 강조한다. 여기서 핵심 지표는 속도나 토큰 비용이 아니라, 신뢰할 수 있는 변경 하나를 만드는 데 드는 총비용이다. 하니스는 자체적인 정책(권한, 생애주기, 퍼미션)과 세부 사항(모델, Git, CI)을 가지며, 의존성은 항상 안쪽 방향, 즉 정책을 향해야 한다. 이 글은 최상위 구조가 메커니즘이 아니라 변경의 생애주기를 반영하는 '스크리밍 아키텍처(Screaming Architecture)'를 제안한다. 실용적인 검증 방법은 세부 요소를 교체했을 때 유스케이스 계약(use case contract)이 영향을 받는지 여부를 확인하는 것이다.