제목: 하네스 핸드북: 진화하는 에이전트 하네스를 가독성 높고, 탐색하기 쉬우며, 편집 가능한 형태로 만들기(1)

제목: 하네스 핸드북: 진화하는 에이전트 하네스를 가독성 높고, 탐색하기 쉬우며, 편집 가능한 형태로 만들기(2)

들어가며

OpenAI의 엔지니어링 팀이 5개월 동안 약 100만 줄의 프로덕션 코드를 만들었다. 놀라운 건 규모가 아니다. 수동으로 작성한 소스코드가 단 한 줄도 없다는 점이다.

소수의 엔지니어가 Codex 에이전트에게 작업을 지시하고, PR을 검토하고, CI 파이프라인을 관리했을 뿐이다. 애플리케이션 로직, 문서, CI 설정, 모니터링 설정까지 전부 AI 에이전트가 만들었다.

이 실험에서 OpenAI가 얻은 가장 중요한 교훈은 이것이다:

"어려운 건 AI 에이전트가 아니다. 에이전트가 일할 **환경(harness)**이 어렵다."

이 환경을 설계하는 분야가 바로 **하네스 엔지니어링(Harness Engineering)**이다.

하네스 엔지니어링이란?

비유로 이해하기

"하네스(harness)"는 말에게 씌우는 마구(馬具)다. 말이 아무리 빠르고 강해도, 고삐 없이는 짐을 나를 수 없고 밭을 갈 수도 없다. 방향을 잡아주고, 힘을 전달하고, 안전하게 제어하는 것이 마구의 역할이다.

AI 에이전트도 마찬가지다.

정의

하네스 엔지니어링: AI 에이전트가 대규모로 안정적이고 일관된 결과물을 만들어내도록 환경, 제약, 피드백 루프를 설계하는 엔지니어링 분야

핵심은 에이전트를 바꾸는 것이 아니라 환경을 바꾸는 것이다.

왜 지금 필요한가?

2025년의 전형적인 실패 패턴