출처
- source_url: https://github.com/wquguru/harness-books
- author: wquguru
- raw: raw source:
2026-07-14-wquguruharness-books-two-books-on-harness-engineering-the-design-philosophies-behind-claude-code-codex-constraints-query-loops-context-governance-multi-agent-verification-harness-books-agentway-dev
요약
harness-books는 코드를 작성하는 모델이 터미널·저장소·권한 시스템·팀 워크플로에 편입될 때 “무엇이 시스템 전체를 유계(bounded)하고, 지속 가능하고, 결과에 책임지도록 만드는가”라는 하나의 질문을 파고드는 두 권의 무료 온라인 책이다. 소스 코드를 줄 단위로 훑기보다, 프롬프트 레이어링·쿼리 루프·권한 결정·컨텍스트 거버넌스·실패 복구·멀티에이전트 검증·로컬 규칙·팀 제도가 어떻게 하나의 “하네스”라는 장기 계통을 이루는지에 집중한다. 핵심 주장은 모델이 가끔 틀린 말을 하는 것 자체보다, 시스템에 그 결과를 처리할 구조가 없는 것이 진짜 위험이라는 것이다.
Book 1 — Harness Engineering: A Design Guide to Claude Code Claude Code를 관찰 대상으로 삼아 런타임 구조에 집중한다. 왜 시스템이 결국 제어 평면(control plane), 쿼리 루프, 도구 권한, 컨텍스트 거버넌스, 복구 경로, 멀티에이전트 검증, 팀 규칙 같은 구성요소를 갖추게 되는지를 설명한다. 프롬프트를 “채팅창”이 아니라 제어 평면의 일부로 보는 관점, 모델의 실수를 예외가 아닌 런타임 규범으로 다루는 관점이 핵심이다.
Book 2 — The Harness Design Philosophies of Claude Code and Codex Claude Code와 Codex를 나란히 놓고 각 하네스가 질서를 어디에 두는지 비교한다. 하나는 런타임 규율에서 출발하고, 다른 하나는 더 구조화된 제어 계층에서 출발한다 — 둘 다 작동하지만 권한을 분배하는 방식이 다르다. 쿼리 루프·스레드·롤아웃·상태의 역할 정렬, 권한·샌드박스·정책 언어가 맡는 거버넌스 역할, 스킬·훅·로컬 규칙이 조직의 습관을 시스템에 인코딩하는 방식을 다룬다.
전체 결론만 원하면 Book 1의 “10 Principles of Harness Engineering” 챕터와 Book 2의 “Convergence Through Different Roads” 챕터를 권한다. 관련 실습 플랫폼으로 AgentWay(agentway.dev)도 함께 소개된다.
관련 위키
원문 보존 위치
원문 전체는 raw source: 2026-07-14-wquguruharness-books-two-books-on-harness-engineering-the-design-philosophies-behind-claude-code-codex-constraints-query-loops-context-governance-multi-agent-verification-harness-books-agentway-dev에 source_url과 함께 저장되어 있다.