aboutsummaryrefslogtreecommitdiff
path: root/docs/design/dev-setup-project.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-24 02:32:56 -0500
committerCraig Jennings <c@cjennings.net>2026-05-24 02:32:56 -0500
commit0890566925f0cb18c4c4ba531895b948127e4744 (patch)
tree99059ebc78df4517b2f6fdf6b9d33fabffea6c0a /docs/design/dev-setup-project.org
parent493b2ee4c8b67f8a980b7645d24a3422b5ff9c10 (diff)
downloaddotemacs-0890566925f0cb18c4c4ba531895b948127e4744.tar.gz
dotemacs-0890566925f0cb18c4c4ba531895b948127e4744.zip
docs(design): add ai-kb spec — global org-roam memory store for the agent
ai-kb is a global, durable, cross-project memory store for Claude Code: org-roam nodes holding lessons, principles, my preferences, and reusable procedures, distinct from the per-project memory files (which shrink to an index pointing into it). The spec covers the two-layer model (a git-versioned file store the agent reads/writes, and an Emacs switch command so I can browse it with backlinks), the sync model, the routing and proactive-write rules, the node format, and the startup retrieval contract. It folds in two reviews. The scope decision: v1 is the memory store, not a full Karpathy LLM Wiki. The heavy machinery (compiled wiki layer, source hashes, formal ingest pipeline, embedding search) is deferred to vNext, each with a reason. Storage is a dedicated private git repo at an XDG path rather than Syncthing or the public emacs-config repo, which would leak personal notes. Two Karpathy ideas earned their way into v1 because they pay off now: capturing the raw source when a node is compiled from external material, and an org-lint validity check on every write so malformed org never reaches the index. Review dispositions and the open decisions are recorded in the spec.
Diffstat (limited to 'docs/design/dev-setup-project.org')
0 files changed, 0 insertions, 0 deletions