@sushanglewis/lincoln 1.8.3 → 1.8.4

package/framework/.claude/agents/pm.md

@@ -20,6 +20,9 @@ extends:
 3. 维护跨子页面影响关系：PRD、用户故事、相关者分析、数据模型等核心文档变更时，在门户中标注受影响的设计文档与原型页面，使下游阶段知悉影响范围。
 4. 对 designer 的输入完整性负责：PRD、用户故事、相关者分析、数据模型、流程图、页面地图必须完整、一致、无歧义；designer 回退确认时，PM 优先澄清，而非让 designer 自行假设。
 5. 在 `product-prototype` 阶段以 reviewer 身份确认原型的功能、字段、流程与需求文档一致。
+6. PRD 质量把关：输出 PRD 前完成「需求清晰度六问」自检（用户有哪些、场景是什么、边界在哪里、如何管异常、如何体验好、最终谁决策），六问全部有明确答案才允许定稿。
+7. PRD 只承载业务内容：技术调研、技术方案、架构/接口/数据库设计等只进设计阶段的归档页，不写入 PRD；过程性疑问（待确认、TODO 之类）在对话中解决后才以结论形式落文档。
+8. 交叉验证决策权：研发计划阶段以测试场景反向挑战 PRD 发现的缺口，必须由人类 PM 决策闭环——修复（PRD 升版重冻结）或接受（记录理由与影响）二选一；PM 未决策不得视为闭环。
 
 ## 专属规则
 

package/framework/.claude/schemas/stage-definition.schema.json

@@ -283,6 +283,8 @@
             "handoff_versions_match",
             "prd_has_required_sections",
             "prd_snapshot_present",
+            "prd_content_hygiene",
+            "prd_cross_validated",
             "artifact_meta_complete",
             "ids_valid",
             "portal_index_fresh"

package/framework/.claude/skills/build-product-prototype/prompts/main.md

@@ -115,12 +115,14 @@ You may still read the categorized example templates under `.claude/templates/is
    - Include `<meta name="page-uid" content="...">`, `<meta name="nav-group" content="...">`, and `<meta name="nav-label" content="...">` (injected by the renderer from CLI args; annotations come from the YAML `annotations` block).
    - Provide the full annotation meta tags so the portal right panel explains functionality, layout, fields, boundary cases, and exception flows.
    - State the applicable role(s), scenario, page state (default / empty / loading / error / success), and which functions are visible and usable in that state via the `doc-purpose`, `doc-rules`, and `doc-boundaries` annotations, so each sub-page precisely depicts what a given role sees and can do in that case.
+   - Depict only the final system as it will ship: no demo-only buttons, explanatory text rows, or walkthrough-only jumps. Explanations belong in the `doc-*` annotation metas rendered in the portal right panel, never as on-screen prose.
+   - Declare the user story and business-flow step the page implements via `doc-stories` / `doc-refs`, so the prototype aligns bidirectionally with the PRD: every flow step has at least one page, and every page belongs to a flow step or story.
    - Use `LincolnPrototype.ui` builders and `prototype.css` tokens for every visual element so both light and dark themes render correctly; verify both themes by toggling the portal theme switch.
    - Assign a stable `data-uid` attribute to every interactive element, screen region, and WebView placeholder.
    - Override `LincolnPrototype.data` in the page script for issue-specific mock data (user, org, webviews, settings, unread items).
 
 7. Optionally create or update `{process_slug}/designs/<design_id>/prototype.pen` with Pencil tools if the PM explicitly asks for a Pencil prototype. If you use Pencil tools, call `get_editor_state(include_schema: true)` first and use `snapshot_layout` to check for clipping/overlap.
-8. Update the root `{process_slug}/pages/docs/prd.html` section 9 "相关产物链接" with the `ui-spec.html`, `fields.html`, and HTML prototype links. If the PRD already has an approved snapshot, warn the PM that changes require a version bump and re-freeze via `python scripts/lincoln_prd.py freeze`.
+8. Update the「相关产物链接」section of the root `{process_slug}/pages/docs/prd.html` (PRD sections are matched by name — numbering is cosmetic) with the `ui-spec.html`, `fields.html`, and HTML prototype links. If the PRD already has an approved snapshot, warn the PM that changes require a version bump and re-freeze via `python scripts/lincoln_prd.py freeze`.
 9. Ask the PM to open `{process_slug}/index.html` in a browser, toggle the theme switch in the macOS menubar, and review both light and dark renderings of each prototype page inside the portal.
 10. When the PM confirms the prototype, add `<!-- prototype-status: approved -->` to `ui-spec.html`.
 11. Run `python scripts/stage_loader.py --stage product-prototype --action record-artifacts`.
@@ -143,4 +145,5 @@ You may still read the categorized example templates under `.claude/templates/is
 - Prototype links use relative paths so they work both inside the portal iframe and when opened standalone.
 - Do not add collapse toggles or custom panel chrome to the portal; the right annotation panel is always visible.
 - The system tray is portal-level chrome. Never redraw the tray inside an app prototype page with `.menubar`, `.tray-icon`, `.tray-panel`, `bindTray`, or `trayMenu`. Tray scenario pages must be thin controllers that post `lincoln-tray-state` messages to the portal.
+- 原型即最终系统样貌：禁止仅用于演示的模拟按钮、屏内说明文字与演示跳转；解释一律走 `doc-*` 注释由门户右侧面板呈现；每个原型页面经 `doc-stories` / `doc-refs` 标注所属用户故事与业务流程步骤，与 PRD 文字双向对齐。
 - After approval, tell the user to run: `claude plan-tdd-development <session_id> <design_id>`.

package/framework/.claude/skills/clarify-requirements/prompts/main.md

@@ -80,7 +80,17 @@ Produce a clear, agreed-upon `{process_slug}/pages/docs/requirements.html` and t
      --markdown {process_slug}/pages/docs/user-stories.md
    ```
 
-9. Generate the root-level PRD at `{process_slug}/pages/docs/prd.html` using the Markdown-first renderer:
+9. 需求清晰度六问自检（Six-Question Gate）。起草原稿前逐项回答，答案落入 PRD 对应章节；任何一项答不出，先按 Human Interaction Rules 问人类 PM，禁止带着未决问题落笔：
+
+   | 六问 | 落笔位置 | 答不出时的动作 |
+   |---|---|---|
+   | 用户有哪些？ | 用户故事 | 请 PM 补充分角色 |
+   | 场景是什么？何时触发、如何完成？ | 业务流程图 | 与 PM 走查主流程 |
+   | 边界在哪里？明确不做什么 | 需求背景（非目标）+ 业务规则 | 请 PM 划定非目标 |
+   | 如何管异常？覆盖每个失败的系统行为 | 业务规则（异常处理） | 逐场景请 PM 裁决 |
+   | 如何体验好？质量与体验判据 | 非功能需求（体验要求） | 请 PM 给出体验判据 |
+   | 最终谁决策？ | 版本说明（决策人） | 请 PM 指定决策人 |
+10. Generate the root-level PRD at `{process_slug}/pages/docs/prd.html` using the Markdown-first renderer:
 
    ```bash
    python scripts/lincoln_render.py \
@@ -90,25 +100,33 @@ Produce a clear, agreed-upon `{process_slug}/pages/docs/requirements.html` and t
      --markdown {process_slug}/pages/docs/prd.md
    ```
 
-   Write `{process_slug}/pages/docs/prd.md` with at least these H2 chapters, but feel free to add, merge, or reorder them to best tell the story:
-
-   - `## 1. 需求背景`
-   - `## 2. 用户故事`
-   - `## 3. 功能拆解`
-   - `## 4. 业务流程图` (use ` ```mermaid ` diagrams)
-   - `## 5. 验收标准`
-   - `## 6. 业务规则`
-   - `## 7. 非功能需求`
-   - `## 8. 关联系统/接口`
-   - `## 9. 相关产物链接`
-   - `## 10. 风险与开放问题`
+   Write `{process_slug}/pages/docs/prd.md` following this progressive skeleton. Keep all thirteen chapters in this order as the default narrative; you may insert additional business chapters inside the skeleton when this requirement's shape calls for it. Section headings are matched by name — numbering is cosmetic, not part of the contract:
+
+   - `## 1. 版本说明` — 当前版本、文档状态、决策人（最终谁拍板）。
+   - `## 2. 修订记录` — 版本/日期/作者/变更摘要 表格。
+   - `## 3. 功能列表` — 功能/优先级/状态/对应用户故事 表格。
+   - `## 4. 需求背景`
+   - `## 5. 用户故事`
+   - `## 6. 功能拆解`
+   - `## 7. 业务流程图` (use ` ```mermaid ` diagrams)
+   - `## 8. 验收标准`
+   - `## 9. 业务规则`（边界与异常处理）
+   - `## 10. 非功能需求`（含体验要求）
+   - `## 11. 关联系统/接口`
+   - `## 12. 相关产物链接`
+   - `## 13. 风险与开放问题`
+
+   PRD 正文禁则（读者是研发团队，文档只讲业务场景）：
+   - 不写技术调研、技术方案、架构设计、接口设计、数据库设计等内容——这类内容只进 design 阶段维护的归档页 `feasibility.html`。
+   - 不写任何过程性提醒（"待确认""待人类 PM 确认""TODO"、agent 注等）——疑问在对话中解决，解决后才落文档。
+   - 同一信息只用一种方式描述：文字、表格、mermaid 图组合使用，但不重复表达同一内容。
 
    It must also carry:
    - `<!-- version: v1.0 -->` marker (added automatically by the renderer from the Markdown file or `--version`).
    - Meta tags: `doc-title`, `nav-group="Docs"`, `doc-version="v1.0"`, and a stable `doc-uid` (all injected by the renderer).
-10. When the PM confirms, add an approval marker inside `requirements.html`: `<!-- status: approved -->`.
-11. After human approval, run `python scripts/lincoln_prd.py freeze` to create the immutable snapshot `{process_slug}/pages/docs/snapshots/prd-v1.0.html`.
-12. Run `python scripts/stage_loader.py --stage clarify --action record-artifacts` to persist the artifact paths and refresh `{process_slug}/assets/js/package-data.js`.
+11. When the PM confirms, add an approval marker inside `requirements.html`: `<!-- status: approved -->`.
+12. After human approval, run `python scripts/lincoln_prd.py freeze` to create the immutable snapshot `{process_slug}/pages/docs/snapshots/prd-v1.0.html`.
+13. Run `python scripts/stage_loader.py --stage clarify --action record-artifacts` to persist the artifact paths and refresh `{process_slug}/assets/js/package-data.js`.
 
 ## Human Interaction Rules
 
@@ -122,6 +140,8 @@ Produce a clear, agreed-upon `{process_slug}/pages/docs/requirements.html` and t
 - Every document page opens with `## 页面意图` (目标读者 + 本页回答什么问题) and `## 边界` (本页不覆盖什么 + 单一事实来源链接).
 - Content follows standard Markdown: a single H1, H2 chapters, and tables/Mermaid over long prose. Never duplicate content across pages — link to the single source of truth instead.
 - These pages are business-facing: 需求背景、用户角色、旅程、业务状态、业务流程、验收标准. Technical research or solution comparisons performed while clarifying are only background for the PM's decision — do not register them into any page; they may be summarized later into the archived `feasibility.html` by the design stage.
+- 过程性内容不进入任何页面：待确认事项、agent 提醒、对话记录只留在对话里，解决后才以结论形式落文档。
+- 同一信息只描述一次：文字、表格、mermaid 图可以组合使用，但不得用多种方式重复表达同一内容；需要引用时链接到单一事实来源。
 
 ## 认知象限确认（Johari）
 

package/framework/.claude/skills/draft-product-design/prompts/main.md

@@ -79,7 +79,7 @@ Create `{process_slug}/pages/docs/` HTML design documents with enough product, d
 4. Create the PM→UX handoff contract at `{process_slug}/handoffs/pm-to-ux/pm-to-ux.handoff.yaml` referencing the approved design docs and PRD versions.
 5. Create the human-readable PM→UX handoff portal page at `{process_slug}/pages/docs/handoff-pm-to-ux-v1.0.html` and the narrative master handoff document at `{process_slug}/handoffs/pm-to-ux/master-handoff-pm-to-ux-v1.0.md`. These summarize core decisions, scope, open questions, and the context pack for the receiving UX Agent.
 6. Keep all documents traceable to the approved requirement and transcript timestamps where available.
-7. Update the root `{process_slug}/pages/docs/prd.html` section 9 "相关产物链接" with links to the new design documents and handoff artifacts. If the PRD already has an approved snapshot (`pages/docs/snapshots/prd-v*.html`), warn the PM that any content change requires bumping the version marker and re-freezing via `python scripts/lincoln_prd.py freeze`.
+7. Update the「相关产物链接」section of the root `{process_slug}/pages/docs/prd.html` (PRD sections are matched by name — numbering is cosmetic) with links to the new design documents and handoff artifacts. If the PRD already has an approved snapshot (`pages/docs/snapshots/prd-v*.html`), warn the PM that any content change requires bumping the version marker and re-freezing via `python scripts/lincoln_prd.py freeze`.
 8. Ask the PM to review `design-review.html` and linked docs (they can open `{process_slug}/index.html` in a browser).
 9. When the PM confirms, add `<!-- status: approved -->` to `design-review.html`.
 10. Run `python scripts/stage_loader.py --stage product-design-docs --action record-artifacts`.

package/framework/.claude/skills/lc-workflow/validators/validate.py

@@ -640,33 +640,75 @@ def check_tdd_plan_complete(design_id: str):
 # PRD checks
 # ---------------------------------------------------------------------------
 
+# 递进骨架（issue-129）：版本说明 → 修订记录 → 功能列表 → 需求展开。
+# 章节编号不参与匹配，PM 可按需求类型在骨架内增插业务章节。
 REQUIRED_PRD_SECTIONS = [
-    "## 1. 需求背景",
-    "## 2. 用户故事",
-    "## 3. 功能拆解",
-    "## 4. 业务流程图",
-    "## 5. 验收标准",
-    "## 6. 业务规则",
-    "## 7. 非功能需求",
-    "## 8. 关联系统/接口",
-    "## 9. 相关产物链接",
-    "## 10. 风险与开放问题",
+    "版本说明",
+    "修订记录",
+    "功能列表",
+    "需求背景",
+    "用户故事",
+    "功能拆解",
+    "业务流程图",
+    "验收标准",
+    "业务规则",
+    "非功能需求",
+    "关联系统/接口",
+    "相关产物链接",
+    "风险与开放问题",
 ]
 
+PRD_SECTION_PATTERNS = [
+    (name, re.compile(rf"^##\s*(?:\d+\s*[.、．]?\s*)?{re.escape(name)}\s*$", re.MULTILINE))
+    for name in REQUIRED_PRD_SECTIONS
+]
+
+# PRD 正文禁则：过程性疑问在对话中解决，技术内容归归档页（issue-129 第 4/6 条）。
+PRD_FORBIDDEN_PROCESS_RE = re.compile(r"待确认|待人类|待补充|待\s*PM|TODO|FIXME", re.IGNORECASE)
+PRD_FORBIDDEN_TECH_HEADING_RE = re.compile(
+    r"^##+\s*.*(技术调研|技术方案|可行性研究|架构设计|接口设计|数据库设计)",
+    re.MULTILINE,
+)
+
+CROSS_VALIDATION_PASS_RE = re.compile(
+    r"<!--\s*cross-validation:\s*pass\s+prd-version:\s*(v\d+\.\d+)\s*-->"
+)
+
+
+def _prd_hygiene_violations(content: str) -> list[str]:
+    violations = sorted(set(PRD_FORBIDDEN_PROCESS_RE.findall(content)))
+    violations.extend(sorted(set(PRD_FORBIDDEN_TECH_HEADING_RE.findall(content))))
+    return violations
+
 
 def check_prd_has_required_sections(path: str):
     target = PROJECT_ROOT / path
     if not target.exists():
         fail(f"PRD missing: {target}")
 
-    text = read_document_file(target)
-    missing = [section for section in REQUIRED_PRD_SECTIONS if section not in text]
+    content = read_document_file(target)
+    missing = [name for name, pattern in PRD_SECTION_PATTERNS if not pattern.search(content)]
     if missing:
         fail(f"PRD missing required sections: {', '.join(missing)}")
 
     pass_check("PRD has all required sections")
 
 
+def check_prd_content_hygiene(path: str):
+    target = PROJECT_ROOT / path
+    if not target.exists():
+        fail(f"PRD missing: {target}")
+
+    violations = _prd_hygiene_violations(read_document_file(target))
+    if violations:
+        fail(
+            "PRD contains content that belongs in conversation or archived pages, "
+            f"not the PRD: {', '.join(violations)}"
+        )
+
+    pass_check("PRD content hygiene OK")
+
+
 def check_prd_snapshot_present(path: str):
     target = PROJECT_ROOT / path
     if not target.exists():
@@ -692,6 +734,43 @@ def check_prd_snapshot_present(path: str):
     pass_check(f"PRD snapshot present: {snapshot_path}")
 
 
+def check_prd_cross_validated(path: str):
+    target = PROJECT_ROOT / path
+    if not target.exists():
+        fail(f"Cross-validation report missing: {target}")
+
+    match = CROSS_VALIDATION_PASS_RE.search(read_document_file(target))
+    if not match:
+        fail(
+            "Cross-validation report has no pass marker. Every gap must be closed by a "
+            "human-PM decision (PRD fix with re-freeze, or accepted with recorded "
+            "rationale) before adding '<!-- cross-validation: pass prd-version: vX.Y -->'."
+        )
+
+    prd_path = target.parent / "prd.html"
+    if not prd_path.exists():
+        fail(f"PRD missing next to cross-validation report: {prd_path}")
+
+    if extract_markdown_version is None:
+        fail("markdown version extraction is not available")
+
+    prd_version = extract_markdown_version(prd_path)
+    if prd_version != match.group(1):
+        fail(
+            f"Cross-validation pass marker is for PRD {match.group(1)}, but the PRD is now "
+            f"{prd_version or 'unversioned'}. Re-run cross-validation against the current PRD."
+        )
+
+    violations = _prd_hygiene_violations(read_document_file(prd_path))
+    if violations:
+        fail(
+            f"PRD regressed after cross-validation pass: {', '.join(violations)}. "
+            "Fix the PRD, bump its version, re-freeze, and re-run cross-validation."
+        )
+
+    pass_check(f"PRD cross-validation pass marker matches PRD {prd_version}")
+
+
 # ---------------------------------------------------------------------------
 # Registry
 # ---------------------------------------------------------------------------
@@ -729,6 +808,8 @@ EXIT_CHECKS = {
     "tdd_plan_complete": check_tdd_plan_complete,
     "prd_has_required_sections": check_prd_has_required_sections,
     "prd_snapshot_present": check_prd_snapshot_present,
+    "prd_content_hygiene": check_prd_content_hygiene,
+    "prd_cross_validated": check_prd_cross_validated,
 }
 
 

package/framework/.claude/skills/plan-tdd-development/SKILL.md

@@ -13,6 +13,7 @@ inputs:
     required: true
 outputs:
   - "{process_slug}/pages/docs/tdd-plan.html"
+  - "{process_slug}/pages/docs/prd-cross-validation.html"
 required_tools:
   - Read
   - Bash

package/framework/.claude/skills/plan-tdd-development/prompts/main.md

@@ -1,10 +1,10 @@
 # plan-tdd-development
 
-You are executing the Lincoln workflow step `tdd-development-plan`: turn the confirmed product design and prototype into a TDD development plan.
+You are executing the Lincoln workflow step `tdd-development-plan`: turn the confirmed product design and prototype into a TDD development plan, then reverse-drive the PRD with test scenarios so gaps close before development.
 
 ## Goal
 
-Create `{process_slug}/pages/docs/tdd-plan.html` as the bridge from product design to OpenSpec and GitHub Issues.
+Create `{process_slug}/pages/docs/tdd-plan.html` as the bridge from product design to OpenSpec and GitHub Issues, and produce `{process_slug}/pages/docs/prd-cross-validation.html` so every test scenario (正常/边界/异常) challenges the PRD — SDD tests reverse-drive PRD completeness.
 
 ## Input
 
@@ -16,11 +16,13 @@ Create `{process_slug}/pages/docs/tdd-plan.html` as the bridge from product desi
 在执行本 prompt 前：
 1. 调用 `superpowers:writing-plans` 规划 `tdd-plan.html` 结构。
 2. 遵循 `superpowers:test-driven-development` 方法论：确保每个任务切片都是“先写失败测试 → 最小实现 → 重构”序列。
-3. 在 `tdd-plan.html` 的 Markdown source 头部加入：  
+3. 在 `tdd-plan.html` 的 Markdown source 头部加入：
    `> **Required sub-skill:** Use superpowers:test-driven-development for all implementation`
 
 ## Steps
 
+### Phase 1 — TDD 计划
+
 1. Verify that `{process_slug}/pages/docs/ui-spec.html` contains `<!-- prototype-status: approved -->` or `[x] PM 已确认原型`.
 2. Confirm `{process_slug}/designs/<design_id>/prototype.pen`, `{process_slug}/pages/docs/fields.html`, and the design review package exist.
 3. Read the confirmed design docs and inspect the `.pen` through Pencil tools if visual structure is needed.
@@ -34,11 +36,39 @@ Create `{process_slug}/pages/docs/tdd-plan.html` as the bridge from product desi
    - Task slices suitable for OpenSpec tasks and GitHub Issues
    - Risks, dependencies, and out-of-scope items
 5. Add `<!-- status: ready-for-openspec -->` when the plan is complete.
-6. Run `python scripts/stage_loader.py --stage tdd-development-plan --action record-artifacts`.
+
+### Phase 2 — PRD 交叉验证（测试反向驱动 PRD）
+
+6. **场景回问**：从 tdd-plan 的测试场景（正常、边界、异常）逐一回问 `{process_slug}/pages/docs/prd.html`：该场景涉及的业务规则与验收标准在 PRD 中是否有明确答案？逐项记录「场景 → PRD 答案（章节 + 条文）」，PRD 无答案者标记为缺口。
+7. **对齐闭环**：建立业务流程步骤 ↔ 原型页面双向对齐矩阵——PRD 业务流程图中的每个步骤至少有 1 个原型页面承载；每个原型页面归属于某流程步骤或用户故事。任一侧对不上即为缺口（流程中断或原型多余）。
+8. **渲染报告**：写 `{process_slug}/pages/docs/prd-cross-validation.md`（顶部含 `<!-- version: v1.0 -->`），用 `lincoln_render.py` 渲染为 `{process_slug}/pages/docs/prd-cross-validation.html`：
+
+   ```bash
+   python scripts/lincoln_render.py \
+     --stage tdd-development-plan \
+     --target {process_slug}/pages/docs/prd-cross-validation.html \
+     --title "PRD 交叉验证报告" \
+     --markdown {process_slug}/pages/docs/prd-cross-validation.md
+   ```
+
+   报告必须含：场景 → PRD 答案映射表、缺口清单、决策记录表（缺口 / 闭环方式 / PM 决策 / 理由）、PRD 修订回执。
+9. **闭环缺口**：每个缺口由人类 PM 决策二选一——
+   - **修复**：修订 `prd.md`，bump `<!-- version: vX.Y -->`，运行 `python scripts/lincoln_prd.py freeze` 重新冻结，然后重跑 Phase 2；
+   - **接受**：在决策记录表中记录理由与影响，经人类 PM 明确认可。
+
+   全部缺口闭环后，在报告 markdown 末尾追加 `<!-- cross-validation: pass prd-version: vX.Y -->`（vX.Y = 当前 PRD 版本）并重新渲染。未闭环前禁止写入该标记。
+10. Run `python scripts/stage_loader.py --stage tdd-development-plan --action record-artifacts`.
+
+## Output Artifacts
+
+- `{process_slug}/pages/docs/tdd-plan.html`
+- `{process_slug}/pages/docs/prd-cross-validation.html`（含场景→PRD 答案映射、缺口清单、决策记录、闭环标记）
 
 ## Rules
 
 - Keep the plan executable by an engineer without requiring extra product decisions.
 - Every task slice must map back to a design artifact and acceptance criterion.
 - Do not generate OpenSpec artifacts in this step.
+- 交叉验证发现的 PRD 缺口不得自行编造业务答案，必须交回人类 PM 决策（修复或接受）。
+- pass 标记中的版本必须与当前 PRD 版本一致；PRD 后续任何改动都会使标记失效，须重跑 Phase 2。
 - After completion, tell the user to run: `claude propose-with-openspec <session_id> <design_id> <change_name>`.

package/framework/.claude/stages/clarify.yaml

@@ -61,6 +61,9 @@ gates:
   - check: prd_has_required_sections
     args:
     - '{process_slug}/pages/docs/prd.html'
+  - check: prd_content_hygiene
+    args:
+    - '{process_slug}/pages/docs/prd.html'
   - check: human_approved
   - check: prd_snapshot_present
     args:

package/framework/.claude/stages/tdd-development-plan.yaml

@@ -18,6 +18,7 @@ variables:
 - process_slug
 artifact_templates:
   '{process_slug}/pages/docs/tdd-plan.html': .claude/templates/issue-package/page-doc.html.tpl
+  '{process_slug}/pages/docs/prd-cross-validation.html': .claude/templates/issue-package/page-doc.html.tpl
 agent:
   primary: lc-engineer
   reviewers:
@@ -36,11 +37,12 @@ skills:
 artifacts:
   required:
   - '{process_slug}/pages/docs/tdd-plan.html'
+  - '{process_slug}/pages/docs/prd-cross-validation.html'
 references:
   skill_prompt: .claude/skills/plan-tdd-development/SKILL.md
   agent_guide: .claude/agents/engineer.md
 context:
-  goal: 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成可执行的测试驱动研发计划（`tdd-plan.html`），作为从产品设计到 OpenSpec 变更提案的桥梁。所有产物通过 {process_slug}/index.html 门户访问。
+  goal: 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成可执行的测试驱动研发计划（`tdd-plan.html`），作为从产品设计到 OpenSpec 变更提案的桥梁；随后执行 PRD 交叉验证——用测试场景反向挑战 PRD（业务规则、验收标准、流程与原型对齐），全部缺口经人类 PM 决策闭环后方可离开本阶段。所有产物通过 {process_slug}/index.html 门户访问。
   execution: "调用 plan-tdd-development skill 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成包含验收映射、测试场景与任务切片的 tdd-plan.html，作为 OpenSpec 提案的输入。"
 gates:
   entry:
@@ -49,3 +51,6 @@ gates:
     - product-prototype
   exit:
   - check: artifacts_present
+  - check: prd_cross_validated
+    args:
+    - '{process_slug}/pages/docs/prd-cross-validation.html'

package/framework/.claude/workflows/interview-to-knowledge.yaml

@@ -54,6 +54,8 @@ workflow:
       exit_checks:
         - check: prd_has_required_sections
           args: ["{process_slug}/pages/docs/prd.html"]
+        - check: prd_content_hygiene
+          args: ["{process_slug}/pages/docs/prd.html"]
         - check: human_approved
           args: ["{session_id}"]
         - check: prd_snapshot_present
@@ -114,9 +116,12 @@ workflow:
       action: plan-tdd-development
       artifacts:
         - "{process_slug}/pages/docs/tdd-plan.html"
+        - "{process_slug}/pages/docs/prd-cross-validation.html"
       exit_checks:
         - check: tdd_plan_complete
           args: ["{design_id}"]
+        - check: prd_cross_validated
+          args: ["{process_slug}/pages/docs/prd-cross-validation.html"]
 
     - id: propose
       name: OpenSpec 提案

package/framework/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "lincoln",
       "description": "AI-Native product R&D collaboration system for Conductor + Claude Code. Orchestrates stages, gates, artifacts, skills, and roles across product, design, and engineering into a repeatable workflow from recordings to GitHub Issues to Obsidian knowledge base.",
-      "version": "1.8.3",
+      "version": "1.8.4",
       "author": {
         "name": "Lincoln contributors"
       },
@@ -28,5 +28,5 @@
       ]
     }
   ],
-  "version": "1.8.3"
+  "version": "1.8.4"
 }

package/framework/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lincoln",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "AI-Native product R&D collaboration system for Conductor + Claude Code + OpenSpec + GitHub + Obsidian",
   "author": {
     "name": "Lincoln contributors"

package/framework/.version-bump.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.3",
+  "version": "1.8.4",
   "manifests": [
     {
       "path": ".claude-plugin/plugin.json",

package/framework/README.en.md

@@ -12,9 +12,9 @@ Lincoln is an AI-Native R&D workflow system spanning **IDEs, agent harnesses, co
 
 ## Latest Release
 
-[![Release](https://img.shields.io/badge/release-v1.8.3-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.8.4-blue)](RELEASE.md)
 
-**v1.8.3** is released: SecurityAnalyzer pre-tool-use gating, Trace 2.0 event log, session friction scoring and knowledge recall, plus multi-dimensional stakeholder analysis in the clarify stage.
+**v1.8.4** is released: hook-injected less-is-more artifact discipline, plus a fix syncing the `policies` directory into vendored projects.
 
 See the full release notes in [RELEASE.md](RELEASE.md).
 
@@ -101,6 +101,12 @@ lincoln update            # upgrade to the latest release and re-sync
 lincoln update --check    # check for a newer version without installing
 ```
 
+Or upgrade the package directly via npm and then re-sync:
+
+```bash
+npm install -g @sushanglewis/lincoln@latest && lincoln update
+```
+
 On an older install (e.g. from the `lincoln-install` era), or if npm reports `EEXIST: file already exists`, a leftover bin from an old package is blocking the install — clean up first, then reinstall:
 
 ```bash
@@ -236,6 +242,7 @@ Before submitting a PR, please read:
 
 | Version | Date | Key capabilities |
 |---|---|---|
+| v1.8.4 | 2026-10-08 | PM-stage PRD quality gates: six-question clarity check, 13-section progressive PRD skeleton, content-hygiene and cross-validation checks, final-system-only prototype discipline (#129) |
 | v1.8.3 | 2026-10-08 | Less-is-more artifact discipline (hook-injected); platform-aware install hints for non-npm CLIs; `lincoln update` refreshes external skill libraries |
 | v1.7.0 | 2026-09-05 | SecurityAnalyzer gating; Trace 2.0 event log; friction scoring/knowledge recall/trace condensation/MR mining; parallel specialist delegation; stakeholder analysis model |
 | v1.6.3 | 2026-08-15 | Markdown-first issue-package documents; `--render-stage` batch rendering; local `mermaid.min.js` runtime |

package/framework/README.md

@@ -12,9 +12,9 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ## 最新版本
 
-[![Release](https://img.shields.io/badge/release-v1.8.3-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.8.4-blue)](RELEASE.md)
 
-**v1.8.3** 已发布：新增 SecurityAnalyzer 安全门控、Trace 2.0 事件日志与会话摩擦学习/知识召回能力，clarify 阶段支持多维度相关者分析。
+**v1.8.4** 已发布：新增少即是多制品生成纪律（hook 注入），修复 policies 目录未同步进 vendored 项目的问题。
 
 查看完整发布说明：[RELEASE.md](RELEASE.md)
 
@@ -101,6 +101,12 @@ lincoln update            # 升级本体 + 同步框架 + 刷新外部技能库
 lincoln update --check    # 只检查是否有新版本，不安装
 ```
 
+也可以直接用 npm 把本体升到最新再同步框架：
+
+```bash
+npm install -g @sushanglewis/lincoln@latest && lincoln update
+```
+
 技能库同步遵循 dependencies.yaml 的 pin 策略：本地有未提交修改的仓库会被跳过并警告（不会被强制覆盖），非 npm 管理的 CLI（如 gh）缺失时只提示安装命令。同步失败降级为警告，不会阻断升级。
 
 如果还是旧版安装（例如 bin 名是 `lincoln-install` 的时代），或更新时 npm 报 `EEXIST: file already exists`，说明有旧包残留的 bin 文件挡住了安装，先清理再重装：
@@ -238,6 +244,7 @@ Lincoln 的 `.claude/` 是开放的系统提示层，欢迎基于同一套元模
 
 | 版本 | 日期 | 关键能力 |
 |---|---|---|
+| v1.8.4 | 2026-10-08 | PM 阶段 PRD 质量门控：需求六问自检、13 章递进骨架、PRD 内容卫生与交叉验证校验、原型最终样貌纪律（#129） |
 | v1.8.3 | 2026-10-08 | 少即是多制品生成纪律（hook 注入）；非 npm CLI 平台化安装提示；`lincoln update` 同步刷新外部技能库 |
 | v1.7.0 | 2026-09-05 | SecurityAnalyzer 安全门控；Trace 2.0 事件日志；摩擦学习/知识召回/Trace 浓缩/MR 挖掘；并行专家子代理委托；相关者分析模型 |
 | v1.6.3 | 2026-08-15 | Markdown-first issue-package 文档；`--render-stage` 批量渲染；Mermaid 图表本地渲染 |

package/framework/RELEASE.md

@@ -1,3 +1,24 @@
+# Lincoln v1.8.4 Release Notes
+
+**Release date:** 2026-10-08
+
+## Highlights
+
+- **PM 阶段 PRD 质量整治 (#129)** — 把「PM 产出的 PRD 必须经得起研发团队与测试挑战」从 prompt 建议升级为可执行的门控：
+  - **需求清晰度六问自检** — clarify-requirements 起草原稿前必须逐项回答：用户有哪些、场景是什么、边界在哪里、如何管异常、如何体验好、最终谁决策；答不出先问人类 PM，禁止带未决问题落笔。
+  - **13 章递进骨架** — PRD 固定为「版本说明 → 修订记录 → 功能列表 → 需求背景 → … → 风险与开放问题」的渐进结构，章节按名字匹配、编号只是装饰，PM 可按需求形态在骨架内增插业务章节。
+  - **双注册表内容卫生校验** — 两份校验器（stage gates 与 workflow exit_checks）同步新增 `prd_content_hygiene`：PRD 正文禁止过程性短语（待确认/待 PM/TODO 等）与技术性章节（技术调研/架构设计/数据库设计等），技术内容只进 design 阶段的归档页 feasibility.html。
+  - **SDD 测试反向驱动交叉验证** — plan-tdd-development 新增 Phase 2：从测试场景（正常/边界/异常）逐一回问 PRD 业务规则与验收标准，并建立业务流程步骤 ↔ 原型页面双向对齐矩阵；缺口必须由人类 PM 决策闭环（修复 = PRD 升版重冻结，或接受 = 记录理由与影响），全部闭环后交叉验证报告才能写入 pass 标记，`prd_cross_validated` 校验器强制 pass 标记版本与当前 PRD 版本严格相等并对 PRD 复检卫生，防止后续阶段编辑回潮。
+  - **原型只画最终样貌** — build-product-prototype 明确禁止仅用于演示的模拟按钮、屏内说明文字与演示跳转，解释一律走 `doc-*` 注释由门户右侧面板呈现；每个原型页面标注所属用户故事与业务流程步骤，与 PRD 文字双向对齐。
+  - **PM 角色质量职责** — lc-pm 新增三条专属职责：输出 PRD 前完成六问自检、PRD 只承载业务内容、交叉验证缺口必须经人类 PM 决策才允许闭环。
+
+## Migration Notes
+
+- 无破坏性变更：新校验只在 `clarify` 与 `tdd-development-plan` 阶段出口执行，既有已审批产物不受影响；重跑这两个阶段时需满足新版骨架与卫生规则。
+- 升级后执行 `lincoln update` 即把新 prompt、校验器与门控接线同步进各 harness；进行中的 issue 工作包从下一阶段起自动适用新规则。
+
+---
+
 # Lincoln v1.8.3 Release Notes
 
 **Release date:** 2026-10-08

package/framework/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.8.3",
-  "generatedAt": "2026-10-08T06:44:27.829Z",
+  "version": "1.8.4",
+  "generatedAt": "2026-10-08T15:05:56.234Z",
   "files": [
     {
       "path": ".claude-plugin/hooks.json",
@@ -8,11 +8,11 @@
     },
     {
       "path": ".claude-plugin/marketplace.json",
-      "sha256": "11b5a97c00ce9b5ad558cd0d4929a9b3acaabc006fa3a20c223e3026a778fb8c"
+      "sha256": "eedc0fe820496ffa76731e694758753e81d55bcbab1b3f4700562559aeebeba8"
     },
     {
       "path": ".claude-plugin/plugin.json",
-      "sha256": "18060c38b9f9d9a3ca1b356a33d39810f13248cf1ee9bdd224fb6b2ca9d907e0"
+      "sha256": "c18a2bb7fa9907deccc2e14556a3279d876ed08560eb092a59f341587f7fe7c9"
     },
     {
       "path": ".claude/agents/architect.md",
@@ -56,7 +56,7 @@
     },
     {
       "path": ".claude/agents/pm.md",
-      "sha256": "75e9481a9bb0b87fd051416f1680f748ddd62e61209c29697acb589fbbb11fa1"
+      "sha256": "eaf7c02ca5b268376e3df7ebe5862bee739688748b8a9472818117b74cfdd627"
     },
     {
       "path": ".claude/agents/qa.md",
@@ -152,7 +152,7 @@
     },
     {
       "path": ".claude/schemas/stage-definition.schema.json",
-      "sha256": "5746190d5de63f7481bc161d4c6a301a43b776886b99ffb0c099609bb5422a05"
+      "sha256": "153a15c095706c259fabb313227eb183615b84596020f70326ea5e3541f9797e"
     },
     {
       "path": ".claude/schemas/workflow-stage.schema.json",
@@ -172,7 +172,7 @@
     },
     {
       "path": ".claude/skills/build-product-prototype/prompts/main.md",
-      "sha256": "390589f01598b749d8c85e5ecab425ea70b428cb3fe91484b91136168e0b4a82"
+      "sha256": "6523aa6def0f75f93cbbbcbb76e5de285ecc730bb81211add8900826f6a51d5b"
     },
     {
       "path": ".claude/skills/clarify-requirements/SKILL.md",
@@ -180,7 +180,7 @@
     },
     {
       "path": ".claude/skills/clarify-requirements/prompts/main.md",
-      "sha256": "5431aa1a268058d397d1a0acbf79d50b8c87e42ab3ae7f329e0e810e2e519f7b"
+      "sha256": "c96b1972e085fdea5c28c152c69fa8421d814fc9ce4a7169fa5c8f94619ef36c"
     },
     {
       "path": ".claude/skills/dependencies.yaml",
@@ -192,7 +192,7 @@
     },
     {
       "path": ".claude/skills/draft-product-design/prompts/main.md",
-      "sha256": "22d3a9635ab3937206eb1bb686728e5d5135b9b1de27ca76d6976180ab97b8ab"
+      "sha256": "77aa515515dbe87216041f064a480ddac269889e2e5f296843537ab92d794c44"
     },
     {
       "path": ".claude/skills/lc-analyze-frameworks/SKILL.md",
@@ -348,15 +348,15 @@
     },
     {
       "path": ".claude/skills/lc-workflow/validators/validate.py",
-      "sha256": "2ef99c40e29de06761005ac58f9e47a32955a104a18987d4b8059507f179bdbf"
+      "sha256": "0a6b9afab31c0e0e4b33dc7cc2e421604bafbc386cb9bd259098232f161e0e1b"
     },
     {
       "path": ".claude/skills/plan-tdd-development/SKILL.md",
-      "sha256": "e90e6fba34fa718cae42b7f9f12e044152f5e1742500704824022d4bac62f4e3"
+      "sha256": "71c9497cd6bb6cbf0486fd3955bdf41579c6c2691f4c060a343d4712ba485143"
     },
     {
       "path": ".claude/skills/plan-tdd-development/prompts/main.md",
-      "sha256": "44ed17546594d97aa25cf88af8b124f8978c114229b7522517b23d909cdd1321"
+      "sha256": "9a5a3a5b84c27e52026e8f6d01f3c350d5ac478af4f349c6756a5b40e2150705"
     },
     {
       "path": ".claude/skills/process-interview/SKILL.md",
@@ -404,7 +404,7 @@
     },
     {
       "path": ".claude/stages/clarify.yaml",
-      "sha256": "14d3ddb85431fb1800fff8794a6c6aeec378cc8e88bf458f7b593409b8380b1c"
+      "sha256": "506491928f9e68fb643912046b66b565035ed9c2b397a9613d3541cd46d35327"
     },
     {
       "path": ".claude/stages/explore-opensource.yaml",
@@ -496,7 +496,7 @@
     },
     {
       "path": ".claude/stages/tdd-development-plan.yaml",
-      "sha256": "6195affc25c98b63564cbfea0020132729209dd76180b01fa96645a6c25fe2ef"
+      "sha256": "2e684504983e2b9488ffc885a018832883395fd8b0b9beadf4cd6f30e73d06bf"
     },
     {
       "path": ".claude/stages/workflow-router.yaml",
@@ -528,7 +528,7 @@
     },
     {
       "path": ".claude/workflows/interview-to-knowledge.yaml",
-      "sha256": "ba7178a7459025e9fa003cc9b0f3318ec0dc7f0b0bda89114d69723028398d47"
+      "sha256": "8f858613592282504701141d65c36cc44c82d4ea47c14b890db90559a30f9e9c"
     },
     {
       "path": ".claude/workflows/oss-first-design.yaml",
@@ -540,7 +540,7 @@
     },
     {
       "path": ".version-bump.json",
-      "sha256": "9050ff12f124a1b2579d975e90b2669b2893444c7086118801977fc3c53d4612"
+      "sha256": "19c15c1eae8c4e4a1062f0e82bdbf4201910f6fd9a42019a0627fa7e41061546"
     },
     {
       "path": "CLAUDE.md",
@@ -556,15 +556,15 @@
     },
     {
       "path": "README.en.md",
-      "sha256": "ffdd23fd7d0c3c915c370204a2946c795f86d0daf4b2d25dd8625b6569c18bf8"
+      "sha256": "12325801ae226d0dfa825b66cae2fb48758af0c979d890f56f7447fa1be8b89b"
     },
     {
       "path": "README.md",
-      "sha256": "ed869d2870af28080f376572576b62d70a3f73fcd8dd44f86f41de754d7a8df8"
+      "sha256": "8b5427ce20877fddd96a763f50841bf91706e0611e22320fd255dbc19d72e66d"
     },
     {
       "path": "RELEASE.md",
-      "sha256": "027304754761c791630b61d474b03b703adf5faf97da990850c6976cdf10801d"
+      "sha256": "a4d72d108a6f676a48392327bab1a5b88b40eaf3c8eec581d3866705f3994942"
     },
     {
       "path": "SKILL.md",
@@ -776,7 +776,7 @@
     },
     {
       "path": "scripts/validate_stage.py",
-      "sha256": "ad154306596c82d9436d282c7e10484a43d6814b5a90fe8b458643a371edec7a"
+      "sha256": "45259fce089fb9fc72df5b1a1c00a3c782008662e9de551aff45aff44a732019"
     },
     {
       "path": "tools/lincoln-installer/.gitignore",
@@ -788,7 +788,7 @@
     },
     {
       "path": "tools/lincoln-installer/package.json",
-      "sha256": "a47d678d0f5390965c9d2125e4c9335b81b42bbf654a7f2b8c95ad34fb6a2ee8"
+      "sha256": "8af7b6ee0dc6da02d47413495af0b8f042d90ffb0a79c46e8bce5c6dafb19671"
     },
     {
       "path": "tools/lincoln-installer/src/cli.tsx",
@@ -1072,11 +1072,11 @@
     },
     {
       "path": "tools/lincoln/package-lock.json",
-      "sha256": "5f41e5b6fe2347030a6ea415667bfbddfb854c6bca10fe024fe9aafd4d452fdb"
+      "sha256": "5156ad816f5a4eb0ea354943b74af393c2586878bf5b64a1ab228bb6cae98ae4"
     },
     {
       "path": "tools/lincoln/package.json",
-      "sha256": "da52cdabdf3af3fc189466ba555b77c0b698075288600e6f29d56a85bb64decd"
+      "sha256": "6631b2928992358105633a0e0b4c693c40e40fbd73757f74a39dc8bd2302165e"
     },
     {
       "path": "tools/lincoln/src/cli.tsx",

package/framework/scripts/validate_stage.py

@@ -324,37 +324,82 @@ def check_portal_index_fresh() -> None:
 # ---------------------------------------------------------------------------
 
 
+# 递进骨架（issue-129）：版本说明 → 修订记录 → 功能列表 → 需求展开。
+# 章节编号不参与匹配，PM 可按需求类型在骨架内增插业务章节。
 REQUIRED_PRD_SECTIONS = [
-    "## 1. 需求背景",
-    "## 2. 用户故事",
-    "## 3. 功能拆解",
-    "## 4. 业务流程图",
-    "## 5. 验收标准",
-    "## 6. 业务规则",
-    "## 7. 非功能需求",
-    "## 8. 关联系统/接口",
-    "## 9. 相关产物链接",
-    "## 10. 风险与开放问题",
+    "版本说明",
+    "修订记录",
+    "功能列表",
+    "需求背景",
+    "用户故事",
+    "功能拆解",
+    "业务流程图",
+    "验收标准",
+    "业务规则",
+    "非功能需求",
+    "关联系统/接口",
+    "相关产物链接",
+    "风险与开放问题",
 ]
 
+PRD_SECTION_PATTERNS = [
+    (name, re.compile(rf"^##\s*(?:\d+\s*[.、．]?\s*)?{re.escape(name)}\s*$", re.MULTILINE))
+    for name in REQUIRED_PRD_SECTIONS
+]
+
+# PRD 正文禁则：过程性疑问在对话中解决，技术内容归归档页（issue-129 第 4/6 条）。
+PRD_FORBIDDEN_PROCESS_RE = re.compile(r"待确认|待人类|待补充|待\s*PM|TODO|FIXME", re.IGNORECASE)
+PRD_FORBIDDEN_TECH_HEADING_RE = re.compile(
+    r"^##+\s*.*(技术调研|技术方案|可行性研究|架构设计|接口设计|数据库设计)",
+    re.MULTILINE,
+)
+
+CROSS_VALIDATION_PASS_RE = re.compile(
+    r"<!--\s*cross-validation:\s*pass\s+prd-version:\s*(v\d+\.\d+)\s*-->"
+)
+
+
+def _read_prd_text(target: Path) -> str:
+    if target.suffix == ".html":
+        return extract_html_markdown(target)
+    return target.read_text(encoding="utf-8")
+
+
+def _prd_hygiene_violations(text: str) -> list[str]:
+    violations = sorted(set(PRD_FORBIDDEN_PROCESS_RE.findall(text)))
+    violations.extend(sorted(set(PRD_FORBIDDEN_TECH_HEADING_RE.findall(text))))
+    return violations
+
 
 def check_prd_has_required_sections(path: str) -> None:
     target = PROJECT_ROOT / path
     if not target.exists():
         fail(f"PRD missing: {target}")
 
-    if target.suffix == ".html":
-        text = extract_html_markdown(target)
-    else:
-        text = target.read_text(encoding="utf-8")
+    text = _read_prd_text(target)
 
-    missing = [section for section in REQUIRED_PRD_SECTIONS if section not in text]
+    missing = [name for name, pattern in PRD_SECTION_PATTERNS if not pattern.search(text)]
     if missing:
         fail(f"PRD missing required sections: {', '.join(missing)}")
 
     pass_check("PRD has all required sections")
 
 
+def check_prd_content_hygiene(path: str) -> None:
+    target = PROJECT_ROOT / path
+    if not target.exists():
+        fail(f"PRD missing: {target}")
+
+    violations = _prd_hygiene_violations(_read_prd_text(target))
+    if violations:
+        fail(
+            "PRD contains content that belongs in conversation or archived pages, "
+            f"not the PRD: {', '.join(violations)}"
+        )
+
+    pass_check("PRD content hygiene OK")
+
+
 def check_prd_snapshot_present(path: str) -> None:
     target = PROJECT_ROOT / path
     if not target.exists():
@@ -374,6 +419,40 @@ def check_prd_snapshot_present(path: str) -> None:
     pass_check(f"PRD snapshot present: {snapshot_path}")
 
 
+def check_prd_cross_validated(path: str) -> None:
+    target = PROJECT_ROOT / path
+    if not target.exists():
+        fail(f"Cross-validation report missing: {target}")
+
+    match = CROSS_VALIDATION_PASS_RE.search(_read_prd_text(target))
+    if not match:
+        fail(
+            "Cross-validation report has no pass marker. Every gap must be closed by a "
+            "human-PM decision (PRD fix with re-freeze, or accepted with recorded "
+            "rationale) before adding '<!-- cross-validation: pass prd-version: vX.Y -->'."
+        )
+
+    prd_path = target.parent / "prd.html"
+    if not prd_path.exists():
+        fail(f"PRD missing next to cross-validation report: {prd_path}")
+
+    prd_version = _extract_document_version(prd_path)
+    if prd_version != match.group(1):
+        fail(
+            f"Cross-validation pass marker is for PRD {match.group(1)}, but the PRD is now "
+            f"{prd_version or 'unversioned'}. Re-run cross-validation against the current PRD."
+        )
+
+    violations = _prd_hygiene_violations(_read_prd_text(prd_path))
+    if violations:
+        fail(
+            f"PRD regressed after cross-validation pass: {', '.join(violations)}. "
+            "Fix the PRD, bump its version, re-freeze, and re-run cross-validation."
+        )
+
+    pass_check(f"PRD cross-validation pass marker matches PRD {prd_version}")
+
+
 # ---------------------------------------------------------------------------
 # Registry
 # ---------------------------------------------------------------------------
@@ -397,6 +476,8 @@ EXIT_CHECKS = {
     "handoff_versions_match": check_handoff_versions_match,
     "prd_has_required_sections": check_prd_has_required_sections,
     "prd_snapshot_present": check_prd_snapshot_present,
+    "prd_content_hygiene": check_prd_content_hygiene,
+    "prd_cross_validated": check_prd_cross_validated,
     "portal_index_exists": check_portal_index_exists,
     "artifact_meta_complete": check_artifact_meta_complete,
     "ids_valid": check_ids_valid,

package/framework/tools/lincoln/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@sushanglewis/lincoln",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@sushanglewis/lincoln",
-      "version": "1.8.3",
+      "version": "1.8.4",
       "license": "MIT",
       "dependencies": {
         "ink": "^5.2.0",

package/framework/tools/lincoln/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sushanglewis/lincoln-recorder",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "Cross-tool terminal UI for recording Lincoln interviews",
   "type": "module",
   "main": "./dist/index.js",

package/framework/tools/lincoln-installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lincoln-install",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "Terminal TUI installer for the Lincoln AI-Native R&D workflow system",
   "type": "module",
   "main": "dist/main.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sushanglewis/lincoln",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "Global Lincoln agent harness plugin CLI",
   "type": "module",
   "main": "./dist/index.js",