원문 캡처 · github.com
원문 캡처 · github.com

Harness Engineering 101은 LLM을 두뇌, 하네스를 몸에 비유해 AI 에이전트의 작동 원리를 설명하는 온라인 책이다. 16개 장에서 약 300줄의 파이썬 장난감 에이전트를 확장하며 도구 호출, 컨텍스트 관리, 안전장치 같은 구성 요소를 다룬다.

온라인에서 책 읽기. 책은 2026년 9월 버전 1.0으로 소개됐다. 각 장은 해결할 문제와 최소한의 수정 방법, 그 수정에 따르는 비용을 살펴보는 방식으로 구성된다.

목차는 LLM API와 에이전트 루프에서 시작해 캐싱, 서브에이전트, 백그라운드 작업, 프레임워크와 MCP, 디버깅, 안전장치, 코딩 에이전트, RAG로 이어진다. 부록에서는 모델 라우팅과 비용 관리, 작업 디렉터리 격리, 모드, 재시도·요청 제한·스트리밍을 다룬다. 전체 소개와 목차에서 장별 원문을 확인할 수 있다.

책에서 설명하는 패턴은 오픈소스 코딩 에이전트 One Code에서 구체화됐으며, One Code는 pi를 기반으로 한다. 저장소에는 책 원고와 단계별 실행 가능한 장난감 하네스, 다이어그램 생성 코드가 포함돼 있다.

로컬에서 책을 미리 보거나 정적 사이트로 빌드하려면 mdbook과 mdbook-mermaid가 필요하다.

text
cargo install mdbook mdbook-mermaid # or: brew install mdbook (+ mdbook-mermaid binary)
mdbook serve --open # live-reloading preview at http://localhost:3000
mdbook build # static site into ./book

mdbook-mermaid가 없으면 Mermaid 다이어그램이 렌더링되지 않고 코드로 표시된다. 정량 다이어그램을 다시 생성하려면 Python 3.10 이상과 matplotlib가 필요하다.

text
cd src/diagrams && python3 gen_all.py # Python 3.10+, matplotlib

책의 글은 CC BY-NC-ND 4.0으로 제공돼 출처를 밝히면 공유할 수 있지만, 상업적 이용이나 수정본 배포는 허용되지 않는다. 하네스와 다이어그램의 파이썬 코드는 MIT 라이선스를 따른다. 글 라이선스 · 저장소