@openprd/cli 0.1.0

package/.openprd/README.md

@@ -0,0 +1,82 @@
+# OpenPrd Workspace
+
+`.openprd/` is the project-local source of truth for discovery, PRD synthesis, validation, freeze, and handoff.
+
+## Lifecycle
+
+```text
+classify -> interview -> synthesize -> validate -> freeze -> handoff
+```
+
+## What Lives Here
+
+- `config.yaml` - runtime defaults and workflow policy
+- `schema/` - canonical PRD schema and validation rules
+- `schema/diagram-architecture.schema.yaml` - minimal contract schema for architecture diagrams
+- `schema/diagram-product-flow.schema.yaml` - minimal contract schema for product flow diagrams
+- `templates/` - starter packs and registry
+- `templates/diagram/` - contract templates for diagram artifacts
+- `standards/` - project standards contract and manual templates
+- `engagements/active/` - default active PRD draft, flow, role, and handoff docs
+- `engagements/active/decision-log.md` - durable decision history
+- `engagements/active/open-questions.md` - unresolved questions and discovery gaps
+- `engagements/active/progress.md` - append-only execution progress
+- `engagements/active/verification.md` - freeze and validation evidence
+- `engagements/active/architecture-diagram.html` - reviewable architecture diagram artifact
+- `engagements/active/architecture-diagram.json` - structured diagram contract for iteration
+- `engagements/active/product-flow-diagram.html` - reviewable product flow diagram artifact
+- `engagements/active/product-flow-diagram.json` - structured product flow contract for iteration
+- `artifacts/active/` - HTML + Markdown + patch bundles for human-in-the-loop review and playground workflows
+- `artifacts/archive/` - archived artifact bundles after demand review or handoff
+- `state/` - runtime status, version index, freeze snapshots, session metadata, and execution graph
+- `state/task-graph.json` - workflow/task graph, blockers, and next-ready node
+- `state/events.jsonl` - append-only lifecycle event stream
+- `state/versions/` - immutable version snapshots
+- `sessions/` - per-engagement working state
+- `exports/` - downstream outputs such as OpenSpec handoff bundles
+
+## Template Layers
+
+```text
+base -> industry -> company -> project -> session
+```
+
+Rules:
+
+- Core PRD fields are fixed.
+- Template layers may add or reorder sections.
+- Template layers may not remove required semantics.
+- The active engagement is the working draft that evolves over time.
+- `classify` sets the product type; `interview` loads discovery prompts.
+- `next` recommends the next action and discovery questions.
+- `synthesize` writes a new versioned PRD snapshot.
+- HTML review and playground artifacts should be paired with a markdown data source and a machine-readable capture patch.
+- `diff` compares version snapshots.
+- `history` lists the version index.
+- Freeze requires validation to pass.
+- `standards` verifies `docs/basic/`, file manual templates, and folder README templates.
+
+## Project Standards
+
+The canonical project baseline docs path is `docs/basic/`.
+
+Required docs:
+
+- `docs/basic/file-structure.md`
+- `docs/basic/app-flow.md`
+- `docs/basic/prd.md`
+- `docs/basic/frontend-guidelines.md`
+- `docs/basic/backend-structure.md`
+- `docs/basic/tech-stack.md`
+
+Use `openprd standards <path> --verify` before reporting a change as ready.
+
+## Supported Product Types
+
+- `consumer`
+- `b2b`
+- `agent`
+
+## Handoff Principle
+
+The goal is not only to write a PRD. The goal is to keep a PRD alive as the product evolves, and to export a stable handoff package when execution starts.

package/.openprd/benchmarks/evidence/milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code.md

@@ -0,0 +1,14 @@
+# milvus.io/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
+
+- ID: milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code
+- 状态: approved
+- 场景: agent-harness, pr-review-harness
+- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
+- 研究方式: official_page_first
+- 来源: https://milvus.io/ar/blog/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
+
+## 备注
+
+AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge recommendation
+

package/.openprd/benchmarks/evidence/nolanlawson-com-using-ai-to-write-better-code-more-slowly.md

@@ -0,0 +1,14 @@
+# nolanlawson.com/using-ai-to-write-better-code-more-slowly
+
+- ID: nolanlawson-com-using-ai-to-write-better-code-more-slowly
+- 状态: approved
+- 场景: agent-harness, pr-review-harness
+- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
+- 研究方式: official_page_first
+- 来源: https://nolanlawson.com/2026/05/25/using-ai-to-write-better-code-more-slowly/
+
+## 备注
+
+AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge recommendation
+

package/.openprd/benchmarks/index.md

@@ -0,0 +1,37 @@
+# OpenPrd Benchmark Registry
+
+## 规则
+
+- 项目级 approved benchmark 优先于 OpenPrd 内置 Source Map。
+- `inbox/` 里的 candidate 只表示待确认线索，不表示长期最佳实践。
+- 每次只挑 1-3 个高相关来源；来源目录不是事实来源。
+
+## Approved Sources
+
+### milvus.io/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md `milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code`
+
+- 状态: approved
+- 来源类型: engineering-article
+- 场景: agent-harness, pr-review-harness
+- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
+- 研究方式: official_page_first
+- 来源: https://milvus.io/ar/blog/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
+- 备注: AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge recommendation
+- 价值: AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge recommendation
+
+### nolanlawson.com/using-ai-to-write-better-code-more-slowly `nolanlawson-com-using-ai-to-write-better-code-more-slowly`
+
+- 状态: approved
+- 来源类型: web
+- 场景: agent-harness, pr-review-harness
+- 触发: 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管；设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；默认给每个低风险 PR 拉起多 reviewer 并行审查
+- 研究方式: official_page_first
+- 来源: https://nolanlawson.com/2026/05/25/using-ai-to-write-better-code-more-slowly/
+- 备注: AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge recommendation
+- 价值: AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge recommendation
+
+## Candidate Sources
+
+- 暂无待确认来源。

package/.openprd/benchmarks/sources.yaml

@@ -0,0 +1,56 @@
+version: 1
+schema: openprd.benchmarks.v1
+updatedAt: 2026-05-28 11:30:07
+sources:
+  - id: milvus-io-ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-code
+    title: milvus.io/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
+    scope: project
+    status: approved
+    sourceType: engineering-article
+    url: https://milvus.io/ar/blog/ai-code-review-gets-better-when-models-debate-claude-vs-gemini-vs-codex-vs-qwen-vs-minimax.md
+    path: null
+    repo: null
+    researchMethod: official_page_first
+    scenarios:
+      - agent-harness
+      - pr-review-harness
+    triggerWhen:
+      - 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管
+      - 设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+    notFor:
+      - 普通 PRD / 产品流程设计
+      - 与 CLI 无关的一次性 UI 视觉问题
+      - 默认给每个低风险 PR 拉起多 reviewer 并行审查
+    note: AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge
+      recommendation
+    value: AI code review / PR review harness；reviewer agreement、交叉验证、误报过滤、hallucination filter、merge
+      recommendation
+    addedAt: 2026-05-28 11:01:00
+    approvedAt: 2026-05-28 11:01:06
+    lastVerified: 2026-05-28 11:30:06
+  - id: nolanlawson-com-using-ai-to-write-better-code-more-slowly
+    title: nolanlawson.com/using-ai-to-write-better-code-more-slowly
+    scope: project
+    status: approved
+    sourceType: web
+    url: https://nolanlawson.com/2026/05/25/using-ai-to-write-better-code-more-slowly/
+    path: null
+    repo: null
+    researchMethod: official_page_first
+    scenarios:
+      - agent-harness
+      - pr-review-harness
+    triggerWhen:
+      - 设计 Agent harness、长程任务、状态持久化、验证门禁或人工接管
+      - 设计 merge 前高风险复核、独立 reviewer 交叉验证、误报过滤、reviewer agreement 或 merge recommendation
+    notFor:
+      - 普通 PRD / 产品流程设计
+      - 与 CLI 无关的一次性 UI 视觉问题
+      - 默认给每个低风险 PR 拉起多 reviewer 并行审查
+    note: AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge
+      recommendation
+    value: AI code review / PR review harness；独立审查、主代理先不站队、汇总后再验证、critical/high/medium/low 分级、merge
+      recommendation
+    addedAt: 2026-05-28 11:00:52
+    approvedAt: 2026-05-28 11:01:06
+    lastVerified: 2026-05-28 11:30:07

package/.openprd/config.yaml

@@ -0,0 +1,50 @@
+version: 1
+schema: prd-core
+activeTemplatePack: base
+supportedProductTypes:
+  - consumer
+  - b2b
+  - agent
+templateInheritance:
+  - base
+  - industry
+  - company
+  - project
+  - session
+workflow:
+  discovery:
+    steps:
+      - classify
+      - interview
+      - synthesize
+      - standards
+      - validate
+      - freeze
+  handoff:
+    target: openspec
+learningReview:
+  enabled: true
+  autoOpen: true
+  defaultGenre: internet-product
+  sourceScope: workspace
+quality:
+  enabled: true
+  command: openprd quality . --verify
+  reportFormat: html
+qualityGates:
+  standards:
+    docsRoot: docs/basic
+    command: openprd standards . --verify
+  quality:
+    command: openprd quality . --verify
+    enforcement: advisory
+  freezeRequires:
+    - meta
+    - problem
+    - users
+    - goals
+    - scope
+    - scenarios
+    - requirements
+    - constraints
+    - risks

package/.openprd/discovery/config.json

@@ -0,0 +1,21 @@
+{
+  "activeChange": "verify-boundaries-and-historical-refresh",
+  "taskSharding": {
+    "maxItemsPerFile": 25,
+    "handoffRequired": true,
+    "firstFile": "tasks.md",
+    "nextFilePattern": "tasks-###.md"
+  },
+  "taskMetadata": {
+    "stableIdPattern": "T###.##",
+    "required": [
+      "done",
+      "verify"
+    ],
+    "optional": [
+      "deps",
+      "type"
+    ],
+    "dependencyOrder": "dependencies must appear before dependents"
+  }
+}

package/.openprd/engagements/active/flows.md

@@ -0,0 +1,30 @@
+# 流程
+
+## 主流程
+
+- 维护者运行 openprd run . --context 或 openprd run . --verify 时，只看到当前项目主验证状态；仓库中存在 research、toolkit-sources、marketplace-candidates 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式 classify-external。
+
+## Mermaid 流程图
+
+```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
+```
+
+## 边界情况
+
+- 待补充
+
+## 失败模式
+
+- reference discovery 仍然混入 run context 或 run verify
+- standards verify 继续被 research 或 toolkit-sources 之类参考目录的说明书缺口淹没
+- fleet 更新后历史项目仍保留旧的 verify 噪音行为

package/.openprd/engagements/active/handoff.md

@@ -0,0 +1,9 @@
+# 交接
+
+- 版本: v0001
+- 产品类型: agent
+- 模板包: agent
+- Digest: dc988d7a94c07d2a8070968a71ddacffb374eaeee12aa85eb93231e06dd7b077
+- 负责人: Codex
+- 下一步: 评审已生成的 PRD，并准备交接。
+- 目标系统: OpenSpec

package/.openprd/engagements/active/intake.md

@@ -0,0 +1,15 @@
+# Intake
+
+## 产品类型
+
+- consumer
+- b2b
+- agent
+
+## 问题
+
+- 我们要解决什么问题？
+- 主要用户是谁？
+- 成功是什么样？
+- 哪些内容明确不在范围内？
+- 我们希望 freeze 的第一个里程碑是什么？

package/.openprd/engagements/active/prd.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/engagements/active/review.html

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="refresh" content="0; url=../../reviews/v0001.html" />
+    <title>Verify 边界与历史项目刷新 / 评审入口</title>
+    <style>
+      :root {
+        color-scheme: light;
+        --bg: #f8fafc;
+        --panel: #ffffff;
+        --text: #111827;
+        --muted: #6b7280;
+        --line: rgba(17,24,39,0.12);
+        --accent: #2563eb;
+      }
+      * { box-sizing: border-box; }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: grid;
+        place-items: center;
+        background: linear-gradient(180deg, #f8fafc 0%, #eef2ff 100%);
+        color: var(--text);
+        font-family: system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;
+      }
+      .panel {
+        width: min(560px, calc(100vw - 32px));
+        padding: 28px 24px;
+        border: 1px solid var(--line);
+        border-radius: 16px;
+        background: var(--panel);
+        box-shadow: 0 18px 40px rgba(15,23,42,0.08);
+      }
+      h1 {
+        margin: 0 0 10px;
+        font-size: 24px;
+        line-height: 1.25;
+      }
+      p {
+        margin: 0 0 12px;
+        color: var(--muted);
+        line-height: 1.6;
+      }
+      a {
+        color: var(--accent);
+        font-weight: 700;
+        text-decoration: none;
+      }
+      a:hover { text-decoration: underline; }
+    </style>
+  </head>
+  <body>
+    <main class="panel">
+      <h1>Verify 边界与历史项目刷新 / 评审入口</h1>
+      <p>这个入口只保留当前评审稿的固定路径，页面会自动跳转到最新的版本化评审文件。</p>
+      <p><a href="../../reviews/v0001.html">如果没有自动跳转，点这里打开评审面板</a></p>
+    </main>
+  </body>
+</html>

package/.openprd/engagements/active/roles.md

@@ -0,0 +1,21 @@
+# 角色
+
+## 用户
+
+- 主要用户:
+- 维护 OpenPrd 的 Agent 工程师
+- 使用 OpenPrd 管理历史项目的项目维护者
+
+- 次要用户:
+- 待补充
+
+- 相关方:
+- 待补充
+
+## 类型专项
+
+- 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 验证刷新结果。

package/.openprd/engagements/work-units/wu-20260524015648-6d33ded7.json

@@ -0,0 +1,23 @@
+{
+  "version": 1,
+  "workUnitId": "wu-20260524015648-6d33ded7",
+  "title": "Verify 边界与历史项目刷新",
+  "status": "confirmed",
+  "projectRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd",
+  "workspaceRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd",
+  "targetRoot": "/Users/chaojifeng/Projects/harness-engineer/openprd",
+  "latestVersionId": "v0001",
+  "latestVersionDigest": "dc988d7a94c07d2a8070968a71ddacffb374eaeee12aa85eb93231e06dd7b077",
+  "reviewArtifact": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/reviews/v0001.html",
+  "activeReviewArtifact": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/engagements/active/review.html",
+  "artifactBundle": {
+    "dir": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/artifacts/active/v0001-review",
+    "html": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/artifacts/active/v0001-review/artifact.html",
+    "markdown": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/artifacts/active/v0001-review/data.md",
+    "patch": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/artifacts/active/v0001-review/capture-patch.json"
+  },
+  "createdAt": "2026-05-24 01:56:48",
+  "updatedAt": "2026-05-30 01:14:49",
+  "reviewPath": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/reviews/v0001.html",
+  "activeReviewPath": "/Users/chaojifeng/Projects/harness-engineer/openprd/.openprd/engagements/active/review.html"
+}

package/.openprd/knowledge/index.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "updatedAt": "2026-05-13 14:08:50",
+  "incidents": [],
+  "patterns": [],
+  "skills": []
+}