commit 88d5d979fe1e77f6ac28dfc15925a63cc809f046
Author: Memory Gateway Bot <memory-gateway@example.local>
Date:   Sun Mar 8 14:38:32 2026 +0800

    init: seed collective memory repo

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..1eb9224
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,46 @@
+# AGENTS.md (memory-repo root)
+
+## 1) 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/`）。
+- 智能体在该目录及其子目录内维护记忆文件。
+- 禁止跨仓库写入其他记忆体根目录。
+
+## 2) 目录类型
+- 类型：`root`。
+
+## 3) 当前目录作用
+- 定义整个记忆系统的全局规则与目录语义。
+- 本地 Git 仓库负责写入。
+- 远程 MCP/QMD 负责群体共享记忆权威查询。
+- 本仓库应作为独立记忆仓库存在，例如 Gitea 上的 `collective-memory-repo`。
+- 当前 `qmd-docker-http-mcp` 代码仓库不是群体记忆真相源。
+
+## 4) 查询规则
+- 群体共享记忆查询必须走远程 MCP/QMD（`memory.search/get/trace/status/list_lanes`）。
+- 本地检索仅用于：未 push 草稿、远程故障降级、本地调试。
+- 本地结果不是群体真相。
+
+## 5) Git 工作规则（总则）
+- 修改前：`git fetch --prune origin`，再 `git pull --rebase`。
+- 小步提交，一次提交只做一件事（建议 message 含 `task/agent/scope`）。
+- 优先写自己的 `agents/<id>/`、当前 `tasks/<id>/`、`daily/`。
+- 避免同时修改公共长期文件与私有草稿。
+- 冲突处理：append-only 文件先保留原始记录，再人工提炼长期事实。
+
+## 6) 可见性状态机
+- `push 前`：本地记忆仅自己可见。
+- `push 后但未索引`：记忆已提交但群体未可见。
+- `远程 fetch + qmd update 后`：记忆群体可见。
+- `群体召回`：只认远程 MCP 结果。
+- `本地结果`：只认作个人草稿或 fallback。
+
+## 7) Promote 规则
+- 原始观察先落到 `daily/` 或 `tasks/<id>/` 或 `agents/<id>/`。
+- 稳定结论再 promote 到 `shared/long-term/`。
+- 不允许智能体直接把未验证草稿写入长期共享记忆。
+
+## 8) 参考文档
+- `policies/GIT-SOP.md`
+- `policies/MEMORY-VISIBILITY.md`
+- `policies/QUERY-POLICY.md`
+- `policies/PROMOTION-POLICY.md`
diff --git a/MEMORY.md b/MEMORY.md
new file mode 100644
index 0000000..7cf7a50
--- /dev/null
+++ b/MEMORY.md
@@ -0,0 +1,23 @@
+# MEMORY.md
+
+## 系统定义
+- 写入通道：本地 Git 记忆仓库。
+- 权威查询通道：远程 MCP/QMD。
+- 本地检索角色：草稿与故障降级。
+
+## 目录索引
+- `shared/long-term/`：长期共享记忆（durable facts）。
+- `agents/<agent-id>/`：智能体私域工作记忆。
+- `tasks/<task-id>/`：任务级共享记忆。
+- `daily/`：append-only 原始观察。
+- `policies/`：统一策略与 SOP。
+
+## 记忆生命周期
+1. capture：原始事实写入 `daily/` 或 `tasks/` 或 `agents/`。
+2. review：在任务上下文验证和去重。
+3. promote：沉淀稳定结论到 `shared/long-term/`。
+4. recall：群体召回仅通过远程 MCP/QMD。
+
+## 群体查询准则
+- 所有群体结论必须可追溯到：`branch + commit_hash + synced_at + source_path + scope`。
+- 查询一致性顺序固定：`sync git -> qmd update/embed -> query`。
diff --git a/SOUL.md b/SOUL.md
new file mode 100644
index 0000000..4ed5e81
--- /dev/null
+++ b/SOUL.md
@@ -0,0 +1,5 @@
+# SOUL.md (Optional OpenClaw Compatibility)
+
+本文件为可选兼容层，不是系统必需规范。
+请以 `AGENTS.md` 为唯一通用必读文件。
+本文件内容与根 `AGENTS.md` 保持一致。
diff --git a/USER.md b/USER.md
new file mode 100644
index 0000000..3e1b3df
--- /dev/null
+++ b/USER.md
@@ -0,0 +1,4 @@
+# USER.md (Optional OpenClaw Compatibility)
+
+本文件为可选兼容层，不是系统必需规范。
+系统规则与操作边界请以根 `AGENTS.md` 为准。
diff --git a/agents/AGENTS.md b/agents/AGENTS.md
new file mode 100644
index 0000000..cfdec78
--- /dev/null
+++ b/agents/AGENTS.md
@@ -0,0 +1,28 @@
+# AGENTS.md (agents)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/`）。
+
+## 目录类型
+- 类型：`shared-agent-space`。
+
+## 目录作用
+- 承载各智能体私域目录：`agents/<agent-id>/`。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 每个智能体优先只改自己的子目录。
+- 先同步再提交，小步提交。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 稳定结论通过 task/promote 进入 long-term。
diff --git a/agents/agent-a/AGENT-CARD.md b/agents/agent-a/AGENT-CARD.md
new file mode 100644
index 0000000..4e740ea
--- /dev/null
+++ b/agents/agent-a/AGENT-CARD.md
@@ -0,0 +1,7 @@
+# AGENT-CARD: agent-a
+
+- agent_id: `agent-a`
+- default_lane: `agent`
+- writable_scope: `agents/agent-a/**`
+- promote_target: `shared/long-term/**`
+- query_authority: `remote MCP/QMD only`
diff --git a/agents/agent-a/AGENTS.md b/agents/agent-a/AGENTS.md
new file mode 100644
index 0000000..053da61
--- /dev/null
+++ b/agents/agent-a/AGENTS.md
@@ -0,0 +1,33 @@
+# AGENTS.md (agents/agent-a)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/agent-a/`）。
+- 智能体仅在该目录维护自己的工作记忆。
+- 不得跨目录修改其他智能体私域目录。
+
+## 目录类型
+- 类型：`agent`。
+
+## 目录作用
+- 智能体私域工作记忆：收件、当前上下文、草稿。
+
+## 查询规则
+- 群体共享记忆查询必须走远程 MCP/QMD。
+- 本地检索仅用于未 push 草稿、故障降级和本地调试。
+
+## Git 规则
+- 修改前先 `git fetch --prune origin`，再 `git pull --rebase`。
+- 先写 `inbox.md/current.md/drafts/`，再按需要 promote。
+- 小步提交，避免与长期共享记忆同提交混改。
+- 冲突优先保留 append-only 原始记录。
+
+## 可见性状态机
+- push 前：仅自己可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 个人观察先记在当前目录。
+- 稳定结论通过 task 或 promote 流程进入 `shared/long-term/`。
diff --git a/agents/agent-a/current.md b/agents/agent-a/current.md
new file mode 100644
index 0000000..7447208
--- /dev/null
+++ b/agents/agent-a/current.md
@@ -0,0 +1,3 @@
+# current
+
+当前任务上下文与短期计划。
diff --git a/agents/agent-a/drafts/.gitkeep b/agents/agent-a/drafts/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/agents/agent-a/inbox.md b/agents/agent-a/inbox.md
new file mode 100644
index 0000000..9e44edc
--- /dev/null
+++ b/agents/agent-a/inbox.md
@@ -0,0 +1,3 @@
+# inbox
+
+- [ ] 待整理观察记录
diff --git a/agents/agent-b/AGENT-CARD.md b/agents/agent-b/AGENT-CARD.md
new file mode 100644
index 0000000..d636127
--- /dev/null
+++ b/agents/agent-b/AGENT-CARD.md
@@ -0,0 +1,7 @@
+# AGENT-CARD: agent-b
+
+- agent_id: `agent-b`
+- default_lane: `agent`
+- writable_scope: `agents/agent-b/**`
+- promote_target: `shared/long-term/**`
+- query_authority: `remote MCP/QMD only`
diff --git a/agents/agent-b/AGENTS.md b/agents/agent-b/AGENTS.md
new file mode 100644
index 0000000..58c43b8
--- /dev/null
+++ b/agents/agent-b/AGENTS.md
@@ -0,0 +1,30 @@
+# AGENTS.md (agents/agent-b)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/agents/agent-b/`）。
+
+## 目录类型
+- 类型：`agent`。
+
+## 目录作用
+- `agent-b` 的私域工作记忆目录。
+
+## 查询规则
+- 群体查询只认远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 先同步（fetch + pull --rebase）再修改。
+- 小步提交，不跨目录乱改。
+- 冲突时先保留原始记录，后人工整理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 原始观察在 agent/task/daily。
+- 稳定事实 promote 到 long-term。
diff --git a/agents/agent-b/current.md b/agents/agent-b/current.md
new file mode 100644
index 0000000..9c4aa3f
--- /dev/null
+++ b/agents/agent-b/current.md
@@ -0,0 +1,3 @@
+# current
+
+当前上下文。
diff --git a/agents/agent-b/drafts/.gitkeep b/agents/agent-b/drafts/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/agents/agent-b/inbox.md b/agents/agent-b/inbox.md
new file mode 100644
index 0000000..9c531c6
--- /dev/null
+++ b/agents/agent-b/inbox.md
@@ -0,0 +1,3 @@
+# inbox
+
+- [ ] 待办输入
diff --git a/daily/2026-03-08.md b/daily/2026-03-08.md
new file mode 100644
index 0000000..c1c7b5c
--- /dev/null
+++ b/daily/2026-03-08.md
@@ -0,0 +1,3 @@
+# 2026-03-08
+
+- 原始观察：系统完成远程权威查询链路验证。
diff --git a/daily/2026-03-09.md b/daily/2026-03-09.md
new file mode 100644
index 0000000..c386c12
--- /dev/null
+++ b/daily/2026-03-09.md
@@ -0,0 +1,3 @@
+# 2026-03-09
+
+- 原始观察：任务记忆与长期记忆目录分离完成。
diff --git a/daily/AGENTS.md b/daily/AGENTS.md
new file mode 100644
index 0000000..bc87819
--- /dev/null
+++ b/daily/AGENTS.md
@@ -0,0 +1,28 @@
+# AGENTS.md (daily)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/daily/`）。
+
+## 目录类型
+- 类型：`daily`。
+
+## 目录作用
+- 原始日记/观察记录，默认 append-only。
+
+## 查询规则
+- 群体查询只认远程 MCP/QMD。
+- 本地查询仅草稿/fallback。
+
+## Git 规则
+- 每天一个文件，追加写入为主。
+- 不把 daily 直接当长期真相，需 promote。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- daily 里的稳定事实必须提炼后写入 `shared/long-term/`。
diff --git a/policies/GIT-SOP.md b/policies/GIT-SOP.md
new file mode 100644
index 0000000..4b42d9c
--- /dev/null
+++ b/policies/GIT-SOP.md
@@ -0,0 +1,35 @@
+# GIT-SOP
+
+## 目标
+- 降低冲突。
+- 保证“先同步再提交”。
+- 避免长期共享记忆被多人同时频繁改写。
+- 保证 task/agent/daily 记录优先 append-only。
+- 建立稳定的 promote 流程。
+
+## 标准流程
+1. 修改前同步
+- `git fetch --prune origin`
+- `git pull --rebase`
+- 确认当前分支与远端一致。
+
+2. 写入阶段
+- 优先写私域和过程态目录：`agents/<id>/`、`tasks/<id>/`、`daily/`。
+- 原始观察不直接进入 `shared/long-term/`。
+
+3. 提交阶段
+- 小步提交，一次提交只做一类修改。
+- commit message 建议包含 `task:<id> agent:<id> scope:<lane>`。
+
+4. push 后语义
+- push 仅表示“已提交到远端”，不代表群体立即可见。
+- 必须等待远程服务完成 `fetch + qmd update`。
+
+5. promote 阶段
+- 仅把稳定事实从 `task/agent/daily` 提炼至 `shared/long-term/`。
+- promote 提交应附来源路径与证据引用。
+
+## 冲突处理
+- `daily/RUNLOG/inbox`：按 append-only 思路合并。
+- `shared/long-term/*`：禁止自动粗暴合并，必须人工审阅。
+- 无法确认语义一致时，先保留原始记录，再单独提交整理。
diff --git a/policies/MEMORY-VISIBILITY.md b/policies/MEMORY-VISIBILITY.md
new file mode 100644
index 0000000..d5e1871
--- /dev/null
+++ b/policies/MEMORY-VISIBILITY.md
@@ -0,0 +1,22 @@
+# MEMORY-VISIBILITY
+
+## 可见性状态机
+1. push 前
+- 本地记忆仅写入者可见。
+
+2. push 后但未索引
+- 内容已在远端 Git，但远程 MCP/QMD 尚未完成索引。
+- 群体查询不可将其视为已可见。
+
+3. 远程 fetch + qmd update 后
+- 该 commit 进入远程索引。
+- 群体查询可见。
+
+4. 群体召回
+- 只认远程 MCP 返回结果。
+
+5. 本地结果
+- 仅作个人草稿或 fallback。
+
+## 可追溯字段
+- 每次查询返回必须包含：`branch`、`commit_hash`、`synced_at`、`source_path`、`scope`。
diff --git a/policies/PROMOTION-POLICY.md b/policies/PROMOTION-POLICY.md
new file mode 100644
index 0000000..2b958dc
--- /dev/null
+++ b/policies/PROMOTION-POLICY.md
@@ -0,0 +1,24 @@
+# PROMOTION-POLICY
+
+## 目标
+- 将过程态信息提炼为长期稳定记忆。
+
+## 输入来源
+- `daily/`
+- `tasks/<task-id>/`
+- `agents/<agent-id>/`
+
+## promote 判定条件
+- 事实可复核，有来源证据。
+- 内容跨任务可复用。
+- 语义稳定，不依赖临时上下文。
+
+## promote 输出
+- `shared/long-term/projects/`
+- `shared/long-term/lessons/`
+- `shared/long-term/decisions/`
+
+## promote 提交要求
+- 说明来源：原始文件路径和时间。
+- 说明结论：提炼后的稳定事实。
+- 说明范围：适用项目/任务/角色。
diff --git a/policies/QUERY-POLICY.md b/policies/QUERY-POLICY.md
new file mode 100644
index 0000000..86611c7
--- /dev/null
+++ b/policies/QUERY-POLICY.md
@@ -0,0 +1,21 @@
+# QUERY-POLICY
+
+## 双通道模型
+- 写入：本地 Git。
+- 群体查询：远程 MCP/QMD（权威）。
+- 本地检索：仅草稿/fallback。
+
+## 远程查询工具
+- `memory.search`
+- `memory.get`
+- `memory.trace`
+- `memory.status`
+- `memory.list_lanes`
+
+## lane 规则
+- 支持 lane：`task`、`agent`、`shared-long-term`、`daily`。
+- 默认优先级：`task > agent > shared-long-term > daily`。
+
+## 禁止项
+- 禁止将任意机器本地索引当作群体真相。
+- 禁止把本地未 push 内容当作群体共享记忆。
diff --git a/shared/AGENTS.md b/shared/AGENTS.md
new file mode 100644
index 0000000..70b4203
--- /dev/null
+++ b/shared/AGENTS.md
@@ -0,0 +1,30 @@
+# AGENTS.md (shared)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/shared/`）。
+
+## 目录类型
+- 类型：`shared`。
+
+## 目录作用
+- 承载群体可共享记忆区域。
+- 长期真相目录在 `shared/long-term/`，并有更严格写入规则。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅作草稿/fallback，不得作为共享真相来源。
+
+## Git 规则
+- 先同步再编辑：`git fetch && git pull --rebase`。
+- 非 promote 场景不直接编辑 `shared/long-term/`。
+- 冲突优先保留证据链，再做受控整理。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 仅从 `daily/ tasks/ agents/` 经过提炼后进入 `shared/long-term/`。
diff --git a/shared/long-term/AGENTS.md b/shared/long-term/AGENTS.md
new file mode 100644
index 0000000..4ff117d
--- /dev/null
+++ b/shared/long-term/AGENTS.md
@@ -0,0 +1,31 @@
+# AGENTS.md (shared/long-term)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/shared/long-term/`）。
+
+## 目录类型
+- 类型：`long-term`。
+
+## 目录作用
+- 存放 durable facts、稳定项目知识、经验教训与已确认决策。
+
+## 查询规则
+- 该目录是群体长期记忆来源之一，但权威查询仍必须通过远程 MCP/QMD。
+- 本地读取结果只能作草稿或故障降级参考。
+
+## Git 规则
+- 修改前必须先同步：`git fetch --prune` + `git pull --rebase`。
+- 禁止并发大规模改动长期共享文件。
+- 仅允许 promote 提炼写入，不直接搬运未经验证原始记录。
+- 冲突不自动乱合并，必须人工/受控逻辑处理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅作草稿/fallback。
+
+## Promote 规则
+- 原始记录先在 `daily/ tasks/ agents/`。
+- 稳定事实再写入 `projects/ lessons/ decisions/`。
diff --git a/shared/long-term/decisions/.gitkeep b/shared/long-term/decisions/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/shared/long-term/lessons/.gitkeep b/shared/long-term/lessons/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/shared/long-term/projects/.gitkeep b/shared/long-term/projects/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tasks/AGENTS.md b/tasks/AGENTS.md
new file mode 100644
index 0000000..a8e78f6
--- /dev/null
+++ b/tasks/AGENTS.md
@@ -0,0 +1,29 @@
+# AGENTS.md (tasks)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/`）。
+
+## 目录类型
+- 类型：`shared-task-space`。
+
+## 目录作用
+- 承载任务级共享记忆目录：`tasks/<task-id>/`。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅草稿/fallback。
+
+## Git 规则
+- 先同步再写入。
+- task 目录优先 append-only 记录过程。
+- 长期结论必须 promote 到 `shared/long-term/`。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 任务结论沉淀到长期目录时必须附来源路径与提交信息。
diff --git a/tasks/task-001/AGENTS.md b/tasks/task-001/AGENTS.md
new file mode 100644
index 0000000..2f19708
--- /dev/null
+++ b/tasks/task-001/AGENTS.md
@@ -0,0 +1,31 @@
+# AGENTS.md (tasks/task-001)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/task-001/`）。
+
+## 目录类型
+- 类型：`task`。
+
+## 目录作用
+- 任务级共享工作记忆，记录任务上下文、过程与决策。
+- 与长期共享记忆区别：任务目录偏过程态，长期目录偏稳定态。
+
+## 查询规则
+- 群体查询必须走远程 MCP/QMD。
+- 本地检索仅用于草稿/fallback。
+
+## Git 规则
+- 先同步再修改：`git fetch` + `git pull --rebase`。
+- 优先 append 到 `RUNLOG.md` 和 `DECISIONS.md`。
+- 单次提交只做一类变更，不混入长期共享改动。
+- 冲突采用 append-only 合并思路，最终人工归档。
+
+## 可见性状态机
+- push 前：仅本地可见。
+- push 后未索引：已提交未群体可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 任务结论经验证后，提炼并 promote 到 `shared/long-term/`。
diff --git a/tasks/task-001/DECISIONS.md b/tasks/task-001/DECISIONS.md
new file mode 100644
index 0000000..8096d11
--- /dev/null
+++ b/tasks/task-001/DECISIONS.md
@@ -0,0 +1,3 @@
+# DECISIONS
+
+- 待补充。
diff --git a/tasks/task-001/LINKS.md b/tasks/task-001/LINKS.md
new file mode 100644
index 0000000..be337bc
--- /dev/null
+++ b/tasks/task-001/LINKS.md
@@ -0,0 +1,3 @@
+# LINKS
+
+- 相关文档与证据链接。
diff --git a/tasks/task-001/RUNLOG.md b/tasks/task-001/RUNLOG.md
new file mode 100644
index 0000000..0ba3f08
--- /dev/null
+++ b/tasks/task-001/RUNLOG.md
@@ -0,0 +1,3 @@
+# RUNLOG
+
+- 2026-03-08: 初始化任务记录。
diff --git a/tasks/task-001/TASK.md b/tasks/task-001/TASK.md
new file mode 100644
index 0000000..e78c289
--- /dev/null
+++ b/tasks/task-001/TASK.md
@@ -0,0 +1,7 @@
+# TASK-001
+
+## Goal
+- 示例任务目标。
+
+## Scope
+- 明确输入与输出边界。
diff --git a/tasks/task-002/AGENTS.md b/tasks/task-002/AGENTS.md
new file mode 100644
index 0000000..8ca0e26
--- /dev/null
+++ b/tasks/task-002/AGENTS.md
@@ -0,0 +1,29 @@
+# AGENTS.md (tasks/task-002)
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录（`memory-repo/tasks/task-002/`）。
+
+## 目录类型
+- 类型：`task`。
+
+## 目录作用
+- `task-002` 的共享任务记忆空间。
+
+## 查询规则
+- 群体查询仅通过远程 MCP/QMD。
+- 本地检索只用于草稿/fallback。
+
+## Git 规则
+- 修改前先同步远端。
+- 小步提交、避免跨目录乱改。
+- 冲突先保留原始记录后手工整理。
+
+## 可见性状态机
+- push 前：本地可见。
+- push 后未索引：群体不可见。
+- fetch + qmd update 后：群体可见。
+- 群体召回只认远程 MCP。
+- 本地结果仅草稿/fallback。
+
+## Promote 规则
+- 稳定结论 promote 到 `shared/long-term/`。
diff --git a/tasks/task-002/DECISIONS.md b/tasks/task-002/DECISIONS.md
new file mode 100644
index 0000000..8096d11
--- /dev/null
+++ b/tasks/task-002/DECISIONS.md
@@ -0,0 +1,3 @@
+# DECISIONS
+
+- 待补充。
diff --git a/tasks/task-002/LINKS.md b/tasks/task-002/LINKS.md
new file mode 100644
index 0000000..748d250
--- /dev/null
+++ b/tasks/task-002/LINKS.md
@@ -0,0 +1,3 @@
+# LINKS
+
+- 相关链接。
diff --git a/tasks/task-002/RUNLOG.md b/tasks/task-002/RUNLOG.md
new file mode 100644
index 0000000..00301ae
--- /dev/null
+++ b/tasks/task-002/RUNLOG.md
@@ -0,0 +1,3 @@
+# RUNLOG
+
+- 2026-03-09: 初始化任务记录。
diff --git a/tasks/task-002/TASK.md b/tasks/task-002/TASK.md
new file mode 100644
index 0000000..0006c2f
--- /dev/null
+++ b/tasks/task-002/TASK.md
@@ -0,0 +1,4 @@
+# TASK-002
+
+## Goal
+- 示例任务目标。
diff --git a/templates/AGENT-CARD.md.template b/templates/AGENT-CARD.md.template
new file mode 100644
index 0000000..1bad030
--- /dev/null
+++ b/templates/AGENT-CARD.md.template
@@ -0,0 +1,6 @@
+# AGENT-CARD: <agent-id>
+
+- agent_id: `<agent-id>`
+- writable_scope: `agents/<agent-id>/**`
+- query_authority: `remote MCP/QMD`
+- promote_target: `shared/long-term/**`
diff --git a/templates/AGENTS.md.template b/templates/AGENTS.md.template
new file mode 100644
index 0000000..f46042d
--- /dev/null
+++ b/templates/AGENTS.md.template
@@ -0,0 +1,31 @@
+# AGENTS.md
+
+## 工作根路径
+- 当前工作根路径 = 本文件所在目录。
+
+## 目录类型
+- `<root|shared|long-term|agent|task|daily>`
+
+## 目录作用
+- `<填写本目录负责的记忆范围>`
+
+## 查询规则
+- 群体共享记忆查询必须走远程 MCP/QMD。
+- 本地检索仅用于未 push 草稿、故障降级、本地调试。
+
+## Git 规则
+- 修改前：`git fetch --prune origin` + `git pull --rebase`。
+- 小步提交，一次提交只做一件事。
+- 避免跨目录乱改。
+- 冲突优先保留 append-only 原始记录，再人工整理长期事实。
+
+## 可见性状态机
+- push 前：本地仅自己可见。
+- push 后但未索引：已提交但群体未可见。
+- 远程 fetch + qmd update 后：群体可见。
+- 群体召回：只认远程 MCP。
+- 本地结果：只认作草稿/fallback。
+
+## Promote 规则
+- 原始观察 -> `daily/task/agent`
+- 稳定结论 -> `shared/long-term`
diff --git a/templates/MEMORY.md.template b/templates/MEMORY.md.template
new file mode 100644
index 0000000..a1fafde
--- /dev/null
+++ b/templates/MEMORY.md.template
@@ -0,0 +1,12 @@
+# MEMORY.md
+
+## System
+- 写入通道：本地 Git。
+- 查询通道：远程 MCP/QMD（权威）。
+- 本地检索：草稿/fallback。
+
+## Lanes
+- task > agent > shared-long-term > daily
+
+## Traceability
+- branch + commit_hash + synced_at + source_path + scope
diff --git a/templates/TASK.md.template b/templates/TASK.md.template
new file mode 100644
index 0000000..2bdc8e3
--- /dev/null
+++ b/templates/TASK.md.template
@@ -0,0 +1,10 @@
+# TASK: <task-id>
+
+## Goal
+- <任务目标>
+
+## Scope
+- <输入输出边界>
+
+## Done Criteria
+- <验收标准>