repo-dev-workflow-constraints

Flow2Spec 项目开发纪律（Dev Workflow Constraints）

仅适用于 Flow2Spec 本仓自身开发，不下发给普通业务仓。

三端同源手写镜像：

• Claude：.claude/rules/repo-dev-workflow-constraints.md
• Cursor：.cursor/rules/repo-dev-workflow-constraints.mdc
• Codex：.codex/topics/repo-dev-workflow-constraints.md
• 路由摘要：.Knowledge/topics/f2s-dev-workflow-constraints.md

所有权边界

位置	角色	写入方式
packages/core/templates/{zh-CN,en-US}/	下游 Rule、Skill、Hook、知识模板的唯一真源；随 Core tarball 发布	人或 Agent 直接维护并提交 Git
.claude/ / .cursor/ / .codex/ / 根 AGENTS.md	本仓消费模板后的配置根产物	用户明确要求后由 flow2spec init / npm run sync:agents 分发
.Knowledge/	本仓共享知识库	按 topic/skill 写权直接维护
本仓专属 repo-* Rule/Skill	只服务本仓，不进入 Core templates	三端配置根手写镜像

根 templates/ 与根 lib/ 均不再存在：模板和核心实现分别由 packages/core/templates/、packages/core/lib/ 单独持有。packages/core/templates/ 受 Git 管理，不依赖复制脚本、.gitignore 例外或 prepack 同步。

硬约束

1. 下游会使用的 Rule、Skill、Hook、AGENTS、配置与知识模板，只改 packages/core/templates/zh-CN/ 和 packages/core/templates/en-US/；双语版本保持语义一致。
2. 不直接编辑配置根中由 Core templates 派生的文件。它们会在后续 init 中被覆盖。
3. 本规则、repo-dev-check 等本仓专属内容不进 Core templates，直接同步三端手写镜像与本仓知识库。
4. Agent 不主动执行 flow2spec init / npm run sync:agents；只有用户明确要求分发时才执行。
5. 根 lib/ 不作为兼容入口。CLI 通过 createFlow2Spec() 等 Core 公共 API 工作；Core 内部测试可按需引用 packages/core/lib/。

修改判断

• 通用能力：改 packages/core/templates/{locale}/...，必要时同步 Core 实现与公开文档。
• 本仓知识：改 .Knowledge/topics/、matcher、manifest/index；触达 topic 时先读 f2s-topic-authoring。
• 本仓专属纪律：改三端 repo-dev-workflow-constraints 镜像，不写入 Core templates。
• 配置根派生产物：不手改，也不为预览主动执行 init。

版本模型

CLI Version       packages/cli/package.json
Core Version      packages/core/package.json
Template Version  packages/core/package.json.templateVersion
Protocol Version  packages/core/capabilities.json.protocolVersion

• CLI 对 Core 使用运行时 caret 兼容范围（如 ^3.8.2）；已安装依赖通过显式更新刷新，不会静默变化。
• Core 在 CLI 兼容范围内的更新可独立发布，version:set:core 保留 CLI 版本和依赖范围；不兼容时在写盘前报错。
• Rule、Skill、Hook、知识模板变化时升 Core，并显式执行 version:set:template；兼容变更无需为此升 CLI。
• CLI 开始调用新版 Core API 时，升 CLI 并通过 version:set:cli --core-range ^x.y.z 调整兼容下限；不兼容升级须显式评估。
• Protocol Version 只在公共协议不兼容时调整。
• 根 private workspace version 不参与 npm 发布匹配。