하네스
엔지니어링

하네스 = 에이전트를 감싸는 실행 환경

에이전트는 LLM + 도구 루프다. 그 루프를 돌리는 게 하네스다.

하네스는 모델을 감싸 실행을 조율하는 바깥 환경이다.
도구를 쥐여주고, 루프를 돌리고, 결과를 검증하고, 컨텍스트를 채운다.

모델만 떼어놓으면 한 번 답하고 끝나는 텍스트 생성기일 뿐이다.
하네스가 그걸 일을 끝까지 끌고 가는 에이전트로 만든다.

그래서 같은 모델이어도 하네스가 다르면 결과가 달라진다.
하네스 엔지니어링은 모델 바깥을 설계하는 일이다.

무엇을 감싸나, 도구·검증·메모리·루프

하네스가 책임지는 건 크게 네 겹이다.

도구는 모델이 바깥 세계에 손대는 통로다. 파일 읽기와 쓰기, 명령 실행이 여기에 들어간다.
검증은 결과가 맞는지 확인하는 장치다. 테스트와 린트, 빌드가 여기에 해당한다.

메모리는 무엇을 컨텍스트 창에 채울지 고른다. 기억할 것과 버릴 것을 가른다.
루프 제어는 사이클을 몇 번 돌고 언제 멈출지 정한다.

가운데 코어는 모델 그대로다.
네 겹 중 하나만 빠져도 에이전트는 절름발이가 된다.

루프를 돌리고 재시도를 시킨다

하네스의 심장은 루프다. 한 방에 끝내는 게 아니라 돌려가며 고친다.

모델이 생각하고, 도구를 호출하고, 결과를 받아 다시 생각한다.
이 사이클을 하네스가 돌린다. 검증이 실패하면 그대로 끝내지 않고 루프로 되돌려보낸다.

재시도와 중단 조건도 하네스 몫이다.
몇 번까지 다시 시도할지, 무한 루프를 어떻게 끊을지, 언제 사람에게 넘길지를 정한다.

모델은 “다시 해라”를 스스로 못 챙긴다.
그 판단을 바깥에서 대신 해주는 게 하네스의 루프 제어다.

하네스가 결과를 좌우한다

핵심은 이렇다. 모델이 같아도 하네스가 좋으면 결과가 좋아진다.

빈약한 하네스는 도구를 안 주고, 검증 없이 한 번에 답하고, 컨텍스트를 대충 채운다.
그럼 똑똑한 모델도 헛다리를 짚고 끝난다.

좋은 하네스는 알맞은 도구를 쥐여주고, 결과를 테스트로 검증하고, 실패하면 재시도시키고, 필요한 맥락만 골라 채운다.
그럼 같은 모델이 일을 끝까지 끌고 간다.

그래서 Claude Code, Codex 같은 코딩 에이전트의 실력은 모델 절반에 하네스 절반이다.
바이브코더가 손볼 수 있는 쪽이 바로 하네스다.

정리, 모델 바깥을 설계한다

하네스 엔지니어링은 모델을 더 똑똑하게 만드는 일이 아니다. 모델 바깥을 잘 짜는 일이다.

도구와 루프, 검증과 재시도, 컨텍스트 관리. 이게 전부 하네스의 영역이다.
모델 안쪽은 못 건드려도 바깥쪽은 우리가 설계한다.

다음 강에선 이 하네스 안에서 작업을 쪼개 여러 서브에이전트로 팬아웃하는 멀티 에이전트를 다룬다.