Notepad と Project Memory でプロジェクト知識を永続化する

oh-my-claudecode は、セッションをまたいでプロジェクトの知識を蓄積・活用するための2つのシステムを提供しています。Notepad と Project Memory を組み合わせることで、Claude Code がプロジェクトの文脈を深く理解できるようになります。

Notepad システム

Notepad は3つのセクションで構成されています。

セクション	特徴	用途
Priority	常にロード、500文字以内	最重要の現在コンテキスト
Working	タイムスタンプ付き、7日で自動プルーン	作業メモ、進捗記録
Manual	永続、自動プルーンなし	重要な知識、決定事項

Priority セクションへの書き込み

> /oh-my-claudecode:writer-memory

Priority はセッション開始時に常にロードされるため、現在のフォーカスや重要な制約を記述します。

Working Memory への追加

PostToolUse フックが自動的に作業メモを追加しますが、手動でも追加可能です。

認証フローの設計を完了。JWT + リフレッシュトークン方式を採用。
アクセストークン: 15分、リフレッシュトークン: 7日。

Manual Memory への追加

重要な決定事項や、長期間保持すべき知識を保存します。

データベース設計: users, tenants, orders テーブルは全て tenant_id で分離。
RLSポリシー必須。

Project Memory

プロジェクトの構造化された知識ベースです。

セクション	内容
techStack	使用技術のスタック
build	ビルド・テストコマンド
conventions	コーディング規約
structure	プロジェクト構造
notes	自由形式のノート
directives	永続的な指示

Project Memory の読み取り

> プロジェクトメモリを確認して

OMC MCP ツールの project_memory_read が現在のプロジェクトメモリを表示します。

Project Memory の更新

> このプロジェクトの技術スタックを記録して:
> - Frontend: Next.js 15 + React 19
> - Backend: Hono + Drizzle ORM
> - Database: PostgreSQL 16
> - Testing: Vitest + Playwright

project_memory_write ツールが技術スタックを更新します。

セッション間の連携

セッション開始時: SessionStart フックが Project Memory と Priority Notepad をロード
作業中: PostToolUse フックが自動的に Working Memory に追記
Compact 前: PreCompact フックが状態を保存し、Project Memory を保護
セッション終了時: SessionEnd フックが最終状態を永続化

PreCompact での状態保護

compact 実行前に、重要な状態が自動的に Notepad に退避されます。これにより、コンパクト後も重要なコンテキストが失われません。

実践的な運用パターン

# セッション1: 設計フェーズ
Priority: "認証モジュールの設計中。JWT方式を採用。"
Manual: "認証の設計決定: JWT + リフレッシュトークン。理由: ステートレス + セキュリティ。"

# セッション2: 実装フェーズ
Priority: "認証モジュール実装中。login, register, refresh エンドポイント。"
Working: "login.ts 完成、register.ts 作業中"

# セッション3: テストフェーズ
Priority: "認証モジュールのテスト中。カバレッジ目標: 80%"
Working: "login.test.ts パス、refresh.test.ts 作業中"

各セッションで Priority を更新し、次のセッションが前回の文脈を即座に把握できるようにします。

あわせて読む

Everything Claude Code の Instinct で継続学習する - パターンの抽出と学習
# プレフィックスで素早くメモリに追加する - クイックメモリの基本

Notepad と Project Memory でプロジェクト知識を永続化する