Agent-Native/policy/guidelines-adoption.md

通用规范采纳记录

• 项目/负责人：Agent-Native / 仓库所有者 weichen
• 状态：active
• 规范位置：deps/development-guidelines
• 规范性文档目录：policy/
• 过程文档位置：docs/records/（项目内固定目录豁免。当前为个人维护的基础库，单独过程仓会让每份记录都变成跨仓 gitlink；任务主记录仍在 Gitea Issue/PR。豁免一经登记，过程记录不得再写入 policy/ 或规范库。）
• 版本权威：父仓 gitlink；可读标签：无（内容版本 0.1.0-draft.6，提交 26b562d2e34fbc560711296a309c91c74ffc55b1）
• 批准/生效依据：本仓接入提交；草案审阅完成后随该提交生效
• 替代范围和迁移说明：本仓此前没有根 AGENTS.md。接入后以本文件与根入口为准，不在规范库内保存项目事实。

规范/工作流	适用条件与范围	采纳或不适用理由	执行方式/证据
core/baseline.md	日常工作	所有改动都要守硬边界	manual
workflows/delivery.md、debugging.md、handoff.md	交付、排障与交接	单人维护仍需要可交接的任务记录	manual
standards/collaboration.md	并行共同起点、节点同步与陈旧候选拒绝	本仓会被 Agent-Squad 以 gitlink 消费	manual
standards/verification.md	验证与结论	仓库根 go vet / go test	manual；命令见 PROJECT.md
workflows/design-verification.md、standards/testability.md、standards/failure-containment.md	契约、适配器与故障分类	执行器失败必须可定位且不扩大工具范围	manual
standards/module-contracts.md	contract/exec/runtime/adapters 边界	公开端口已按层拆分	manual
standards/observability.md	错误码、过程事件	与 Error-Code-System / Logging-System 对齐	manual
standards/agent-execution.md	能力协商与后端回退	本仓就是执行契约的权威	manual
standards/multi-repo.md	submodule 与固定组合	规范与基础库以 gitlink 锁定	manual
standards/security.md	路径授权、工具范围、凭证	凭证不入库；路径授权不等于 OS 沙箱	manual
standards/documentation.md	三层文档	policy/ 与 docs/records/ 已分开	manual
standards/data-reliability.md	执行副作用与重放	无本仓数据库；适用副作用分类，不扩展成存储设计	manual
standards/configuration.md	调用方注入的模型与工具配置	本仓不自带多实例部署配置	manual
standards/release-operations.md	独立发布流水线	当前无制品仓库与部署入口	不适用
workflows/automation.md	定时与后台任务	本仓无 daemon	不适用

项目差异

原规则/章节	项目采用方式	原因与风险	负责人/复查条件
documentation.md 过程仓默认独立仓库	过程记录放 docs/records/	个人基础库；风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 Gitea Issue/PR	出现第二名维护者或对外发布流程时复查

默认做法差异说明理由；硬边界冲突须有明确有效决策，不能用此表自授权。建议不采用无需登记。

本次升级或首次接入验证

• 入口：根 AGENTS.md、PROJECT.md 指向 deps/development-guidelines。
• 子模块：deps/development-guidelines 固定 26b562d2e34fbc560711296a309c91c74ffc55b1。
• .gitmodules 使用批准的上游 SSH URL，不含本机路径或凭证。
• 执行方式保持 manual：挂载 Markdown 不自动改变 CI。
• 回退：恢复本提交之前的 gitlink，并删除根入口与 policy/guidelines-adoption.md 中对应条款；无已生效的 CI 或权限变更需要另恢复。

2026-09-29 追加：agent-intent 可选意图闸门

• 新增 deps/agent-intent（固定 55780ae2cce4ae98d8b0557b8234af8833a7c522），deps/error-code-system 前进到 dbeed2f1b67eb417ce089e7033a228578fbbeb03（追加 squad.intent_refused，兼容性变更无）。
• 依赖边界新增：唯 adapters/intentgate 可 import agent-intent；不使用该包时核心与 agent-intent 无编译关系。
• 接入与验证记录见 docs/records/2026-09-29-intentgate-adoption.md。
• 回退：删除 adapters/intentgate/、go.mod 的 agent-intent require/replace、.gitmodules 对应条目与 submodule，scripts/submodule-consistency.sh 移除该路径。