ハーネスエンジニアリング：信頼できるAIエージェントの作り方
記事：8
ハーネスエンジニアリング（harness engineering）は、言語モデルの周囲に、AIエージェントが実際の作業を確実にこなせる環境を作る分野です。公式はエージェント = モデル + ハーネス。同じモデルでも、あるプロジェクトではベテランの開発者のように働き、別のプロジェクトではコンテキストを失い、動かない機能を「完了」と報告します。その違いは、ほとんどの場合モデルではなくハーネスにあります。
このガイドはテーマの地図です。中心となる概念と、それらを学ぶ推奨順序をまとめています。各テーマは個別の記事で詳しく解説しています。
ハーネスの5つのサブシステム
- 指示——CLAUDE.md と AGENTS.md、専門ドキュメント、skills。エージェントがプロジェクトについて知っていること。
- ツール——shell、ファイル編集、ブラウザ、MCPサーバー。エージェントが行動する手段。
- 環境——サンドボックス、コンテナ、隔離された作業コピー。エージェントがコマンドを実行する場所。
- 状態——計画と進捗のファイル、gitの履歴。セッションをまたぐ記憶。
- フィードバック——テスト、リンター、フック、独立した検査役。エージェントが自分のミスに気づく仕組み。
これらは閉じたループを形成します。どれか一つを取り除くと、ループはその場所で切れます。検査がなければエージェントはエラーに気づけず、状態がなければ毎回のセッションが最初からやり直しになります。
どこから始めるか
このテーマが初めてなら、まずハーネスエンジニアリングとは何か、プロンプトやコンテキストのエンジニアリングとどう違うのかを扱った記事から読んでください。エージェントのハーネスの簡潔な定義と例は、ハーネスの定義の記事にあります。
次に実践に進みましょう。誰もが最初に出会うのはプロジェクトの指示ファイルです。CLAUDE.md や AGENTS.md に何を書き、何を書くべきでないか。そして、ファイルに明記されたルールをエージェントが無視してしまうのはなぜか。
エージェントがすでにプロジェクトで作業しているなら、次に問題になるのは信頼性です。ステップごとの計画は、失敗ログと MTBF・MTTR の指標から出発し、低コストのロールバック、フィードバックのループ、ファイルによる記憶を経て、数時間を人の手を借りずに働く自律ループへとつながります。
基本原則
- エージェントが壊れているのではなく、環境が壊れている。モデルを変える前に、ハーネスの穴を探してください。
- フィードバックから始める。検証コマンドは、説明文のページより価値があります。
- 指示は教科書ではなく地図。入口のファイルは短く、詳細は必要に応じて読み込みます。
- 大切なものはコンテキストウィンドウではなくファイルに置く。
- 測定する。感覚ではなく失敗ログで判断する。
ハーネスの各サブシステムと、その全体の組み立ては、ハーネスエンジニアリングの講座で実践を通して解説しています。