한빛미디어

AI 코딩 도구를 처음 쓸 때는 대부분 모델 성능에 관심이 간다.

“어떤 모델이 더 똑똑한가”, “Claude가 좋은가, GPT가 좋은가”, “Cursor가 좋은가, Claude Code가 좋은가” 같은 질문을 먼저 하게 된다.

나도 처음에는 비슷했다.

좋은 모델을 쓰면 개발 생산성이 자연스럽게 올라갈 것이라고 생각했다. 그런데 실제 업무에 적용하려고 하면 생각보다 빨리 한계가 보인다.

AI가 코드를 잘 짜는 순간은 분명 있다.

하지만 문제는 항상 잘 짜는가, 팀의 기준에 맞게 짜는가, 자기 실수를 스스로 발견하는가, 운영 환경에서 믿고 맡길 수 있는가다.

이 책은 그 지점을 정확히 건드린다.

핵심 메시지는 단순하다.

모델은 엔진이고, 하네스는 작동 조건이다.

좋은 엔진만 있다고 차가 안전하게 달리는 것은 아니다.

어떤 도로에서 달리는지, 브레이크는 제대로 동작하는지, 계기판은 있는지, 사고가 났을 때 멈출 수 있는지가 함께 중요하다. AI도 마찬가지다. 모델 자체보다 모델 주변의 실행 구조가 결과를 크게 좌우한다.

이 책에서 말하는 하네스는 단순한 프롬프트 모음이 아니다.

프롬프트, 컨텍스트, 에이전트 역할, 스킬, 도구 권한, 오케스트레이션, 검증 루프까지 포함한 AI 에이전트 실행 구조에 가깝다.

개인적으로 이 부분이 가장 좋았다.

하네스 엔지니어링 ⊇ 컨텍스트 엔지니어링 ⊇ 프롬프트 엔지니어링

요즘 AI를 잘 쓴다고 하면 프롬프트를 잘 쓰는 것으로만 이해하는 경우가 많다. 하지만 실무에서는 프롬프트보다 더 중요한 것이 있다.

어떤 파일을 읽게 할 것인지, 어떤 명령은 실행하지 못하게 할 것인지, 결과를 누가 검토할 것인지, 실패했을 때 어떻게 되돌릴 것인지가 훨씬 중요하다.

특히 시니어 개발자 입장에서 보면 이 책은 “AI를 어떻게 잘 써볼까?”보다는 “AI를 팀의 개발 프로세스 안에 어떻게 안전하게 넣을 것인가?”에 더 가깝다.

책은 크게 네 부분으로 구성되어 있다.

Part 1에서는 왜 하네스가 필요한지 설명한다. 단일 에이전트가 자기 실수를 제대로 보지 못하는 문제, 모델만 바꿔서는 해결되지 않는 구조적 한계를 다룬다. 여기서부터 책의 방향이 분명해진다. 이 책은 AI 도구 사용법만 알려주는 책이 아니라, AI를 업무 시스템으로 다루는 책이다.

Part 2에서는 에이전트, 스킬, 오케스트레이터를 나눠 설명한다.

에이전트는 역할을 가진 작업자이고, 스킬은 특정 작업을 수행하기 위한 능력이며, 오케스트레이터는 여러 에이전트가 어떻게 협업할지 조율하는 구조다.

특히 스킬 설계 부분이 실용적이었다.

스킬은 본문을 길게 쓴다고 잘 호출되는 것이 아니라, deion 한 줄이 중요하다는 설명이 인상적이었다. AI에게 “필요하면 이걸 써”라고 알려주는 방식도 결국 설계의 영역이라는 점을 다시 생각하게 했다.

Part 3에서는 하네스를 더 체계적으로 구성하는 방법을 다룬다.

파이프라인, 팬아웃·팬인, 전문가 풀, 생성-검증, 감독자, 계층적 위임 같은 아키텍처 패턴이 나온다. 이 부분은 단순히 Claude Code를 쓰는 방법을 넘어서, 에이전트 기반 시스템을 어떻게 설계할지 고민하는 사람에게 도움이 된다.

Part 4는 실전 사례 중심이다.

코드 리뷰 자동화, 풀스택 기능 구현, 레거시 마이그레이션, 디버깅/RCA 같은 시나리오가 나온다. 실제 개발팀에서 AI를 도입할 때 가장 먼저 적용해볼 만한 영역들이라 현실감이 있었다.

다만 아쉬운 점도 있다.

완전 초보자를 위한 책은 아니다. Claude Code나 AI 코딩 도구를 한 번도 써보지 않은 사람이 읽으면 초반부터 낯설 수 있다. 설치나 환경 설정도 아주 친절한 입문서 느낌은 아니다. 어느 정도 개발 경험이 있고, AI 도구를 조금이라도 써본 사람이 읽어야 책의 의도를 제대로 이해할 수 있을 것 같다.

또한 중간중간 에이전트, 팀원, 서브에이전트 같은 용어가 비슷하게 섞여 나오는 부분은 조금 헷갈릴 수 있다. 개념 자체가 아직 업계에서 완전히 표준화된 영역은 아니다 보니 어쩔 수 없는 부분도 있지만, 처음 접하는 독자라면 한 번에 매끄럽게 읽히지는 않을 수 있다.

그럼에도 이 책의 장점은 분명하다.

AI를 “신기한 도구”가 아니라 “운영 가능한 개발 프로세스의 일부”로 바라보게 만든다.

하네스를 처음 도입한다면 개인적으로는 책의 내용을 그대로 크게 적용하기보다, 작은 단위부터 시작하는 것이 좋다고 본다.

예를 들면 코드 리뷰 자동화가 가장 적당하다.

처음부터 AI에게 코드를 수정하고 머지하게 맡기기보다는, PR을 읽고 위험 요소를 찾게 하거나, 테스트 누락 여부를 점검하게 하는 식으로 시작하는 것이다. 읽기 권한부터 주고, 쓰기 권한은 나중에 제한적으로 여는 방식이 현실적이다.

그다음에는 생성-검증 구조를 붙여볼 수 있다.

하나의 에이전트가 코드를 만들고, 다른 에이전트가 리뷰한다. 또는 구현 담당과 테스트 담당을 나눈다. 이 정도만 해도 단일 에이전트에게 모든 것을 맡기는 것보다 안정성이 올라간다.

이 책은 그런 방향을 잡는 데 좋은 참고서다.

AI 코딩 도구를 개인 생산성 향상용으로만 쓰고 있다면, 이 책을 통해 한 단계 더 나아갈 수 있다. 특히 팀 단위로 AI 도입을 고민하는 리드 개발자, 시니어 개발자, 개발 PM에게 잘 맞는다.

반대로 단순히 “Claude Code 설치해서 명령어 몇 개 써보고 싶다” 정도라면 조금 무겁게 느껴질 수 있다. 이 책은 사용법 책이라기보다 설계서에 가깝다.

읽고 나서 가장 크게 남은 생각은 이것이다.

AI를 잘 쓰는 사람은 프롬프트를 잘 쓰는 사람이 아니라,

AI가 실수해도 무너지지 않는 구조를 만드는 사람일 수 있다.

앞으로 모델은 계속 좋아질 것이다.

하지만 모델이 좋아질수록 오히려 더 중요해지는 것은 그 모델을 어디까지 믿고, 어디서 멈추게 하고, 어떻게 검증할 것인가다.

그 질문에 관심이 있다면 『하네스 엔지니어링 with 클로드 코드』는 충분히 읽어볼 만한 책이다.