memory-management

メモリ管理

メモリを活用すると、Claude は職場の協力者になります。社内で使われている言葉を理解する相手です。

目標

略記を意味のある情報に変換します。

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

メモリがなければ、この依頼は意味をなしません。メモリがあれば、Claude は次のように理解します。

• todd → Todd Martinez、財務責任者、Slack を好む
• PSR → Pipeline Status Report（週次営業資料）
• oracle → Oracle Systems の案件であり、企業そのものではない

アーキテクチャ

CLAUDE.md          ← Hot cache (~30 people, common terms)
memory/
  glossary.md      ← Full decoder ring (everything)
  people/          ← Complete profiles
  projects/        ← Project details
  context/         ← Company, teams, tools

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. Check CLAUDE.md (hot cache)
   → Todd? ✓ Todd Martinez, Finance
   → PSR? ✓ Pipeline Status Report
   → Phoenix? ✓ DB migration project

2. If not found → search memory/glossary.md
   → Full glossary has everyone/everything

3. If still not found → ask user
   → "What does X mean? I'll remember it."

この階層型のアプローチにより、無制限に拡張できる memory/ をサポートしながら、CLAUDE.md を簡潔（約100行）に保てます。

ファイルの場所

• 作業メモリ： 現在の作業ディレクトリにある 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 (hot cache)     → Check first, covers 90% of cases
2. memory/glossary.md        → Full glossary if not in hot cache
3. memory/people/, projects/ → Rich detail when needed
4. Ask user                  → Unknown term? Learn it.

例：

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」、「移行」など

4. 好み： CLAUDE.md の「好み」セクションに追加します

メモリの呼び出し

ユーザーが「X は誰ですか」または「X は何を意味しますか」と尋ねたとき：

1. まず CLAUDE.md を確認します
2. 詳細については memory/ を確認します
3. 見つからない場合：「X の意味はまだわかりません。教えてもらえますか？」

段階的な情報開示

1. あらゆる依頼をすばやく解析するため、CLAUDE.md を読み込みます
2. 実行に必要なコンテキストをすべて確認するときは、memory/ を参照します
3. 例：PSR について todd にメールを作成する
   • 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 を新鮮で関連性の高い状態に保てます。