wquguru/harness-books

그것이 무엇인가

Harness Books는 "하네스 엔지니어링" — AI 코딩 에이전트(예: Claude Code 또는 Codex)를 둘러싼 시스템을 설계하여 실제 소프트웨어 프로젝트에서 안전하고 안정적으로 동작하도록 하는 실천 — 에 관한 두 권의 무료 온라인 책을 출판하는 프로젝트입니다.

책은 온라인으로 읽거나 PDF로 다운로드할 수 있으며, 프로젝트에는 로컬에서 사이트를 생성하기 위한 소스 파일과 빌드 도구도 포함되어 있습니다.

책이 다루는 내용

• 1권: 하네스 엔지니어링: Claude Code 설계 가이드 — Claude Code를 구체적인 예로 사용하여 하네스의 핵심 구성 요소를 설명합니다: 제어 논리로서의 프롬프트, 쿼리 루프, 도구 권한, 컨텍스트 관리, 오류 복구, 다중 에이전트 검증, 팀 규칙. AI 코딩 도구의 실제 위험은 가끔 발생하는 잘못된 답변이 아니라 결과를 처리할 구조의 부족이라고 주장합니다.

• 2권: Claude Code와 Codex의 하네스 설계 철학 — Claude Code와 Codex가 각각 시스템에서 "질서"를 어떻게 배치하는지 비교합니다. 하나는 런타임 규율에 더 의존하고, 다른 하나는 구조화된 제어 계층에 의존합니다. 이 책은 독자가 아키텍처 트레이드오프를 이해하고, 에이전트 시스템을 평가하며, 자체 하네스를 구축할 때 무엇을 공부해야 하는지 이해하는 데 도움을 줍니다.

핵심 주장

• 하네스 엔지니어링은 제약이 실행을 어떻게 조직화하는지에 관한 것이지, 단순한 프롬프트 엔지니어링이 아닙니다.
• 코드 작성 모델이 실제 엔지니어링 환경에 들어가면 주요 문제는 답변 품질에서 행동 결과로 이동합니다.
• 프롬프트, 도구, 권한, 상태, 복구, 검증, 제도는 부가 기능이 아니라 단일 제어 구조의 기관입니다.
• 에이전트 시스템을 비교할 때 핵심 질문은 기능 체크리스트가 아니라 질서가 실제로 어디에 배치되는지입니다.
• 팀이 개인 경험을 재사용 가능한 규칙으로 전환할 수 없다면 에이전트를 안정적인 시스템으로 전환하는 데 어려움을 겪을 것입니다.

대상 독자

• 실제 프로젝트에서 AI 코딩 에이전트를 사용하거나 사용할 계획이 있는 개발자, 팀 리더, 아키텍트.
• 에이전트 시스템의 아키텍처 설계에 관심이 있는 사람 (사용 팁뿐만 아니라).
• Claude Code와 Codex의 차이를 더 깊이 이해하고 싶은 사람.

읽는 방법

• 전체 프레임워크를 얻으려면: 1권을 읽은 다음 2권을 읽으세요.
• 코딩 에이전트 도구를 이미 알고 있고 아키텍처 비교를 직접 원한다면: 2권부터 시작하세요.
• 결론만 원한다면: 1권 9장과 2권 7장을 읽으세요.

추가 리소스

프로젝트는 또한 책의 아이디어를 훈련 경로, 드릴, 프로젝트 연습으로 확장하는 별도의 연습 플랫폼 AgentWay를 가리킵니다.

기술 세부 사항

리포지토리에는 책 소스 파일(Markdown 형식), 빌드 스크립트(Python 기반, Honkit 사용), 로컬에서 전체 사이트를 빌드하는 지침이 포함되어 있습니다. 최종 출력은 dist/ 폴더에 기록됩니다. 영어와 중국어 버전이 모두 제공됩니다.

요약

Harness Books는 AI 코딩 에이전트를 실제 엔지니어링 워크플로우에 안전하게 통합하는 방법을 이해하려는 모든 사람을 위한 실용적이고 아키텍처 중심의 두 권의 가이드입니다. 사용 방법뿐만 아니라 그 주변 시스템을 설계하는 방법도 다룹니다.