Repolode
wquguru

wquguru/harness-books

Claude Code와 Codex 같은 코드 작성 모델의 에이전트 하네스를 설계하고 제어하는 방법을 설명하는 무료 온라인 도서 두 권입니다.

스타
3,194
포크
387
열린 이슈
6
마지막 커밋
6개월 전

어떤 프로젝트인가요?

Harness Books는 하네스 엔지니어링을 다루는 두 권의 책입니다. 하네스 엔지니어링이란 코드 작성 모델이 터미널, 저장소, 권한 시스템, 팀 워크플로 안에서 실행될 때 이를 제어하는 주변 시스템을 설계하는 분야입니다. 이 책들은 프롬프트 계층화, 쿼리 루프, 도구 권한, 컨텍스트 관리, 오류 복구, 멀티 에이전트 검증, 팀 규칙을 다루며, 시스템의 범위와 책임성을 유지하는 것을 목표로 합니다.

첫 번째 책인 A Design Guide to Claude Code는 Claude Code를 주제로 런타임 구조에 초점을 맞추고, 제어 플레인, 쿼리 루프, 복구 경로와 같은 구성 요소가 시스템에 왜 필요한지 설명합니다. 두 번째 책인 The Harness Design Philosophies of Claude Code and Codex는 두 도구를 나란히 비교하며, 샌드박스, 정책 언어, 스킬, 훅 등을 포함해 각 도구가 실행 제어를 어디에 두는지 살펴봅니다.

두 책 모두 영어와 중국어로 온라인에서 읽을 수 있으며, PDF로 다운로드할 수도 있습니다. 저장소에는 사이트를 로컬에서 생성하는 Python 빌드 스크립트도 포함되어 있습니다.

핵심 기능

  • 01에이전트 시스템의 쿼리 루프, 도구 권한, 컨텍스트 관리, 오류 복구를 다룹니다.
  • 02제어 플레인 설계, 샌드박스, 정책 언어 측면에서 Claude Code와 Codex를 비교합니다.
  • 03스킬, 훅, 로컬 규칙으로 팀의 작업 방식을 에이전트 시스템에 반영하는 방법을 설명합니다.
  • 04영어와 중국어로 온라인에서 읽을 수 있으며, PDF 다운로드도 제공합니다.
  • 05이중 언어 도서 사이트를 로컬에서 빌드하는 Python 스크립트가 포함되어 있습니다.

활용 사례

  • 자체 코딩 에이전트를 만들면서 제어 계층을 이해하고 싶은 개발자.
  • 팀에서 AI 코딩 도구를 어떻게 관리할지 결정하려는 엔지니어링 리드.
  • 도구를 선택하기 전에 Claude Code와 Codex의 아키텍처를 비교하려는 엔지니어.

빠른 시작

  1. 1

    온라인으로 책 읽기

  2. 2

    책을 로컬에서 빌드하기 (Book 1, 영어)

    python3 tools/book-kit/build_honkit.py book1-claude-code --locale en
  3. 3

    통합 Pages 사이트 만들기

    python3 tools/book-kit/build_pages_site.py

사용 전 알아둘 점

  • 이 프로젝트는 소프트웨어가 아니라 책 모음이며, 라이선스가 명시되어 있지 않습니다.
  • 로컬 빌드에는 Python 빌드 스크립트를 실행해야 하며, 결과물은 dist/에 저장됩니다.

토픽

자주 묻는 질문

harness-books은(는) 무엇인가요?
Claude Code와 Codex 같은 코드 작성 모델의 에이전트 하네스를 설계하고 제어하는 방법을 설명하는 무료 온라인 도서 두 권입니다. Harness Books는 하네스 엔지니어링을 다루는 두 권의 책입니다. 하네스 엔지니어링이란 코드 작성 모델이 터미널, 저장소, 권한 시스템, 팀 워크플로 안에서 실행될 때 이를 제어하는 주변 시스템을 설계하는 분야입니다. 이 책들은 프롬프트 계층화, 쿼리 루프, 도구 권한, 컨텍스트 관리, 오류 복구, 멀티 에이전트 검증, 팀 규칙을 다루며, 시스템의 범위와 책임성을 유지하는 것을 목표로 합니다.
harness-books은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
harness-books에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
harness-books은(는) 아직 유지보수되고 있나요?
6개월 이상 커밋 없음. harness-books의 마지막 커밋은 2026년 4월 19일입니다.
harness-books은(는) 어디에 사용할 수 있나요?
자체 코딩 에이전트를 만들면서 제어 계층을 이해하고 싶은 개발자. 팀에서 AI 코딩 도구를 어떻게 관리할지 결정하려는 엔지니어링 리드. 도구를 선택하기 전에 Claude Code와 Codex의 아키텍처를 비교하려는 엔지니어.
harness-books는 어떻게 설치하나요?
온라인으로 책 읽기 책을 로컬에서 빌드하기 (Book 1, 영어): python3 tools/book-kit/build_honkit.py book1-claude-code --locale en 통합 Pages 사이트 만들기: python3 tools/book-kit/build_pages_site.py
harness-books은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/wquguru/harness-books

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트