"LLM은 뇌고 하네스가 몸이다" AI 에이전트 밑바닥부터 만드는 오픈소스 가이드 화제

요약 개발자들 사이에서 AI 에이전트를 근본 원리부터 파헤치는 오픈소스 튜토리얼 프로젝트 '하네스 엔지니어링 101(Harness Engineering 101)'이 공개되어 주목받고 있습니다. 이 가이드는 "LLM은 두뇌이고, 하네스(Harness)는 몸체다"라는 핵심 명제에서 출발합니다. 저자는 LLM API의 본질이 상태가 없는(Stateless) 구조이며, 매 턴마다 전체 대화 기록을 JSON 배열로 보내고 텍스트를 돌려받는 것에 불과하다고 설명합니다. 결국 업계에서 부르는 'AI 에이전트'란 이 단 하나의 반복 루프에서 발생하는 구체적인 문제점들을 해결하기 위해 덧붙인 패치들의 집합이며, 하네스는 바로 그 JSON 배열을 구성하고 유지하며 보호하는 프로그램이라는 분석입니다. 총 16개 챕터로 구성된 이 시리즈는 순수 파이썬으로 작성된 약 300줄짜리 토이 에이전트를 점진적으로 확장해가며 원리를 설명합니다. 각 장은 '발생하는 문제(실패 사례)', '최소한의 패치 코드', '패치에 따르는 비용'이라는 동일한 구조로 전개됩니다. 내용은 크게 4개 파트로 나뉩니다. 1부에서는 JSON 배열 통신, 넥스트 토큰 예측 한계, 도구(Tool) 호출 및 캐싱 비용 문제를 다루고, 2부에서는 컨텍스트 윈도우 한계 관리, 서브에이전트를 통한 컨텍스트 분기, 실행 중 방향 제어 및 비동기 백그라운드 처리를 다룹니다. 3부에서는 MCP, 스킬 등 프레임워크 생태계와 배열 디버깅을, 4부에서는 가드레일, 코딩 에이전트 사례 분석, RAG 패턴 등을 심도 있게 조명하며, 별도 부록을 통해 모델 라우팅과 작업 격리 같은 고급 주제도 제공합니다.