★프롬프트잘쓰는법에집착하지말고,시스템을설계하라
★저자의실제경험을담은에이전틱개발의성공과실패,성과와비용
★뜬구름잡는개념설명은그만,손으로만들며익히는실전비법서!
AI코딩을알려주는책과자료는이미많습니다.대부분‘무엇을어떻게입력하는가’에서끝납니다.이책은그다음질문에답합니다.프롬프트를아무리잘써도결과가들쭉날쭉한이유는무엇이며,사람이자리를비운사이에도일이굴러가게하려면무엇을설계해야할까요?
저자는그답을두층으로정리합니다.아래층은하네스입니다.에이전트를‘모델’이아니라‘모델+환경’으로보고,무엇을막고무엇을보여주고어떤도구를쥐어줄지정하는층입니다.위층은루프입니다.그환경위에서무엇을맡기고어떻게확인하며언제멈출지를정합니다.책제목이된루프엔지니어링이이위층을설계하는일입니다.저자의정의는이렇습니다.“여러에이전트실행을반복해서운영하는방법을설계하는일.사람이매번다음프롬프트를입력하지않아도작업이이어지도록시작조건과작업선택,검증,상태저장,종료정책을정하는일입니다.”
★누가읽으면좋은가?
커서나코덱스로AI코딩의편리함을이미맛본개발자가첫번째독자입니다.도구는쓰고있는데더큰작업을맡기기가불안한단계,이책은거기서출발합니다.
두번째는자동화루프를직접돌려본분입니다.한시간쯤돌려보셨다면에이전트가이미해결한오류를다시붙잡거나,완료했다고말해놓고실제로는안된장면을보셨을것입니다.이책은그실패를예시로삼아검증과종료조건을설계합니다.
세번째는팀에AI개발방식을도입해야하는리드입니다.역할분리가품질에얼마나기여하는지,대신비용이얼마나늘어나는지를앤트로픽의실측치로판단하실수있습니다.
★이책에서다루는내용
PART01[클로드코드와에이전틱코딩]은도구를손에쥐는단계입니다.설치와인증에서시작해대화형·비대화형실행,권한모드,.claude디렉터리구조,컨텍스트윈도우와프롬프트캐싱을다룹니다.핵심은2장의에이전트루프입니다.컨텍스트를모으고,작업을하고,결과를확인하는이단순한구조가클로드코드를언어모델이아니라에이전트로만듭니다.여기서명언출력기CLI와할일관리CLI를만듭니다.
_01클로드코드와에이전틱코딩이해하기
에이전틱코딩이무엇인지,클로드코드를설치하고인증하는것으로시작합니다.자동완성형도구에서채팅형IDE를거쳐지금의에이전트퍼스트도구에이르기까지의흐름을정리합니다.대화형과비대화형실행방식,파일멘션,주요슬래시커맨드같은기본기를익힙니다.대화한번으로파일이만들어지고실행까지확인되는과정을직접관찰합니다.
_02클로드코드의동작원리와핵심개념
클로드코드를채팅창이아니라컨텍스트수집,작업수행,결과검증을반복하는에이전트로이해하는장입니다.이반복이바로에이전트루프이며,책제목의'루프'가처음등장하는지점이기도합니다.권한모드로어디까지자동승인할지정하고,.claude디렉터리구조와설정우선순위를익히고,컨텍스트윈도우가유한하다는전제에서작업을나누는방법과프롬프트캐싱으로비용을줄이는법까지다룹니다.
PART02[클로드코드의확장]은에이전트에게능력과경계를부여합니다.3장은반복작업을SKILL.md로패키징해이슈생성·커밋·PR·리뷰·리뷰반영까지개발사이클전체를스킬다섯종으로자동화합니다.4장은MCP와훅을함께다룹니다.여기서이책의중요한구분하나가나옵니다.CLAUDE.md에적어둔지침은대부분지켜지지만컨텍스트가가득차면누락됩니다.“지침이확률적으로지켜지는것과달리훅은결정적으로실행되므로,한번도어기면안되는규칙은훅으로만듭니다.”5장은모델에들어가는입력전체를CLAUDE.md,rules,스킬,automemory네층으로설계하고컨텍스트오염을다룹니다.6장은격리된컨텍스트에서일하는서브에이전트와수십개를조율하는동적워크플로로넘어갑니다.저자는이장의결과물을두고“여기까지코드를한줄도작성하지않았습니다”라고적었습니다.
_03에이전트스킬
매번같은설명을반복하는대신작업절차를파일로패키징하는방법을배웁니다.클로드코드가세션시작시스킬의이름과설명만먼저읽고필요할때본문을불러오는점진적공개구조를이해하고,개인스킬과프로젝트스킬,플러그인스킬의차이와이름충돌처리까지익힙니다.마지막에는개발사이클전체를스킬로자동화합니다.
_04MCP와훅
에이전트를회사의다른시스템과잇는방법,그리고반드시지켜야할규칙을강제하는방법을함께다룹니다.MCP는도구연동의표준으로,서버를연결하는것부터직접만드는것까지진행합니다.훅은지침과다릅니다.CLAUDE.md에적어둔규칙은대부분지켜지지만컨텍스트가가득찼을때누락되곤합니다.지침이확률적으로지켜지는것과달리훅은결정적으로실행되므로,한번도어기면안되는규칙은훅으로만듭니다.
_05컨텍스트엔지니어링
프롬프트한줄이아니라모델에들어가는입력전체를설계하는장입니다.신입사원에게아무설명없이버그를고쳐달라고만시키면어떻게되는지에서출발해,CLAUDE.md와rules,스킬,automemory가각각어떤층을담당하는지정리합니다.컨텍스트윈도우가아무리커도중간의정보를놓치는문제를짚고,오염된컨텍스트를알아채는신호와복구방법을다룹니다.오염은치료보다예방이쉽습니다.
_06서브에이전트와동적워크플로
메인대화를어지럽히지않고격리된컨텍스트에서일하는서브에이전트를정의합니다.도구와모델,권한을제한해필요한만큼만쥐어주는방법을익히고,수십개에이전트를한번에조율하는동적워크플로까지나아갑니다.저자는이장의결과물을두고"여기까지코드를한줄도작성하지않았다"고적었습니다.
PART03[하네스와루프엔지니어링그리고LLMOps]은이책의핵심입니다.7장은하네스엔지니어링의개념과사례를다룹니다.코덱스를쓴팀이5개월동안사람이한줄도쓰지않고백만라인규모제품을만들며약1,500개의PR을병합한사례,앤트로픽이모델성능이좋아질때마다하네스를오히려덜어낸사례가나란히놓입니다.8장은목표와완료조건만주면도는루프를처음만듭니다.셸while문몇줄짜리랄프루프의원리를익히고RSSWiki를완성합니다.
_07하네스엔지니어링
에이전트를모델이아니라모델과환경의합으로바라봅니다.어떤하네스를씌우느냐가에이전트의성격을정합니다.무엇을막고,무엇을보여주고,어떤도구를쥐어주고,어떻게갱신할지네관점으로자기프로젝트의하네스를설계합니다.오픈AI와앤트로픽의실제사례와함께살펴봅니다.
_08에이전트루프
목표와완료조건만주면사람개입없이도는루프를처음으로만들어봅니다.제품사양서를먼저쓰고,셸while문세줄로이루어진랄프루프의원리를이해한뒤,클로드코드의/goal로같은일을시킵니다.에이전트입장에서매사이클은기억상실증에걸린직원이출근할때마다인수인계문서를읽는것과같습니다.그래서완료조건을어떻게적느냐가결과를가릅니다.수정하면안되는파일같은제약을함께명시해야에이전트가조건자체를공략하지못합니다.
_09에이전트역할분리
한에이전트가쓰고스스로검토하면놓치는것이생깁니다.플래너,생성자,평가자를구조적으로분리해결과물품질의하한을올리는방법을다룹니다.여섯종의협업문서로에이전트끼리상태를주고받게하고,오케스트레이터가이들을사이클로돌립니다.8장의RSSWiki를이구조로다시짓고,나아가여러프로젝트를동시에굴려봅니다.다만역할분리는품질의하한을올리는장치이지상한을올리는장치는아니며,비용은크게늘어난다는점도숫자로짚습니다.
_10루프엔지니어링
이책의제목이되는개념을정면으로다루는장입니다.루프엔지니어링은사람이매번프롬프트를보내는대신,작업을찾고실행하고검증하고기록하는시스템을설계해그시스템이에이전트를호출하게하는일입니다.하네스가환경의층이라면루프엔지니어링은그위에서도는반복의층을설계합니다.이너루프와아우터루프를구분하고,시작과작업선택,실행,검증,상태,제어,예산,기록여덟항목을정하는법을익힙니다.Bun팀이Zig53만줄을열하루만에러스트로옮긴사례를커밋수와토큰비용까지포함해해부하고,마지막으로이해부채를다룹니다.코드가돌고테스트가통과해도구현이유와영향범위를설명할사람이없다면위험은쌓입니다.
_11LLMOps와랭퓨즈
HTTP응답은200OK인데LLM이환불정책을잘못안내할수있습니다.기존모니터링으로는잡히지않는이런실패를다루는것이LLMOps입니다.랭퓨즈를셀프호스트로띄우고,실제로동작하는고객문의답변도우미를만들어요청하나하나에추적과점수를남깁니다.프롬프트를파일이아니라랭퓨즈에서버전과label로관리하면,앱을다시배포하지않고도프롬프트를교체하고문제가생기면즉시되돌릴수있습니다.
