@playcraft/cli 0.0.43 → 0.0.46

package/project-template/docs/team/workflow-consistency-checklist.md

@@ -21,33 +21,33 @@ Maintenance checklist after editing `packages/cli/project-template`. Run before
 
 ## Phase D — L1 < 220 lines
 
-- [x] `pm.md`, `designer.md`, `developer.md`, `reviewer.md`, `technical-artist.md` each **< 220** lines
+- [x] `game-designer.md`, `artist.md`, `developer.md`, `reviewer.md`, `technical-artist.md` each **< 220** lines
 - [x] New refs registered in `refs/README.md` with L1 back-links
-- [x] `designer-deliverable-spec.md`, `designer-style-exploration-flow.md`, `developer-phase1-flow.md` exist
+- [x] `artist-deliverable-spec.md`, `artist-style-exploration-flow.md`, `developer-phase1-flow.md` exist
 
 ## Phase F — TA atlas / WebP / MP3
 
 - [x] `ta-atlas-deliverable-standard.md` exists; TA L1 + Runtime reference it
 - [x] `layout-spec.template.md`: atlas grouping table, webp defaults, frameId column
 - [x] `collaboration.md` § Asset Contract: WebP atlas + MP3
-- [x] PM `pm-workflow-detail.md`: Atlas grouping at Gate #1
+- [x] Game Designer `game-designer-workflow-detail.md`: Atlas grouping at Gate #1
 - [x] Developer cookbook: atlasPath + frameId binding
 
 ## Round 3 — Invoke 体感打磨
 
 ### Phase A — Runtime 入口微调
 
-- [x] Designer Runtime: Phase 1 Skill Discovery → style-exploration-flow (one line)
+- [x] Artist Runtime: Phase 1 Skill Discovery → style-exploration-flow (one line)
 - [x] Developer Runtime: Spec Quick-Check (30s, MUST) on production branch
 - [x] Developer Ph.1 STOP: `next_orchestrator_action` = single value `Wait for parallel tracks`
 - [x] TA Step 0: verb pipeline (no E→A→B→C→D shorthand in L1)
-- [x] TA Compliance: atlas grouping table check + spec-gap routeTo PM
+- [x] TA Compliance: atlas grouping table check + spec-gap routeTo Game Designer
 
 ### Phase B — L1 术语显式化
 
-- [x] PM Runtime: 四件套 list + atlas groups + Style Direction in Track done
+- [x] Game Designer Runtime: 四件套 list + atlas groups + Style Direction in Track done
 - [x] Reviewer Goals: six dimension names + Vetoes listed
-- [x] Designer Track done: MC 5×9:16 ratio (≈ 2.81)
+- [x] Artist Track done: MC 5×9:16 ratio (≈ 2.81)
 
 ### Phase C — 跨 Agent 同步
 
@@ -59,7 +59,7 @@ Maintenance checklist after editing `packages/cli/project-template`. Run before
 ### Phase D — 重复段清理
 
 - [x] Developer L1: no separate `## Phase 1` / `## Phase 2` headings (Execute L2 under Runtime)
-- [x] Designer Phase 2: skills/refs/output only (no duplicate Trigger)
+- [x] Artist Phase 2: skills/refs/output only (no duplicate Trigger)
 - [x] Developer Important Rules: Test-first + Atlas binding split (#5 / #6)
 - [x] Reviewer Output: sync `handoff.rework_round` on fail
 
@@ -67,46 +67,45 @@ Maintenance checklist after editing `packages/cli/project-template`. Run before
 
 - [x] Gate Protocol matches CLAUDE Orchestration table
 - [x] All five agents: Runtime + PLAYCRAFT_STOP
-- [x] PM Gate #1 four docs; Reviewer no `stage: rework`; Developer handoff Invoke @reviewer
+- [x] Game Designer Gate #1 four docs; Reviewer no `stage: rework`; Developer handoff Invoke @reviewer
 
 ## Polish pass (Glossary / deliverable cards / TA Step naming)
 
 - [x] `collaboration.md`: § Glossary (canonical terms)
-- [x] `pm.md`: § Gate #1 Deliverable Card
+- [x] `game-designer.md`: § Gate #1 Deliverable Card
 - [x] Reviewer: `rework_round` failure budget explicit in L1 + `reviewer-six-dimension-eval.md`
 - [x] `refs/README.md`: § 按 invoke 场景反查
 - [x] `ta-pipeline-cookbook.md`: Step 0/1/2 (not Phase 0/1/2)
 - [x] `CLAUDE.md`: Single-Agent Fallback removed; sub-agent invoke required
 
-## Phase G — Designer Handoff v2
+## Phase G — Artist Handoff v2
 
-- [x] `docs/team/workflow-changelog.md` documents `designer-handoff-v2`
-- [x] `templates/project-state.template.md` § Workflow spec + Parallel Tracking (audio + digit + atom status)
-- [x] `designer-deliverable-spec.md`: Handoff Pack, Phase 2 VisualAtom rules; no legacy Phase 2 visual-only-TA sentence
-- [x] `designer-handoff-v2-checklist.md` linked from `designer-style-exploration-flow.md` Step 5
+- [x] `docs/team/workflow-changelog.md` documents `artist-handoff-v2`
+- [x] `templates/project-state.template.md` § Workflow spec + Parallel Tracking (audio + digit + artist wave notes)
+- [x] `artist-deliverable-spec.md`: Handoff Pack, Phase 2 VisualAtom rules; no legacy Phase 2 visual-only-TA sentence
+- [x] `artist-handoff-v2-checklist.md` linked from `artist-style-exploration-flow.md` Step 5
 - [x] `templates/style-exploration.template.md` uses MC + ASR (no `concept_{{a}}.png`)
-- [x] `templates/designer-log.template.md`: ASR Coverage Matrix + Palette Locked
+- [x] `templates/artist-log.template.md`: ASR Coverage Matrix + Palette Locked
 - [x] `playcraft-style-qa` uses MC path; no `concept_selected.png`
 - [x] `playcraft-asset-state-sheet` skill exists; `playcraft-exploded-view` removed
-- [x] `core-model.md` + `atom-plan.template.md` v2 VisualAtom baseline
+- [x] `core-model.md` + `atom-tree.template.json` v2 VisualAtom baseline
 - [x] Vitest `designer-handoff-v2` cases pass
 
-## Phase J — atom-plan JSON canonical
+## Phase J — atom-tree simplified manifest
 
-- [x] `docs/team/atom-plan-format.md` — JSON + MD split, PM Gate #1 flow
-- [x] `templates/atom-plan.template.json` + trimmed `atom-plan.template.md` (no inline Skills Match Snapshot)
-- [x] `pm-workflow-detail.md` Step 8 + Gate checklist → `atom-plan.json` + `validate-atom-plan`
-- [x] `playcraft-workflow` living DAG + `collaboration.md` / `agent-conduct.md` aligned
-- [x] `.claude/hooks/validate-atom-plan.mjs` + PM STOP in `settings.json` / `.cursor/hooks.json`
-- [x] `validate-workflow-stop.mjs` requires `atom-plan.json` for TA/Developer intake
-- [x] Vitest `atom-plan-json-and-validate-hook` passes
+- [x] `docs/team/atom-tree-format.md` — JSON + MD split rewritten as selection manifest + reference guide
+- [x] `templates/atom-tree.template.json` aligned to `meta.skillsMatch` / `meta.selectedAtoms` / `selectionRevisions[]`
+- [ ] ref-flow runtime / refs fully aligned to the simplified atom-tree model
+- [ ] CLI-side validation / hook story updated for the new schema
+- [x] `playcraft-workflow` core docs (`collaboration.md` / `agent-conduct.md` / `pipeline-overview.md` / `CLAUDE.md`) aligned to the new atom-tree positioning
+- [ ] tests / hooks that still assume old `selectedSkills`-style schema audited and updated
 
 ## Phase I — Upstream intake + four-doc discipline + hooks
 
-- [x] `agent-conduct.md`: PM/Designer four-doc discipline; TA/Developer Upstream Intake MUST
+- [x] `agent-conduct.md`: Game Designer/Artist four-doc discipline; TA/Developer Upstream Intake MUST
 - [x] `ta-pipeline-cookbook.md` Step 0a + `developer-phase1-flow.md` Step 0
 - [x] `ta-log.template.md` + `developer-log.template.md` § Upstream Intake
-- [x] `pm.md` + `pm-workflow-detail.md` + `designer.md` + `collaboration.md` § Four-doc discipline
+- [x] `game-designer.md` + `game-designer-workflow-detail.md` + `artist.md` + `collaboration.md` § Four-doc discipline
 - [x] `.claude/settings.json` + `.cursor/hooks.json` → `validate-workflow-stop.mjs`
 - [x] Vitest `upstream-intake` + `validate-workflow-stop.test.ts` pass
 
@@ -114,8 +113,8 @@ Maintenance checklist after editing `packages/cli/project-template`. Run before
 
 - [x] `workflow-changelog.md`: `production-serial-v1` current; no Migration section
 - [x] `templates/project-state.template.md`: `workflowSpecVersion` = `production-serial-v1`; § Production Pipeline (no Parallel Tracking / THREE-WAY)
-- [x] Gate #2b: orchestrator invokes `@designer` only; serial `@technical-artist` → `integration` `@developer`
-- [x] `designer.md` STOP: `Invoke @technical-artist`; `technical-artist.md`: `Set stage=integration, invoke @developer`
+- [x] Gate #2b: orchestrator invokes `@artist` only; serial `@technical-artist` → `integration` `@developer`
+- [x] `artist.md` STOP: `Invoke @technical-artist`; `technical-artist.md`: `Set stage=integration, invoke @developer`
 - [x] `developer.md` Runtime: no `stage: production` row; single `integration` branch
 - [x] `developer-phase1-flow.md`: trigger `integration`; no assets-not-required / Parallel with
 - [x] `CLAUDE.md` + `playcraft-orchestrator.mdc` + `collaboration.md` + `agent-conduct.md` + `agent-runtime-matrix.md` aligned
@@ -133,6 +132,15 @@ Maintenance checklist after editing `packages/cli/project-template`. Run before
 - [x] `collaboration.md` § STOP sync checklist step 5 (Plan convergence)
 - [x] Vitest `validate-workflow-stop.test.ts` covers `validatePlan`
 
+## Phase M — Developer role / flow split
+
+- [x] `developer.md` rewritten around role perspective (architecture / project state / requirement implementation / boundaries)
+- [x] Shared docs (`CLAUDE.md`, `agent-conduct`, `agent-runtime-matrix`, `pipeline-overview`) state that Skill literacy belongs to Developer cognition; flow docs only project it onto the current atom-tree
+- [x] `developer-phase1-flow.md` explicitly scoped to execution sequence, not role ownership
+- [x] `developer-dev-handoff.md` and `developer-impl-cookbook.md` marked as verification / pattern refs, not runtime authority
+- [x] `refs/README.md` clarified L1 vs L2 expectation for Developer docs
+- [x] `docs/role-analysis/04-developer-agent.md` updated to reflect role card vs flow split
+
 ## Phase L — convergence-v1 doc alignment audit (2026-05)
 
 Documents missed during the `production-serial-v1` → `convergence-v1` upgrade (commit `9fdc39a06`). Each item below has a [W#] tag indicating which audit wave applied the fix.
@@ -142,28 +150,24 @@ Documents missed during the `production-serial-v1` → `convergence-v1` upgrade
 ### W1 — Doc alignment
 
 - [x] `agent-runtime-matrix.md`: rewritten — replaced `integration` / `review` / `rework` with `ui_pass` / `ui_review` / `ui_rework` / `gameplay_pass`; `reworkRound` → `uiReworkRound`; added `devStatus` / `loadCheck` columns; added Post-STOP verification table
-- [x] All five agent L1 files (`pm.md`, `designer.md`, `technical-artist.md`, `developer.md`, `reviewer.md`): added `> **Workflow spec**: convergence-v1` declaration line at top
-- [x] `pm-workflow-detail.md`: `integration` → `ui_pass` (lines 144, 247)
+- [x] All five agent L1 files (`game-designer.md`, `artist.md`, `technical-artist.md`, `developer.md`, `reviewer.md`): added `> **Workflow spec**: convergence-v1` declaration line at top
+- [x] `refs/game-designer-workflow-detail.md`: `integration` → `ui_pass` (lines 144, 247)
 - [x] `developer-dev-handoff.md`: `stage → review` → `devStatus: ui_ready` / `ready` + handoff `Invoke @reviewer ui_diff/load_check` (line 99)
 
 ### W2 — Term alignment (ASR)
 
-- [ ] `playcraft-asset-state-sheet` Skill: "ASR State Inventory" → "ASR Coverage Matrix" (designer-log only has Coverage Matrix)
-- [ ] `designer-log.template.md` § ASR Coverage Matrix: add "Sheet grid" metadata (rows × cols + cell width × height + cell padding)
+- [ ] `playcraft-asset-state-sheet` Skill: "ASR State Inventory" → "ASR Coverage Matrix" (artist-log only has Coverage Matrix)
+- [ ] `artist-log.template.md` § ASR Coverage Matrix: add "Sheet grid" metadata (rows × cols + cell width × height + cell padding)
 - [ ] `ta-pipeline-cookbook.md` Step 0a + ASR extraction: aligned references
 
 ### W3 — Machine-readable ASR binding
 
-- [x] `atom-plan.template.json`: add `atoms[].asrSlot?: { sheet, row, col }` optional field (example VisualAtom row included)
-- [x] `atom-plan-format.md`: document `asrSlot` field semantics + crop formula + ownership table
-- [x] `core-model.md`: VisualAtom baseline → `asrSlot` linkage (assignment rule + scheduling metadata table)
-- [x] `ta-pipeline-cookbook.md` § ASR 提取方法: prepend "优先路径" reading `atom-plan.json` → `atoms[].asrSlot` for batch crop
-- [x] `designer-log.template.md` § Coverage: instruct Designer to mirror Coverage rows into `atom-plan.json asrSlot`
+- [ ] superseded under the simplified atom-tree manifest model; ASR coverage remains in `artist-log.template.md` and downstream logs instead of `atom-tree.json`
 
 ### W4 — Hook hardening + test suite re-alignment
 
-- [ ] `validate-workflow-stop.mjs`: add `designer` branch validating `designer-log.md § Skill Preflight`
-- [ ] `validate-workflow-stop.mjs`: `readStage()` regex accepts `stage: ui_pass` (YAML, no backticks)
+- [ ] `validate-workflow-stop.mjs`: add `artist` branch validating `artist-log.md § Skill Preflight`
+- [x] `validate-workflow-stop.mjs`: `readStage()` regex accepts current stage names (`pm`, `storyboard`, `development`, `style_exploration`, `production`, `ui_review`, `ui_rework`, `done`)
 - [ ] `packages/cli/test/validate-workflow-stop.test.ts`: add designer + YAML stage test cases; rewrite `Developer Implementation Plan sample` → use `UI Pass Plan` / `Gameplay Pass Plan`
 - [ ] `packages/cli/test/project-template-workflow.test.ts`: rewrite stale describes (originally pre-existing failures from commit `9fdc39a06`):
   - `workflow-docs` (9 tests): replace six-dimension scoring / `rework_round` / `stage: review` assertions with `convergence-v1` equivalents (`uiReworkRound`, `ui_diff`, `load_check`)
@@ -181,12 +185,56 @@ Documents missed during the `production-serial-v1` → `convergence-v1` upgrade
 
 ### W6 — Interface polish
 
-- [x] `designer-deliverable-spec.md` § Phase 2: clarify ICP supplementary PNG trigger condition (only when TA Step 0c confidence=low **and** crop/segment failed)
+- [x] `artist-deliverable-spec.md` § Phase 2: clarify ICP supplementary PNG trigger condition (only when TA Step 0c confidence=low **and** crop/segment failed)
 - [x] `ta-log.template.md` Style Interpretation: change "Do NOT proceed with any asset type where confidence = low" → atom-granularity ("hold that asset type; other types continue")
-- [x] `designer-log.template.md` + `ta-log.template.md` § mediaGroups Reuse: add `extension` column + filter note (Designer: `.aiaudio` only; TA: `.aiimage` + `.aisprite`)
-
-## Automated
+- [x] `artist-log.template.md` + `ta-log.template.md` § mediaGroups Reuse: add `extension` column + filter note (Artist: `.aiaudio` only; TA: `.aiimage` + `.aisprite`)
+
+## Phase GR — growth-rings-v1 alignment (2026-06)
+
+- [x] `collaboration.md` rewritten: Ring Gate Protocol + Iteration field ownership anchors
+- [x] `.cursor/rules/playcraft-orchestrator.mdc` — iteration×loop matrix (no waterfall Gates)
+- [x] `.cursor/rules/playcraft-subagent-boundary.mdc` — ring/loop boundaries
+- [x] Role cards + key refs updated to growth-rings vocabulary
+- [x] `validate-workflow-stop.mjs` — validatePlan uses `loop` not `stage`
+- [x] `verify:visual` + `verify:atom-conformance` + `workflow-doctor --strict`
+- [x] `validate-workflow-stop` invokes `workflow-doctor` `strict: 'stop'` on every gated STOP
+- [x] `ring:gate` passes `--strict-if-references` to `verify:visual` when ASR is locked
+- [x] `pipeline-overview.md` + `docs/harness/playcraft-harness-overview.md` updated
+- [x] Vitest: project-template-workflow, validate-workflow-stop, workflow-doctor
+
+> Phases A–N above describe **superseded** `convergence-v1` / `planning-stage-v1` history — do not use for new edits.
+
+## Phase O — engine-neutral scaffold (growth-rings + init-template, template `0.3.1-alpha.0`)
+
+- [x] `playcraft remix init-template` (`--engine`, `--from-atom-tree`, `--bake`, `--all-engines`)
+- [x] `engine-packs/{phaser,threejs}` + `compose.ts` (project-template ⊕ pack)
+- [x] `game/contract/` + `publishPlayableRuntime()` + Phaser adapter
+- [x] `workflow-doctor`: `.playcraft-engine` vs `meta.engineDecision.adapter`
+- [x] Ring 1 build gate in `playcraft-orchestrator.mdc`
+- [x] `CLAUDE.md` + `collaboration.md` + `pipeline-overview.md` — Ring 1 init-template chain
+- [x] `developer.md` / `skill-selector-guide.md` / `game-designer-workflow-detail.md` — engine vs atom scaffold
+- [x] `playable-record` / `playable-debug` / `playable-validate` / `playcraft-playable-optimization` SKILL — `window.__playable`
+- [x] `docs/harness/playcraft-harness-overview.md` (monorepo meta) — phaser/threejs + init-template
+- [x] Vitest: `scaffold-compose.test.ts`, workflow-doctor engine checks, verify-contract legacy warn
 
 ```bash
-cd packages/cli && pnpm exec vitest run test/project-template-workflow.test.ts test/validate-workflow-stop.test.ts
+cd packages/cli && pnpm exec vitest run test/scaffold-compose.test.ts test/workflow-doctor.test.ts test/verify-contract.test.ts test/harness-contract.test.ts
 ```
+
+## Phase N — planning-stage-v1 (Gate #1 slim + planning stage + Gate #exec)
+
+Flow change: Gate #1 only requires design-brief + DESIGN.md. After Gate #2a (MC selection), a new `planning` stage produces layout-spec (via sendMessage to Game Designer) → atom-tree (ref-flow) → implementation-plan (plan-writer). Gate #exec confirms the execution plan before development.
+
+- [x] `CLAUDE.md`: Stage Model string includes `planning`; Gates include `#exec`; Stage sync table updated; Stage transition table updated; Asset Contract locked after Gate #exec (not #1); Post-STOP verification includes planning docs
+- [x] `docs/team/collaboration.md`: Gate Protocol table includes `#exec`; Gate #1 section rewritten (2 deliverables only); Gate #exec section added; Stage field ownership includes `planning`; Four-doc discipline updated; Glossary updated (两件套)
+- [x] `docs/pipeline-overview.md`: 全景矩阵 includes `planning`; Gate 节点一览 includes `#exec`; Stage 1 pm 产出缩减; Stage 2.5 `planning` added; Stage 3 development adjusted; Orchestrator 决策速查 updated
+- [x] `docs/team/agent-runtime-matrix.md`: Game Designer row updated (planning stage sendMessage); Orchestrator row updated (planning + #exec); Reviewer row updated (execution_plan_check)
+- [x] `docs/team/agent-conduct.md`: Orchestrator MUST includes #exec; Reviewer MUST includes execution_plan_check; Asset Contract locked after Gate #exec; Gate #1 design_check simplified
+- [x] `templates/project-state.template.md`: Stage string includes `planning`; Gates table includes `#exec`; Handoff examples updated; File Index split (Gate #1 vs Planning)
+- [x] `.claude/agents/reviewer.md`: Runtime table includes `execution_plan_check`; Goals table includes new mode; Review flow summary updated
+- [x] `.claude/agents/game-designer.md`: Outputs section mentions layout-spec in planning stage via sendMessage
+- [x] `.claude/agents/refs/skill-selector-guide.md`: temporary ref-flow atom selection runs in ring 1 after Game Designer; ref-flow deepening remains ring 2+
+- [ ] `.claude/agents/refs/implementation-plan-guide.md`: Note that plan-writer runs in `planning` stage
+- [ ] `.claude/agents/refs/storyboard-generation-guide.md`: Confirm no layout-spec dependency (storyboard reads design-brief only)
+- [ ] `docs/team/workflow-changelog.md`: Document `planning-stage-v1` change
+- [ ] Tests updated for new stage/gate sequence

package/project-template/game/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Placeholder until `playcraft remix init-template` applies an engine pack.
+ * Safe to replace — see game/.playcraft-scaffold-pending
+ */
+
+export function startGame(parentId: string): { destroy?: (removeCanvas?: boolean) => void } {
+  const parent = document.getElementById(parentId);
+  const message = 'Engine not scaffolded. Run: playcraft remix init-template --from-atom-tree';
+  if (parent) {
+    parent.innerHTML = `<p style="font-family:system-ui,sans-serif;padding:2rem;color:#888">${message}</p>`;
+  }
+  console.warn(`[playcraft] ${message}`);
+  return {
+    destroy() {
+      if (parent) parent.innerHTML = '';
+    },
+  };
+}

package/project-template/globals.d.ts

@@ -0,0 +1,51 @@
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.jpeg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.gif" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.mp3" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.ogg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.wav" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.m4a" {
+  const src: string;
+  export default src;
+}
+
+declare const __DEV__: boolean;

package/project-template/index.css

@@ -0,0 +1,34 @@
+*,
+*::before,
+*::after {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+  -webkit-tap-highlight-color: transparent;
+}
+
+html,
+body {
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: #000;
+  -webkit-user-select: none;
+  user-select: none;
+  -webkit-touch-callout: none;
+  overscroll-behavior: none;
+  touch-action: none;
+}
+
+#game-container {
+  width: 100%;
+  height: 100%;
+  padding-top: env(safe-area-inset-top);
+  padding-right: env(safe-area-inset-right);
+  padding-bottom: env(safe-area-inset-bottom);
+  padding-left: env(safe-area-inset-left);
+}
+
+canvas {
+  display: block;
+}

package/project-template/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <meta name="format-detection" content="telephone=no" />
+    <title>PlayCraft Playable</title>
+  </head>
+  <body>
+    <div id="game-container"></div>
+    <script type="module" src="/main.ts"></script>
+  </body>
+</html>

package/project-template/main.ts

@@ -0,0 +1,9 @@
+import "./index.css";
+import { startGame } from "./game/index";
+
+let game = startGame("game-container");
+
+window.addEventListener("resize", () => {
+  game.destroy?.(true);
+  game = startGame("game-container");
+});

package/project-template/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "playcraft-game",
+  "version": "0.1.0",
+  "playcraftTemplateVersion": "0.3.2-alpha.0",
+  "description": "PlayCraft Playable Ads project",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "dev:start": "node skills/_shared/scripts/dev-start.mjs --root=.",
+    "dev:stop": "node skills/_shared/scripts/dev-start.mjs --root=. --stop",
+    "build": "vite build && npm run verify:build",
+    "build:raw": "vite build",
+    "verify:build": "node skills/playable-record/scripts/verify-build.mjs --root=.",
+    "preview": "vite preview",
+    "ensure:project": "node skills/_shared/scripts/ensure-project.mjs --root=.",
+    "ring:gate": "node skills/../.claude/hooks/gate-runner.mjs",
+    "workflow:doctor": "node skills/_shared/scripts/workflow-doctor.mjs --root=.",
+    "workflow:doctor:strict": "node skills/_shared/scripts/workflow-doctor.mjs --root=. --strict",
+    "state:set": "node skills/_shared/scripts/state-set.mjs --root=.",
+    "state:get": "node skills/_shared/scripts/state-get.mjs --root=.",
+    "state:advance-ring": "node skills/_shared/scripts/state-advance-ring.mjs --root=.",
+    "slice:set": "node skills/_shared/scripts/slice-set.mjs --root=.",
+    "verify:slice": "node skills/playable-record/scripts/verify-slice.mjs --root=. --use-dev",
+    "verify:slice-artist": "node skills/playable-record/scripts/verify-slice-artist.mjs --root=.",
+    "verify:slice-ta": "node skills/playable-record/scripts/verify-slice-ta.mjs --root=.",
+    "harness:smoke": "node skills/_shared/scripts/harness-smoke.mjs --root=.",
+    "context:budget": "node skills/_shared/scripts/context-budget.mjs --root=.",
+    "verify:env": "node skills/_shared/scripts/verify-env.mjs --root=.",
+    "skills:check": "node skills/_shared/scripts/skills-check.mjs --root=.",
+    "verify:ui": "python3 skills/playable-verify-ui/scripts/run_all.py",
+    "verify:ui:assets": "python3 skills/playable-verify-ui/scripts/run_all.py --only assets",
+    "verify:ui:layout": "python3 skills/playable-verify-ui/scripts/run_all.py --only layout",
+    "record:mp4": "node skills/playable-record/scripts/record-playable.mjs --root=. --use-dev",
+    "record:focus": "node skills/playable-record/scripts/record-playable.mjs --root=. --use-dev --focus",
+    "typecheck": "tsc --noEmit",
+    "verify:contract": "node skills/playable-record/scripts/verify-contract.mjs --root=. --use-dev",
+    "verify:lifecycle": "node skills/playable-record/scripts/verify-lifecycle.mjs --root=. --use-dev",
+    "verify:firstwin": "node skills/playable-record/scripts/verify-firstwin.mjs --root=. --use-dev",
+    "playground": "node skills/playable-focus/scripts/playground.mjs --root=.",
+    "sweep:L1": "node skills/playable-focus/scripts/playground.mjs --root=. sweep L1",
+    "sweep:G1": "node skills/playable-focus/scripts/playground.mjs --root=. sweep G1",
+    "repack:frames": "python3 skills/playable-fx-peak/scripts/repack-frame-sequence.py",
+    "mark:slices": "python3 skills/playable-art/scripts/import-gpt-art-sheets-v2.py --mark-only",
+    "import:gpt-art": "python3 skills/playable-art/scripts/import-gpt-art-sheets-v2.py",
+    "review:assets": "python3 skills/playable-art/scripts/review-processed-assets.py --root=.",
+    "verify:asset-review": "python3 skills/playable-art/scripts/review-processed-assets.py --root=. --strict --json",
+    "verify:slice-plan": "python3 skills/playable-verify-ui/scripts/verify_slice_plan.py --root=.",
+    "build-atlas": "python3 skills/playable-art/scripts/build-atlas.py",
+    "record:mp4:install": "playwright install chromium",
+    "bootstrap:playground": "node skills/playable-focus/scripts/bootstrap-playground.mjs --root=.",
+    "validate:frame-anchors": "python3 skills/playable-fx-peak/scripts/validate-frame-anchors.py",
+    "placeholder:gen": "python3 skills/_shared/scripts/gen-placeholder.py",
+    "placeholder:pack-sheet": "node skills/_shared/scripts/placeholder-pack-sheet.mjs --root=.",
+    "placeholder:gen-audio": "python3 skills/_shared/scripts/gen-placeholder-audio.py",
+    "verify:placeholders": "node skills/_shared/scripts/verify-placeholders.mjs --root=.",
+    "verify:fusion": "node skills/playable-record/scripts/verify-fusion.mjs --root=. --use-dev",
+    "verify:visual-ring1": "node skills/playable-record/scripts/verify-visual-ring1.mjs --root=. --use-dev",
+    "verify:visual-ring2": "node skills/playable-record/scripts/verify-visual-ring.mjs --root=. --ring=2 --use-dev",
+    "verify:visual-ring3": "node skills/playable-record/scripts/verify-visual-ring.mjs --root=. --ring=3 --use-dev",
+    "verify:vlm-video": "node skills/playable-record/scripts/verify-vlm-video.mjs --root=.",
+    "verify:visual": "python3 skills/playable-verify-ui/scripts/verify_visual.py --root=.",
+    "verify:bg-clean": "python3 skills/playable-verify-ui/scripts/verify_bg_clean.py --root=.",
+    "verify:tile-consistency": "python3 skills/playable-verify-ui/scripts/verify_tile_consistency.py --root=.",
+    "verify:text-overlap": "python3 skills/playable-verify-ui/scripts/verify_text_overlap.py --root=.",
+    "verify:vision": "python3 skills/playable-verify-ui/scripts/verify_vision_evidence.py --root=.",
+    "verify:asset-code-sync": "node skills/_shared/scripts/verify-asset-code-sync.mjs --root=.",
+    "verify:atom-conformance": "node skills/_shared/scripts/verify-atom-conformance.mjs --project=."
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.19.8",
+    "playwright": "^1.59.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.3"
+  }
+}

package/project-template/skills/README.md

@@ -0,0 +1,52 @@
+# Template Skills — 九步核心集（短名）
+
+## 命名（新 → 旧，口语仍可用）
+
+| 新目录名                  | 旧名                            | 用户可说                       |
+| ------------------------- | ------------------------------- | ------------------------------ |
+| **playable-validate**     | playable-video-validate-loop    | video validate loop / 整片优化 |
+| **playable-verify-ui**    | playable-ui-optimization        | ui optimization / 检查 UI      |
+| **playable-record**       | playable-record-playback        | 录屏                           |
+| **playable-debug**        | playable-debug-playback         | 一键通关                       |
+| **playable-art**          | playable-gpt-art-pipeline       | gpt art / 换美术               |
+| **playable-fx-peak**      | playable-frame-fx-peak-pipeline | peak pipeline / 帧光效         |
+| **playable-fx-decompose** | playable-decompose-fx           | decompose / 碎裂               |
+| **playable-animate**      | playable-animation-polish       | 动效手感                       |
+| **playable-focus**        | playable-focus-playground       | L→G / focus lab                |
+
+## 已删除 skill → 内容并入哪里
+
+| 已删                             | 并入                                                                          |
+| -------------------------------- | ----------------------------------------------------------------------------- |
+| playable-ui-regression-checklist | `playable-validate/validation-rules.md` §⑥ + `references/checklist-detail.md` |
+| playable-gpt-fx-frame-animation  | `playable-fx-peak` § GPT 出图与 A/B                                           |
+| playable-ui-reference-matching   | `playable-art` § Reference Matching                                           |
+| playable-frame-text-layout       | `playable-verify-ui` § Frame+Text + `measure_frame_content.py`                |
+| playable-performance-interaction | `playable-animate` § Performance + references                                 |
+| playable-single-html-bundle      | `playable-validate/references/single-html-bundle.md`                          |
+
+## Skill 索引
+
+| 用户意图                    | Skill                                                     | 角色                            |
+| --------------------------- | --------------------------------------------------------- | ------------------------------- |
+| Develop 占位资产            | [playable-placeholder](./playable-placeholder/SKILL.md)   | **Developer** (rings 1–3 build) |
+| 整片 / 当前页面（**默认**） | [playable-validate](./playable-validate/SKILL.md)         | TA / Reviewer                   |
+| 静态素材 / layout           | [playable-verify-ui](./playable-verify-ui/SKILL.md)       |
+| 录屏                        | [playable-record](./playable-record/SKILL.md)             |
+| 一键通关                    | [playable-debug](./playable-debug/SKILL.md)               |
+| GPT 美术                    | [playable-art](./playable-art/SKILL.md)                   |
+| 帧 ADD / repack             | [playable-fx-peak](./playable-fx-peak/SKILL.md)           |
+| 破碎                        | [playable-fx-decompose](./playable-fx-decompose/SKILL.md) |
+| 动效 / 卡顿                 | [playable-animate](./playable-animate/SKILL.md)           |
+| L→G                         | [playable-focus](./playable-focus/SKILL.md)               |
+
+Agent 起手：[\_shared/agent-prep.md](./_shared/agent-prep.md) → `npm run ensure:project`
+
+## 同步与漂移治理
+
+- **`skills/` 下的本地 playable skill 唯一同步源**：`node skills/_shared/scripts/sync-template-skills.mjs`。
+  不要手动逐文件复制或从其它路径拉取；任何对这九个 skill 的更新都应回到 monorepo 源、经此脚本同步，避免多源漂移。
+- **`.claude/skills/` 下的平台 skill 影子副本**：模板对少数平台 skill（`playcraft-image-generation`、
+  `playcraft-audio-generation`、`playcraft-sprite-generation`）保留静态副本并优先于 `@playcraft/skills` 包版本。
+  这是有意 fork——用 `npm run skills:check` 检测它们是否已与包版本漂移（`--strict` 在漂移时非零退出），
+  确保 fork 是"刻意保留"而非"忘记更新"。