create-yss-spec 3.1.3 → 3.3.0

package/template/docs/process/schemas/implementation-repository-preparation-result.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/implementation-repository-preparation-result.schema.json",
+  "title": "Implementation Repository Preparation Result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "result", "current_version", "projects", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "implementation-repository-preparation-result" },
+    "result": { "const": "completed" },
+    "current_version": { "const": true },
+    "projects": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "required": ["project_id", "delivery_role", "status"],
+        "properties": {
+          "project_id": { "type": "string", "minLength": 1 },
+          "delivery_role": { "enum": ["backend", "frontend"] },
+          "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
+          "reason": { "type": "string" },
+          "repository_ref": { "type": "string" },
+          "project_root": { "type": "string" },
+          "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
+          "onboarding_result": { "type": "object" },
+          "scaffold_contract": { "type": "object" },
+          "scaffold_manifest_ref": { "type": "string" },
+          "scaffold_verification": { "type": "object" },
+          "template_available": { "type": "boolean" },
+          "architecture_family": { "type": "string" }
+        }
+      }
+    },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  }
+}

package/template/docs/process/schemas/project-scaffold-contract.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/project-scaffold-contract.schema.json",
+  "title": "YSS Project Scaffold Contract v4",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "contract_id", "contract_version", "status", "persisted_ref", "current_version", "delivery_role", "scaffold_kind", "generator_skill", "implementation_repository", "target_output_dir", "repository_scope", "init_git", "allowed_write_paths", "expected_evidence_files", "verification_commands", "approval", "generation_policy"],
+  "properties": {
+    "schema_version": { "const": 4 },
+    "kind": { "const": "project-scaffold-contract" },
+    "contract_id": { "type": "string", "minLength": 1 },
+    "contract_version": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "integer", "minimum": 1 }] },
+    "scaffold_request_id": { "type": "string", "minLength": 1 },
+    "compiler_draft_ref": { "type": "string", "minLength": 1 },
+    "lifecycle_approval_ref": { "type": "string", "minLength": 1 },
+    "status": { "const": "approved" },
+    "persisted_ref": { "type": "string", "minLength": 1 },
+    "current_version": { "const": true },
+    "delivery_role": { "enum": ["backend", "frontend"] },
+    "scaffold_kind": { "enum": ["backend-ddd", "backend-layered-mvc", "frontend-yss-vue3"] },
+    "generator_skill": { "enum": ["yss-ddd-scaffold-generator", "yss-layered-mvc-scaffold-generator", "yss-frontend-scaffold-generator"] },
+    "implementation_repository": { "type": "string", "minLength": 1 },
+    "backend_repository": { "type": "string", "minLength": 1 },
+    "scaffold_status": { "const": "required" },
+    "target_output_dir": { "type": "string", "minLength": 1 },
+    "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
+    "init_git": { "type": "boolean" },
+    "project_name": { "type": "string", "minLength": 1 },
+    "base_package": { "type": "string", "minLength": 1 },
+    "architecture_family": { "enum": ["domain-driven", "layered-mvc"] },
+    "architecture_profile": { "type": "string", "minLength": 1 },
+    "decision_ref": { "type": "string", "minLength": 1 },
+    "decision_id": { "type": "string", "minLength": 1 },
+    "decision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "maven_coordinates": { "type": "object" },
+    "profiles": { "type": "object" },
+    "module_profile": { "type": "object" },
+    "frontend": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["app_name", "microapp_name", "base_route", "package_manager", "template", "openapi_impact"],
+      "properties": {
+        "app_name": { "type": "string", "minLength": 1 },
+        "microapp_name": { "type": "string", "minLength": 1 },
+        "base_route": { "type": "string", "pattern": "^/" },
+        "package_manager": { "const": "pnpm" },
+        "template": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["repository", "commit"],
+          "properties": {
+            "repository": { "type": "string", "minLength": 1 },
+            "commit": { "type": "string", "pattern": "^[a-f0-9]{40}$" }
+          }
+        },
+        "openapi_impact": { "enum": ["frozen", "not-applicable"] },
+        "openapi_json_ref": { "type": "string", "minLength": 1 },
+        "openapi_json_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "openapi_not_applicable_reason": { "type": "string", "minLength": 1 },
+        "replacements": { "type": "object", "additionalProperties": { "type": "string" } }
+      },
+      "allOf": [
+        { "if": { "properties": { "openapi_impact": { "const": "frozen" } } }, "then": { "required": ["openapi_json_ref", "openapi_json_digest"] } },
+        { "if": { "properties": { "openapi_impact": { "const": "not-applicable" } } }, "then": { "required": ["openapi_not_applicable_reason"] } }
+      ]
+    },
+    "allowed_write_paths": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "expected_evidence_files": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "verification_commands": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "approval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["approval_ref", "approver"],
+      "properties": { "approval_ref": { "type": "string", "minLength": 1 }, "approver": { "type": "string", "minLength": 1 }, "persisted_ref": { "type": "string", "minLength": 1 }, "current_version": { "oneOf": [{ "type": "boolean" }, { "type": "integer" }, { "type": "string" }] } }
+    },
+    "generation_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "existing_target", "old_project_migration", "template_upgrade"],
+      "properties": {
+        "mode": { "const": "initialize-only" },
+        "existing_target": { "const": "unsupported" },
+        "old_project_migration": { "const": "unsupported" },
+        "template_upgrade": { "const": "unsupported" }
+      }
+    },
+    "work_unit": {
+      "type": "object",
+      "required": ["id", "behavior", "primary_skill", "supporting_skills", "tdd_mode", "allowed_write_paths", "expected_evidence", "verification_commands", "controlled_generation"],
+      "properties": {
+        "id": { "type": "string" },
+        "behavior": { "enum": ["project-scaffold", "scaffold"] },
+        "primary_skill": { "type": "string" },
+        "supporting_skills": { "type": "array", "items": { "type": "string" } },
+        "tdd_mode": { "const": "controlled-generation" },
+        "allowed_write_paths": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "expected_evidence": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "verification_commands": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "controlled_generation": { "const": true }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "delivery_role": { "const": "frontend" } } },
+      "then": { "required": ["frontend"], "properties": { "generator_skill": { "const": "yss-frontend-scaffold-generator" }, "scaffold_kind": { "const": "frontend-yss-vue3" } } }
+    },
+    {
+      "if": { "properties": { "delivery_role": { "const": "backend" } } },
+      "then": { "required": ["scaffold_request_id", "compiler_draft_ref", "lifecycle_approval_ref", "backend_repository", "scaffold_status", "project_name", "base_package", "architecture_family", "decision_ref", "decision_id", "decision_digest", "maven_coordinates", "profiles", "module_profile", "work_unit"] }
+    }
+  ]
+}

package/template/docs/process/schemas/strategic-design-handoff.schema.json

@@ -117,7 +117,10 @@
           "const": "docs/process/schemas/context-reconciliation.schema.json"
         },
         "required_before_skill": {
-          "const": "yss-tactical-design"
+          "enum": [
+            "yss-technical-design",
+            "yss-tactical-design"
+          ]
         },
         "status": {
           "const": "pending"
@@ -137,10 +140,16 @@
           "const": "downstream-rd-team"
         },
         "skill": {
-          "const": "yss-tactical-design"
+          "enum": [
+            "yss-technical-design",
+            "yss-tactical-design"
+          ]
         },
         "output": {
-          "const": "tactical-design-contract"
+          "enum": [
+            "technical-design-contract",
+            "tactical-design-contract"
+          ]
         }
       }
     },
@@ -666,5 +675,69 @@
         }
       }
     }
-  }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "target": {
+            "properties": {
+              "skill": {
+                "const": "yss-technical-design"
+              }
+            }
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "target": {
+            "properties": {
+              "output": {
+                "const": "technical-design-contract"
+              }
+            }
+          },
+          "target_context_reconciliation": {
+            "properties": {
+              "required_before_skill": {
+                "const": "yss-technical-design"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "target": {
+            "properties": {
+              "skill": {
+                "const": "yss-tactical-design"
+              }
+            }
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "target": {
+            "properties": {
+              "output": {
+                "const": "tactical-design-contract"
+              }
+            }
+          },
+          "target_context_reconciliation": {
+            "properties": {
+              "required_before_skill": {
+                "const": "yss-tactical-design"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
 }

package/template/docs/process/strategic-handoff-package.md

@@ -31,7 +31,7 @@ scripts/strategic-handoff import --bundle <目录或ZIP> --target-root <研发
 
 导入落盘到 `docs/handoffs/<handoff-id>/<version>/`，包含不可变 `package/`、`import-receipt.json`、`context-reconciliation-draft.json`、`tactical-traceability-draft.json`、`upstream-change-impact.json`。仅写快照与草案，不自动更新根词汇表或批准状态。目标侧确认增量后更新唯一根 `CONTEXT.md`，生成既有 schema 的正式 reconciliation 并校验。
 
-战术合同的 `strategic_handoff` 绑定 `import_receipt_ref`、`bundle_digest`、`context_reconciliation_ref` 和 `rows`。逐条覆盖全部规则与 `critical: true` 的成功/失败场景；行字段如下：
+Technical Design Contract v2（DDD / MVC 共用）的 `strategic_handoff` 绑定 `import_receipt_ref`、`bundle_digest`、`context_reconciliation_ref` 和 `rows`。逐条覆盖全部规则与 `critical: true` 的成功/失败场景；行字段如下：
 
 - `source_id`、源对象 `source_digest`、`disposition`、`dependency_status: known | unknown`、`dependent_slice_refs`。
 - `implemented`：`tactical_refs`、`test_seam_refs`、`evidence_refs` 必须可解析；关键场景另用 `scenario_tests` 分别绑定 `outcome: success | failure` 与 `seam_ref`。
@@ -42,9 +42,11 @@ scripts/strategic-handoff import --bundle <目录或ZIP> --target-root <研发
 ```bash
 scripts/verify-strategic-handoff-consumption --root <研发项目根> <战术合同>
 scripts/verify-strategic-handoff-consumption --root <研发项目根> --slice <切片ID> <已批准战术合同>
-node .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs <战术合同> --root <研发项目根>
+node .agents/skills/yss-technical-design/scripts/validate-technical-design.mjs <技术设计合同> --root <研发项目根>
 ```
 
+新交接的 target 使用 `yss-technical-design` / `technical-design-contract`，对账必须在通用入口前完成；旧 `yss-tactical-design` / `tactical-design-contract` 成对只读兼容，不修改已冻结包。`tactical_refs` 在 v2 可指向 `design` 中的 MVC 模块、用例、规则或 DDD 对象，测试 seam 同样在对应分支解析。无战略交接包的 MVC 项目直接消费批准需求，不要求补造战略 DDD。
+
 整体验证有未落实项时返回 blocked；按切片验证可放行有证据证明不依赖这些项的切片。输出 `block_all`、`blocked_slice_refs`、`issues`、实际消费包摘要与战术摘要。通过只证明结构化映射完整和引用可核验，业务语义仍需独立评审；不能代替 Slice Contract 批准。
 
 每版完整快照可独立消费，差异区分 added / updated / removed。更新须提升交接版本，内容变化的源资产也须提升其版本。接收新版本后，消费校验比较最新已导入源对象摘要；规则变化按行依赖阻断，未映射的新规则扩大阻断，战略责任边界、方案决策、Spec/视觉/原型源码等变化未重新绑定时整体阻断。`upstream-change-impact.json` 是生命周期处理 stale 的证据输入，不直接改 Tracker 或覆盖战术合同。

package/template/docs/process/template-verification-profiles.yaml

@@ -57,6 +57,9 @@ required_files:
   - .agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md
   - .agents/skills/yss-implementation-contract-compiler/tests/compiler-scenarios.test.mjs
   - .agents/skills/yss-skill-source-index-refresh/SKILL.md
+  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs
+  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs
+  - .agents/skills/yss-repository/tests/profile-routing.test.mjs
   - docs/agents/yss-ui-skills-integration.md
   - docs/agents/strategic-design-skills-integration.md
   - docs/user-guide/yss-ui-mcp.md
@@ -72,6 +75,8 @@ required_files:
   - docs/process/schemas/strategic-design-handoff.schema.json
   - docs/process/schemas/frontend-implementation-evidence.schema.json
   - docs/process/schemas/scaffold-architecture-decisions.schema.json
+  - docs/process/schemas/project-scaffold-contract.schema.json
+  - docs/process/schemas/implementation-repository-preparation-result.schema.json
   - docs/design/schemas/visual-baseline.schema.json
   - docs/process/schemas/subagent-task-package.schema.json
   - docs/process/templates/lifecycle-checkpoint-template.yaml
@@ -82,6 +87,11 @@ required_files:
   - docs/design/templates/visual-baseline-template.yaml
   - docs/process/templates/maintenance-checkpoint-template.yaml
   - docs/templates/subagent-task-package-template.md
+  - .agents/skills/yss-technical-design/SKILL.md
+  - .agents/skills/yss-technical-design/references/technical-design.schema.json
+  - .agents/skills/yss-technical-design/scripts/validate-technical-design.mjs
+  - .agents/skills/yss-mvc-design/SKILL.md
+  - .agents/skills/yss-mvc-design/references/mvc-design.schema.json
   - .agents/skills/yss-tactical-design/SKILL.md
   - .agents/skills/yss-tactical-design/agents/openai.yaml
   - .agents/skills/yss-tactical-design/references/tactical-design-contract.md
@@ -112,6 +122,9 @@ required_files:
   - scripts/verify-template-candidate
   - scripts/verify-template
   - scripts/verify-business-language-scenarios
+  - scripts/query-lifecycle-context
+  - scripts/lib/lifecycle-context-query.mjs
+  - scripts/verify-lifecycle-context-query-scenarios
   - scripts/verify-frontend-implementation-evidence-scenarios
   - scripts/prepare-maintenance-review
   - scripts/evaluate-maintenance-review-round
@@ -126,6 +139,9 @@ syntax_files:
   - scripts/update-skill-lock
   - scripts/verify-upstream-skill-source
   - scripts/lib/skill-supply-chain.mjs
+  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs
+  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs
+  - .agents/skills/yss-repository/tests/profile-routing.test.mjs
   - scripts/generate-lifecycle-artifacts
   - scripts/verify-lifecycle-registry
   - scripts/verify-lifecycle-checkpoint
@@ -133,6 +149,9 @@ syntax_files:
   - scripts/verify-context-contract
   - scripts/verify-context-contract-scenarios
   - scripts/verify-business-language-scenarios
+  - scripts/query-lifecycle-context
+  - scripts/lib/lifecycle-context-query.mjs
+  - scripts/verify-lifecycle-context-query-scenarios
   - scripts/verify-context-reconciliation
   - scripts/verify-context-reconciliation-scenarios
   - scripts/verify-grill-with-docs-context-scenarios
@@ -167,6 +186,10 @@ syntax_files:
   - scripts/lib/lifecycle-transition.mjs
   - scripts/verify-lifecycle-scenarios
   - scripts/verify-lifecycle-transition-scenarios
+  - scripts/verify-frontend-scaffold-generator-scenarios
+  - .agents/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs
+  - .agents/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs
+  - .agents/skills/yss-frontend-scaffold-generator/scripts/generate_and_verify_scaffold.mjs
   - scripts/verify-matt-yss-integration-scenarios
   - scripts/verify-prototype-backend-scaffold-scenarios
   - scripts/verify-yss-implementation-contract-compiler-scenarios
@@ -191,6 +214,10 @@ syntax_files:
   - scripts/verify-maintenance-review-workflow-scenarios
   - scripts/verify-template-cache-scenarios
 routing:
+  - patterns: [".template-source/cli-core/**"]
+    groups: [dedicated-cli-core]
+  - patterns: [".agents/skills/yss-technical-design/**", ".agents/skills/yss-mvc-design/**", ".agents/skills/yss-tactical-design/**", "scripts/lib/technical-design-boundary.mjs", "scripts/lib/strategic-handoff-design-targets.mjs"]
+    groups: [tactical-design, implementation]
   - patterns: ["scripts/*backend-delivery*", "scripts/*frontend-delivery*", "scripts/lib/*backend-delivery*", "scripts/lib/*frontend-delivery*", "scripts/fixtures/backend-delivery/**", "docs/process/frontend-backend-delivery.md", "docs/process/schemas/backend-delivery*", "docs/process/schemas/frontend-delivery*"]
     groups: [frontend-delivery]
   - patterns: ["scripts/*user-decision*", "scripts/lib/user-decision*", "scripts/fixtures/user-decision/**", "docs/process/schemas/user-decision*", "docs/process/templates/user-decision*", "scripts/lib/approval-record.mjs", "scripts/verify-approval-record"]
@@ -230,6 +257,9 @@ routing:
   - patterns: ["scripts/**"]
     groups: [hygiene]
 groups:
+  dedicated-cli-core:
+    commands:
+      - { run: "node --test .template-source/cli-core/tests/*.test.mjs", when: template-source }
   frontend-delivery:
     commands:
       - { run: "scripts/verify-frontend-delivery-scenarios" }
@@ -257,8 +287,12 @@ groups:
       - { run: "scripts/verify-skill-governance" }
       - { run: "scripts/verify-upstream-skill-source --source=iloveZzz/yss-harness-design-agent --source-root=submodules/yss-harness-design-agent", when: template-source }
       - { run: "node .agents/skills/yss-antdv-next-design/tests/run-scenarios.mjs" }
+      - { run: "node --test .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs" }
+      - { run: "node --test .agents/skills/yss-repository/tests/profile-routing.test.mjs" }
   tactical-design:
     commands:
+      - { run: "node .agents/skills/yss-technical-design/scripts/generate-schema.mjs --check" }
+      - { run: "node .agents/skills/yss-technical-design/tests/run-scenarios.mjs" }
       - { run: "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs" }
       - { run: "node --check .agents/skills/yss-tactical-design/tests/run-scenarios.mjs" }
       - { run: "node .agents/skills/yss-tactical-design/tests/run-scenarios.mjs" }
@@ -287,6 +321,7 @@ groups:
       - { run: "scripts/verify-grill-with-docs-context-scenarios" }
       - { run: "scripts/verify-strategic-context-import-scenarios" }
       - { run: "scripts/verify-lifecycle-registry" }
+      - { run: "scripts/verify-lifecycle-context-query-scenarios" }
       - { run: "scripts/verify-lifecycle-checkpoint docs/process/templates/lifecycle-checkpoint-template.yaml" }
       - { run: "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-plan-template.yaml" }
       - { run: "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-verification-template.yaml" }
@@ -295,6 +330,7 @@ groups:
       - { run: "scripts/verify-scaffold-architecture-decision-scenarios" }
       - { run: "scripts/verify-lifecycle-scenarios" }
       - { run: "scripts/verify-lifecycle-transition-scenarios" }
+      - { run: "scripts/verify-frontend-scaffold-generator-scenarios" }
   maintenance:
     commands:
       - { run: "scripts/verify-maintenance-checkpoint .template-source/evidence/maintenance/yss-tactical-design-l3-checkpoint-2026-08-27.yaml", when: template-source }
@@ -307,6 +343,7 @@ groups:
       - { run: "scripts/verify-scaffold-generator-scenarios" }
       - { run: "node --test .agents/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs" }
       - { run: "node --test .agents/skills/yss-layered-mvc-scaffold-generator/scripts/scaffold-generator.test.mjs" }
+      - { run: "scripts/verify-frontend-scaffold-generator-scenarios" }
       - { run: "scripts/verify-prototype-backend-scaffold-scenarios" }
       - { run: "scripts/verify-matt-yss-integration-scenarios" }
       - { run: "scripts/verify-yss-implementation-contract-compiler-scenarios" }

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

@@ -28,11 +28,17 @@ owner: ai
 | superproject_git_url | 父仓远端；必须与 `git_url` 不同 |
 | checkout_state | attached-branch / detached-head / uninitialized / empty-gitlink / 不适用 |
 | scaffold_status | existing / required / initialized |
+| preparation_status | existing-and-onboarded / initialized-and-verified / not-applicable |
+| preparation_result_ref | `artifact.implementation-repository-preparation-result` 的当前引用 |
+| project_scaffold_contract_ref | 新建工程必填；统一 schema v4，历史已批准后端 v3 只读兼容 |
+| scaffold_manifest_ref | 新建工程必填 |
+| scaffold_verification_ref | 新建工程必填，且 status=passed |
 | 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 |  |
+| init_git | true / false；必须来自真实用户确认 |
 | owner |  |
 | ci_system | GitLab CI / GitHub Actions / Jenkins / other / none |
 | issue_tracker | GitLab / GitHub / other |
@@ -85,4 +91,6 @@ Harness 内项目路径约束：`apps/backend/`、`apps/frontend/` 只能作为
 - 关联 Harness change：
 - 关联垂直切片：
 - 关联阶段 checkpoint：
+- 实现仓库准备聚合结果：
+- `gate.implementation-repositories-ready`：approved / blocked
 - fresh verification 命令：

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

@@ -59,7 +59,8 @@ Approved / Changes requested / Blocked
 | 已存在 `Backend Slice Implementation Contract`，且 required skills / allowed paths / forbidden patterns / evidence / seam / verification 完整 | pass / violation / not-applicable |  |
 | `yss-domain` 已按影响面落实，Domain 不依赖 Adapter、Infrastructure、Mapper、Controller 或 Web DTO | pass / violation / not-applicable |  |
 | `yss-application` 已按影响面落实，Application 只做用例编排、事务边界和跨聚合协调 | pass / violation / not-applicable |  |
-| `yss-repository` 已按影响面落实，需要持久化的切片有 PO / Repository / Convertor / GatewayImpl | pass / seam-deferred / violation / not-applicable |  |
+| `yss-repository` 已按影响面落实；所选 Profile、层边界、PO / Repository / Convertor / GatewayImpl 或 MVC repository 结构、事务归属均有文件和测试证据 | pass / seam-deferred / violation / not-applicable |  |
+| `yss-mybatis` 已按影响面落实；基类、Mapper/XML 扫描、分页责任、批量 SQL、条件开关和数据源能力与当前组件索引一致；精确结论已核验 component tree / clean 状态 | pass / seam-deferred / violation / missing_evidence / not-applicable |  |
 | `yss-web-controller` / `yss-dto` 已按影响面落实，CMD / Query / VO / Result 按既有 DTO 体系定义或复用，Controller 不用内部类或非约定包临时承载主要 DTO / VO、不手工分页主要业务集合、不穿透 Repository | pass / violation / not-applicable |  |
 | `mapstruct` 已按影响面落实，PO / Domain Model / DTO / VO / CMD / Query 转换使用 MapStruct Convertor / Mapper，未使用 `BeanUtils.copyProperties`、反射拷贝或重复手写字段赋值；例外已记录测试和补齐落点 | pass / violation / not-applicable |  |
 | `lombok` 已按影响面落实，POJO 样板代码使用 Lombok，未成片手写 getter/setter、constructor、builder、logger；实体 / POJO 未触发 `@Data` 等反模式或已说明例外 | pass / violation / not-applicable |  |
@@ -72,10 +73,11 @@ Approved / Changes requested / Blocked
 ### 后端 smoke check
 
 ```bash
-rg -n "class (SingleResult|MultiResult|PageResult|Result)<|public static class .*(Command|Cmd|Query|VO)|subList\\(|InMemory.*Gateway|implements .*Gateway|extends .*Repository|@TableName|Mappers\\.getMapper" apps/backend
+# <review-root...> 必须由本体项目、实现仓登记、Slice project_roots 与 allowed_write_paths 解析。
+rg -n "class (SingleResult|MultiResult|PageResult|Result)<|public static class .*(Command|Cmd|Query|VO)|subList\\(|InMemory.*Gateway|implements .*Gateway|extends Base(Plus)?Repository|@TableName|@MapperScan|Mappers\\.getMapper|PageQuery|insertBatchSomeColumn|yss\\.mybatis" <review-root...>
 ```
 
-命中说明：`SingleResult` / `PageResult`、`CMD` / `Query` / `VO` 命中不等于失败；需要说明其是否来自 `yss-dto` / 项目既有体系、是否位于约定包路径、是否继承约定基类。
+命中说明：DTO/Result 或 MyBatis 基类、`PageQuery`、批量/扫描配置命中不等于失败；需要按当前合同、Repository Profile 和 MyBatis source index 说明其来源、分页责任与配置是否匹配。
 
 | 命中 | 解释 | 结论 |
 |---|---|---|
@@ -119,6 +121,8 @@ rg -n "from 'ant-design-vue'|<(Table|Tree|Form)[ >]|YFormily|YssFormily|YTable|Y
 | Agent 尝试用 `BeanUtils.copyProperties`、反射拷贝或大段手写字段赋值完成 POJO 转换 | 应被标记为 `violation`，回到 `mapstruct` 补 Convertor / Mapper，或补受控例外、测试和 review 证据 |  |
 | Agent 尝试成片手写 getter/setter、constructor、builder 或 logger | 应被标记为 `violation`，回到 `lombok` 补注解，或补受控例外、测试和 review 证据 |  |
 | Agent 尝试用 `InMemory*Gateway` 完成正式持久化 | 只能 `seam-deferred`，必须有补齐切片和风险说明 |  |
+| Agent 未核验 Profile/source index 就选择 `BaseRepository` / `BasePlusRepository`，或把两套分页责任混在同一查询 seam | 应按 `yss-repository` / `yss-mybatis` 标记 `violation` 或 `missing_evidence` |  |
+| Agent 把多数据源实例集合误当成线程上下文动态路由，或在事务进入后才尝试切换 | 应标记 `violation`；先核验组件能力，再由批准的上层适配承担路由 |  |
 | Agent 只写“符合 YSS”但没有 skill / 文件 / 测试证据 | 应被标记为 `violation` |  |
 | Agent 在后端验证、CI、README 或发布说明中写裸 `mvn ...` | 应改为项目根目录 `./mvnw ...`，否则标记为 `violation` |  |
 | Agent 将英文 skill / 模板的标题和说明原样输出为项目持久化文档 | 应改为中文正文和中文章节标题，否则标记为 `violation` |  |

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

@@ -1,14 +1,15 @@
 # 战术设计子项目用户手册
 
-本入口保留给既有读者。Tactical Design 把已批准业务规则映射为聚合、状态、不变量、一致性边界和测试 seam；它不是新的模板家族，不代替 API Freeze 或 Slice Contract 批准。
+本入口保留给既有读者。“战术设计子项目”通过 `yss-technical-design` 统一承接技术设计，整体主控仍为 `yss-product-lifecycle`。先确认后端项目采用 `domain-driven` 或 `layered-mvc`，再分别调用 `yss-tactical-design` 或 `yss-mvc-design`；DDD 是选项，不是默认要求。技术设计不代替 API Freeze 或 Slice Contract 批准。
 
 ## 输入与开始
 
-先核对本仓身份、profile、根 CONTEXT.md、当前战略交接及批准证据。导入快照后完成目标词汇对账，再逐项登记源规则/关键场景的承接；缺失、冲突或过期先回交，不能猜测业务规则。
+先核对本仓身份、profile、根 CONTEXT.md、适用的战略交接、需求及批准证据。已有战略包时，导入快照后完成目标词汇对账，再逐项登记源规则/关键场景的承接；缺失、冲突或过期先回交，不能猜测业务规则。
 
 ```text
 请按本仓生命周期检查“设备领用”当前战略输入及目标词汇对账。
-有领域行为影响时，使用 yss-tactical-design 起草战术设计，
+使用 yss-technical-design 核对已确认的项目架构并起草技术设计，
+DDD 调用 yss-tactical-design，传统 MVC 调用 yss-mvc-design；
 解释设备占用的竞争、状态转换和一致性边界，并映射公开测试 seam。
 逐项列出已承接、冲突、延期及依赖切片，等待适用审查后再编译实现合同。
 ```
@@ -20,15 +21,15 @@
 | 谁保护不变量 | 哪个对象/边界保证设备不能同时被领用 |
 | 状态是否合法 | 未批准申请是否允许领用；重复归还如何处理 |
 | 一致性在哪里保证 | 申请与设备占用是否同事务；失败如何恢复 |
-| 外部依赖如何隔离 | API/Repository/Gateway 怎样映射而不篡改业务含义 |
+| 外部依赖如何隔离 | API/Repository/适配边界怎样映射而不篡改业务含义 |
 | 如何证伪设计 | 并发领用、无权限、重复请求的公开 seam 与预期结果 |
 
-案例只是提问方向，答案由项目实际业务与工程条件决定。没有领域行为影响时按当前政策记录带原因的 not-applicable，不为简单页面硬造聚合。
+案例只是提问方向，答案由项目实际业务与工程条件决定。MVC 不要求先完成战略 DDD，也不要求聚合、值对象或 DDD Gateway；用例、规则、事务、幂等、并发和测试承接仍须清晰。没有相关技术设计影响时记录带原因的 not-applicable。
 
 ## 从设计到实现
 
 综合项目由本仓生命周期继续路由，通用研发/后端由 Harness 流程承接。前端专职只消费上游规则、冻结接口并准备前端工程设计，不在本仓派发后端战术实现。
 
-编译器起草当前合同，批准与可实现状态由本仓编排和门禁控制。实现前确认工程登记、冻结接口、测试 seam、允许路径与回滚点。战术评审通过不等于 ready-for-agent。
+技术设计经现有门禁批准后，编译器消费当前设计并起草实现合同，批准与可实现状态由本仓编排和门禁控制。实现前确认工程登记、冻结接口、测试 seam、允许路径与回滚点。战术评审通过不等于 ready-for-agent。
 
 过程示例见 [设备借用贯穿案例](设备借用贯穿案例.md)；项目选型见 [用户手册](用户手册.md)。

package/template/scripts/fixtures/strategic-handoff/fixture.mjs

@@ -16,7 +16,8 @@ context_schema_version: 1
 |---|---|---|---|---|
 | 供应商 | 提供产品或服务的主体 | Supplier | Global | |
 `;
-export async function fixture(root) {
+// Legacy fixture remains the default for released CLI compatibility tests.
+export async function fixture(root, { technicalDesign = false } = {}) {
  const put=(ref,value)=>{const p=path.join(root,ref);mkdirSync(path.dirname(p),{recursive:true});writeFileSync(p,typeof value==='string'?value:json(value));};
  put('yss-project.yaml','schema_version: 1\nrepository_mode: project-instance\n');put('CONTEXT.md',context);
  const source=parseContextSource(context), resolved=resolveContextTermRefs(source,['Global/Supplier']);
@@ -51,7 +52,7 @@ const visualBaselineRef = { baseline_id: sealedBaseline.baseline_id, version: se
  const terminalGate=countersignRuleForGate(roles.gate_policy,'gate.strategic-design-handoff-approved')?'gate.strategic-design-handoff-approved':'gate.stage-decision-package-approved';
  const gates={domain_strategy_ref:'gate.domain-strategy-approved',stage_decision_package_ref:'gate.stage-decision-package-approved',spec_ref:'gate.spec-baseline-approved',prototype_ref:'gate.user-confirmation',visual_baseline_ref:'gate.user-confirmation',business_ticket_set_ref:terminalGate,handoff:terminalGate};
  const approvals=Object.fromEntries([...Object.keys(sourceRefs),'handoff'].map(key=>[key,{record_ref:`approvals/${key}.yaml`,gate_id:gates[key],digest_kind:key==='visual_baseline_ref'?'visual-baseline':['domain_strategy_ref','stage_decision_package_ref','business_ticket_set_ref'].includes(key)?'canonical-json':'sha256-bytes'}]));
- const handoff={schema_version:3,handoff_id:'strategic-design-handoff.supplier',handoff_version:'v1',status:'approved',source:sourceRefs,source_context_snapshot:snapshot,context_delta:{added:resolved.terms.map(({term_ref,term,meaning,english_identifier,context_id,forbidden_aliases})=>({term_ref,term,meaning,english_identifier,context_id,forbidden_aliases})),updated:[],deprecated:[]},target_context_reconciliation:{target_context_ref:'CONTEXT.md',reconciliation_schema_ref:'docs/process/schemas/context-reconciliation.schema.json',required_before_skill:'yss-tactical-design',status:'pending'},target:{team:'downstream-rd-team',skill:'yss-tactical-design',output:'tactical-design-contract'},problem_and_business_outcomes:['提交供应商材料'],bounded_context_and_subdomain_map:['SupplierManagement'],context_map_and_translation_responsibility:['SupplierManagement'],ubiquitous_language_and_concept_candidates:['Global/Supplier'],scenarios_and_business_invariants:['rule.complete','scenario.submit'],tactical_design_questions:['一致性边界'],deferred_decisions_and_ownership:[],evidence_and_version_digests:['evidence/offline.log'],acceptance:['traceability'],package_export:{schema_version:1,approvals,additional_files:[],reference_map:{},prototype:{profile:'H2',preview_root:'preview',entry_ref:'preview/index.html',verification_ref:'evidence/offline.json',verification_digest:hash(readFileSync(path.join(root,'evidence/offline.json'))),source_digest:treeDigest(root,'prototype-src'),source_root:'prototype-src',lock_ref:'prototype-src/pnpm-lock.yaml'}}};
+ const handoff={schema_version:3,handoff_id:'strategic-design-handoff.supplier',handoff_version:'v1',status:'approved',source:sourceRefs,source_context_snapshot:snapshot,context_delta:{added:resolved.terms.map(({term_ref,term,meaning,english_identifier,context_id,forbidden_aliases})=>({term_ref,term,meaning,english_identifier,context_id,forbidden_aliases})),updated:[],deprecated:[]},target_context_reconciliation:{target_context_ref:'CONTEXT.md',reconciliation_schema_ref:'docs/process/schemas/context-reconciliation.schema.json',required_before_skill:technicalDesign?'yss-technical-design':'yss-tactical-design',status:'pending'},target:{team:'downstream-rd-team',skill:technicalDesign?'yss-technical-design':'yss-tactical-design',output:technicalDesign?'technical-design-contract':'tactical-design-contract'},problem_and_business_outcomes:['提交供应商材料'],bounded_context_and_subdomain_map:['SupplierManagement'],context_map_and_translation_responsibility:['SupplierManagement'],ubiquitous_language_and_concept_candidates:['Global/Supplier'],scenarios_and_business_invariants:['rule.complete','scenario.submit'],tactical_design_questions:['一致性边界'],deferred_decisions_and_ownership:[],evidence_and_version_digests:['evidence/offline.log'],acceptance:['traceability'],package_export:{schema_version:1,approvals,additional_files:[],reference_map:{},prototype:{profile:'H2',preview_root:'preview',entry_ref:'preview/index.html',verification_ref:'evidence/offline.json',verification_digest:hash(readFileSync(path.join(root,'evidence/offline.json'))),source_digest:treeDigest(root,'prototype-src'),source_root:'prototype-src',lock_ref:'prototype-src/pnpm-lock.yaml'}}};
  const sign=()=>{put('handoff.yaml',handoff);for(const[key,approval]of Object.entries(approvals)){const asset=key==='handoff'?{id:handoff.handoff_id,version:handoff.handoff_version,digest:hash(readFileSync(path.join(root,'handoff.yaml')))}:sourceRefs[key];put(approval.record_ref,{schema_version:1,gate_id:approval.gate_id,decision:'approved',actor_kind:'digital-human',role_id:countersignRuleForGate(roles.gate_policy,approval.gate_id).countersigners[0],runtime_id:'runtime.generic',principal_ref:'synthetic-maintenance-fixture',artifact_bindings:[{id:asset.id||asset.baseline_id,version:asset.version,digest:asset.digest}]});}};
  sign();return{handoff,strategy,stage,put,sign,snapshot};
 }

package/template/scripts/lib/implementation-contract-compiler.mjs

@@ -1,3 +1,4 @@
+import { enforceTechnicalDesign } from './technical-design-boundary.mjs';
 import { enforceHarnessSkillScope } from "./harness-execution-scope.mjs";
 import { createHash } from "node:crypto";
 import { readFileSync } from "node:fs";
@@ -66,7 +67,8 @@ export function compileImplementationContract({
   architecture_evidence,
   root = ROOT,
   slice_id,
-  frontend_delivery
+  frontend_delivery,
+  technical_design
 }) {
   assertV2(registry, compilerContract);
   const deliveryInput = enforceFrontendDelivery({ slice_id, frontend_delivery }, { root });
@@ -91,6 +93,8 @@ export function compileImplementationContract({
     for (const recipe of orderedRecipes) if (recipe.architecture_family && recipe.architecture_family !== architecture_identity.architecture_family) fail(`Recipe ${recipe.id} 与架构族不匹配`);
   }
 
+  enforceTechnicalDesign({ technical_design, conditions, architecture_identity, slice_id }, { root });
+
   const capabilitySources = new Map();
   const orderedCapabilities = [];
   const addCapability = (capabilityId, source) => {
@@ -175,6 +179,7 @@ export function compileImplementationContract({
       readiness_blockers: architectureProfile.maturity === "supported" ? [] : ["backend-profile-not-supported"],
       skill_profiles: Object.fromEntries(orderedSkills.map((skill) => [skill, architecture_identity.architecture_profile]))
     } : {}),
+    ...(technical_design ? { technical_design, slice_id } : {}),
     recipe_ids: orderedRecipes.map((recipe) => recipe.id),
     conditions: [...conditionSet].sort(),
     required_capabilities: orderedCapabilities,
@@ -202,6 +207,8 @@ export function evaluateContractFreshness(contract, { registry, compilerContract
   if (contract?.schema_version !== 2) fail("Slice Implementation Contract schema v1 已停止支持；必须重新编译 v2 合同");
   const resolution = contract.resolution ?? contract;
   const reasons = [];
+  try { enforceTechnicalDesign({ ...resolution, slice_id: contract.slice_id ?? resolution.slice_id }, { root }); }
+  catch { reasons.push("technical-design-stale-or-unavailable"); }
   try { enforceFrontendDelivery(contract, { root }); }
   catch { reasons.push("frontend-delivery-stale-or-unavailable"); }
   if (resolution.registry_digest !== digestDocument(registry)) reasons.push("registry-digest-changed");