context-master

Context Master

複雑なタスク、長時間のセッション、複数ファイルのプロジェクトに対応する、汎用的なコンテキスト管理および計画スキルです。Web アプリ、API、Claude Code CLI のどれを使用していても同じように機能します。CLI 固有の追加機能については references/claude-code-cli.md をご覧ください。

この SKILL.md は意図的に短くしています。詳細は references/ にあります。必要なものだけ読み込んでください。

有効にするタイミング

次のいずれかに該当する依頼では、積極的に有効にしてください。

• 複数ファイルのプロジェクト（関連するファイルが 3 つ以上、ウェブサイト、アプリ、API、ドキュメント一式）。
• アーキテクチャや技術の選択（「X と Y のどちらを使うべきか」「どの方法がよいか…」など）。
• 調査／比較／トレードオフ分析。
• リファクタリングや移行作業。
• コンテキストの効率が重要となる長時間のコーディングセッション。
• 連続する手順が 3 つ以上あるタスクや、依存関係を共有するタスク。

依存関係のない単一ファイルの依頼では、このスキルを使用しないでください。

5 ステップのワークフロー（覚えておくこと）

あらゆる複数ファイルのプロジェクト（ウェブサイト、アプリ、API、ドキュメント一式）で、次の 5 つのステップを順番に実行してください。

1. STOP — まだファイルを作成しないでください。
2. PLAN — 拡張思考 または 計画ドキュメントを使用してください（どちらも同等に有効です。references/multi-file-planning.md を参照）。
3. ANNOUNCE — ファイルの一覧と作成順をユーザーに伝えてください。
4. CREATE — 最適な順序でファイルを書き込みます（依存される側より基盤を先に）。
5. VERIFY — すべての参照先が解決されることを確認し、完了を宣言する前に問題を修正してください。

実例（ポートフォリオサイト）

User: "Create a portfolio with home, about, projects, and contact pages."

Step 1 STOP    -- do not start with index.html.
Step 2 PLAN    -- "Think hard about architecture: 5 files needed,
                  styles.css is the shared dependency."
Step 3 ANNOUNCE -- "I'll create:
                  1. styles.css       (shared styling)
                  2. index.html       (references styles.css)
                  3. about.html
                  4. projects.html
                  5. contact.html"
Step 4 CREATE   -- write files in that order.
Step 5 VERIFY   -- every HTML file links styles.css; navigation resolves.

Result: no refactor, no re-export, no broken links.

完全なテンプレート、プロジェクトの種類（ウェブサイト／React／バックエンド API など）ごとの最適な順序のパターン、検証チェックリストは references/multi-file-planning.md にあります。

基本原則（各 1 行）

1. 書く前に計画する — 拡張思考か計画ドキュメントのどちらかを使い、どちらも省略しないでください。
2. 基盤を先にする — 共有依存関係（CSS、設定、基底クラス、スキーマ）は、依存するものより先に用意します。
3. 詳細な分析は隔離されたコンテキストに委ねる — サブエージェント（CLI）や思考アーティファクト（Web／API）を使い、メインスレッドを整理した状態に保ちます。
4. フェーズの境界を明確にする — コンテキストが曖昧にならないよう、「フェーズ 1 完了。フェーズ 2 に移ります：…」のように各フェーズに名前を付けます。
5. インラインの内容より成果物を使う — 長いコードやドキュメントは、チャット履歴ではなく成果物やファイルに保存します。
6. 段階的に開示する — 一度に 1 つの範囲を依頼し、無関係な手順をまとめて依頼しないでください。
7. リセットを明示する — 方向転換するときは「これまでのアプローチはいったん脇に置いて…」と伝えます。
8. 大規模なプロジェクトの後に振り返る — 計画は立てられていたか、参照先に問題は起きなかったかを確認します。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 "Ultrathink about [decision]" — 約 5K トークンの推論を別途実行し、メインコンテキストには約 200 トークンの要約を返します（効率は約 23 倍）。
• Web／API："Create a deep-analysis artifact and ultrathink about [decision]" — 同じ考え方で、サブエージェントの代わりにアーティファクトを使用します。

トリガー、アンチパターン、すぐに使えるプロンプトについては、references/thinking-delegation.md をご覧ください。

よくあるワークフロー（概要のみ）

それぞれの手順については、references/workflows.md にステップごとの説明があります。

• ワークフロー 0 — 複数ファイルのウェブサイト／プロジェクト作成（デフォルト — 上記と同じ 5 ステップを、より詳しく説明します）。
• ワークフロー 1 — 複雑な意思決定（アーキテクチャ、技術の選択）。
• ワークフロー 2 — 複雑な機能開発（分析 → 設計 → 実装 → テスト → 統合）。
• ワークフロー 3 — 調査と技術評価。
• ワークフロー 4 — アーティファクトを使ったコード生成と反復。
• ワークフロー 5 — 分析を分離したリファクタリング。

アンチパターン（避けてください）

概要 — 例と対策については、references/anti-patterns.md を参照してください。

1. 計画前にファイルを作成する — リファクタリングにコンテキストを浪費します。
2. すべてを一度に依頼する — コンテキストを圧迫し、浅い出力になります。
3. 長いコードやドキュメントをチャットに直接書き込む — 履歴が肥大化します。アーティファクトやファイルを使ってください。
4. 深い推論をメインスレッドで行う — 約 5K トークンを消費しますが、約 200 トークンで済む場合があります。
5. フェーズの境界を設けない — 関連性のないサブタスク間でコンテキストが曖昧になります。

トラブルシューティング

セッションの内容が逸れてきた場合（回答に焦点が合わない、会話が長くなりすぎる、コードが編集されずに再生成される、拡張思考が機能しないなど）は、references/troubleshooting.md を参照してください。ウェブ／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 のプロジェクト後のセクションを振り返ってください。