用途：kb-memory 用于读写共享知识库（shared brain，位于 ~/kb），在会话开始时回忆关于用户和项目的持久事实，并在获得值得长期保留的信息时写入。
位置：知识库是 Markdown 笔记的 git 仓库，位置可配置。若设置了 $KB_DIR 则使用它，否则运行 kb root 解析（默认 ~/kb）。所有命令通过 kb CLI 执行（位于仓库的 scripts/ 中，安装后在 PATH 上）。
读取（进入时）：回答任何非琐碎问题前，先运行 kb index 读取 MEMORY.md（每条笔记一行的索引）；打开与任务匹配的 memory/*.md 笔记；需要更新或更深的细节时，获取笔记的来源（URL，即 …/llms.txt）。
写入（离开时）：不确定是否持久，用快速捕获 kb capture "<rough note>"（追加到 raw/inbox/<today>.md，之后由 dream pass 提炼）；若是确定的保留内容，按 memory/_TEMPLATE.md 在 memory/ 中添加标准笔记，顶层 frontmatter 包含 name（与文件名相同）、description、type（user|feedback|project|reference|tech）、tags、created、updated，可选 title/category/aliases/related/sources；用 [[slug]] 链接相关笔记；向 MEMORY.md 添加一行指针。之后运行 kb lint（强制执行标准）和 kb sync（pull/commit/push）。
范围与限制：仅限公开、持久、通用的事实——该仓库是公开的。绝不存储机密、SSH 主机、内部或保密细节。完整协议见 $KB_DIR/AGENTS.md，合并整理见 kb-dream。