정의
AI 에이전트가 특정 작업을 수행할 때 발생하는 오류를 체계적으로 발견하고 재발을 방지하기 위해 설계된 검증·제어 체계. 단순 프롬프트 수준을 넘어 코드 레벨의 제약, 자동 검증 파이프라인, 도메인 특화 언어(예: Alloy) 등을 활용하여 에이전트의 행동을 조이고(harness) 안정성을 확보하는 엔지니어링 방법론이다.
핵심 속성
- 목적: 에이전트의 실수를 반복하지 않게 방지하고, 좋은 행동을 스스로 검증할 수 있는 환경 조성.
- 스캐폴딩과의 차이: 스캐폴딩은 학습자가 스스로 올라갈 수 있도록 도움 계단(비계)을 제공하는 반면, 하네스는 말의 안장이나 마구처럼 행동을 직접 조이고 검증하는 데 초점.
- 구성 요소:
- 프롬프팅 레벨의 제어 (예: CoT 후속 질문 제한)
- 프로그래밍 도구를 통한 검증 (예: 단위 테스트, 형식 검증)
- 도메인 특화 검증 언어 (예: Alloy를 활용한 end-to-end 테스트와 자연어 설명이 결합된 실행 가능 명세서)
- 출처 개념: Mitchell Hashimoto가 자신의 AI 도입 블로그 시리즈에서 “하네스를 설계하라” 단계로 제시. 이후 Claude Code, Codex 등 에이전트 도구 전체를 가리키는 일반 명사로 확장.
- 한계: TDD가 어려운 그래픽스/3D 분야나 시각적 품질 평가가 필요한 작업에서는 하네스 적용이 까다로움.
관계
- 20260607-ddalgguk-human-intuition-kr — 하네스가 해결하지 못하는 경계 영역에서 인간의 직관과 가설 실험이 중요해짐 (상위개념: 에이전트 협업 패턴)
- 20260607-ai-delegation-domain-expansion-kr — 하네스 위임이 인간 스킬 퇴화를 유발할 수 있지만, 도메인 확장을 통해 보완 (대조: 위임 vs 스킬 형성)
- 20260607-token-brownout-kr — 하네스에 대한 과도한 의존이 브라운아웃 상황에서 위기를 초래할 수 있음 (연장: 의존성 리스크)
인용
“에이전트가 실수를 하는 것을 발견할 때마다 시간을 들여 그 실수를 다시는 하지 않게 만드는 해결책을 설계한다. 엔지니어링한다는 개념으로 하네스 엔지니어링해서 크게 두 가지를 얘기했는데, 프롬프팅이라는 것하고 실제 프로그래밍 도구를 통해서 에이전트가 나쁜 짓을 하는 거를 볼 때마다 다시는 그 짓을 못하게 하는 쪽으로 노력을 하고 있고, 에이전트가 좋은 거를 하고 있는지를 스스로 검증할 수 있게 하도록 어떤 하네스를 제공하고 있다.” — 최승준
출처
- 📎 클리핑: 20260613-ep89-ko-transcript