claude-second-brain 0.4.0 → 0.4.1

package/README.md

@@ -133,6 +133,61 @@ It's a plain GitHub repo. View and edit files directly in the browser at any tim
 
 ## How it works
 
+Sources flow in on the left, Claude synthesizes them into the wiki, qmd indexes every page into a local hybrid search index, and GitHub makes the whole vault editable from Obsidian and Claude Code on any device.
+
+```mermaid
+flowchart TB
+  subgraph Sources["sources/ — raw, immutable"]
+    direction LR
+    S1[articles/]
+    S2[pdfs/]
+    S3[personal/]
+  end
+
+  subgraph Skills["Claude Code skills"]
+    direction LR
+    I["/brain-ingest"]
+    Q["/brain-search"]
+    R["/brain-refresh"]
+  end
+
+  subgraph Wiki["wiki/ — cross-linked synthesis"]
+    direction LR
+    W1[overview.md]
+    W2[topic / entity pages]
+    W3[sources/]
+    W4[qa/]
+  end
+
+  QMD[("qmd.sqlite<br/>vector + BM25<br/>hybrid index")]
+
+  subgraph Remote["GitHub — source of truth"]
+    GH[private repo]
+  end
+
+  subgraph Read["Read / edit anywhere"]
+    direction LR
+    OB["Obsidian<br/>graph · backlinks · mobile"]
+    CC["Claude Code<br/>desktop + mobile"]
+  end
+
+  User((you))
+
+  Sources -->|read| I
+  I -->|write pages, cross-link,<br/>flag contradictions| Wiki
+  R -.->|chunk + embed<br/>changed files| QMD
+  Wiki -.->|indexed by| QMD
+  User -->|ask a question| Q
+  Q -->|hybrid search| QMD
+  QMD -->|top-k pages| Q
+  Q -->|cited answer| User
+  Wiki <-->|"obsidian-git<br/>auto commit / pull"| GH
+  GH --> OB
+  GH --> CC
+```
+
+### The ingest loop, zoomed in
+
 ```
 ┌─────────────────────┐        ┌─────────────────────┐        ┌─────────────────────┐
 │   Drop in a source  │        │ /brain-ingest       │        │     Wiki grows      │

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-second-brain",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Scaffold an LLM-maintained Obsidian knowledge wiki",
   "type": "module",
   "bin": {

package/template/README.md

@@ -54,6 +54,63 @@ Registers the qmd collections and generates local vector embeddings. First run d
 
 ---
 
+## How it works
+
+Sources flow in on the left, Claude synthesizes them into the wiki, qmd indexes every page into a local hybrid search index, and GitHub makes the whole vault editable from Obsidian and Claude Code on any device.
+
+```mermaid
+flowchart TB
+  subgraph Sources["sources/ — raw, immutable"]
+    direction LR
+    S1[articles/]
+    S2[pdfs/]
+    S3[personal/]
+  end
+
+  subgraph Skills["Claude Code skills"]
+    direction LR
+    I["/brain-ingest"]
+    Q["/brain-search"]
+    R["/brain-refresh"]
+  end
+
+  subgraph Wiki["wiki/ — cross-linked synthesis"]
+    direction LR
+    W1[overview.md]
+    W2[topic / entity pages]
+    W3[sources/]
+    W4[qa/]
+  end
+
+  QMD[("qmd.sqlite<br/>vector + BM25<br/>hybrid index")]
+
+  subgraph Remote["GitHub — source of truth"]
+    GH[private repo]
+  end
+
+  subgraph Read["Read / edit anywhere"]
+    direction LR
+    OB["Obsidian<br/>graph · backlinks · mobile"]
+    CC["Claude Code<br/>desktop + mobile"]
+  end
+
+  User((you))
+
+  Sources -->|read| I
+  I -->|write pages, cross-link,<br/>flag contradictions| Wiki
+  R -.->|chunk + embed<br/>changed files| QMD
+  Wiki -.->|indexed by| QMD
+  User -->|ask a question| Q
+  Q -->|hybrid search| QMD
+  QMD -->|top-k pages| Q
+  Q -->|cited answer| User
+  Wiki <-->|"obsidian-git<br/>auto commit / pull"| GH
+  GH --> OB
+  GH --> CC
+```
+
+---
+
 ## Obsidian Mobile
 
 If this repo lives inside your iCloud Drive folder, Obsidian Mobile reads it with no extra setup. Graph view, backlinks, offline access — all working. The Git plugin handles sync automatically when you commit and push.