한빛미디어

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

현시대는 빅데이터와 딥러닝의 급격한 발전으로 AI가 엄청난 발전을 하였으며 현재까지도 계속 발전을 하고 있어 영화 “터미네이터”의 스카이넷이 현실로 실현될 날이 머지않아 보입니다. 이렇게 발전된 AI는 IT계열에서 뿐만 아니라 사무분야, 논문 작성, 소설 작성, 실시간 강의 정리, 농장 관리 같은 스마트팜 등등 모든 분야에서 사용되고 있는 동반자 같은 존재가 되는 추세이며 특히 IT계열 그 중에서도 프로그램 및 게임 개발에서 매우 편리함을 제공하고 있습니다. AI가 발전하기 전까지의 개발은 자신의 아이디어를 실현하기 위해서 사람이 직접 프로그래밍 언어와 전문 기술을 익혀야 하고 그래픽, 사운드 등 타 분야와의 협업을 필요시 했지만 AI가 발전된 현재는 아이디어만 있으면 누구나 프로그램 개발을 하는 1인 개발자가 될 수 있습니다. 오늘은 가장 많이 사용되고 있는 AI 에이전트 중 하나인 클로드 코드와 하네스 엔지니어링을 다뤄보겠습니다.

클로드 코드란 AI 연구 기업 앤트로픽(Anthropic)이 개발한 차세대 대형 언어 모델(LLM)이자 인공지능 어시스턴트로 자연스러운 대화 능력, 고도의 논리적 추론, 코딩 및 텍스트 편집 등 다방면에서 뛰어난 성능을 발휘하여 전 세계적으로 널리 쓰이고 있습니다.

하네스 엔지니어링은 AI 모델에게 단순히 지시를 내리는 것을 넘어, AI가 스스로 올바르게 업무를 수행할 수 있도록 돕는 실행환경과 제어 시스템을 설계하는 기술입니다.

제가 이 책을 선택한 이유는 작성자가 몇달간 다듬어 온 하네스를 만드는 스킬과 그 뒤에 있는 관점, 그리고 실제로 굴려본 하네스 팀들의 경험치를 이 책에  담겨져 있어 초보자들이 좀 더 쉽게 접근할 수 있기 때문입니다.

이 책의 특성은 하네스 엔지니어링 초보자이거나 특정 언어나 프레임워크를 깊이 알아야 할 필요 없어도 터미널에서 Git을 실행하고 마크다운 파일을 편집할 수 있으면 누구나 할 수 있게 책의 내용이 구성되었다는 점 입니다. 이 책 내 예제코드는 타임스크립트와 파이썬을 활용하지만, 어느 쪽이든 패턴만 읽어도 충분히 따라 올 수 있게 구성되어 있습니다.

구성

Part 1: 하네스란 무엇인가

Chapter 1: 왜 하네스인가

Chapter 2: 30분 Quick Start

Part 2: 하네스 구성하기 -- 에이전트 • 스킬 • 오케스트레이터

Chapter 3: 에이전트•스킬•오케스트레이터의 책임 분리

Chapter 4: 에이전트를 정의한다는 것

Chapter 5: 스킬 설계의 기술

Chapter 6: 오케스트레이터

Part 3: 하네스 스킬로 구성하기

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

Chapter 8: 여섯 가지 아키텍쳐 패턴

Chapter 9: 팀/서브에이전트/하이브리드

Chapter 10: 하네스 등록과 진화

Part 4: 하네스 실전편

Chapter 11: 코드 리뷰 자동화 팀

Chapter 12: 풀스택 기능 구현 팁

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

Chapter 14: 디버깅/RCA 팀

Part 5: 부록

Appendix A: 클로드 코드 설치 • 환경 설정

Appendix B: 안티패턴 카탈로그+도구 설계 패턴

Appendix C: 트러블 슈팅 –- 자주 막히는 실패 패턴 20선

Appendix D: 토큰 경제와 레퍼런스 아키텍쳐

파트별로 나누어 봤을때 책에서 나온 대로 파트1인 1~2장은 “왜 하네스인가”를 납득시키는 파트로 단일 에이전트가 자기 실수를 잘 보지 못 하는 문제를 짚은 후 하네스를 정의하고, 이어서 30분 안에 굴려가는 가장 작은 팁을 실제로 만드는 방법에 대해, 파트2인 3~6장은 에이전트•스킬•오케스트레이터 세 기둥을 각자의 장에서 따로 다루며 세 기둥의 책임 분리, 에이전트 정의 템플릿과 가드레임, description이 호출 여부를 결정한다는 원칙과 스킬 검증, TeamCreate•TaskCreate•SendMessage로 리더 병복을 깨는 방법과 관측•경계면에 대해, 파트3인 7~10장은 2부의 단계를 자동화하는 메타스킬을 다루며 7,8장은 설계의 골격으로 스킬이 스킬을 만든다는 관점 전환과 6단계 파이프라인, 그리고 여섯가지 아키텍쳐를 안내하며 9,10장은 운영의 골격으로 팀/서브/하이브리드 실행 보드 선택과 새 세션에서도 자동 트리거되게 하는 CLAUDE.md 포인터•구성 불일치 감지로 하네스를 유지하는 법에 대해, 파트4인 11~14장은 코드 리뷰 자동화 팀, 풀스택 기능 구현 팀, 레거시 마이그레이션 팀, 디버깅/RCA 팀 등 4개의 도메인 사례를 넣어서 각 장은 시나리오 → 팀 구성 → 워크플로 → 핵심 파일 훑어보기 → 실행 결과(생략 가능) → 응용 가이드 → 주의사항의 일곱세션으로 구성되어 있으며 그 중 하나의 사례가 OpenAI가 5개월동안 100만줄을 생성하면서 수동 코드 0줄을 유지한 사례 등에 대해, 부록은 A는 클로드 코드의 설치와 환경 설정, B는 안티패턴 카탈로그, C는 트러블슈팅 20선, D는 토큰 경제와 레퍼런스 아키텍쳐에 대해 설명하고 있습니다.

​ 

개인적인 생각으로 학습은 하네스 엔지니어링 초보자, 개발자로 취업 희망하는 분 및 하네스 엔지니어로 이직을 희망하시는 분들은 1장부터, 개발자(2년차~)분들께서는 2장부터 학습하시는 것이 좋을 것 같습니다.​

개인적으로 약간의 단점이 어쩌면 욕심일수도 있는게 좀더 많은 실습 예제 및 비즈니스 케이스가 담겨있으면 더 좋았지 않았을까라는 아쉬움이 있습니다.

​
 

저의 리뷰를 읽어주셔서 감사합니다. 다음에는 좀더 유용하고 좋은 책으로 더 나은 리뷰를 통해 여러분께 책을 소개시켜 드릴 수 있도록 더 노력하겠습니다.

​

감사합니다.​​

도서 링크: https://www.hanbit.co.kr/store/books/look.php?p_code=B2817272480