Claude実践大全第4章:Claude Projectsによるコンテキストの永続化──毎回ゼロから説明し直す消耗を終わらせる

本記事は、『Claude実践大全:Chat・Cowork・Codeで「動くAI」を仕事に組み込む技術』を1章ずつ紹介するシリーズの第4回です。各記事では1つの章のエッセンスをダイジェストでお届けします。

Claudeを毎日使っていると、必ずぶつかる地味なストレスがあります。新しい会話を開くたびに、コードベースの構成を説明し、出力例を見せ、コーディング規約を伝え……と、すべてが白紙からのやり直しになるのです。本書ではこれを「AIの健忘問題」と呼んでいます。第4章は、この健忘をClaude Projectsでどう克服するかを丁寧に解き明かす章です。

地味に見えて、このコストは積み上がります。アーキテクチャの前提を整えるだけで毎回20分。週に何度も繰り返せば、説明のし直しだけで4〜5時間が溶けていく。さらに深刻なのは、コンテキストがリセットされ続けると、Claudeがあなたのプロジェクトに固有の専門性を育てられないことです。第4章は、そこに永続的な「記憶の層」を与える設計図を示します。

3つの層でできた「永続的なコンテナ」

Claude Projectは、単なる会話履歴の保存場所ではありません。本書では、3つの異なる層を持つ永続的なコンテナとして整理しています。

システムコンテキスト: プロジェクト内のすべての会話に自動適用される、常設の指令。毎回書き直す必要がありません。
ナレッジベース: アーキテクチャ文書やAPI仕様など、いつでも参照できる永続ライブラリ。個々の会話を散らかしません。
会話履歴: 整理され検索可能な状態で保たれる、過去のやり取りとArtifact。

この設計の巧みさは、各層がそれぞれ違う役割を担う点にあります。詳しい層の連携と設計思想は、本書で具体例とともに展開されます。

カスタム指示は「3層」で書く

コンテキスト永続化の中核が、カスタム指示です。本書は、効果的な指示が Foundation（基盤)・Patterns（パターン)・Operational（運用) という3層構造に従うことを示します。中核的な目的と制約を描き、固有の規約を記し、働き方を伝える。この型に沿うだけで、Claudeはあなたの規約を理解した状態で会話を始められます。

威力は比較すると一目瞭然です。指示がなければ「コードベースの構成はこうで、バリデーションはこうで……」と毎回前置きが必要。指示があれば「ユーザー分析を取得するエンドポイントを追加して。日付範囲を受け取り、月次指標を返すものに」と本題だけ伝えればよいのです。

💡 ポイント: カスタム指示は「網羅」ではなく「最重要パターンへの絞り込み」が鉄則。多くてもせいぜい2〜3ページに収め、網羅的な参考素材はナレッジベースに任せます。

陥りがちなアンチパターン

多くのチームが同じ失敗を繰り返します。本書はその典型をいくつも名指しで挙げ、回避策まで示します。たとえば、50ページの設計文書をまるごと貼り付ける「指示の丸投げ」。具体的なファイルパスやホスト名を書いてインフラ変更のたびに壊れる「実装の詳細の混入」。そして「Xをするな、Yをするな」ばかりの禁止偏重ルール。

⚠ 注意: 「生のSQLを書くな」と禁止で書くのではなく、「DBアクセスは data/repositories.py のリポジトリパターンを使う」と、正しい道へ導く形で書きましょう。Claudeは禁止より「あるべき姿」のほうが正確に従えます。

真価はチームで現れる

Claude Projectsが本当に光るのは、チームで共有したときです。全員が同じプロジェクト内で作業すれば、Claudeは共有アーキテクチャを理解し、一貫した助言を返します。「私たちが確立したパターンに従ったか、このサービス実装をレビューして」と頼めば、命名規約もテスト要件も踏まえたレビューが返ってくる。新メンバーのオンボーディングも、過去の会話履歴をたどることで劇的に加速します。本書では、1つの大きなプロジェクトか小さなものを多数か、という組織設計の判断軸まで踏み込んでいます。

コンテキストの「進化」をどう管理するか

見落とされがちですが重要なのが、コンテキストの変化の追跡です。コードと違い、プロジェクトのカスタム指示やナレッジベースには組み込みのバージョン管理がありません。本書はこの盲点に対し、ナレッジベース内にCHANGELOGを置くというシンプルなベストプラクティスを提案します。古いサンプルと指示の食い違いに気づける、地味ながら効く一手です。