create-yss-spec 3.2.0 → 3.3.1

package/template/docs/process/schemas/digital-human-task-package.schema.json

@@ -6,6 +6,8 @@
   "additionalProperties": false,
   "required": ["schema_version", "task_id", "work_unit_id", "actor_id", "role_id", "runtime_id", "execution_state", "workflow_status", "skill_source", "contract", "inputs", "objective", "allowed_write_paths", "forbidden_actions", "expected_outputs", "expected_evidence_files", "verification_commands", "verification_results", "downstream_consumers", "convergence"],
   "properties": {
+    "plan_review_ref": { "type": "string", "minLength": 1 },
+    "plan_user_decision_ref": { "type": "string", "minLength": 1 },
     "schema_version": { "const": 1 },
     "frontend_delivery": {
       "type": "object", "additionalProperties": false, "required": ["acceptance_ref"],

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/lifecycle-checkpoint.schema.json

@@ -6,6 +6,9 @@
   "additionalProperties": false,
   "required": ["schema_version", "repository_mode", "mode", "status", "stage", "artifacts", "gates", "context_reconciliation", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
   "properties": {
+    "plan_review_ref": { "type": "string", "minLength": 1 },
+    "plan_user_decision_ref": { "type": "string", "minLength": 1 },
+    "feature_id": { "type": "string", "minLength": 1 },
     "schema_version": { "const": 1 },
     "repository_mode": { "enum": ["template-source", "project-instance"] },
     "mode": { "enum": ["route", "orchestrate", "resume", "audit"] },

package/template/docs/process/schemas/lifecycle-registry.schema.json

@@ -27,7 +27,7 @@
   },
   "$defs": {
     "id": { "type": "string", "pattern": "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$" },
-    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_goal": { "type": "string", "minLength": 1 }, "public_exit_criteria": { "type": "string", "minLength": 1 } } } },
+    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "spec_entry": {"type":"object","required":["required_checks","gate_impacts"],"additionalProperties":false,"properties":{"required_checks":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}},"gate_impacts":{"type":"object","minProperties":1,"additionalProperties":{"type":"string","minLength":1}}}}, "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_goal": { "type": "string", "minLength": 1 }, "public_exit_criteria": { "type": "string", "minLength": 1 } } } },
     "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } }, "requires_gates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^gate\\." } } } } },
     "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "enum": ["template-source", "project-instance"] }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_input": { "type": "string", "minLength": 1 }, "public_output": { "type": "string", "minLength": 1 }, "public_completion": { "type": "string", "minLength": 1 } } } },
     "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_description": { "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/template-engineering-overview.md

@@ -22,7 +22,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 | 身份 | 用途 | 允许的主要工作 | 边界 |
 |---|---|---|---|
 | `template-source` | 维护通用模板与治理规则 | 更新单一事实来源、同步技能投影、构建 CLI 快照、验证与审查 | 不生成具体产品的 Spec、原型、OpenAPI 或垂直切片 Ticket |
-| `project-instance` | 承载具体产品或模块的研发管理资产 | 执行 Discovery、Spec、设计、工程契约、Ticket、实现、验证和发布流程 | 不反向成为通用模板的权威来源 |
+| `project-instance` | 承载具体产品或模块的研发管理资产 | 执行 Plan、Spec、设计、工程契约、Ticket、实现、验证和发布流程 | 不反向成为通用模板的权威来源 |
 
 身份只由 `yss-project.yaml` 声明。目录结构、Git remote 和占位符都不能替代该清单。
 
@@ -32,7 +32,7 @@ YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份
 
 | 产品线 | 模板源 | 实例化 CLI | 生命周期边界 |
 |---|---|---|---|
-| 全产品生命周期 | `yss-spec-project-template` | `create-yss-spec` | 从 Discovery 到发布与复盘 |
+| 全产品生命周期 | `yss-spec-project-template` | `create-yss-spec` | 从 Plan 到发布与复盘 |
 | DDD 战略设计交接 | `yss-harness-design-agent` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
 | 开发落地 | `yss-harness-dev-agent` | `create-yss-harness-dev` | 从已批准 Spec 或战略设计交接包到 Tactical Design、Slice Contract、实现与验证 |
 

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
@@ -117,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
@@ -131,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
@@ -138,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
@@ -172,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
@@ -269,6 +287,8 @@ 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" }
@@ -298,9 +318,11 @@ groups:
       - { run: "scripts/verify-context-contract-scenarios" }
       - { run: "node scripts/verify-business-language-scenarios" }
       - { run: "scripts/verify-context-reconciliation-scenarios" }
+      - { run: "node scripts/verify-script-performance-scenarios" }
       - { 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" }
@@ -309,6 +331,8 @@ groups:
       - { run: "scripts/verify-scaffold-architecture-decision-scenarios" }
       - { run: "scripts/verify-lifecycle-scenarios" }
       - { run: "scripts/verify-lifecycle-transition-scenarios" }
+      - { run: "node scripts/verify-plan-spec-entry-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 }
@@ -321,6 +345,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/process/templates/context-reconciliation-template.yaml

@@ -1,7 +1,7 @@
 schema_version: 1
 repository_mode: project-instance
-stage: stage.discovery
-work_unit: work-unit.discovery-requirements
+stage: stage.plan
+work_unit: work-unit.plan-requirements
 status: reconciled
 context_snapshot:
   context_ref: CONTEXT.md

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

@@ -10,7 +10,7 @@ context_reconciliation:
   ref: null
   reason: 等待当前工作单元完成稳定术语回写与核对
   evidence_refs: []
-next_work_unit: work-unit.discovery-opportunity
+next_work_unit: work-unit.plan-opportunity
 phase_boundary:
   decision: continue
   reason: initial routing

package/template/docs/requirements/README.md

@@ -1,6 +1,6 @@
 # 需求定义 (Requirements) — 从想法到可执行定义
 
-> **Phase: Requirements | 输入: Discovery | 输出: Spec + Stories + 验收条件**
+> **Phase: Requirements | 输入: Plan | 输出: Spec + Stories + 验收条件**
 
 ---
 
@@ -79,7 +79,7 @@ delegate_task(
 ## AI-Human Loop
 
 ```
-Discovery报告 → AI生成Spec → PM审核
+Plan报告 → AI生成Spec → PM审核
 → AI补充边界 → PM确认 → AI拆解Stories
 → 团队估算 → AI标注风险 → TechLead确认 → 进入Architecture
 ```

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/local-parent-ticket-template.md

@@ -37,7 +37,7 @@ Status: ready-for-human
 
 ## 资产与证据
 
-- Discovery：`docs/.scratch/<feature>/discovery/`
+- Plan：`docs/.scratch/<feature>/plan/`
 - Spec Delta：`docs/.scratch/<feature>/spec-delta/`
 - Design：`docs/.scratch/<feature>/design/`
 - API：`docs/.scratch/<feature>/api/`

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/templates/subagent-task-package-template.md

@@ -35,7 +35,7 @@ owner: ai
 
 | 输入 | 路径 / 链接 | 用途 |
 |---|---|---|
-| Spec / Discovery |  |  |
+| Spec / Plan |  |  |
 | Product / Interaction Design |  |  |
 | OpenAPI Draft / Freeze |  |  |
 | Architecture / ADR / CONTEXT |  |  |

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

@@ -67,7 +67,7 @@ init 只创建不存在或空目录；attach / sync 默认只预览，写入要
 
 ## 按路线推进
 
-综合模板按本仓生命周期从分诊、Discovery、Spec/功能架构、产品设计、工程契约、Ticket、切片推进到验证与发布。战略模板在业务交接停止；通用研发从批准上游接入；专职两端按交付合同接力。
+综合模板按本仓生命周期从分诊、Plan、Spec/功能架构、产品设计、工程契约、Ticket、切片推进到验证与发布。战略模板在业务交接停止；通用研发从批准上游接入；专职两端按交付合同接力。
 
 每一步都让 Agent 说明：消费了哪些当前输入、准备了什么、缺谁确认、怎样检查结果。具体阶段和门禁从本仓注册表读取，不把别的模板阶段编号复制进本仓。
 

package/template/scripts/cache-template-commit

@@ -3,9 +3,9 @@ import { parseArgs } from "node:util";
 import { acquireTemplateCommit } from "./lib/template-commit-cache.mjs";
 
 try {
-  const { values } = parseArgs({ options: { repository: { type: "string" }, commit: { type: "string" }, "cache-root": { type: "string" } }, strict: true });
+  const { values } = parseArgs({ options: { repository: { type: "string" }, commit: { type: "string" }, "cache-root": { type: "string" }, "timeout-ms": { type: "string" } }, strict: true });
   if (!values.repository || !values.commit) throw new TypeError("用法: scripts/cache-template-commit --repository <remote-url> --commit <40位commit> [--cache-root <path>]");
-  const result = acquireTemplateCommit({ repository: values.repository, commit: values.commit, cacheRoot: values["cache-root"] });
+  const result = acquireTemplateCommit({ repository: values.repository, commit: values.commit, cacheRoot: values["cache-root"], timeoutMs: Number(values["timeout-ms"] || 0) });
   process.stdout.write(`${JSON.stringify(result)}\n`);
 } catch (error) {
   process.stderr.write(`模板 commit 缓存失败: ${error.message}\n`);

package/template/scripts/fixtures/strategic-handoff/source-roles.json

@@ -73,7 +73,7 @@
     ],
     "stages": [
       "stage.entry-triage",
-      "stage.discovery",
+      "stage.plan",
       "stage.spec-architecture",
       "stage.product-design",
       "stage.system-data-engineering",
@@ -103,11 +103,11 @@
       "contract_version": 1,
       "title": "YSS 需求经理",
       "stages": [
-        "stage.discovery",
+        "stage.plan",
         "stage.spec-architecture"
       ],
       "draft_artifact_ids": [
-        "artifact.discovery-record",
+        "artifact.plan-record",
         "artifact.spec"
       ],
       "core_skills": [
@@ -137,7 +137,7 @@
       "contract_version": 1,
       "title": "YSS 产品经理",
       "stages": [
-        "stage.discovery",
+        "stage.plan",
         "stage.spec-architecture",
         "stage.product-design",
         "stage.verification-release-retrospective"
@@ -177,7 +177,7 @@
       "title": "YSS 项目经理",
       "stages": [
         "stage.entry-triage",
-        "stage.discovery",
+        "stage.plan",
         "stage.spec-architecture",
         "stage.product-design",
         "stage.system-data-engineering",
@@ -346,9 +346,9 @@
   ],
   "stage_groups": [
     {
-      "id": "group.discovery",
+      "id": "group.plan",
       "name": "Discovery",
-      "stage": "stage.discovery",
+      "stage": "stage.plan",
       "members": [
         "role.lifecycle-orchestrator",
         "role.requirements-manager",

package/template/scripts/fixtures/user-decision/plan-fixture.mjs

@@ -0,0 +1,30 @@
+// Synthetic test evidence only; never import to produce real project approval.
+import { mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { ROOT } from '../../lib/lifecycle-registry.mjs';
+import { parseContextContract, resolveContextTermRefs } from '../../lib/context-contract.mjs';
+import { decisionDigest } from '../../lib/user-decision.mjs';
+import { planEntryPolicy } from '../../lib/plan-spec-entry.mjs';
+import { buildDecisionFixture } from './build-fixture.mjs';
+
+export function buildPlanFixture(root) {
+  mkdirSync(path.join(root, 'docs/process'), { recursive: true });
+  const write = (ref, value) => writeFileSync(path.resolve(root, ref), typeof value === 'string' ? value : JSON.stringify(value, null, 2));
+  write('yss-project.yaml', 'schema_version: 1\nrepository_mode: project-instance\n');
+  for (const ref of ['CONTEXT.md', 'docs/process/lifecycle-registry.yaml']) write(ref, readFileSync(path.join(ROOT, ref), 'utf8'));
+  write('plan.md', '测试规划：小范围修订，不改变业务边界或关键规则。\n');
+  const c = parseContextContract({ root });
+  write('reconciliation.json', { schema_version: 1, repository_mode: 'project-instance', stage: 'stage.plan', work_unit: 'work-unit.plan-requirements', status: 'reconciled', context_snapshot: { context_ref: c.context_ref, context_schema_version: c.context_schema_version, document_digest: c.document_digest, referenced_terms_digest: resolveContextTermRefs(c, []).referenced_terms_digest, term_refs: [] }, changes: { added: [], updated: [], deprecated: [] }, unresolved_terms: [], evidence_refs: ['CONTEXT.md'] });
+  const policy = planEntryPolicy({ root });
+  const review = { schema_version: 1, kind: 'plan-entry-review', feature_id: 'feature.demo', plan_ref: 'plan.md', context_reconciliation_ref: 'reconciliation.json', basis: ['plan.md', 'CONTEXT.md', 'docs/process/lifecycle-registry.yaml', 'reconciliation.json'].map(ref => ({ ref, digest: decisionDigest(readFileSync(path.join(root, ref))) })), checks: Object.fromEntries(policy.required_checks.map(id => [id, { status: 'passed', evidence_refs: ['plan.md'] }])), open_items: [], impacts: { domain_strategy: false, stage_decision: false }, gates: Object.fromEntries(Object.keys(policy.gate_impacts).map(id => [id, { status: 'not-applicable', reason: '本次仅修订已确认范围内的细节，不改变边界、规则或阶段合同', evidence_refs: ['plan.md'] }])) };
+  const reviewRef = path.join(root, 'review.json');
+  const save = () => write(reviewRef, review);
+  save();
+  const approval = buildDecisionFixture(path.join(root, 'approval'), { boundary: 'plan-conclusion', subjectRef: reviewRef });
+  const reapprove = () => {
+    save();
+    approval.record.request.items[0].subject.digest = decisionDigest(readFileSync(reviewRef));
+    approval.present(); approval.record.responses = []; approval.respond(); approval.save();
+  };
+  return { root, review, save, write, approval, reapprove, state: { feature_id: review.feature_id, plan_review_ref: reviewRef, plan_user_decision_ref: approval.ref, user_decisions: [approval.requirement] } };
+}

package/template/scripts/lib/backend-delivery.mjs

@@ -81,10 +81,13 @@ function validManifest(manifest,root) {
   ensure(manifest.files.reduce((total,file)=>total+file.size_bytes,0)<=512*1024*1024,'后端包大小超限');
   const originals=manifest.files.filter(x=>x.original_ref).map(x=>x.original_ref);
   ensure(new Set(originals.map(x=>x.toLowerCase())).size===originals.length,'后端包源路径重复');
+  const captured = new Map();
   for(const file of manifest.files) {
     const bytes=readFileSync(safe(root,file.path));
     ensure(bytes.length===file.size_bytes&&hash(bytes)===file.sha256,`后端包文件摘要不一致: ${file.path}`);
+    captured.set(file.path, bytes);
   }
+  return captured;
 }
 
 export async function openBackendDelivery(input, action) {
@@ -93,9 +96,9 @@ export async function openBackendDelivery(input, action) {
     ensure(existsSync(input)&&!lstatSync(input).isSymbolicLink(),'后端交付包不存在或是 symlink');
     let root=path.resolve(input);
     if(lstatSync(root).isFile()) { root=path.join(temporary,'unpacked');mkdirSync(root);archive('unpack',path.resolve(input),root); }
-    const manifest=read(safe(root,'manifest.json'));validManifest(manifest,root);
+    const manifest=read(safe(root,'manifest.json'));const captured=validManifest(manifest,root);
     const source=path.join(temporary,'source');mkdirSync(source);
-    for(const file of manifest.files)if(file.original_ref)write(source,file.original_ref,readFileSync(safe(root,file.path)));
+    for(const file of manifest.files)if(file.original_ref)write(source,file.original_ref,captured.get(file.path));
     const inspected=await inspectBackendDelivery(source,manifest.delivery_ref);
     ensure(manifest.delivery_id===inspected.delivery.delivery_id&&manifest.version===inspected.delivery.version,'后端包身份不一致');
     return await action({root,source,manifest,...inspected});