LeanX

하네스 · 루프 엔지니어링

AI 에이전트를 한 번 시키고 끝이 아니라, 스스로 일하고 검증하는 시스템으로 운용하는 법

하네스(Harness)란 무엇인가

하네스는 AI 모델을 감싸는 작업 환경 전체 — 도구·컨텍스트·권한·인터페이스 — 를 뜻하며, '모델이 두뇌라면 하네스는 손발과 주방'이라는 비유가 이 개념의 핵심입니다. 약 9분.

원샷 프롬프트는 단순한 작업에는 충분하지만, 복잡하고 반복적이며 검증이 필요한 작업에는 에이전트가 스스로 찾고·실행하고·검증하고·기록하고·다음을 결정하는 루프(Loop) 방식이 훨씬 강력합니다. 약 10분.

훌륭한 에이전트 루프는 목적·편집가능범위·지표·예산·품질게이트·메모리·정지조건이라는 7가지 요소를 모두 갖출 때 예측 가능하고 안전하게 작동합니다. 약 12분.

컨텍스트 엔지니어링이란 AI 에이전트의 작업 창(context window)에 무엇을 언제 얼마나 넣을지 설계하는 기술로, 2025년 이후 단순 프롬프팅을 대체하는 핵심 역량이 되었습니다. 약 12분.

메이커-체커 패턴(Maker-Checker Pattern)은 만드는 에이전트와 검증하는 에이전트를 완전히 분리하는 설계로, 같은 모델이 자신의 결과물을 검토하는 구조적 한계를 극복합니다. 약 11분.

에이전트가 '완료했습니다'라고 말하는 것은 성공이 아니며, 테스트·타입체크·린트·브라우저 확인 같은 외부 평가자(external evaluator)가 실제로 통과해야 성공입니다. 약 10분.

에이전트 루프의 기억은 대화 창(context window)이 아니라 외부 파일에 있어야 하며, loop-state.md·decision-log.md 같은 지속 가능한 상태 파일이 세션 간 연속성과 반복 실수 방지를 보장합니다. 약 10분.

git worktree로 에이전트마다 독립 작업 디렉터리를 주면 파일 충돌 없이 여러 에이전트를 동시에 실행할 수 있지만, 코드 격리만으로는 부족하고 런타임·DB·포트까지 격리해야 진짜 안전합니다. 약 10분.

이론을 넘어 실제로 동작하는 루프를 만들려면, 작은 범위에서 시작해 검증 가능한 목표를 정하고, 프롬프트·체크리스트·상태 파일을 준비한 후 직접 돌려보며 개선하는 반복 과정이 필수입니다. 약 14분.