332 lines
13 KiB
Markdown
332 lines
13 KiB
Markdown
# Claude Code × Obsidian Wiki — Your AI Remembers, Reflects, and Evolves
|
||
|
||
> AIが勝手に記憶し、整理し、毎朝振り返ってくれるナレッジシステム
|
||
>
|
||
> Inspired by [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) + the Dreaming pattern
|
||
|
||
Claude Codeの中に眠っている記憶（Memory）、設定ファイル（CLAUDE.md）、スキル（Skills）を
|
||
Obsidianで可視化し、毎朝・毎夕のDreamingで自動振り返りを行う仕組み。
|
||
|
||
PC閉じてても動く。iPhoneからも見える。人間はObsidianを開いて読むだけ。
|
||
|
||
## コンセプト
|
||
|
||
```
|
||
┌─ Claude Code の世界（普段は .claude/ に隠れている）───────────┐
|
||
│ │
|
||
│ CLAUDE.md ×N ←──┐ │
|
||
│ CC Memory ×N ←──┤── 自動同期 ──→ ~/vault/ │
|
||
│ Skills ×N ←──┤ (Obsidian) │
|
||
│ Cron jobs ←──┘ 人間が見る窓 │
|
||
│ │
|
||
│ + 日記（daily/）は Obsidian にだけ存在 │
|
||
│ + Dreaming（朝夕の自動振り返り）で知見が複利で増える │
|
||
│ │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 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
|
||
▼
|
||
┌─ GitHub (private repo) ─────────────────────────────────────┐
|
||
│ vault/ の全ファイル │
|
||
└──────────────────────┬──────────────────────────────────────┘
|
||
│ pull (launchd 毎時)
|
||
▼
|
||
┌─ Layer 2: ローカル自動化 ───────────────────────────────────┐
|
||
│ │
|
||
│ Claude Code Hooks (async: true) │
|
||
│ ├── PostToolUse → ファイル変更をログ記録 │
|
||
│ └── Stop → セッション終了をdaily noteに自動追記 │
|
||
│ │
|
||
│ External AI Agent Cron（PCオン時の追加データ） │
|
||
│ ├── SF/Stripe/HERP/YouTube等の専門データ追記 │
|
||
│ └── PCオフなら単にスキップ（Layer 1だけで完成） │
|
||
│ │
|
||
└──────────────────────┬──────────────────────────────────────┘
|
||
│ iCloud
|
||
▼
|
||
Obsidian (Mac + iPhone)
|
||
```
|
||
|
||
## AIの記憶システム（Memory）
|
||
|
||
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/
|
||
├── CLAUDE.md ← Schema（LLM向けルール定義）
|
||
├── DREAMS.md ← Dreaming蓄積ファイル
|
||
│
|
||
├── daily/ ← デイリーノート
|
||
│ └── 2026-04-07.md Schedule / Gmail / Slack / AI Analysis /
|
||
│ Morning Reflection / Evening Reflection /
|
||
│ Claude Code Session / Thoughts
|
||
│
|
||
├── system/ ← Claude Codeシステムのミラー（SYNCED）
|
||
│ ├── claude-md-tree.md 全CLAUDE.mdの階層ツリー
|
||
│ ├── global-rules.md ルール・禁止事項の要約
|
||
│ ├── api-inventory.md 保有API一覧（キーは除外）
|
||
│ ├── tech-stack.md 技術スタック
|
||
│ └── cron-jobs.md 稼働中ジョブ一覧
|
||
│
|
||
├── skills/ ← 全スキル一覧 + 個別ページ（SYNCED）
|
||
│ ├── _index.md カテゴリ別テーブル
|
||
│ └── auto-minutes.md 各スキルの説明・コマンド
|
||
│
|
||
├── memory/ ← CC Memory完全ミラー（SYNCED）
|
||
│ ├── _index.md 全メモリ一覧（タイプ別）
|
||
│ ├── feedback/ 行動指針
|
||
│ ├── reference/ 外部参照
|
||
│ ├── project/ プロジェクト状況
|
||
│ └── user/ ユーザープロファイル
|
||
│
|
||
├── clients/ ← 顧客ナレッジ蓄積（Karpathyパターン）
|
||
│ ├── _index.md 全顧客一覧
|
||
│ └── client-a.md 議事録のたびに自動蓄積
|
||
│
|
||
├── meetings/ ← 議事録要点（/auto-minutes連携）
|
||
├── decisions/ ← 経営判断ログ
|
||
├── insights/ ← 学び・パターン + 週次Dreaming
|
||
├── templates/ ← daily-note, meeting, decision
|
||
└── 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/claude-code
|
||
ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/claude-code ~/vault
|
||
```
|
||
|
||
### Step 2: テンプレートファイルをコピー
|
||
|
||
このリポジトリの `vault-template/` をコピー:
|
||
|
||
```bash
|
||
cp -r vault-template/* ~/vault/
|
||
```
|
||
|
||
### Step 3: Claude Code 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で実行:
|
||
|
||
```
|
||
/wiki-sync-init
|
||
```
|
||
|
||
または手動:
|
||
|
||
```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
|
||
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 で:
|
||
- **vault-daily-morning**: 毎朝07:00、Calendar+Slack+Gmail→daily note生成
|
||
- **vault-daily-evening**: 毎夕18:30、Evening Dreaming+パターン検出
|
||
|
||
## デイリーノートの完成形
|
||
|
||
```markdown
|
||
---
|
||
date: 2026-04-07
|
||
weekday: Monday
|
||
type: daily
|
||
score: 74
|
||
---
|
||
|
||
## Schedule
|
||
| 時間 | 予定 | 備考 |
|
||
|------|------|------|
|
||
| 09:00 | 経営管理部 定例 | |
|
||
| 10:00 | 開発営業 定例 | |
|
||
| 14:00 | 社内定例 | |
|
||
|
||
## Gmail
|
||
| From | Subject | Action |
|
||
|------|---------|--------|
|
||
| 田中太郎 | セミナー開催打合せ | 要返信 |
|
||
|
||
## Slack Highlights
|
||
- **#general**: 組織体制の議論
|
||
- **#sales**: チャットbot進捗、CRM連携デモ依頼
|
||
- **#daily-report**: X社向け研修の受注ほぼ確定
|
||
|
||
## AI Analysis
|
||
- 生産性: B — 会議完了率100%
|
||
- 対応力: B — 未読メール6件
|
||
- 営業: B- — 商談0件
|
||
|
||
## Morning Reflection
|
||
- 昨日の決定: サービス料金改定を決定
|
||
- 今日の注目: セミナー返信、パートナーMTG
|
||
|
||
## Evening Reflection
|
||
- 今日のハイライト: X社向け研修の受注ほぼ確定
|
||
- パターン: 月曜は会議が10件超で最多（3週連続）
|
||
- 未解決: セミナー打合せ返信
|
||
|
||
## Thoughts
|
||
<!-- 自分で一言 -->
|
||
```
|
||
|
||
## 参考
|
||
|
||
- [Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — 設計思想の原点
|
||
- [obsidian-wiki (Ar9av)](https://github.com/Ar9av/obsidian-wiki) — Karpathyパターンのフレームワーク
|
||
- [QMD](https://github.com/tobi/qmd) — Markdownセマンティック検索（100ページ超で導入検討）
|
||
- [Claude Code Hooks](https://code.claude.com/docs/en/hooks-guide) — async hookの公式ドキュメント
|
||
- [Cloud Scheduled Tasks](https://code.claude.com/docs/en/web-scheduled-tasks) — PC不要の自動化
|
||
|
||
## License
|
||
|
||
MIT
|