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 | 1faa6e7538d458a9e65c6e97fbf566363686e6c8 (patch) | |
| tree | acd4e459081f886387bd87afa5481ce8269aa99e /tests/test-integration-buffer-diff.el | |
| parent | 40303246cb1a6d21621d8898a41ed7d4675fc3f3 (diff) | |
| download | dotemacs-1faa6e7538d458a9e65c6e97fbf566363686e6c8.tar.gz dotemacs-1faa6e7538d458a9e65c6e97fbf566363686e6c8.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 'tests/test-integration-buffer-diff.el')
0 files changed, 0 insertions, 0 deletions
