diff --git a/docs/configuration.html b/docs/configuration.html
index 81cf605..3a23550 100644
--- a/docs/configuration.html
+++ b/docs/configuration.html
@@ -441,7 +441,8 @@ <h2 data-i18n="mem.title">Memory</h2>
               Memory is user-private knowledge pinned into the immutable prefix — so the
               agent reads it on every turn without re-priming. Two scopes: <em>global</em>
               (cross-project facts about you) and <em>project</em> (per-workspace context).
-              Distinct from a committable <code>CARBON.md</code>, which lives in the repo.
+              Distinct from committable <code>AGENTS.md</code> / <code>CARBON.md</code>
+              project rules, which live in the repo.
             </p>
 
             <h3 data-i18n="mem.h.layout">Layout</h3>
diff --git a/docs/guide-i18n.js b/docs/guide-i18n.js
index e3fa200..6170f31 100644
--- a/docs/guide-i18n.js
+++ b/docs/guide-i18n.js
@@ -101,7 +101,7 @@
 
     "mem.title": "Memory",
     "mem.body1":
-      "Memory is user-private knowledge pinned into the immutable prefix — so the agent reads it on every turn without re-priming. Two scopes: <em>global</em> (cross-project facts about you) and <em>project</em> (per-workspace context). Distinct from a committable <code>CARBON.md</code>, which lives in the repo.",
+      "Memory is user-private knowledge pinned into the immutable prefix — so the agent reads it on every turn without re-priming. Two scopes: <em>global</em> (cross-project facts about you) and <em>project</em> (per-workspace context). Distinct from committable <code>AGENTS.md</code> / <code>CARBON.md</code> project rules, which live in the repo.",
     "mem.h.layout": "Layout",
     "mem.idx": "index — pinned into the prefix",
     "mem.proj": "sha1(absRoot)[0..16]",
@@ -272,7 +272,7 @@
 
     "mem.title": "Memory",
     "mem.body1":
-      "Memory 是用户私有的知识，钉进不可变前缀——所以 agent 每回合都自动读到，不用再重新 prime。两个 scope：<em>global</em>（关于你的、跨项目事实）与 <em>project</em>（按工作区的上下文）。和提交进仓库的 <code>CARBON.md</code> 不是一回事。",
+      "Memory 是用户私有的知识，钉进不可变前缀——所以 agent 每回合都自动读到，不用再重新 prime。两个 scope：<em>global</em>（关于你的、跨项目事实）与 <em>project</em>（按工作区的上下文）。和提交进仓库的 <code>AGENTS.md</code> / <code>CARBON.md</code> 项目规则不是一回事。",
     "mem.h.layout": "目录布局",
     "mem.idx": "索引——会被钉进前缀",
     "mem.proj": "sha1(absRoot)[0..16]",
diff --git a/docs/src/config.jsx b/docs/src/config.jsx
index 4c51a55..a4cab3b 100644
--- a/docs/src/config.jsx
+++ b/docs/src/config.jsx
@@ -103,20 +103,20 @@ Only focus on the code touched by this diff — don't go off-topic.`,
     title: 'Memory',
     cn: { zh: '项目级与全局记忆', en: 'Project + global memory' },
     desc: {
-      zh: 'Carbon Code 把"应当记住"的内容拆成两层：仓库级的 CARBON.md（提交进 git，团队共享）与用户级的 ~/.carboncode/memory.md（个人偏好，不入库）。每次会话启动时自动注入到 prompt 头部。',
-      en: 'Carbon Code splits "what to remember" into two layers: repo-level `CARBON.md` (checked into git, shared with the team) and user-level `~/.carboncode/memory.md` (personal preferences, kept private). Both are injected at the top of the prompt on every session.',
+      zh: 'Carbon Code 把"应当记住"的内容拆成两层：仓库级的 AGENTS.md / CARBON.md（提交进 git，团队共享）与用户级的 ~/.carboncode/memory/（个人偏好，不入库）。每次会话启动时自动注入到 prompt 头部。',
+      en: 'Carbon Code splits "what to remember" into two layers: repo-level `AGENTS.md` / `CARBON.md` files (checked into git, shared with the team) and user-level `~/.carboncode/memory/` entries (personal preferences, kept private). Both are injected at the top of the prompt on every session.',
     },
     bullets: [
-      { zh: '<project>/CARBON.md · 项目约定 · git-tracked', en: '<project>/CARBON.md · project conventions · git-tracked' },
-      { zh: '~/.carboncode/memory.md · 用户偏好 · 私有', en: '~/.carboncode/memory.md · user preferences · private' },
+      { zh: '<project>/AGENTS.md 或 CARBON.md · 项目约定 · git-tracked', en: '<project>/AGENTS.md or CARBON.md · project conventions · git-tracked' },
+      { zh: '~/.carboncode/memory/ · 用户偏好 · 私有', en: '~/.carboncode/memory/ · user preferences · private' },
       { zh: '/memory edit 在 TUI 内直接编辑', en: '/memory edit opens it inside the TUI' },
       { zh: '注入位置位于 cache-stable 前缀 · 不影响命中', en: 'Injected inside the cache-stable prefix · cache hit unaffected' },
     ],
     files: [
       {
-        name: '<project>/CARBON.md',
+        name: '<project>/AGENTS.md',
         lang: 'md',
-        code: `# CARBON.md
+        code: `# AGENTS.md
 # Carbon Code loads this on every session start.
 
 ## Conventions
@@ -135,7 +135,7 @@ Only focus on the code touched by this diff — don't go off-topic.`,
 - Don't bump version numbers in package.json`,
       },
       {
-        name: '~/.carboncode/memory.md',
+        name: '~/.carboncode/memory/global/preferences.md',
         lang: 'md',
         code: `# Personal preferences
 
@@ -223,7 +223,7 @@ Only focus on the code touched by this diff — don't go off-topic.`,
 # Capabilities
 › /mcp list           # mounted MCP servers
 › /skill new fix-bug  # scaffold a new skill
-› /memory edit        # open CARBON.md
+› /memory edit        # open AGENTS.md / CARBON.md
 
 # Session + replay
 › /status             # model · cache hit · cost