# 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`