qmd-memory-gateway/AGENTS.md

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。