COURSE 01 · Harness Engineering
コンテキストの設計
ループが一周するたびに積み上がるコンテキストを、何を入れ何を削るかで設計する。窓の限界に対して、compaction・外部メモ・サブエージェントという3つの戦略を見る。
これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。前のエージェントループを深く見るの続きで、ループで最も結果を左右するコンテキストを扱います。
コンテキストとは、渡す情報の全部
モデルは、その一回の推論で見える情報からしか判断できません。この見える情報の全部がコンテキストです。エージェントループは一周ごとにここへ情報を足していくので、放っておくと際限なく膨らみます。だから、何を入れて何を削るかを設計する必要があります。これをコンテキストエンジニアリングと呼びます。
何がコンテキストに入るのか、整理しておきます。
- システムプロンプト(ハーネスがモデルに渡す土台の指示)
CLAUDE.mdやAGENTS.mdのような、プロジェクトやユーザーの決まりごと- 読み込んだファイルの中身
- ツールを実行した結果
- これまでの会話の履歴
窓には限りがある
モデルが一度に見られる量(コンテキスト窓)には上限があります。長い作業では、トークン数が窓を超えてしまう。大きなコード移行や長い調査のように、数十分から数時間続く作業では、この限界をどう回すかが成否を分けます。
公式ドキュメントによると、長い作業のために補い合う3つの戦略があります(調査時点:2026年11月)。
- compaction(圧縮):窓の限界が近づいたら、会話を要約して、要約から新しい窓を始め直す。中身を高い忠実度で残し、性能の落ちを抑えます。
- 構造化したメモ(note-taking):覚えておきたいことを、窓の外に記録しておく。必要なときに読み戻します。
- サブエージェント:重い脇作業を、別のコンテキストに逃がす。本筋の窓を汚しません。
compactの実際の挙動は、このコースの会話履歴の保存・Clear・Resumeの内部構造で見たとおりです。保存には全部残っても、モデルに渡すのは最後の要約と、その後の未圧縮部分でした。
設計の芯
コンテキストは、多ければよいものではありません。関係ないものが混じれば、モデルは迷います。必要なものを、必要なときだけ渡す。次のレッスンで見るツールやスキルも、この「必要なときだけ」を支える仕組みです。
次に読む
次はツールとMCPで、ループの「動く」を担う部分を見ます。各ハーネスが実際にどうコンテキストを扱うかは各ハーネスの中身でも確かめられます。