summaryrefslogtreecommitdiff
path: root/scripts
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
commitf296e59610a916d0a39f5de4929165830b7fd959 (patch)
treef9233e9be76a447221cc45fa3675defe507ae952 /scripts
parentf288e3fd6d19c20cc51561a45eca8cfce555129e (diff)
downloaddotemacs-f296e59610a916d0a39f5de4929165830b7fd959.tar.gz
dotemacs-f296e59610a916d0a39f5de4929165830b7fd959.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 'scripts')
0 files changed, 0 insertions, 0 deletions