diff --git a/README.md b/README.md index 338d6ba..8c69348 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,14 @@ -# Exbrain — Your AI's External Brain +

+ Exbrain Banner +

-> 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) +

Exbrain — Your AI's External Brain

+ +

+ An AI knowledge system that automatically remembers, organizes, and reflects.
+ Claude Code × Obsidian × SOUL/MEMORY/DREAMS

+ 🇯🇵 日本語版はこちら · Inspired by Karpathy's LLM Wiki +

## What is Exbrain? diff --git a/README_JP.md b/README_JP.md new file mode 100644 index 0000000..33f27a3 --- /dev/null +++ b/README_JP.md @@ -0,0 +1,263 @@ +

+ Exbrain Banner +

+ +

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と外部エージェントの性格設定を統合。 + +```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の中身を自動同期、読むだけ +│ → ヘッダー付き +│ +├── 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 diff --git a/assets/banner.png b/assets/banner.png new file mode 100644 index 0000000..6c783a5 Binary files /dev/null and b/assets/banner.png differ