Harness Engineering 101: LLMは脳、ハーネスは身体

Harness Engineering 101

LLMは脳。ハーネスは体。

バージョン 1.1、2026年10月。

AI利用に関する開示：私は、WSO2 MI Copilot、WSO2 BI Copilot、およびOne Codeを構築して学んだことから、各章を自分で作成しました。Claude CodeとOne Codeを使用して、各章が回答（Mintoピラミッド）から始まるように並べ替え、英語を洗練させ、図を生成し、チャートを描画するコードを記述しました。

最初の原則からAIエージェントを構築することに関するブログシリーズで、書籍としても出版されています。

📖 オンラインで読む: https://isuruwijesiri.com/harness-engineering-101/

LLM APIはステートレスです。各ターン、会話全体をJSON配列として送信し、テキストを受け取ります。「ハーネス」とは、その配列を構築、維持、保護するプログラムです。この分野で「エージェント」と呼ばれるものはすべて、その単一のループに対する一連のパッチであり、各パッチは具体的な問題が発生したために存在します。このシリーズは、その単一のアイデアを16章にわたって展開し、その過程でプレーンなPythonで約300行のトイエージェントを成長させます。

私はOne Codeでも同じアイデアを使用しています。これはpi上に構築されたオープンソースのコーディングエージェントです。

レンダリングされた書籍は、上記のリンクからオンラインで読むのが最適です。GitHubでソースを読みたい場合は、以下の順序で章を追ってください。完全な紹介は、書籍のランディングページにあります。

読む順序

各章は同じ構造を持っています：障害、最小限のパッチ、パッチのコスト。

Part I — ワイヤー（何も魔法ではない）

Part II — 長時間実行（プレッシャー下の配列）

Part III — エコシステム（すでに理解しているものを命名する）

Part IV — 信頼、ドメイン、データ

エピローグ

• あなた自身のものを構築する: 完全なトイハーネス、注釈付き

付録 — 高度なトピック

スタンドアロンのピース。必要に応じて読んでください。

• A. 1つのハーネス、複数の脳: モデルルーティング、プロンプトティア、コストエンジニアリング
• B. ワークツリーと分離: 並列エージェントに世界の個別のコピーを与える
• C. モードとプランモード: ハーネス強制オペレーティングステート（コーディング固有）
• D. リトライ、レート制限、ストリーミング: 地味な配管、およびワイヤ上でのストリーミングの仕組み

リポジトリレイアウト

書籍のローカルビルド

cargo install mdbook mdbook-mermaid   # または: brew install mdbook (+ mdbook-mermaid バイナリ)
mdbook serve --open                    # http://localhost:3000 でライブリロードプレビュー
mdbook build                           # 静的サイトを ./book にビルド

mdbook-mermaid はインラインのmermaid図をレンダリングします。これがないと、それらのブロックは生のコードとして表示されます。

定量的図の再生成

cd src/diagrams && python3 gen_all.py   # Python 3.10+, matplotlib

ライセンス

このリポジトリはデュアルライセンスです：

• 散文（すべての章と付録、src/下の.mdファイル）は、Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0)の下でライセンスされています。クレジットを表示すれば共有できますが、商業的に使用したり、改訂版を公開したりすることはできません。全文はLICENSEにあります。
• コード（src/harness/およびsrc/diagrams/下の.pyファイル、およびそれらから書籍の章に複製されたコードスニペット）は、MITライセンスの下でライセンスされています。クレジットを表示して、自由に利用してください。

© 2026 Isuru Wijesiri。