context-engineering

コンテキストエンジニアリング

概要

基本原則： コンテキストは有限のリソースであり、追加しても効果は次第に薄れます。最大量ではなく、シグナルの強いトークンを最小限に絞ります。

200K トークンは共有領域です。システムプロンプト、会話履歴、処理内容が含まれます。コンテキストが増えるにつれて、パフォーマンスは予測可能な形で低下します。

使用する場面

• セッションが30分を超える、またはトークン数が50k以上
• 指示が無視されたり、忘れられたりする
• 繰り返し説明が必要になる
• マルチエージェントのワークフローを計画する
• セッション間の引き継ぎを準備する

クイックリファレンス

問題	症状	対策
中間部での見落とし	会話中盤の指示が無視される	重要な情報を最初か最後に移す
コンテキストの汚染	エラーが重なり、幻覚が参照される	要約してリセットする
コンテキストの注意散漫	無関係な情報でパフォーマンスが低下する	積極的に削除する
コンテキストの混乱	指針の矛盾により一貫性がなくなる	指示をまとめる

劣化のパターン

1. 中間部での見落とし効果

コンテキストの中間にある情報は、端にある情報より想起率が10〜40％低くなります。

[START - High attention]
  ↓
[MIDDLE - Low attention zone]  ← Instructions here get ignored
  ↓
[END - High attention]

対策： 戦略的に配置する

• 重要な指示 → 最初（システムプロンプト、最初のユーザーメッセージ）
• 直近の決定事項 → 最後（直近の数メッセージ）
• 参照資料 → 中間（検索用途には適していますが、指示には不向き）

2. コンテキストの汚染

初期の幻覚が参照される → 積み重なる → 「事実」になる。

症状：

• 以前の事実と矛盾する断定的な発言
• 実際には話していないことへの「先ほど話したように……」という言及
• 過去の誤りを根拠とする循環論法

対策： チェックポイントを設けて要約する

Every 10-15 exchanges, create explicit checkpoint:

"Let me summarize what we've established:
1. [Verified fact]
2. [Verified fact]
3. [Decision made]

Continuing from here..."

3. コンテキストの注意散漫

無関係なトークンが注意力の予算を奪い合います。

症状：

• 無関係な過去の話題に言及した応答
• 現在のタスクから注意がそれる
• 古いコンテキストに関する不要な但し書き

対策： 積極的に削除する

• 新しいコンテキストにするには、/clear と要約を使う
• マルチエージェントでは、サブエージェントには関連するコンテキストのみを渡す
• 解決済みの議論は現在の検討対象から取り除く

4. コンテキストの混乱

矛盾する複数の指示により、挙動に一貫性がなくなります。

症状：

• 複数のアプローチを交互に採用する
• 「一方では……、他方では……」と両論を並べて曖昧にする
• ある指示に従うため、別の指示を無視する

対策： 指示をまとめる

Before: "Use TypeScript" (message 3) + "Keep it simple" (message 12) + "Add types everywhere" (message 27)

After: "TypeScript with practical typing - types where they help, skip where obvious"

最適化のテクニック

コンパクション

上限に近づいたら、コンテキストの各セクションを要約します。

## Session Summary (compacted)

**Goal:** [One sentence]
**Decisions made:**
- [Decision 1]
- [Decision 2]
**Current state:** [What's done, what's next]
**Key constraints:** [Still-active requirements]

---
[Continue with fresh context]

観測結果のマスキング

冗長なツール出力を簡潔な参照情報に置き換えます。

Before: [500 lines of file content in context]
After: "Read src/app/page.tsx - React component with Hero, About, FAQ sections"

コンテキストの分割（マルチエージェント）

サブタスクを、整理されたコンテキストを持つ個別のエージェントに分離します。

Main Agent (orchestrator):
  - High-level plan
  - Synthesis of results

Subagent 1 (search):        Subagent 2 (implement):
  - Only search context       - Only implementation context
  - Returns summary           - Returns code

ルール： サブエージェントに渡すのは、タスクと必要最小限のコンテキストのみです。会話履歴全体は渡しません。

実践的なワークフロー

長時間セッションの場合（1時間超）

digraph context_management {
  "Every 15-20 min" [shape=diamond];
  "Context healthy?" [shape=diamond];
  "Continue" [shape=box];
  "Create checkpoint summary" [shape=box];
  "Consider /clear + summary" [shape=box];

  "Every 15-20 min" -> "Context healthy?";
  "Context healthy?" -> "Continue" [label="yes"];
  "Context healthy?" -> "Create checkpoint summary" [label="degrading"];
  "Create checkpoint summary" -> "Consider /clear + summary";
}

健全性を確認する質問：

• 直近の指示に従っていますか？
• 現在のタスクに集中できていますか？
• 応答が曖昧になったり、断定を避けたりしていませんか？

引き継ぎの場合（/save-session）

次のセッションのために、以下を記録します。

1. 目標の状態 - 何を達成しようとしていたか？
2. 現在の状態 - 何が完了し、何に問題があるか？
3. 重要な決定事項 - なぜ Y ではなく X を選んだのか？
4. 適用中の制約 - どのルールが引き続き適用されるか？
5. 次のステップ - どこから再開するか？

サブエージェントの場合

## Subagent Prompt Template

**Task:** [Specific deliverable]
**Context:** [ONLY what's needed - 50-200 words max]
**Constraints:** [Hard requirements]
**Output format:** [What to return]

[Do NOT include: conversation history, resolved discussions, unrelated files]

アンチパターン

アンチパターン	失敗する理由	よりよい方法
「念のため、すべて含める」	注意が分散し、注意散漫を招く	今必要なものだけを含める
毎回のメッセージで指示を繰り返す	トークンを浪費し、指示が伝わっていないかのように見える	システムプロンプトを信頼し、無視された場合のみ念押しする
要約なしでファイルを大量に貼り付ける	中間部での見落とし効果が起きる	読む → 要約する → 要約を参照する
解決済みの話題を残し続ける	コンテキストが混乱する	解決内容を要約して、先に進む

トークン予算のガイドライン

コンテキストサイズ	期待される品質	対応
< 20k	最適	通常どおり続行
20-50k	良好	品質低下を監視
50-100k	低下中	積極的な管理が必要
100-150k	低い	近いうちに要約してリセット
> 150k	危機的	チェックポイントを作成してリセット

重要な洞察

「目標は、200K トークンをすべて使うことではありません。成果を得るために必要な最小限のトークンを使うことです。」

網羅性より情報価値を重視します。現在の判断に重要な情報を含め、それ以外は除外し、必要に応じて追加情報にアクセスできるシステムを設計します。

---

Claude が担うことと、あなたが決めること

Claude が担うこと	あなたが行うこと
コンテキストの状態を監視する	リセットするか続行するかを決める
チェックポイントの要約を作成する	要約が正確か検証する
無関係な内容を削除する	何がまだ必要か判断する
サブエージェント向けプロンプトを構成する	タスクを戦略的に分解する
品質低下のパターンを検出する	介入のタイミングを決める

---

スキルの適用範囲

このスキルが特に適している場合：

• 長時間のセッション（>30 min、>50k tokens）
• 引き継ぎを伴うマルチエージェントのワークフロー
• 複数のセッションにまたがる複雑なプロジェクト
• 「指示を忘れる」問題のデバッグ

このスキルがあまり適していない場合：

• 短く焦点の絞られたやり取り → 不要です
• 1 回限りのクエリ → オーバーヘッドが不要です
• コンテキストが自然に制限されるタスク → すでに制約されています

---

スキルのメタデータ

name: context-engineering
category: meta
version: 2.0
author: GUIA
source_expert: Anthropic research, NeoLabHQ context-engineering-kit
difficulty: advanced
mode: centaur
tags: [context, tokens, memory, multi-agent, handoff, optimization]
created: 2026-02-03
updated: 2026-02-03