# AGENTS.md

## Working Rules

- 先阅读 `README.md`，确认架构和 API 约定后再修改代码。
- 修改 `memory-gateway`、`git` 同步逻辑或 `docker-compose.yml` 后，先运行测试再提交结果。
- 不要破坏现有 `qmd` 容器能力（HTTP MCP、健康检查、模型配置与持久化）。
- 优先保证功能正确性和可恢复性，不为了“优雅”牺牲可追溯和可运维性。
- 每次查询返回必须可追溯到 `branch + commit_hash + synced_at`。
- 禁止实现“单目录频繁 checkout 不同 branch”的方案；必须使用分支隔离 workspace。
- 任何查询一致性逻辑必须遵循：`sync git -> qmd update/embed -> query`。