@openprd/cli 0.1.0

package/.openprd/state/versions/v0001.json

@@ -0,0 +1,121 @@
+{
+  "versionNumber": 1,
+  "versionId": "v0001",
+  "createdAt": "2026-05-24 01:56:48",
+  "projectRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd",
+  "workspaceRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd",
+  "schema": "prd-core",
+  "templatePack": "agent",
+  "productType": "agent",
+  "title": "Verify 边界与历史项目刷新",
+  "owner": "Codex",
+  "status": "synthesized",
+  "sections": {
+    "meta": {
+      "title": "Verify 边界与历史项目刷新",
+      "owner": "Codex",
+      "status": "classified",
+      "version": "v0001",
+      "productType": "agent",
+      "date": "2026-05-24"
+    },
+    "problem": {
+      "problemStatement": "修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项目生成物。",
+      "whyNow": "历史项目的 verify 正在被参考目录噪音阻塞，需要尽快恢复 run/verify 的可信度。",
+      "evidence": []
+    },
+    "users": {
+      "primaryUsers": [
+        "维护 OpenPrd 的 Agent 工程师",
+        "使用 OpenPrd 管理历史项目的项目维护者"
+      ],
+      "secondaryUsers": [],
+      "stakeholders": []
+    },
+    "goals": {
+      "goals": [
+        "让主验证只关注当前项目源码和当前实现门禁",
+        "让历史项目刷新后默认获得更干净的 verify 体验"
+      ],
+      "successMetrics": [
+        "存在 reference discovery 时 openprd run . --context 不再默认展示它",
+        "仓库内常见外部参考目录在未人工归类前不再直接把 standards verify 阻塞成大面积说明书噪音",
+        "openprd fleet 更新后历史项目生成物包含这次修复"
+      ],
+      "acceptanceGoals": [
+        "run/verify 的默认结果不再把 reference discovery 或明显外部参考目录当成主门禁噪音",
+        "历史项目刷新后生成物能承接这次边界修复",
+        "对需要人工确认的 external reference 仍保留显式 classify-external 路径"
+      ]
+    },
+    "scope": {
+      "inScope": [
+        "调整 run context 与 run verify 对 discovery 的纳入规则",
+        "调整 standards/source-manual 默认对明显外部参考目录的处理策略",
+        "为历史项目执行 openprd fleet 更新与必要回填"
+      ],
+      "outOfScope": [
+        "不自动替每个历史项目猜测所有业务目录的 externalReferences 清单",
+        "不修改历史项目的业务代码或需求内容",
+        "不把人工确认 external reference 的能力删除"
+      ]
+    },
+    "scenarios": {
+      "primaryFlows": [
+        "维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项目主验证状态；仓库中存在 research、toolkit-sources、marketplace-candidates 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式 classify-external。"
+      ],
+      "edgeCases": [],
+      "failureModes": [
+        "reference discovery 仍然混入 run context 或 run verify",
+        "standards verify 继续被 research 或 toolkit-sources 之类参考目录的说明书缺口淹没",
+        "fleet 更新后历史项目仍保留旧的 verify 噪音行为"
+      ]
+    },
+    "requirements": {
+      "functional": [],
+      "nonFunctional": [],
+      "businessRules": []
+    },
+    "businessGuardrails": {
+      "costDrivers": [],
+      "usageLimits": [],
+      "abusePrevention": [],
+      "monitoringSignals": [],
+      "alertThresholds": [],
+      "stopLossActions": []
+    },
+    "constraints": {
+      "technical": [],
+      "compliance": [],
+      "dependencies": []
+    },
+    "risks": {
+      "assumptions": [],
+      "risks": [],
+      "openQuestions": [
+        "本次只收敛默认边界，不自动猜测每个历史项目全部 external reference 清单；如果某些项目还需要更细的目录级归类，仍由维护者显式确认和补充"
+      ]
+    },
+    "handoff": {
+      "owner": "Codex",
+      "nextStep": "评审已生成的 PRD，并准备交接。",
+      "targetSystem": "OpenSpec"
+    },
+    "typeSpecific": {
+      "kind": "agent",
+      "title": "Agent 专项",
+      "fields": {
+        "humanAgentContract": "Agent 可以识别并提示 reference discovery 与外部参考目录边界，但把目录正式归类为 external reference 仍需要人确认；批量刷新历史项目可以自动执行。",
+        "autonomyBoundary": "Agent 可以修改 OpenPrd CLI、补测试、更新文档、运行 fleet dry-run 与 update-openprd/backfill-work-units，并验证结果；不得静默把任意历史目录永久归类为 external reference。",
+        "toolBoundary": "使用本地代码检索、OpenPrd CLI、自带测试、fleet 更新、doctor 与 verify 完成实现和验证；本次不需要外部第三方文档调研。",
+        "stateModel": "需要保留三类状态：当前项目源码验证状态、reference discovery 状态、standards external reference 显式配置；主 run/verify 只默认消费第一类，其他两类按边界显式暴露。",
+        "evalPlan": "通过针对 run-harness、standards 和 fleet 的单测与集成验证评估；再用历史项目 dry-run 与 update-openprd/backfill-work-units 验证刷新结果。"
+      }
+    }
+  },
+  "reviewPresentation": null,
+  "workUnitId": "wu-20260524015648-6d33ded7",
+  "targetRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd",
+  "content": "# Verify 边界与历史项目刷新\n> 语言规则：除 PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、产品名和协议名等必要专有名词外，用户可见内容应使用简体中文。\n- 版本: v0001\n- 负责人: Codex\n- 产品类型: agent\n- 模板包: agent\n- 状态: synthesized\n- 生成时间: 2026-05-24 01:56:48\n## 元信息\n\n- 标题: Verify 边界与历史项目刷新\n- 负责人: Codex\n- 状态: classified\n- 版本: v0001\n- 产品类型: agent\n- 日期: 2026-05-24\n\n## 问题\n\n- 问题陈述: 修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项目生成物。\n- 为什么是现在: 历史项目的 verify 正在被参考目录噪音阻塞，需要尽快恢复 run/verify 的可信度。\n- 证据:\n  - 待补充\n\n## 用户与相关方\n\n- 主要用户:\n  - 维护 OpenPrd 的 Agent 工程师\n  - 使用 OpenPrd 管理历史项目的项目维护者\n- 次要用户:\n  - 待补充\n- 相关方:\n  - 待补充\n\n## 目标与成功标准\n\n- 目标:\n  - 让主验证只关注当前项目源码和当前实现门禁\n  - 让历史项目刷新后默认获得更干净的 verify 体验\n- 成功指标:\n  - 存在 reference discovery 时 openprd run . --context 不再默认展示它\n  - 仓库内常见外部参考目录在未人工归类前不再直接把 standards verify 阻塞成大面积说明书噪音\n  - openprd fleet 更新后历史项目生成物包含这次修复\n- 验收目标:\n  - run/verify 的默认结果不再把 reference discovery 或明显外部参考目录当成主门禁噪音\n  - 历史项目刷新后生成物能承接这次边界修复\n  - 对需要人工确认的 external reference 仍保留显式 classify-external 路径\n\n## 范围与非目标\n\n- 范围内:\n  - 调整 run context 与 run verify 对 discovery 的纳入规则\n  - 调整 standards/source-manual 默认对明显外部参考目录的处理策略\n  - 为历史项目执行 openprd fleet 更新与必要回填\n- 范围外:\n  - 不自动替每个历史项目猜测所有业务目录的 externalReferences 清单\n  - 不修改历史项目的业务代码或需求内容\n  - 不把人工确认 external reference 的能力删除\n\n## 场景与流程\n\n- 主流程:\n  - 维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项目主验证状态；仓库中存在 research、toolkit-sources、marketplace-candidates 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式 classify-external。\n- 边界情况:\n  - 待补充\n- 失败模式:\n  - reference discovery 仍然混入 run context 或 run verify\n  - standards verify 继续被 research 或 toolkit-sources 之类参考目录的说明书缺口淹没\n  - fleet 更新后历史项目仍保留旧的 verify 噪音行为\n\n## 可视化图表\n\n### 产品流程\n\n```mermaid\nflowchart LR\n  entry[\"入口触发<br/>维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项…\"]\n  experience[\"产品内步骤<br/>修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项…\"]\n  decision{\"决策点<br/>边界情况仍需澄清\"}\n  success([\"成功结果<br/>存在 reference discovery 时 openprd run . --context 不再默认展示它\"])\n  failure[[\"失败与恢复<br/>reference discovery 仍然混入 run context 或 run verify\"]]\n  entry -->|\"维护者运行 openprd run . --context 或 openprd r…\"| experience\n  experience -->|\"系统处理请求\"| decision\n  decision -->|\"让主验证只关注当前项目源码和当前实现门禁\"| success\n  decision -.->|\"reference discovery 仍然混入 run context 或 ru…\"| failure\n```\n\n### 架构\n\n```mermaid\nflowchart LR\n  users[\"主要用户<br/>维护 OpenPrd 的 Agent 工程师 · 使用 OpenPrd 管理历史项目的项目维护者\"]\n  subgraph solution[\"方案边界\"]\n    experience[\"Agent 运行层<br/>维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项…\"]\n    core[\"核心产品逻辑<br/>修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项…\"]\n    integrations[\"依赖与集成<br/>暂无外部依赖记录\"]\n    governance[[\"约束与可靠性<br/>暂无明确约束\"]]\n    delivery[\"验证与交接<br/>存在 reference discovery 时 openprd run . --context 不再默认展示它 · 仓库内常…\"]\n  end\n  users -->|\"维护者运行 openprd run . --context 或 openprd…\"| experience\n  experience -->|\"产品动作与编排\"| core\n  core -->|\"依赖与外部服务\"| integrations\n  core -.->|\"策略、可靠性与合规\"| governance\n  core -->|\"成功标准与交接\"| delivery\n  integrations -->|\"运营就绪\"| delivery\n  governance -.->|\"评审与确认\"| delivery\n```\n\n## 需求\n\n- 功能需求:\n  - 待补充\n- 非功能需求:\n  - 待补充\n- 业务规则:\n  - 待补充\n\n## 业务护栏\n\n- 成本来源:\n  - 待补充\n- 额度与限制:\n  - 待补充\n- 滥用防护:\n  - 待补充\n- 监控信号:\n  - 待补充\n- 报警阈值:\n  - 待补充\n- 止损动作:\n  - 待补充\n\n## 约束、依赖与风险\n\n- 技术约束:\n  - 待补充\n- 合规要求:\n  - 待补充\n- 依赖:\n  - 待补充\n- 假设:\n  - 待补充\n- 风险:\n  - 待补充\n- 开放问题:\n  - 本次只收敛默认边界，不自动猜测每个历史项目全部 external reference 清单；如果某些项目还需要更细的目录级归类，仍由维护者显式确认和补充\n\n## 类型专项模块\n\n- 类型: Agent 专项\n- humanAgentContract: Agent 可以识别并提示 reference discovery 与外部参考目录边界，但把目录正式归类为 external reference 仍需要人确认；批量刷新历史项目可以自动执行。\n- autonomyBoundary: Agent 可以修改 OpenPrd CLI、补测试、更新文档、运行 fleet dry-run 与 update-openprd/backfill-work-units，并验证结果；不得静默把任意历史目录永久归类为 external reference。\n- toolBoundary: 使用本地代码检索、OpenPrd CLI、自带测试、fleet 更新、doctor 与 verify 完成实现和验证；本次不需要外部第三方文档调研。\n- stateModel: 需要保留三类状态：当前项目源码验证状态、reference discovery 状态、standards external reference 显式配置；主 run/verify 只默认消费第一类，其他两类按边界显式暴露。\n- evalPlan: 通过针对 run-harness、standards 和 fleet 的单测与集成验证评估；再用历史项目 dry-run 与 update-openprd/backfill-work-units 验证刷新结果。\n\n## 交接\n\n- 负责人: Codex\n- 下一步: 评审已生成的 PRD，并准备交接。\n- 目标系统: OpenSpec\n",
+  "digest": "dc988d7a94c07d2a8070968a71ddacffb374eaeee12aa85eb93231e06dd7b077"
+}

package/.openprd/state/versions/v0001.md

@@ -0,0 +1,161 @@
+# Verify 边界与历史项目刷新
+> 语言规则：除 PRD、OpenPrd、OpenSpec、API、SDK、CLI、TypeScript、JSON、HTTP、WebSocket、字段 key、命令名、产品名和协议名等必要专有名词外，用户可见内容应使用简体中文。
+- 版本: v0001
+- 负责人: Codex
+- 产品类型: agent
+- 模板包: agent
+- 状态: synthesized
+- 生成时间: 2026-05-24 01:56:48
+## 元信息
+
+- 标题: Verify 边界与历史项目刷新
+- 负责人: Codex
+- 状态: classified
+- 版本: v0001
+- 产品类型: agent
+- 日期: 2026-05-24
+
+## 问题
+
+- 问题陈述: 修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项目生成物。
+- 为什么是现在: 历史项目的 verify 正在被参考目录噪音阻塞，需要尽快恢复 run/verify 的可信度。
+- 证据:
+  - 待补充
+
+## 用户与相关方
+
+- 主要用户:
+  - 维护 OpenPrd 的 Agent 工程师
+  - 使用 OpenPrd 管理历史项目的项目维护者
+- 次要用户:
+  - 待补充
+- 相关方:
+  - 待补充
+
+## 目标与成功标准
+
+- 目标:
+  - 让主验证只关注当前项目源码和当前实现门禁
+  - 让历史项目刷新后默认获得更干净的 verify 体验
+- 成功指标:
+  - 存在 reference discovery 时 openprd run . --context 不再默认展示它
+  - 仓库内常见外部参考目录在未人工归类前不再直接把 standards verify 阻塞成大面积说明书噪音
+  - openprd fleet 更新后历史项目生成物包含这次修复
+- 验收目标:
+  - run/verify 的默认结果不再把 reference discovery 或明显外部参考目录当成主门禁噪音
+  - 历史项目刷新后生成物能承接这次边界修复
+  - 对需要人工确认的 external reference 仍保留显式 classify-external 路径
+
+## 范围与非目标
+
+- 范围内:
+  - 调整 run context 与 run verify 对 discovery 的纳入规则
+  - 调整 standards/source-manual 默认对明显外部参考目录的处理策略
+  - 为历史项目执行 openprd fleet 更新与必要回填
+- 范围外:
+  - 不自动替每个历史项目猜测所有业务目录的 externalReferences 清单
+  - 不修改历史项目的业务代码或需求内容
+  - 不把人工确认 external reference 的能力删除
+
+## 场景与流程
+
+- 主流程:
+  - 维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项目主验证状态；仓库中存在 research、toolkit-sources、marketplace-candidates 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式 classify-external。
+- 边界情况:
+  - 待补充
+- 失败模式:
+  - reference discovery 仍然混入 run context 或 run verify
+  - standards verify 继续被 research 或 toolkit-sources 之类参考目录的说明书缺口淹没
+  - fleet 更新后历史项目仍保留旧的 verify 噪音行为
+
+## 可视化图表
+
+### 产品流程
+
+```mermaid
+flowchart LR
+  entry["入口触发<br/>维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项…"]
+  experience["产品内步骤<br/>修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项…"]
+  decision{"决策点<br/>边界情况仍需澄清"}
+  success(["成功结果<br/>存在 reference discovery 时 openprd run . --context 不再默认展示它"])
+  failure[["失败与恢复<br/>reference discovery 仍然混入 run context 或 run verify"]]
+  entry -->|"维护者运行 openprd run . --context 或 openprd r…"| experience
+  experience -->|"系统处理请求"| decision
+  decision -->|"让主验证只关注当前项目源码和当前实现门禁"| success
+  decision -.->|"reference discovery 仍然混入 run context 或 ru…"| failure
+```
+
+### 架构
+
+```mermaid
+flowchart LR
+  users["主要用户<br/>维护 OpenPrd 的 Agent 工程师 · 使用 OpenPrd 管理历史项目的项目维护者"]
+  subgraph solution["方案边界"]
+    experience["Agent 运行层<br/>维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项…"]
+    core["核心产品逻辑<br/>修复 OpenPrd verify 边界，避免外部参考目录和 reference discovery 污染主验证，并刷新历史项…"]
+    integrations["依赖与集成<br/>暂无外部依赖记录"]
+    governance[["约束与可靠性<br/>暂无明确约束"]]
+    delivery["验证与交接<br/>存在 reference discovery 时 openprd run . --context 不再默认展示它 · 仓库内常…"]
+  end
+  users -->|"维护者运行 openprd run . --context 或 openprd…"| experience
+  experience -->|"产品动作与编排"| core
+  core -->|"依赖与外部服务"| integrations
+  core -.->|"策略、可靠性与合规"| governance
+  core -->|"成功标准与交接"| delivery
+  integrations -->|"运营就绪"| delivery
+  governance -.->|"评审与确认"| delivery
+```
+
+## 需求
+
+- 功能需求:
+  - 待补充
+- 非功能需求:
+  - 待补充
+- 业务规则:
+  - 待补充
+
+## 业务护栏
+
+- 成本来源:
+  - 待补充
+- 额度与限制:
+  - 待补充
+- 滥用防护:
+  - 待补充
+- 监控信号:
+  - 待补充
+- 报警阈值:
+  - 待补充
+- 止损动作:
+  - 待补充
+
+## 约束、依赖与风险
+
+- 技术约束:
+  - 待补充
+- 合规要求:
+  - 待补充
+- 依赖:
+  - 待补充
+- 假设:
+  - 待补充
+- 风险:
+  - 待补充
+- 开放问题:
+  - 本次只收敛默认边界，不自动猜测每个历史项目全部 external reference 清单；如果某些项目还需要更细的目录级归类，仍由维护者显式确认和补充
+
+## 类型专项模块
+
+- 类型: Agent 专项
+- humanAgentContract: Agent 可以识别并提示 reference discovery 与外部参考目录边界，但把目录正式归类为 external reference 仍需要人确认；批量刷新历史项目可以自动执行。
+- autonomyBoundary: Agent 可以修改 OpenPrd CLI、补测试、更新文档、运行 fleet dry-run 与 update-openprd/backfill-work-units，并验证结果；不得静默把任意历史目录永久归类为 external reference。
+- toolBoundary: 使用本地代码检索、OpenPrd CLI、自带测试、fleet 更新、doctor 与 verify 完成实现和验证；本次不需要外部第三方文档调研。
+- stateModel: 需要保留三类状态：当前项目源码验证状态、reference discovery 状态、standards external reference 显式配置；主 run/verify 只默认消费第一类，其他两类按边界显式暴露。
+- evalPlan: 通过针对 run-harness、standards 和 fleet 的单测与集成验证评估；再用历史项目 dry-run 与 update-openprd/backfill-work-units 验证刷新结果。
+
+## 交接
+
+- 负责人: Codex
+- 下一步: 评审已生成的 PRD，并准备交接。
+- 目标系统: OpenSpec

package/.openprd/templates/agent/intake.md

@@ -0,0 +1,6 @@
+# Agent Intake
+
+- What must the agent do autonomously?
+- What must remain human-approved?
+- Which tools and state are available?
+- How do we evaluate success and failure?

package/.openprd/templates/agent/prd.md

@@ -0,0 +1,21 @@
+# Agent PRD
+
+## Inherits
+
+- `base/prd.md`
+
+## Agent 专项字段
+
+- Human-Agent contract:
+- 自主边界:
+- 工具边界:
+- 状态模型:
+- 兜底路径:
+- 评估计划:
+
+## Agent 备注
+
+- 哪些事项必须由人确认？
+- Agent 可以安全执行什么？
+- 如何跨任务衡量成功？
+- 失败后如何恢复？

package/.openprd/templates/b2b/intake.md

@@ -0,0 +1,6 @@
+# B2B Intake
+
+- Who is the buyer?
+- Who is the daily user?
+- Who is the admin?
+- What approval or compliance step can block rollout?

package/.openprd/templates/b2b/prd.md

@@ -0,0 +1,24 @@
+# B2B PRD
+
+## Inherits
+
+- `base/prd.md`
+
+## B2B 专项字段
+
+- 采购方:
+- 使用者:
+- 管理员:
+- 运营者:
+- 角色:
+- 现状流程:
+- 目标流程:
+- 权限矩阵:
+- 审批流程:
+
+## B2B 备注
+
+- 哪个角色负责决策？
+- 哪个角色执行工作？
+- 哪个流程步骤需要可审计？
+- 哪个依赖可能阻塞上线？

package/.openprd/templates/base/intake.md

@@ -0,0 +1,18 @@
+# Intake 模板
+
+## 发现
+
+- 我们要解决什么问题？
+- 主要用户是谁？
+- 当前临时解决方式是什么？
+- 成功指标是什么？
+- 哪些内容不在范围内？
+- 是否涉及免费用户、额度、用量、AI 调用、第三方服务或其他会产生成本的行为？
+
+## Freeze Check
+
+- 产品类型是否已明确？
+- 关键角色是否已明确？
+- 是否已有成功指标？
+- 若存在消耗型成本，是否已明确额度限制、滥用防护、监控报警和止损动作？
+- 是否存在阻塞 freeze 的开放问题？

package/.openprd/templates/base/prd.md

@@ -0,0 +1,67 @@
+# PRD
+
+## 1. 元信息
+
+- 标题:
+- 负责人:
+- 状态:
+- 版本:
+- 产品类型:
+- 日期:
+
+## 2. 问题
+
+- 问题陈述:
+- 为什么现在做:
+- 证据:
+
+## 3. 用户与相关方
+
+- 主要用户:
+- 次要用户:
+- 相关方:
+
+## 4. 目标与成功标准
+
+- 目标:
+- 成功指标:
+- 验收目标:
+
+## 5. 范围与非目标
+
+- 范围内:
+- 范围外:
+
+## 6. 场景与流程
+
+- 主流程:
+- 边界情况:
+- 失败模式:
+
+## 7. 需求
+
+- 功能需求:
+- 非功能需求:
+- 业务规则:
+
+## 8. 业务护栏
+
+- 成本来源:
+- 额度与限制:
+- 滥用防护:
+- 监控信号:
+- 报警阈值:
+- 止损动作:
+
+## 9. 约束、依赖与风险
+
+- 技术约束:
+- 依赖:
+- 风险:
+- 开放问题:
+
+## 10. 交接
+
+- 下一步:
+- 目标系统:
+- 负责人:

package/.openprd/templates/company/README.md

@@ -0,0 +1,10 @@
+# Company Template Layer
+
+This layer captures company-specific PRD habits and terminology.
+
+Rules:
+
+- May rename section labels for display.
+- May add company-only fields.
+- May not delete canonical fields.
+- May not change required semantics.

package/.openprd/templates/consumer/intake.md

@@ -0,0 +1,6 @@
+# Consumer Intake
+
+- What moment triggers the need?
+- What emotional or lifestyle value matters?
+- What is the activation event?
+- What keeps the user returning?

package/.openprd/templates/consumer/prd.md

@@ -0,0 +1,19 @@
+# Consumer PRD
+
+## Inherits
+
+- `base/prd.md`
+
+## 消费端专项字段
+
+- 用户画像:
+- 用户分层:
+- 用户旅程:
+- 激活指标:
+- 留存指标:
+
+## 消费端备注
+
+- 这个产品创造什么情绪价值或生活方式价值？
+- 用户的第一个成功时刻是什么？
+- 什么会让用户持续回来？

package/.openprd/templates/diagram/architecture.contract.json

@@ -0,0 +1,53 @@
+{
+  "type": "architecture",
+  "locale": "zh-CN",
+  "title": "示例架构评审",
+  "subtitle": "说明预期系统形态，便于用户确认",
+  "components": [
+    {
+      "id": "frontend",
+      "name": "前端体验",
+      "type": "frontend",
+      "subtitle": "面向用户的层",
+      "details": [
+        "主要入口界面"
+      ]
+    },
+    {
+      "id": "backend",
+      "name": "核心产品逻辑",
+      "type": "backend",
+      "subtitle": "核心编排",
+      "details": [
+        "业务规则"
+      ]
+    }
+  ],
+  "flows": [
+    {
+      "source": "frontend",
+      "target": "backend",
+      "label": "主要交互",
+      "type": "standard"
+    }
+  ],
+  "summaryCards": [
+    {
+      "title": "范围",
+      "color": "frontend",
+      "items": [
+        "范围内包含什么",
+        "范围外排除什么"
+      ]
+    }
+  ],
+  "reviewInstructions": [
+    "确认缺失系统、边界和依赖。"
+  ],
+  "metadata": {
+    "versionId": "v0001",
+    "owner": "PM",
+    "targetSystem": "OpenPrd",
+    "reviewStatus": "pending-confirmation"
+  }
+}

package/.openprd/templates/diagram/product-flow.contract.json

@@ -0,0 +1,76 @@
+{
+  "type": "product-flow",
+  "locale": "zh-CN",
+  "title": "示例产品流程评审",
+  "subtitle": "说明预期用户与系统顺序，便于确认",
+  "actors": [
+    "用户",
+    "系统"
+  ],
+  "steps": [
+    {
+      "id": "step-1",
+      "name": "用户进入流程",
+      "type": "user_action",
+      "lane": "用户",
+      "description": "流程从这里开始"
+    },
+    {
+      "id": "step-2",
+      "name": "系统处理请求",
+      "type": "system_process",
+      "lane": "系统",
+      "details": [
+        "核心系统响应"
+      ]
+    },
+    {
+      "id": "step-3",
+      "name": "决策点",
+      "type": "decision",
+      "lane": "系统",
+      "description": "根据结果分支"
+    },
+    {
+      "id": "step-4",
+      "name": "成功完成",
+      "type": "success",
+      "lane": "系统",
+      "description": "顺利路径结果"
+    }
+  ],
+  "transitions": [
+    {
+      "from_step_id": "step-1",
+      "to_step_id": "step-2",
+      "label": "开始"
+    },
+    {
+      "from_step_id": "step-2",
+      "to_step_id": "step-3",
+      "label": "继续"
+    },
+    {
+      "from_step_id": "step-3",
+      "to_step_id": "step-4",
+      "label": "成功",
+      "type": "standard"
+    }
+  ],
+  "summaryCards": [
+    {
+      "title": "评审重点",
+      "color": "decision",
+      "items": [
+        "确认步骤顺序",
+        "确认缺失的恢复路径"
+      ]
+    }
+  ],
+  "reviewInstructions": [
+    "确认缺失步骤、决策点和错误路径。"
+  ],
+  "metadata": {
+    "reviewStatus": "pending-confirmation"
+  }
+}

package/.openprd/templates/industry/README.md

@@ -0,0 +1,16 @@
+# Industry Template Layer
+
+This layer is where industry-specific defaults live.
+
+Examples:
+
+- SaaS
+- E-commerce
+- Fintech
+- Internal tools
+
+Rules:
+
+- May add or reorder sections.
+- May not remove core schema fields.
+- Must keep validation compatible with `prd-core`.

package/.openprd/templates/manifest.yaml

@@ -0,0 +1,27 @@
+version: 1
+
+registry:
+  base:
+    path: base/prd.md
+    extends: []
+
+  consumer:
+    path: consumer/prd.md
+    extends:
+      - base
+
+  b2b:
+    path: b2b/prd.md
+    extends:
+      - base
+
+  agent:
+    path: agent/prd.md
+    extends:
+      - base
+
+overrideLayers:
+  - industry
+  - company
+  - project
+  - session

package/.openprd/templates/project/README.md

@@ -0,0 +1,14 @@
+# Project Template Layer
+
+This layer captures project-specific PRD adjustments.
+
+Use cases:
+
+- Add rollout notes.
+- Add project-specific assumptions.
+- Add extra review gates.
+
+Rules:
+
+- Must inherit from company and core layers.
+- Must remain freeze-compatible.