marketing-shibata50/exbrain
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

v2: Full English README with SOUL/MEMORY/DREAMS trinity, architecture, setup guide

Browse source
This commit is contained in:
Masahiro Chaen 2026-04-08 01:40:54 +09:00
parent d858e1f315
commit be1530bf01
1 changed files with 216 additions and 223 deletions
Download patch file Download diff file Expand all files Collapse all files

439
README.md
View file

@ -1,221 +1,222 @@
# Exbrain — Your AI's External Brain # Exbrain — Your AI's External Brain
> AIが勝手に記憶し、整理し、毎朝振り返ってくれる外付け脳 > An AI knowledge system that automatically remembers, organizes, and reflects.
> >
> Claude Code × Obsidian × SOUL/MEMORY/DREAMS > Claude Code × Obsidian × SOUL/MEMORY/DREAMS
> >
> Inspired by [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) > Inspired by [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
Claude Codeの中に眠っている記憶（Memory）、設定ファイル（CLAUDE.md）、スキル（Skills）を ## What is Exbrain?
Obsidianで可視化し、毎朝・毎夕のDreamingで自動振り返りを行う仕組み。
PC閉じてても動く。iPhoneからも見える。人間はObsidianを開いて読むだけ。 Exbrain turns Claude Code's hidden internal state — Memory files, CLAUDE.md configs, Skills — into a human-readable Obsidian vault. It adds a **Dreaming** layer that automatically reflects on your day, detects patterns, and builds a growth trajectory over time.
## コンセプト Your laptop can be closed. Your phone shows everything. You just open Obsidian and read.
## The SOUL / MEMORY / DREAMS Trinity
The core of Exbrain is three files at the root of your vault:
``` ```
┌─ Claude Code の世界（普段は .claude/ に隠れている）───────────┐ ~/vault/
├── SOUL.md ← WHO you are (identity, values, boundaries)
├── MEMORY.md ← WHAT you've experienced (decisions, patterns, lessons)
└── DREAMS.md ← WHERE you're going (insights, growth, open questions)
```
### SOUL.md — Identity
Defines who you are and how the AI should behave. Merged from Claude Code's CLAUDE.md and any external agent personality configs.
```markdown
## Identity
- Your name, role, company
## Values
- "Ship fast, iterate later"
- "API-first, no manual work"
## Boundaries (non-negotiable)
- "Never send emails — drafts only"
- "Never post to Slack without confirmation"
## Tech Ecosystem
- APIs, MCP servers, CLI tools
```
### MEMORY.md — Experience
A digest of everything the AI has learned. Auto-synced from Claude Code's Memory (`.claude/projects/*/memory/`) + enriched by Cloud Scheduled Tasks.
```markdown
## Recent
- [2026-04-07] Built Obsidian vault with SOUL/MEMORY/DREAMS
- [2026-04-06] Company A training deal almost closed
## Decisions
- Hybrid design: static mirror + Karpathy pattern + Dreaming
## Patterns
- Fridays are meeting-heavy (3 weeks in a row)
- Email replies concentrate in the afternoon
## CC Memory Summary (35 files)
- feedback/21: "Never send emails", "Always git commit after GAS edits"
- reference/7: API locations, tool configs
- project/4: Active project statuses
- user/1: User profile and preferences
```
### DREAMS.md — Reflection
Updated automatically by Dreaming (morning + evening + weekly). Tracks patterns that emerge over time.
```markdown
## Current Insights
- Meeting density peaks on Mondays (10+ meetings, 3 consecutive weeks)
## Emerging Patterns
| Pattern | Count | Trend |
|---------|-------|-------|
| Tool → Skill → Automation cycle | 10+ | Consistent |
| Email/Slack send caution | 5+ | Critical boundary |
## Growth Trajectory
- Q1: 26 skills built, 32 cron jobs running, SF revenue 210%
## Open Questions
- Should CC Memory duplicates be consolidated?
```
## Architecture
```
┌─ Layer 1: Cloud Scheduled Tasks (no PC needed) ────────────┐
│ │ │ │
│ CLAUDE.md ×N ←──┐ │ │ 07:00 vault-daily-morning │
│ CC Memory ×N ←──┤── 自動同期 ──→ ~/vault/ │ │ ├── Read SOUL.md (understand user context) │
│ Skills ×N ←──┤ (Obsidian) │ │ ├── Read MEMORY.md (recent decisions & patterns) │
│ Cron jobs ←──┘ 人間が見る窓 │ │ ├── Google Calendar → today's schedule │
│ ├── Slack → overnight highlights │
│ ├── Gmail → important unread emails │
│ ├── Morning Dreaming (yesterday's review → today's focus) │
│ ├── Update MEMORY.md Recent section │
│ └── git push │
│ │ │ │
│ + 日記（daily/）は Obsidian にだけ存在 │ │ 18:30 vault-daily-evening │
│ + Dreaming（朝夕の自動振り返り）で知見が複利で増える │ │ ├── Read SOUL.md + MEMORY.md + DREAMS.md │
│ ├── Evening Dreaming (today + 7-day pattern detection) │
│ ├── Update MEMORY.md + DREAMS.md │
│ ├── Sunday: weekly Dreaming + Lint + Slack notification │
│ └── git push │
│ │ │ │
└──────────────────────────────────────────────────────────────┘ └──────────────────────┬───────────────────────────────────────┘
```
### 3つの性格を持つハイブリッド設計
```
vault/
├── system/, skills/, memory/
│ → 静的ミラー（ダッシュボード）
│ → Claude Codeの中身を自動同期、人間は読むだけ
│ → <!-- SYNCED: DO NOT EDIT --> ヘッダー付き
│
├── daily/
│ → 自動ログ + 手書き日記
│ → Calendar + Slack + Gmail + AI Analysis
│ → 朝夕2回のDreaming（パターン検出・振り返り）
│
└── meetings/, clients/, insights/
→ Karpathyパターン（知識が複利で増える）
→ 議事録を処理するたびに顧客ページに自動蓄積
→ 12回の議事録を読み返す必要がない
```
## アーキテクチャ
```
┌─ Layer 1: Cloud Scheduled Tasks（PC不要）──────────────────┐
│ │
│ 毎朝 07:00 vault-daily-morning │
│ ├── Google Calendar → 今日の予定 │
│ ├── Slack → 昨夜〜今朝のハイライト │
│ ├── Gmail → 未読・重要メール │
│ ├── Morning Dreaming（昨日の振り返り→今日の注目） │
│ └── GitHub push │
│ │
│ 毎夕 18:30 vault-daily-evening │
│ ├── Evening Dreaming（今日+7日分→パターン検出） │
│ ├── 日曜は週次Dreaming + Lint + Slack通知 │
│ └── GitHub push │
│ │
└──────────────────────┬──────────────────────────────────────┘
│ push │ push
▼ ▼
┌─ GitHub (private repo) ─────────────────────────────────────┐ ┌─ GitHub (private repo) ──────────────────────────────────────┐
│ vault/ の全ファイル │ │ All vault files │
└──────────────────────┬──────────────────────────────────────┘ └──────────────────────┬───────────────────────────────────────┘
│ pull (launchd 毎時) │ pull (hourly via launchd)
▼ ▼
┌─ Layer 2: ローカル自動化 ───────────────────────────────────┐ ┌─ Layer 2: Local Automation ──────────────────────────────────┐
│ │ │ │
│ Claude Code Hooks (async: true) │ │ Claude Code Hooks (async: true) │
│ ├── PostToolUse → ファイル変更をログ記録 │ │ ├── PostToolUse → log file changes │
│ └── Stop → セッション終了をdaily noteに自動追記 │ │ └── Stop → append session end to daily note + MEMORY.md │
│ │ │ │
│ External AI Agent Cron（PCオン時の追加データ） │ │ External Agent Cron (when PC is on) │
│ ├── SF/Stripe/HERP/YouTube等の専門データ追記 │ │ ├── Additional data: Salesforce, Stripe, HERP, YouTube │
│ └── PCオフなら単にスキップ（Layer 1だけで完成） │ │ └── Skipped when PC is off (Layer 1 is self-sufficient) │
│ │ │ │
└──────────────────────┬──────────────────────────────────────┘ └──────────────────────┬───────────────────────────────────────┘
│ iCloud │ iCloud sync
▼ ▼
Obsidian (Mac + iPhone) Obsidian (Mac + iPhone)
``` ```
## AIの記憶システム（Memory） ## Vault Structure
Claude Codeは `.claude/projects/*/memory/` に記憶を保存する。
この記憶がObsidianに自動ミラーされ、人間が読める形になる。
```
memory/
├── feedback/ (21件) ← AIへの行動指針
│ ├── never-send-email.md 「メール送信は絶対禁止。下書きのみ」
│ ├── gas-version-control.md 「GAS編集後は毎回git commit」
│ └── minutes-include-sf.md 「議事録にはSF+Slack報告も含める」
│
├── reference/ (7件) ← 外部システムへのポインタ
│ ├── wordpress-api.md 「APIの認証情報はここ」
│ └── typefully-api.md 「X投稿はTypefully経由」
│
├── project/ (4件) ← プロジェクト状況
│ └── project-status.md 「プロジェクトAは進行中、来月リリース」
│
└── user/ (1件) ← ユーザープロファイル
└── user-profile.md 「シェル環境にまだ詳しくない」
```
AIが過去の失敗や指示を覚えていて、次から同じミスをしない。
その記憶が全部Obsidianで見える。「何を覚えてるの？」が一目瞭然。
## Dreaming（朝夕の自動振り返り）
External AI AgentのSOUL/MEMORY/DREAMSパターンを参考に設計。
```
毎朝 07:00 — Morning Dreaming
├── 昨日のdaily noteを読み返す
├── 決定事項・未解決タスクを抽出
└── 「今日の注目ポイント」を3行で生成
毎夕 18:30 — Evening Dreaming
├── 今日のSlack/Gmail/Calendarを振り返り
├── 直近7日とのパターン比較
│ 例: 「火曜は会議密度が高い（3週連続）」
│ 例: 「メール返信が午後に集中」
├── 未解決の問いを抽出
└── パターンが見つかったら insights/ にページ作成
毎週日曜 — Weekly Dreaming
├── 1週間分のdailyから洞察を抽出
├── DREAMS.md に成長軌跡を記録
├── Lint（壊れたリンク・orphanページ検出）
└── Slackでサマリー通知
```
DREAMS.mdに蓄積される内容:
- Current Insights（最新の内省結果）
- Emerging Patterns（浮かび上がるパターン）
- Growth Trajectory（成長の軌跡）
- Open Questions（未解決の問い）
## Vault構造
``` ```
~/vault/ ~/vault/
├── CLAUDE.md ← Schema（LLM向けルール定義） ├── SOUL.md ← Identity, values, boundaries
├── DREAMS.md ← Dreaming蓄積ファイル ├── MEMORY.md ← Experience digest (CC Memory mirror)
├── DREAMS.md ← Dreaming accumulation (auto-updated)
├── CLAUDE.md ← Schema (LLM rules for this vault)
│ │
├── daily/ ← デイリーノート ├── daily/ ← Daily notes (auto-generated morning & evening)
│ └── 2026-04-07.md 　 Schedule / Gmail / Slack / AI Analysis / │ └── 2026-04-07.md Schedule / Gmail / Slack / AI Analysis /
│ Morning Reflection / Evening Reflection / │ Morning Reflection / Evening Reflection /
│ Claude Code Session / Thoughts │ Claude Code Session / Thoughts
│ │
├── system/ ← Claude Codeシステムのミラー（SYNCED） ├── system/ ← Claude Code system mirror (SYNCED)
│ ├── claude-md-tree.md 　 全CLAUDE.mdの階層ツリー │ ├── claude-md-tree.md All CLAUDE.md files as a tree
│ ├── global-rules.md 　 ルール・禁止事項の要約 │ ├── global-rules.md Rules & boundaries summary
│ ├── api-inventory.md 　 保有API一覧（キーは除外） │ ├── api-inventory.md API list (no keys)
│ ├── tech-stack.md 　 技術スタック │ ├── tech-stack.md Technology stack
│ └── cron-jobs.md 　 稼働中ジョブ一覧 │ └── cron-jobs.md Running cron jobs
│ │
├── skills/ ← 全スキル一覧 + 個別ページ（SYNCED） ├── skills/ ← All skills with details (SYNCED)
│ ├── _index.md 　 カテゴリ別テーブル ├── memory/ ← CC Memory individual file mirror (SYNCED)
│ └── auto-minutes.md 　 各スキルの説明・コマンド │ ├── feedback/ Behavioral guidelines
│ ├── reference/ External system pointers
│ ├── project/ Project statuses
│ └── user/ User profile
│ │
├── memory/ ← CC Memory完全ミラー（SYNCED） ├── clients/ ← Client knowledge (Karpathy pattern)
│ ├── _index.md 　 全メモリ一覧（タイプ別） ├── meetings/ ← Meeting summaries (auto from /auto-minutes)
│ ├── feedback/ 　 行動指針 ├── decisions/ ← Decision log
│ ├── reference/ 　 外部参照 ├── insights/ ← Learnings + weekly Dreaming
│ ├── project/ 　 プロジェクト状況
│ └── user/ 　 ユーザープロファイル
│
├── clients/ ← 顧客ナレッジ蓄積（Karpathyパターン）
│ ├── _index.md 　 全顧客一覧
│ └── client-a.md 　 議事録のたびに自動蓄積
│
├── meetings/ ← 議事録要点（/auto-minutes連携）
├── decisions/ ← 経営判断ログ
├── insights/ ← 学び・パターン + 週次Dreaming
├── templates/ ← daily-note, meeting, decision ├── templates/ ← daily-note, meeting, decision
└── scripts/ ← hookスクリプト + 同期スクリプト └── scripts/ ← Hook scripts + sync scripts
``` ```
## セットアップ手順 ## Hybrid Design: Three Personalities
### 前提条件 ```
- Claude Code（Pro or Max） vault/
- Obsidian（無料） ├── system/, skills/, memory/
- GitHub アカウント │ → Static mirror (dashboard)
- （オプション）Slack / Google Calendar / Gmail の Connector │ → Auto-synced from Claude Code, read-only
│ → <!-- SYNCED: DO NOT EDIT --> header
│
├── daily/
│ → Auto log + handwritten diary
│ → Calendar + Slack + Gmail + AI Analysis + Dreaming
│ → Runs even with PC closed (Cloud Scheduled Tasks)
│
└── meetings/, clients/, insights/
→ Karpathy pattern (compounding knowledge)
→ Each meeting processed → client page auto-enriched
→ No need to re-read 12 meeting transcripts
```
### Step 1: Vault作成 ## Setup
### Prerequisites
- Claude Code (Pro or Max)
- Obsidian (free)
- GitHub account
- (Optional) Slack / Google Calendar / Gmail Connectors
### Step 1: Create Vault
```bash ```bash
# フォルダ作成
mkdir -p ~/vault/{daily,system,skills,memory/{feedback,reference,project,user},clients,meetings,decisions,insights,templates,scripts} mkdir -p ~/vault/{daily,system,skills,memory/{feedback,reference,project,user},clients,meetings,decisions,insights,templates,scripts}
# iCloud同期（iPhone対応する場合） # iCloud sync (for iPhone)
mv ~/vault ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/claude-code mv ~/vault ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/exbrain
ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/claude-code ~/vault ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/exbrain ~/vault
``` ```
### Step 2: テンプレートファイルをコピー ### Step 2: Copy Templates
このリポジトリの `vault-template/` をコピー:
```bash ```bash
cp -r vault-template/* ~/vault/ git clone https://github.com/chaenmasahiro0425/exbrain.git /tmp/exbrain
cp -r /tmp/exbrain/vault-template/* ~/vault/
``` ```
### Step 3: Claude Code Hooks 設定 ### Step 3: Configure Hooks
`~/.claude/settings.json` に追加: Add to `~/.claude/settings.json`:
```json ```json
{ {
@ -239,30 +240,16 @@ cp -r vault-template/* ~/vault/
} }
``` ```
### Step 4: 初回同期 ### Step 4: Initial Sync
Claude Codeで実行:
In Claude Code:
``` ```
/wiki-sync-init Please read all my skills from ~/.claude/skills/, all memory files from
~/.claude/projects/*/memory/, and sync them to ~/vault/. Create SOUL.md
with my identity and MEMORY.md with a digest of all memories.
``` ```
または手動: ### Step 5: GitHub Backup
```bash
# Skills同期
for d in ~/.claude/skills/*/; do
name=$(basename "$d")
# SKILL.md を読んで vault/skills/ にページ作成
done
# Memory同期
find ~/.claude/projects -name "*.md" -path "*/memory/*" ! -name "MEMORY.md" | while read src; do
# vault/memory/ にミラー作成
done
```
### Step 5: GitHub + 自動pull
```bash ```bash
cd ~/vault cd ~/vault
@ -270,13 +257,13 @@ git init && git add -A && git commit -m "Initial vault"
gh repo create my-vault --private --source=. --push gh repo create my-vault --private --source=. --push
``` ```
### Step 6: Cloud Scheduled Tasks（オプション、PC不要にする場合） ### Step 6: Cloud Scheduled Tasks (PC-free automation)
claude.ai/code/scheduled で: At [claude.ai/code/scheduled](https://claude.ai/code/scheduled):
- **vault-daily-morning**: 毎朝07:00、Calendar+Slack+Gmail→daily note生成 - **vault-daily-morning** (07:00): Read SOUL.md → Calendar + Slack + Gmail → daily note + Morning Dreaming
- **vault-daily-evening**: 毎夕18:30、Evening Dreaming+パターン検出 - **vault-daily-evening** (18:30): Read SOUL.md + MEMORY.md + DREAMS.md → Evening Dreaming + pattern detection
## デイリーノートの完成形 ## Daily Note Example
```markdown ```markdown
--- ---
@ -287,47 +274,53 @@ score: 74
--- ---
## Schedule ## Schedule
| 時間 | 予定 | 備考 | | Time | Event | Note |
|------|------|------| |------|-------|------|
| 09:00 | 経営管理部 定例 | | | 09:00 | Management meeting | |
| 10:00 | 開発営業 定例 | | | 10:00 | Sales standup | |
| 14:00 | 社内定例 | | | 14:00 | Company standup | |
## Gmail ## Gmail
| From | Subject | Action | | From | Subject | Action |
|------|---------|--------| |------|---------|--------|
| 田中太郎 | セミナー開催打合せ | 要返信 | | Tanaka | Seminar meeting request | Reply needed |
## Slack Highlights ## Slack Highlights
- **#general**: 組織体制の議論 - **#general**: Organization restructuring discussion
- **#sales**: チャットbot進捗、CRM連携デモ依頼 - **#sales**: Chatbot progress, CRM demo request
- **#daily-report**: X社向け研修の受注ほぼ確定 - **#daily-report**: Company X training deal almost closed
## AI Analysis
- 生産性: B — 会議完了率100%
- 対応力: B — 未読メール6件
- 営業: B- — 商談0件
## Morning Reflection ## Morning Reflection
- 昨日の決定: サービス料金改定を決定 - Yesterday's decision: Service pricing revision
- 今日の注目: セミナー返信、パートナーMTG - Today's focus: Seminar reply, partner meeting
## Evening Reflection ## Evening Reflection
- 今日のハイライト: X社向け研修の受注ほぼ確定 - Highlight: Company X training deal confirmed
- パターン: 月曜は会議が10件超で最多（3週連続） - Pattern: Mondays consistently have 10+ meetings (3 weeks)
- 未解決: セミナー打合せ返信 - Unresolved: Seminar meeting reply pending
## Thoughts ## Thoughts
<!-- 自分で一言 --> <!-- Write your own reflection here -->
``` ```
## 参考 ## Scripts Included
- [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — 設計思想の原点 | Script | Purpose |
- [obsidian-wiki (Ar9av)](https://github.com/Ar9av/obsidian-wiki) — Karpathyパターンのフレームワーク |--------|---------|
- [QMD](https://github.com/tobi/qmd) — Markdownセマンティック検索（100ページ超で導入検討） | `on-session-end.sh` | Stop hook: appends session summary to daily note + MEMORY.md |
- [Claude Code Hooks](https://code.claude.com/docs/en/hooks-guide) — async hookの公式ドキュメント | `on-file-change.sh` | PostToolUse hook: logs CLAUDE.md/memory/skill changes |
- [Cloud Scheduled Tasks](https://code.claude.com/docs/en/web-scheduled-tasks) — PC不要の自動化 | `weekly-sync.sh` | Weekly lint: broken links, orphan pages, stale content |
| `git-pull-sync.sh` | Hourly git pull with stash handling |
| `sync-agent-to-vault.sh` | Enriches daily notes from external agent JSON data |
All scripts are macOS-compatible (no GNU extensions), reviewed for security (no shell injection, PID-based locking instead of flock).
## References
- [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — The original pattern
- [Claude Code Hooks](https://code.claude.com/docs/en/hooks-guide) — async hook documentation
- [Cloud Scheduled Tasks](https://code.claude.com/docs/en/web-scheduled-tasks) — PC-free automation
- [QMD](https://github.com/tobi/qmd) — Markdown semantic search (for 100+ pages)
## License ## License