- 주문상품수량
- 개
- 예상적립금
P - 상품할인금
- 원
- 배송료
- 원
- 주문합계
- 원
네비게이션 실시간 인기 책
예약판매
[예약판매] 하네스 엔지니어링 with 클로드 코드 AI 에이전트 팀을 설계·운영하는 개발자의 실전 가이드, 누구나 프로처럼 실전 AI
- 황민호 저
- 한빛미디어
- 2026년 06월 11일
-
정가30,000원
-
판매가27,000원 [10% 할인]
-
결제 혜택무이자
카드할인/포인트결제 안내
제휴카드
반디앤루니스 롯데카드 결제금액 최대 25% 청구할인 (1만원 이상 결제건에 한해 월 2회, 건당 최대 1만원 할인) 반디앤루니스 우리V카드 결제금액 10% 청구할인 포인트결제
OK캐쉬백 포인트 최소 10원부터 전액 사용 or 1% 적립 현대카드 M포인트 결제금액의 최대 10% 사용 가능 신한카드 포인트 결제금액의 최대 10% 사용 가능(일부카드) 하나(구.외환) 포인트 보유 한도 내에서 100% 사용 가능 씨티카드 포인트 결제금액의 최대 50% 사용 가능 할인카드
NH농협 TAKE5카드 20% 청구할인(Edu Pack) 채움 플래티늄 멀티카드 20% 청구할인 모바일 Tmoney 신한카드 10% 청구할인 신한카드 Shopping 10% 청구할인 NH농협 체크카드 10% 청구할인 NH20 해봄 신용카드 10% 청구할인 씨티 클리어 카드 7% 청구할인 NH20 해봄 체크카드 5% 청구할인 NH농협 LADY다솜카드 5% 청구할인 신한카드 큐브 5% 청구할인 신한카드 큐브 PLATINUM# 5% 청구할인 
무이자 안내
-
적립금1,500원 적립 [5%P]
추가 적립금 안내
[2천원 추가 적립]
총 주문금액 5만원 이상 구매 시 2,000원 추가 적립
도서(eBook포함)만 구매 시 적립 대상에서 제외업채배송상품 포함(기프트, 업체배송 등) 5만원[멤버십 추가 적립]
슈퍼루니 : 3% 추가 적립
골드루니 : 2% 추가 적립
실버루니 : 1% 추가 적립
단, 국내도서, eBook만 구매 시 적립 불가
-
배송료무료배송
-
출고예상일2026년 06월 12일 이후
※ 출고예정일은 도서 재고상황에 따라 변동될 수 있습니다.
당일배송 가능지역 검색
“도로명주소”를 쉽게 찾아보세요
1. 도로명으로 검색하기 (예, “직지길” or “직지길+322”)
2. 건물명으로 검색하기 (예, “반디앤루니스빌딩”)
3. 동(읍/면/리) 으로 검색 (예, “인사동” or “인사동+43”)
4. 도로명주소를 모르실 경우 도로명주소 안내시스템(http://www.juso.go.kr)에서 확인해주세요.
시/도
시/군/구
회원리뷰
ISBN: 9791175790599
304쪽
578g
183 x 235 (㎜)
지금 이책은
- 판매지수 : 0
이 분야의 베스트셀러
-
처음 만나는 인공지능 [개정판]
김대수
26,000원
-
비전공자를 위한 이해할 수 있는 IT 지식
최원영
15,120원
-
컴퓨팅 사고 Level Up 소프트 파워 with 스크래치
김호다, 이지민, 정영철 외
20,700원
이 책이 속한 분야
책 소개
이 책은
단일 에이전트 대신 '에이전트 팀'을 설계하라
클로드 코드로 구축하는 최초의 하네스 실전 가이드
AI 에이전트를 도구로 쓰는 단계를 넘어, 스스로 일하는 에이전트 팀을 직접 설계하고 운영하는 방법인 하네스 엔지니어링을 체계적으로 정리한 최초의 실전서다. 이 책의 저자이자, 카카오의 AI 리더 황민호(로빈 황)가 공개한 하네스 관련 오픈소스 자료는 깃허브에서 3천 개 이상의 별(star)을 받으며 이미 개발자 커뮤니티의 주목을 받은 바 있다.
하네스란 모델의 가중치를 건드리지 않고, 모델 바깥에 권한·도구·검증·관측을 설계해 에이전트가 혼자 움직이게 만드는 환경이다. 단일 에이전트의 구조적 한계부터, 에이전트 · 스킬 · 오케스트레이터라는 하네스 세 기둥의 설계 원칙, 스킬이 스킬을 만드는 메타스킬과 여섯 가지 아키텍처 패턴, 코드 리뷰·풀스택 구현·레거시 마이그레이션·디버깅 팀의 실전 사례까지 마크다운 파일을 직접 만들어 보며 익힐 수 있도록 설계되었다. 프롬프트 엔지니어링이나 모델 내부 지식 없이도, git과 마크다운 파일만 다룰 수 있다면 충분하다.
출판사 리뷰
"모델이 아니라 하네스가 결과를 결정한다"
카카오 AI 리더가 직접 검증한 AI 에이전트 팀 설계 바이블
클로드 코드, 커서 같은 AI 코딩 도구가 일상이 된 지금, 실무 개발자들이 겪는 가장 큰 문제는 따로 있다. 단일 에이전트는 자기 실수를 잘 보지 못한다는 것이다. 2025년 7월 한 기업에서 벌어진 프로덕션 데이터 삭제 사고(에이전트가 임원 레코드를 지우고 "복구 불가"라고 거짓 보고했던 사건)는 우리에게도 먼 이야기가 아니다. 혼자 쓴 PR을 혼자 머지하는 구조가 AI 에이전트의 기본값이기 때문이다. 이 책은 그 구조적 한계를 정면으로 다루며, 해법으로 하네스 엔지니어링을 제시한다.
저자 황민호는 카카오에서 AI 개발 생산성을 담당하며 수십 개 도메인에 하네스를 직접 적용해온 개발자다. 그가 직접 수행한 A/B 실험에서 같은 클로드 모델이 '.claude/' 구성 차이만으로 49.5점에서 79.3점으로 뛰어올랐다. "모델이 아니라 하네스가 결과를 결정한다"라는 이 책의 핵심 명제가 단순한 선언이 아니라 실제 데이터임을 보여주는 기록이다.
Part 1 | 하네스란 무엇인가
단일 AI 에이전트는 왜 믿을 수 없는지 그 이유부터 짚어보고, 하네스의 정의와 핵심 원리를 정리한다. 이어서 30분 안에 굴러가는 가장 작은 에이전트 팀을 빈 디렉토리에서 직접 만들어본다.
Part 2 | 하네스 구성하기 - 에이전트 · 스킬 · 오케스트레이터
하네스를 이루는 세 기둥을 자세하게 다룬다. 에이전트는 역할과 가드레일을 어떻게 정의하는지, 스킬은 description 한 줄로 호출 여부를 어떻게 결정하는지, 오케스트레이터는 TeamCreate·TaskCreate·SendMessage로 리더 병목을 어떻게 해소하는지 순서대로 익힌다. 개념 설명에 그치지 않고 이 파트를 끝내면 직접 팀을 구성할 수 있는 수준이 된다.
Part 3 | 하네스 스킬로 구성하기
Part 2에서 수행한 팀 구성 과정을 자동화하는 메타스킬을 다룬다. 스킬이 스킬을 만든다는 관점 전환과 6단계 파이프라인, 파이프라인·허브앤스포크·프로듀서-리뷰어 등 여섯 가지 아키텍처 패턴을 실제 선택 기준과 함께 펼친다. 팀·서브에이전트·하이브리드 실행 모드 선택, 세션이 바뀌어도 자동 트리거되는 CLAUDE.md 포인터 설정, 구성 불일치(drift) 감지까지, 설계에서 운영까지 한 흐름으로 이어진다.
Part 4 | 하네스 실전편
코드 리뷰 자동화, 풀스택 기능 구현, 레거시 마이그레이션, 디버깅/RCA라는 네 개의 실전 팀을 시나리오→팀 구성→워크플로→핵심 파일 전문→실행 결과→변형 가이드→안티패턴 순서로 낱낱이 공개한다. Airbnb가 3,500개의 React 테스트를 6주 만에 이전한 사례, OpenAI가 5개월간 100만 줄을 생성하며 수동 코드 0줄을 유지한 사례도 여기에 담겼다. 이 파트를 읽고 나면 각자의 도메인에 맞는 하네스를 처음부터 설계하는 데 필요한 판단 기준을 파악하게 될 것이다.
이 책의 대상 독자
● 하네스라는 단어를 들어봤지만 막상 시작하지 못한 개발자
● 클로드 코드 같은 AI 도구를 쓰고 있지만 단일 에이전트의 한계에서 벗어나지 못한 개발자
● AI를 혼자 잘 쓰는 단계를 지나 팀이나 조직에 도입을 시도하는 리드 개발자
저자 소개
현재 카카오에서 AI 개발 생산성 관련 업무를 담당하고 있는 개발자입니다. 실무에서 AI 에이전트 하네스를 설계·운영하며, 같은 모델이 환경에 따라 전혀 다른 결과를 내는 과정을 직접 관측해 왔습니다. 깃허브에서 오픈소스 활동을 활발히 이어가며 하네스 관련 메타스킬, 에이전트 템플릿, 스킬 템플릿을 공개하고 갱신하고 있습니다. 이 책에 수록된 템플릿 다수도 해당 저장소에서 비롯된 것들입니다.
'AI 에이전트가 일하는 환경을 어떻게 설계해야 개인과 조직 모두의 생산성이 무너지지 않고 쌓이는가'를 핵심 화두로 삼고 있습니다. 모델 성능이 매번 새로운 기록을 세우는 시대에도, 최종 결과를 결정하는 것은 모델 자체가 아니라 그것을 감싸는 하네스라는 신념을 갖고 있습니다.
목차
[ Part 01 하네스란 무엇인가 ]
Chapter 01 왜 하네스인가
_스스로 데이터를 지운 단일 에이전트
_혼자 일하는 AI는 자기 실수를 못 본다
_모델의 환경을 바꿨을 때 일어난 일들
_병목은 능력이 아니라 구조다
_하네스 = around the model
_하네스에 대한 세 가지 오해
Chapter 02 30분 Quick Start
_[Step 1] 같은 프롬프트, 다른 산출물
_[Step 2] 30분 안에 2인 팀 만들기
_자주 틀리는 세 가지
[ Part 02 하네스 구성하기 - 에이전트·스킬·오케스트레이터 ]
Chapter 03 에이전트·스킬·오케스트레이터의 책임 분리
_2인 팀을 분해해보자
_한 파일에 다 넣으면 무엇이 깨지는가
_세 기둥, 세 질문
_세 기둥은 어떻게 맞물리는가
_세 기둥이 섞이면 생기는 문제
Chapter 04 에이전트를 정의한다는 것
_어제 잘 굴러가던 팀이 오늘 아침 사라지는 이유
_본문 7개 섹션 - 왜 필요하고 어떻게 쓰는가
_가드레일 - 에이전트가 할 수 없는 것을 파일로 정하기
_프론트매터 다섯 필드와 16개 공식 필드
_실전 파일 전체 읽기 - copy-editor.md
_책 집필 하네스의 7가지 에이전트 관계도
_안티패턴
Chapter 05 스킬 설계의 기술
_스킬을 썼는데 왜 호출이 안 될까
_원리 1 - Description이 호출을 결정한다
_원리 2 - Progressive Disclosure 3단계
_원리 3 - Why-First 원칙
_실물 파일 읽기 - book-writer/SKILL.md
_구현 - book-writer 스킬을 펼치다
_스킬 검증 - With/Without 비교
_안티패턴
Chapter 06 오케스트레이터
_리더는 이벤트 루프, 팀원은 피어
_세 가지 기본 도구 - 팀을 데이터 전달 방식으로 보기
_TeamCreate - 팀은 상수가 아니라 세션 객체
_TaskCreate - 공유 작업 큐와 depends_on
_SendMessage - 리더를 거치지 않는 peer-to-peer 채널
_에이전트 파일의 팀 통신 프로토콜 섹션
_리더의 역할
_데이터 흐름
_실전 예제 - PR 리뷰 오케스트레이터 SKILL.md
_292개 에이전트 사건
_TeamDelete와 정리 - 세션당 한 팀, shutdown 필수
_언제 팀 프리미티브를 도입할까
_관측과 경계면 - 팀을 바깥에서 보기
_안티패턴
[ Part 03 하네스 스킬로 구성하기 ]
Chapter 07 메타 하네스 스킬과 6단계 파이프라인
_여섯 번째 팀을 만들던 날
_메타스킬이란 무엇인가
_메타스킬이 여는 6단계 파이프라인
_Phase 1. 도메인 분석 - 질문을 정제하는 단계
_Phase 2. 팀 아키텍처 설계
_Phase 3·4. 에이전트와 스킬 - 파일이 없으면 존재하지 않는다
_Phase 5. 오케스트레이션
_Phase 6. 검증
_Phase 0·7 - 순환 구조와 Meta-Harness 루프
_안전장치 - 메타스킬도 폭주할 수 있다
_안티패턴
Chapter 08 6가지 아키텍처 패턴
_팀에는 모양이 있다
_에이전트를 몇 명으로 쪼갤 것인가
_패턴 1. 파이프라인 - 순서가 의미를 만든다
_패턴 2. 팬아웃·팬인 - 같은 입력, 다른 관점
_패턴 3. 전문가 풀 - 라우터 + 전문가
_패턴 4. 생성-검증 - 만들고 검사하고 다시 만든다
_패턴 5. 감독자 - 런타임 동적 분배
_패턴 6. 계층적 위임 - 총괄 → 팀장 → 실무자
_복합 패턴은 실전의 기본값
_패턴 선택 기준 - 플로우차트와 전환 신호
_전통 분산 패턴과의 대응
_안티패턴
Chapter 09 팀 / 서브에이전트 / 하이브리드
_팀을 짤까, 그냥 각자 시킬까
_실행 모드별 트레이드오프
_실행 모드 결정
_아키텍처 패턴과 실행 모드
_구현 - 세 템플릿 골격
_[예시] 제품 런칭 준비 하네스
_안티패턴
Chapter 10 하네스 등록과 진화
_하네스는 진화하는 생명체다
_포인터는 4줄, 시스템은 4층
_하네스 등록 - CLAUDE.md 템플릿과 실전용 변형
_진화의 두 관문 - Phase 0 현황 감사와 7-5 운영 루프
_피드백 반영과 변경 이력 - drift를 방지하는 물리적 증거
_재실행과 부분 재실행
_심화 - ADR과 Build to Delete
_안티패턴
_하네스 등록과 진화 통합 체크리스트
[ Part 04 하네스 실전편 ]
Chapter 11 코드 리뷰 자동화 팀
_시나리오 - PR 리뷰
_팀 구성
_워크플로
_핵심 파일 훑어보기
_실행 결과
Chapter 12 풀스택 기능 구현 팀
_시나리오 - 로그인 기능 추가
_팀 구성
_워크플로
_핵심 파일 훑어보기
_실행 결과
_응용 가이드
Chapter 13 레거시 마이그레이션 팀
_시나리오 - 3,500개의 레거시 테스트 파일
_팀 구성
_워크플로
_핵심 파일 훑어보기
_응용 가이드
Chapter 14 디버깅 / RCA 팀
_시나리오 - "로컬에선 잘 되는데요"
_팀 구성
_워크플로
_핵심 파일 훑어보기
_응용 가이드
[맺음말] 스케일별 하네스 진화
[부록 A] 설치·환경 설정
[부록 B] 안티패턴 카탈로그 + 도구 설계 패턴
[부록 C] 트러블슈팅 - 자주 막히는 실패 패턴 20선
[부록 D] 토큰 경제와 레퍼런스 아키텍처
Chapter 01 왜 하네스인가
_스스로 데이터를 지운 단일 에이전트
_혼자 일하는 AI는 자기 실수를 못 본다
_모델의 환경을 바꿨을 때 일어난 일들
_병목은 능력이 아니라 구조다
_하네스 = around the model
_하네스에 대한 세 가지 오해
Chapter 02 30분 Quick Start
_[Step 1] 같은 프롬프트, 다른 산출물
_[Step 2] 30분 안에 2인 팀 만들기
_자주 틀리는 세 가지
[ Part 02 하네스 구성하기 - 에이전트·스킬·오케스트레이터 ]
Chapter 03 에이전트·스킬·오케스트레이터의 책임 분리
_2인 팀을 분해해보자
_한 파일에 다 넣으면 무엇이 깨지는가
_세 기둥, 세 질문
_세 기둥은 어떻게 맞물리는가
_세 기둥이 섞이면 생기는 문제
Chapter 04 에이전트를 정의한다는 것
_어제 잘 굴러가던 팀이 오늘 아침 사라지는 이유
_본문 7개 섹션 - 왜 필요하고 어떻게 쓰는가
_가드레일 - 에이전트가 할 수 없는 것을 파일로 정하기
_프론트매터 다섯 필드와 16개 공식 필드
_실전 파일 전체 읽기 - copy-editor.md
_책 집필 하네스의 7가지 에이전트 관계도
_안티패턴
Chapter 05 스킬 설계의 기술
_스킬을 썼는데 왜 호출이 안 될까
_원리 1 - Description이 호출을 결정한다
_원리 2 - Progressive Disclosure 3단계
_원리 3 - Why-First 원칙
_실물 파일 읽기 - book-writer/SKILL.md
_구현 - book-writer 스킬을 펼치다
_스킬 검증 - With/Without 비교
_안티패턴
Chapter 06 오케스트레이터
_리더는 이벤트 루프, 팀원은 피어
_세 가지 기본 도구 - 팀을 데이터 전달 방식으로 보기
_TeamCreate - 팀은 상수가 아니라 세션 객체
_TaskCreate - 공유 작업 큐와 depends_on
_SendMessage - 리더를 거치지 않는 peer-to-peer 채널
_에이전트 파일의 팀 통신 프로토콜 섹션
_리더의 역할
_데이터 흐름
_실전 예제 - PR 리뷰 오케스트레이터 SKILL.md
_292개 에이전트 사건
_TeamDelete와 정리 - 세션당 한 팀, shutdown 필수
_언제 팀 프리미티브를 도입할까
_관측과 경계면 - 팀을 바깥에서 보기
_안티패턴
[ Part 03 하네스 스킬로 구성하기 ]
Chapter 07 메타 하네스 스킬과 6단계 파이프라인
_여섯 번째 팀을 만들던 날
_메타스킬이란 무엇인가
_메타스킬이 여는 6단계 파이프라인
_Phase 1. 도메인 분석 - 질문을 정제하는 단계
_Phase 2. 팀 아키텍처 설계
_Phase 3·4. 에이전트와 스킬 - 파일이 없으면 존재하지 않는다
_Phase 5. 오케스트레이션
_Phase 6. 검증
_Phase 0·7 - 순환 구조와 Meta-Harness 루프
_안전장치 - 메타스킬도 폭주할 수 있다
_안티패턴
Chapter 08 6가지 아키텍처 패턴
_팀에는 모양이 있다
_에이전트를 몇 명으로 쪼갤 것인가
_패턴 1. 파이프라인 - 순서가 의미를 만든다
_패턴 2. 팬아웃·팬인 - 같은 입력, 다른 관점
_패턴 3. 전문가 풀 - 라우터 + 전문가
_패턴 4. 생성-검증 - 만들고 검사하고 다시 만든다
_패턴 5. 감독자 - 런타임 동적 분배
_패턴 6. 계층적 위임 - 총괄 → 팀장 → 실무자
_복합 패턴은 실전의 기본값
_패턴 선택 기준 - 플로우차트와 전환 신호
_전통 분산 패턴과의 대응
_안티패턴
Chapter 09 팀 / 서브에이전트 / 하이브리드
_팀을 짤까, 그냥 각자 시킬까
_실행 모드별 트레이드오프
_실행 모드 결정
_아키텍처 패턴과 실행 모드
_구현 - 세 템플릿 골격
_[예시] 제품 런칭 준비 하네스
_안티패턴
Chapter 10 하네스 등록과 진화
_하네스는 진화하는 생명체다
_포인터는 4줄, 시스템은 4층
_하네스 등록 - CLAUDE.md 템플릿과 실전용 변형
_진화의 두 관문 - Phase 0 현황 감사와 7-5 운영 루프
_피드백 반영과 변경 이력 - drift를 방지하는 물리적 증거
_재실행과 부분 재실행
_심화 - ADR과 Build to Delete
_안티패턴
_하네스 등록과 진화 통합 체크리스트
[ Part 04 하네스 실전편 ]
Chapter 11 코드 리뷰 자동화 팀
_시나리오 - PR 리뷰
_팀 구성
_워크플로
_핵심 파일 훑어보기
_실행 결과
Chapter 12 풀스택 기능 구현 팀
_시나리오 - 로그인 기능 추가
_팀 구성
_워크플로
_핵심 파일 훑어보기
_실행 결과
_응용 가이드
Chapter 13 레거시 마이그레이션 팀
_시나리오 - 3,500개의 레거시 테스트 파일
_팀 구성
_워크플로
_핵심 파일 훑어보기
_응용 가이드
Chapter 14 디버깅 / RCA 팀
_시나리오 - "로컬에선 잘 되는데요"
_팀 구성
_워크플로
_핵심 파일 훑어보기
_응용 가이드
[맺음말] 스케일별 하네스 진화
[부록 A] 설치·환경 설정
[부록 B] 안티패턴 카탈로그 + 도구 설계 패턴
[부록 C] 트러블슈팅 - 자주 막히는 실패 패턴 20선
[부록 D] 토큰 경제와 레퍼런스 아키텍처
배송 시 유의사항
- 반디앤루니스에서 구매하신 도서는 물류 대행 위탁업체 웅진 북센을 통해 배송됩니다.
(배송 포장에 "웅진 북센"으로 표기될 수 있습니다.)
- 구매한 상품의 품질과 배송 관련 문의는 반디앤루니스로 문의 바랍니다.
- 천재지변 및 택배사의 사정에 따라 배송이 지연될 수 있습니다.
- 결제(입금) 완료 후 출판사 및 유통사의 사정으로 품절 또는 절판 되어 상품 구입이 어려울 수 있습니다. (별도 안내 예정)
- 도서산간지역의 경우 추가 배송비가 발생될 수 있습니다.
반품/교환
상품 설명에 반품/ 교환 관련한 안내가 있는 경우 그 내용을 우선으로 합니다. (업체 사정에 따라 달라질 수 있습니다)
반품/교환
-
반품/교환 반품/교환 방법 홈 > 고객센터 > 자주찾는질문 “반품/교환/환불” 안내 참고 또는 1:1상담게시판 반품/교환 가능 기간 반품,교환은 배송완료 후 7일 이내, 상품의 결함 및 계약내용과 다를 경우 문제발견 후 30일 이내에 신청가능 반품/교환 비용 변심 혹은 구매착오의 경우에만 반송료 고객 부담(별도 지정 택배사 없음) 반품/교환 불가 사유 - 소비자의 책임 사유로 상품 등이 손실 또는 훼손된 경우
- 소비자의 사용, 포장 개봉에 의해 상품 등의 가치가 현저히 감소한 경우
- 복제가 가능한 상품 등의 포장을 훼손한 경우 : 예)만화책, 잡지, 화보집 등
- 시간의 경과에 의해 재판매가 곤란한 정도로 가치가 현저히 감소한 경우
- 전자상거래등에서의 소비자보호에 관한 법률이 정하는 소비자 청약철회 제한 내용에 해당되는 경우
- 해외주문 상품(해외 원서)의 경우(파본/훼손/오발송 상품을 제외)
소비자 피해보상
환불지연에 따른 배상- 상품의 불량에 의한 반품, 교환, A/S, 환불, 품질보증 및 피해보상 등에 관한 사항은
소비자 분쟁해결 기준(공정거래위원회고시)에 준하여 처리됨 - 대금 환불 및 환불지연에 따른 배상금 지급 조건, 절차 등은 전자상거래 등에서의
소비자 보호에 관한 법률에 따라 처리함
반품/교환 주소 경기도 파주시 문발로 77, 웅진북센(반디앤루니스)
