한빛미디어

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

AI 코딩 도구를 처음 접했을 때 나 스스로가 아래와 같은 기대를 했었다.

“이제 코드는 AI가 대신 짜주겠구나.”

“개발 생산성이 폭발적으로 올라가겠구나.”

“프롬프트만 잘 쓰면 원하는 결과를 바로 얻을 수 있겠구나.”

하지만 실제 업무 현장에 적용해보면 기대와 현실 사이에는 분명한 간극이 있다. AI는 코드를 빠르게 생성하지만, 그 코드가 항상 안전하거나 일관적이거나 유지보수 가능한 것은 아니다. 때로는 기존 구조를 무시하고, 테스트 없이 대규모 수정을 제안하며, 보안적으로 위험한 구현을 아무렇지 않게 만들어내기도 한다.

『하네스 엔지니어링 with 클로드 코드』는 바로 이 지점을 정면으로 다루는 책이다. 이 책은 AI에게 단순히 “코드 짜줘”라고 지시하는 수준을 넘어, AI 에이전트가 실수하지 않도록 역할, 권한, 도구, 검증, 관측 체계를 어떻게 설계해야 하는지를 설명한다.

한마디로 말하면 이 책은 AI 코딩 도구 사용법 책이라기보다, AI 에이전트를 개발 조직 안에서 안전하고 반복 가능하게 운영하기 위한 실전 아키텍처 가이드에 가깝다.

이 책에서 가장 인상적인 관점은 AI의 실패 원인을 단순히 모델 성능에서 찾지 않는다는 점이다. 많은 사람은 AI가 이상한 코드를 만들거나 잘못된 판단을 내리면 “아직 모델이 부족하다”고 생각한다. 물론 모델 성능도 중요하다. 하지만 이 책은 더 근본적인 문제를 지적한다. AI가 일하는 구조가 잘못되었기 때문에 실패한다는 것이다. 사람이 일할 때도 마찬가지다. 아무리 능력 있는 개발자라도 역할이 불명확하고, 권한이 과도하며, 리뷰 절차가 없고, 테스트 기준이 없다면 문제가 발생할 수밖에 없다. AI 에이전트도 다르지 않다. 오히려 AI는 속도가 빠르기 때문에 잘못된 구조 안에서는 더 빠르게 더 많은 문제를 생성해 낸다.

하네스는 AI 모델 자체를 바꾸는 것이 아니다. 모델 바깥에 역할, 권한, 도구, 검증, 관측 체계를 설계해서 AI가 안전하게 일하도록 만드는 실행 환경이다. 이 책은 이 개념을 중심으로 AI 에이전트 팀을 어떻게 설계하고 운영할 것인지 구체적으로 설명한다.

그동안 AI 활용의 핵심 키워드는 프롬프트 엔지니어링이었다. 어떻게 질문해야 좋은 답을 얻을 수 있는지, 어떤 문장을 넣어야 원하는 결과가 나오는지가 중요했다. 하지만 실무에서는 프롬프트만으로는 한계가 있다. 좋은 프롬프트 하나가 매번 같은 품질을 보장하지 않는다. 코드베이스가 복잡해지고, 작업 범위가 커지고, 보안과 품질 기준이 개입되면 단순한 프롬프트만으로는 안정적인 결과를 얻기 어렵다.

이 책이 제시하는 하네스 엔지니어링은 프롬프트보다 한 단계 더 넓은 개념이다. AI에게 무엇을 말할 것인가가 아니라, AI가 어떤 역할로, 어떤 도구를 사용해, 어떤 절차를 거쳐, 어떤 기준으로 검증받으며 일할 것인가를 설계한다.

즉, 프롬프트 엔지니어링이 ‘지시의 기술’이라면, 하네스 엔지니어링은 ‘AI 업무 시스템 설계의 기술’이다.

이 책의 중심에는 세 가지 구성요소(에이전트, 스킬, 오케스트레이터)가 있다.

에이전트는 특정 역할을 맡은 AI 작업자다. 예를 들어 코드 작성자, 코드 리뷰어, 테스트 담당자, 보안 검토자, 문서화 담당자처럼 역할을 나눌 수 있다. 중요한 것은 AI에게 모든 일을 한 번에 맡기지 않는다는 점이다. 사람 조직처럼 AI도 역할과 책임을 분리해야 한다.

스킬은 에이전트가 반복적으로 사용할 수 있는 업무 절차다. PR 리뷰 스킬, 로그인 기능 구현 스킬, 테스트 작성 스킬, 장애 원인 분석 스킬처럼 실무에서 반복되는 작업을 재사용 가능한 단위로 정리한다. 잘 만든 스킬은 단순한 프롬프트 모음이 아니라 조직의 업무 노하우가 축적된 프로세스 자산이 된다.

오케스트레이터는 여러 에이전트와 스킬을 조율하는 역할을 한다. 어떤 작업을 누구에게 배정할지, 어떤 순서로 진행할지, 어떤 결과를 검증할지, 언제 작업을 종료할지를 관리한다. 개발 프로젝트에서 PM, 테크리드, 스크럼 마스터가 하는 역할과 유사하다.

이 구조가 중요한 이유는 AI 활용을 ‘대화’에서 ‘업무 프로세스’로 전환하기 때문이다. 지금까지 많은 AI 활용이 채팅창에서의 단발성 요청에 머물렀다면, 하네스 엔지니어링은 AI를 실제 업무 흐름 안에 넣고 통제 가능한 방식으로 운영하게 만든다.

개인적으로 이 책에서 가장 실무적으로 와닿았던 부분은 AI 에이전트 운영에도 권한 분리와 품질 게이트가 필요하다는 관점이었다. AI에게 모든 파일을 수정하게 하고, 생성한 코드를 스스로 검토하게 하고, 테스트도 생략한 채 결과를 믿는 것은 대단히 위험하다. 이는 나혼자 개발하고, 혼자 리뷰하고, 혼자 승인하고, 혼자 배포하는 것과 다르지 않다. 특히, 이 책은 생성자와 검증자를 분리하는 구조를 강조한다. 한 에이전트가 코드를 작성하면 다른 에이전트가 리뷰하고, 또 다른 에이전트가 테스트와 보안 관점에서 검토하는 식이다. 이 방식은 실제 개발 조직의 코드 리뷰, 보안 검토, 테스트 자동화 체계와 맞닿아 있다.

보안 관점에서 현재 상황을 바라보면, AI 에이전트가 인증·인가 로직을 수정하거나, 환경 설정을 바꾸거나, 운영 데이터에 접근하거나, 민감정보를 로그로 남기는 상황은 충분히 발생할 수 있다. 따라서 AI에게도 명확한 금지 행동, 승인 절차, 검증 기준, 감사 로그, Secure Coding 가이드라인이 필요하다는 것이다.

이 책의 장점은 개념 설명에 머물지 않고 실제 개발 업무에 가까운 사례를 다룬다는 점이다. 코드 리뷰 자동화 팀, 풀스택 기능 구현 팀, 레거시 마이그레이션 팀, 디버깅과 RCA 팀 같은 구성은 실제 현장에서 바로 응용할 수 있는 시나리오다. 예를 들어 로그인 기능을 구현한다고 할 때, 단일 AI에게 “로그인 기능 만들어줘”라고 요청하는 방식은 위험하다. 로그인은 프론트엔드, 백엔드, 인증, 세션, 토큰, 예외 처리, 보안 정책, 테스트가 모두 연결된 기능이다. 이 책의 방식대로라면 요구사항 분석, 프론트엔드 구현, 백엔드 구현, 보안 검토, 테스트 작성, 통합 리뷰를 각각 역할별 에이전트에게 분리할 수 있다.

이 책은 개발자를 위한 실전 가이드이지만, PM이나 CISO 관점에서도 읽을 가치가 높다.

PM에게는 AI 에이전트를 프로젝트 수행 체계 안에 어떻게 편입할 것인지에 대한 방향성을 제시해 준다. 작업 분해, 역할 배정, 산출물 검증, 재작업 관리, 변경 이력 관리 등은 모두 프로젝트 관리의 핵심 요소들이다. AI 에이전트 팀도 결국 하나의 수행 조직처럼 설계되어야 한다느 점에서 공감되는 부분이었다.

CISO 측면에서는 AI 활용에 따른 새로운 보안통제 프레임워크를 생각하게 만들어준다. 앞으로 기업 내부에서 AI 코딩 도구와 에이전트형 자동화 도구의 사용은 더 늘어날 것이다. 이때 중요한 것은 사용을 막는 것이 아니라, 안전하게 사용할 수 있는 기준과 플랫폼을 만드는 것이다. AI 에이전트의 권한을 어디까지 허용할 것인가, 어떤 작업은 반드시 검증을 거쳐야 하는가, 민감정보와 운영환경 접근은 어떻게 통제할 것인가, 에이전트의 작업 이력은 어떻게 감사할 것인가. 이 책은 이런 질문을 기술 실무 관점에서 고민하게 만든다.

다만 이 책은 AI 코딩 도구를 처음 접하는 독자에게는 다소 어렵게 느껴질 수 있다. 클로드 코드, CLAUDE.md, 에이전트, 스킬, 오케스트레이션, 메타 하네스 같은 개념이 익숙하지 않다면 초반 진입 장벽이 있을 수 있다.

또한 책의 주제가 실무 지향적인 만큼, 단순히 AI가 무엇인지 알고 싶은 독자보다는 실제로 AI 코딩 도구를 사용하고 있거나 조직 내 도입을 고민하는 독자에게 더 적합하다. AI 입문서라기보다는 AI 활용 고도화 전략서에 가깝다.

하지만 바로 그 점이 이 책의 차별점이기도 하다. 이미 AI 도구를 사용해봤고, 그 한계와 불안정성을 경험한 사람이라면 이 책의 문제의식에 크게 공감할 것이다.

『하네스 엔지니어링 with 클로드 코드』는 AI 시대의 개발자가 어떤 방향으로 진화해야 하는지를 잘 보여주는 책이다. AI가 코드를 대신 짜주는 시대를 넘어, 이제는 AI 에이전트가 팀처럼 협업하고, 역할을 나누고, 서로 검증하며, 조직의 개발 프로세스 안에서 작동하는 단계로 이동하고 있다.

AI를 더 잘 쓰기 위해서는 더 긴 지시문을 쓰는 것이 아니라, 더 안전하고 반복 가능하며 검증 가능한 업무 구조를 설계해야 한다. 이 책은 그 구조를 어떻게 만들 것인지에 대한 실무적 답을 제시한다. AI 코딩 도구를 이미 사용하고 있다면, 이 책은 단순한 사용법 이상의 Insight를 제공해줄 것이다. 그리고 조직 차원에서 AI 에이전트 도입을 고민하고 있다면, 반드시 한 번쯤 읽어볼 만한 책이다.

#하네스엔지니어링 #클로드코드 #AI에이전트 #AI개발 #프롬프트엔지니어링 #개발자동화 #AI코딩 #ClaudeCode #소프트웨어개발 #개발자책추천 #AI도서추천 #PM추천도서 #CISO #보안아키텍처 #AI거버넌스