이전

리뷰 (2)

한줄평
평점 분포
  • 리뷰 총점10 100%
  • 리뷰 총점8 0%
  • 리뷰 총점6 0%
  • 리뷰 총점4 0%
  • 리뷰 총점2 0%
연령대별 평균 점수
  • 10대 0.0
  • 20대 0.0
  • 30대 0.0
  • 40대 10.0
  • 50대 10.0

포토/동영상 (2)

리뷰 총점 종이책
AI가 방금 고친 버그를 또 만든다면, 프롬프트보다 ‘작업 환경’을 돌아봐야 합니다 - 『에이전틱 코딩 완성의 기술』을 읽고 운영 중인 서비스에 적용해 본 기록
"AI가 방금 고친 버그를 또 만든다면, 프롬프트보다 ‘작업 환경’을 돌아봐야 합니다 - 『에이전틱 코딩 완성의 기술』을 읽고 운영 중인 서비스에 적용해 본 기록" 내용보기
한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다.AI가 방금 고친 버그를 또 만들었습니다.AI 코딩 에이전트를 처음 썼을 때는 편리했습니다. 반복해서 작성하던 기본 코드는 몇 초 만에 나왔고, 에러 로그를 보여주면 원인도 짚어주었습니다. 그런데 프로젝트가 커지면서 문제가 생기기 시작했습니다.운영 중인 서비스의 목록 API에 검색 필터 하나를
"AI가 방금 고친 버그를 또 만든다면, 프롬프트보다 ‘작업 환경’을 돌아봐야 합니다 - 『에이전틱 코딩 완성의 기술』을 읽고 운영 중인 서비스에 적용해 본 기록" 내용보기


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

AI가 방금 고친 버그를 또 만들었습니다.

AI 코딩 에이전트를 처음 썼을 때는 편리했습니다. 반복해서 작성하던 기본 코드는 몇 초 만에 나왔고, 에러 로그를 보여주면 원인도 짚어주었습니다. 그런데 프로젝트가 커지면서 문제가 생기기 시작했습니다.

운영 중인 서비스의 목록 API에 검색 필터 하나를 추가해 달라고 했더니, 잘 작동하던 인증 미들웨어와 공용 설정 파일까지 수정했습니다. 10분 전에 고친 버그가 다음 요청에 다시 나타나기도 했습니다. AI가 코드를 작성하며 아껴준 시간보다 뒷수습하는 시간이 길어지기도 했습니다.

프롬프트를 더 자세히 써야 할까요. 아니면 일을 맡기는 방식부터 바꿔야 할까요. 그 답이 『에이전틱 코딩 완성의 기술』에 담겨 있습니다.


도구 사용법보다 작업 방식을 다루는 책

처음에는 클로드 코드 CLI 사용법을 다룬 책이라고 생각했습니다. 하지만 실제로는 AI 에이전트와 어떻게 협업할지 다루는 책이었습니다. 1부에서는 요청과 응답을 반복하는 방식의 한계를 짚고, 2부에서는 하네스 엔지니어링과 작업 환경 설계를 설명합니다. 3부는 이를 클로드 코드로 옮기는 방법을, 4부는 서비스 구현과 기존 시스템 확장 실습을 다룹니다.

특정 제품에만 적용되는 원칙이 아니라는 점이 좋았습니다. 규칙 문서와 계획 파일, 테스트, 훅을 활용하는 방식은 다른 에이전트에도 적용할 수 있습니다.

사진2.png


프롬프트보다 중요한 것은 '하네스'였습니다.

책은 프롬프트의 역할을 과장하지 않습니다. 프롬프트는 지도가 아니라 메모라고 서명합니다. "보안도 챙겨줘"라는 요청은 필요하지만, 그 한마디로 권한 검사가 구현되는 것은 아닙니다. 저자는 결과물의 품질을 '모델 x 작업 방식 x 검증 구조 x 맥락'의 곱으로 설명합니다. 작업 방식이 갖춰지지 않으면 성능 좋은 모델도 오히려 위험을 키울 수 있다는 뜻입니다.

여기서 등장하는 개념이 '하네스(Harness)'입니다. 모델을 제외하고 AI가 일하는 데 필요한 환경 전반을 뜻합니다. 작업 방향을 안내하는 Guides(문서·규칙·계획)와 결과를 확인하는 Sensors(타입 검삭·린트·테스트)로 이루어집니다.

책에서 소개하는 앤트로픽의 실험도 이 차이를 보여줍니다. 같은 모델과 프롬프트를 사용했지만, 하네스 없이 20분 동안 9달러를 들여 만든 결과물은 실패했습니다. 반면 Planner · Generator · Evaluator를 붙인 쪽은 6시간 동안 200달러를 들여 작동하는 게임을 만들었습니다. 모델을 바꾸지 않고도 작업 구조에 따라 결과가 달라진 사례입니다.

사진3.png


운영 중인 서비스에 4단계 작업 흐름을 적용해 봤습니다.

대상은 제가 만드는 'CPP System Workbench'입니다. C++ 시스템 프로그래밍을 4분할 화면에서 직접 빌드·실행하며 배우는 로컬 학습 도구입니다. React/Type 화면, Node.js 서버, CMake C++ 챕터로 이루어져 있습니다.

개선 저에는 '정답과 내 코드'를 비교하는 기능이 없었습니다. 학습자가 solution/ 을 직접 열어야 했고, 내부 마커(@TODO_BEGIN 등)까지 화면에 드러났습니다. 첫 스프린트 회고에 남아 있던 문제였습니다.

책의 research.md, PLAN.md 자리에는 스프린트 절차서와 백로그를 두었습니다. 구현을 미루고 구조를 먼저 정리하다가, solution/ 이 초기화의 유일한 원본이라 마커를 지우면 안 된다는 점과 extractSkeletonFromSolution() 이 이미 있다는 점을 찾았습니다. 그래서 마커는 파일에 두고 읽기 API에서 정제하기로 했습니다.


책에 남긴 밑줄: "구현은 지루해야 한다"

4장의 "구현은 지루해야 한다"라는 문장이 가장 오래 남았습니다. 구현 중에 계속 새로운 판단을 내려야 한다면 설계가 충분하지 않았다는 뜻으로 이해를 했습니다. 가장 재미없던 계획 시간이 가장 편한 구현 시간을 만들었습니다.

13장의 "생각은 맡겨도, 이해는 맡길 수 없다"라는 문장도 기억에 남았습니다. AI가 빌드에 성공했다고 보고해도 그것만으로 작업이 끝난 것은 아닙니다. 책에서는 완료 여부를 판단할 때 기본값을 FAIL로 두라고 말합니다. 증거가 없다면 통과로 보지 말라는 뜻입니다.

사진5.png


이런 개발자에게 추천합니다.

  • 프롬프트를 길게 써도 AI가 기존 코드를 망가뜨려 답답하셨던 분

  • 운영 중인 코드 베이스에 AI를 투입하려는 실무자

  • 바이브 코딩의 결과를 팀에 병합할 자신이 없는 분


마무리: AI에게 코드를 맡기는 것과 개발하는 것은 다릅니다.

모델은 앞으로도 더 똑똑해질 것입니다. 그렇다고 개발자의 작업 방식까지 저절로 나아지는 것은 아닙니다. 이 책을 일고 남은 것은 프롬프트 몇 줄이 아니라, AI의 작업 방향을 잡고 검증할 수 있는 환경을 설계하는 습관이었습니다.


에이전틱 코딩 완성의 기술 - 한빛+


#한빛미디어 #한빛플러스 #나는리뷰어다 #에이전틱코딩완성의기술 #김플립 #하네스엔지니어링 #클로드코드 #AI코딩



m*****l 2026.11.18. 신고 공감 0 댓글 0
리뷰 총점 종이책
에이전틱 코딩 완성의 기술로 바이브코딩을 다시 시작한다
"에이전틱 코딩 완성의 기술로 바이브코딩을 다시 시작한다" 내용보기
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다."유튜브만 찾아보고 맥락 없이 바이브코딩을 하던 내게 체계를 알려준 책이다. 뜬구름잡듯 알고 있던 내용들에 살을 붙여 체계적으로 어떻게 해야 앞으로 코딩으로 성과를 낼 수 있는지 알려줬다. 바이브코딩이 아니라 에이전틱 코딩을 해야한다고 말한다. 사람이 중심이던 시대가 끝나고 AI가
"에이전틱 코딩 완성의 기술로 바이브코딩을 다시 시작한다" 내용보기

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








유튜브만 찾아보고 맥락 없이 바이브코딩을 하던 내게 체계를 알려준 책이다. 

뜬구름잡듯 알고 있던 내용들에 살을 붙여 체계적으로 어떻게 해야 앞으로 코딩으로 성과를 낼 수 있는지 알려줬다. 

바이브코딩이 아니라 에이전틱 코딩을 해야한다고 말한다. 




사람이 중심이던 시대가 끝나고 AI가 루프를 돌려 자율수행을 하던 시대가 되었다. 

2026년 초기만해도 프롬프트가 중심이 되어 어떻게 명령하고 스킬을 설정할지가 주였는데, 

에이전틱 전략을 세우고 루프를 세우는 것이 장기적인 방향에서도 맞다는게 느껴진다. 












지난 몇 개월간 클로드코드로 많은 작업을 했다. 

하루에 8시간 이상 3월부터 많은 시간을 쏟아 부었다. 

하지만 내게 남은건 VS코드에 타자 치는 것 뿐이었다. 

이제와서 나는 아래 그림처럼 기초시설을 배우고 배관시설을 세팅하고 집다운 집을 세우기 위해 공부하려 한다. 

프론트엔드와 백엔드, 자료저장, 그리고 보안 쪽까지 어느정도 개념은 알아둬야 업무를 진행할 수 있을 듯 하다. 










처음부터 불안은 했다. 

AI가 만들어서 쓸 수 있을까? 

첫 화면은 쓸만했는데 이게 정말 될까? 

하지만 문제는 바로 드러났다. 

내가 아무리 질문을 해도 내가 아는 테두리에서만 가르쳐줘서 제대로 된 결과물을 내지 못했다. 

보안 또한 마찬가지였다. 












이 책에는 내가 생각했던 말이 그대로 써있었다. 

바이브코딩은 직관적이고 대화형이며 창의적 탐색이 강한 방식이다. 

그래서 다양한 샛길로 빠질 수 있다. 내가 이렇게 전달을 잘 못하는 사람인 줄을 몰랐다. 

사람과의 대화에서도 알아서 딱 잘 깔끔하고 센스있게 하는 경우는 드문데, 

내가 하는 말은 수십개 수천개로 뻗어 나갈 수 있다는 것을 알았다. 


그래서 에이전틱 엔지니어링의 목표지향 에이전트는 계획하고 실행하고 테스트하고 반복하는 방식으로 다시 공부해 보려 한다. 









지난 3월보다 모델은 좋아졌지만 완성된 결과물은 아직도 내놓지 못했다. 

AI가 아무리 좋아졋도 계획이 잘 세워지고 내가 잘 이끌어야 한다는 것이다. 






내가 고민하고 나아갈 방향을 엔트로픽에서는 이미 말했었다. 

코드베이스를 읽고, 변경 파일과 흐름을 파악하고, 계획을 만든 뒤 구현!! 

그냥 해줘~ 하면 이도 저도 아닌 결과물이 나온다. 

특정 시점에 자동실행하는 hook을 사용하여 방향성을 제대로 해야 한다고 한다. 












또한 이 책에서는 지도와 센서가 필요하다고 말한다. 

가이드로 계획을 세우고 전달하면 AI 에이전트가 코딩작성과 도구호출 그리고 검증 결과를 제출 하고

센서가 타임체크, E2E테스트, 보안스캔 그리고 사람의 리뷰를 통해 AI 에이전트에게 피드백이 가면

다시 아웃풋을 내는 구조로 만든다. 
















위 내용은 이 책의 첫 장 '왜 AI 코딩의 끝은 완성되지 않는가' 를 기록한 내용입니다. 

지난 몇 개월간 사용한 AI 툴이 아직까지도 내가 왜 완성을 내지 못하는가를 완전히 공감하게 했습니다. 




2부에서는 하네스엔지니어링으로 결과를 통제하는 법. 

너무나도 다양한 방법을 제시하는 AI에게 통제를 가하여 원하는 결과로 가는 방향을 제시한다.

AI도구가 더 발전하더라도 아래 내용은 항상 습관처럼 숙지하고 가져가야 할 것으로 보인다. 






3부에서는 클로드 코드에 대해서 배운다. 

유튜브같은 곳에서 많이 설명하는 것들이다. 

새로운 스킬에 열광하기도 하고 새로운 모델이 나오면 많이 달라지기도 한다. 






그리고 4부에서는 끝까지 완성하는 경험!! 

이 끝까지 완성하는 경험을 이루다보면 나도 제대로 된 바이브코딩을 하는 습관을 기를 것으로 보인다. 



w*******6 2026.11.18. 신고 공감 0 댓글 0