create-yss-spec 3.5.2 → 3.5.3

package/template/scripts/verify-frontend-implementation-evidence

@@ -2,11 +2,12 @@
 import { existsSync, readFileSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
-import { parseArgs } from "node:util";
+import { parseArgs, isDeepStrictEqual } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
 import { validateVisualBaseline } from "../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs";
 import { enforceFrontendDelivery } from "./lib/frontend-delivery-boundary.mjs";
+import {safe,hash} from './lib/strategic-handoff-io.mjs';
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const schemaPath = path.join(repoRoot, ".template-spec/process/schemas/frontend-implementation-evidence.schema.json");
@@ -56,6 +57,25 @@ try {
     if (value.kind === "plan" && value.baseline_case_ids.some((id) => !selectedCaseIds.includes(id))) throw new TypeError("baseline_case_ids 必须属于选定 Visual Baseline cases");
   }
   if (!values["allow-template"] && value.kind === "verification") {
+    const bound = (ref,digest) => {
+      const bytes=readFileSync(safe(root,ref));
+      if(hash(bytes)!==digest)throw new TypeError(`前端证据摘要不一致: ${ref}`);
+      return bytes;
+    };
+    if(!value.implementation_plan || value.interaction_results.some(x=>typeof x==='string'))throw new TypeError('legacy-interaction-binding-missing: 历史交互文字可读；当前完成须重新验证并绑定实施计划与结构化交互证据');
+    const plan=parseDocument(bound(value.implementation_plan.ref,value.implementation_plan.digest).toString(),{uniqueKeys:true}).toJS({maxAliasCount:0});
+    const planSchema=spawnSync('python3',['-c',validator,schemaPath],{cwd:repoRoot,encoding:'utf8',input:JSON.stringify(plan)});
+    if(planSchema.status!==0 || plan.kind!=='plan'||plan.template!==false||plan.status!=='approved'||!isDeepStrictEqual(plan.visual_baseline,value.visual_baseline)||!isDeepStrictEqual(plan.route_and_page_inventory,value.route_and_page_inventory)||!isDeepStrictEqual(plan.pnpm_commands,value.pnpm_commands)||plan.spec_ref!==value.spec_ref||plan.prototype_ref!==value.prototype_ref)throw new TypeError('前端实施计划未批准或与当前验证范围不一致');
+    const states=new Set(), cases=new Set(), pairs=new Set();
+    for(const interaction of value.interaction_results){
+      if(interaction.result!=='pass')throw new TypeError('前端交互验证未通过，构建成功不能替代交互验收');
+      if(!plan.state_cases.includes(interaction.state)||!value.visual_baseline.case_ids.includes(interaction.case_id))throw new TypeError('前端交互不属于已批准计划');
+      const pair=JSON.stringify([interaction.case_id,interaction.state]);if(pairs.has(pair))throw new TypeError('前端交互结果重复');pairs.add(pair);
+      bound(interaction.evidence_ref,interaction.evidence_digest);states.add(interaction.state);cases.add(interaction.case_id);
+    }
+    if(plan.state_cases.some(state=>!states.has(state))||value.visual_baseline.case_ids.some(id=>!cases.has(id)))throw new TypeError('前端交互验收覆盖缺失');
+    if(!value.console_evidence)throw new TypeError('前端 console 证据缺失');
+    bound(value.console_evidence.ref,value.console_evidence.digest);
     if (value.console_warning_check !== "pass") throw new TypeError("前端验证必须通过 console warning 检查");
     if (value.uncovered_differences.length > 0) throw new TypeError("存在未解释视觉差异，不能通过前端实现还原验证");
     if (value.independent_review?.status !== "approved") throw new TypeError("前端验证必须通过独立 UI fidelity review");
@@ -66,8 +86,11 @@ try {
       if (item.result !== "pass" || item.uncovered_difference !== false) throw new TypeError(`${item.case_id} 存在未通过或未解释差异`);
       for (const field of ["baseline_image_ref", "implementation_image_ref", "diff_ref"]) if (!existsSync(path.resolve(root, item[field]))) throw new TypeError(`${item.case_id}.${field} 不可读取`);
       if (item.mask_ref !== "not-applicable" && !existsSync(path.resolve(root, item.mask_ref))) throw new TypeError(`${item.case_id}.mask_ref 不可读取`);
+      bound(item.implementation_image_ref,item.implementation_image_digest);bound(item.diff_ref,item.diff_digest);
     }
     if (value.actual_verification.some((item) => item.exit_code !== 0)) throw new TypeError("pnpm fresh verification 存在非零退出码");
+    if(value.pnpm_commands.some(command=>!value.actual_verification.some(row=>row.command===command)))throw new TypeError('pnpm 验证命令覆盖缺失');
+    for(const row of value.actual_verification){if(!Number.isFinite(Date.parse(row.executed_at)))throw new TypeError('实际执行时间无效');bound(row.evidence_ref,row.evidence_digest);}
   }
   process.stdout.write(`前端实现还原 ${value.kind} 验证通过\n`);
 } catch (error) {

package/template/scripts/verify-maintenance-research

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {parseArgs} from 'node:util';
+import path from 'node:path';
+import {readRepositoryMode} from './lib/repository-mode.mjs';
+import {recordResearchVerification} from './lib/maintenance-research.mjs';
+try {
+  const {values, positionals} = parseArgs({allowPositionals: true, options: {root: {type: 'string'}, output: {type: 'string'}}, strict: true});
+  const root = path.resolve(values.root || '.');
+  if (readRepositoryMode(root) !== 'template-source' || positionals.length !== 2 || !values.output) throw Error('用法: verify-maintenance-research <brief> <evidence> --output <新目录> [--root <模板根>]');
+  const result = recordResearchVerification(root, ...positionals, values.output);
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+  if (result.exit_code !== 0) process.exitCode = 1;
+} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/template/skills-lock.json

@@ -18,7 +18,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "15953d4f0191b06e026df285a95f4535d3243151"
+      "revision": "ed8865b79dbe1cb59277fe643c3cb27139674530"
     },
     "ayghri/i-have-adhd": {
       "revision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02"
@@ -72,7 +72,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/codebase-design/SKILL.md",
-        "effectiveHash": "aa378da82d844fe251092cfed0a6aab1e2fd79fe8973ad6986e9623f48d45569",
+        "effectiveHash": "fb5a146a98a69cf0c5142f4e59d22fd937678d6436de3fe50be9724f14340c16",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "9f457cc65ef2d70eb5b8a44a4dae2b139840078b6596a67ee8c4e95f5a0e6f5c",
         "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -215,7 +215,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/frontend-commit/SKILL.md",
-        "effectiveHash": "a8e45f6ac5f6cbdf36b54e5850a58e6fbec997b4301dee3e928ab23a38de4457",
+        "effectiveHash": "aef8df2cb8114a35740144563981788443e7566619e6c489e64efcf2dc6cd81c",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "ffc1c7813607705c7c1158f4c5d3111aca79e73f1843e33bbc95eda9b5c726de",
         "adaptationRef": ".template-source/agents/yss-ui-skills-integration.md",
@@ -226,14 +226,11 @@
           ".pi/skills"
         ]
       },
-      "grill-with-docs": {
-        "source": "mattpocock/skills",
-        "sourceType": "github",
-        "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
-        "effectiveHash": "2006f65f386e79ff37c2c3294efe146e2e546845cf52e1571340dcb2a81a0df3",
-        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
-        "upstreamHash": "6b1292031c4f38a11309b9dad9be1141c1921c6edf86d1ae6da8b048fa71a349",
-        "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
+      "git-commit-core": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/git-commit-core/SKILL.md",
+        "effectiveHash": "6e08d4731740660abd7e02f8ae8e323e2a10fd26ef349370f567e0bbeafa4f89",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -313,26 +310,11 @@
           ".pi/skills"
         ]
       },
-      "improve-codebase-architecture": {
-        "source": "mattpocock/skills",
-        "sourceType": "github",
-        "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md",
-        "effectiveHash": "803482a33ea83cb12ac39a3497c7712cb5a4520b756532f9eae34c6e09673aa7",
-        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
-        "upstreamHash": "86f5e0413fa5b42b8e954858a09ce5a73187c61169f1b3b199bc79416fd78086",
-        "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "java-backend-commit": {
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/java-backend-commit/SKILL.md",
-        "effectiveHash": "58ec04a7da69bb7c73ae080600f71630710d56f4b3ca742d0992c5373891170f",
+        "effectiveHash": "0d50beb6563ff17b87ef2726b6f3ed53c4d686e210ff02a8692582dd6d8eb79f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -344,7 +326,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/llm-wiki/SKILL.md",
-        "effectiveHash": "196036b81aecac07eaebe9f4787f145d2e521d6ac24d073b8c8260b371761f49",
+        "effectiveHash": "58dda4429d0ed50b7c1fe316ea2b839667a059b134eb42a66224de67d003b0c3",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -394,7 +376,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/prototype/SKILL.md",
-        "effectiveHash": "52b83cd3b9f4ef74884674209829cd02b3e00d77c5e304ab0d11a1508e9d347c",
+        "effectiveHash": "c6e9016fbe694e026544d7439ee5914ef5fedf65c5609deb562b2794cfcf7b49",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "492e4433fcd9cf88c0854aba063829ee248b208849e5827a45da8424199fd10f",
         "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -410,7 +392,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
         "effectiveHash": "2bae1a26b95eb84c7e0eec6b624fd1b064a258424a69798c797052095aa088b3",
-        "sourceRevision": "15953d4f0191b06e026df285a95f4535d3243151",
+        "sourceRevision": "ed8865b79dbe1cb59277fe643c3cb27139674530",
         "upstreamHash": "68c6e4613354ad919bab3d718739f1cc6930d8df0777d6f7db90435bdae77d52",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -439,7 +421,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md",
-        "effectiveHash": "531a20a49393a76b39fb8325522ca14bf4257750f202d49f74be64bd51208429",
+        "effectiveHash": "6ec7cc4d7665033c66f9de3511d215ffc357b7312b0ac932ed7ec1d8e8fd8d30",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "80cd6b5be4f67913f1b10f5acd97fccaeb6401682ae7ff3a971460cb73d86cbe",
         "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -480,21 +462,6 @@
           ".pi/skills"
         ]
       },
-      "to-questionnaire": {
-        "source": "mattpocock/skills",
-        "sourceType": "github",
-        "skillPath": "skills/productivity/to-questionnaire/SKILL.md",
-        "effectiveHash": "a7b7a3b4792028114028512becfa81b10e374d34f36c00772446b0becc348083",
-        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
-        "upstreamHash": "915ac22f1133fd4a7899ac6536e704cae57f1104d45745b32193d1572332868f",
-        "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "to-spec": {
         "source": "mattpocock/skills",
         "sourceType": "github",
@@ -552,21 +519,6 @@
           ".pi/skills"
         ]
       },
-      "wait-what": {
-        "source": "mattpocock/skills",
-        "sourceType": "github",
-        "skillPath": "skills/productivity/wait-what/SKILL.md",
-        "effectiveHash": "8c48d704adc212453fbe52ffb196f858e006e644fb5eb1e4b7fc83f27b38e602",
-        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
-        "upstreamHash": "3f2e7e2ce8820380c08df1d6f2d8dc6aaefe5c2857d00a7190990c62d4039316",
-        "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
-        "targets": [
-          ".agents/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".pi/skills"
-        ]
-      },
       "wayfinder": {
         "source": "mattpocock/skills",
         "sourceType": "github",
@@ -692,7 +644,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
         "effectiveHash": "109f131d03c5a970f88a01472b575397090aac5029a666e23e021ec6d05d9526",
-        "sourceRevision": "15953d4f0191b06e026df285a95f4535d3243151",
+        "sourceRevision": "ed8865b79dbe1cb59277fe643c3cb27139674530",
         "upstreamHash": "ae040c639056ecf2160f1231e30ac67360bd8aa1e030eac778520dd56af8068c",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -817,7 +769,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "82e06da43e2fcaaa30e27e36e9b6622c02ad553a76cd9430fc75cf9315e029e4",
+        "effectiveHash": "042be2c919a2aca3df70847051235cffee97a4ff76dca750ff18c857a2732c7f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -877,7 +829,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "2b4da4d116a88b05ac330290964af471bf2c0887d944797266aaf0cc9e7cdb36",
+        "effectiveHash": "97956a27c96e05eca6992b19db0e031b531ef41faa440d1915af048b5c63f81c",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -890,7 +842,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
         "effectiveHash": "ba84f0bd9e469eee9a6d659bf2f5f1848761ae0d13ae46541d7bd668c31e8379",
-        "sourceRevision": "15953d4f0191b06e026df285a95f4535d3243151",
+        "sourceRevision": "ed8865b79dbe1cb59277fe643c3cb27139674530",
         "upstreamHash": "7781df6293f381bd40781d2f6b163cf824f959624b1c34aeb9c241d6be709c89",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -916,7 +868,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/research/SKILL.md",
-        "effectiveHash": "38059a4a505dcf1b674f324e8f507e8564f8ba036e417129a7bbc2727b5209a3",
+        "effectiveHash": "9b3d0d3f83acefb0ffef51c671b124bb0be732e23c27795658fbd3c6b699bada",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "75b7f9bbd7ccff6755a006f8b25d319a46ecbf6bd4b4c3323965ed9cb65e78ff",
         "adaptationRef": ".template-source/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -968,7 +920,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
         "effectiveHash": "2284f6060799fb74f7396b27a273669f78d62a6ac24f9acc533770b71198da18",
-        "sourceRevision": "15953d4f0191b06e026df285a95f4535d3243151",
+        "sourceRevision": "ed8865b79dbe1cb59277fe643c3cb27139674530",
         "upstreamHash": "6cd0ed5aa21d68cea871d0bd202beb3b28cca2981f075ad9c24667ac030118d2",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1110,15 +1062,6 @@
     },
     "platform": {
       ".codex/skills": {
-        "data-analytics": {
-          "source": "project",
-          "sourceType": "local",
-          "skillPath": ".codex/skills/data-analytics/SKILL.md",
-          "effectiveHash": "9ed415498a99f8ea18064f488ae58496608cc8ba07dd0326e46bc021e14e1275",
-          "targets": [
-            ".codex/skills"
-          ]
-        },
         "product-design": {
           "source": "project",
           "sourceType": "local",

package/template.manifest.json

@@ -92,9 +92,13 @@
     "scripts/lib/skill-governance.mjs",
     "scripts/lib/template-commit-cache.mjs",
     "scripts/lib/template-verification.mjs",
-    "scripts/lib/template-verification-runner.mjs"
+    "scripts/lib/template-verification-runner.mjs",
+    "scripts/lib/verification-selection.mjs",
+    "scripts/lib/verification-report.mjs"
+  ],
+  "excludePathSuffixes": [
+    "-scenarios"
   ],
-  "excludePathSuffixes": ["-scenarios"],
   "renderPaths": [
     ".gitignore",
     "AGENTS.md",
@@ -128,44 +132,129 @@
     "version": 1,
     "default": "managed",
     "rules": [
-      { "pattern": ".git/**", "ownership": "protected" },
-      { "pattern": ".template-source/**", "ownership": "protected" },
-      { "pattern": ".cursor/environment.json", "ownership": "protected" },
-      { "pattern": ".gitmodules", "ownership": "user-owned" },
-      { "pattern": ".gitignore", "ownership": "managed-customizable" },
-      { "pattern": "apps/**", "ownership": "user-owned" },
-      { "pattern": "packages/**", "ownership": "user-owned" },
-      { "pattern": "wiki/**", "ownership": "user-owned" },
-      { "pattern": "docs/reviews/**", "ownership": "user-owned" },
-      { "pattern": "docs/.scratch/**", "ownership": "user-owned" },
-      { "pattern": ".template-spec/agents/issue-tracker.md", "ownership": "managed-customizable" },
-      { "pattern": "yss-project.yaml", "ownership": "generated" },
-      { "pattern": "skills-lock.json", "ownership": "generated" },
-      { "pattern": "yss-public-skills.json", "ownership": "generated" },
-      { "pattern": ".agents/skills/.yss-skills-manifest.json", "ownership": "generated" },
-      { "pattern": "AGENTS.md", "ownership": "managed-customizable" },
-      { "pattern": "CONTEXT.md", "ownership": "managed-customizable" },
-      { "pattern": "DESIGN.md", "ownership": "managed-customizable" },
-      { "pattern": "README.md", "ownership": "user-owned" }
+      {
+        "pattern": ".git/**",
+        "ownership": "protected"
+      },
+      {
+        "pattern": ".template-source/**",
+        "ownership": "protected"
+      },
+      {
+        "pattern": ".cursor/environment.json",
+        "ownership": "protected"
+      },
+      {
+        "pattern": ".gitmodules",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": ".gitignore",
+        "ownership": "managed-customizable"
+      },
+      {
+        "pattern": "apps/**",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": "packages/**",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": "wiki/**",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": "docs/reviews/**",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": "docs/.scratch/**",
+        "ownership": "user-owned"
+      },
+      {
+        "pattern": ".template-spec/agents/issue-tracker.md",
+        "ownership": "managed-customizable"
+      },
+      {
+        "pattern": "yss-project.yaml",
+        "ownership": "generated"
+      },
+      {
+        "pattern": "skills-lock.json",
+        "ownership": "generated"
+      },
+      {
+        "pattern": "yss-public-skills.json",
+        "ownership": "generated"
+      },
+      {
+        "pattern": ".agents/skills/.yss-skills-manifest.json",
+        "ownership": "generated"
+      },
+      {
+        "pattern": "AGENTS.md",
+        "ownership": "managed-customizable"
+      },
+      {
+        "pattern": "CONTEXT.md",
+        "ownership": "managed-customizable"
+      },
+      {
+        "pattern": "DESIGN.md",
+        "ownership": "managed-customizable"
+      },
+      {
+        "pattern": "README.md",
+        "ownership": "user-owned"
+      }
     ]
   },
   "customizationPolicy": {
     "version": 1,
     "defaultStrategy": "replace-with-force",
     "rules": [
-      { "pattern": ".gitignore", "strategy": "manual" },
-      { "pattern": ".template-spec/agents/issue-tracker.md", "strategy": "manual" },
-      { "pattern": "CONTEXT.md", "strategy": "manual" },
-      { "pattern": "DESIGN.md", "strategy": "manual" }
+      {
+        "pattern": ".gitignore",
+        "strategy": "manual"
+      },
+      {
+        "pattern": ".template-spec/agents/issue-tracker.md",
+        "strategy": "manual"
+      },
+      {
+        "pattern": "CONTEXT.md",
+        "strategy": "manual"
+      },
+      {
+        "pattern": "DESIGN.md",
+        "strategy": "manual"
+      }
     ]
   },
   "generatorPolicy": {
     "version": 1,
     "rules": [
-      { "pattern": "yss-project.yaml", "generatorId": "repository-identity", "generatorVersion": 1 },
-      { "pattern": "skills-lock.json", "generatorId": "skills-lock", "generatorVersion": 1 },
-      { "pattern": "yss-public-skills.json", "generatorId": "public-skills", "generatorVersion": 1 },
-      { "pattern": ".agents/skills/.yss-skills-manifest.json", "generatorId": "skills-manifest", "generatorVersion": 1 }
+      {
+        "pattern": "yss-project.yaml",
+        "generatorId": "repository-identity",
+        "generatorVersion": 1
+      },
+      {
+        "pattern": "skills-lock.json",
+        "generatorId": "skills-lock",
+        "generatorVersion": 1
+      },
+      {
+        "pattern": "yss-public-skills.json",
+        "generatorId": "public-skills",
+        "generatorVersion": 1
+      },
+      {
+        "pattern": ".agents/skills/.yss-skills-manifest.json",
+        "generatorId": "skills-manifest",
+        "generatorVersion": 1
+      }
     ]
   }
 }

package/template.snapshot.json

@@ -3,13 +3,12 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "13d8d9c9304a73d65d1e2e6842744b9578f4876a",
-  "templateCommit": "13d8d9c9304a73d65d1e2e6842744b9578f4876a",
+  "requestedRef": "f6826c35ceb3f24795c2dd341354559bfa960ae4",
+  "templateCommit": "f6826c35ceb3f24795c2dd341354559bfa960ae4",
   "sourceState": "committed",
-  "manifestHash": "d5a3b1e8f7b1bfe2f616acbe31abb4710927cd61d432d5e07990c59149435f3d",
+  "manifestHash": "08a47c580dbe9c3b5a3b9470e1d5916069133d89c3f83bc2b30224b35bf6605f",
   "encodedPaths": {
     ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
-    ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
@@ -17,6 +16,6 @@
     ".gitignore": "__yss_dotfile__.gitignore",
     ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "747545a4222871b8cd201d0b42b64a946bb4f11f3fd63e9f5434bcc32a8b8a5a",
-  "generatedAt": "2026-09-27T14:53:54.985Z"
+  "snapshotHash": "086dde475b4976d3e26499a4d91c03ccb59905bfa44f36dfd9c2535348513e7d",
+  "generatedAt": "2026-09-28T13:56:15.580Z"
 }

package/template/.agents/skills/grill-with-docs/SKILL.md

@@ -1,20 +0,0 @@
----
-name: grill-with-docs
-description: Use when the user explicitly requests a relentless design interview that must preserve resolved glossary terms, ADR-worthy decisions, and factual research evidence.
-disable-model-invocation: true
----
-
-Call the Skill tool with `grilling`, then call it separately with `domain-modeling`. This compatibility entry does not define a second glossary format: it consumes `domain-modeling/CONTEXT-FORMAT.md`, the repository Context Contract validator, and the lifecycle reconciliation contract.
-
-## Output Contract
-
-1. Read `yss-project.yaml` and the root glossary before the first round, then run `scripts/verify-context-contract --root . --json`. Missing or lowercase root files, nested `CONTEXT.md`, `CONTEXT-MAP.md`, unsupported schema, absolute/cross-repository references, and Markdown pseudo-anchors are `blocked` or `migration-required`.
-2. Separate discoverable facts from user decisions; investigate facts instead of asking the user.
-3. Ask the entire current decision frontier, with a recommendation for every question, then wait.
-4. Keep candidate or disputed terms in the Plan decision frontier. Only after confirmation, use `domain-modeling` to record true stable glossary entries in the repository root's single, case-sensitive `CONTEXT.md`; business rows use the five-column format and `<ContextId>/<EnglishIdentifier>` identity. Non-`Global` Context IDs must come from the approved business responsibility areas in the business-boundary asset.
-5. Create an ADR only when the decision is hard to reverse, surprising without context, and a real trade-off.
-6. Persist factual research/validation records in the repository's existing review or research convention.
-7. For `project-instance`, before requesting approval or returning a next work unit, generate and validate `context_reconciliation` with a readable ref, `document_digest`, `referenced_terms_digest`, and `term_refs`. Unresolved candidates, scope conflicts, aliases, or digest drift are `blocked`; reconciliation does not create another gate. For `template-source`, do not add fictional business terms and return a reasoned `not-applicable` after validating the template contract.
-8. Do not modify implementation skills, contracts, or code until the user confirms shared understanding and the intended change scope.
-
-The final grilling round must list confirmed decisions, unresolved assumptions, documents changed, `context_reconciliation` status/ref, and the next authorized action, then return control to `yss-product-lifecycle` (or the active YSS lifecycle orchestrator). It cannot approve an asset or advance a stage itself. A research note is evidence, not an architecture approval or release claim.

package/template/.agents/skills/grill-with-docs/agents/openai.yaml

@@ -1,5 +0,0 @@
-interface:
-  display_name: "Grill with Docs"
-  short_description: "Grill a design and write its docs"
-policy:
-  allow_implicit_invocation: false

package/template/.agents/skills/improve-codebase-architecture/agents/openai.yaml

@@ -1,5 +0,0 @@
-interface:
-  display_name: "Improve Codebase Architecture"
-  short_description: "Find and grill architecture improvements"
-policy:
-  allow_implicit_invocation: false

package/template/.agents/skills/prototype/UI.md

@@ -1,112 +0,0 @@
-# UI Prototype
-
-Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
-
-If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
-
-## When this is the right shape
-
-- "What should this page look like?"
-- "I want to see a few options for this dashboard before committing."
-- "Try a different layout for the settings screen."
-- Any time the user would otherwise spend a day picking between three vague mockups in their head.
-
-## Two sub-shapes — strongly prefer sub-shape A
-
-A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
-
-### Sub-shape A — adjustment to an existing page (preferred)
-
-The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
-
-If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
-
-### Sub-shape B — a new page (last resort)
-
-Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
-
-Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
-
-Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
-
-In both sub-shapes the floating bottom bar is identical.
-
-## Process
-
-### 1. State the question and pick N
-
-Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
-
-Write down the plan in one line, in the prototype's location or a top-of-file comment:
-
-> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
-
-This works whether the user is here to push back or not.
-
-### 2. Generate radically different variants
-
-Draft each variant. Hold each one to:
-
-- The page's purpose and the data it has access to.
-- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
-- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
-
-Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
-
-### 3. Wire them together
-
-Create a single switcher component on the route:
-
-```tsx
-// pseudo-code — adapt to the project's framework
-const variant = searchParams.get('variant') ?? 'A';
-return (
-  <>
-    {variant === 'A' && <VariantA {...data} />}
-    {variant === 'B' && <VariantB {...data} />}
-    {variant === 'C' && <VariantC {...data} />}
-    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
-  </>
-);
-```
-
-For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
-
-For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
-
-### 4. Build the floating switcher
-
-A small fixed-position bar at the bottom-centre of the screen with three pieces:
-
-- **Left arrow** — cycles to the previous variant (wraps around).
-- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
-- **Right arrow** — cycles forward (wraps around).
-
-Behaviour:
-
-- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
-- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
-- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
-- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
-
-Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
-
-### 5. Hand it over
-
-Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
-
-### 6. Capture the answer and clean up
-
-Once a variant has won, capture the answer — which variant and why — then capture the prototype the way the [SKILL](SKILL.md) describes. Fold the winner into the real code and move the rest onto the throwaway branch, not into main:
-
-- **Sub-shape A** — fold the winner into the existing page; drop the losing variants and the switcher from main.
-- **Sub-shape B** — promote the winning variant to a real route; drop the throwaway route and the switcher from main.
-
-The full set of variants is the primary source, so it lands on the throwaway branch, not the bin — variant components and the switcher left in the main branch rot fast and confuse the next reader.
-
-## Anti-patterns
-
-- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
-- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
-- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
-- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.