From b408a621365b68745c9317ee1408b021e90c2232 Mon Sep 17 00:00:00 2001 From: jared Date: Thu, 4 Jun 2026 11:18:31 -0400 Subject: [PATCH] Align 04-build-plan vault path with ADR-012 Replace the stale ~/brain placeholder with the locked vault location ~/Documents/SecondBrain so the build plan agrees with ADR-012 and the runbook. Pre-existing inconsistency, surfaced during change verification. Co-Authored-By: Claude Opus 4.8 --- docs/memory-system/04-build-plan.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/memory-system/04-build-plan.md b/docs/memory-system/04-build-plan.md index 97742e4..3c7949b 100644 --- a/docs/memory-system/04-build-plan.md +++ b/docs/memory-system/04-build-plan.md @@ -30,8 +30,9 @@ Build bottom-up: the vault and Graphify first (usable standalone), then the hook plugin that packages it. ### Step 1 — Vault skeleton & conventions -- Decide the vault location (default: a synced home dir, e.g. `~/brain`; symlink into - `~/.claude/memory` only if a tool insists). **Vault is the single source of truth.** +- Vault location is settled by ADR-012: `~/Documents/SecondBrain` (the existing Obsidian + vault). No new vault is created; symlink into `~/.claude/memory` only if a tool insists. + **Vault is the single source of truth.** - Write `CONVENTIONS.md` in the vault: the frontmatter contract. The required fields are `summary` (one-line, author-written — this is the human-readable router hint Graphify does not generate) and `scope` (`scope/global` or `scope/project`). Tags are now @@ -110,14 +111,14 @@ Run the initial build against the small fixture set (5–10 notes from Step 1/2c full vault. The bulk vault build is deferred to after the system is validated end-to-end. ```bash -graphify extract --path ~/brain --backend ollama --model gemma4:e2b \ +graphify extract --path ~/Documents/SecondBrain --backend ollama --model gemma4:e2b \ --token-budget 512 --max-concurrency 2 ``` Tune `--token-budget` (semantic chunk size) and `--max-concurrency` based on VRAM headroom. Review `GRAPH_REPORT.md` — check god nodes make sense (they should be your most-connected tools, clients, and domain concepts). -**Full vault migration** (the `~/brain` build above run over all notes) is the final step — +**Full vault migration** (the `~/Documents/SecondBrain` build above run over all notes) is the final step — deferred to after end-to-end validation on the pilot project. Do not bulk-migrate the vault until the system is verified working on the fixture set and pilot project. @@ -280,7 +281,8 @@ global install keeps conventions a single source of truth. ## Open questions -1. **Vault location** — `~/brain` (synced home dir)? Symlink into `~/.claude/memory`? +1. **Vault location** — Settled by ADR-012: `~/Documents/SecondBrain`. Symlink into + `~/.claude/memory` only if a tool requires it. 2. **Sync mechanism** — git (versioned, hourly) vs Syncthing (continuous)? 3. **Stale rebuild threshold** — how many days before SessionStart triggers `--force`? 7 days is the starting guess; tune after observing drift in practice.