# 通用规范采纳记录

- 项目/负责人：Agent-Intent / weichen
- 状态：active
- 规范位置：`deps/development-guidelines`
- 规范性文档目录：`policy/`（项目规则与制度放此处）
- 过程文档位置：任务卡在 `.task/`（模板 `.task/templates/task-card.md`，本次任务卡 `.task/feature-governance-adoption.md`）；任务主记录在 PR 描述与 Gitea Issue/PR。既有项目内豁免目录 `docs/records/` 保持不变（理由见 PROJECT.md「仓库与操作」节与下方「项目差异」）。
- 版本权威：本仓 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） | enforced：CI `scripts/agent-exec validate --repo .` 与 `scripts/dm governance check --repo .`；证据：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/` 为规范性文档；过程记录按既有豁免放 `docs/records/` | manual；见下方「项目差异」 |
| standards/tool-adaptation.md | 新工具/执行器适配 | 不适用：本次不新增工具适配卡；执行器 profile 由 AGENT-EXECUTION.md 登记 | 不适用 |
| standards/data-reliability.md | 本仓自有数据库 | 不适用：无数据库；快照替换的原子性由并发测试覆盖 | 不适用 |
| standards/release-operations.md | 独立发布流水线 | 不适用：当前无制品仓库与部署入口；可构建性以 `main` 的 `go test` 为准 | 不适用 |
| workflows/automation.md | 定时与后台任务 | 不适用：本仓无 daemon | 不适用 |

## 项目差异

| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| documentation.md 过程仓默认独立仓库 | 过程记录放 `docs/records/`；任务卡放 `.task/` | 个人基础库；风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 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 由用户设置，回退时同步撤销。