メモリ管理

メモリは Claude をあなたの職場の協力者にします。社内言語を話す仲間です。

目的

省略表現を理解に変える：

User: "ask todd to do the PSR for oracle"
              ↓ Claude がデコード
"Ask Todd Martinez (Finance lead) to prepare the Pipeline Status Report
 for the Oracle Systems deal ($2.3M, closing Q2)"

メモリなしではその要求は無意味です。メモリがあれば、Claude は以下を認識します：

• todd → Todd Martinez、Finance lead、Slack を好む
• PSR → Pipeline Status Report（週間営業ドキュメント）
• oracle → Oracle Systems 案件、会社ではない

アーキテクチャ

CLAUDE.md          ← ホットキャッシュ（約30人、よく使う用語）
memory/
  glossary.md      ← 完全なデコード辞書（すべて）
  people/          ← 完全なプロフィール
  projects/        ← プロジェクト詳細
  context/         ← 企業、チーム、ツール

CLAUDE.md（ホットキャッシュ）:

• 最も頻繁にやり取りする約30人
• 最も一般的な約30の頭字語/用語
• アクティブなプロジェクト（5～15）
• あなたの優先設定
• 目的：日次のデコード要件の90%をカバー

memory/glossary.md（完全な用語集）:

• 完全なデコード辞書 - すべての人、すべての用語
• CLAUDE.md に見つからないときに検索
• 無制限に成長可能

memory/people/、projects/、context/:

• 実行時に必要なときの詳細情報
• 完全なプロフィール、履歴、コンテキスト

ルックアップフロー

User: "ask todd about the PSR for phoenix"

1. CLAUDE.md（ホットキャッシュ）をチェック
   → Todd? ✓ Todd Martinez, Finance
   → PSR? ✓ Pipeline Status Report
   → Phoenix? ✓ DB migration project

2. 見つからない場合 → memory/glossary.md を検索
   → 完全な用語集にすべての人と用語が含まれています

3. それでも見つからない場合 → ユーザーに聞く
   → "What does X mean? I'll remember it."

このティアード方式により、CLAUDE.md を軽く保ちながら（約100行）memory/ での無制限のスケールをサポートします。

ファイル場所

• ワーキングメモリ: 現在の作業ディレクトリの CLAUDE.md
• ディープメモリ: memory/ サブディレクトリ

ワーキングメモリ形式（CLAUDE.md）

コンパクト性のためテーブルを使用します。合計 50～80 行程度を目安とします。

# Memory

## Me
[Name], [Role] on [Team]. [One sentence about what I do.]

## People
| Who | Role |
|-----|------|
| **Todd** | Todd Martinez, Finance lead |
| **Sarah** | Sarah Chen, Engineering (Platform) |
| **Greg** | Greg Wilson, Sales |
→ Full list: memory/glossary.md, profiles: memory/people/

## Terms
| Term | Meaning |
|------|---------|
| PSR | Pipeline Status Report |
| P0 | Drop everything priority |
| standup | Daily 9am sync |
→ Full glossary: memory/glossary.md

## Projects
| Name | What |
|------|------|
| **Phoenix** | DB migration, Q2 launch |
| **Horizon** | Mobile app redesign |
→ Details: memory/projects/

## Preferences
- 25-min meetings with buffers
- Async-first, Slack over email
- No meetings Friday afternoons

ディープメモリ形式（memory/）

memory/glossary.md - デコード辞書：

# Glossary

Workplace shorthand, acronyms, and internal language.

## Acronyms
| Term | Meaning | Context |
|------|---------|---------|
| PSR | Pipeline Status Report | Weekly sales doc |
| OKR | Objectives & Key Results | Quarterly planning |
| P0/P1/P2 | Priority levels | P0 = drop everything |

## Internal Terms
| Term | Meaning |
|------|---------|
| standup | Daily 9am sync in #engineering |
| the migration | Project Phoenix database work |
| ship it | Deploy to production |
| escalate | Loop in leadership |

## Nicknames → Full Names
| Nickname | Person |
|----------|--------|
| Todd | Todd Martinez (Finance) |
| T | Also Todd Martinez |

## Project Codenames
| Codename | Project |
|----------|---------|
| Phoenix | Database migration |
| Horizon | New mobile app |

memory/people/{name}.md:

# Todd Martinez

**Also known as:** Todd, T
**Role:** Finance Lead
**Team:** Finance
**Reports to:** CFO (Michael Chen)

## Communication
- Prefers Slack DM
- Quick responses, very direct
- Best time: mornings

## Context
- Handles all PSRs and financial reporting
- Key contact for deal approvals over $500k
- Works closely with Sales on forecasting

## Notes
- Cubs fan, likes talking baseball

memory/projects/{name}.md:

# Project Phoenix

**Codename:** Phoenix
**Also called:** "the migration"
**Status:** Active, launching Q2

## What It Is
Database migration from legacy Oracle to PostgreSQL.

## Key People
- Sarah - tech lead
- Todd - budget owner
- Greg - stakeholder (sales impact)

## Context
$1.2M budget, 6-month timeline. Critical path for Horizon project.

memory/context/company.md:

# Company Context

## Tools & Systems
| Tool | Used for | Internal name |
|------|----------|---------------|
| Slack | Communication | - |
| Asana | Engineering tasks | - |
| Salesforce | CRM | "SF" or "the CRM" |
| Notion | Docs/wiki | - |

## Teams
| Team | What they do | Key people |
|------|--------------|------------|
| Platform | Infrastructure | Sarah (lead) |
| Finance | Money stuff | Todd (lead) |
| Sales | Revenue | Greg |

## Processes
| Process | What it means |
|---------|---------------|
| Weekly sync | Monday 10am all-hands |
| Ship review | Thursday deploy approval |

インタラクション方法

ユーザー入力のデコード（ティアード検索）

常にリクエストで使われている省略表現をデコードしてから行動します：

1. CLAUDE.md（ホットキャッシュ） → まずチェック、90%をカバー
2. memory/glossary.md        → ホットキャッシュにない場合は完全な用語集
3. memory/people/、projects/ → 必要な場合は詳細情報
4. ユーザーに聞く              → 不明な用語？学習します

例：

User: "ask todd to do the PSR for oracle"

CLAUDE.md lookup:
  "todd" → Todd Martinez, Finance ✓
  "PSR" → Pipeline Status Report ✓
  "oracle" → (not in hot cache)

memory/glossary.md lookup:
  "oracle" → Oracle Systems deal ($2.3M) ✓

Now Claude can act with full context.

メモリを追加する

ユーザーが「これを覚えて」または「X は Y を意味する」と言った場合：

1. 用語集項目（頭字語、用語、省略表現）：

   • memory/glossary.md に追加
   • よく使う場合は CLAUDE.md クイック用語集に追加

2. 人:

   • memory/people/{name}.md を作成/更新
   • 重要な場合は CLAUDE.md 主要人物に追加
   • ニックネームをキャプチャ - デコードに重要

3. プロジェクト:

   • memory/projects/{name}.md を作成/更新
   • 現在進行中の場合は CLAUDE.md アクティブプロジェクトに追加
   • コードネームをキャプチャ - 「Phoenix」、「the migration」など

4. 優先設定: CLAUDE.md の優先設定セクションに追加

メモリを呼び出す

ユーザーが「誰が X か」または「X は何か」と聞いた場合：

1. CLAUDE.md をまずチェック
2. 詳細情報を memory/ でチェック
3. 見つからない場合：「X が何を意味するかまだわかりません。教えてください」

段階的情報開示

1. CLAUDE.md をロードして任意のリクエストをすばやく解析
2. 実行に完全なコンテキストが必要な場合は memory/ に深掘り
3. 例：Todd に PSR についてメールを下書きする場合
   • CLAUDE.md は Todd = Todd Martinez、PSR = Pipeline Status Report を伝えます
   • memory/people/todd-martinez.md は Slack を好み、直接的であることを伝えます

ブートストラップ

/productivity:start を使用して、チャット、カレンダー、メール、ドキュメントをスキャンして初期化します。人、プロジェクトを抽出し、用語集の構築を開始します。

規約

• CLAUDE.md で 太字 用語をスキャン可能にします
• CLAUDE.md を 100 行以下に保ちます（「トップ30」ルール）
• ファイル名：小文字、ハイフン（todd-martinez.md、project-phoenix.md）
• 常にニックネームと別名をキャプチャ
• スキャン可能にするため用語集をテーブル形式で
• 頻繁に使用される場合は CLAUDE.md に昇格させます
• 陳腐化した場合は memory/ のみに降格させます

どこに何が入るか

タイプ	CLAUDE.md（ホットキャッシュ）	memory/（完全ストレージ）
人	最も頻繁な約30の連絡先	glossary.md + people/{name}.md
頭字語/用語	最も一般的な約30個	glossary.md（完全リスト）
プロジェクト	アクティブプロジェクトのみ	glossary.md + projects/{name}.md
ニックネーム	トップ30に属する場合は主要人物に	glossary.md（すべてのニックネーム）
企業コンテキスト	クイックリファレンスのみ	context/company.md
優先設定	すべての優先設定	-
履歴/陳腐化	✗ 削除	✓ memory/ に保持

昇格/降格

以下の場合は CLAUDE.md に昇格させます：

• 用語/人をよく使う
• アクティブな作業の一部

以下の場合は memory/ のみに降格させます：

• プロジェクト完了
• 人が頻繁な連絡先ではなくなった
• 用語がめったに使われない

これにより、CLAUDE.md を新鮮で関連性のあるものに保ちます。