時間とともにあなたのプロジェクトを学習するClaudeコードのシステム

r/ClaudeAIで開発者が、Claude Codeのセッション間で永続的なコンテキストが失われる問題に対処するシステムを共有しました。毎回ゼロから始める代わりに、この設定はClaudeがあなたのプロジェクトの規約、アーキテクチャ、過去の失敗を学習するのを助けます。

問題と解決策

Claude Codeを使用すると、新しいセッションごとに以前のコンテキストがすべて失われます。Claudeは既に理解したファイルを再読み込みし、修正済みのミスを繰り返し、確立されたパターンを無視するため、常に再説明が必要になります。

解決策は、リポジトリにいくつかのファイルを追加することです：

• CLAUDE.md - Claudeに振る舞い方を指示する短いルール集。例としては「不明な点があれば先に進む前に確認する」「テストを自分で実行せず、代わりに実行すべきコマンドを教える」（エラーの追跡にトークンを浪費するのを防ぎ、費用を節約）などがあります。
• docs/フォルダ - プロジェクトの規約、パターン、アーキテクチャを捉えた短いファイル（それぞれ5-10行）を含み、サブフォルダに整理されています。インデックスファイル（docs/README.md）は、Claudeが推測する代わりに適切なドキュメントを素早く見つけるのを助けます。

3つの重要なプロンプト

• bootstrap - 既存のコードベースを採用する際に一度貼り付けます。Claudeはあなたのコードを読み、初期ドキュメントを作成します。
• refine - セッションの終わりに貼り付けます。Claudeは何が起こったかを振り返り、新しい学びでドキュメントを更新します。
• factory - Claudeが繰り返したいことを行ったときに貼り付けます。パターンを再利用可能なプロンプトとして捕捉します。

ワークフローの循環

このプロセスは継続的な学習サイクルを作り出します：Claudeとコーディングする → セッション終了 → refineプロンプトを貼り付ける → Claudeがドキュメントを更新 → コミットする → 次のセッションがより賢く開始される。ドキュメントはgitで管理されるため、チーム全員が恩恵を受け、どの技術スタックでも機能します。

実装からの実用的なヒント

• エラー追跡にトークンを浪費するのを避けるため、Claudeにビルド/テストコマンドを実行しないよう明示的に指示します。代わりに、実行すべきコマンドを教えさせます。
• 曖昧な表現（例：「複雑なタスクの場合は一時停止」）ではなく、具体的な数字をルールに使用します（例：「3つ以上のファイルを変更する場合は一時停止」）。Claudeは曖昧さを解釈するのに時間を浪費するからです。
• docsフォルダのインデックスファイルは、Claudeが関連情報を見つけようとランダムなファイルを開くのを防ぐため、すぐに効果を発揮します。

このシステムは無料でオープンソースであり、saas-vibeで利用可能です。