ハーネスエンジニアリングとは
ハーネスエンジニアリングとは、AIエージェントを自由に走らせるのではなく、レールの上を走らせるための設計技術である
読み: ハーネスエンジニアリング
AIエージェントを自由に走らせるのではなく、レールの上を走らせるための設計技術である。環境・制約・ツール・フィードバックループを設計し、AIが暴走やバグを起こさないよう動ける範囲をあらかじめ定義する。人間がコードを手で書く代わりに、AIにコードを書かせるための枠組みを作る技術として、AIエージェント開発で重要な役割を担っている。
かんたんに言うと
AIエージェントを「うまく働かせるためのレールと制御装置」を設計する技術である。人間の体にたとえるなら、筋肉(AI)をどこでどう動かすかを決める神経と骨格を設計するようなものとなる。AIが勝手に暴走したり、バグを量産したりしないよう、動ける範囲・使えるツール・受け取るフィードバックをあらかじめ設計しておく。
4つの主要工程
ハーネスエンジニアリングは4つの要素から構成される。1つ目は環境・アーキテクチャ設計で、AIエージェントが動く世界を定義する。どのディレクトリ構造にするか、どのツール(CLI、ブラウザ自動化、ログ・メトリクス)にアクセスさせるかを決める。2つ目は制約・ルールの設計で、AIが守るべきルールを機械的に強制する。命名規則やアーキテクチャ原則をカスタムリンターで検出する仕組みがこれに該当する。
3つ目はドキュメント・コンテキストの設計である。AIが「どこに何があるか」「どう動くべきか」を理解できるよう、構造化されたドキュメントを用意する。AGENTS.mdでエージェントの役割を明文化し、docsディレクトリを「システムの地図」として設計する。4つ目はフィードバックループの設計で、AI自身による自己レビュー、自動テスト、メトリクス、人間レビューを組み合わせて継続的に改善される仕組みを作る。
ワイヤーハーネス設計との違い
自動車や航空機の「ワイヤーハーネス設計」は、物理的な配線を設計する技術である。AIはその設計プロセスの一部を支援するツールとして使われるが、これはAIを応用する分野の話であり、AIエンジニアリング手法としてのハーネスエンジニアリングとは別物となる。
AIにおけるハーネスエンジニアリングは、LLMや自律的なAIシステムを制御・安定化するためのソフトウェア的な枠組みを設計する技術である。AIに大規模なコード生成や保守を任せつつ、人間が「どこへ行くか(意図)」を指定し、AIが「どう進むか(実行)」を担当する。最終的な意思決定は人間が行う設計が一般的となっている。
AIエージェント開発における役割
ハーネスエンジニアリングはプロアクティブAIアシスタントやマルチエージェントシステムの実用化において中核的な役割を果たしている。AIエージェントが自律的に判断する範囲が広がるほど、ハーネスの設計精度が動作品質を左右する。プロンプトエンジニアリングがAIへの指示の出し方を最適化するのに対し、ハーネスエンジニアリングはAIが動作する環境全体を設計する点で異なる。
当社の見解
当社は3台のAI(Claude Code、Antigravity、Codex)を並行運用する中で、ハーネスエンジニアリングの限界と突破を繰り返してきた。初期はCLAUDE.mdにルールを書く「ソフト制御」から始めたが、AIはルールを読まない。hookで毎メッセージ強制注入する「ハード制御」に移行したが、注入量が56,000文字に膨張してAIがパニックを起こした。1,200文字に削減し、必要な教訓だけをタスクに応じて選択的に注入する設計に到達した。
さらに、AIが思考プロセスなしにツールを実行することを物理的にブロックするゲート(protocol_gate)、AIの出力を事後検証するバリデーター、セッション後半の品質劣化を検知するモニター、コンテキスト圧縮後もルールを維持する自己修復機構(黄金律再注入)を実装した。外部ツール(omega-memory)の導入で16個のhookが自動追加されシステムが181秒/ツール呼び出しに劣化した事故も経験し、AIの無断変更をgitで追跡・復元する仕組みも構築した。ハーネスの健全性はAI Health Index(29問題の解決率を定量計測、総合スコア70.9%)で可視化している。ハーネスエンジニアリングの本質は、AIに「何をさせるか」ではなく「暴走したときに何が起きるか」を設計することである。常に最悪を想定した設計が求められる。
同じ失敗を二度としないAIエージェント
今のAIは、聞けば何でも答えてくれます。
でも、セッションが切れた瞬間に前回の失敗を忘れます。
当社が開発しているAIは、過去の経緯を念頭に置いて、
聞かれる前に「それは前回うまくいきませんでした」と声をかけます。
人間にも同じ失敗をさせず、AI自身も繰り返しません。
古参の社員が横にいるように、黙っていても気づいてくれる。
それが、当社が考える本当のAI社員です。
