コンテキストマスター
複雑なタスク、長時間のセッション、マルチファイルプロジェクトのためのユニバーサルコンテキスト管理・計画スキル。Webアプリ、API、Claude Code CLIのいずれでも同じように動作します。CLI固有のボーナス機能については、references/claude-code-cli.mdを参照してください。
このSKILL.mdは意図的に短くしてあります。詳細な資料はreferences/にあります。必要なものだけを読み込んでください。
アクティベートすべきタイミング
リクエストが以下のいずれかに該当する場合は、積極的にアクティベートしてください。
- マルチファイルプロジェクト（3つ以上の関連ファイル、ウェブサイト、アプリ、API、ドキュメントセット）
- アーキテクチャまたは技術の意思決定（「XとYどちらを使うべきか」「どのアプローチが…」）
- 調査 / 比較 / トレードオフ分析
- リファクタリングまたは移行作業
- コンテキスト効率が重要となる長時間のコーディングセッション
- 3つ以上の連続ステップ、または共有依存関係を持つタスク
リクエストが依存関係のない単一ファイルの場合は、このスキルはスキップしてください。
5ステップワークフロー（これを覚えてください）
あらゆるマルチファイルプロジェクト（ウェブサイト、アプリ、API、ドキュメントセット）に対して、以下の5つのステップを順番に実行します。
- STOP — まだファイルを作成しないでください。
- PLAN — 拡張思考 または 計画ドキュメントを使用します（どちらも同様に有効です。
references/multi-file-planning.mdを参照）。 - ANNOUNCE — ファイルリストと作成順序をユーザーに伝えます。
- CREATE — 最適な順序でファイルを作成します（依存するものより先に基盤を作成）。
- VERIFY — すべての参照が解決されていることを確認し、問題を修正してから完了とします。
サンプルワークフロー（ポートフォリオウェブサイト）
ユーザー: 「ホーム、アバウト、プロジェクト、コンタクトの各ページがあるポートフォリオを作成してください。」
ステップ1 STOP -- index.htmlから始めない。
ステップ2 PLAN -- 「アーキテクチャについて深く考える：5つのファイルが必要。
styles.css が共有依存関係。」
ステップ3 ANNOUNCE -- 「以下の順序で作成します：
1. styles.css （共有スタイリング）
2. index.html （styles.cssを参照）
3. about.html
4. projects.html
5. contact.html」
ステップ4 CREATE -- この順序でファイルを作成。
ステップ5 VERIFY -- すべてのHTMLファイルがstyles.cssにリンクされているか、ナビゲーションが解決されているかを確認。
結果: リファクタリング不要、再エクスポート不要、リンク切れなし。
完全なテンプレート、プロジェクトタイプ別の最適順序パターン（ウェブサイト/React/バックエンドAPIなど）、および検証チェックリストは、references/multi-file-planning.mdにあります。
中核原則（各1行）
- 書く前に計画する — 拡張思考または計画ドキュメントのどちらかは必ず行い、両方をスキップしない。
- 基盤を先に — 共有依存関係（CSS、設定、ベースクラス、スキーマ）は依存するものより先に作成する。
- 深い分析は分離されたコンテキストに委譲する — サブエージェント（CLI）または思考成果物（Web/API）がメインスレッドをクリーンに保つ。
- フェーズの境界 — 各フェーズに名前を付ける（「フェーズ1完了。フェーズ2に移行: …」）ことで、コンテキストが混ざるのを防ぐ。
- インラインコンテンツより成果物 — 長いコードやドキュメントは、チャット履歴ではなく成果物/ファイルに保存する。
- 段階的開示 — 一度に1つのスライスだけを要求する。無関係なステップをまとめてバッチ処理しない。
- リセットの合図 — 方向転換するときは「以前のアプローチは一旦脇に置きます…」と言う。
- 大規模プロジェクト後に振り返る — 計画通りに進んだか？ 参照は壊れていなかったか？
references/multi-file-planning.mdのプロジェクト後チェックリストを使用する。
各原則の完全な説明と例: references/universal-best-practices.md
トークン節約の目安
| プロジェクトサイズ | 計画なし | 計画あり | 節約率 |
|---|---|---|---|
| 小 (3-4 ファイル) | ~6,000 トークン | ~2,500 トークン | ~58% |
| 中 (7-8 ファイル) | ~12,000 トークン | ~4,500 トークン | ~63% |
| 大 (20+ ファイル) | ~35,000 トークン | ~12,000 トークン | ~66% |
200Kトークンのコンテキストウィンドウには、計画ありで中規模プロジェクト約16～17個、計画なしで7～8個が収まります。実効的な増加率は2.1倍です。数値と方法論の詳細はreferences/multi-file-planning.mdを参照してください。
受動的深層思考アーキテクチャ
コンテキスト効率を最大限高めるための最も強力なパターン：深い推論を分離された空間にルーティングし、短いサマリーだけをメインスレッドに返します。
- Claude Code CLI:
/agent deep-analyzer "[決定]について深く考える"— 約5Kトークンの推論が帯域外で行われ、メインコンテキストには約200トークンのサマリーが届きます（約23倍の効率）。 - Web / API:
"深層分析の成果物を作成し、[決定]について深く考える"— 同じ考え方ですが、サブエージェントの代わりに成果物を使用します。
トリガー、アンチパターン、および既成のプロンプト: references/thinking-delegation.md
一般的なワークフロー（参照先のみ）
これらの各ワークフローには、references/workflows.mdにステップバイステップの手順があります。
- ワークフロー0 — マルチファイルウェブサイト/プロジェクト作成（デフォルト。上記の5ステップと同じですが、より詳細です）。
- ワークフロー1 — 複雑な意思決定（アーキテクチャ、技術選定）。
- ワークフロー2 — 複雑な機能開発（分析 → 設計 → 実装 → テスト → 統合）。
- ワークフロー3 — 調査と技術評価。
- ワークフロー4 — 成果物によるコード生成と反復。
- ワークフロー5 — 分離分析によるリファクタリング。
アンチパターン（避けるべきこと）
クイックリスト — 例と修正方法はreferences/anti-patterns.mdを参照:
- 計画前にファイルを作成する — リファクタリングでコンテキストを浪費する。
- すべてを一度に要求する — コンテキストを過負荷にし、浅い出力を生み出す。
- 長いコードやドキュメントをチャットにインライン化する — 履歴を肥大化させる。成果物/ファイルを使用する。
- 深い推論をメインスレッドで行わせる — 約200トークンで済むところに約5Kトークンを費やす。
- フェーズ境界なし — 無関係なサブタスク間でコンテキストが混ざる。
トラブルシューティング
セッションが漂流し始めたら（応答が散漫、会話が長くなりすぎている、コードが編集ではなく再生成されている、拡張思考が機能していない）、references/troubleshooting.mdを参照してください。Web/APIとCLIを個別にカバーした、症状→対策の表があります。
Claude Code CLI ボーナス
Claude Code CLIで実行している場合、以下も利用できます:
/clear,/compact,/continue— 組み込みのコンテキスト制御。/agent <name>— 分離されたサブエージェントに委譲する。CLAUDE.md— 永続的なプロジェクトメモリ。CLAUDE.mdとサブエージェント定義を生成するためのヘルパースクリプト。
詳細、スクリプトの呼び出し方、および深層分析委譲パターン: references/claude-code-cli.md
スキルとサブエージェントの統合パターン（両方利用可能な場合）は、references/agent-skills-integration-2025.mdにあります。長文コンテキスト戦略とサブエージェントプロンプトパターン: references/context_strategies.mdおよびreferences/subagent_patterns.md。
リファレンスマップ
| ファイル | 使用タイミング |
|---|---|
references/multi-file-planning.md | 計画テンプレート、プロジェクトタイプ別の最適順序パターン、検証チェックリスト、プロジェクト後の振り返りが必要なとき。 |
references/universal-best-practices.md | 8つの中核原則のいずれかの根拠や例が必要なとき。 |
references/workflows.md | 特定のシナリオ（意思決定、機能、調査、リファクタリング）のステップバイステップ手順が必要なとき。 |
references/thinking-delegation.md | 深層分析の委譲を設計するとき、または思考プロンプトを作成するとき。 |
references/anti-patterns.md | 現在のアプローチがコンテキストを無駄にしていないか確認するとき。 |
references/troubleshooting.md | セッションが漂流、低速、または説明が多すぎるとき。 |
references/claude-code-cli.md | Claude Code CLIで実行しており、サブエージェント/CLAUDE.mdツールが必要なとき。 |
references/agent-skills-integration-2025.md | CLIでスキルとサブエージェントを組み合わせるとき。 |
references/context_strategies.md | 長文戦略ノート。 |
references/subagent_patterns.md | サブエージェントのプロンプトパターン。 |
成功の指標
- ファイルを作成する前に計画を発表した。
- 基盤ファイル（CSS、設定、スキーマ）が依存するものより先に作成された。
- 初回実行で参照が壊れなかった。リファクタリングは不要だった。
- 深い推論はサブエージェントまたは成果物で行われ、メインスレッドでは行われなかった。
- フェーズを越えるたびに名前が付けられた。
これらのいずれかが失敗した場合は、次のタスクの前に、references/anti-patterns.mdとreferences/multi-file-planning.mdのプロジェクト後セクションを見直してください。