create-yss-spec 3.0.1 → 3.1.3

package/template/docs/process/schemas/user-decision.schema.json

@@ -0,0 +1,357 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/user-decision.schema.json",
+  "title": "用户决定记录",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "kind",
+    "request",
+    "responses"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "kind": {
+      "const": "user-decision"
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "requester_ref",
+        "requester_source",
+        "items",
+        "presented_source"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requester_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requester_source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "ref",
+            "digest",
+            "message_id"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "platform-message",
+                "session-export",
+                "user-confirmation-file"
+              ]
+            },
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "message_id": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "items": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "boundary",
+              "title",
+              "subject",
+              "basis",
+              "scope",
+              "changes",
+              "risks",
+              "recommendation",
+              "next_actions",
+              "responder_ref"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "boundary": {
+                "type": "string",
+                "minLength": 1
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "subject": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "ref",
+                  "version",
+                  "digest"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "version": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^sha256:[a-f0-9]{64}$"
+                  }
+                }
+              },
+              "basis": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "ref",
+                    "version",
+                    "digest"
+                  ],
+                  "properties": {
+                    "ref": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "version": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "digest": {
+                      "type": "string",
+                      "pattern": "^sha256:[a-f0-9]{64}$"
+                    }
+                  }
+                }
+              },
+              "scope": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "uniqueItems": true,
+                "minItems": 1
+              },
+              "changes": {
+                "type": "string",
+                "minLength": 1
+              },
+              "risks": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "uniqueItems": true
+              },
+              "recommendation": {
+                "type": "string",
+                "minLength": 1
+              },
+              "next_actions": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "uniqueItems": true,
+                "minItems": 1
+              },
+              "responder_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "delegation_source": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "ref",
+                  "digest",
+                  "message_id"
+                ],
+                "properties": {
+                  "kind": {
+                    "enum": [
+                      "platform-message",
+                      "session-export",
+                      "user-confirmation-file"
+                    ]
+                  },
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^sha256:[a-f0-9]{64}$"
+                  },
+                  "message_id": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            }
+          }
+        },
+        "presented_source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "ref",
+            "digest",
+            "message_id"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "platform-message",
+                "session-export",
+                "user-confirmation-file"
+              ]
+            },
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "message_id": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    },
+    "responses": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "source",
+          "principal_ref",
+          "responded_at",
+          "text",
+          "request_digest",
+          "selection",
+          "item_ids",
+          "decision",
+          "approved_scope"
+        ],
+        "properties": {
+          "source": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "kind",
+              "ref",
+              "digest",
+              "message_id"
+            ],
+            "properties": {
+              "kind": {
+                "enum": [
+                  "platform-message",
+                  "session-export",
+                  "user-confirmation-file"
+                ]
+              },
+              "ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "digest": {
+                "type": "string",
+                "pattern": "^sha256:[a-f0-9]{64}$"
+              },
+              "message_id": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "principal_ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "responded_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1
+          },
+          "request_digest": {
+            "type": "string",
+            "pattern": "^sha256:[a-f0-9]{64}$"
+          },
+          "selection": {
+            "enum": [
+              "single",
+              "explicit-items",
+              "explicit-all"
+            ]
+          },
+          "item_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true,
+            "minItems": 1
+          },
+          "decision": {
+            "enum": [
+              "approved",
+              "rejected",
+              "changes-requested",
+              "unclear",
+              "revoked"
+            ]
+          },
+          "approved_scope": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,56 @@
+# 战略交接快照包
+
+本合同用于批准后的战略交付和研发接收，不增加生命周期阶段或门禁。`scripts/strategic-handoff` 是统一入口；Node 22+、Python 3 和现有 `jsonschema` 环境即可运行，不下载依赖、不执行交接包中的代码。包 schema 与导出配置见同目录 `schemas/strategic-handoff-package.schema.json`、`schemas/strategic-handoff-export.schema.json`。源规则仍由战略合同持有，索引与快照不成为第二套事实源。
+
+## 源资产准备
+
+1. 源仓必须为 `project-instance`。业务边界与规则合同保留 schema v2，正式便携导出要求 `traceability_version: 1`。`rule_catalog` 的每行包含稳定 `rule_id`、`statement`、`responsible_context`、`status: confirmed`。不得用行号、文字 hash 或导出顺序生成业务身份。
+2. 每个场景明确 `critical`、`rule_refs`、`success_results` 和既有 `failure_results`；兼容字段 `rules` 必须与引用规则正文一致。不变量使用 `rule_ref`，并通过 `scenario_refs` 指向确实覆盖该规则的场景。缺身份或关联先回战略方确认、更新并重新批准，导出器不猜测。
+3. Handoff v3 的 `package_export` 使用导出 schema。`approvals` 按 `source` 字段及 `handoff` 绑定批准记录，声明 `record_ref`、`gate_id`、`digest_kind`。沿用源角色表的现有门禁；战略、阶段、Spec 分别对应各自批准门禁，原型和视觉基线对应 `gate.user-confirmation`，业务 Ticket 集和完整交接对应源 profile 的交接批准门禁（综合模板使用阶段决策包门禁绑定本次交接）。
+4. 批准记录除既有会签字段，还要在 `artifact_bindings` 中逐项绑定 `{id, version, digest}`。战略/阶段建议 `canonical-json`；普通文件使用 `sha256-bytes`；视觉基线使用 `visual-baseline`。正文中的 `approved` 和可读取批准路径不能替代当前字节的批准绑定。源角色表要求用户决定记录时，接收端必须支持并核验该策略；旧工具缺少该能力时阻断并要求升级，不能按旧规则放行。
+5. `additional_files` 明确补充依赖；`reference_map` 将 `evidence.*` 稳定证据引用解析为仓内路径。源资产、批准记录、证据引用、Markdown 本地链接和显式目录共同形成依赖闭包。HTTP 引用保留为引用，不在导出时下载网页。
+6. `prototype` 指定 `profile`、`preview_root`、`entry_ref`、`verification_ref`、`verification_digest`（验证记录的字节摘要）；H2 另须 `source_root`、`lock_ref` 和 `source_digest`（源码目录树摘要，算法同下述预览树）。源码交付目录不含 node_modules / .git；锁文件与源码一同保存。预览目录须资源闭合，可通过本地静态服务离线浏览。源码、锁文件或验证记录变化须更新交接摘要并重新批准。
+7. 离线浏览验证记录必须有 `network_mode: offline`、实际 `command`、`executed_at`、`exit_code: 0`、`case_ids`、`evidence_refs` 和 `preview_digest`。后者为按路径排序的预览文件 `{path: 相对preview_root路径, sha256: 字节摘要}` 数组的 canonical JSON SHA-256。记录须覆盖视觉基线 case；采集时禁用外网，动态资源与交互由实际浏览器验证。验包不执行来源代码；静态闭包检查不能替代浏览器证据。
+
+## 命令
+
+以下路径参数由当前资产提供，不从目录 glob 猜测业务含义。
+
+```bash
+scripts/strategic-handoff export --source-root <战略项目根> --handoff <仓内交接文件> --output <新目录> --zip
+scripts/strategic-handoff export --source-root <战略项目根> --handoff <新版本交接文件> --output <新目录> --previous <上一目录或ZIP> --zip
+scripts/strategic-handoff verify --bundle <目录或ZIP>
+scripts/strategic-handoff import --bundle <目录或ZIP> --target-root <研发项目根>
+```
+
+目录是逻辑包；ZIP 只负责运输。源资产原始字节进入 payload，清单以 `original_ref → path` 映射原路径到包内路径；原 Handoff 保存在 `handoff.yaml`，源根词汇表保存为 `payload/source-context.snapshot.md`。包中不创建嵌套 `CONTEXT.md`。独立验包时工具在临时目录重建只读验证视图，完成后清理；不把临时源词汇表注册为目标权威。
+
+`manifest.json` 的 `files` 声明所有文件的字节摘要和大小。`bundle_digest` 是删除自身字段后 canonical JSON 的 SHA-256；不把整 ZIP 摘要当逻辑版本摘要。目录与 ZIP 的逻辑摘要相同。源合同的既有语义 digest 另行复核。目录/ZIP 已存在时拒绝覆盖，同身份版本不同内容的导入拒绝；已验过且相同的重复导入返回 `already-imported`。限制为 20,000 文件、512 MiB 展开内容；拒绝 ZIP 路径穿越、重复路径、大小写碰撞和符号链接。
+
+## 下游接收与逐条追溯
+
+导入落盘到 `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` 的成功/失败场景；行字段如下：
+
+- `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`。
+- `deferred`：`reason`、`risk`、`owner`、`followup_ticket_ref`、`verification_plan`、`target_version` 完整。仍阻断依赖切片。
+- `not-applicable`：必须有 `reason` 和可读取 `evidence_refs`，不允许用它掩盖未决冲突。
+- `pending` / `conflict`：阻断相关部分，冲突回交战略方更新和批准。依赖未知或未解释时阻断全部相关切片。
+
+```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 <研发项目根>
+```
+
+整体验证有未落实项时返回 blocked；按切片验证可放行有证据证明不依赖这些项的切片。输出 `block_all`、`blocked_slice_refs`、`issues`、实际消费包摘要与战术摘要。通过只证明结构化映射完整和引用可核验，业务语义仍需独立评审；不能代替 Slice Contract 批准。
+
+每版完整快照可独立消费，差异区分 added / updated / removed。更新须提升交接版本，内容变化的源资产也须提升其版本。接收新版本后，消费校验比较最新已导入源对象摘要；规则变化按行依赖阻断，未映射的新规则扩大阻断，战略责任边界、方案决策、Spec/视觉/原型源码等变化未重新绑定时整体阻断。`upstream-change-impact.json` 是生命周期处理 stale 的证据输入，不直接改 Tracker 或覆盖战术合同。
+
+## 维护与同步
+
+共享脚本和包 schema 以主模板为维护源，通过 `scripts/sync-strategic-handoff-tools` 同步到设计/研发模板；源战略 schema 的离线验证副本由该脚本从 canonical `yss-stage-decision/references` 派生。三仓技能仍只编辑 `.agents/skills`，再生成各 runtime 投影与锁。CLI 快照使用各自同步工具，工作树快照用于集成验证，不代表已发布 commit。
+
+维护者可先同步三个 CLI 快照，再运行 `node .template-source/scripts/verify-strategic-handoff-distribution.mjs`，用临时合成资产验证实际生成实例之间的完整链路；结束后清理临时项目。

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

@@ -9,6 +9,9 @@ profiles:
   release:
     all_groups: true
 core_escalation_patterns:
+  - scripts/lib/user-decision.mjs
+  - scripts/lib/approval-record.mjs
+  - scripts/lib/lifecycle-transition.mjs
   - AGENTS.md
   - yss-project.yaml
   - docs/process/maintenance-intensity.yaml
@@ -34,6 +37,9 @@ core_escalation_patterns:
   - scripts/inspect-maintenance-candidate
   - .template-source/tooling/node/scripts/design-md.mjs
 required_files:
+  - docs/process/schemas/user-decision.schema.json
+  - docs/process/templates/user-decision-template.yaml
+  - .agents/skills/yss-product-lifecycle/references/user-decisions.md
   - yss-project.yaml
   - AGENTS.md
   - CONTEXT.md
@@ -62,11 +68,18 @@ required_files:
   - docs/process/schemas/digital-human-task-package.schema.json
   - docs/process/schemas/maintenance-review-record.schema.json
   - docs/process/schemas/lifecycle-checkpoint.schema.json
+  - docs/process/schemas/context-reconciliation.schema.json
+  - 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/design/schemas/visual-baseline.schema.json
   - docs/process/schemas/subagent-task-package.schema.json
   - docs/process/templates/lifecycle-checkpoint-template.yaml
+  - docs/process/templates/context-reconciliation-template.yaml
   - docs/process/templates/frontend-implementation-plan-template.yaml
   - docs/process/templates/frontend-implementation-verification-template.yaml
+  - docs/process/templates/scaffold-architecture-decisions-template.yaml
+  - docs/design/templates/visual-baseline-template.yaml
   - docs/process/templates/maintenance-checkpoint-template.yaml
   - docs/templates/subagent-task-package-template.md
   - .agents/skills/yss-tactical-design/SKILL.md
@@ -77,9 +90,17 @@ required_files:
   - .agents/skills/yss-tactical-design/references/output-template.md
   - .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs
   - .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
+  - .agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md
+  - .agents/skills/yss-layered-mvc-scaffold-generator/agents/openai.yaml
+  - .agents/skills/yss-layered-mvc-scaffold-generator/references/architecture.md
+  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/generate_scaffold.mjs
+  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/run_scaffold_verification.mjs
+  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/generate_and_verify_scaffold.mjs
+  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/scaffold-generator.test.mjs
   - .agents/skills/yss-prototype-stage/references/product-design-adapter.md
   - .agents/skills/yss-prototype-stage/references/prototype-profile-routing.md
   - .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs
+  - .agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs
   - .agents/skills/yss-prototype-stage/tests/run-scenarios.mjs
   - docs/design/templates/prototype-evidence-template.yaml
   - scripts/lib/template-verification.mjs
@@ -90,12 +111,17 @@ required_files:
   - scripts/verify-template-fast
   - scripts/verify-template-candidate
   - scripts/verify-template
+  - scripts/verify-business-language-scenarios
+  - scripts/verify-frontend-implementation-evidence-scenarios
   - scripts/prepare-maintenance-review
   - scripts/evaluate-maintenance-review-round
   - scripts/cache-template-commit
   - scripts/capture-maintenance-candidate
   - scripts/inspect-maintenance-candidate
 syntax_files:
+  - scripts/lib/user-decision.mjs
+  - scripts/verify-user-decision
+  - scripts/verify-user-decision-scenarios
   - scripts/sync-skills
   - scripts/update-skill-lock
   - scripts/verify-upstream-skill-source
@@ -103,7 +129,18 @@ syntax_files:
   - scripts/generate-lifecycle-artifacts
   - scripts/verify-lifecycle-registry
   - scripts/verify-lifecycle-checkpoint
+  - scripts/lib/context-contract.mjs
+  - scripts/verify-context-contract
+  - scripts/verify-context-contract-scenarios
+  - scripts/verify-business-language-scenarios
+  - scripts/verify-context-reconciliation
+  - scripts/verify-context-reconciliation-scenarios
+  - scripts/verify-grill-with-docs-context-scenarios
+  - scripts/verify-strategic-context-import
+  - scripts/verify-strategic-context-import-scenarios
   - scripts/verify-frontend-implementation-evidence
+  - scripts/verify-scaffold-architecture-decisions
+  - scripts/verify-scaffold-architecture-decision-scenarios
   - scripts/lib/task-package-schema.mjs
   - scripts/lib/json-schema.mjs
   - scripts/lib/task-package.mjs
@@ -154,6 +191,12 @@ syntax_files:
   - scripts/verify-maintenance-review-workflow-scenarios
   - scripts/verify-template-cache-scenarios
 routing:
+  - 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"]
+    groups: [lifecycle, collaboration]
+  - patterns: ["scripts/*strategic-handoff*", "scripts/lib/strategic-handoff*", "scripts/fixtures/strategic-handoff/**", "docs/process/strategic-handoff-package.md", "docs/process/schemas/strategic-handoff-*"]
+    groups: [strategic-handoff-package]
   - patterns: [DESIGN.md, "docs/design/**", ".template-source/tooling/node/scripts/design-md.mjs"]
     groups: [design-system]
   - patterns: [AGENTS.md, CONTEXT.md, yss-project.yaml, package.json, .gitignore, README.md, "docs/**"]
@@ -187,6 +230,14 @@ routing:
   - patterns: ["scripts/**"]
     groups: [hygiene]
 groups:
+  frontend-delivery:
+    commands:
+      - { run: "scripts/verify-frontend-delivery-scenarios" }
+      - { run: "node .template-source/scripts/verify-delivery-harness-distribution.mjs", when: template-source }
+  strategic-handoff-package:
+    commands:
+      - { run: "node --check scripts/lib/strategic-handoff.mjs" }
+      - { run: "scripts/verify-strategic-handoff-package-scenarios" }
   design-system:
     commands:
       - { run: "node .template-source/tooling/node/scripts/design-md.mjs lint DESIGN.md", when: template-source }
@@ -205,6 +256,7 @@ groups:
       - { run: "scripts/verify-skill-registry" }
       - { 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" }
   tactical-design:
     commands:
       - { run: "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs" }
@@ -220,17 +272,27 @@ groups:
     commands:
       - { run: "scripts/verify-digital-human-roles" }
       - { run: "scripts/verify-digital-human-roles-scenarios" }
-      - { run: "scripts/verify-approval-record docs/templates/approval-record-template.yaml" }
+      - { run: "scripts/verify-approval-record --history docs/templates/approval-record-template.yaml" }
       - { run: "scripts/verify-subagent-task-package-scenarios" }
       - { run: "scripts/verify-digital-human-task-package-scenarios" }
       - { run: "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/digital-human-task-package-review-task.yaml", when: template-source }
       - { run: "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/lifecycle-ticket-transition-review-task-package.yaml", when: template-source }
   lifecycle:
     commands:
+      - { run: "scripts/verify-user-decision-scenarios" }
+      - { run: "scripts/verify-context-contract --root . --json" }
+      - { run: "scripts/verify-context-contract-scenarios" }
+      - { run: "node scripts/verify-business-language-scenarios" }
+      - { run: "scripts/verify-context-reconciliation-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-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" }
+      - { run: "scripts/verify-frontend-implementation-evidence-scenarios" }
+      - { run: "scripts/verify-scaffold-architecture-decisions --allow-template docs/process/templates/scaffold-architecture-decisions-template.yaml" }
+      - { run: "scripts/verify-scaffold-architecture-decision-scenarios" }
       - { run: "scripts/verify-lifecycle-scenarios" }
       - { run: "scripts/verify-lifecycle-transition-scenarios" }
   maintenance:
@@ -243,6 +305,8 @@ groups:
       - { run: "scripts/verify-implementation-path-scenarios" }
       - { run: "scripts/verify-repository-scope-scenarios" }
       - { 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-prototype-backend-scaffold-scenarios" }
       - { run: "scripts/verify-matt-yss-integration-scenarios" }
       - { run: "scripts/verify-yss-implementation-contract-compiler-scenarios" }
@@ -252,6 +316,7 @@ groups:
       - { run: "scripts/verify-yss-ui-scenarios" }
       - { run: "scripts/verify-yss-prototype-contract-scenarios" }
       - { run: "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template" }
+      - { run: "node .agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs validate docs/design/templates/visual-baseline-template.yaml --allow-template" }
   governance-release:
     commands:
       - { run: "scripts/verify-governance-release" }

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]