ハーネスエンジニアリング

AIエージェントを制約とフィードバックループで制御するシステム設計による「信頼できる開発」の実現。

目次

プロローグ ── エージェントは壊れていない、ハーネスが壊れている AIコーディングエージェントを初めて使ったときの体験を思い出してほしい。
第2章出自と提唱の経緯 ── 誰が、なぜ今この言葉を作ったのかハーネスエンジニアリングという言葉を最初に明確に定義したのは、**Mitchell Hashimoto** だ。Terraform、Vagrant、Packer、Consulの作者であり、HashiCorpの共同創業者。2024年からはターミナルエミュレーター「Ghostty」の開発に専念している。
第3章概念の整理 ── プロンプト・コンテキスト・ハーネスの三層モデル「ハーネスエンジニアリング」という言葉が出回り始めた初期、「コンテキストエンジニアリングと何が違うのか」「プロンプトエンジニアリングの言い換えに過ぎないのでは」という議論が起きた。
第4章議論の変遷 ── コミュニティがどう形にしてきたか Hashimotoの定義（2025年後半）とOpenAIの事例発表（2026年初頭）は火付け役だったが、「ハーネスエンジニアリング」という概念を産業的・工学的に体系化したのはその後の各プレイヤーによる議論の蓄積だ。
第5章ベストプラクティス ── 実証された七つの鉄則本章では、複数の実践者が独立して同じ結論に達しているプラクティスを七つ取り上げる。「理論的に正しそう」ではなく「実際に試されて、繰り返し報告されている」ものに絞った。各鉄則に背景・実装・注意点を添える。
第6章アンチパターン ── やりがちな失敗と脱出法ハーネスエンジニアリングの失敗パターンは、プロンプトの失敗とは性質が違う。一発で気づく失敗ではなく、気づいたときには深く根を張っている慢性的な失敗だ。「なんか最近エージェントの品質が下がってきた気がする」「ハーネスを整備したはずなのに改善しない」という症状から始まることが多い。
第7章エピローグ ── エンジニアリングの本質は変わらないハーネスエンジニアリングは称賛だけを受けているわけではない。技術コミュニティには正当な批判と懐疑論が存在する。