[전자책] 에이전틱 코딩 완성의 기술 - 클로드 코드와 하네스로 AI 코딩의 모든 과정을 설계하고 검증하는 법
김플립 지음 / 한빛미디어 / 2026년 10월
평점 :
장바구니담기


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



AI에게 코드를 부탁하면 빠르게 결과가 나온다. 그런데 기능을 하나씩 더하다 보면 처음 의도와 멀어지고, 방금 고친 오류가 다시 나타나기도 한다. 코드를 만드는 일은 쉬워졌는데, 그 결과를 믿고 사용해도 되는지 판단하는 일은 여전히 어렵다.

이 책은 그 질문에서 출발한다.

'프롬프트를 고치는 방식’과 ‘작업 구조를 고치는 방식’을 나란히 보여주는 그림을 한동안 뚫어져라 쳐다본다.


page 63. 이 책이 무엇을 말하고 싶은지 한 번에 보인다.


오류가 날 때마다 AI에게 다시 말해 고치는 일은 당장의 문제를 해결할 수 있다. 하지만 비슷한 실수가 반복된다면, 지시문만 손볼 게 아니라 계획과 검증 절차를 함께 바꿔야 한다. 이 차이를 보고 나니 AI 코딩의 결과는 한 번의 답변보다 일을 맡기는 과정에 달렸다는 생각이 들었다.


책에서 말하는 하네스는 AI가 일할 수 있도록 둘러싼 작업 환경과 규칙이다. 프롬프트만 잘 쓰는 요령에 머물지 않는다.

작업 지침을 문서로 남기고, 도구와 실행 환경을 정하고, 테스트로 결과를 확인하는 과정까지 포함한다.

AI가 무엇을 할지 정하는 것만큼, 무엇을 하면 안 되는지와 어디서 사람의 확인을 받을지도 설계한다.

이 책을 읽으며 AI에게 일을 맡기는 장면이 조금 달리 보였다.


필요한 건 더 길고 자세한 요청문이 아니라, AI가 참고할 기준과 결과를 확인할 방법일 수 있다.

계획을 세우고, 작은 단위로 구현하고, 테스트를 돌리고, 실패한 이유를 다시 전달하는 흐름은 알게 되었다.


1부는 바이브 코딩의 편리함과 한계를 짚고...



2부는 계획·기록·검증으로 작업을 통제하는 방법을 설명한다.



3부에서는 Claude Code의 모드와 에이전트, 스킬, 훅, MCP 같은 기능을 실제 작업에 연결한다.

개념을 소개하는 데서 그치지 않고, 프로젝트 지침과 작업 계획을 어디에 기록할지, 테스트 실패를 어떤 흐름으로 다룰지 보여주는 점이 구체적이라 좋았다.



4부, 앞에서 익힌 작업 방식을 실제 서비스 완성(실습)으로 이어간다.

계획과 검증 절차를 세우는 데서 멈추지 않고, AI와 함께 만든 결과물을 어떻게 작동하는 서비스로 마무리할지 다룬다는 점에서 책의 흐름이 완성된다.


책의 실습을 따라서 만든건 아니지만, 최근 여러 하네스 관련책들을고, 따라해보면서..

이 책에서 작가가 이야기 하고 싶은 내용에 공감하고 있다.

스스로도 에이전틱 코딩, 하네스 엔지니어링에 대한 책을 읽기 전/후가 완전히 달라졌음을 느낀다.


실제 계획·기록·검증하는 방법으로 처음 사이트를 Vercel에 배포해 보았다. 클로드가 실제 코드를 작성한 시간은 계획하고 검증하는 시간의 1/10 도 안되었던거 같다.

이제 이 책에 대한 생각을 정리해 본다.

최근 AI의 관련된 책을 보면.. 질문의 기술에서 작업장, 즉 계획과 통제라는 측면에서 많은 책들이 이야기한다.

OpenAI도 에이전트가 코드를 맡게 되면서 사람의 일이 코드 작성에서 작업 환경 설계, 의도 전달, 피드백 루프 구축으로 이동한다고 설명하고, Anthropic의 Claude Code 사용 연구에서도 활용 방식으로 코드 작성뿐 아니라 수정, 테스트, 에이전트 조율이 함께 다루고 있다.


프롬프트의 중요성이 사라진다기보다는, 프롬프트가 작업 전체에서 맡는 자리가 달라진다고 생각된다. 목표와 완료 기준을 말로 분명히 전달하는 건 여전히 중요하지만, 그 말만으로 작업이 끝나지는 않는다. AI가 참고할 맥락을 준비하고, 쓸 도구와 권한을 정하고, 결과를 검사할 방법까지 갖춰야 한다.


이 책을 한 문장으로 말하면, AI에게 코드를 맡기는 기술보다 AI의 결과를 끝까지 확인하는 기술을 알려주는 책이다.


AI 코딩 도구를 쓰면서 같은 오류를 되풀이해 고치고 있는 사람, 작은 실험을 실제 프로젝트로 키우고 싶은 사람에게 권하고 싶다. 코드 생성부터 먼저 익히고 싶은 입문자라면 초반의 용어와 작업 체계가 다소 버거울 수 있을 것도 같다.


왜 에이전틱 코딩이라고 했을까? 스스로 답을 내어본다.

‘에이전틱 코딩’이란, AI에게 코드를 한 번 생성시키는 것보다, AI가 개발 작업을 이어서 수행하도록 설계하고 관리하는 코딩 방식을 전하고 싶었던 거 같다.

다음에 AI에게 코드를 맡길 때는 먼저 “어떤 결과면 끝났다고 할까?”부터 적어두려 한다.



댓글(0) 먼댓글(0) 좋아요(0)
좋아요
l 공유하기 l 북마크하기찜하기 lthankstoThanksTo