platanu***
2026-06-27

스스로 일하는 에이전트 팀을 설계하고 운영하는 방법인 하네스 엔지니어링을 체계적으로 정리한 최초의 실전서
한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다.
AI가 헛다리를 짚으면 우리는 으레 모델을 탓하거나 더 좋은 버전을 기다리게 됩니다. 그런데 저자는 모델은 그대로 두고 주변 환경만 바꾼 실험들을 나란히 보여줍니다. 가중치는 손도 대지 않았는데 성능이 세대 교체급으로 뛰더군요. 그러나 병목은 능력이 아니라 구조고, 그러니 답은 모델 안이 아니라 바깥에 있다는 이야기를 책을 통해 저자가 전달 합니다.
왜 혼자서는 어려울까요. 단일 에이전트는 계획하고 코딩하고 검증하고 스스로 고치는 일을 같은 모델과 같은 가정으로 한 박스 안에서 처리합니다. 그러다 보니 계획에서 놓친 가정을 검증에서도 똑같이 지나치곤 합니다. 자기가 쓴 글을 자기가 교정하고, 혼자 쓴 PR을 혼자 머지하는 구조인 셈이지요. 그래서 저자는 '하네스'를 꺼냅니다. 모델 가중치는 건드리지 않고 그 주변의 권한과 도구, 검증, 상태, 관측을 결정론으로 설계하는 일입니다. 프롬프트가 말로 설득한다면 하네스는 구조로 강제한다는 대비가 글 전체를 관통합니다.
핵심은 역할을 셋으로 나눈다는 데 있습니다. 에이전트는 '누가', 스킬은 '어떻게', 오케스트레이터는 '언제 누구와'를 맡습니다. 저자는 에이전트 정의를 설정이 아니라 역할 계약서라고 부릅니다. 파일에 적히지 않으면 그 역할은 존재하지 않는다는 원칙이라, 검토자에게서 수정 도구를 빼두면 잘못 해석하더라도 손을 댈 수 없습니다. 여럿이 모이는 대목에서는, 리더가 모든 말을 중계하는 우체국이 되는 순간 병렬이 조용히 순차로 주저앉는다는 경고가 기억에 남습니다. 리더는 중계자에서 통합자이자 관측자로 물러앉고, 팀원은 서로 직접 대화하는 동료로 올라섭니다.
뒤로 가면 실전 사례가 기다립니다. 에어비앤비가 테스트 파일 약 3,500개를 옮기는 데, 손으로 하면 18개월 걸릴 일을 6주 만에 끝내고 97%를 자동화한 이야기입니다. 비결은 더 좋은 프롬프트가 아니라 에러와 파일 상태를 다시 모델에 되먹이는 피드백 루프, 그리고 변환에서 검증, 재시도로 이어지는 상태 기계였습니다. AI 협업이 신비한 새 영역이 아니라 Saga나 work-stealing 같은 분산 시스템 위에 서 있다는 시각이 글 전체를 든든하게 받쳐 줍니다.
파인튜닝이나 모델 내부를 기대하셨다면, 저자가 처음부터 그 영역을 바깥으로 밀어 두었으니 방향이 조금 어긋날지도 모릅니다. 반대로 단일 에이전트 프롬프팅에서 좀처럼 나아가지 못해 답답하셨던 분, 에이전트를 써 보긴 했지만 왜 협업이 잘 안 되는지 궁금했던 분이라면 자리가 잘 맞습니다. git과 마크다운만 다룰 줄 알면 빈 디렉터리에서 차근차근 따라가도록 짜여 있으니, 눈으로만 읽지 마시고 직접 파일을 만들어 보시길 권합니다. 도구를 동료로 바꾸는 일은 결국 그 손끝에서 시작되니까요.
한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다.