CLAUDE.md を外部作業メモリとして活用する
コーディングセッションを再開するたびに時間を無駄にするのは、もうやめましょう。
ある開発者は、CLAUDE.md ファイルがない状態でプロジェクトを再開すると、状況を把握するために最大15分もの精神的労力を費やしていることに気づきました。どこまで作業を進めたかを確認しなければならないからです。構造化された CLAUDE.md を作成した後は、その時間は1分未満に短縮されました。
CLAUDE.md は、あなたの「外部作業メモリ」として機能します。Claude Code は、セッションの開始時にこのファイルを自動的に読み込みます。ファイルを貼り付けたり、AI に存在を教えたりする必要はありません。ただ、それだけで機能するのです。
次の2つのファイルを使用することをお勧めします。
- プロジェクトルートの
./CLAUDE.md。技術スタックやコーディング規約など、プロジェクト固有のルールに使用します。 - グローバルルール用の
~/.claude/CLAUDE.md。好みの文章スタイルなど、すべてのプロジェクトに適用したい事項に使用します。
精神的なエネルギーには限りがあります。Slack のメッセージやメールなどの割り込みが入ると、頭の中の「作業用メモ（スクラッチパッド）」は消えてしまいます。作業に戻ったとき、文脈を再構築するために時間を浪費することになります。CLAUDE.md は、そのメモを頭の中からファイルへと移してくれるのです。
これにより、主に4つの問題が解決されます。
- 技術スタックを記憶するため、再度説明する必要がなくなります。
- コーディング規約を記憶するため、同じ命名規則を何度も決める必要がなくなります。
- あなたの文章スタイルを記憶するため、出力があなたらしいものになります。
- 現在のタスクを記憶するため、どこから開始すべきかが明確になります。
プロジェクトルートに、以下の4つのヘッダーを持つ CLAUDE.md ファイルを作成してください。
Project Name
Stack
- 使用しているツールをここにリストアップします。
Voice
- AI にどのように書いてほしいかを記載します。
Gotchas
- 回避すべき間違いをリストアップします。
Current checkpoint
- 完了した最後のタスク。
- 次に行うべきタスク。
- 進行を妨げている要因。
「Current checkpoint」ヘッダーが最も重要です。これにより、Claude はあなたが今どこにいるのかを正確に把握できます。セッションを開始すると、Claude はチェックポイントを読み取り、すぐに次のステップを提示してくれます。
設定手順：
- プロジェクトルートで
touch CLAUDE.mdを実行します。 - 上記の4つのヘッダーを追加します。
- 分かっている情報を記入します。
- 個人の好みのために、
~/.claude/CLAUDE.mdにグローバルファイルを作成します。
Claude が質問してきた内容で、「これを知っておいてほしかった」と思う答えがあれば、その都度ファイルに書き込んでください。使うたびに、ファイルはより洗練されていきます。
常に最新の状態に保ってください。古い CLAUDE.md ファイルは誤った情報をもたらします。技術スタックやワークフローを変更したら、すぐにファイルを更新しましょう。
Source: https://dev.to/gentic_news/use-claudemd-as-external-working-memory-5f01
学習コミュニティ（任意参加）: https://t.me/GyaanSetuAi