Commit Graph

102 Commits

Author SHA1 Message Date
jared 54b00364cd Add 3-layer memory system design documentation
This documents the complete architecture for a personal, cross-project
memory system for Claude Code: three-layer (episodic/knowledge/deferred-
semantic) design using Milvus Lite for fast local storage with lazy
remote sync. Includes video synthesis, architecture decisions with
rejected alternatives (MemPalace, Mem0, Postgres, LightRAG), concrete
build plan with scripts and hooks, and initial handoff for implementation.
2026-06-03 16:47:50 -04:00
jared b0695dd4b5 Add Graphify setup & best-practices guide (11 docs + research)
Research: dispatched 11 subagents to synthesize a creator interview into 11
standalone documents (overview, install, code/doc ingestion, backends, querying,
token economics, workflows, best practices, and community tips), then reconciled
cross-document contradictions against the GitHub repo (v0.8.30 release).

Verified all substantive claims against primary sources (GitHub, interview,
community, PyPI). Corrected interview errors: package is graphifyy (double-y),
shell scripts now AST-supported, Slack/meetings/OneNote connectors are roadmap
not shipped. Settled flag version disputes (--token-budget vs. --budget) by
grepping raw README bytes. Applied honest token-savings framing (1–49x measured,
not 70–90x marketing).

Every claim tagged inline by source confidence ([github] / [interview] /
[community] / [unverified]). Zero broken links, zero residual contradictions.

Deliverable: docs/graphify/
  - 00-README.md: index, reading order, provenance
  - 01-overview-concepts.md: god nodes, neuro-symbolic, vs. Obsidian
  - 02-installation-setup.md: install, register, first run
  - 03-ingesting-code-ast.md: tree-sitter, 33 languages, multi-repo
  - 04-ingesting-docs-knowledge.md: PDF/media/YouTube/Google Workspace
  - 05-local-models-and-backends.md: Ollama vs. cloud, privacy
  - 06-querying-and-god-nodes.md: god-nodes-first discipline
  - 07-token-economics-and-updates.md: savings honestly, --update, SHA hashing
  - 08-workflows-and-use-cases.md: onboarding, bug-trace, audits, second brain
  - 09-best-practices-checklist.md: do/don't reference + quick commands
  - external-tips.md: community tips, gotchas, savings debate

Also included: graphify-interview (raw creator interview, source material),
memory-systems-compared060326 (research reference).
2026-06-03 16:45:07 -04:00