# AGENTS.md - PrivateVoice-MAS 源码区规则

本目录是 PrivateVoice-MAS 当前 `mas` 分支的源码根目录。

## 必读

涉及源码、测试、构建、模块边界或非平凡实现时，先读：

1. `/Users/ar/Projects/PrivateVoice-MAS/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice-MAS/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice-MAS/03-O/README.md`
4. `/Users/ar/Projects/PrivateVoice-MAS/03-O/C1.source/CODEGRAPH.md`
5. 当前 Round 的产品定义、技术方案和验收文档
6. 涉及 UI 时读 `/Users/ar/Projects/PrivateVoice-MAS/DESIGN.md`

## 代码规则

- 只实现当前任务直接需要的代码。
- 复用系统能力和现有模块，不为一次性需求创建抽象层。
- 不把输入资料中的功能直接当成已确认需求。
- Git 命令默认在 `/Users/ar/Projects/PrivateVoice-MAS/03-O` 执行，而不是本目录。
- 新增或移动源码后，同步更新本目录 `CODEGRAPH.md`。
- 构建、测试、QA 脚本优先放到 `../C3.tools/`，除非工程工具链要求必须随源码放置。
- 自动图谱结果只能辅助定位，不能替代对真实源码、测试和 QA 证据的回读。