|
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다." AI 코딩 도구를 처음 접했을 때 나 스스로가 아래와 같은 기대를 했었다. “이제 코드는 AI가 대신 짜주겠구나.” “개발 생산성이 폭발적으로 올라가겠구나.” “프롬프트만 잘 쓰면 원하는 결과를 바로 얻을 수 있겠구나.” 하지만 실제 업무 현장에 적용해보면 기대와 현실 사이에는 분명한 간극이 있다. AI는 코드를 빠르게 생성하지만, 그 코드가 항상 안전하거나 일관적이거나 유지보수 가능한 것은 아니다. 때로는 기존 구조를 무시하고, 테스트 없이 대규모 수정을 제안하며, 보안적으로 위험한 구현을 아무렇지 않게 만들어내기도 한다. 『하네스 엔지니어링 with 클로드 코드』는 바로 이 지점을 정면으로 다루는 책이다. 이 책은 AI에게 단순히 “코드 짜줘”라고 지시하는 수준을 넘어, 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거버넌스 |
|
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다." 2022년 챗GPT가 소개되면서 프롬프트 엔지니어링(2023년) → 컨텍스트 엔지니어링(2025년) → 하네스 엔지니어링(2026년 2월)이 소개되었다. 문제 해결 관점에서 세 가지 개념은 모두 중요하지만, 소프트웨어 개발 방법론 측면에서 하네스 엔지니어링은 가장 중요하며, 개발 패러다임을 완전히 바꾸는 개념이라고 생각한다. 개발뿐만 아니라 모든 업무를 보는 패러다임을 통째로 바꿀 개념이다. 지난 3년간 개발자들은 힘든 시간을 보내고 있다. 생성형 AI가 발전하면서 가장 먼저 타격을 입은 분야가 개발자들이라고 생각한다. 적응하기 위해 끊임없이 공부하고, 공부하고, 공부하지만 새로운 개념들이 계속 나오고 있다. 물론 생성형 AI 시대에 시행착오를 거치는 과정이라고 생각하지만, 피곤한 것도 사실이다. 이제 끝이 보인다. 하네스 엔지니어링은 최근 3년간의 시행착오에 종지부를 찍는 개념이다. 이 책은 황민호 저자의 메타스킬 오픈소스 harness에 사용된 개념을 설명하고 있다. 셀 수 없을 정도로 많이 생성한 분야별 하네스의 경험이 고스란히 담겨 있다. 책에서는 하네스 엔지니어링의 개념을 시작으로 하네스를 구성하는 세 요소(에이전트 · 스킬 · 오케스트레이터), 메타스킬, 개발에서 가장 많이 사용되는 네 가지 사례, 설치 방법, 트러블슈팅까지 하네스 엔지니어링의 A to Z를 담고 있다. 메타스킬로 하네스를 구성하고 사용하는 것은 이미 해봤다. 에이전트, 스킬, 오케스트레이터가 각각 무엇인지도 알고 있었다. 그런데 막상 하네스가 제대로 동작하지 않을 때, 어디서 무엇이 잘못됐는지 짚어낼 수 없었다. 세 요소가 유기적으로 어떻게 맞물려 돌아가는지 몰랐기 때문이다. 이 책은 그 안쪽을 보여준다. 사용할 줄 아는 것과 이해하는 것은 다르다. 하네스를 직접 깎으려면 후자가 필요하다.
책에서 다루는 개념은 생각보다 쉽지 않다. 가장 어려운 이유는 지난 수십 년간 익숙해진 전통적인 소프트웨어 엔지니어링에서 AX로의 생각의 전환이 필요하기 때문이다. 챗봇 인터페이스로만 AI를 접했거나, 에이전트를 아직 경험하지 않은 독자라면 분명 러닝 커브가 있을 것이다. 클로드 코드 Max 플랜이 필요하다는 점도 입문자에게는 부담이 될 수 있다.
그럼에도 하네스 엔지니어링은 소프트웨어 개발에 국한되지 않고 콘텐츠 제작, 데이터 분석, 금융, 의료, 법률 등 인간의 모든 활동에 영향을 미칠 것이다. 2026년 2월에 나온 개념이지만, 생성형 AI가 나오면서 필연적으로 나올 수밖에 없었던 개념이다. 앞으로 모두가 하네스를 구축할 수 있겠지만, 이 책은 AI가 만든 하네스에 의존하는 것이 아니라 그 초안을 활용하여 직접 통제하는 능력을 갖게 해줄 것이다. 아직 하네스 엔지니어링이 생소한 국내 독자에게 매우 시의적절한 책이다. 비 개발자와 입문자를 위한 분야별 하네스를 구축하고 실습하는 2편을 조심스레 기대해본다. |
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다." AI 코딩 도구를 사용하다 보면 원하는 결과가 나오지 않을 때 가장 먼저 프롬프트를 고치게 된다. 지시를 더 자세히 쓰거나, 예시를 추가하거나, 더 성능이 좋은 모델로 바꾸면 결과도 좋아질 것이라고 생각하기 쉽다. 나 역시 AI 에이전트의 성능을 모델과 프롬프트의 문제로만 보는 편이었다. 책에서 가장 먼저 좋았던 부분은 2장의 30분 Quick Start였다.
|
|
한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다. 하네스 엔지니어링 with 클로드 코드(한빛미디어, 2026) [모델이 아니라 하네스가 결과를 결정합니다.] AI 에이전트 구성을 통한 업무 효율과 생산성 증대로 뜨거운 오늘, 루프 엔지니어링과 더불어 '하네스 엔지니어링'이 화두로 떠오르고 있다. 저자(황민호)가 페이스북 친구라 저자의 행적을 sns를 통해 관심있게 보고 있던 찰나, 한빛미디어를 통해 하네스 엔지니어링의 기본 개념과 사용법을 설명하는 책이 출간 되었다. 한빛미디어 - 나는 리뷰어다를 통해 살펴본 AI 에이전트 구성의 새로운 방법, ai 모델을 변경하는 것이 아닌 모델 이외를 통제하여 AI 에이전트가 안전하고 예측 가능한 방식으로 작동하도록 설계하는 법을 책을 통해 만나게 되었다. 하네스의 주요 구성요소는 '권한, 도구, 검증, 상태, 관측' 으로, 단일 에이전트의 '실패'를 모델의 한계가 아니라 환경의 설계 문제로 다루는 방법이다. 저자는 클로드 코드를 통한 실습으로 하네스의 구성법을 '에이전트'-'스킬'-'오케스트레이터'의 세 가지 구성요소로 역할과 책임을 설명한다. 에이전트는 '누가' 에이전트 팀 구성을 위해 에이전트의 정의, 스킬 설계, 오케스트레이터를 구성하는 반복 작업을 '메타스킬'로 명칭하며 '어떤 스킬과 에이전트를 만들어야 하는가?'에 대한 고민의 답을 제안한다. 메타스킬은 자기 참조성을 통해 검증 가능성을 갖으며, 이는 하네스 스킬을 통한 엔지니어링 테스트 방식으로 연결된다. 하네스의 개념 이해를 위해 저자는 6가지 아키텍처 패턴으로 에이전트 구성 예시를 든다. 에이전트를 어떻게 분리 할 것인지?(몇 개의 에이전트를 구성할 것인지?)를 패턴을 통해 문제에 알맞는 팀 모양을 구성하도록 안내하며 복합 패턴 및 3~5명의 팀 규모 상한을 제시한다. '하네스 엔지니어링'을 텍스트로 마주했을때는 '아! 이런 기술도 있구나. 재밌겠는데?'하는 호기심과 관심이었지만, 책을 통해 실제 실습 구성을 따라가면 엔지니어링에 필요한 다양한 개념과 원리 이해를 만나게 된다. 책을 한 번 완독 후 클로드 코드로 저자의 하네스 설계를 한 땀 한땀 따라가며 지금 왜 이 기술이 화두인지, 필요한지, 유용한지를 깊이있게 알아갈 수 있었다. (특히 마지막 Part4. 실전편에서는 다양한 팀 구성 방법과 응용 방법 그리고 주의사항까지 제시하며 하네스 엔지니어링의 A to Z를 설명하는 점이 입문자에게 큰 도움이 되었다.) 클로드 코드를 많이 사용하고, AI 에이전트에 관심이 있는 그리고 '하네스 엔지니어링'이 궁금한 모든분께 황민호 저자의 하네스 엔지니어링 실전 가이드 '하네스 엔지니어링 with 클로드 코드'를 추천한다. 저자 : 황민호 제목 : 하네스 엔지니어링 with 클로드 코드 출판사 : 한빛미디어 출간 연도 : 2026.06.11 페이지 : 308쪽 www.hanbit.co.kr https://www.hanbit.co.kr/store/books/look.php?p_code=B2817272480 한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다. #한빛미디어 #하네스엔지니어링 #황민호 #나는리뷰어다 #하네스 #클로드코드 |
|
한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다.
즘 클로드 코드(Claude Code) 관련 내용을 정말 어마어마하게 듣고 있습니다. 프롬프트 엔지니어링, 하네스 엔지니어링, 클로드 스킬, CLAUDE.md, 옵시디언 에이전트 자동화까지. 하루가 멀다 하고 새로운 개념이 쏟아져서, 솔직히 다 따라가기가 벅찰 정도입니다. 그 많은 키워드 중에서도 몇 달째 가장 뜨거운 단어가 바로 '하네스 엔지니어링' 입니다. 도대체 뭐길래 이렇게 핫한 걸까 궁금하던 차에, 한빛미디어 <나는리뷰어다> 6월 도서로 딱 이 책이 도착했습니다. 바로 『하네스 엔지니어링 with 클로드 코드』 입니다. 엔지니어링이라는데, 알고 보면 '내 도구 다듬기' '하네스 엔지니어링'이라고 하면 단어부터 거창하고 어렵게 느껴집니다. 그런데 책을 읽으면서 제가 받은 느낌은 의외로 단순했습니다. 결국 내가 쓸 도구를 잘 다듬는 일과 비슷하다는 것입니다. 도구를 잘 다듬어야 좋은 결과물이 나오는 건 너무 당연한 이야기니까요. 예를 들면 내 방 가구 배치 같은 것이라고 생각하면 쉽습니다. 같은 방, 같은 가구라도 어디에 어떻게 두느냐에 따라 동선이 편해지기도 하고 답답해지기도 하죠. AI도 똑같습니다. 같은 모델이라도 일하는 환경을 어떻게 배치하고 다듬어 주느냐에 따라 결과물이 완전히 달라집니다. 이 책이 처음부터 끝까지 강조하는 메시지도 바로 그것입니다.
즉 프롬프트를 잘 쓰는 시대에서 → 하네스(환경)를 잘 설계하는 시대로 넘어가야 한다는 겁니다. 저는 이 한 문장 때문에 책을 끝까지 읽기로 했습니다. 그래서 하네스가 뭔가요 말은 어렵지만 구조는 단순합니다. AI 한 명에게 전부 떠넘기지 말고, 역할을 나눠서 'AI 팀'처럼 일하게 만드는 틀입니다.
에이전트(누가) — 어떤 역할을 맡을지 스킬(어떻게) — 그 일을 하는 방법 오케스트레이터(언제·누구와) — 누가 언제 협업할지 이 세 가지를 분리해서 설계하면 AI가 혼자 일할 때 생기는 한계를 구조적으로 메울 수 있다는 게 책의 뼈대입니다.
직접 읽어보니 좋았던 점 거창한 도구가 필요 없습니다. Git과 마크다운만으로 구현이 가능해서, "또 무슨 프레임워크 깔아야 하나" 하는 부담이 없었습니다. '생성-검증' 구조가 인상적이었습니다. AI가 만든 결과물을 AI가 다시 검증하게 짜는 방식인데, 그동안 제가 일일이 손으로 확인하던 일을 시스템으로 풀 수 있겠더라고요. 실전 사례가 진짜 실무에 가깝습니다. 코드 리뷰, 레거시 마이그레이션, 디버깅처럼 "이건 나도 겪는 일"인 사례라 바로 와닿았습니다. [인상 깊었던 페이지나 도식 사진 1장 - 6가지 아키텍처 패턴 부분 추천]
솔직히 살짝 아쉬운 점 부제 그대로 '개발자' 실전 가이드라, 저처럼 코딩이 깊지 않은 사람은 용어에서 멈춰서게 되는 일이 많았습니다. 하지만 용어에 친숙해진다면 비개발자도 충분히 따라갈 수 있습니다. '하네스'라는 개념 자체가 새것이다 보니, 처음 한두 챕터는 용어에 적응하는 시간이 필요했습니다. 그래도 308쪽 분량에 군더더기가 적고, 개념에서 패턴, 실전으로 이어지는 순서가 깔끔해서 길을 잃지는 않았습니다.
이런 분께 추천합니다 클로드 코드를 '혼자 쓰는 도구' 수준에서만 쓰고 있는 분 AI를 팀이나 조직 단위로 도입하려는 리드 개발자 반복 작업을 자동화 시스템으로 묶고 싶은 분 반대로 이제 막 AI 입문, 프롬프트를 처음 배우는 단계라면 조금 이른 책일 수 있습니다. 마무리 저는 이 책을 읽고 "AI에게 일을 시키는 법"에서 "AI 팀을 운영하는 법"으로 생각이 한 단계 넘어갔습니다. 쏟아지는 클로드 코드 키워드 속에서 왜 하네스 엔지니어링이 몇 달째 가장 핫한지, 읽고 나니 납득이 되더군요. 마침 제가 블로그에 연재 중인 자동화 실습에도 바로 적용해 볼 생각입니다. AI를 단순한 '도구'가 아니라 잘 다듬어 쓰는 '나만의 작업 환경'으로 만들고 싶은 분이라면, 한 번 읽어볼 가치가 충분합니다. 도서 보러가기: https://www.hanbit.co.kr/store/books/look.php?p_code=B2817272480 #하네스엔지니어링 #클로드코드 #ClaudeCode #AI에이전트 #한빛미디어 #나는리뷰어다 #AI자동화 #업무자동화 #서평 #슈마의보고듣고쓰고 |
|
패턴화된 업무, 복잡하지만 규칙이 있는 코드. 이 모든 것은 이제 AI에 넘겨야 되는 세상 작년까지만 해도, langSqeunce, langGraph를 비롯하여, prompt -> context AI 개발이 대세였었다. 하지만, 1년도 안되는 시간에 클로드가 탄생하였고, 클로드를 통해 세상은 다시금 대격변을 겪고 있다. 언제부터인가 튜닝 머신 (사람과 기계의 대화를 통해 사람이 대화 상대가 머신인지 아닌지 판별하는 것) 개념 그 이상의 것이 등장하기 시작했다. 아마도 그 시작은 전산학이 시작해서부터 계속되었겠지만, 세기의 대결인 이세돌 사범과 알파고의 대결 그 이후라고 해도 과언이 아닐 것이다. 즉, 기술의 변화 속도가 이제는 사람이 예측 가능한 범주 그 이상이 된 것이다. 위 사건 이후로, AI 기술은 수많은 갈래를 뻗어 파생 분야가 생겨났다. 그리고 그 가지가 뻗기와 가지치기를 반복한 결과 마침내 오늘에 이른 것이라 할 수 있다. 그것은 바로 대 AI 시대.. 그것이 오늘의 현실인 것이다. 【책 내용 요약】 이 책은 prompt -> context -> harness에 이르는 간략한 역사를 소개한 후, 요즘 대세가 되는 AI Model을 제외한 모든 것을 개발하는 harness 개념을 소개한다. 내용은 간략하며, 담백하고 AI를 이용해 개발을 해본 사람이 있다면 누구든 쉽게 이해할 수 있는 그런 구성으로 되어있다. 대표적인 책의 구성은 아래와 같다.
앞서 언급한 내용과 동일하게 harness 엔지니어링은 모델을 제외한 모든 것들을 자동화?의 관점에서 조립하고 설계하는 기술이라 할 수 있다. 가령 A라는 모델이 있다면, A라는 모델뿐만 아니라, B 모델, C 모델까지 확장하여 각각의 Agent에 역할을 할당하고, 그 역할에 따라 Agent (모델)끼리 상호 소통하고 최종의 목적을 향해 자동화된 프로세싱을 만드는 과정이 harness 엔지니어링이다. 즉, 각각의 Agent에 역할과 role을 정의하고 그 역할과 role에 따라서 정확히 동작하는지를 감독/평가/결정하는 일련의 과정을 정의하는 것이라 할 수 있다. 【 하네스 엔지니어링을 읽고 나서 】 단순히 코딩뿐만 아니라 이제는 전 산업분야에 걸쳐서 AI가 적용되고 있고, 이미 적용된 사례도 적잖게 찾아볼 수 있다. 무엇보다 Agent 1개가 거의 사람 한 명 몫을 수행하기에 (완벽하진 않지만) 더 이상 1인 창업이 완전히 불가능한 세상이라 할 수도 없게 되었다. 아마도 머지않은 시점에 (2~3년 내로) 개인의 경쟁력은 결국 창의력, 추진력으로 귀결되는 세상으로 탈바꿈하게 될 것이다. 즉, 이제는 전문적인 기술보단 창의적인 생각이 더욱 주목받는 세상이 시작된 것이다. #본 도서는 "한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다. |
|
기술의 패러다임이 바뀔 때마다 우리는 수많은 개념과 정의 속에서 살아갑니다. 최근 생성형 AI의 폭발적인 발전은 개발 프로세스 자체를 뒤흔들고 있습니다. 이러한 격변의 시기에 누군가가 복잡하고 어려운 개념을 정리하고 방법을 가이드해 준다면 누구나 쉽고 빠르게 AI를 활용할 수 있을 겁니다. 「 하네스 엔지니어링 with 클로드 코드 」는 단순히 AI 도구의 사용법을 나열하는 가이드북이 아닙니다. 이 책은 '클로드 코드(Claude Code)'를 활용하여, 시스템의 안정성과 유연성을 확보하는 '하네스 엔지니어링(Harness Engineering)'의 실천적 방법론을 체계적으로 다룹니다. 단순히 AI를 활용하는 방법을 다루는 게 아니라, 클로드 코드와 하네스 엔지니어링을 활용할 때 우리가 고민하고 생각해봐야 하는 것들을 자세하고 여러 시나리오를 기반으로 생각해 보도록 유도합니다.
IT 업계의 수 많은 기술 트렌드, 프레임워크나 최신 개발 언어에만 매몰된 책들은 유통기한이 짧을 겁니다. 반면, 기술의 저 아래 바닥부터 '본질'을 건드리는 책은 시간이 지나도 빛을 발할 겁니다. 그런 의미에서 「 하네스 엔지니어링 with 클로드 코드 」는 단순한 트렌드만 따라가는 책이 아니라, AI 협업 시대의 엔지니어링 본질을 디테일하게 터치해주는 책입니다. 대다수의 AI 관련 서적들은 생성형 AI로 어떻게 하면 좋은 프롬프트를 작성할 수 있는지와 같은 단편적인 기능에만 집중합니다. 그러나 「 하네스 엔지니어링 with 클로드 코드 」는 시스템 공학적 틀 안에서 특히 데이터 분석 시스템 구축 시 많은 이들이 범하는 오류인 '데이터 모델 만능주의'를 타파할 수 있는 기회일 수 있습니다. 흔히 정교한 수학적 모델이나 잘 정돈된 테이블 스카마만 있으면 훌륭한 데이터 분석 시스템이 완성될 것이라 착각합니다. 하지만 실제 시스템은 독립된 공간에서 진공상태로 존재하지 않습니다. 끊임없이 유입되는 이기종 데이터, 네트워크 지연, 메모리 한계, 끊임없는 비즈니스 요구사항 등등에서 살아 움직여야 합니다. 저자는 「 하네스 엔지니어링 with 클로드 코드 」에서 클로드 코드를 활용해 이러한 환경적 변수를 어떻게 통제하고, 시스템 분석을 통해 구조적 결함을 어떻게 선제적으로 예방할 수 있는지 구체적인 아키텍처와 코드로 보여줍니다. 이 책은 단순히 "AI를 어떻게 사용하나요?"라고 말하지 않습니다. 대신 "AI와 함께 시스템을 어떻게 더 단단하게 만들 것입니까?"를 묻습니다. 클로드 코드를 활용해 AI 자동화를 진행하기 원하는 주니어, 시니어 개발자 등등 모든 사람들에게 기꺼이 일독을 권하는 바입니다. |
|
안녕하세요, AI 에이전트와 자동화 도구를 적극 활용 중인 개발자입니다. 요즘 클로드 코드, 커서 같은 AI 코딩 도구를 쓰면서 늘 한 가지 불편함을 느꼈어요."왜 이 AI는 자기가 실수한 걸 스스로 못 잡지?" 혼자 코드를 짜고, 혼자 검토하고, 혼자 머지하는 구조에서 에이전트의 자기 검증은 결국 자기가 자기 글을 교정하는 것과 같다는 걸 어렴풋이 느끼고 있었습니다. 그러던 중에 [하네스 엔지니어링 with 클로드 코드]를 읽게 됐습니다. 결론부터 말하면, 이 책은 "AI 도구를 어떻게 더 잘 쓰는가"가 아니라 "AI가 일하는 환경 자체를 어떻게 설계하는가"를 다루는 책입니다. "모델이 아니라 하네스가 결과를 결정한다" 책의 첫 장부터 충격적인 사례가 나옵니다. 2025년 7월, 한 기업에서 AI 에이전트가 임원 레코드 1,206명분을 삭제하고 "복구 불가능합니다"라고 보고한 사건이요. 알고 보니 복구는 가능했고, 에이전트가 스스로 내린 판단이 문제였습니다. 읽으면서 손이 떨렸습니다. 이건 먼 나라 이야기가 아니거든요. AI 에이전트가 plan → code → verify → self-revise의 네 단계를 혼자 다 수행하는 구조에서는, 처음에 놓친 가정을 끝까지 반복한다는 게 이 책의 핵심 진단입니다. 저자인 황민호(카카오 FDE팀 수석)는 같은 클로드 모델을 두고 환경만 바꿨더니 점수가 49점에서 79점으로 올랐다는 실험 결과를 제시합니다. 모델이 아니라 모델을 둘러싼 구조가 결과를 결정한다는 것, 그게 이 책이 말하는 하네스 엔지니어링의 핵심입니다. 하네스란 무엇인가 — "모델 바깥을 설계하라" Part 1은 왜 단일 에이전트가 믿을 수 없는지에서 시작합니다. 단일 에이전트는 자기 실수를 잘 못 본다. 구조를 보면 이유가 명확합니다. 혼자 쓴 PR을 혼자 머지하는 구조이기 때문입니다. 하네스란 모델의 가중치를 건드리지 않고, 모델 바깥에 권한·도구·검증·관측을 설계해 에이전트가 혼자 움직이게 만드는 환경입니다. 병목이 능력이 아니라 구조에 있다는 인식의 전환이 이 파트의 핵심입니다. "단일 에이전트는 자신의 실수를 잘 보지 못한다." 이 한 줄이 책 전체의 출발점입니다. AI 에이전트가 계획·작성·검증·자기수정을 모두 같은 박스 안에서 수행하니, 처음에 놓친 가정은 끝까지 반복되고, 다른 검토자가 없으면 설계 결함이 그대로 남습니다. 하네스의 세 기둥 — 에이전트·스킬·오케스트레이터 Part 2는 이 책에서 가장 밀도 높은 파트입니다. 하네스를 이루는 세 기둥을 순서대로 분해합니다. 에이전트(누가) — 역할과 가드레일을 파일로 정의합니다. "이 에이전트는 무엇을 할 수 있고, 무엇을 할 수 없는가"를 CLAUDE.md와 에이전트 정의 파일에 명시합니다. 스킬(어떻게) — description 한 줄이 호출 여부를 결정합니다. 아무리 잘 만든 스킬도 description이 엉성하면 에이전트가 언제 써야 할지 모릅니다. 스킬 설계의 핵심은 description 작성이라는 게 인상 깊었습니다. 오케스트레이터(언제 누구와) — TeamCreate, TaskCreate, SendMessage 세 도구로 팀을 조율합니다. 특히 "한 파일에 다 넣으면 무엇이 깨지는가" 챕터가 인상 깊었습니다. 누가(역할), 어떻게(스킬), 언제 누구와(조율)가 한 파일에 섞이면 한쪽을 바꿀 때마다 다른 쪽이 영향을 받습니다. 단일 책임 원칙을 어긴 클래스 하나가 자리를 차지하고 있는 셈입니다. 저는 읽고 나서 팀 내 에이전트 구성을 다시 들여다봤습니다. "이 역할 정의가 여기 있어야 하나?" 질문 하나씩 던지면서 정리했더니, 수정 속도가 눈에 띄게 달라졌습니다. 오케스트레이터 — 리더 병목을 어떻게 해소할까 6장 오케스트레이터 챕터는 사실상 이 책의 핵심입니다. 팀이 세 명을 넘으면 리더 병목이 생깁니다. 오케스트레이터가 모든 메시지를 중계하면 처리량이 병목이 되고, 직접 코드를 고치면 책임 분리가 무너집니다. 이를 해결하는 게 세 가지 기본 도구입니다. TeamCreate로 세션 객체로서의 팀을 생성하고, TaskCreate로 공유 작업 큐를 관리하고, SendMessage로 팀원끼리 직접 소통하게 합니다. 책에서 강조하는 건 이거예요. "모든 것이 성공한다고 가정하는 오케스트레이터는 프로덕션에서 가장 먼저 무너진다." — 클로드 코드 오케스트레이션 공식 가이드에서 인용한 이 문장이 챕터 전체를 관통합니다. 팬아웃/팬인, 파이프라인, 생성-검증 등 여섯 가지 아키텍처 패턴과 함께 실행 모드별 트레이드오프도 명확하게 정리됩니다. Part 4 실전편 — 코드 리뷰 자동화 팀 이 챕터는 그냥 실무 필살기입니다. PR diff를 받아 정적 분석, 보안 검토, 테스트 영향 검토를 병렬로 수행하고 하나의 리뷰 리포트로 통합하는 코드 리뷰 자동화 팀의 전체 구성이 낱낱이 공개됩니다. 오케스트레이터 스크립트부터 각 에이전트 정의 파일, 출력물 경로 설계까지 실제로 복사해서 바로 실행 가능한 수준으로 담겨 있습니다. 부록 — 설치부터 안티패턴까지 부록 A는 클로드 코드 설치와 환경 설정을 다룹니다. macOS, Windows, Linux 각각의 설치 명령, Native installer 우선 권고, 지원 계정 종류까지 공식 문서 기준으로 정리돼 있습니다. 팀 도입 시 온보딩 가이드로 그대로 쓸 수 있습니다. 부록 B의 안티패턴 카탈로그는 특히 현실적입니다. 레벨 1(컨텍스트 창 초과), 레벨 2(토큰 마비 3단계), 레벨 3(큐레이션), 레벨 4(피드백 품질) 순으로 에이전트가 망가지는 경로를 구체적으로 보여줍니다. 부록 C의 5분 셀프 진단 10항목은 팀에 공유하기 딱 좋습니다. claude doctor가 모든 항목 OK인지, 에이전트 수가 20개 미만인지, CLAUDE.md가 200줄 이하인지 등 월 1회 응급 점검으로 활용할 수 있습니다. 이 책을 읽고 나서 달라진 것 읽고 나서 코딩 실력이 느는 게 아니라, AI 에이전트에게 일을 맡기기 전에 먼저 멈추게 됩니다. "이 에이전트가 혼자 이걸 해도 되는가?", "검증 단계가 분리돼 있는가?" 이 질문이 자동으로 나오기 시작해요. 에이전트에게 작업을 던지기 전에 구조부터 고민하게 됐고, 뭔가 꼬인다는 느낌이 들면 그게 모델 문제가 아니라 하네스 구조 문제라는 신호로 받아들이게 됐습니다. "한 번 읽고 끝"이 아니라, 꽂아두고 실전에서 막힐 때마다 꺼내보는 기준서 같은 느낌입니다. 이런 분들께 강추
프롬프트 엔지니어링이나 모델 내부 지식 없이도, git과 마크다운 파일만 다룰 수 있다면 충분합니다. 댓글로 여러분은 AI 에이전트가 예상치 못한 행동을 했던 경험이 있으신지 공유해 주세요! #하네스엔지니어링 #클로드코드 #AI에이전트 #하네스아키텍처 #개발자서평 #에이전트팀설계 #한빛미디어 #카카오AI #오케스트레이터 #메타스킬 |
|
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다." 사내 교육, 가족 상경 등 여러 가지로 너무 정신이 없던 6월이었다. 덕분에 월초에 반 정도 읽고 더이상 진도를 못 내고 있다가 월말이 다 되어서 겨우 완독하고 리뷰를 남겨 본다. 지난 달에 사내에서 SW 보안 교육을 직접 진행했었는데, 그 때에도 살짝 언급을 했었던 하네스 엔지니어링이 이번 도서의 주제이다. 최근 들어 생성형 AI 개발 도구인 ChatGPT Codex와 Claude Code 유료 버전을 하나씩 차례로 사용해 보면서 이번 도서의 주제인 하네스 엔지니어링에 대해서도 실제 테스트를 해볼 수가 있었는데, 음.. 이제는 정말 개발 생산성 향상을 위해 생성형 AI 유료 구독 하나쯤 필수라는 생각이 드는 것처럼 하네스 엔지니어링도 AI 기반 바이브 코딩 시 반드시 활용해야 하는 스킬이라는 생각이 든다. 저자도 강조했듯이 AI 도구의 활용 결과는 모델이 아니라 하네스가 결정을 한다는 말에 나 또한 동의한다. 단순히 프롬프팅만을 입력하면서 코드를 생성하고 개발하는데 그치지 않고, 그러한 프롬프팅 결과가 미리 정해진 규칙에 의해 다듬어질 수 있도록 에이전트 스킬을 미리 심어두게 되면, 꼭 사용 모델을 최신의 프론티어 모델로 변경하지 않더라도 동작의 성능이 올라갈 수 있다는 것이다. 저자 분은 카카오에서 AX 관련 업무를 하면서 그러한 다양한 시도를 통해 더 나은 결과물을 낼 수 있는 환경을 구축할 수 있었고, 이 책은 그러한 저자의 경험에 대한 내용을 담은 도서이다.
하네스(Harness)란 모델의 가중치를 바꾸지 않고, 모델 바깥의 권한, 도구, 검증, 상태, 관측을 설계해 에이전트가 일하게 하는 환경을 말하며, 하네스 엔지니어링은 그러한 하네스라는 AI 에이전트가 일하는 환경 전체를 설계하고 운용하는 구조적 체계라고 이해하면 된다. 이제는 단순히 좋은 프롬프트로 1회성의 좋은 결과물을 내는 것만이 목적이 아니라, AI 에이전트의 자율적인 action을 관리하고 구조적으로 제어하기 위해서 하네스가 반드시 필요해진 시대가 되었다. 솔직히 이 책을 읽기 전까지는, 물론 하네스 엔지니어링이 필요하긴 해도 프롬프트를 길고 정교하게 잘 쓰면 하네스 없이도 그러한 하네스 엔지니어링의 효과를 낼 수 있는게 아닌가하는 생각을 하곤 했었다. (도서에도 그런 내용이 나와 있어서 사실 굉장히 뜨끔했다. ^^;) 그러나 사실 프롬프트는 강제사항이 아니기 때문에, 구조적인 가드레일 및 통제 체계를 갖추기 위해서는 하네스와 같은 별도의 강제 설정이 반드시 필요하고, 그래야만 만에 하나 프롬프트가 잘못되어 있더라도 하네스에 의해 통제될 수 있다. (물론 별도 md로도 100% 강제라고 보장은 안되겠지만..) 한 마디로 본 도서에는 하네스 엔지니어링 노하우의 모든 것이 담겨있다고 볼 수 있을 정도로 하네스와 관련된 많은 유용한 내용을 담고 있어, 하네스 엔지니어링에 대해 입문하고자 하는 분들 뿐만 아니라, 약간의 AGENTS.md나 SKILL.md를 이미 사용하고 있는 분들에게도 유용할 것 같다. 사람이 단일 에이전트 하나에 명령을 내리는 체계에서 AI 에이전트들이 자신의 컨텍스트를 관리하고 서로 협업하면서 자율적으로 일을 할 수 있게 만드는 멀티 에이전트 형태로 변화되면서 이러한 에이전트들에 대한 역할 기반의 동작 설계를 위한 요소로서 하네스가 이용되고 있다. 참고로, 저자분의 깃헙에 가보면 harness-100이라는 리포지토리가 있는데, 일상생활과 업무에 바로 적용할 수 있는 100가지 유용한 에이전트 팀 하네스가 저장되어 있다. 그 내용들만 둘러봐도 하네스를 어떻게 작성하는지 이해하는데 많은 참고가 된다. 보통 여러 개의 멀티 에이전트들을 위한 md 파일과 그에 따라 필요한 skill.md 파일이 존재하고, 무엇보다도 이러한 각 에이전트들의 결과물들을 통합하여 최종 산출물로 정리하는 오케스트레이터 skill.md 파일이 존재하는 구조이다.
또한, 개인적으로 부록 D의 토큰 사용량을 다룬 부분이 매우 흥미로웠는데, 돌릴 때마다 토큰 비용이 드는 AI 서비스의 특성 상, 적은 비용 투자 대비 최고의 효율을 얻고자하는 모든 사람들의 관심사항이기 때문이다. 저자분이 그 동안의 경험을 토대로 기록한 5가지 원리와 안티패턴은 예산이 충분치 않은 개인이나 조직에 상당한 도움이 될 것이라 생각된다.
AI 기술이 대중화되면서 AI 관련 서적들도 쏟아져 나오고 있지만, 본 도서처럼 하네스 엔지니어링을 본격적으로 자세히 다룬 도서는 처음 읽어보게 되어 개인적으로 많은 도움이 되었다. AI 시스템을 소프트웨어 공학적 관점에서 어떻게 통제하고 확장해야 하는지의 본질을 짚어주는 도서인 것 같다. 여담인데, 오늘 페이스북 타임라인에 올라온 글들을 쭉 읽어보다가, 친구 중 누군가가 웹툰 제작용 하네스를 무료로 공개한다고 올린 글을 보고, 여기에도 하네스 엔지니어링 전문가 분이 계셨다고 생각을 했었는데, 다시 잘 보니 본 도서의 저자분이셔서 매우 놀라고 신기했다. ^^ 저자분의 활발한 활동을 보며 나 또한 더 노력해야겠다는 긍정적인 자극이 되는 것 같아 저자분께 이 자리를 빌어 감사의 말씀을 전한다. |
안녕하세요? 글 쓰는 개발자, 품격 있는 직장인 부자입니다. 저는 주로 커서를 이용해서 개발하고 클로드의 모델을 이용하지만 아직도 10%도 제대로 활용하고 있지 못하다고 생각이 드는 개발자입니다. 분명히 생산성이 향상되었긴 하지만, 아직도 뭔가 많이 활용할 수 있는데 못하고 있는 부분이 꽤 남아있다는 것도 알기에 항상 인공지능을 이용하면서도 찝찝한 기분이 들죠. 이번에 읽고 있는 『하네스 엔지니어링 with 클로드 코드』는 이런 부분을 일부 해결해주는 좋은 도구였습니다. 완전히 정독하지 못해서 실제 업무에 반영하지 못한 부분이 많지만 제가 어떤 부분을 놓치고 있는지를 깨닫게 해준 부분이 많았어요. 책에서 언급한 대상 독자인 "커서를 쓰고 있지만 단일 에이전트 프롬프팅에서 벗어나지 못한 개발자"는 저를 보고 하는 소리인 것 같군요. 하네스 엔지니어링에 대해서는 이것저것 들은 것이 있어서 개념만은 알고 있었습니다만 내 업무에, 나의 프로젝트에 어떻게 적용하는지는 거의 몰랐고 시작할 엄두도 못내고 있었어요. 바로바로 들어오는 업무를 쳐내는 것도 바빴거든요. 그런데 책을 보니 조금만 시간을 내서 환경을 구성하기만 하면 앞으로의 작업들이 상당히 정확하면서도 편해질 수 있는 가능성이 있음을 느꼈습니다. 실제로 책에서 언급하길 LLM은 그대로 두더라도 모델의 환경을 바꾸기만 했을 때 상당한 수준의 벤치마크 향상이 보였다고 합니다. 사실상 생산성의 향상이라고 봐야겠죠? 그리고 이를 위한 엔지니어링 기법으로 최근 많이 알려지고 응용되고 있는 것이 바로 하네스 엔지니어링입니다. 모델은 그대로 두고 주변을 설계하는 것이 핵심이라고 해요. AI 에이전트가 일하는 환경 전체를 설계하고 운용하는 구조적 체계를 만드는 일인데, 이거 점점 개발자가 하는 일이 최상위 관리자의 역할로 올라가는 것 같습니다. 문제는 그 속도가 너무 빨라서 제가 잘 못 따라가는 것 같네요 ㅋㅋ 하네스 엔지니어링에서 필요한 것은 누가(Agent), 어떻게(Skill), 누구와(Orchestrator)라는 세 가지 요소인데, 말은 어렵지만 책이나 자료를 읽으면 읽을수록 그냥 현실에서의 팀장님 역할인 것 같습니다. 우리 모두가 팀장이 되어야 하는 시대가 찾아온 것 같아요. 리더십에 대한 책을 보는게 직접적인 업무에 도움이 될 것만 같군요. 그런데 최근에 조금씩 프로젝트 전체에 대해 파악해서 처리할 일이 많아지면서 저라는 인간의 뇌로는 단시간에 파악할 수 없는 부분이 많아지고 있어요. 이런 부분은 충분히 AI의 도움을 받을 수 있을텐데, 아직 방법을 잘 몰랐습니다. 『하네스 엔지니어링 with 클로드 코드』에서 이런 부분에 대한 기법들을 아주 많이 배우고 있어요. 특히 Skill을 작성하는 것은 성능에 꽤 많은 영향을 줬던 것 같습니다. 이게 문제는 너무 급한 일정을 소화해야 할 때는 스킬이나 에이전트에 대한 설계를 할 시간조차 나지 않는다는건데요. 그렇다고 안하면 미래에 뒤쳐질 것이 자명하기 때문에 걱정이 많습니다. 코드 작성의 전체 비중 중에서 소스코드를 직접 수정하는 비율이 10% 이하로 떨어진 것이 벌써 몇 달이 됐습니다. 그럼에도 인공지능을 제대로 활용하지 못하는 것은 너무 아쉽네요. 아주 조금씩이라도 이 책 『하네스 엔지니어링 with 클로드 코드』 내용을 업무에 반영해보려고 합니다. 얼마나 많이 생산성이 향상될까요... 기대됩니다! 『하네스 엔지니어링 with 클로드 코드』 리뷰 끝. |