Claudeコードにおけるシステムプロンプトの肥大化を削減するため、CLAUDE.mdファイルを圧縮する

Claudeのコンテキスト使用量の最適化

Claude Codeは、プロジェクトレベルのCLAUDE.mdファイル、~/.claude/CLAUDE.mdにあるグローバルファイル、永続メモリシステムファイルを含むすべての会話に、CLAUDE.mdファイルをシステムプロンプトのコンテキストとして挿入します。これらのファイル内のすべての文字は、Claudeがユーザーのリクエストに対応する前に処理するコンテキストを消費し、信号対雑音比が低い場合にパフォーマンスを低下させる可能性があります。

圧縮アプローチ

著者は、人間が読みやすい装飾を取り除き、機械が読み取れる信号のみを保持することを以下のルールで提案しています：

マークダウンの装飾を削除：ヘッダー（##）、太字（**）、斜体（*）、水平線（---）
文章を表記に圧縮：説明文の代わりにコンパクトなキーと値のペアやパイプ区切りのリストを使用
冗長な枠組みを削除：「このセクションには...」や「次の表は...を示しています」などの文章を排除
ファイル間の重複コンテキストを排除：同じ情報を一つの正規の場所に保持
表の書式を圧縮：冗長なマークダウンの表をコンパクトな表記に置き換える

圧縮前後の例

ディレクトリインデックスの表の例：

圧縮前（マークダウンの表）：

## ディレクトリ
| ディレクトリ | 内容 | 読むタイミング |
|-------------|-----------------------------|---------------------------------------|
| src/ | アプリケーションのソースコード | アプリケーションロジックを扱う時 |
| infra/ | TerraformとAnsibleファイル | インフラストラクチャを変更する時 |
| docs/ | アーキテクチャのドキュメント | システム設計を理解する時 |
| scripts/ | デプロイとユーティリティスクリプト | デプロイワークフローを実行または編集する時 |

圧縮後：

Dirs: src/=アプリケーションのソースコード | infra/=terraform+ansible | docs/=アーキテクチャのドキュメント | scripts/=デプロイ+ユーティリティスクリプト

メモリシステムの指示の例：

圧縮前：

## メモリシステム
永続メモリは `/path/to/memory/` に保存されます。
**セッション開始時**：このリポジトリで実質的な作業を行う際に、コンテキストを再確立するために `memory/_index.md` を読みます。
**作業中** — 重要なことが起こった時にメモリに書き込みます：
- 発見や非自明な事実 → `memory/discoveries.md` に追加
- 適用または学習した新しいスキル → `memory/skills.md` を更新

圧縮後：

Memory: /path/to/memory/
session-start: 実質的な作業の際に _index.md を読む
during-work (重要なイベントのみに書き込み、雑音ではなく信号を)：
discovery → memory/discoveries.md に追加
skill learned → memory/skills.md を更新