@captain_z/zsk 1.4.3 → 1.5.1

package/dist/core/skills.d.ts

@@ -1,4 +1,4 @@
-declare const DOMAINS: readonly ["sdlc", "frontend", "quality", "design-handoff", "system", "meta"];
+declare const DOMAINS: readonly ["core"];
 export type Domain = (typeof DOMAINS)[number];
 export type Skill = {
     name: string;
@@ -9,9 +9,8 @@ export type Skill = {
 export declare function resolveSkillsRoot(): Promise<string>;
 export declare function loadSkill(skillName: string): Promise<Skill>;
 /**
- * Enumerate every installable skill by walking the skills root directly.
- * Returns names in `zsk:<slug>` form, sorted by domain then slug, so UI
- * groupings are stable across runs.
+ * Enumerate every installable core skill by walking the skills root directly.
+ * Returns names in `zsk:<slug>` form, sorted by slug.
  */
 export declare function enumerateSkills(): Promise<Skill[]>;
 export { DOMAINS };

package/dist/core/skills.js

@@ -1,19 +1,12 @@
-// Skill resolution: zsk:<slug> → filesystem SKILL.md path + domain metadata.
+// Skill resolution: zsk:<slug> → filesystem SKILL.md path + install metadata.
 //
 // Dev (monorepo): resolves via ../../../../capabilities/skills/
-// Production:      resolves via @captain_z/zsk-skills/skills/
+// Production:      resolves via @captain_z/zsk-skills package root
 import { access, readdir } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
-const DOMAINS = [
-    "sdlc",
-    "frontend",
-    "quality",
-    "design-handoff",
-    "system",
-    "meta",
-];
+const DOMAINS = ["core"];
 let skillsRootCache = null;
 export async function resolveSkillsRoot() {
     if (skillsRootCache)
@@ -29,7 +22,7 @@ export async function resolveSkillsRoot() {
     catch {
         // fall through
     }
-    // Production: @captain_z/zsk-skills package (flat layout, no /skills/ wrapper)
+    // Production: @captain_z/zsk-skills package ships skill dirs at package root.
     const require = createRequire(import.meta.url);
     const pkgPath = require.resolve("@captain_z/zsk-skills/package.json");
     const skillsDir = dirname(pkgPath);
@@ -39,50 +32,48 @@ export async function resolveSkillsRoot() {
 export async function loadSkill(skillName) {
     const slug = skillName.replace(/^zsk:/, "");
     const root = await resolveSkillsRoot();
-    for (const domain of DOMAINS) {
-        const file = resolve(root, domain, slug, "SKILL.md");
-        try {
-            await access(file);
-            return { name: skillName, domain, slug, file };
-        }
-        catch {
-            // try next domain
-        }
+    const file = resolve(root, slug, "SKILL.md");
+    try {
+        await access(file);
+        return { name: skillName, domain: "core", slug, file };
     }
-    throw new Error(`Skill not found in any domain: ${skillName}`);
+    catch {
+        // fall through
+    }
+    throw new Error(`Core skill not found: ${skillName}`);
 }
 /**
- * Enumerate every installable skill by walking the skills root directly.
- * Returns names in `zsk:<slug>` form, sorted by domain then slug, so UI
- * groupings are stable across runs.
+ * Enumerate every installable core skill by walking the skills root directly.
+ * Returns names in `zsk:<slug>` form, sorted by slug.
  */
 export async function enumerateSkills() {
     const root = await resolveSkillsRoot();
     const out = [];
-    for (const domain of DOMAINS) {
-        const domainDir = resolve(root, domain);
-        let entries;
+    const seen = new Set();
+    let entries;
+    try {
+        entries = await readdir(root, { withFileTypes: true });
+    }
+    catch {
+        entries = [];
+    }
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        const file = resolve(root, e.name, "SKILL.md");
         try {
-            entries = await readdir(domainDir, { withFileTypes: true });
+            await access(file);
         }
         catch {
-            continue; // domain dir may not exist in partial installs
-        }
-        for (const e of entries) {
-            if (!e.isDirectory())
-                continue;
-            const file = resolve(domainDir, e.name, "SKILL.md");
-            try {
-                await access(file);
-            }
-            catch {
-                continue; // directory without SKILL.md → not a skill
-            }
-            out.push({ name: `zsk:${e.name}`, domain, slug: e.name, file });
+            continue; // directory without SKILL.md → not a skill
         }
+        const name = `zsk:${e.name}`;
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        out.push({ name, domain: "core", slug: e.name, file });
     }
-    out.sort((a, b) => DOMAINS.indexOf(a.domain) - DOMAINS.indexOf(b.domain) ||
-        a.slug.localeCompare(b.slug));
+    out.sort((a, b) => a.slug.localeCompare(b.slug));
     return out;
 }
 export { DOMAINS };

package/dist/core/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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"}

package/dist/core/targets.js

@@ -18,7 +18,7 @@ export const TARGET_OPTIONS = [
     {
         kind: "claude-plugin",
         label: "./.claude-plugin/",
-        hint: "Claude 插件形态（生成 manifest.json）",
+        hint: "Claude 插件形态（生成 plugin.json + commands/ + skills/）",
         resolve: () => resolve(process.cwd(), ".claude-plugin"),
     },
     {

package/dist/core/targets.js.map

@@ -1 +1 @@
-{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/core/targets.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBhD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC;KACpD;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;KACnD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC;KACvD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/core/targets.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBhD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC;KACpD;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,mDAAmD;QACzD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;KACnD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC;KACvD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@captain_z/zsk",
-  "version": "1.4.3",
+  "version": "1.5.1",
   "description": "ZNorth Standard Kit — CLI installer for zsk skill bundles (npx @captain_z/zsk add)",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
     "commander": "^12.1.0",
     "picocolors": "^1.1.1",
     "yaml": "^2.7.0",
-    "@captain_z/zsk-skills": "1.4.3"
+    "@captain_z/zsk-skills": "1.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/schemas/module.schema.json

@@ -201,7 +201,7 @@
     "toolName": {
       "description": "Known runtime/design verification tool.",
       "type": "string",
-      "enum": ["computer_use", "browser_use", "figma_mcp", "script", "manual", "skill"]
+      "enum": ["computer_use", "browser_use", "playwright", "playwright_cli", "playwright_mcp", "figma_mcp", "script", "manual", "skill"]
     },
     "metadata": {
       "description": "Explicit extension point for project-specific metadata.",

package/schemas/zsk-config.schema.json

@@ -104,6 +104,105 @@
         }
       }
     },
+    "automation": {
+      "description": "Harness automation defaults for workflow stages.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "smoke": {
+          "$ref": "#/$defs/commandStage"
+        },
+        "deploy": {
+          "$ref": "#/$defs/commandStage"
+        },
+        "demo": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "defaultMode": {
+              "type": "string",
+              "enum": ["manual", "script", "playwright", "computer-use", "hybrid"]
+            },
+            "baseUrl": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "evidenceDir": {
+              "$ref": "#/$defs/pathRef"
+            },
+            "scenarioDir": {
+              "$ref": "#/$defs/pathRef"
+            },
+            "playwright": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/pathRef"
+                },
+                "project": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "cli": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "computerUse": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "role": {
+                  "type": "string",
+                  "const": "understand-and-decide"
+                }
+              }
+            },
+            "bridge": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "decisionTool": {
+                  "type": "string",
+                  "enum": ["browser_use", "computer_use", "playwright_mcp"]
+                },
+                "executionTool": {
+                  "type": "string",
+                  "enum": ["playwright"]
+                },
+                "planFile": {
+                  "$ref": "#/$defs/pathRef"
+                },
+                "executionFile": {
+                  "$ref": "#/$defs/pathRef"
+                }
+              }
+            },
+            "metadata": {
+              "$ref": "#/$defs/metadata"
+            }
+          }
+        },
+        "verify": {
+          "$ref": "#/$defs/commandStage"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
     "sync": {
       "description": "Optional deterministic or AI-assisted raw resource sync configuration.",
       "type": "object",
@@ -124,12 +223,33 @@
     "toolName": {
       "description": "Known tool or capability name.",
       "type": "string",
-      "enum": ["computer_use", "browser_use", "figma_mcp", "script", "manual", "skill"]
+      "enum": ["computer_use", "browser_use", "playwright", "playwright_cli", "playwright_mcp", "figma_mcp", "script", "manual", "skill"]
+    },
+    "commandStage": {
+      "description": "Automation command list for a workflow stage.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
     },
     "sourceType": {
       "description": "Resource role.",
       "type": "string",
-      "enum": ["srs", "prd", "design", "api_contract", "test_case", "design_asset", "vendor_doc", "manual"]
+      "enum": ["srs", "prd", "design", "api_contract", "backend_repo", "test_case", "design_asset", "vendor_doc", "manual"]
     },
     "sourceRef": {
       "description": "Resource source reference.",

package/templates/issue/default/issue.md

@@ -1,9 +1,19 @@
 # __ISSUE_ID__-__ISSUE_SLUG__
 
+## 问题类型
+
+__ISSUE_TYPE__
+
 ## 问题级别
 
 __SEVERITY__
 
+## 严重性理由
+
+- 用户/业务影响：
+- 阻塞范围：
+- 是否有 workaround：
+
 ## 模块
 
 `__MODULE_ID__`
@@ -22,7 +32,7 @@ __SEVERITY__
 
 1.
 
-## 实际结果
+## 实际结果（当前现状）
 
 
 ## 预期结果
@@ -36,10 +46,33 @@ __SEVERITY__
 ## 影响范围
 
 
-## 初步定位
+## 根因分析
+
+- 初步根因：
+- 置信度：
+- 受影响代码/配置/资源：
+- 排除过的原因：
+
+## 修复路线
+
+- 路由：Coding / Spec 更新 / Design 更新 / 测试数据 / 环境 / 无效问题
+- Owner：
+- 回归保护：测试 / 场景 / lint / checklist / 豁免
+
+## Documentation Feedback
+
+- 需要反哺的文档：
+  - [ ] `docs/{module}/spec.md`
+  - [ ] `docs/{module}/design.md`
+  - [ ] `docs/{module}/tasks.md`
+  - [ ] `docs/SYSTEM-SPEC.md`
+  - [ ] `.zsk/learning/proposals`
+- 更新内容或 no-update rationale：
+- 反哺时机：修复通过 verify 且经用户/产品确认后执行
 
 
 ## 状态
 
 - 状态：Open
 - 复测：
+- 确认时间：

package/templates/module/frontend-module/acceptance.md

@@ -0,0 +1,18 @@
+# __MODULE_NAME__ Acceptance
+
+## Verdict
+
+- Result: NOT_STARTED
+- Accepted by:
+- Date:
+
+## Evidence Summary
+
+| Source | Conclusion | Link |
+| --- | --- | --- |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no acceptance has been performed yet.
+

package/templates/module/frontend-module/archive.md

@@ -0,0 +1,17 @@
+# __MODULE_NAME__ Archive
+
+## Closure
+
+| Item | Link |
+| --- | --- |
+
+## Learning Proposals
+
+| Finding | Target | Evidence |
+| --- | --- | --- |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; archive has not run yet.
+

package/templates/module/frontend-module/commit.md

@@ -0,0 +1,15 @@
+# __MODULE_NAME__ Commit
+
+## Commit Evidence
+
+| Item | Evidence |
+| --- | --- |
+| Review gate | |
+| Smoke gate | |
+| Commit | |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no commit evidence has been captured yet.
+

package/templates/module/frontend-module/demo-outline.md

@@ -0,0 +1,59 @@
+# __MODULE_NAME__ Demo Outline
+
+## Demo Flow
+
+Use this section as the speaking order. The audience should be able to follow the demo from top to bottom without reading any appendix.
+
+| Step | Show | Function / Business Point | Scenario | Source Alignment | Playwright Case | Presenter Line | Expected Visible Result | Next |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 1 | Starting state and primary goal |  |  | PRD/SRS + Spec + Task + Test | `scenarios/<case>.spec.ts` |  |  | 2 |
+| 2 | Core happy path / main value |  |  | PRD/SRS + Spec + Task + Test | `scenarios/<case>.spec.ts` |  |  | 3 |
+| 3 | Required branch / role / validation / edge |  |  | PRD/SRS + Spec + Task + Test | `scenarios/<case>.spec.ts` |  |  | Final |
+| Final | Final state, evidence, and known gaps |  |  | PRD/SRS + Spec + Task + Test |  | summarize evidence and known gaps |  | close |
+
+## Opening
+
+- Audience:
+- One-sentence goal:
+- Starting state:
+- Primary user journey:
+- What this demo proves:
+
+## Coverage Alignment
+
+Every required function point in the PRD/SRS should appear here, either as a demo step or as a known gap.
+
+| Function / Business Point | PRD / SRS Need | Spec / Design Contract | Task Scope | Test Case / Assertion | Demo Step | Status |
+| --- | --- | --- | --- | --- | --- | --- |
+|  |  |  |  |  | 1 | covered |
+|  |  |  |  |  | 2 | covered |
+|  |  |  |  |  | 3 | covered |
+
+## Rehearsal Checklist
+
+| Demo Step | Browser Use Handoff | Playwright Case | Rehearsed | Evidence | Ready |
+| --- | --- | --- | --- | --- | --- |
+| 1 |  |  | no | trace/report/screenshot | no |
+| 2 |  |  | no | trace/report/screenshot | no |
+| 3 |  |  | no | trace/report/screenshot | no |
+
+## Pause Rules
+
+- Pause if login/session state is lost.
+- Pause if the UI no longer matches the prepared Playwright case.
+- Pause if a P0/P1 function point cannot be shown.
+- Do not improvise new clicks during the external demo; record the blocker and return to Demo Prep.
+
+## Appendix: Prep Sources
+
+| Source | Path / Link | Used For |
+| --- | --- | --- |
+| SRS / PRD |  | user goal and scope |
+| Spec / AC |  | observable pass criteria |
+| Test cases |  | scenario steps and expected result |
+| Browser Use handoff |  | login state, visible target, candidate locators |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no demo outline has been generated yet.

package/templates/module/frontend-module/demo-report.md

@@ -0,0 +1,23 @@
+# __MODULE_NAME__ Demo Report
+
+## Session
+
+- Session id:
+- Status: NOT_STARTED
+- Mode:
+
+## Coverage
+
+| Function Point | FR/AC | Scenario | Result | Evidence | Issues |
+| --- | --- | --- | --- | --- | --- |
+
+## Reusable Scenarios
+
+| Scenario | Source | Reuse Target | Evidence |
+| --- | --- | --- | --- |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no demo has been performed yet.
+

package/templates/module/frontend-module/deploy.md

@@ -0,0 +1,18 @@
+# __MODULE_NAME__ Deploy
+
+## Deployment
+
+| Environment | URL | Version | Result | Evidence |
+| --- | --- | --- | --- | --- |
+
+## Rollback
+
+- Owner:
+- Command:
+- Notes:
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no deployment has been performed yet.
+

package/templates/module/frontend-module/design.md

@@ -1,5 +1,17 @@
 # __MODULE_NAME__ Design
 
+## Playwright Locator And State Strategy
+
+| Scenario | Page / Route | Preferred Locator Strategy | State Coverage | API / Mock | Auth / Storage | Evidence |
+| --- | --- | --- | --- | --- | --- | --- |
+| P0 happy path |  | getByRole / getByLabel / getByTestId | loading / success / error |  |  | screenshot + trace |
+
+Guidelines:
+
+- Prefer user-facing locators: `getByRole`, `getByLabel`, `getByPlaceholder`, `getByTestId`.
+- Add implementation tasks for missing accessible names, labels, or stable test ids.
+- Define auth/storage reuse before demo so Playwright can run repeatably.
+
 ## Documentation Feedback
 
 - No-update rationale:

package/templates/module/frontend-module/module.yaml

@@ -9,6 +9,8 @@ sources: {}
 runtime:
   url: http://localhost:3000
   tools:
+    - playwright_mcp
+    - playwright
     - computer_use
     - browser_use
 
@@ -18,7 +20,8 @@ tests:
   automated:
     unit: []
     integration: []
-    e2e: []
+    e2e:
+      - __DOCS_OUTPUT__/scenarios
   tdd_required: true
 
 outputs:

package/templates/module/frontend-module/proposal.md

@@ -0,0 +1,7 @@
+# __MODULE_NAME__ Proposal
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no proposal has been drafted yet.
+

package/templates/module/frontend-module/ready.md

@@ -0,0 +1,12 @@
+# __MODULE_NAME__ Ready
+
+## Gate
+
+| Issue | Fix Evidence | Deployment | Ready |
+| --- | --- | --- | --- |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no fixes have been marked ready for verify yet.
+

package/templates/module/frontend-module/review.md

@@ -0,0 +1,12 @@
+# __MODULE_NAME__ Review
+
+## Review Findings
+
+| Finding | Severity | Owner | Issue |
+| --- | --- | --- | --- |
+
+## Documentation Feedback
+
+- No-update rationale:
+  - Created from the ZSK module template; no review has been performed yet.
+

package/templates/module/frontend-module/scenarios/index.md

@@ -0,0 +1,13 @@
+# __MODULE_NAME__ Scenarios
+
+Reusable demo, verify, and regression scenarios for this module.
+
+## Scenario Lifecycle
+
+| Stage | Responsibility |
+| --- | --- |
+| Spec | Define scenario contract and FR/AC linkage |
+| Design | Define locator/state/auth/evidence strategy |
+| Task | Create Playwright skeleton and fixture work |
+| Demo | Execute, record, and promote scenarios |
+| Verify | Reuse scenarios for fix verification |

package/templates/module/frontend-module/scenarios/p0-happy-path.spec.ts

@@ -0,0 +1,13 @@
+import { test, expect } from "@playwright/test";
+
+test.describe("__MODULE_NAME__ demo scenarios", () => {
+  test("P0 happy path", async ({ page }) => {
+    test.skip(!process.env.ZSK_DEMO_BASE_URL, "Set ZSK_DEMO_BASE_URL to run this scenario.");
+
+    await page.goto(process.env.ZSK_DEMO_BASE_URL);
+
+    // Replace this with the scenario contract from spec.md and locator strategy from design.md.
+    await expect(page).toHaveURL(/.+/);
+  });
+});
+