v3: Add banner image, Japanese README, bilingual navigation
This commit is contained in:
Masahiro Chaen
parent
c67aeead2a
commit
5b9267a186
3 changed files with 273 additions and 6 deletions
16
README.md
16
README.md
|
|
@ -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.
|
<h1 align="center">Exbrain — Your AI's External Brain</h1>
|
||||||
>
|
|
||||||
> Claude Code × Obsidian × SOUL/MEMORY/DREAMS
|
<p align="center">
|
||||||
>
|
<b>An AI knowledge system that automatically remembers, organizes, and reflects.</b><br>
|
||||||
> Inspired by [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
|
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?
|
## What is Exbrain?
|
||||||
|
|
||||||
|
|
|
||||||
263
README_JP.md
Normal file
263
README_JP.md
Normal 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
BIN
assets/banner.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.2 MiB |
Loading…
Add table
Add a link
Reference in a new issue