wquguru/harness-books

それは何か

Harness Books は、「ハーネスエンジニアリング」— AI コーディングエージェント（Claude Code や Codex など）を取り巻くシステムを設計し、実際のソフトウェアプロジェクトで安全かつ確実に動作させる実践— に関する2冊の無料オンラインブックを公開するプロジェクトです。

本はオンラインで読むか 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 コーディングエージェントを実際のエンジニアリングワークフローに安全に統合する方法を理解したい人向けの、実用的でアーキテクチャに焦点を当てた2冊のガイドです。使用方法だけでなく、それらを取り巻くシステムを設計する方法も扱います。