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

v3: Add banner image, Japanese README, bilingual navigation

Browse source
This commit is contained in:
Masahiro Chaen 2026-04-08 09:20:56 +09:00
parent c67aeead2a
commit 5b9267a186
3 changed files with 273 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

16
README.md
View file

@ -1,10 +1,14 @@
# Exbrain — Your AI's External Brain
<p align="center">
<img src="assets/banner.png" alt="Exbrain Banner" width="800">
</p>
> An AI knowledge system that automatically remembers, organizes, and reflects.
>
> Claude Code × Obsidian × SOUL/MEMORY/DREAMS
>
> Inspired by [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
<h1 align="center">Exbrain — Your AI's External Brain</h1>
<p align="center">
<b>An AI knowledge system that automatically remembers, organizes, and reflects.</b><br>
Claude Code × Obsidian × SOUL/MEMORY/DREAMS<br><br>
<a href="README_JP.md">🇯🇵 日本語版はこちら</a> · Inspired by <a href="https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f">Karpathy's LLM Wiki</a>
</p>
## What is Exbrain?

263
README_JP.md Normal file
View file

@ -0,0 +1,263 @@
<p align="center">
<img src="assets/banner.png" alt="Exbrain Banner" width="800">
</p>
<h1 align="center">Exbrain — AIの外付け脳</h1>
<p align="center">
<b>AIが勝手に記憶し、整理し、毎朝振り返ってくれるナレッジシステム</b><br>
Claude Code × Obsidian × SOUL/MEMORY/DREAMS<br><br>
<a href="README.md">🇺🇸 English</a> · <a href="https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f">Karpathy's LLM Wiki</a> にインスパイア
</p>
## 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と外部エージェントの性格設定を統合。
```markdown
## Identity
- 名前、役割、会社
## Values
- 「完璧主義より実験主義」
- 「APIファースト、手作業は排除」
## Boundaries（絶対遵守）
- 「メール送信禁止 — 下書きのみ」
- 「Slack確認なしで送信禁止」
```
### MEMORY.md — 経験の蓄積
AIが学んだこと全てのダイジェスト。Claude Codeの Memory（`.claude/projects/*/memory/`）を自動同期 + Cloud Scheduled Tasksが朝夕に追記。
```markdown
## Recent
- [2026-04-07] Obsidian Vault構築、SOUL/MEMORY/DREAMS実装
## Patterns
- 金曜は会議密度が高い（3週連続）
- メール返信が午後に集中
## CC Memory サマリー（35件）
- feedback/21件: 「メール送信禁止」「GAS編集後は毎回commit」
- reference/7件: API情報、ツール設定
```
### DREAMS.md — 内省と成長
Dreaming（朝夕+週次）が自動更新。時間とともに浮かび上がるパターンを記録。
```markdown
## 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作成
```bash
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: テンプレートをコピー
```bash
git clone https://github.com/YOUR_USERNAME/exbrain.git /tmp/exbrain
cp -r /tmp/exbrain/vault-template/* ~/vault/
```
### Step 3: Hooks設定
`~/.claude/settings.json` に追加:
```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バックアップ
```bash
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不要にする場合）
[claude.ai/code/scheduled](https://claude.ai/code/scheduled) で:
- **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](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — 設計思想の原点
- [Claude Code Hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — async hookの公式ドキュメント
- [Cloud Scheduled Tasks](https://docs.anthropic.com/en/docs/claude-code/scheduled-tasks) — PC不要の自動化
- [QMD](https://github.com/tobi/qmd) — Markdownセマンティック検索（100ページ超で導入検討）
## ライセンス
MIT

BIN
assets/banner.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.2 MiB