Harness Atlas

COURSE 01 · FUNDAMENTALS

Harness Engineering

AIエージェントを安定して動かすための基本構造を理解し、最小のハーネスを自分で組み立てます。

入口:まず読む3本

  1. 01ハーネスとは何かモデルだけではAIエージェントは安定して動かない。モデルを働かせる枠組み=ハーネスの役割と、その心臓部にあるエージェントループを理解する。
  2. 02Harness Engineeringとは何かモデルを変えず、その周りの指示・ツール・実行の流れ・評価を設計して、エージェントの出力を信頼できる品質に引き上げる営み。2026年に注目された理由と、一次情報を押さえる。
  3. 03Harnessが複数になると何が起きるか1つのハーネスで足りるうちはよい。チームや用途が増えてハーネスが複数になると、履歴・ポリシー・コスト・ツール・本人確認が分断する。その分断がメタハーネスの出番を作る。

詳しく学ぶ(詳細編)8本

下の「このコースで学ぶこと」の各トピックを、1トピック1レッスンで深掘りします。公開済みのものから読めます。

  1. 04エージェントループを深く見るハーネスの心臓部は「考える・動く・観察する」の繰り返し。その一周で何が起きるか、なぜ止まらなくなるのか、どう止めるのかを、実装の視点で掘り下げる。
  2. 05コンテキストの設計ループが一周するたびに積み上がるコンテキストを、何を入れ何を削るかで設計する。窓の限界に対して、compaction・外部メモ・サブエージェントという3つの戦略を見る。
  3. 06ツールとMCPループの「動く」を担うのがツール。モデルはツールを呼んで外界に触れる。ツールの仕組み(スキーマ定義・同意)と、つなぎ方の標準MCP(Tools・Resources・Prompts)を見る。
  4. 07実行環境とサンドボックスの基本エージェントはコマンドを実行し、ファイルを書き換える。それが走る場所(ランタイム)と、被害を閉じ込める隔離(サンドボックス)の設計が、安全と安定を左右する。囲い方の全体像を見る。
  5. 08サンドボックスの仕組み(OSレベル)ツールに外界を触らせるなら、どこまで触れるかを囲う必要がある。ファイルとネットワークの2層、OSネイティブの仕組み(Landlock・seccomp・Seatbelt)、既定で狭くする設計を深く見る。
  6. 09スキルと段階的開示ツールが「何ができるか」なら、スキルは「どうやるか」を必要なときに渡す仕組み。SKILL.mdと、コンテキストを軽く保つ段階的開示(progressive disclosure)の3段を見る。
  7. 10会話履歴の保存・Clear・Resumeの内部構造ハーネスは会話履歴をローカルに永続保存し、/clearで現在の文脈から切り離し、/resumeで読み直して再構築する。Claude CodeとCodexの保存先と挙動を一次情報で確認し、会話は戻せても実行環境は戻らない、という設計の境界を見る。
  8. 11Evals(評価)ハーネスを磨くには、良くなったかを測る必要がある。最後の結果だけでなく、途中の軌跡(trajectory)を見る。成功率・進捗率、見かけだけの成功、LLMを審判にする方法を見る。

各ハーネスの中身(内部アーキテクチャ)5本

Claude Code・Codex・Cursor・Devin の内部を、共通の軸(ループと権限・コンテキストとセッション・ツールと拡張・実行環境)と、そのハーネス固有の構造でハーネス別に見ます。

  1. 12Claude CodeとCodexのハーネスを比較する同じコーディングエージェントでも、ハーネスの作りは違う。Claude CodeとCodexを並べ、共通の土台と設計の重心の違いを中立に読み解く。各ハーネスの中身へ入る導入。
  2. 13Claude Code の内部アーキテクチャAnthropicのCLIエージェントClaude Codeを、共通の軸(ループと権限・コンテキストとセッション・ツールと拡張・実行環境・サブエージェント)で内部から見る。公式ドキュメントで確認した機能を中立に整理する。
  3. 14Codex の内部アーキテクチャOpenAIのCodexを、Claude Codeと同じ軸で内部から見る。OSレベルのサンドボックスと承認ポリシー、AGENTS.mdとセッション、MCP、そしてOSS実装とApp Serverによる埋め込み性。公式ドキュメントとソースで確認した範囲を中立に整理する。
  4. 15Cursor の内部アーキテクチャAnysphereのAIコードエディタCursorを、同じ軸で見る。Run Modesによる段階的な自動実行とallowlist、Rulesとオンデマンドの文脈取得、MCP、そしてエディタ統合(Tab・Agent・Composer)という固有の構造。公式ドキュメントの範囲で中立に整理する。
  5. 16Devin の内部アーキテクチャCognitionの自律型エージェントDevinを、同じ軸で見る。BrainとDevboxの分離、計画してから実行する流れ、KnowledgeとPlaybooks、Devin MCPとSlack/API。クラウドで任せて走らせる設計を、公式ドキュメントの範囲で中立に整理する。

このコースで学ぶこと

  • Agent Loop
  • Context
  • Tools
  • Sandbox
  • Skills
  • State
  • Evals

次に読む

さらに詳しく(書籍サポート):ハーネス別ガイド

すべてのコースハーネス比較