jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity

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 <noreply@anthropic.com>
This commit is contained in:
jared 2026-06-04 11:18:31 -04:00
parent 77febc8aca
commit b408a62136
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/memory-system/04-build-plan.md
View File

@ -30,8 +30,9 @@ Build bottom-up: the vault and Graphify first (usable standalone), then the hook
plugin that packages it. plugin that packages it.
### Step 1 — Vault skeleton & conventions ### Step 1 — Vault skeleton & conventions
- Decide the vault location (default: a synced home dir, e.g. `~/brain`; symlink into - Vault location is settled by ADR-012: `~/Documents/SecondBrain` (the existing Obsidian
`~/.claude/memory` only if a tool insists). **Vault is the single source of truth.** 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 - 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 `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 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. full vault. The bulk vault build is deferred to after the system is validated end-to-end.
```bash ```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 --token-budget 512 --max-concurrency 2
``` ```
Tune `--token-budget` (semantic chunk size) and `--max-concurrency` based on VRAM headroom. 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 Review `GRAPH_REPORT.md` — check god nodes make sense (they should be your most-connected
tools, clients, and domain concepts). 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 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. 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 ## 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)? 2. **Sync mechanism** — git (versioned, hourly) vs Syncthing (continuous)?
3. **Stale rebuild threshold** — how many days before SessionStart triggers `--force`? 3. **Stale rebuild threshold** — how many days before SessionStart triggers `--force`?
7 days is the starting guess; tune after observing drift in practice. 7 days is the starting guess; tune after observing drift in practice.