create-yss-spec 3.0.0 → 3.1.0

package/template/docs/process/templates/context-reconciliation-template.yaml

@@ -0,0 +1,18 @@
+schema_version: 1
+repository_mode: project-instance
+stage: stage.discovery
+work_unit: work-unit.discovery-requirements
+status: reconciled
+context_snapshot:
+  context_ref: CONTEXT.md
+  context_schema_version: 1
+  document_digest: sha256:<current-normalized-context-digest>
+  referenced_terms_digest: sha256:<digest-of-referenced-terms>
+  term_refs: []
+changes:
+  added: []
+  updated: []
+  deprecated: []
+unresolved_terms: []
+evidence_refs:
+  - CONTEXT.md

package/template/docs/process/templates/frontend-implementation-plan-template.yaml

@@ -1,15 +1,21 @@
-schema_version: 1
+schema_version: 2
 kind: plan
 template: true
 status: draft
-prototype_ref: docs/.scratch/example/design/prototype.html
+prototype_ref: docs/.scratch/example/design/prototypes/index.html
 spec_ref: docs/.scratch/example/spec.md
+visual_baseline:
+  baseline_id: visual-baseline.example
+  version: v1
+  digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+  manifest_ref: docs/.scratch/example/handoff/visual-baseline-v1/visual-baseline.yaml
+  status: approved
+  case_ids: [primary-desktop, primary-narrow]
 route_and_page_inventory:
   - route: /example
     page: ExamplePage
-visual_acceptance_cases:
-  - primary desktop flow
-  - narrow viewport flow
+    case_ids: [primary-desktop, primary-narrow]
+baseline_case_ids: [primary-desktop, primary-narrow]
 desktop_viewport: 1440x900
 narrow_viewport: 390x844
 state_cases: [loading, empty, error, permission, selected, key-interaction]

package/template/docs/process/templates/frontend-implementation-verification-template.yaml

@@ -1,21 +1,41 @@
-schema_version: 1
+schema_version: 2
 kind: verification
 template: true
 status: draft
-prototype_ref: docs/.scratch/example/design/prototype.html
+prototype_ref: docs/.scratch/example/design/prototypes/index.html
 spec_ref: docs/.scratch/example/spec.md
+visual_baseline:
+  baseline_id: visual-baseline.example
+  version: v1
+  digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+  manifest_ref: docs/.scratch/example/handoff/visual-baseline-v1/visual-baseline.yaml
+  status: approved
+  case_ids: [primary-desktop, primary-narrow]
 route_and_page_inventory:
   - route: /example
     page: ExamplePage
-desktop_visual_evidence: [docs/.scratch/example/verification/desktop.png]
-narrow_view_visual_evidence: [docs/.scratch/example/verification/narrow.png]
+    case_ids: [primary-desktop, primary-narrow]
+case_results:
+  - case_id: primary-desktop
+    baseline_image_ref: docs/.scratch/example/handoff/visual-baseline-v1/images/primary-desktop.png
+    implementation_image_ref: docs/.scratch/example/verification/images/primary-desktop.png
+    diff_ref: docs/.scratch/example/verification/diffs/primary-desktop.png
+    mask_ref: not-applicable
+    result: blocked
+    uncovered_difference: false
+    explanation: <difference-or-not-applicable>
 interaction_results: [loading, empty, error, permission, selected, key-interaction]
 console_warning_check: blocked
 pnpm_commands: [pnpm lint, pnpm type-check, pnpm test]
+actual_verification:
+  - command: pnpm test
+    exit_code: 0
+    executed_at: <iso-8601>
+    evidence_ref: docs/.scratch/example/verification/pnpm-test.txt
 uncovered_differences: []
 difference_owner: null
 independent_review:
   reviewer: non-implementer
-  candidate_digest: pending
+  candidate_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
   status: pending
   findings_ref: docs/.scratch/example/verification/ui-fidelity-review.md

package/template/docs/process/templates/lifecycle-checkpoint-template.yaml

@@ -1,9 +1,15 @@
 schema_version: 1
+repository_mode: project-instance
 mode: route
 status: routing
 stage: stage.entry-triage
 artifacts: {}
 gates: {}
+context_reconciliation:
+  status: pending
+  ref: null
+  reason: 等待当前工作单元完成稳定术语回写与核对
+  evidence_refs: []
 next_work_unit: work-unit.discovery-opportunity
 phase_boundary:
   decision: continue
@@ -21,6 +27,9 @@ verification:
   commands: []
   evidence_refs: []
 human_review:
+  user_decisions: []
+  required_decisions: []
+  not_applicable: []
   required: false
   status: not-applicable
 git_checkpoint:

package/template/docs/process/templates/scaffold-architecture-decisions-template.yaml

@@ -0,0 +1,32 @@
+schema_version: 1
+kind: scaffold-architecture-decisions
+template: true
+status: draft
+decisions:
+  - decision_id: scaffold-decision.main-service
+    project_id: main-service
+    parent_project_id: null
+    status: awaiting-user-decision
+    recommended_architecture: domain-driven
+    recommendation_reasons:
+      - 存在聚合不变量或复杂状态转换
+    confirmed_architecture: null
+    override_reason: null
+    inheritance_mode: root-default
+    inherited_from: null
+    platform_profile: spring-boot-2.7-jdk8
+    architecture_profile: target-domain-model
+    verification_database: h2
+    production_database: not-bound
+    requested_capabilities: []
+    resolved_modules: [domain, application, infrastructure, adapter, bootstrap]
+    resolution_version: 1
+    user_confirmation:
+      user_decision_ref: null
+      decision_subject_ref: null
+      confirmed_by: null
+      channel: null
+      confirmation_ref: null
+      confirmed_at: null
+      normalized_text: null
+    decision_inputs_digest: sha256:0000000000000000000000000000000000000000000000000000000000000000

package/template/docs/process/templates/stage-checkpoint-template.md

@@ -2,6 +2,7 @@
 
 ```yaml
 schema_version: 1
+repository_mode: <template-source|project-instance>
 mode: <route|orchestrate|resume|audit>
 status: <routing|running|paused-human-gate|blocked|completed>
 stage: <lifecycle stage>
@@ -16,6 +17,10 @@ gates:
     reason: <why this status applies>
     evidence_refs: []
     approval_ref: <docs/.scratch/<feature>/gates/<gate-id>-approval.yaml when approved countersign gate>
+context_reconciliation:
+  status: <pending|reconciled|not-applicable|blocked>
+  ref: <docs/.scratch/<feature>/evidence/context-reconciliation-<work-unit>.yaml>
+  evidence_refs: [CONTEXT.md]
 phase_boundary:
   decision: <continue|clear|handoff|subagent|compact>
   reason: <decision evidence>

package/template/docs/process/templates/user-decision-template.yaml

@@ -0,0 +1,30 @@
+# 待填写模板；不是批准证据。原始来源字段必须由真实消息提取。
+schema_version: 1
+kind: user-decision
+request:
+  id: <request-id>
+  requester_ref: <提问者原始身份>
+  requester_source:
+    kind: session-export
+    ref: <原始请求捕获文件>
+    digest: <sha256>
+    message_id: <原始消息ID>
+  items:
+    - id: <item-id>
+      boundary: <引用 user_decision_policy 中的门禁或决定类型>
+      title: <可审阅决定>
+      subject: {ref: <资产正文或冻结快照>, version: <version>, digest: <sha256>}
+      basis: []
+      scope: [<批准范围>]
+      changes: <关键变化>
+      risks: []
+      recommendation: <推荐方案>
+      next_actions: [<批准后将执行的动作>]
+      responder_ref: <提问者或其明确指定的负责人>
+      # 指定其他负责人时追加 delegation_source，与 requester_source 同形状。
+  presented_source:
+    kind: session-export
+    ref: <完整展示请求的原始消息捕获>
+    digest: <sha256>
+    message_id: <原始消息ID>
+responses: [] # 收到真实回复后追加；无回复永不预填 approved。

package/template/docs/templates/approval-record-template.yaml

@@ -12,3 +12,7 @@ countersigner_role_ids:
 evidence_refs: []
 biological_veto: false
 notes: 会签必须可读取；起草者不得出现在 countersigner_role_ids。运行时表情/reaction 无效。
+# 关键门禁正式放行时必填；模板/历史结构校验不构成批准。
+subject_ref: null
+approval_scope: []
+user_decision_ref: null

package/template/docs/templates/build-architecture-checklist-template.md

@@ -19,8 +19,8 @@ owner: ai
 | 系统 / 数据架构设计 |  |  |
 | 风险 / 回滚约束 | `AGENTS.md` |  |
 | Slice Implementation Contract |  | 填写 contract_id / contract_version / 生命周期批准状态 |
-| 后端脚手架策略 | `orchestration-contract.yaml` / `yss-ddd-scaffold-generator` |  | backend `scaffold_status=required` 时填写结构化合同身份、批准/持久化引用、生成器输入、预期文件、实际 `./mvnw` 结果和后置 Router 重编译 |
-| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / Router Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
+| 后端脚手架策略 | `orchestration-contract.yaml` / DDD 或 Layered MVC 生成器 |  | backend `scaffold_status=required` 时填写 architecture decision、schema v3 合同身份、批准/持久化引用、生成器输入、Manifest v3、实际 `./mvnw` 结果和后置实现合同编译器重编译 |
+| 工程项目路径策略 | `docs/process/implementation-repo-integration.md` / 实现合同编译器 Contract |  | Harness 内必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 仅为容器，`app/backend/`、`app/frontend/` 及其子路径阻断 |
 | 垂直切片工作单元 |  |  |
 | YSS Skill Execution Result |  | 每个 skill / work_unit 的结果文件引用 |
 
@@ -30,9 +30,9 @@ owner: ai
 |---|---|---|---|---|---|
 | DDD 分层不得穿透：Domain 不依赖 Adapter、Infrastructure、Mapper、Controller 或 Web DTO | 系统架构 / YSS DDD 规范 / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 若发现穿透依赖，标记 `violation` 并停止 build，回到架构修正 |
 | 后端切片必须回勾 `Backend Slice Implementation Contract`：required skills、允许写范围、禁止模式、证据文件、延期 seam 和验证命令完整 | implementation routing / 垂直切片 Ticket / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺合同或合同不完整时暂停并记录替代方案 |
-| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，Router 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
-| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 Router |
-| 原型确认后的后端脚手架顺序：工程基线 → Router 脚手架合同 draft / 生命周期批准 → `yss-ddd-scaffold-generator` → `yss-backend-scaffold-parent` → Router 重编译；脚手架不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
+| 统一合同版本：实现消费的 contract_id / contract_version 与生命周期批准并持久化的版本一致，实现合同编译器 未自行批准合同或推进 `ready-for-agent` | Slice Implementation Contract / 生命周期证据 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 版本不一致时将工作单元标记 `stale` 并暂停 build |
+| 合同子项闭环：Common、Frontend、Backend、Contract、Cross-repo 子合同按影响面填写，不适用项有原因 | Slice Implementation Contract |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺失适用子合同时回到 实现合同编译器 |
+| 后端脚手架顺序：工程基线与 Agent 推荐 → 用户确认并持久化 architecture decision → schema v3 合同 draft / 生命周期批准 → DDD 或 Layered MVC 生成器 → 对应基线与 Manifest v3 校验 → 实现合同编译器重编译；生成器无交互且不得生成业务行为 | `yss-product-lifecycle` / `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 选择缺失、digest 漂移、顺序缺失、生成器混入业务行为或缺 Execution Result 时阻断 |
 | 写路径与证据：Execution Result 的 changed_files 均位于 allowed_write_paths，expected_evidence_files 已实际生成 | Slice Implementation Contract / YSS Skill Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径越界或证据缺失标记 `violation` 并阻断 build |
 | TDD 模式：每个工作单元唯一选择 `behavior-tdd` 或 `controlled-generation`；生成器未承载状态、权限、业务过滤、事务、错误映射或用户可见交互 | Slice Implementation Contract / 垂直切片 Ticket / Execution Result |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 模式不匹配时拆分工作单元并完整重路由 |
 | 所有后续生成代码：必须消费当前批准合同、主 YSS skill、依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result；业务行为使用 `behavior-tdd` | `post_scaffold_generated_code_policy` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺任一条件或以时间压力豁免时阻断 build |
@@ -42,12 +42,12 @@ owner: ai
 | Application：负责用例编排、事务边界和跨聚合协调，不承载核心领域规则 | `yss-application` / 系统架构 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 领域规则下沉 Domain，事务边界留在 Application |
 | Infrastructure：需要持久化的切片必须有 PO / Repository / Convertor / GatewayImpl；`InMemory*Gateway` 只能作为显式 `seam-deferred` | `yss-repository` / 数据架构 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 未补齐时不得声称生产持久化完成 |
 | POJO / Convertor：DTO / VO / CMD / Query / PO / Domain Model 样板代码默认使用 Lombok；对象转换默认使用 MapStruct，禁止 `BeanUtils.copyProperties`、反射拷贝和重复手写字段赋值 | `lombok` / `mapstruct` / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 未加载 skill、缺注解处理器配置、缺 Convertor 或无例外说明时标记 `violation` |
-| 后端工程工具链：构建、测试、运行、OpenAPI 生成、CI 和 Release 命令必须使用项目根目录 `./mvnw ...`；裸 `mvn ...` 必须有受控例外记录 | `yss-ddd-scaffold-generator` / `yss-backend-scaffold-parent` / implementation routing |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 无例外记录时改为 `./mvnw ...`，否则不得进入完成 / 可合并结论 |
+| 后端工程工具链：构建、测试、运行、OpenAPI 生成、CI 和 Release 命令必须使用项目根目录 `./mvnw ...`；裸 `mvn ...` 必须有受控例外记录 | DDD / Layered MVC 生成器及 implementation routing |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 无例外记录时改为 `./mvnw ...`，否则不得进入完成 / 可合并结论 |
 | 工程项目路径：每个 Harness 内项目必须有具体项目段，禁止直接写入容器根或单数 `app/...` | `docs/process/implementation-repo-integration.md` / implementation path validator |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 路径违规时停止 build，并回到实现路由 |
 | 文档语言：持久化生命周期文档、实施记录、审查报告、发布说明和 Git checkpoint 正文必须使用中文，英文 skill / 模板不得原样落地 | `AGENTS.md` / `yss-product-lifecycle` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 仅保留必要英文技术标识、命令和 metadata |
 | 高风险变更：按已批准的普通影响面结论记录验证证据、责任人和回滚约束 | `AGENTS.md` / Spec / 架构记录 |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺验证证据或责任人时不得发布或合并 |
 | 质量基线：`baseline_id` / `baseline_version` 只从 `engineering-baseline` 引用，Slice、Execution Result、审查和发布不得重复定义 | `engineering-baseline` / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺少基线引用或出现重复标准时阻断并回到工程基线 |
-| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | Router Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
+| Doubt-Driven：命中 API、数据、跨仓、发布回滚、实际安全行为或生命周期 / 生成语义时具备主张、反证、证据、残余风险和审查引用 | 实现合同编译器 Contract / `orchestration-contract.yaml` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 缺反证、证据不足或残余风险未处理时阻断 |
 |  |  |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  |  |
 
 状态说明：

package/template/docs/templates/implementation-repo-registry-template.md

@@ -28,7 +28,9 @@ owner: ai
 | superproject_git_url | 父仓远端；必须与 `git_url` 不同 |
 | checkout_state | attached-branch / detached-head / uninitialized / empty-gitlink / 不适用 |
 | scaffold_status | existing / required / initialized |
-| scaffold_skill | `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` / none |
+| scaffold_architecture | `domain-driven` / `layered-mvc` / 不适用；required 时必须由用户确认 |
+| scaffold_decision_ref | `scaffold-architecture-decisions.yaml` 的 decision_id + digest |
+| scaffold_skill | `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` / `yss-frontend-scaffold-generator` / none |
 | scaffold_target_confirmed | 是 / 否 / 不适用 |
 | target_git_url_or_output_dir |  |
 | owner |  |

package/template/docs/templates/implementation-routing-template.md

@@ -9,7 +9,7 @@ owner: ai
 
 > 适用场景：Spec、OpenAPI Freeze / 无 API 影响记录、Design Review 和垂直切片 Ticket 已就绪后，进入实现前。
 > 本文记录契约状态、Ticket 状态、YSS skill 最小集合、测试策略和回滚点，不替代垂直切片 Ticket 或实施计划。
-> Router 只能生成 `draft`、`blocked` 或 `ready-for-lifecycle-review`；不得自行写入 `approved`、`ready-for-agent` 或 `completed`。合同批准、持久化和 Ticket 状态推进由生命周期编排器负责。
+> 实现合同编译器 只能生成 `draft`、`blocked` 或 `ready-for-lifecycle-review`；不得自行写入 `approved`、`ready-for-agent` 或 `completed`。合同批准、持久化和 Ticket 状态推进由生命周期编排器负责。
 
 ## 1. 输入材料
 
@@ -40,7 +40,7 @@ owner: ai
 | Harness 内项目根路径符合 `apps/<backend|frontend>/<project>/` | 是 / 否 / 不适用 | `apps/backend/`、`apps/frontend/` 仅为容器 |
 | 未使用 `app/backend/`、`app/frontend/` 及其子路径 | 是 / 否 / 不适用 | 命中即阻断生成和实现 |
 | 原型确认后先完成后端脚手架，再进入业务代码路由 | 是 / 否 / 不适用 | `backend_scaffold_policy_satisfied` |
-| 后端脚手架合同字段完整且版本当前 | 是 / 否 / 不适用 | schema v2：`scaffold_request_id`、项目/输出目录、Router draft、生命周期批准、base package、Maven 坐标、target DDD/Profile、initialize-only、允许写路径、预期证据、验证命令 |
+| 后端脚手架合同字段完整且版本当前 | 是 / 否 / 不适用 | schema v2：`scaffold_request_id`、项目/输出目录、实现合同编译器 draft、生命周期批准、base package、Maven 坐标、target DDD/Profile、initialize-only、允许写路径、预期证据、验证命令 |
 | 后端构建 / 测试 / OpenAPI / CI 命令均使用项目根目录 `./mvnw ...`，或已记录受控例外 | 是 / 否 / 不适用 | 裸 `mvn ...` 默认为规范偏离 |
 | 持久化文档正文和章节标题已转换为中文，仅保留必要英文技术标识 / metadata | 是 / 否 | 英文 skill / 模板不得原样落地为交付文档 |
 | YSS skill 路由已完成 | 是 / 否 |  |
@@ -55,7 +55,7 @@ owner: ai
 | contract_version |  |
 | slice_id |  |
 | status | `draft` / `blocked` / `ready-for-lifecycle-review` |
-| compiled_by | `yss-router` |
+| compiled_by | `yss-implementation-contract-compiler` |
 | 生命周期批准状态 | pending / approved / rejected；由生命周期编排器填写 |
 | 合同持久化路径 |  |
 
@@ -142,6 +142,8 @@ owner: ai
 | required_skills |  |
 | approved_prototype_ref |  |
 | state_matrix_ref |  |
+| visual_baseline_ref | `visual-baseline.yaml` 路径、版本与 digest |
+| visual_baseline_case_ids | 当前切片实际消费的 case_id；禁止目录 glob |
 | generated_api_client_ref |  |
 | allowed_write_paths |  |
 | component_test_seams | loading / empty / error / permission / 其他公开 seam |
@@ -224,7 +226,7 @@ owner: ai
 
 | 受影响端 | 是否已有可用工程 | scaffold_status | 目标是否确认 | 处理结论 | 使用 skill | 输出位置 / 仓库 | 备注 |
 |---|---|---|---|---|---|---|---|
-| backend | 是 / 否 / 不适用 | existing / required / initialized / not-applicable | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-ddd-scaffold-generator` / none |  |  |
+| backend | 是 / 否 / 不适用 | existing / required / initialized / not-applicable | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` / none |  | 填写 architecture_family、decision_id 与 digest |
 | frontend | 是 / 否 / 不适用 | existing / required / initialized / not-applicable | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-frontend-scaffold-generator` / none |  |  |
 
 脚手架输出位置必须回指具体项目根：后端为 `apps/backend/<project>/`，前端为 `apps/frontend/<project>/`；不得把 `apps/backend/`、`apps/frontend/` 容器根或任何 `app/backend/`、`app/frontend/` 路径作为生成目标。
@@ -238,20 +240,20 @@ owner: ai
 
 ### 4.3 后端脚手架工作单元
 
-当 backend `scaffold_status=required` 时，先登记一个 `controlled-generation` 工作单元：`primary_skill=yss-ddd-scaffold-generator`，并在后续追加 `yss-backend-scaffold-parent` 基线校验和 `yss-router` 合同重编译。`existing` / `initialized` 不重复全量生成，但必须提供等价基线和 Wrapper 证据。
+当 backend `scaffold_status=required` 时，生命周期先按领域复杂度推荐 DDD/MVC，并以批量决策表反问用户确认本体默认与子项目覆盖。选择写入 `scaffold-architecture-decisions.yaml`；缺失、未确认或 stale 时阻断。随后登记一个 `controlled-generation` 工作单元：`domain-driven` 使用 `primary_skill=yss-ddd-scaffold-generator`，`layered-mvc` 使用 `primary_skill=yss-layered-mvc-scaffold-generator`。生成后执行对应基线校验和 `yss-implementation-contract-compiler` 合同重编译。`existing` / `initialized` 不重复生成，架构转换另立迁移工作单元。
 
 | 项 | 内容 |
 |---|---|
-| 前置 | `prototype_confirmation`、工程基线、实现仓库和脚手架目标已确认；Router 脚手架合同 draft 已经生命周期批准并持久化为结构化 JSON，生成器通过 `--contract-file` 消费 |
-| 生成器 | `yss-ddd-scaffold-generator` |
+| 前置 | `prototype_confirmation`、工程基线、实现仓库和脚手架目标已确认；`scaffold-architecture-decisions.yaml` 已由用户确认且 digest 当前；实现合同编译器 schema v3 脚手架合同 draft 已经生命周期批准并持久化为结构化 JSON，生成器通过 `--contract-file` 消费 |
+| 生成器 | `domain-driven` → `yss-ddd-scaffold-generator`；`layered-mvc` → `yss-layered-mvc-scaffold-generator` |
 | 模式 | `controlled-generation` |
 | Java / Maven 身份 | `base_package` 与 Maven `group_id` 分开登记；项目版本、父 POM GAV、`yss-components.version` 进入批准合同并原样传给 CLI |
-| 允许生成 | Domain / Application / Infrastructure / Adapter / Bootstrap 目录骨架、POM、配置、Wrapper 和非业务机械模板 |
+| 允许生成 | DDD 的 Domain / Application / Infrastructure / Adapter / Bootstrap，或 MVC 的 server / service / repository 与能力解析出的 adapter / client / feign-client；以及 POM、配置、Wrapper 和非业务机械模板 |
 | 禁止生成 | 业务规则、状态机、权限、事务、复杂查询、错误映射、业务字段和用户可见行为 |
 | 生成选项 | 关闭 `--with-example`；生成器严格 initialize-only，非空目录、`--force`、旧项目迁移和当前模板升级均为 `unsupported` |
-| Profile | `target-domain-model` / `mybatis-plus` / `mysql` / `spring-boot-2.7-jdk8` / `javax` / `web` / `yss-internal`；其他组合须先通过独立 fixture |
+| Profile | DDD：`target-domain-model` + MySQL；MVC：`layered-mvc` + MySQL/Oracle/OceanBase Oracle；共同固定 Spring Boot 2.7 / Java 8 / `javax` / MyBatis-Plus，其他组合须先通过独立 fixture |
 | 验证 | 使用一键生成验证入口，实际执行项目根目录 `./mvnw validate`、`./mvnw test`、`./mvnw package`；通过后仅为 `empty-scaffold-verified`，golden first slice 通过后才是 `first-slice-verified` |
-| 后置 | `yss-backend-scaffold-parent`、`yss-router` 业务合同重编译、YSS Skill Execution Result |
+| 后置 | `yss-backend-scaffold-parent`、`yss-implementation-contract-compiler` 业务合同重编译、YSS Skill Execution Result |
 
 所有后续生成代码必须绑定当前批准且版本一致的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 Execution Result。业务行为必须使用 `behavior-tdd`；缺任一条件即阻断，不得以脚手架成功或时间压力豁免。
 
@@ -324,7 +326,7 @@ owner: ai
 
 - [ ] 垂直切片 Ticket 完整，且状态允许进入实现。
 - [ ] 统一合同包含 `contract_id` / `contract_version`、Common、Frontend、Backend、Contract 和 Cross-repo 子合同；不适用项均有原因。
-- [ ] 生命周期编排器已批准并持久化合同；Router 没有自行给出 `approved` 或 `ready-for-agent`。
+- [ ] 生命周期编排器已批准并持久化合同；实现合同编译器 没有自行给出 `approved` 或 `ready-for-agent`。
 - [ ] YSS skills 已最小化选择，没有绕过 Ticket、OpenAPI Freeze / 无 API 影响记录或必要的 Spec Delta。
 - [ ] 后端切片如适用，已填写 `Backend Slice Implementation Contract`，并且 required skills、禁止模式、证据文件、延期 seam 和验证命令完整。
 - [ ] 受影响外部实现仓库已登记，并绑定分支、MR / PR、CI 和验证命令。
@@ -340,7 +342,7 @@ owner: ai
 
 ## 9. 下一步门禁
 
-- Router 结论：draft / blocked / ready-for-lifecycle-review
+- 实现合同编译器 结论：draft / blocked / ready-for-lifecycle-review
 - 生命周期编排器结论：approved / rejected / pending
 - 下一步：生命周期合同审查 / TDD 实现 / 完整重路由 / Architecture Re-check / 回到 系统 / 数据架构设计 / 回到垂直切片
 - 阻断项：

package/template/docs/templates/requirement-freeze-template.md

@@ -17,7 +17,7 @@ owner: ai
 | Spec 初稿 |  |  |  |
 | 产品总体设计 / 功能架构 |  |  | 必需 |
 | 产品设计 / 交互说明 |  |  |  |
-| 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |  | 有 UI 时必需；Ant Design v6 主题/视觉标准 + schema v2 语义映射/浏览器/无障碍证据，生产 API 为 YSS UI + Ant Design Vue 4.x |
+| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL |  | 有产品设计影响时必需；按 H1/H2 档位提供 Prototype Evidence schema v4、Visual Baseline schema v1、浏览器、Design QA 与条件 AntD 事实；真实组件待验事项进入前端实现计划 |
 | Prototype Review |  |  |  |
 | CONTEXT 术语 |  |  | 业务术语须含 PascalCase `英文标识` |
 
@@ -51,7 +51,7 @@ owner: ai
 
 ## 6. 完成标准
 
-- [ ] Spec 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和高保真 HTML 原型暴露的阻断项。
+- [ ] Spec 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和原型交付物暴露的阻断项。
 - [ ] 本轮做什么、不做什么、延后什么已经明确。
 - [ ] OpenAPI、工程基线、系统架构、数据架构、风险影响已有明确结论。
 - [ ] 可进入 API 影响分析 / 契约草案 / 工程基线，或阻断项已列出。

package/template/docs/templates/review-report-template.md

@@ -23,11 +23,11 @@ Approved / Changes requested / Blocked
 
 ## Slice Implementation Contract 审查
 
-> 按 Router 生成条件对称核验合同和执行结果。Reviewer 不得直接信任实现者自报的 `implemented`。
+> 按 实现合同编译器 生成条件对称核验合同和执行结果。Reviewer 不得直接信任实现者自报的 `implemented`。
 
 | 检查项 | 结论 | 证据 |
 |---|---|---|
-| `contract_id` / `contract_version` 与生命周期批准、持久化版本及 Ticket 引用一致；Router 未自行写入 `approved`、`ready-for-agent` 或 `completed` | pass / violation |  |
+| `contract_id` / `contract_version` 与生命周期批准、持久化版本及 Ticket 引用一致；实现合同编译器 未自行写入 `approved`、`ready-for-agent` 或 `completed` | pass / violation |  |
 | Common、Frontend、Backend、Contract、Cross-repo 子合同按实际影响填写，不适用项均有原因 | pass / violation |  |
 | `required_skills` 依赖闭包与实际影响对称；Application、MapStruct、Lombok、Alibaba 等强制依赖未遗漏 | pass / violation / not-applicable |  |
 | 每个工作单元绑定唯一 `behavior-tdd` 或 `controlled-generation`；业务行为未混入机械生成 | pass / violation |  |
@@ -88,7 +88,7 @@ rg -n "class (SingleResult|MultiResult|PageResult|Result)<|public static class .
 | 检查项 | 结论 | 证据 |
 |---|---|---|
 | `yss-ui` 组件路由已落实：YSS `required` 封装（如 `YTable` / `YTree` / `YFormily`）未被 AntDV 裸组件或其他重型方案绕过；受控回退有能力缺口记录 | pass / violation / not-applicable |  |
-| `yss-ui-business-page-generation` 页面生成与 `yss-page-module-development` 生命周期编排已落实：`index.vue` 只编排，请求与分页不堆在页面根组件 | pass / violation / not-applicable |  |
+| `yss-ui-business-page-generation` 页面生成与生命周期编排已落实：`index.vue` 只编排，请求与分页不堆在页面根组件 | pass / violation / not-applicable |  |
 | 切片合同 `required_skills` 中的 Formily / 表格 / 树 / 高度 / 主题 / API 专项 skill 已按影响面引用规则；未命中项有 `not-applicable` 原因 | pass / violation / not-applicable |  |
 | 前端验证使用项目根 `pnpm ...`；实际退出码已记录。只做 type-check 或声称“已对齐”不算通过 | pass / violation / not-applicable |  |
 | 机器检查（`pnpm lint` / `pnpm type-check` 等已存在脚本）已执行，或缺失工具已写 `not-applicable` 及原因 | pass / violation / not-applicable |  |
@@ -125,12 +125,12 @@ rg -n "from 'ant-design-vue'|<(Table|Tree|Form)[ >]|YFormily|YssFormily|YTable|Y
 | Agent 修改合同允许路径之外的文件，或缺少预期证据文件 | 应标记为 `violation` 并阻断 build |  |
 | Agent 把状态机、权限、事务或错误映射放入 `controlled-generation` | 应拆分为 `behavior-tdd` 工作单元并触发完整重路由 |  |
 | Agent 使用 `seam-deferred` 却缺少风险、责任人、后续 Ticket、验证计划或目标版本 / 发布日期 | 应标记为 `violation` 并阻断 |  |
-| Agent 返回非空 `new_impacts` 后继续编码或补写旧合同 | 应暂停相关工作单元，将合同标记 `stale`，回到 Router 或更早生命周期阶段 |  |
+| Agent 返回非空 `new_impacts` 后继续编码或补写旧合同 | 应暂停相关工作单元，将合同标记 `stale`，回到 实现合同编译器 或更早生命周期阶段 |  |
 | Agent 只列验证命令但没有实际结果和执行时间 | 不构成 fresh verification，不得给出 Approved / 可合并结论 |  |
 | Agent 用第二个通用审查 skill 代替 `code-review`，或 Standards 未读取合同 `required_skills` / Alibaba / `yss-ui` | 应标记为 `violation` 并阻断完成 |  |
 | Agent 把 YSS 页面模块约定并进 UI fidelity，或适用报告行留空 | 应回到 Standards 专项检查，空白行视为 `missing_evidence` |  |
 | Agent 在审查会话中直接改实现代码以“关掉” finding | 应标记为 `violation`；finding 交实现者在原合同路径修复，再重新捕获候选并全轴复审 |  |
 | Agent 把 `violation` 记为 `not-applicable`，或为日常 Alibaba / YSS 另开生物人豁免门禁 | 应阻断；命中后只允许修复或完整 `seam-deferred`，未命中才 `not-applicable` |  |
-| Agent 发现 `drift` / `new_impacts` / `required_skills` 与真实影响不一致后仍在旧合同上编码 | 应将合同标 `stale`，回 Router 或更早生命周期阶段 |  |
+| Agent 发现 `drift` / `new_impacts` / `required_skills` 与真实影响不一致后仍在旧合同上编码 | 应将合同标 `stale`，回 实现合同编译器 或更早生命周期阶段 |  |
 
 ## 签字确认

package/template/docs/templates/spec-template.md

@@ -51,7 +51,7 @@ owner: ai
 - UI 影响：是 / 否
 - 产品总体设计：`docs/.scratch/<feature>/design/<feature>-product-overview-design.md`
 
-> 只有存在 UI 影响时，才强制低保真页面草图、状态矩阵、高保真 HTML 原型和用户确认；否则记录 `not-applicable` 及原因。
+> 只有存在产品设计影响时，才强制低保真页面草图、状态矩阵、按 H1/H2 路由的原型交付物和用户确认；否则记录 `not-applicable` 及原因。
 
 ## OpenAPI 影响
 
@@ -67,16 +67,16 @@ owner: ai
 |---|---|---|
 | | | |
 
-## DDD 影响判断
+## 业务边界与规则影响判断
 
-> 仅做轻量判断，不新增流程阶段。若均为“否”，后续不需要单独 DDD 设计；若触发边界、模型或一致性变化，在产品总体设计 / 系统概要设计中补齐对应小节。
+> 仅做轻量判断，不新增流程阶段。若均为“否”，后续不需要单独补充业务边界或复杂技术模型设计；若触发责任边界、关键规则、状态或一致性变化，在产品总体设计 / 系统概要设计中补齐对应小节。
 
 | 检查项 | 是 / 否 | 说明 / 处理 |
 |---|---|---|
-| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` 的中文术语和 PascalCase `英文标识` |
-| 是否新增或改变限界上下文 / 模块边界 |  | 需要在产品总体设计中完成 Strategic DDD Check |
+| 是否新增或改变统一业务词汇 / 核心术语 |  | 需要回写 `CONTEXT.md` 的中文术语、PascalCase `英文标识` 和适用业务责任区 |
+| 是否新增或改变业务责任区 / 模块边界 |  | 需要在产品总体设计中完成业务边界与协作检查 |
 | 是否改变上下文间协作关系 |  | 说明上游 / 下游 / 防腐层 / 共享内核关系 |
-| 是否新增或改变聚合、不变量、状态机 |  | 需要在系统概要设计 / 数据架构中完成 Tactical DDD Check |
+| 是否新增或改变关键业务对象、不可违反规则或状态机 |  | 需要在系统概要设计 / 数据架构中完成技术模型检查 |
 | 是否影响 API、权限、数据、审计或风险 / 回滚约束 |  | 进入对应契约、架构或人工审查门禁 |
 
 ## 测试决策

package/template/docs/templates/vertical-slice-ticket-template.md

@@ -51,12 +51,12 @@ Status: ready-for-human
 | contract_id |  |
 | contract_version |  |
 | contract_ref |  |
-| Router 状态 | draft / blocked / ready-for-lifecycle-review |
+| 实现合同编译器 状态 | draft / blocked / ready-for-lifecycle-review |
 | 生命周期批准状态 | pending / approved / rejected |
-| suggested_owner_role_id | `role.frontend-engineer` / `role.backend-engineer` / `role.test-engineer`（Router 建议，编排器派活） |
+| suggested_owner_role_id | `role.frontend-engineer` / `role.backend-engineer` / `role.test-engineer`（实现合同编译器 建议，编排器派活） |
 | Build Architecture Checklist |  |
 
-> Router 不得自行将合同批准或将本 Ticket 推进为 `ready-for-agent`。只有生命周期编排器核验并持久化当前版本合同、清除阻塞边后，才能推进状态。
+> 实现合同编译器 不得自行将合同批准或将本 Ticket 推进为 `ready-for-agent`。只有生命周期编排器核验并持久化当前版本合同、清除阻塞边后，才能推进状态。
 
 ### 工作单元
 
@@ -103,7 +103,7 @@ Status: ready-for-human
 | affected_work_units |  |
 | new_impacts |  |
 | stale_contract_version |  |
-| return_stage | Router / Architecture Re-check / 产品设计 / OpenAPI Draft-Review-Freeze / 系统或数据架构 / other |
+| return_stage | 实现合同编译器 / Architecture Re-check / 产品设计 / OpenAPI Draft-Review-Freeze / 系统或数据架构 / other |
 | recovery_conditions |  |
 
 出现 `drift`、`violation` 或非空 `new_impacts` 时暂停受影响工作单元，不得先完成代码再补合同；更新合同版本并通过生命周期审查后才能恢复。

package/template/docs/user-guide/yss-ui-mcp.md

@@ -5,8 +5,6 @@
 - Claude Code：`.mcp.json`
 - Antigravity：`.agents/mcp_config.json`
 - Cursor：`.cursor/mcp.json`
-- Gemini CLI：`.gemini/settings.json`
-- Kiro：`.kiro/settings/mcp.json`
 - VS Code：`.vscode/mcp.json`
 
 这些配置统一通过 `npx -y @yss-ui/mcp` 启动，不写用户主目录，也不覆盖个人全局配置。首次加载模板后，重启或刷新对应客户端即可发现 MCP。

package/template/docs/user-guide//346/210/230/346/234/257/350/256/276/350/256/241/345/255/220/351/241/271/347/233/256/347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -44,8 +44,9 @@ Strategic Design 解决“业务应该怎样分工和划边界”；Tactical Des
 - Spec、原型或业务级 Ticket 的版本引用；
 - 交给 Tactical Design 裁决的问题，例如聚合边界、状态、一致性和持久化；
 - 未决问题、责任人和后续验证计划。
+- `source_context_snapshot` 与包含术语定义的 `context_delta`，以及“目标仓在 Tactical Design 前完成 `context_reconciliation`”的约束。
 
-如果交接包缺失、过期或与当前 Spec 不一致，先回到上游处理，不要凭经验补写模型。
+先把 `context_delta` 对账到当前项目根目录唯一 `CONTEXT.md`，生成目标侧 reconciliation，并运行 `scripts/verify-strategic-context-import --root . --reconciliation <record> <handoff>`。如果交接包缺失、仍为 v1、过期、摘要漂移或与当前 Spec / 目标词汇不一致，先回到上游处理，不要凭经验补写模型。
 
 ### 确认项目实例
 
@@ -197,6 +198,7 @@ Strategic Design 解决“业务应该怎样分工和划边界”；Tactical Des
 ## 评审前自检
 
 - [ ] 输入来自批准且版本当前的 `Strategic Design Handoff`。
+- [ ] Strategic Design Handoff 为 schema v2，目标根 `CONTEXT.md` 已完成 context delta 对账，`strategic_context_import_ref` 与 `context_reconciliation_ref` 均通过校验。
 - [ ] 统一语言与 `CONTEXT.md` 一致，没有临时创造同义词。
 - [ ] 聚合根、Entity、Value Object 的身份和边界有理由。
 - [ ] 每个聚合的不变量和允许的状态转换都写清楚。
@@ -210,9 +212,9 @@ Strategic Design 解决“业务应该怎样分工和划边界”；Tactical Des
 ## 与其他文档怎么分工
 
 - [用户手册索引](./用户手册索引.md)：所有入门手册的入口。
-- [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md)：上游 Discovery、DDD 战略设计、Spec、原型和 Strategic Design Handoff。
+- [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md)：上游 Discovery、DDD 战略设计、Spec、原型和 Strategic Design Handoff。
 - [系统概要设计模板](../architecture/templates/system-overview-design-template.md)：轻量 Tactical DDD Check 的记录位置。
 - [架构评审清单](../architecture/templates/architecture-review-checklist.md)：设计评审时的结构化检查项。
-- `yss-router` 与后端 / 前端专项技能：批准后的实现合同、代码和验证规则。
+- `yss-implementation-contract-compiler` 与后端 / 前端专项技能：批准后的实现合同、代码和验证规则。
 
 本手册是模板源中的通用分发资产。真实项目应使用自己的术语、规则、合同版本和批准记录；不要把“客户合同审批”示例当成真实业务结论。

package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -205,13 +205,13 @@ codex plugin add yss-backend-harness@personal
 
 ### 插件不会替代什么
 
-Plugin 是运行时适配器，不是新的事实源。它不会替代 `yss-product-lifecycle`、`yss-router` 或 `tdd`，不会设置 `ready-for-agent`，不会 Freeze OpenAPI，也不能承担独立审查。
+Plugin 是运行时适配器，不是新的事实源。它不会替代 `yss-product-lifecycle`、`yss-implementation-contract-compiler` 或 `tdd`，不会设置 `ready-for-agent`，不会 Freeze OpenAPI，也不能承担独立审查。
 
 执行结果应包含 `Workflow Execution Result`（例如 `completed`、`blocked`、`needs-human` 或 `failed`）及对应证据。发现路径越界、合同过期、影响面变化或证据缺失时，应停止并回到路由流程。
 
 ### 不可用时怎么办
 
-如果插件未安装、版本不兼容或执行失败，回退到通用的 `yss-router + tdd` 流程，并记录阻塞原因和实际验证命令。不要为了绕过插件故障而跳过生命周期门禁。
+如果插件未安装、版本不兼容或执行失败，回退到通用的 `yss-implementation-contract-compiler + tdd` 流程，并记录阻塞原因和实际验证命令。不要为了绕过插件故障而跳过生命周期门禁。
 
 ### 其他应用的接入建议
 
@@ -331,7 +331,7 @@ Spec 初稿通常使用 `ready-for-human`。这表示还要确认，不表示可
 - 失败后能不能重试。
 - 窄屏下是否还能完成操作。
 
-成功时，交互说明、状态矩阵、低保真和高保真原型相互一致，并有评审、浏览器验证和用户确认记录。
+先独立评审低保真和状态矩阵，再选择满足风险的最低原型档位：H1 确认视觉和少量交互，H2 验证主流程与异常状态。原型阶段不调用生产实现技能 `yss-ui`；真实组件假设与待验行为交给前端实现计划和实现还原验证。成功时，交互说明、状态矩阵、低保真和原型交付物相互一致，并有评审、浏览器验证和用户确认记录。
 
 正式信息：
 
@@ -397,8 +397,8 @@ Draft 只是草案。评审通过后才能 Freeze。Freeze 可以理解为“接
 
 前端：
 
-- 让 `yss-router` 选择当前页面需要的专项 skill。
-- 以 `yss-ui`、`yss-page-module-development` 和 `tdd` 为主。
+- 让 `yss-implementation-contract-compiler` 选择当前页面需要的专项 skill。
+- 以 `yss-ui`、`yss-ui-business-page-generation` 和 `tdd` 为主。
 - 只修改合同允许的路径。
 - 实际运行已登记的 `pnpm` 命令。
 

package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214/347/264/242/345/274/225.md

@@ -5,7 +5,7 @@
 ## 推荐阅读顺序
 
 1. [YSS 用户手册](./用户手册.md)：了解仓库身份、生命周期主链和 Agent 使用模式。
-2. [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md)：从模糊想法形成 Strategic Design Handoff。
+2. [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md)：从模糊想法形成 Strategic Design Handoff。
 3. [战术设计子项目用户手册](./战术设计子项目用户手册.md)：把交接包细化为 Tactical Design，供研发实现和评审。
 
 ## 按任务查找
@@ -13,9 +13,9 @@
 | 你现在要做什么 | 推荐手册 |
 |---|---|
 | 创建、接管或更新 YSS 项目 | [YSS 用户手册](./用户手册.md) |
-| 澄清需求、确定用户和范围 | [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md) |
+| 澄清需求、确定用户和范围 | [战略设计子项目用户手册](../../submodules/yss-harness-design-agent/docs/user-guide/战略设计子项目用户手册.md) |
 | 设计聚合、状态、不变量和领域事件 | [战术设计子项目用户手册](./战术设计子项目用户手册.md) |
-| 了解完整生命周期和阶段门禁 | [产品生命周期工作流](../../submodules/yss-strategic-design-harness/docs/user-guide/产品生命周期工作流.md) |
-| 查找长期协作习惯和反模式 | [生命周期最佳实践](../../submodules/yss-strategic-design-harness/docs/user-guide/生命周期最佳实践.md) |
+| 了解完整生命周期和阶段门禁 | [产品生命周期工作流](../../submodules/yss-harness-design-agent/docs/user-guide/产品生命周期工作流.md) |
+| 查找长期协作习惯和反模式 | [生命周期最佳实践](../../submodules/yss-harness-design-agent/docs/user-guide/生命周期最佳实践.md) |
 
 > 本仓库是 `template-source`。手册中的业务名称和示例只用于教学；真实产品资料应在 `project-instance` 中建立，并遵守对应的生命周期门禁。