create-yss-spec 3.4.8 → 3.4.10

package/template/scripts/stage-tracking

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { readFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { parseYaml } from './lib/stage-tracking.mjs';
+import { checkTracking, planTracking, applyTracking } from './lib/stage-tracking-migration.mjs';
+try {
+  const { values, positionals } = parseArgs({ allowPositionals: true, strict: true, options: { root: { type: 'string' }, checkpoint: { type: 'string' }, items: { type: 'string' }, plan: { type: 'string' }, refresh: { type: 'boolean', default: false } } });
+  const root = path.resolve(values.root || path.resolve(import.meta.dirname, '..'));
+  const command = positionals[0];
+  if (positionals.length !== 1 || !['check', 'plan', 'apply'].includes(command)) throw new Error('用法: stage-tracking check|plan --root <项目> --checkpoint <相对路径> [--items <yaml>] [--refresh]；apply --root <项目> --plan <json>');
+  let result;
+  if (command === 'apply') {
+    if (!values.plan || values.checkpoint || values.items || values.refresh) throw new Error('apply 只接受 --root 和 --plan');
+    result = applyTracking(root, JSON.parse(readFileSync(values.plan, 'utf8')));
+  } else {
+    if (!values.checkpoint || values.plan) throw new Error('check/plan 需要 --checkpoint');
+    if (command === 'check' && (values.items || values.refresh)) throw new Error('check 不接受写入意图参数');
+    const input = values.items ? parseYaml(readFileSync(values.items, 'utf8')) : [];
+    if (!Array.isArray(input)) throw new Error('--items 必须是工作项数组');
+    result = command === 'check' ? checkTracking(root, values.checkpoint) : planTracking(root, { checkpoint_ref: values.checkpoint, items: input, refresh: values.refresh });
+    if (result.status === 'blocked' || (result.status === 'missing-checkpoint' && result.enabled)) process.exitCode = 1;
+  }
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+} catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

package/template/scripts/strategic-consumer-entry

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import path from 'node:path';
+import { readFileSync, existsSync } from 'node:fs';
+import { openBundle, openDelivery, importBundle } from './lib/strategic-handoff.mjs';
+import { read, safe, ensure, hash, schema, project } from './lib/strategic-handoff-io.mjs';
+import { consumerEntry } from './lib/strategic-handoff-routing.mjs';
+
+try {
+  const { values } = parseArgs({ options: { root: { type: 'string' }, receipt: { type: 'string' }, bundle: { type: 'string' } } });
+  const root = project(values.root);
+  ensure(Boolean(values.receipt) !== Boolean(values.bundle), 'provide-receipt-or-bundle');
+  const inspect = b => {
+    ensure(b.handoff.schema_version === 5, 'design-entry-requires-handoff-v5');
+    const route = b.handoff.consumer_routes.find(item => item.capability === 'backend-technical-design');
+    ensure(route && route.activation !== 'not-applicable', 'backend-consumer-route-not-active');
+    return { ...consumerEntry(root, route.capability, route.entry_work_unit), route_id: route.route_id,
+      bundle_id: b.manifest.bundle_id, version: b.manifest.version, bundle_digest: b.manifest.bundle_digest };
+  };
+  let receiptRef = values.receipt;
+  if (values.bundle) {
+    const input = path.resolve(values.bundle);
+    // Validate the destination route before any import writes.
+    if (existsSync(path.join(input, 'delivery-record.json'))) await openDelivery(input, inspect);
+    else await openBundle(input, inspect);
+    receiptRef = (await importBundle({ bundle: input, targetRoot: root })).receipt_ref;
+  }
+  const receipt = read(safe(root, receiptRef));
+  ensure([2, 3].includes(receipt.schema_version), 'design-entry-receipt-version');
+  schema(receipt, receipt.schema_version === 3 ? 'docs/process/schemas/strategic-handoff-import-receipt-v3.schema.json' : 'docs/process/schemas/strategic-handoff-import-receipt.schema.json');
+  const base = `docs/handoffs/${receipt.bundle_id}/${receipt.version}`;
+  ensure(receiptRef === `${base}/import-receipt.json` && receipt.package_ref === `${base}/package`, 'design-entry-receipt-path');
+  const entry = await openBundle(safe(root, receipt.package_ref), inspect);
+  ensure(entry.bundle_id === receipt.bundle_id && entry.version === receipt.version && entry.bundle_digest === receipt.bundle_digest, 'design-entry-receipt-drift');
+  const route = receipt.routes.find(item => item.capability === entry.capability);
+  ensure(route?.route_id === entry.route_id && route.activation !== 'not-applicable', 'design-entry-receipt-route');
+  if (receipt.schema_version === 3) {
+    ensure(receipt.source_delivery_record_ref === `${base}/source-delivery-record.json`, 'design-entry-delivery-path');
+    const bytes = readFileSync(safe(root, receipt.source_delivery_record_ref));
+    ensure(hash(bytes) === receipt.source_delivery_record_sha256, 'design-entry-delivery-drift');
+    const record = JSON.parse(bytes);
+    ensure(record.bundle_digest === receipt.bundle_digest && record.handoff.id === receipt.bundle_id && record.handoff.version === receipt.version, 'design-entry-delivery-binding');
+  }
+  console.log(JSON.stringify({ result: values.bundle ? 'design-imported' : 'design-inputs-verified', ...entry,
+    import_receipt_ref: receiptRef, next_work_unit: entry.target_work_unit, ready_for_agent: false,
+    stage_verification_required: true, pending: ['target-context-reconciliation', 'engineering-design-and-consumption', 'slice-contract-approval'] }, null, 2));
+} catch (error) { console.error(JSON.stringify({ result: 'blocked', error: error.message, ready_for_agent: false })); process.exitCode = 1; }

package/template/scripts/verify-context-reconciliation

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
+import {withValidationPhase,validationDependencies} from "./lib/validation-phase.mjs";
 import { parseArgs } from "node:util";
 import { verifyContextReconciliation } from "./lib/context-reconciliation.mjs";
 try {
-  const { values, positionals } = parseArgs({ options: { root: { type: "string", default: process.cwd() } }, allowPositionals: true, strict: true });
+  const { values, positionals } = parseArgs({ options: { "validation-dependencies": {type:"boolean",default:false}, root: { type: "string", default: process.cwd() } }, allowPositionals: true, strict: true });
   if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-context-reconciliation [--root <repo>] <record.yaml|json>");
-  verifyContextReconciliation(positionals[0], { root: values.root });
-  process.stdout.write("Context reconciliation 验证通过\n");
+  const result=withValidationPhase({root:values.root,purpose:"context-reconciliation",readOnly:true},()=>{verifyContextReconciliation(positionals[0], { root: values.root });return values["validation-dependencies"]?{result:"verified",validation_dependencies:validationDependencies()}:null;});
+  process.stdout.write(result?JSON.stringify(result)+"\n":"Context reconciliation 验证通过\n");
 } catch (error) {
   process.stderr.write(`Context reconciliation 验证失败: ${error.message}\n`);
   process.exitCode = 1;

package/template/scripts/verify-lifecycle-checkpoint

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { assertStageTracking } from './lib/stage-tracking.mjs';
 import { readFileSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
@@ -6,6 +7,7 @@ import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
 import { assertCheckpointApprovals, assertCheckpointUserDecisions } from "./lib/approval-record.mjs";
+import { loadExecutionScope, assertScopeWorkUnit, verifyDeliveryTerminal } from './lib/lifecycle-execution-scope.mjs';
 import { assertPlanCheckpoint } from "./lib/plan-spec-entry.mjs";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
@@ -32,6 +34,14 @@ try {
   const value = document.toJS({ maxAliasCount: 0 });
   const result = spawnSync("python3", ["-c", validator, schemaPath], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
   if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
+  if(loadExecutionScope(root)) {
+    if(value.status==='completed') {
+      if(value.next_work_unit!==null)throw new TypeError('后端终点不得继续其他工作单元');
+      verifyDeliveryTerminal(root);
+    } else if(value.next_work_unit) assertScopeWorkUnit(value.next_work_unit,{root,readOnly:value.mode==='audit'||value.mode==='route'});
+    else if(value.mode==='resume'||value.mode==='orchestrate') assertScopeWorkUnit('work-unit.entry-triage',{root});
+  }
+  assertStageTracking(value, { root, checkpointRef: path.relative(root, sourcePath), nextWorkUnit: value.next_work_unit, entering: value.mode === 'resume' || value.mode === 'orchestrate' });
   assertCheckpointApprovals(value, sourcePath);
   assertPlanCheckpoint(value);
   assertCheckpointUserDecisions(value);

package/template/skills-lock.json

@@ -18,7 +18,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "77a94e9fc8087f6c46f8dcfe30e362ee84b1f86a"
+      "revision": "9e17922a0a718e5bd1845ddab11850a2f43becad"
     },
     "ayghri/i-have-adhd": {
       "revision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02"
@@ -30,7 +30,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/alibaba-java-code-style/SKILL.md",
-        "effectiveHash": "5ba8d937bd75a2405dc4292ecbf50fb658dcfeba180e8e31f99b1ad00a1cb75b",
+        "effectiveHash": "d66bba428307dd7e7ae3778bfc8a932ea4da74e57b14470bb3619b7e82aee51a",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -42,7 +42,7 @@
         "source": "tt-a1i/archify",
         "sourceType": "github",
         "skillPath": "archify/SKILL.md",
-        "effectiveHash": "1bd1b10fe185d6a6eef0b3ea79a6e885b5fd66c02a3b9faba01cd0be6c35cd2f",
+        "effectiveHash": "27b675bbf8e5362b91dcd99031d93252a524723543be17a6582dc381b52711c3",
         "sourceRevision": "199360cc6687a7857b54dd188d4922b09e466a4b",
         "upstreamHash": "a04c5666d6a5f46bc6f220a36b851e96aaa69ff0630049631364fb23fa5b2ee5",
         "adaptationRef": "docs/agents/archify-integration.md",
@@ -57,7 +57,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/code-review/SKILL.md",
-        "effectiveHash": "0f5a98824850f868c9d5c3579b425c831604413682397d4f49f77e68ef3bcea9",
+        "effectiveHash": "827e72c73d9cc8b8dea4d91b74c8d876dcd552c4bf33c6cfe89ae706ab1e028e",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "12daafb9c4f77deb3c3303dc2e6f8a3c2a0ff7928fc004af959ba18b8bd38068",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -72,7 +72,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/codebase-design/SKILL.md",
-        "effectiveHash": "ac0b3fab747b74bcf9b5fd21425c10853417e2097a45cdda96734991e8a44bf5",
+        "effectiveHash": "aa378da82d844fe251092cfed0a6aab1e2fd79fe8973ad6986e9623f48d45569",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "9f457cc65ef2d70eb5b8a44a4dae2b139840078b6596a67ee8c4e95f5a0e6f5c",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -87,7 +87,7 @@
         "source": "competitive-intelligence",
         "sourceType": "local",
         "skillPath": "sales/skills/competitive-intelligence/SKILL.md",
-        "effectiveHash": "df1473dfd96b1a3ba63ef929917973b613988edf62193b5b82d734de2e8418cd",
+        "effectiveHash": "e26ac60129c604237c16c0275e2179f9986ab4ca1f1f2f45b17be3c3c0a9f4a8",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -111,7 +111,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/diagnosing-bugs/SKILL.md",
-        "effectiveHash": "15b8e2836976665738db7057678cb3a9ff63a8ab8d82274594bd8b068a523915",
+        "effectiveHash": "74159ec23a5ee37cfe5a0ba35285ac24f05a7d27a8906999b7846c7bb61d9b4d",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "bcdaec9e1033901c396437fcb102161d8ad3cd87632007aaf270b19e03e70117",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -156,9 +156,10 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/formily-foundation/SKILL.md",
-        "effectiveHash": "7736711494f368750d930e96f918bc8ae2d8a0c6b7fd404be165d03441546d9d",
+        "effectiveHash": "fb86b350759efebac27880cad2b9822cbeaa686bb80240dd7c44a83eca3a15e7",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "7736711494f368750d930e96f918bc8ae2d8a0c6b7fd404be165d03441546d9d",
+        "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -199,9 +200,10 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/formily-step-flow/SKILL.md",
-        "effectiveHash": "600a0a9a72f3bcb30db83d274b8d1082c036adf10c197dff616f76bec1a33d80",
+        "effectiveHash": "4f8b5d5e71b9d8394a23fe68779d540fd839c0221103c8c112a29e791a359712",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "600a0a9a72f3bcb30db83d274b8d1082c036adf10c197dff616f76bec1a33d80",
+        "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -213,7 +215,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/frontend-commit/SKILL.md",
-        "effectiveHash": "a503a538b9ea6a5134213c87b07e69c935f480bf9bd9b166328969cfb3d86f16",
+        "effectiveHash": "a8e45f6ac5f6cbdf36b54e5850a58e6fbec997b4301dee3e928ab23a38de4457",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "ffc1c7813607705c7c1158f4c5d3111aca79e73f1843e33bbc95eda9b5c726de",
         "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
@@ -258,7 +260,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/productivity/grilling/SKILL.md",
-        "effectiveHash": "579b0a459f1ec960ef6a489811a285f74b4a19220d0bc8d0c1cde2c4d8bfaabb",
+        "effectiveHash": "594b86d3624c3d1d78fea19afed61923856f410843132b9ccadc90f5c1a4ca52",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "0ca4cfe5105d79c6ef6755491492e056c43e88b82666376d8ecd7fac695d96e6",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -303,7 +305,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/implement/SKILL.md",
-        "effectiveHash": "219f59dbfe734ac06ff1e29a21deaf82bbecbac3186fc1f9fcbb076dcf329d70",
+        "effectiveHash": "ec0a73124072d51a16c0dc7ff4825c38a8d903554290d55cc9a7f3dfd2525592",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "b49a049477c7eec7f8dd90745dbc3f27bf75617b832d5b5f33c55aab7638a12e",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -318,7 +320,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/implementation-repo-onboarding/SKILL.md",
-        "effectiveHash": "905e97faee589bcc283cc299a05e795d75a3028440f7059f0115ebe80a266b3c",
+        "effectiveHash": "c5507d71a38bd0d1dc00e04e58cc01cf2bf762ce4a894e69974ba37e4733e269",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -330,7 +332,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md",
-        "effectiveHash": "de5c5a6d6db3b1c665a4e82cf18dcaa4c39360b50b3ebaedf52e072f2614aada",
+        "effectiveHash": "803482a33ea83cb12ac39a3497c7712cb5a4520b756532f9eae34c6e09673aa7",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "86f5e0413fa5b42b8e954858a09ce5a73187c61169f1b3b199bc79416fd78086",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -345,7 +347,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/java-backend-commit/SKILL.md",
-        "effectiveHash": "25f147a114dbbb59c626d737bc284d972c9d51c29ef9160bb87001632ea8d78d",
+        "effectiveHash": "58ec04a7da69bb7c73ae080600f71630710d56f4b3ca742d0992c5373891170f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -357,7 +359,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/llm-wiki/SKILL.md",
-        "effectiveHash": "14359cf7449f3788b97ae642ffa6947a8021b06d3f1a32d2f663db54d7b6f763",
+        "effectiveHash": "27ec83601168ca2648628797b8bf3b453d2adeaac35b1a0cbd2f046504dd898e",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -407,7 +409,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/prototype/SKILL.md",
-        "effectiveHash": "2744ef8e3dd23c2f286527100a2778e446639806b21a2a4f413b76d136a8ff7d",
+        "effectiveHash": "52b83cd3b9f4ef74884674209829cd02b3e00d77c5e304ab0d11a1508e9d347c",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "492e4433fcd9cf88c0854aba063829ee248b208849e5827a45da8424199fd10f",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -422,9 +424,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
-        "effectiveHash": "df6f131bef0f52a96d307d98ab42d74888a9b72c5508911b5622913b334e8eab",
-        "sourceRevision": "77a94e9fc8087f6c46f8dcfe30e362ee84b1f86a",
-        "upstreamHash": "9206df8b6c555c1af1351e425c5ec99ec2a40263c6861607f1418b9c520873ab",
+        "effectiveHash": "410ed10f248f6eb396cd50cea905032e45ec9b203aad41dbf78dbd03aba84b55",
+        "sourceRevision": "9e17922a0a718e5bd1845ddab11850a2f43becad",
+        "upstreamHash": "6df02dd4de236a749a80efd5eba46d18be7979849af2a9af28636906ccfcb2a0",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -437,7 +439,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/resolving-merge-conflicts/SKILL.md",
-        "effectiveHash": "b1fd57782c4699ca4b19dd4322e45c84c3e9d210d3b73d65f53230fe56ee779c",
+        "effectiveHash": "b5a1f8c9e9482e733dc1eb52b0fd51bf0cee6be951b4f6b46ff0eae4e4fb6488",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "310fa72a34cddd1dd1a9790f9ebc17bf2c83caeae5cdf87e2485be8b1abec90e",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -467,7 +469,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/tdd/SKILL.md",
-        "effectiveHash": "b6bbe6b93000fdfa708d88090f463a88755aa70056ce487bd7587ff96877b5b0",
+        "effectiveHash": "55578dd0e7f262730e15b6e490f7794ee891a9f63efafaa0bde2858cd178ddd6",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "28b5e430968370f51b03b88b4b4a046286192733d2f45bd5b8049e16f45fd234",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -497,7 +499,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/productivity/to-questionnaire/SKILL.md",
-        "effectiveHash": "17507a6727412ba31fcd948083478d140d0198d5febc636cdc094cfad7ae0f68",
+        "effectiveHash": "a7b7a3b4792028114028512becfa81b10e374d34f36c00772446b0becc348083",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "915ac22f1133fd4a7899ac6536e704cae57f1104d45745b32193d1572332868f",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -512,7 +514,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/to-spec/SKILL.md",
-        "effectiveHash": "7c4f7d5c27899d57e91f6fa5c8b2749280bcc1c326dcfabf862f8c9a29c14c95",
+        "effectiveHash": "336d977a7b6122608de01802ed219911407029eaffb678bc1d97bd7e0cff3a37",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "f8041146ec1678c32304f46c9de99b73a4b5dadf664e35a8124be47c4cfe3196",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -527,7 +529,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/to-tickets/SKILL.md",
-        "effectiveHash": "9bed48c0570a2af80cc44dff4768f8ced1f741e1898753364646833ade9bf188",
+        "effectiveHash": "b4fb2eb548baede25c42113a8727df12a43367aaf47aa06e5487663f81354520",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "597a1a0af4f7391ab459a02a3f33576109b6bc61ecdc5e7e05149336858b4f29",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -557,7 +559,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/using-git-worktrees/SKILL.md",
-        "effectiveHash": "0df8ff867eb56b381d6ea8c7e307889f551ef6ccc2061f8988ac5a7b6735ef28",
+        "effectiveHash": "db6dfed8198000a4518349924bc694d29e85e3740e9c7155825d1a0a59d8a46f",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -569,7 +571,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/productivity/wait-what/SKILL.md",
-        "effectiveHash": "25e2f8260b20ef170c9add30ca220515a1229dc6bdd7b2394c4656c8c2f9df83",
+        "effectiveHash": "8c48d704adc212453fbe52ffb196f858e006e644fb5eb1e4b7fc83f27b38e602",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "3f2e7e2ce8820380c08df1d6f2d8dc6aaefe5c2857d00a7190990c62d4039316",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -584,7 +586,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/wayfinder/SKILL.md",
-        "effectiveHash": "1cc6404169f4108e3b148d8f3ccf09190e249da94db350cdb5fb98b01db2900e",
+        "effectiveHash": "e38575501c3a13e4fdd89062a257d8f5e3eb3b03ed3a3ed2291835d924add3bf",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "93d2a866764b048ad641e82e27e7a1940fc370e7933470bffeb937fa1fb3922b",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -599,7 +601,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/productivity/writing-for-agents/SKILL.md",
-        "effectiveHash": "88b5fd77c40e9f0eef1616ffc07f9a75563c0b32f50a473976c01c1ca1d0000d",
+        "effectiveHash": "7033ce844ee0da51749292ff4ec9e406645e6ceb16bef2f7dd5dfc957a96f248",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "0071124a923559493bc8924a90fb87bceb048d31ad2ce785fa4281d7c506bfa7",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -629,7 +631,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/api-integration/SKILL.md",
-        "effectiveHash": "8141de047648d58efc94860be698eefdedfda9c963e0dc6f0ebe7fd32e69a030",
+        "effectiveHash": "95b4e05412385b1bf60da6c29c50d77817b9a34789065dd4cf82e95fdd70a778",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "53d265c846f767c5dee9c92f2dc0caced341efd8888631f4b37a46eb486fbbeb",
         "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
@@ -644,7 +646,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-application/SKILL.md",
-        "effectiveHash": "f13873d39fcc84dd8263fc8c6849bf8627da2b137a96b664754d85dc7115f520",
+        "effectiveHash": "af61d4e3ddc32da87a178f3f5b3498bee0e58bc6b1ec313fa795d6f901e5573b",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -656,7 +658,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-audit-log/SKILL.md",
-        "effectiveHash": "197c049b619c31cd008d92508aab932d1cdb0c7a485df8823214a79094961e8a",
+        "effectiveHash": "6c8734383a3b51d11671ca69233d97bac594c9c01166daf5abccad4f4cfcad5a",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -668,7 +670,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-backend-spec-review/SKILL.md",
-        "effectiveHash": "6523791ca63d22653640f3e00a424c2ce9102fdb1a7daa989eb5d302f93be263",
+        "effectiveHash": "7917d0974978297e7df6d8a112b58f815e0dbd0af316d932bc81770300a473b5",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -692,7 +694,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "1f0d1b9094a205b7797d1651d895e80c3977aaf4290589524339c6171a5a5db9",
+        "effectiveHash": "e19c9de03268af6c014a0d3815480d9e2d45c60d2259e2c82448b38eb9825196",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -704,9 +706,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
-        "effectiveHash": "7435f2e4de7dfa434881d03d6fe0858ea54ee3275759077567590f3a231149a9",
-        "sourceRevision": "77a94e9fc8087f6c46f8dcfe30e362ee84b1f86a",
-        "upstreamHash": "c917ecf40a67c52f0fa7894fbdfbf827cc1ed6aff1037be2911377387fede1a0",
+        "effectiveHash": "b3ddbff30926f6675ac60cbf89182593df7ed272d7a1dc75f657f7640960c1b8",
+        "sourceRevision": "9e17922a0a718e5bd1845ddab11850a2f43becad",
+        "upstreamHash": "e156229435c35827c48d3699b021e5e171ec565c2bf91cc91cbb033bf7802d7c",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -731,7 +733,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-domain/SKILL.md",
-        "effectiveHash": "905d4df8e2045c5f1eb56296e6802ed90e90acdfff7dd87eea8159e0e32db91f",
+        "effectiveHash": "da9894b8d11eb507414c16d2d30df39bbf77196d63a22c5200b76206530f5e75",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -743,7 +745,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-dto/SKILL.md",
-        "effectiveHash": "52f9f4c6c4b675918f84d1649ad76bbcc379ed683c072e95e418c33c7083133c",
+        "effectiveHash": "34d9aba2654a06b71d064291c4adf194534a22012d2edac1512d3545240aa27e",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -767,7 +769,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-exception/SKILL.md",
-        "effectiveHash": "ee0ed28408ad623e97cc34425a41cc57c9dce090f1b1057100c4126ba935ebf9",
+        "effectiveHash": "c0b0bbde530f43ab7244770256b95cb46876b813765c75b0536ec8abaa68ea0a",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -794,7 +796,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-formily-schema-generator/SKILL.md",
-        "effectiveHash": "0cc96bccd97e33a90821c42187a5f4c8f0b44fed54744f1cfeef221af7e8881c",
+        "effectiveHash": "a37da6c7211e1758d6eb99d4067e209d92030d17766866e3f20cc7516278b4b1",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -818,7 +820,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-hook/SKILL.md",
-        "effectiveHash": "3dadbff7e395e21145ec9c82095fb55f1242ebfea7283d8b4c424b2dbe6bb811",
+        "effectiveHash": "4b00659a70acc8a71b9813252b65276d863675c9faa8ec564707b5995b1ca8a2",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -830,7 +832,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "5cc7c94f6f62805b1b116b1a8079e34688ec8ec9339caebaac53580f85ebb38f",
+        "effectiveHash": "68cc10eaedad5ff77e48f1d75b7bb37de46b0f250dcd18a7deb6c8d9e64d6035",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -842,7 +844,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md",
-        "effectiveHash": "599dc03a48e5440437fa0f5db314da17ab0f1b6c0b3a84eb3b8c6dfe95794ef6",
+        "effectiveHash": "403bf30feceae02c34b7c29123e6b68cee0f1b182dd7568202aaa3c639804559",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -854,7 +856,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mybatis/SKILL.md",
-        "effectiveHash": "61e6a4b0c3ce0dd4842d7fbf66f670280787ce58339280bb4c2c306bb5f76962",
+        "effectiveHash": "c844472c366438f0c84d22246a82eca645753cf562a909c8857d4a621bf5ad7c",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -866,7 +868,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-draft-review/SKILL.md",
-        "effectiveHash": "3a968c8cdda13055d8f5ea322360fc39d6ba1808c0970262bfd5a49661700b31",
+        "effectiveHash": "d4ff53b34a41c852f5f7ac0b9c0d2f70ca8a027e04a9622f7c0770683a0ab69d",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -878,7 +880,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-governance/SKILL.md",
-        "effectiveHash": "bae6b5e790bd574ba5cff7fea36b6f7791a7ddb3a79d0dc591e1392aa4051e9b",
+        "effectiveHash": "d00b62edef550e2d8c066ce8aa034422bd00825adcc15b6b0953dff7d23af4c0",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -890,7 +892,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "4b30df4030483747b14a4131c5707efe7b321a550d2707536a942eb7a9871842",
+        "effectiveHash": "0904753ec31459a719530aae71864e5a8f2d8acef66f64065c7e2848a362c23e",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -902,9 +904,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
-        "effectiveHash": "cbe197cdf9e4c7e073ea1892dbcfd03778552cd361d6f3e7e16107a89c20677d",
-        "sourceRevision": "77a94e9fc8087f6c46f8dcfe30e362ee84b1f86a",
-        "upstreamHash": "8256a1edfeb203f4de27d190210b0ba5593f8f74e0f3655b62b146daff2105a8",
+        "effectiveHash": "4cc7d388f89feddf50d208b2d5db3a4ffa41974afb364328270c097970fc39c0",
+        "sourceRevision": "9e17922a0a718e5bd1845ddab11850a2f43becad",
+        "upstreamHash": "6e1bcdf107d95c11faee2b988e4e0c36b8e5b76f6b40312a206b83733a96b0fc",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -917,7 +919,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "a3cd3668188098370923fcb7d4423f0d1a887f6709cc12e32bc4e8c7a264f68e",
+        "effectiveHash": "b70b05ba98192eaf3f463d5409e43ed221d53ed097c00bf740364c786954de96",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -980,9 +982,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
-        "effectiveHash": "4c2cfefe9ed99283ec55e029136b64885280935e8e2a9f66d0425b3f1e8217a9",
-        "sourceRevision": "77a94e9fc8087f6c46f8dcfe30e362ee84b1f86a",
-        "upstreamHash": "46a9be287963eff0e71f8106b5d31311e43aabbd1117d7bc3d2d8666a0a99474",
+        "effectiveHash": "43a83bc02fea3c36105be6791ad019036b7ea1a17e5f0704daf93fb7be29b60b",
+        "sourceRevision": "9e17922a0a718e5bd1845ddab11850a2f43becad",
+        "upstreamHash": "f7f765e20f4dca6aca667be03e2b9a7f2a8acc3510eefba88306961882d86ed4",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -995,7 +997,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-tactical-design/SKILL.md",
-        "effectiveHash": "b0d8317a34367ba1cf5bfe7b46fbfc16b3edc457f5bc3529a4451f1134047ca7",
+        "effectiveHash": "c4a519d1faef1de31c85a9bfae0b5b3888432da68470bb23a434be8751164548",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1007,7 +1009,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-technical-design/SKILL.md",
-        "effectiveHash": "2311eeab142a422f3f93473efee7b6561b01e4459281c3aa9b46f28e3518425f",
+        "effectiveHash": "0b701b6a323a227bf4be9201661039f70760ded9c5dcbda594f5bc6d18226fcd",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1031,7 +1033,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/yss-ui-business-page-generation/SKILL.md",
-        "effectiveHash": "929f1d3f71ff49310ed27723d8b51cc4aa217c7ac02b95166af4d7cc9779f37a",
+        "effectiveHash": "8ce96d084abb6fce8d91069b7d80d6c0ac66948d02eb95ab1e5d34a10bb96002",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "97ef56c4b60c0281039996ac582ab01987b4d2bbb89989662594a6ce8a77c95f",
         "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
@@ -1070,7 +1072,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-validation/SKILL.md",
-        "effectiveHash": "a28a6b6aee873c89c1549cfe4a7199f0fc8862c94a5839e0137b344a4c500eaf",
+        "effectiveHash": "2e28fa24880e97238171dcb8cbaa285f49127cd13c3f42e69c263e27e4c57f54",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1082,7 +1084,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-web-controller/SKILL.md",
-        "effectiveHash": "d76f3e4490cbb6a64d93da38fafa242a2eba1f3a5f674877ce4bfd3044444da1",
+        "effectiveHash": "e0ba69025f5ef1ec3ee15bba50caeaa6a3550989abc9b27348d3c64003af3863",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1094,7 +1096,7 @@
         "source": "iloveZzz/yss-ui",
         "sourceType": "github",
         "skillPath": "packages/skills/ytable-usage/SKILL.md",
-        "effectiveHash": "1680f0ec96cd4a34dbe956e00ca723534aae28c5372a6e8ab6a51e28ff38818d",
+        "effectiveHash": "1f8601b9f5a583194c81ecb7dd84b97010d65dfdf217221fb7364ae0bd068293",
         "sourceRevision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
         "upstreamHash": "7b3e8b3d761d910c5506ea17bf6cb264b2f313172748fe081b0fe5c9e9bbfff6",
         "adaptationRef": "docs/agents/yss-ui-skills-integration.md",
@@ -1127,7 +1129,7 @@
           "source": "project",
           "sourceType": "local",
           "skillPath": ".codex/skills/data-analytics/SKILL.md",
-          "effectiveHash": "563e87968f4a958576ac257e518786f031ab15f608c51ca7e7e2f6eaeb5325f8",
+          "effectiveHash": "9ed415498a99f8ea18064f488ae58496608cc8ba07dd0326e46bc021e14e1275",
           "targets": [
             ".codex/skills"
           ]
@@ -1136,7 +1138,7 @@
           "source": "project",
           "sourceType": "local",
           "skillPath": ".codex/skills/product-design/SKILL.md",
-          "effectiveHash": "8a3893679098af1203ce2ceb54de40c4bdffcfd6389b5588c30ec213b67bcd7f",
+          "effectiveHash": "09400645673b38ccd835723e7dff31aa0959c8dec6b01b0e88d4653b4118670e",
           "targets": [
             ".codex/skills"
           ]