Commit Graph

101 Commits

Author SHA1 Message Date
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