Build Harness

0 から 1 へ Agent と Harness を構築する

会話できる CLI アシスタントから、制御可能で観測可能な Agent Harness へ育てる工程ガイド。

読み始める

順番に読むと、モデルの仕組みから Agent と Harness の工学的な見方までたどれます。

01 Agent の基本定義：なぜ一文の Prompt ではないのか？ガイド多くの人が初めて Agent を作ろうとするとき、まず自然に考えるのはこうです。system prompt を少し長くして、ルールを細かく書けば、モデルは「Agent のように働く」のではないか？
02 Agent の構成モデル：Model、Loop、Tools、State 前回はまず一つの誤解をほどきました。Agent は、より長い prompt ではありません。
03 システム境界：ChatBot、Workflow、Agent、Harness の違い多くの人が初めて Agent システムを作るとき、自然にそれを一つのアップグレード経路として理解しがちです。
04 Harness の基本定義：モデル外部の制御システムここまでで、Agent をいくつかの最小部品へ分解しました。
05 Agent の進化経路：Chat Agent -> Tool Agent -> Runtime Agent -> Managed Agent Agent は Chat から Tool、Runtime、Managed へ進むにつれて、現実のリスクを受け止める制御層を増やしていく。重要なのは能力の序列ではなく、どの現実リスクに触れているかで Harness の厚みを決めることだ。
06 Agent を手書きする意味：フレームワーク抽象の背後にある最小メカニズムを理解するここまでの 5 本では、Agent を「魔法のようなモデル能力」から「説明可能な実行システム」へ引き戻してきた。
07 LLM Provider 接続：CLI に最初のモデル呼び出しを完了させるこれまでの数本では、ずっと Agent と Harness の境界について話してきました。
08 最小 Agent Loop：単発回答から多段階の行動へ前回までの記事では、Agent は一文の Prompt でも、より会話上手なモデルでもなく、制御されたプロセスの中でタスクを継続的に進める実行システムだと整理してきた。
09 M0 Core Kernel：実モデルをシステムへ接続し、システムを乗っ取らせないこれまでの記事では、Agent と Harness の考え方を整理してきました。
10 Intent / Execution の分離：モデルが提案し、システムが実行する多くの人が初めて CLI Agent を書くとき、tool call をかなり直接的に捉えがちです。
11 Plugin Host：なぜ core は拡張されることを覚える必要があるのか？第 10 篇では、とても重要な境界を一つ固定しました。
12 Provider Runtime：なぜ provider は tool intent だけを返すべきなのか前回までの記事群で、私たちは土台となる規律を一つ固めました。
13 Tool Runtime：tool intent から observation へ第 10 回では、ひとつの境界を明確にしました。
14 Local Tool Bundle：ファイル、検索、ターミナルと権限ランタイムここまで来ると、多くの人は Agent のローカル能力を、直感的な関数群として書きたくなります。
15 Context Policy：モデルはこのターンで何を見るべきか？ここまでの記事で、Agent の実行経路はかなり分解できた。
16 Session Replay：なぜ event log は長時間タスクの事実源なのか？多くの人が Agent に永続化を足すとき、最初に自然と messages を保存しようとする。
17 Capability Discovery：Skills、MCP、動的 Tool 公開第 17 篇まで来ると、小さな CLI Agent は最初の「会話しかできないプログラム」ではなくなっている。
18 Delegation Runtime：タスクを外へ渡しても、制御権を失わないここまで来ると、小さな CLI Agent はもう会話するだけのモデルの殻ではない。
19 Trace Analysis：事実ログで Agent 失敗を特定する前の数篇で、小さな CLI Agent はかなり現実的な位置まで来た。
20 Memory Governance：candidate ledger から governance store へ第 20 篇まで来ると、私たちの小さな CLI Agent はすでに多くのことができるようになっています。
21 Scoped Retrieval：境界付き検索から audit snapshot へ多くの人が初めて Agent に検索を加えるとき、話をとても直接的に考えます。
22 Productized CLI：profile、extension、multi-provider ここまで来ると、私たちの小さな CLI Agent は、最初の「一度だけ動く demo」ではなくなっています。
23 Hosted Harness：Sandbox、Cron、Durable Execution とリモートデプロイローカル CLI Agent をリモートのホスト環境へ移し、sandbox、cron、durable execution、workspace setup、secret boundary、artifact store、resume/retry、notification が Hosted Harness をどう構成するかを理解する。
24 Agent Harness 用語マップ：Intent、Observation、Event、Artifact、Snapshot、Projection、Trace の関係 Tool Runtime 以降、このシリーズはより混乱しやすい段階に入りました。
25 0 から 1 へ Agent と Harness を構築する会話できる CLI アシスタントから、制御可能で観測可能な Agent Harness へ育てる実践的な工程ガイド。