- Hugging Faceが2026年5月25日、AIエージェントの用語集「Harness, Scaffold, and the AI Agent Terms Worth Getting Right」を公開しました。
- 「エージェント＝モデル＋ハーネス」というシンプルな定義で、現場で乱立する用語の混乱を整理しています。
- ハーネスは「実行層」、スキャフォルドは「振る舞いを決める設計層」。Claude CodeやCodexはまさにこのハーネスにあたります。
- 2026年は「ハーネスエンジニアリング」が主役になる流れが加速。プロンプト一発勝負の時代は終わりつつあります。
- 日本の開発者にも直結するテーマで、用語の理解は社内ツール内製や生成AI導入の意思決定を左右します。
AIエージェントの記事を読んでいて、「ハーネス」「スキャフォルド」「コンテキストエンジニアリング」という言葉が次々と出てきて混乱した経験はありませんか。同じ「エージェント」でも、書き手によって意味がずれているケースは少なくありません。Hugging Faceが2026年5月25日に公開した用語集は、そんな現場のモヤモヤを一気に整理してくれる一本です。
Hugging Faceがなぜ用語集を出したのか
用語集のタイトルは「Harness, Scaffold, and the AI Agent Terms Worth Getting Right（ハーネス、スキャフォルド、知っておくべきAIエージェント用語）」。
きっかけは、機械学習の国際会議ICLR 2026で交わされた一言の質問でした。
「ハーネスとスキャフォルドって、結局なんなのか説明を聞いたけど、人によって全然違う。なぜ意味が一つに定まらないの？」
分野が急速に進化すると、語彙のほうが共通理解より先に膨らみます。Hugging Faceの記事は「世界共通の定義を押し付けるのではなく、考えるためのメンタルモデルを提供する」と前置きしたうえで、現場で使いやすい定義を提示しました。
用語集が必要になった背景
2025年は「AIエージェント元年」と呼ばれ、Claude Code、OpenAI Codex、Cursorなどが一気に市場に投入されました。
ところが、各社のドキュメントを横並びで読むと、「エージェント」「ハーネス」「フレームワーク」という言葉の使い方が微妙に違うのです。読者は同じ単語でも文脈ごとに意味を切り替えなければなりません。
Hugging Faceはこの状況を「語彙が暴走している」と評し、最低限そろえておきたい用語を提案したわけです。
Harness（ハーネス）とは何か
ハーネスは、エージェントの中で「実際に動かす」役割を担う実行層のことです。
具体的には、こんな仕事をします。
- モデル（LLM）を呼び出す
- モデルが要求したツール呼び出しを実際に実行する
- 結果をモデルに戻す
- 「もう止めていい」か「もう一周回す」かを判断する
つまり、エージェントを実際にループさせている黒子の存在です。
Hugging Faceの記事では、Anthropic公式ドキュメントの「Claude CodeはClaudeを取り囲むエージェントハーネスとして機能する」という一文を引用しています。Claude Code、Codex、Antigravity CLIといった製品名は、いずれもハーネスを指す言葉として使われているわけです。
ハーネスが製品の差を生む
ちなみに、AI開発者コミュニティの分析によると、Claude CodeのコードベースのうちAIの意思決定ロジックはわずか1.6%。残り98.4%は運用インフラ、つまりハーネスにあたる部分だと言われています。
同じClaudeを動かしても、ハーネスの作り次第で挙動はまったく変わる。だから「プロンプトより、どう包むかが勝負」と言われ始めているのです。
Scaffold（スキャフォルド）との違い
スキャフォルドは日本語に直すと「足場」。ハーネスがエンジン部分なら、スキャフォルドは「モデルの振る舞いを設計する層」です。
具体的には次の4つを含みます。
- システムプロンプト
- ツールの説明文（モデルにどんな道具を渡すか）
- レスポンスのパース方法
- コンテキスト管理（何を覚えておくか）
つまり、モデルに「あなたはこういう世界で、こういう道具を使って、こう答えてね」と教える設計図のことです。
ハーネスとスキャフォルドはどちらも必要
両者の関係を一文で言うと、こうなります。
「スキャフォルドはモデルがどう考えるかを決め、ハーネスはモデルがどう動くかを決める」
たとえば請求書を処理するエージェントを作る場合、スキャフォルドが「あなたは経理担当のAIです。請求書PDFを読んで仕訳を作ってください」と教え、ハーネスが「PDF読み込みツールを呼んで、結果を会計システムのAPIに渡して、エラーが出たらリトライする」というループを回します。
どちらか片方では成立しません。エージェント＝モデル＋ハーネスという公式の中に、スキャフォルドが組み込まれているわけです。
他にも整理された重要用語
用語集には、ハーネス・スキャフォルド以外にも実務で頻出する言葉が並びます。
Context Engineering（コンテキストエンジニアリング）
従来の「プロンプトエンジニアリング」を拡張した概念です。
長時間動くエージェントでは、毎ステップで「どんな指示を渡すか」「過去のどの中間結果を残すか」「どの状態を捨てるか」を設計し続ける必要があります。1回のプロンプトを磨くのではなく、コンテキスト全体を運用する仕事です。
Policy（ポリシー）
エージェントが「ある状況でどんな行動を選ぶか」の確率分布です。強化学習由来の用語ですが、エージェント設計の議論でも頻出します。
Skills（スキル）
多段ステップのタスクを再利用可能な形でパッケージ化した単位。最近のClaude Codeは「スキル」という仕組みで、特定の手順をひとまとめにして呼び出せるようにしています。
Sub-agents（サブエージェント）
あるエージェントが、サブタスクを別のエージェントに委譲する構造です。たとえば「全体を統括するエージェント」が「リサーチ担当」「コードレビュー担当」を呼び出して並列に作業させる、というイメージです。
類似サービス・従来手法との違い
「ハーネス」という言葉は、既存のAI開発ツール群を整理する物差しとしても便利です。
SDK・フレームワークとの関係
LangChain、LlamaIndex、AutoGenといったSDKやフレームワークは「AIエージェントをどう作るか」に答える道具です。
一方ハーネスは「作ったエージェントをどう動かすか」に答えます。両者は対立せず、ハーネスはSDKやフレームワークの上に乗る一段上のレイヤーになります。
主要ハーネス製品の比較
- Claude Code（Anthropic）：ターミナルから動くコーディングハーネス。MCP、サブエージェント、フックなどを内蔵
- OpenAI Codex：GitHubと連携した自動コーディングエージェント。バックグラウンドで継続実行
- Cursor：IDE型ハーネス。エディタと深く統合された対話的な開発体験
- Antigravity CLI：Googleが提供する開発者向けハーネス
共通しているのは、いずれも「モデル本体ではなく、その周辺の運用基盤こそが差別化要因」と位置づけている点です。
プロンプトエンジニアリングとの違い
2024年ごろまでの主役は「プロンプトをどう書くか」でした。実は2026年現在、「プロンプトをどう包むか（＝ハーネス設計）」のほうが重要視されています。
Hugging Faceの記事もこの流れを後押しする形で、用語の整理から議論を立て直そうとしているわけです。
日本市場・日本の開発者への影響
用語集自体は英語ですが、日本の開発現場にも直接効いてきます。
社内ツール内製の意思決定が変わる
ある中堅メーカーの情シス担当者が「社内向けにAIアシスタントを作りたい」と相談されたとします。
用語整理がない時代は「プロンプトをどう書くか」だけが議論の中心でした。これからは「どのハーネスを採用するか」「スキャフォルドはどこまで自社で書くか」というレイヤー分けで設計判断を下せます。意思決定の地図がはっきりするわけです。
SIer業界の役割再定義
日本のSIer業界では「AIエージェント導入支援」というメニューが急増しています。発注側と受注側で「ハーネス」「スキャフォルド」の定義がずれると、見積もりとスコープの認識違いが起きやすい状態です。
Hugging Faceの用語集を共通参照とすることで、契約書レベルでの認識合わせがしやすくなります。
採用市場でも用語の標準化が進む
「ハーネスエンジニア」「コンテキストエンジニア」といった新しい職種名が、海外の求人サイトでは既に登場しています。
日本でも今後、AI開発者の役割分担がこの粒度で整理されていく可能性が高いと言われています。求職者・採用担当の双方にとって、用語の標準理解はキャリア戦略の前提知識になりつつあります。
よくある質問（FAQ）
Q1. ハーネスとフレームワークは何が違うのですか？
フレームワーク（LangChainなど）はエージェントを「組み立てる」ためのキットです。ハーネスは組み立てたエージェントを「動かし続ける」実行環境を指します。フレームワークを使ってハーネスを作る、という関係性です。
Q2. スキャフォルドはシステムプロンプトと同じ意味ですか？
システムプロンプトはスキャフォルドの一部です。スキャフォルドにはさらに、ツール定義、レスポンスのパース、コンテキスト管理などが含まれます。「モデルの振る舞いを設計するもの全部」と捉えると分かりやすいです。
Q3. 個人開発者でもハーネスを意識する必要はありますか？
はい、あります。Claude CodeやCursorを使う際、設定ファイル（CLAUDE.md、設定JSONなど）を書く行為はまさにスキャフォルド設計です。フックや権限管理を触るとハーネスの挙動を変えていることになります。用語を知っているだけで設定の意味が一段クリアになります。
Q4. この用語集は今後変わる可能性がありますか？
Hugging Faceも「世界共通の定義はまだ存在しない」と明言しています。今後コミュニティの議論で表現が変わる可能性は十分あります。ただし「モデル＋ハーネス＝エージェント」という基本構造は当面安定すると見られています。
Q5. 用語集の全文はどこで読めますか？
Hugging Face公式ブログ（huggingface.co/blog/agent-glossary）で公開中です。英語ですが、図解と例示が豊富で、機械翻訳でも要点はつかめます。GitHubリポジトリでもMarkdown版が読めます。
まとめ
- Hugging Faceが2026年5月25日にAIエージェント用語集を公開、現場の混乱を整理する基礎資料として注目
- 「エージェント＝モデル＋ハーネス」が中核の定義。ハーネスは実行層、スキャフォルドは設計層
- Claude Code・Codex・Cursorはいずれも代表的なハーネス製品。コードベースの98.4%が運用インフラという指摘も
- 2026年はプロンプトエンジニアリングからハーネスエンジニアリングへの移行が加速
- 日本のSIerや内製チームにとっても、共通用語の理解は導入判断と契約合意の前提条件になる
AIエージェント関連のニュースを読む前に、まずはHugging Faceの用語集にざっと目を通しておくと、その後の理解スピードが格段に上がるはずです。
参考文献
- Hugging Face Blog「Harness, Scaffold, and the AI Agent Terms Worth Getting Right」https://huggingface.co/blog/agent-glossary
- GitHub「huggingface/blog: agent-glossary.md」https://github.com/huggingface/blog/blob/main/agent-glossary.md
- MindStudio「What Is an Agent Harness? The Architecture Behind Claude Code, Codex, and Cursor」https://www.mindstudio.ai/blog/what-is-agent-harness-architecture-explained
- Claude Code Docs「How Claude Code works」https://code.claude.com/docs/en/how-claude-code-works
- AI Magicx Blog「Harness Engineering: Why the Way You Wrap AI Matters More Than Your Prompts in 2026」https://www.aimagicx.com/blog/harness-engineering-replacing-prompt-engineering-2026
こんな時代だから遊んで学びたい
AIを学ぶオンラインサロン「AIフレンズ」では、生成AIを楽しく、どこよりも優しく学べる環境をご用意しております。
毎週開催されるオンラインセッションでは、リアルタイムで学び合える機会を提供しています。 さらに、月に一度のオフラインイベントでは、メンバー同士が直接交流し、アイデアや知識を深めることができます。
「AIフレンズ」の仲間とともに、新しい価値を創造し、可能性を広げてみませんか？
一緒に学び、成長しながら、生成AIを使いこなす力を身につけましょう！
