Files
Agent-Intent/policy/guidelines-adoption.md
T
weichen b450b03638 Initialize the repository with pinned submodules, project entry documents, and the design record
Details (original message):
Initialize the repository with pinned submodules, project entry documents, and the design record.
2026-09-29 15:20:38 +00:00

4.1 KiB
Raw Blame History

通用规范采纳记录

  • 项目/负责人:Agent-Intent / 仓库所有者 weichen
  • 状态:active
  • 规范位置:deps/development-guidelines
  • 规范性文档目录:policy/
  • 过程文档位置:docs/records/(项目内固定目录豁免。当前为个人维护的基础库,单独过程仓会让每份记录都变成跨仓 gitlink;任务主记录仍在 Gitea Issue/PR。豁免一经登记,过程记录不得再写入 policy/ 或规范库。)
  • 版本权威:父仓 gitlink;可读标签:无(内容版本 0.1.0-draft.6,提交 26b562d2e34fbc560711296a309c91c74ffc55b1)
  • 批准/生效依据:本仓接入提交;草案审阅完成后随该提交生效
  • 替代范围和迁移说明:本仓为新建仓库,无既往规则需要迁移。
规范/工作流 适用条件与范围 采纳或不适用理由 执行方式/证据
core/baseline.md 日常工作 所有改动都要守硬边界 manual
workflows/delivery.md、debugging.md、handoff.md 交付、排障与交接 单人维护仍需要可交接的任务记录 manual
standards/collaboration.md 并行共同起点、节点同步与陈旧候选拒绝 本仓会被 Agent-Squad / Agent-Native 以 gitlink 消费 manual
standards/verification.md 验证与结论 仓库根 go vet / go test(含 -race) manual;命令见 PROJECT.md
workflows/design-verification.md、standards/testability.md、standards/failure-containment.md 识别漏斗、配置合并与快照切换 识别必须可脱离外部 I/O 独立验证;配置失败保留上一快照 manual
standards/module-contracts.md intent/conformance/catalogcheck/examples 边界 公开端口按层拆分;扩展点只留接口 manual
standards/observability.md 错误码、识别事件日志 与 Error-Code-System / Logging-System 对齐 manual
standards/configuration.md spec/overlay 双源合并、快照 revision、生效时机与诊断 本仓核心就是配置驱动模块;check/explain 由 intentctl 承担 manual
standards/multi-repo.md submodule 与固定组合 规范与基础库以 gitlink 锁定 manual
standards/security.md 凭证、配置信任边界 配置文件属宿主可信输入;本仓不含凭证 manual
standards/documentation.md 三层文档 policy/ 与 docs/records/ 已分开 manual
standards/data-reliability.md 本仓自有数据库 无数据库;快照替换的原子性由并发测试覆盖 不适用
standards/agent-execution.md Agent 执行契约 本仓不做执行,只做 LLM 前的确定性识别 不适用
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;deps/error-code-system 固定 28fa06eaa56a19906732681cc02474a87ac9d408(含 intent 种子域);deps/logging-system 固定 2c5716fdcffbc4696fc0371afc70f39c44174201。三者与 Agent-Squad / Agent-Native 当前组合一致(error-code-system 为新增 intent 域后的新提交,属追加式变更)。
  • .gitmodules 使用批准的上游 SSH URL,不含本机路径或凭证。
  • 执行方式保持 manual:挂载 Markdown 不自动改变 CI。
  • 回退:恢复本提交之前的 gitlink,并删除根入口与 policy/guidelines-adoption.md 中对应条款;无已生效的 CI 或权限变更需要另恢复。