<하네스 엔지니어링 with 클로드 코드> 후기

 "한빛미디어 서평단 <나는 리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다."

 

https://www.yes24.com/product/goods/189818905

하네스 엔지니어링 with 클로드 코드 | 황민호 | 한빛미디어 - 예스24

 

 

요즘 클로드코드에 대해 의존성이 많이 올라가면서 다양한 AI 서적들이 출간되고 있고, 그 중에서 요즘 더 뜨고 있는 하네스 엔지니어링에 대해 클로드코드와 같이 작성되 있는 이 책을 보게 되었다.

책 목차들 중점으로 내 생각을 적어보자면,

 

1부 . 하네스란 무엇인가

Chapter 01. 왜 하네스인가

AI 성능보다 AI가 일하는 환경을 설계하는 것이 더 중요하다는 점을 이해할 수 있었다.

Chapter 02. 30분 Quick Start

긴 설명보다 바로 실습을 통해 하네스의 개념을 빠르게 체험할 수 있어서 좋았다.

---

2부 . 하네스 구성하기 - 에이전트·스킬·오케스트레이터

Chapter 03. 에이전트·스킬·오케스트레이터의 책임 분리

객체지향의 역할 분리처럼 AI도 역할을 나누는 것이 유지보수에 큰 도움이 된다는 점이 인상적이었다.

Chapter 04. 에이전트를 정의한다는 것

좋은 에이전트는 프롬프트를 잘 쓰는 것이 아니라 명확한 규칙과 책임을 갖는 것이라는 점을 배웠다.

Chapter 05. 스킬 설계의 기술

스킬 하나도 재사용성과 호출 방식을 고려해 설계해야 한다는 점이 실무적이었다.

Chapter 06. 오케스트레이터

여러 AI를 협업시키는 구조를 보며 멀티스레드나 분산 시스템을 설계하는 느낌이 들었다.

---

3부. 하네스 스킬로 구성하기

Chapter 07. 메타 하네스 스킬과 6단계 파이프라인

AI가 AI를 만드는 구조까지 확장되는 과정을 보며 자동화의 가능성을 느꼈다.

Chapter 08. 여섯 가지 아키텍처 패턴

프로젝트 규모에 따라 다양한 하네스 구조를 선택할 수 있다는 점이 실무에 도움이 될 것 같았다.

Chapter 09. 팀 / 서브에이전트 / 하이브리드

하나의 AI에게 모든 일을 맡기기보다, 역할별 AI를 조합하는 것이 더 효율적이라는 점이 흥미로웠다.

Chapter 10. 하네스 등록과 진화

처음부터 완벽한 구조를 만드는 것이 아니라, 프로젝트에 맞게 계속 개선해 나가는 과정이 중요하다는 점을 배울 수 있었다.

---

4부. 실전 사례

Chapter 11. 코드 리뷰 팀

혼자 검토하는 AI보다 역할을 나눈 AI 팀이 더 신뢰할 수 있다는 점이 인상 깊었다.

Chapter 12. 풀스택 개발 팀

프론트엔드와 백엔드를 각각 담당하는 AI 협업 방식이 실제 개발 환경과 비슷해서 이해하기 쉬웠다.

Chapter 13. 레거시 마이그레이션 팀

가장 복잡한 작업도 단계별로 역할을 나누면 AI가 안정적으로 수행할 수 있다는 점을 보여주었다.

Chapter 14. 디버깅 팀 / RCA 팀

디버깅 과정에서도 여러 AI가 서로 검증하는 구조가 오류를 줄이는 데 효과적이라는 점을 알 수 있었다.

 

전체적으로는 "프롬프트를 잘 쓰는 법"이 아니라 "AI가 스스로 협업하도록 시스템을 설계하는 법"을 설명하는 책이라는 점이 가장 기억에 남았다.

 

 

이 책에서 가장 인상 깊었던 점은 AI 모델 자체보다 모델을 둘러싼 구조(Harness)가 결과를 결정한다는 관점이다.

 

지금까지는 더 좋은 모델이나 더 좋은 프롬프트에 관심이 집중되었지만, 저자는 에이전트의 역할을 분리하고, 스킬을 정의하며, 오케스트레이터를 통해 여러 AI가 협업하도록 만드는 것이 더 중요한 요소라고 설명한다.

 

특히 에이전트, 스킬, 오케스트레이터라는 세 가지 핵심 요소를 중심으로 시스템을 설계하는 방식은 소프트웨어 아키텍처를 공부해본 개발자라면 자연스럽게 이해할 수 있도록 구성되어 있다. 단순한 이론 설명에 그치지 않고 코드 리뷰, 디버깅, 레거시 마이그레이션, 풀스택 개발 등 실제 업무에서 활용 가능한 사례를 단계별로 다루고 있다는 점도 장점이다.

 

또한 Git과 Markdown만 사용할 수 있다면 실습을 따라갈 수 있도록 구성되어 있어 AI나 머신러닝을 깊게 공부하지 않은 개발자도 접근하기 쉽다는 점이다.. 모델 내부를 분석하기보다는 개발 생산성을 높이는 방법에 초점을 맞추고 있기 때문에 실무 활용도가 높아 보였다.

 

이 책은 프롬프트 엔지니어링을 넘어 AI 에이전트 시대를 준비하는 개발자에게 좋은 출발점이 될 수 있다. 특히 Claude Code, Cursor 같은 AI 코딩 도구를 이미 사용하고 있지만 "AI가 혼자 일하는 데 한계를 느꼈다"는 사람이라면 많은 아이디어를 얻을 수 있을 것이다.

 

다만 AI 에이전트라는 개념 자체가 아직 빠르게 발전하는 분야인 만큼, 책의 내용을 그대로 적용하기보다는 자신의 프로젝트에 맞게 응용하고 발전시키는 관점으로 읽는 것이 좋다고 생각한다.

 

전체적으로 『하네스 엔지니어링 with 클로드 코드』는 AI 활용법을 넘어 AI 협업 시스템을 설계하는 사고방식을 소개하는 책이다. 앞으로 AI 기반 개발 환경이 더욱 보편화될 것을 고려하면, 단순한 사용법을 익히는 수준을 넘어 AI 팀을 설계하는 방법을 배우고 싶은 개발자에게 충분히 읽어볼 가치가 있는 책이라고 생각한다.