Agent-Intent/policy/guidelines-adoption.md

通用规范采纳记录

• 项目/负责人：Agent-Intent / weichen
• 状态：active
• 规范位置：deps/development-guidelines
• 规范性文档目录：policy/（项目规则与制度放此处）
• 过程文档位置：.task/ 存放任务卡与交付证据（模板 .task/templates/task-card.md，本次任务卡 .task/feature-governance-adoption.md）；docs/records/ 存放其他过程记录，为既有项目内豁免目录，保持不变（理由见 PROJECT.md「仓库与操作」节与下方「项目差异」）；任务主记录在 PR 描述与 Gitea Issue/PR。
• 版本权威：本仓 gitlink deps/development-guidelines @ 2688fd2be6a5（内容版本 0.1.0-draft.12；可读标签：无）
• 批准/生效依据：feature/governance-adoption PR（Agent-Intent）
• 替代范围和迁移说明：本次替代此前的 Guidelines gitlink 26b562d2e34f（内容版本 0.1.0-draft.6），固定为 2688fd2be6a5。新增 AGENT-EXECUTION.md 执行路由、deps/development-manager 治理 gitlink（@ bd3a7de57a3a）、scripts/dm、scripts/agent-exec、scripts/task、scripts/hooks/pre-commit、.gitea/workflows/governance.yml。本仓无既往 Agent 执行路由需迁移。

规范/工作流	适用条件与范围	采纳或不适用理由	执行方式/证据
core/baseline.md	日常工作	所有改动守硬边界；集成分支不直接提交，经 feature 分支与 PR 合入	manual；scripts/hooks/pre-commit 本地拒绝直提 main 与非法分支名（需 core.hooksPath 启用，由人执行）；未验证（尚无直提与非法分支名的负例记录）
workflows/delivery.md、debugging.md、handoff.md	交付、排障与交接	单人维护仍需要可交接的任务记录	manual；任务卡 .task/，主记录在 PR
standards/collaboration.md	并行共同起点、节点同步与陈旧候选拒绝	本仓被 Agent-Squad / Agent-Native 以 gitlink 消费，需固定共同基线	manual；合入前在 main 上 git fetch 并确认 HEAD
standards/merge-queue.md	多个就绪任务的最终同步、CI、Review 与合入调度	不适用：当前为单维护者，无多任务同时合入的调度需求；出现并行合入时复查	不适用
standards/agent-execution.md	工程 Agent CLI 执行路由、会话隔离与受控集成	凡 AI 协助实施均经执行路由：配置 AGENT-EXECUTION.md，执行器入口 scripts/agent-exec（validate / run / apply / admit / cleanup）	advisory（CI 运行 scripts/agent-exec validate 与 scripts/dm governance check，分支保护尚未设为必需检查；设为必需检查并有阻断负例后再登记 enforced）；证据：governance check + 正负例（.task/feature-governance-adoption.md）
standards/verification.md	验证与结论	仓库根 go vet / go test（含 -race）为正式验证	命令见 PROJECT.md「验证命令」；CI .gitea/workflows/ci.yml
workflows/design-verification.md、standards/testability.md、standards/failure-containment.md	识别漏斗、配置合并与快照切换的设计/验证、模块测试与故障控制	识别必须可脱离外部 I/O 独立验证；配置失败保留上一快照	manual；快照并发测试（-race）
standards/module-contracts.md	intent / conformance / catalogcheck / examples 的边界与公开契约	公开端口按层拆分；扩展点只留接口	manual
standards/observability.md	错误码、识别事件日志	与 Error-Code-System / Logging-System 对齐	manual；catalogcheck 测试
standards/configuration.md	spec/overlay 双源合并、快照 revision、生效时机与诊断	本仓核心即配置驱动模块；诊断由 intentctl 承担	manual；intentctl lint / explain
standards/multi-repo.md	submodule 与固定组合	规范、执行器与基础库均以 gitlink 锁定；不执行 submodule update --remote	manual；scripts/submodule-consistency.sh；scripts/dm governance check
standards/security.md	凭证、配置信任边界	配置文件属宿主可信输入；本仓不保存凭证	manual
standards/documentation.md	三层文档（入口、规范性文档、过程记录）	policy/ 为规范性文档；任务卡与交付证据放 .task/，其他过程记录按既有豁免放 docs/records/	manual；见下方「项目差异」
standards/tool-adaptation.md	新工具/执行器适配	适用：仓库配置 Agent CLI profile（AGENT-EXECUTION.md）、pre-commit 钩子与 Gitea CI 任务，逐项登记见下方「工具适配矩阵」	适用，见下方矩阵
standards/data-reliability.md	本仓自有数据库	不适用：无数据库；快照替换的原子性由并发测试覆盖	不适用
standards/release-operations.md	独立发布流水线	不适用：当前无制品仓库与部署入口；可构建性以 main 的 go test 为准	不适用
workflows/automation.md	定时与后台任务	不适用：本仓无 daemon	不适用

工具适配矩阵（standards/tool-adaptation.md）

要求	级别	机制	正例证据	负例证据
(a) 本地 pre-commit 准入 scripts/agent-exec admit	advisory（本地钩子，需 core.hooksPath 启用，同 OS 用户可绕过，不是门禁）	scripts/hooks/pre-commit 调用 scripts/agent-exec admit	SELF：adoption cases 的 positive-run-apply 通过（.task/evidence/governance-adoption/02-20261017T073820Z.log）	SELF：bad-receipt、out-of-scope-path 被拒绝（同上日志；记录见 .task/feature-governance-adoption.md）
(b) governance CI（.gitea/workflows/governance.yml：agent-exec validate 与 dm governance check）	advisory（分支保护设为必需检查前不阻断合并）	Gitea Actions job governance，在 PR 与 main 推送时运行	PR 头 SHA 上的 governance CI 运行结果（尚未登记）	未验证

项目差异

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

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

本次升级或首次接入验证

• 入口：根 AGENTS.md 与 PROJECT.md 指向 deps/development-guidelines；AGENTS.md 新增「Agent 执行与新项目准入（强制）」段落，AGENT-EXECUTION.md 为执行路由唯一权威。
• 子模块：deps/development-guidelines 固定 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb；deps/development-manager 固定 bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c；deps/error-code-system 与 deps/logging-system 不变。
• 门禁：.gitea/workflows/governance.yml 在 PR 与 main 推送时运行 scripts/agent-exec validate --repo . 与 scripts/dm governance check --repo .；实际正负例与 Review/CI 证据记录在 .task/feature-governance-adoption.md。
• 回退：恢复 deps/development-guidelines gitlink 为 26b562d2e34f，删除 AGENTS.md 新增段落、deps/development-manager 条目、scripts/dm、scripts/agent-exec、scripts/task、scripts/hooks/pre-commit、.gitea/workflows/governance.yml 与 .task/templates/task-card.md，并将本文件状态改回 proposed。分支保护与规范 tag 由用户设置，回退时同步撤销。