本文件只负责索引,不保存版本快照、测试结果或架构正文。
- 所有任务先读安全规则和Git / worktree 规则。
- 再按任务读取
.agents/rules/下零或一项最接近的领域规则;没有匹配项时不强行套用。涉及文档创建、修改、引用或删除时读文档治理规则。 - 涉及版本、分支、worktree、验证状态或已知问题时,先实时复核,再参考
.agents/context/的日期化快照。 - 架构、运维、功能合同、历史证据和外部参考从文档总入口进入。
默认首轮只加载解决任务所需的一个索引和最多两份相关正文或 Context;需要更多证据时沿链接逐级展开,不预读全部 context、audit 或 evidence。正式独立审查额外读取 reviewing.md overlay,但不增加领域规则、索引、正文或 Context 的预算。
目标 artifact / runtime > tag 与公开 release > 当前源码和测试 > .agents/context/ > docs/ > memory / handoff。
.agents/rules/ 是 Agent 的稳定行为规则;.agents/context/ 只是可更新的当前状态索引;临时交接不得替代两者。
- 未提交内容按用户数据保护;只读任务只允许检查和报告。
- commit、push、tag、release、替换已安装 App或运行真实 provider 测试均需明确授权。
- 真实 API Key、OAuth token、Keychain、SSH 私钥和账号数据库始终不得读取或回显;真实 provider 测试只能消费用户显式提供给隔离进程的输入,授权测试不等于授权检查凭证内容。
- 临时 handoff 放入
.agents/handoffs/,长期事实应进入 rules、context 或 docs。