diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-24 02:32:56 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-24 02:32:56 -0500 |
| commit | 0890566925f0cb18c4c4ba531895b948127e4744 (patch) | |
| tree | 99059ebc78df4517b2f6fdf6b9d33fabffea6c0a /modules/cj-window-toggle-lib.el | |
| parent | 493b2ee4c8b67f8a980b7645d24a3422b5ff9c10 (diff) | |
| download | dotemacs-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 'modules/cj-window-toggle-lib.el')
0 files changed, 0 insertions, 0 deletions
