AI 코딩 에이전트가 재사용과 최소한의 구현을 우선해 필요한 코드만 작성하도록 하는 프롬프트 기반 스킬입니다.
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
온라인으로 책 읽기
- 2
책을 로컬에서 빌드하기 (Book 1, 영어)
python3 tools/book-kit/build_honkit.py book1-claude-code --locale en - 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 통계는 매일 갱신됩니다.
관련 프로젝트
소설의 서사 구조를 다듬고 문서별 규칙을 적용해 AI 글투를 걷어내는 휴대용 Agent Skill
Claude Code, Codex 등 여러 코딩 에이전트를 한 대화에 모아 협업시키는 VS Code 확장
Claude Code, Claude.ai와 Codex, Cursor, Gemini CLI 같은 코딩 에이전트용 Claude Skills 및 플러그인 1,000여 개를 엄선해 모아 둔 디렉터리입니다.
Anthropic의 Claude Code 사용을 위한 서브에이전트, 명령어, 스킬, 훅, 메모리, 워크플로를 다루는 엄선된 최신 모범 사례 가이드이자 참고 자료입니다.
Codex CLI와 API에서 코딩, 생산성, 데이터 워크플로를 자동화하는 실용적인 Codex 스킬을 모아 놓은 GitHub 목록입니다.