一言で言うと
用語集が出た理由は、「分野が未熟だから」だけではありません。AIエージェントの「ループ(同じ手順を繰り返しながら進める仕組み)を誰が制御するか」という設計の主導権が、まだ各社のあいだで競われているため、同じ用語が文脈ごとに違う意味で使われ続けている、というのが本質です。
何が起きているのか
Hugging Face は2026年5月25日、AIエージェント開発で使われる「harness(ハーネス)」と「scaffold(スキャフォールド)」の用語集を公開しました。きっかけは、ICLR 2026(AI分野の主要な国際学会)での一つの投稿です。ある研究者が「これらの用語の説明を多く聞いたが、一つの定義に収束しなかった」と問題提起したことで、同ブログの執筆につながりました。
この用語集が整理している主な概念は、次の4つです。
モデル ここでいうモデルは、大規模言語モデル(LLM: Large Language Model)本体のことです。Claude、GPT、Qwen などが該当します。役割は、テキストを受け取ってテキストを返すことです。チャットをまたいで覚え続ける記憶や、同じ手順を繰り返し実行するループは、モデル単体には備わっていません。また、「ファイルを開いて」「検索して」といった操作を文章で指示することはできますが、実際に手を動かすのは、モデルの外側にあるハーネス(実行層)の仕事です。
スキャフォールド(定義層) AIに「どんな仕事をさせるか」を書き込む設計図の層です。たとえば、システムプロンプト(AIへの基本指示)、使えるツールの一覧と説明、AIの返答をどう解釈するか(パース)、作業の各段階で何を覚えておくか、といったルールがここに入ります。モデル本体は変えず、その外側で「こう動いてください」と決める部分です。
ハーネス(実行層) モデルを呼び出し、ループを回し、ツール呼び出しを処理し、いつ止まるかを決める層です。モデルを実際に「動かす」仕組みそのものを指します。
エージェント 「モデル+それを動かすすべての仕組み」と定義されます。単に応答するだけでなく、ループの中で行動するシステム全体を意味します。
記事には、「Claude Code は Claude の周囲にあるエージェントハーネスとして機能する」という記述もあります。つまり、Claude というモデル本体の外側に、実際に作業を進めるための実行の仕組みがある、というイメージです。
AI業界の文脈では
「AIエージェントの用語が混乱しているのは、分野の発展が速いからだ」という見方が一般的です。その前提に立てば、今回の用語集は「成熟の証」と読めます。
しかし、その前提には見落としがあります。scaffold(定義層)は、プロンプトの変更で比較的コストなく調整できます。一方、harness(ループ制御)は「誰が実装するか」がまだ競われています。Anthropic は Claude Code というハーネスを自社で提供し、OpenAI は Codex というハーネスを持ちます。Hugging Face は smolagents(スモールエージェンツ)というフレームワークを持っています。それぞれが「harness」という言葉を、自社の設計思想に沿って使っています。
用語が一致しない直接の原因は、「ループ制御をどの層が担うか」という設計の境界が、まだ業界全体で決まっていないことにあります。
私の見立て
この用語集の意味は、「定義を整理した」こと以上に、「scaffold と harness という設計の境界線を示した」点にあると思います。
scaffold(定義層)の変更は、ほぼコストゼロで即反映できます。harness(ループ制御)の設計を変えると、フレームワーク全体に影響が出ます。この区別なしに設計すると、後から変えたい部分が深いところに埋まってしまいやすい。AIエージェントの開発で「動かない原因がどの層にあるのか分からない」という混乱が起きやすいのも、この境界が曖昧なまま実装が進んでいることが一因だと見ています。
Hugging Face がこの用語集を出す動機には、自社フレームワーク(smolagents)の設計思想を、業界の基準線に近づけたい意図がある可能性もあります。「共通言語を作る」動きは、標準化をめぐる競争でもあります。ただし、記事自体は「これが正しい定義だ」とは言っておらず、「議論をしやすくするための実用的な考え方を提供する」という控えめな立場を取っています。
→ 何が変わるか: scaffold と harness の区別が広まると、AIエージェントの導入プロジェクトで「何をプロンプト調整で対応できるか」「何がフレームワーク側の問題か」という切り分けが早くなります。現在は、問題の原因がどの層にあるのかを特定するのに時間がかかることが多いです。
→ 何をすべきか: AIエージェントツール(Claude Code、Cursor、Codex など)を使っているなら、ハーネス(ループ制御)はそのツールが担っている、と理解したうえで、自社でカスタムが必要な部分がスキャフォールド(プロンプトやツール定義)の範囲に収まるかを確認するといいでしょう。その判断が、AIエージェント活用の設計方針を決める出発点になります。