하네스 엔지니어링 백과사전
AI는 더 이상 단순히 “대답을 잘하는 도구”에 머물지 않습니다. 이제 AI는 문서를 읽고, 도구를 사용하고, 코드를 수정하고, 보고서를 작성하며, 실제 업무를 이어받아 수행하는 작업자가 되어가고 있습니다.
그런데 흥미로운 현상이 자주 벌어집니다. 데모에서는 놀라울 만큼 뛰어나던 AI가 실제 업무에 투입되는 순간 흔들리기 시작합니다. 중요한 정책을 놓치고, 앞선 맥락을 잊고, 테스트도 하지 않은 채 완료했다고 말하며, 때로는 위험한 행동까지 아무렇지 않게 시도합니다.
많은 사람은 이때 먼저 모델을 의심합니다.
“더 좋은 모델을 써야 할까?”
“프롬프트를 더 정교하게 써야 할까?”
“다른 AI 도구로 바꿔야 할까?”
하지만 이 책은 다른 질문에서 출발합니다.
정말 문제는 모델일까요?
아니면 모델이 일하는 환경일까요?
아무리 똑똑한 신입사원이라도 매뉴얼과 도구, 권한, 검토자, 업무 기록이 없다면 실수할 수밖에 없습니다. AI도 다르지 않습니다. 모델은 생각하는 엔진이지만, 실제 업무를 움직이는 것은 모델 alone이 아니라 모델이 일하는 환경입니다. 무엇을 보고, 어떤 도구를 쓰고, 어디서 멈추고, 어떻게 검증받고, 무엇을 기억하는지를 결정하는 체계가 필요합니다.
이 책은 그 환경을 하네스(Harness)라고 부릅니다.
하네스는 단순한 프롬프트 한 줄이 아닙니다. AI가 일하는 사무실이자 운영체제이며, 작업 규칙이자 안전벨트입니다. 문맥, 메모리, 도구, 권한, 검증, 기록, 사람의 승인까지 포함하는 AI 업무 환경 전체가 바로 하네스입니다.
이 책은 다소 어려울 수 있는 기술 개념을 일상적인 비유로 풀어냅니다. 컨텍스트 창은 책상 위에 펼쳐진 자료로, 메모리는 회의록과 서랍으로, 도구 호출은 손과 발로, 권한은 출입카드와 공항 보안검색대로, 하네스는 운영체제이자 사무실 전체로 설명합니다. 그래서 개발자가 아니어도 충분히 읽을 수 있습니다. 그러나 내용은 결코 가볍지 않습니다.
OpenAI, Claude Code, Codex, Cursor, Antigravity, MCP, Agent Skills, 평가 하네스, 장시간 에이전트, Subagent와 Agent Teams, 메모리 소유권, 하네스 두께, 안전과 운영까지, AI 에이전트를 실제 업무에 적용하기 위해 꼭 알아야 할 핵심을 한 권에 담았습니다. 각 장의 끝에는 가족 여행 준비, 이사 체크리스트, 주간 식단, 집안 도구 정리처럼 익숙한 생활 주제를 바탕으로 작은 하네스를 직접 만들어보는 실습도 담았습니다. 부록에서는 AI 메모리를 가족 기록장처럼 관리하는 법과 Subagent와 Agent Teams를 구분하는 방법도 따로 정리했습니다. 책의 마지막에는 하네스 엔지니어링의 기원과 교육 설계 인사이트를 한눈에 정리한 종합 보고서도 제공합니다.
이 책을 읽고 나면 더 이상 이렇게 묻지 않게 될 것입니다.
“어떤 모델이 가장 좋은가?”
대신 이런 질문을 하게 될 것입니다.
“이 모델이 일하는 환경은 제대로 설계되어 있는가?”
“AI는 필요한 문서를 충분히 보고 있는가?”
“도구를 안전하게 사용하고 있는가?”
“결과는 검증되고 있는가?”
“다음 세션에도 기억은 이어지는가?”
“사람은 어디에서 개입해야 하는가?”
이제 AI를 잘 쓰는 사람은 단지 질문을 잘 쓰는 사람이 아닙니다. AI가 제대로 일할 수 있는 환경을 설계하는 사람입니다.
이 책은 바로 그 전환을 위한 안내서입니다.
모델은 엔진입니다. 하네스는 그 엔진이 실제 길 위를 달릴 수 있게 만드는 차체이자 핸들이고, 브레이크이며, 계기판이고, 안전벨트입니다. 좋은 AI 에이전트는 더 똑똑한 모델만으로 만들어지지 않습니다. 더 잘 설계된 환경에서 탄생합니다.
이 책의 한 문장:
좋은 AI 활용은 좋은 질문에서 시작하지만, 오래가는 AI 시스템은 좋은 하네스에서 완성된다.