collective-memory-repo/AGENTS.md

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