11 KiB
11 KiB
Exbrain — AIの外付け脳
AIが勝手に記憶し、整理し、毎朝振り返ってくれるナレッジシステム
Claude Code × Obsidian × SOUL/MEMORY/DREAMS
🇺🇸 English · Karpathy's LLM Wiki にインスパイア
Exbrainとは？
Claude Codeの中に隠れている記憶（Memory）、設定ファイル（CLAUDE.md）、スキル（Skills）をObsidianで可視化。Dreamingレイヤーが自動で毎日振り返り、パターンを検出し、成長の軌跡を記録する。
PCを閉じても動く。iPhoneでも見える。人間はObsidianを開いて読むだけ。
SOUL / MEMORY / DREAMS
Exbrainの核心は、Vault直下の3つのファイル:
~/vault/
├── SOUL.md ← 自分は誰か（アイデンティティ・価値観・境界線）
├── MEMORY.md ← 何を経験したか（決定・パターン・学び）
└── DREAMS.md ← どこに向かうか（洞察・成長・未解決の問い）
SOUL.md — アイデンティティ
自分が誰で、AIにどう振る舞ってほしいかを定義。Claude CodeのCLAUDE.mdと外部エージェントの性格設定を統合。
## Identity
- 名前、役割、会社
## Values
- 「完璧主義より実験主義」
- 「APIファースト、手作業は排除」
## Boundaries（絶対遵守）
- 「メール送信禁止 — 下書きのみ」
- 「Slack確認なしで送信禁止」
MEMORY.md — 経験の蓄積
AIが学んだこと全てのダイジェスト。Claude Codeの Memory（.claude/projects/*/memory/）を自動同期 + Cloud Scheduled Tasksが朝夕に追記。
## Recent
- [2026-04-07] Obsidian Vault構築、SOUL/MEMORY/DREAMS実装
## Patterns
- 金曜は会議密度が高い（3週連続）
- メール返信が午後に集中
## CC Memory サマリー（35件）
- feedback/21件: 「メール送信禁止」「GAS編集後は毎回commit」
- reference/7件: API情報、ツール設定
DREAMS.md — 内省と成長
Dreaming（朝夕+週次）が自動更新。時間とともに浮かび上がるパターンを記録。
## Current Insights
- 月曜は会議10件超が常態化（3週連続）
## Emerging Patterns
| パターン | 回数 | 傾向 |
|---------|------|------|
| ツール→スキル→自動化サイクル | 10+ | 一貫 |
## Growth Trajectory
- Q1: スキル26個構築、cronジョブ32本稼働
アーキテクチャ
┌─ Layer 1: Cloud Scheduled Tasks（PC不要）────────────────┐
│ │
│ 07:00 vault-daily-morning │
│ ├── SOUL.md を読む（ユーザー理解） │
│ ├── MEMORY.md を読む（直近の文脈） │
│ ├── Google Calendar → 今日の予定 │
│ ├── Slack → 昨夜のハイライト │
│ ├── Gmail → 重要な未読メール │
│ ├── Morning Dreaming（昨日の振り返り→今日の注目） │
│ ├── MEMORY.md の Recent を更新 │
│ └── git push │
│ │
│ 18:30 vault-daily-evening │
│ ├── SOUL.md + MEMORY.md + DREAMS.md を読む │
│ ├── Evening Dreaming（今日+7日間→パターン検出） │
│ ├── MEMORY.md + DREAMS.md を更新 │
│ ├── 日曜: 週次Dreaming + Lint + Slack通知 │
│ └── git push │
│ │
└────────────────────────┬──────────────────────────────────┘
│ push
▼
┌─ GitHub（private repo）──────────────────────────────────┐
│ vault/の全ファイル │
└────────────────────────┬──────────────────────────────────┘
│ pull（launchd 毎時）
▼
┌─ Layer 2: ローカル自動化 ────────────────────────────────┐
│ │
│ Claude Code Hooks (async: true) │
│ ├── PostToolUse → ファイル変更をログ記録 │
│ └── Stop → セッション終了をdaily note + MEMORY.mdに記録 │
│ │
│ 外部エージェント Cron（PCオン時の追加データ） │
│ ├── Salesforce/Stripe/HERP等の専門データ追記 │
│ └── PCオフ時はスキップ（Layer 1だけで完結） │
│ │
└────────────────────────┬──────────────────────────────────┘
│ iCloud同期
▼
Obsidian（Mac + iPhone）
ハイブリッド設計 — 3つの性格
vault/
├── system/, skills/, memory/
│ → 静的ミラー（ダッシュボード）
│ → Claude Codeの中身を自動同期、読むだけ
│ → <!-- SYNCED: DO NOT EDIT --> ヘッダー付き
│
├── daily/
│ → 自動ログ + 手書き日記
│ → Calendar + Slack + Gmail + AI Analysis + Dreaming
│ → PC閉じてても Cloud Scheduled Tasks が動く
│
└── meetings/, clients/, insights/
→ Karpathyパターン（知識が複利で増える）
→ 議事録を処理するたびに顧客ページに自動蓄積
→ 12回の議事録を読み返す必要がない
Vault構造
~/vault/
├── SOUL.md ← アイデンティティ・価値観・境界線
├── MEMORY.md ← 経験のダイジェスト（CC Memoryミラー）
├── DREAMS.md ← Dreaming蓄積（自動更新）
├── CLAUDE.md ← Schema（LLM向けルール定義）
│
├── daily/ ← デイリーノート（朝夕自動生成）
├── system/ ← Claude Codeシステムミラー（SYNCED）
├── skills/ ← スキル一覧+個別ページ（SYNCED）
├── memory/ ← CC Memory個別ファイルミラー（SYNCED）
├── clients/ ← 顧客ナレッジ蓄積（Karpathyパターン）
├── meetings/ ← 議事録要点
├── decisions/ ← 経営判断ログ
├── insights/ ← 学び・パターン + 週次Dreaming
├── templates/ ← テンプレート
└── scripts/ ← hookスクリプト + 同期スクリプト
セットアップ
前提条件
- Claude Code（Pro or Max）
- Obsidian（無料）
- GitHubアカウント
- （オプション）Slack / Google Calendar / Gmail の Connector
Step 1: Vault作成
mkdir -p ~/vault/{daily,system,skills,memory/{feedback,reference,project,user},clients,meetings,decisions,insights,templates,scripts}
# iCloud同期（iPhone対応する場合）
mv ~/vault ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/exbrain
ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/exbrain ~/vault
Step 2: テンプレートをコピー
git clone https://github.com/YOUR_USERNAME/exbrain.git /tmp/exbrain
cp -r /tmp/exbrain/vault-template/* ~/vault/
Step 3: Hooks設定
~/.claude/settings.json に追加:
{
"hooks": {
"PostToolUse": [{
"matcher": "Write|Edit",
"hooks": [{
"type": "command",
"command": "bash ~/vault/scripts/on-file-change.sh",
"async": true
}]
}],
"Stop": [{
"hooks": [{
"type": "command",
"command": "bash ~/vault/scripts/on-session-end.sh",
"async": true
}]
}]
}
}
Step 4: 初回同期
Claude Codeで:
~/.claude/skills/ の全スキル、~/.claude/projects/*/memory/ の全記憶ファイルを
~/vault/ に同期してください。SOUL.md にアイデンティティを、MEMORY.md に記憶の
ダイジェストを作成してください。
Step 5: GitHubバックアップ
cd ~/vault
git init && git add -A && git commit -m "Initial vault"
gh repo create my-vault --private --source=. --push
Step 6: Cloud Scheduled Tasks（PC不要にする場合）
- vault-daily-morning（毎朝07:00）: SOUL.md読み→Calendar+Slack+Gmail→daily note + Morning Dreaming
- vault-daily-evening（毎夕18:30）: SOUL.md+MEMORY.md+DREAMS.md読み→Evening Dreaming+パターン検出
含まれるスクリプト
| スクリプト | 用途 |
|---|---|
on-session-end.sh |
Stop hook: daily note + MEMORY.mdにセッション記録 |
on-file-change.sh |
PostToolUse hook: CLAUDE.md/memory/skill変更をログ |
weekly-sync.sh |
週次Lint: 壊れたリンク・孤立ページ・古いページ検出 |
git-pull-sync.sh |
毎時git pull（stash対応） |
sync-agent-to-vault.sh |
外部エージェントのJSONデータでdaily note充実化 |
全スクリプトmacOS互換（GNU拡張なし）、セキュリティレビュー済み（PIDロック、インジェクション対策）。
参考
- Karpathy's LLM Wiki — 設計思想の原点
- Claude Code Hooks — async hookの公式ドキュメント
- Cloud Scheduled Tasks — PC不要の自動化
- QMD — Markdownセマンティック検索（100ページ超で導入検討）
ライセンス
MIT