Repolode
wquguru

wquguru/harness-books

Claude CodeやCodexなど、コードを書くモデルのエージェントハーネスの設計と制御を解説する無料のオンライン書籍2冊。

スター
3,194
フォーク
387
未解決の Issue
6
最終コミット
6 か月前

これは何?

Harness Booksは、ハーネスエンジニアリングに関する2冊の書籍です。ここでいうハーネスとは、コードを書くモデルがターミナル、リポジトリ、権限システム、チームのワークフロー内で動作するときに、そのモデルを制御する周辺システムを指します。書籍では、プロンプトの階層化、クエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリー、複数エージェントによる検証、チームのルールを取り上げ、システムの動作範囲を適切に制限し、説明責任を保つ方法を解説します。

1冊目の『A Design Guide to Claude Code』では、Claude Codeを題材に、ランタイムの構造を掘り下げ、コントロールプレーン、クエリループ、リカバリーパスといったコンポーネントがなぜシステムに加わるのかを説明します。2冊目の『The Harness Design Philosophies of Claude Code and Codex』では、2つのツールを比較し、サンドボックス、ポリシー言語、スキル、フックなど、実行制御の配置をそれぞれ検証します。

2冊とも英語と中国語でオンライン閲覧でき、PDFとしてダウンロードすることもできます。リポジトリには、サイトをローカルで生成するためのPythonビルドスクリプトも含まれています。

主な機能

  • 01エージェントシステムにおけるクエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリーを解説します。
  • 02コントロールプレーンの設計、サンドボックス、ポリシー言語についてClaude CodeとCodexを比較します。
  • 03スキル、フック、ローカルルールによって、チームの慣習をエージェントシステムに反映する方法を解説します。
  • 04英語と中国語でオンライン閲覧でき、PDFもダウンロードできます。
  • 052言語対応の書籍サイトをローカルでビルドする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など、コードを書くモデルのエージェントハーネスの設計と制御を解説する無料のオンライン書籍2冊。 Harness Booksは、ハーネスエンジニアリングに関する2冊の書籍です。ここでいうハーネスとは、コードを書くモデルがターミナル、リポジトリ、権限システム、チームのワークフロー内で動作するときに、そのモデルを制御する周辺システムを指します。書籍では、プロンプトの階層化、クエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリー、複数エージェントによる検証、チームのルールを取り上げ、システムの動作範囲を適切に制限し、説明責任を保つ方法を解説します。
harness-books は無料で使えますか?ライセンスは?
harness-books にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
harness-books は今もメンテナンスされていますか?
半年以上コミットなし。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 の数値は毎日更新されます。

関連プロジェクト