Harness Atlas

COURSE 01 · Harness Engineering

コンテキストの設計

ループが一周するたびに積み上がるコンテキストを、何を入れ何を削るかで設計する。窓の限界に対して、compaction・外部メモ・サブエージェントという3つの戦略を見る。

これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。前のエージェントループを深く見るの続きで、ループで最も結果を左右するコンテキストを扱います。

コンテキストとは、渡す情報の全部

モデルは、その一回の推論で見える情報からしか判断できません。この見える情報の全部がコンテキストです。エージェントループは一周ごとにここへ情報を足していくので、放っておくと際限なく膨らみます。だから、何を入れて何を削るかを設計する必要があります。これをコンテキストエンジニアリングと呼びます。

何がコンテキストに入るのか、整理しておきます。

  • システムプロンプト(ハーネスがモデルに渡す土台の指示)
  • CLAUDE.md や AGENTS.md のような、プロジェクトやユーザーの決まりごと
  • 読み込んだファイルの中身
  • ツールを実行した結果
  • これまでの会話の履歴

窓には限りがある

モデルが一度に見られる量(コンテキスト窓)には上限があります。長い作業では、トークン数が窓を超えてしまう。大きなコード移行や長い調査のように、数十分から数時間続く作業では、この限界をどう回すかが成否を分けます。

公式ドキュメントによると、長い作業のために補い合う3つの戦略があります(調査時点:2026年11月)。

  • compaction(圧縮):窓の限界が近づいたら、会話を要約して、要約から新しい窓を始め直す。中身を高い忠実度で残し、性能の落ちを抑えます。
  • 構造化したメモ(note-taking):覚えておきたいことを、窓の外に記録しておく。必要なときに読み戻します。
  • サブエージェント:重い脇作業を、別のコンテキストに逃がす。本筋の窓を汚しません。
コンテキスト窓(上限あり) システム・ルール・ファイル・ツール結果・履歴が積み上がる 残り 窓が埋まってきたら、次の3つで回す 圧縮 要約して詰め直す 外部メモ 窓の外に記録 サブエージェント 別の窓へ逃がす
コンテキストは一周ごとに積み上がる。窓の上限に対し、圧縮・外部メモ・サブエージェントで長い作業を回す。

compactの実際の挙動は、このコースの会話履歴の保存・Clear・Resumeの内部構造で見たとおりです。保存には全部残っても、モデルに渡すのは最後の要約と、その後の未圧縮部分でした。

設計の芯

コンテキストは、多ければよいものではありません。関係ないものが混じれば、モデルは迷います。必要なものを、必要なときだけ渡す。次のレッスンで見るツールやスキルも、この「必要なときだけ」を支える仕組みです。

次に読む

次はツールとMCPで、ループの「動く」を担う部分を見ます。各ハーネスが実際にどうコンテキストを扱うかは各ハーネスの中身でも確かめられます。

前のレッスンコースへ戻る次のレッスン