@playcraft/cli 0.0.55 → 0.0.56

package/project-templates/threejs/.claude/hooks/block-ring1-tasklist.mjs

@@ -26,7 +26,7 @@ const RING1_BLOCKED_TOOLS = new Set([
 ]);
 
 function resolveProjectDir() {
-  const raw = process.env.CLAUDE_PROJECT_DIR || process.env.CURSOR_PROJECT_DIR || process.cwd();
+  const raw = process.env.CODEBUDDY_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.env.CURSOR_PROJECT_DIR || process.cwd();
   if (process.platform === 'win32' && /^\/[a-zA-Z]\//.test(raw)) {
     return raw[1].toUpperCase() + ':' + raw.slice(2).replace(/\//g, '\\');
   }
@@ -85,7 +85,7 @@ async function main() {
 
   emitDeny(
     `Ring 1 Dispatch Path: internal Task lists are blocked during iteration 1 (${toolName}). `
-    + `Use Task / @game-designer / temporary ref-flow atom-selection subagent / @developer spawn instead. Run npm run state:get and follow CLAUDE.md § Ring 1 Dispatch Path.`,
+    + `Use Task / @creative-director / @game-designer / temporary ref-flow atom-selection subagent / @developer spawn instead. Run npm run state:get and follow docs/team/collaboration.md § Ring 1 engine scaffold.`,
   );
 }
 

package/project-templates/threejs/.claude/hooks/user-prompt.mjs

@@ -7,7 +7,7 @@
  *   2. Snapshot (always, for full audit trail)
  *      Output goes to ../ to avoid nesting.
  *
- * Claude Code version — uses CLAUDE_PROJECT_DIR.
+ * Claude Code / CodeBuddy version — uses CODEBUDDY_PROJECT_DIR / CLAUDE_PROJECT_DIR.
  */
 
 import fs from 'node:fs';
@@ -26,7 +26,7 @@ const __dirname = path.dirname(__filename);
 // ── helpers ──────────────────────────────────────────────────────────────────
 
 function resolveProjectDir() {
-  const raw = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  const raw = process.env.CODEBUDDY_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd();
   if (process.platform === 'win32' && /^\/[a-zA-Z]\//.test(raw))
     return raw[1].toUpperCase() + ':' + raw.slice(2).replace(/\//g, '\\');
   return path.resolve(raw);
@@ -69,10 +69,9 @@ function sanitize(text, maxLen = 20) {
 
 function runSnapshot(projectDir, state, promptText) {
   const snapScript = path.join(__dirname, '..', 'snapshot.mjs');
-  const outDir = path.join(projectDir, '..', 'snap');
 
   if (!fs.existsSync(snapScript)) {
-    console.log('[snap] script not found');
+    console.error('[snap] script not found');
     return null;
   }
 
@@ -80,17 +79,17 @@ function runSnapshot(projectDir, state, promptText) {
   const snapName = prefix ? `prompt_${prefix}` : `prompt_turn-${state.turns}`;
 
   const r = spawnSync('node', [
-    snapScript, '--project', projectDir, '--out', outDir, '--name', snapName,
-  ], { encoding: 'utf8', timeout: 60_000, stdio: 'pipe' });
+    snapScript, '--project', projectDir, '--name', snapName, '--force',
+  ], { encoding: 'utf8', timeout: 120_000, stdio: 'pipe' });
 
   if (r.status !== 0) {
-    console.log(`[snap] failed: ${r.stderr?.slice(0, 200)}`);
+    console.error(`[snap] failed: ${r.stderr?.slice(0, 200)}`);
     return null;
   }
-  const m = r.stdout.match(/([^\s\\/]+\.zip)/);
-  const zipName = m ? m[1] : null;
-  if (zipName) console.log(`[snap] ${zipName}`);
-  return zipName;
+  const m = r.stdout.match(/Tag\s*:\s*(\S+)/);
+  const tagName = m ? m[1] : null;
+  if (tagName) console.error(`[snap] ${tagName}`);
+  return tagName;
 }
 
 // ── log ──────────────────────────────────────────────────────────────────────
@@ -124,7 +123,7 @@ function ring1DirectPathContext(projectDir) {
 
   const loopGuides = {
     clarify:
-      '- loop=clarify: Invoke @game-designer for concise gameplay lock. After GD STOP, spawn a temporary ref-flow atom-selection subagent for compact atom-tree selection. Do NOT write docs/DESIGN.md or docs/atom-tree.json as orchestrator.',
+      '- loop=clarify (split default): Read creative-director-kickoff-guide.md; translate user intent → Creative question (do not forward mechanism spec verbatim). Invoke @creative-director for Micro-Story Spine + north-star + creative-process, then @game-designer for design spec. After GD STOP, spawn temporary ref-flow atom-selection subagent. Do NOT write docs/DESIGN.md or docs/atom-tree.json as orchestrator.',
     build:
       '- loop=build: If scaffold not done, ensure the temporary atom-selection subagent has stopped, then run validate-atom-tree-selection → init-template → verify:contract → verify:lifecycle. Then Invoke @developer for ring 1 build.',
     verify:
@@ -135,12 +134,12 @@ function ring1DirectPathContext(projectDir) {
   return `[PlayCraft Ring 1 Dispatch Path — harness auto-injected]
 iteration=1 loop=${loop}: you are the orchestrator — dispatch role subagents, do NOT inline Designer/Developer work.
 - Do NOT create internal Task lists (TaskCreate / TaskUpdate / TaskList / TaskGet / TaskOutput / TaskStop).
-- Task / @game-designer / temporary ref-flow atom-selection subagent / @developer spawn IS required when the table below says invoke.
+- Task / @creative-director / @game-designer / temporary ref-flow atom-selection subagent / @developer spawn IS required when the table below says invoke.
 - First command: npm run state:get — use next_orchestrator_action + summary; do NOT open docs/project-state.md in full.
 ${loopGuide}
 - Game Designer owns docs/DESIGN.md. The temporary atom-selection subagent owns compact docs/atom-tree.json. Developer owns game/ + verifiers on STOP.
 - No Ring 2+ docs, no Reviewer / Artist / TA, no record:mp4 in ring 1.
-See CLAUDE.md § Ring 1 Dispatch Path and .cursor/rules/playcraft-orchestrator.mdc.`;
+See docs/team/collaboration.md § Ring 1 engine scaffold and .cursor/rules/playcraft-orchestrator.mdc.`;
 }
 
 function emitAdditionalContext(text) {
@@ -169,15 +168,15 @@ async function main() {
   const preview = promptText.replace(/\n/g, '\\n').slice(0, 300);
 
   // Snapshot (always)
-  const zipName = runSnapshot(projectDir, state, promptText);
-  if (zipName) state.lastSnapAt = ts;
+  const tagName = runSnapshot(projectDir, state, promptText);
+  if (tagName) state.lastSnapAt = ts;
 
   // Detailed log entry
   const lines = [
     '─'.repeat(60),
     `[${ts}] PROMPT #${state.turns}`,
     `    Input : ${preview}`,
-    `    Snapshot: ${zipName || 'FAILED'}`,
+    `    Snapshot: ${tagName || 'FAILED'}`,
     '─'.repeat(60),
   ];
   writeHookLog(projectDir, lines.join('\n'));
@@ -187,7 +186,7 @@ async function main() {
     emitAdditionalContext(ring1DirectPathContext(projectDir));
   }
 
-  console.log(`prompt #${state.turns} logged`);
+  console.error(`prompt #${state.turns} logged`);
   saveState(projectDir, state);
 }
 

package/project-templates/threejs/.claude/hooks/validate-workflow-stop.mjs

@@ -19,6 +19,9 @@ import {
 } from '../../skills/_shared/scripts/ring-config.mjs';
 import { normalizeSliceState, readState, stateExists, isSliceResolved } from '../../skills/_shared/scripts/state-store.mjs';
 import { validateBuildArtifactForSlice } from '../../skills/playable-record/scripts/lib/build-artifact.mjs';
+import { verifyDesignConsistency, validateAnimationSpine, validateStorySpine } from '../../skills/_shared/scripts/verify-design-consistency.mjs';
+import { validateSkillFidelity } from '../../skills/_shared/scripts/lib/skill-fidelity.mjs';
+import { isMechanismLocked } from '../../skills/_shared/scripts/disclosure-config.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const require = createRequire(import.meta.url);
@@ -43,9 +46,26 @@ const PLAN_REQUIRED_SUBS = {
 const PLACEHOLDER_RE = /\{\{[^}]+\}\}/;
 const MIN_TAKEAWAY_LEN = 8;
 
+function isCreativeDirectorSplitEnabledForStop() {
+  const raw = String(process.env.CREATIVE_DIRECTOR_SPLIT ?? '1').trim().toLowerCase();
+  return raw !== '0' && raw !== 'false' && raw !== 'off';
+}
+
+/** GD mechanism-lock STOP (before north-star exists). */
+function isGameDesignerMechanismPhase(projectDir) {
+  if (!isCreativeDirectorSplitEnabledForStop()) return false;
+  if (fs.existsSync(path.join(projectDir, 'docs/north-star.md'))) return false;
+  const state = readState(projectDir);
+  const ctx = state.handoffContext || {};
+  const primarySkill = String(ctx.primaryGameplaySkill ?? '').trim();
+  if (!primarySkill || primarySkill === 'unset') return false;
+  if (fs.existsSync(path.join(projectDir, 'docs/level-sketch.json'))) return false;
+  return isMechanismLocked(projectDir, ctx);
+}
+
 /** Required upstream docs scale with growth ring — ring 1 stays minimal (DESIGN only; design-brief is optional scratch). */
 const DEV_REQUIRED_DOCS_BY_RING = {
-  1: ['docs/project-state.md', 'docs/DESIGN.md'],
+  1: ['docs/project-state.md', 'docs/DESIGN.md', 'docs/atom-tree.json'],
   2: [
     'docs/project-state.md',
     'docs/design-brief.md',
@@ -95,6 +115,7 @@ const ROLE_LOG = {
   artist: { log: 'logs/artist-log.md', label: 'Artist' },
   reviewer: { log: 'logs/review-report.md', label: 'Reviewer' },
   'game-designer': { log: null, label: 'Game Designer' },
+  'creative-director': { log: null, label: 'Creative Director' },
   'skill-selector': { log: null, label: 'Temporary Atom Selector' },
 };
 
@@ -488,6 +509,7 @@ function detectRole(input) {
     if (n === 'developer-lead' || n === 'developer' || n === 'dev') return 'developer';
     if (n === 'artist') return 'artist';
     if (n === 'reviewer' || n === 'review') return 'reviewer';
+    if (n === 'creative-director' || n === 'creative director') return 'creative-director';
     if (n === 'game-designer' || n === 'game designer' || n === 'designer') return 'game-designer';
     if (n === 'skill-selector' || n === 'skill selector' || n === 'ref-flow') return 'skill-selector';
   }
@@ -803,6 +825,88 @@ function validateReviewerStop(projectDir) {
   return errors;
 }
 
+/**
+ * @param {string} projectDir
+ */
+function validateCreativeDirectorStop(projectDir) {
+  const errors = [];
+  const handoff = readHandoff(projectDir);
+  const state = readState(projectDir);
+
+  if (handoff.subagent_stop !== 'true') {
+    errors.push('Creative Director STOP requires subagent_stop: true');
+  }
+  if ((handoff.waiting_for || '').toLowerCase() !== 'orchestrator') {
+    errors.push('Creative Director STOP requires waiting_for: orchestrator');
+  }
+  if (!handoff.next_orchestrator_action || handoff.next_orchestrator_action === 'null') {
+    errors.push('Creative Director STOP requires next_orchestrator_action (Invoke @game-designer — ring 1 design spec)');
+  }
+
+  for (const doc of ['docs/north-star.md', 'docs/creative-process.md']) {
+    errors.push(...validateDocFile(projectDir, doc));
+  }
+
+  const northPath = path.join(projectDir, 'docs/north-star.md');
+  if (fs.existsSync(northPath)) {
+    const north = fs.readFileSync(northPath, 'utf8');
+    if (!/One-liner|一句话/i.test(north) || north.replace(/\s/g, '').length < 80) {
+      errors.push('docs/north-star.md: missing substantive One-liner / north star fields');
+    }
+    if (!/Rejected vibe|拒绝/i.test(north)) {
+      errors.push('docs/north-star.md: missing Rejected vibe section');
+    }
+    if (!/Micro-Story\s*Spine/i.test(north)) {
+      errors.push('docs/north-star.md: missing Micro-Story Spine section');
+    }
+  }
+
+  const cpPath = path.join(projectDir, 'docs/creative-process.md');
+  let creativeProcessText = '';
+  if (fs.existsSync(cpPath)) {
+    creativeProcessText = fs.readFileSync(cpPath, 'utf8');
+    const candidates = (creativeProcessText.match(/###\s*Candidate\s+[ABC]/gi) || []).length;
+    if (candidates < 3) {
+      errors.push('docs/creative-process.md: Phase 1 requires ≥3 candidates (A/B/C)');
+    }
+  }
+
+  if (fs.existsSync(northPath)) {
+    const north = fs.readFileSync(northPath, 'utf8');
+    const spineResult = validateStorySpine(north, '', creativeProcessText);
+    for (const p of spineResult.problems) {
+      errors.push(`docs/north-star.md: ${p}`);
+    }
+    if (spineResult.metrics.narrativeLevel === 'L3') {
+      errors.push('docs/north-star.md: Narrative level L3 forbidden — use L2 or below');
+    }
+  }
+
+  if (fs.existsSync(path.join(projectDir, 'docs/DESIGN.md'))) {
+    const designLen = fs.readFileSync(path.join(projectDir, 'docs/DESIGN.md'), 'utf8').length;
+    if (designLen > 200) {
+      errors.push('Creative Director must not write substantive docs/DESIGN.md — spec phase is @game-designer');
+    }
+  }
+
+  const primarySkill = String(state?.handoffContext?.primaryGameplaySkill ?? '').trim();
+  if (!primarySkill || primarySkill === 'unset') {
+    errors.push('Creative Director STOP requires handoffContext.primaryGameplaySkill (set during mechanism lock)');
+  }
+
+  if (fs.existsSync(northPath)) {
+    const north = fs.readFileSync(northPath, 'utf8');
+    const fidelity = validateSkillFidelity(projectDir, { northStarMd: north, payoffOnly: true });
+    if (!fidelity.skipped && !fidelity.pass) {
+      for (const reason of fidelity.driftReasons) {
+        errors.push(`CD PGS fidelity: ${reason}`);
+      }
+    }
+  }
+
+  return errors;
+}
+
 /**
  * @param {string} projectDir
  */
@@ -826,8 +930,41 @@ function validateGameDesignerStop(projectDir) {
     return errors;
   }
 
-  const ring = Math.min(Math.max(iteration, 1), 4);
   const state = readState(projectDir);
+  const ring = Math.min(Math.max(iteration, 1), 4);
+  const mechanismPhase = ring === 1 && isGameDesignerMechanismPhase(projectDir);
+
+  if (mechanismPhase) {
+    const ctx = state.handoffContext || {};
+    const primarySkill = String(ctx.primaryGameplaySkill ?? '').trim();
+    if (!primarySkill || primarySkill === 'unset') {
+      errors.push('Mechanism lock STOP requires handoffContext.primaryGameplaySkill');
+    }
+    if (!isMechanismLocked(projectDir, ctx)) {
+      errors.push('Mechanism lock STOP requires docs/atom-tree.json meta.skillsMatch.items non-empty');
+    }
+    const atomTreePath = path.join(projectDir, 'docs/atom-tree.json');
+    if (!fs.existsSync(atomTreePath)) {
+      errors.push('Mechanism lock STOP requires docs/atom-tree.json');
+    } else {
+      errors.push(...validateHandoffContext(projectDir, 'game-designer'));
+      const refs = ctx.lastRole?.artifactRefs || [];
+      if (!refs.some((r) => String(r).includes('atom-tree.json'))) {
+        errors.push('handoffContext.lastRole.artifactRefs must include docs/atom-tree.json');
+      }
+    }
+    if (fs.existsSync(path.join(projectDir, 'docs/north-star.md'))) {
+      errors.push('Mechanism phase must not write docs/north-star.md — creative-director owns north-star');
+    }
+    if (fs.existsSync(path.join(projectDir, 'docs/DESIGN.md'))) {
+      const designLen = fs.readFileSync(path.join(projectDir, 'docs/DESIGN.md'), 'utf8').length;
+      if (designLen > 200) {
+        errors.push('Mechanism phase must not write substantive docs/DESIGN.md');
+      }
+    }
+    return errors;
+  }
+
   const ss = normalizeSliceState(state.sliceState || {});
   const sliceAxisClarify = ss.slices.length > 0 && (ring === 1 || ring === 2);
 
@@ -841,7 +978,25 @@ function validateGameDesignerStop(projectDir) {
   if (ring === 1) {
     const designPath = path.join(projectDir, 'docs/DESIGN.md');
     if (fs.existsSync(designPath)) {
-      errors.push(...validatePlayableSeedDesign(fs.readFileSync(designPath, 'utf8')));
+      const designContent = fs.readFileSync(designPath, 'utf8');
+      errors.push(...validatePlayableSeedDesign(designContent));
+      errors.push(...validateDesignFusionSection(designContent));
+    }
+    const sketchPath = path.join(projectDir, 'docs/level-sketch.json');
+    if (!fs.existsSync(sketchPath) && sliceAxisClarify) {
+      errors.push('Ring 1 clarify requires docs/level-sketch.json (executable level sketch)');
+    }
+    if (ring === 1 && sliceAxisClarify && fs.existsSync(sketchPath)) {
+      if (fs.existsSync(designPath)) {
+        const designContent = fs.readFileSync(designPath, 'utf8');
+        errors.push(...validateAnimationSpine(designContent));
+      }
+      const designCheck = verifyDesignConsistency(projectDir);
+      if (!designCheck.ok) {
+        for (const p of designCheck.problems) {
+          errors.push(`verify:design: ${p}`);
+        }
+      }
     }
   }
 
@@ -1318,6 +1473,9 @@ function validateRole(projectDir, role) {
   if (role === 'reviewer') {
     return validateReviewerStop(projectDir);
   }
+  if (role === 'creative-director') {
+    return validateCreativeDirectorStop(projectDir);
+  }
   if (role === 'game-designer') {
     return validateGameDesignerStop(projectDir);
   }
@@ -1393,20 +1551,28 @@ function validateRole(projectDir, role) {
 }
 
 /** Selected atoms that must be linked into .claude/skills/ (excludes bundled playcraft-* skills). */
-function readSelectedAtomsForLink(projectDir) {
+function readAtomTreeForPreflight(projectDir) {
   const jsonPath = path.join(projectDir, 'docs/atom-tree.json');
-  if (!fs.existsSync(jsonPath)) return [];
+  if (!fs.existsSync(jsonPath)) return { exists: false, parseError: false, atoms: [] };
   try {
     const tree = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
     const atoms = Array.isArray(tree?.meta?.selectedAtoms) ? tree.meta.selectedAtoms : [];
-    return atoms
-      .map((a) => (typeof a === 'string' ? a.trim() : ''))
-      .filter((a) => a && !a.startsWith('{{') && !a.startsWith('playcraft-'));
+    return {
+      exists: true,
+      parseError: false,
+      atoms: atoms
+        .map((a) => (typeof a === 'string' ? a.trim() : ''))
+        .filter((a) => a && !a.startsWith('{{') && !a.startsWith('playcraft-')),
+    };
   } catch {
-    return [];
+    return { exists: true, parseError: true, atoms: [] };
   }
 }
 
+function readSelectedAtomsForLink(projectDir) {
+  return readAtomTreeForPreflight(projectDir).atoms;
+}
+
 /** Extract a markdown section body from `heading` up to the next same-or-higher-level heading. */
 function extractMarkdownSection(content, heading) {
   const start = content.indexOf(heading);
@@ -1437,6 +1603,21 @@ function countFilledTableRows(section) {
   return count;
 }
 
+function missingSelectedAtomPreflightRows(content, atoms) {
+  const missing = [];
+  if (!content.includes('docs/atom-tree.json')) missing.push('docs/atom-tree.json');
+  const preflight = extractMarkdownSection(content, '## Skill Preflight');
+  if (!preflight) {
+    missing.push('logs/developer-log.md § Skill Preflight');
+    return missing;
+  }
+  for (const atom of atoms) {
+    const skillPath = `.claude/skills/${atom}/SKILL.md`;
+    if (!preflight.includes(atom) || !preflight.includes(skillPath)) missing.push(skillPath);
+  }
+  return missing;
+}
+
 /**
  * Shared skill-link + Skill Preflight + placeholder materialization evidence gate.
  * Applied at every ring's Developer build STOP so "use placeholders / implement per skill"
@@ -1447,7 +1628,15 @@ function countFilledTableRows(section) {
  */
 function validateSkillAndPlaceholderEvidence(projectDir, content) {
   const errors = [];
-  const atoms = readSelectedAtomsForLink(projectDir);
+  const atomTree = readAtomTreeForPreflight(projectDir);
+  const atoms = atomTree.atoms;
+
+  if (!atomTree.exists) {
+    errors.push('Skill Preflight: missing docs/atom-tree.json — dispatchPacket.requiredContext cannot disclose selected atom Skills');
+  }
+  if (atomTree.parseError) {
+    errors.push('Skill Preflight: docs/atom-tree.json must be valid JSON before Developer STOP');
+  }
 
   // 1. Skill link evidence: selected atoms materialized under .claude/skills/
   const skillsDir = path.join(projectDir, '.claude/skills');
@@ -1458,13 +1647,19 @@ function validateSkillAndPlaceholderEvidence(projectDir, content) {
     );
   }
 
-  // 2. Skill Preflight filled (one non-template row per atom)
+  // 2. Skill Preflight filled (one exact-path row per atom)
   const preflight = extractMarkdownSection(content, '## Skill Preflight');
   if (!preflight || countFilledTableRows(preflight) < Math.max(1, atoms.length)) {
     errors.push(
       'Skill Preflight: developer-log.md § Skill Preflight is not filled — add one non-template row per selected atom (read .claude/skills/<atom>/SKILL.md: what it provides + how you use it)',
     );
   }
+  const missingRows = missingSelectedAtomPreflightRows(content, atoms);
+  if (missingRows.length > 0) {
+    errors.push(
+      `Skill Preflight: missing required reading evidence for ${missingRows.join(', ')} — read docs/atom-tree.json and add one exact .claude/skills/<atom>/SKILL.md row for every meta.selectedAtoms item`,
+    );
+  }
 
   // 3. Placeholder materialization evidence (placeholder-first, not code-draw-only)
   const placeholder = extractMarkdownSection(content, '### Placeholder materialization');
@@ -1779,6 +1974,8 @@ export {
   validateGameDesignerSeedContext,
   validateGameDesignerSliceQueueSeed,
   validateSkillsMatchSliceRefs,
+  validateSkillAndPlaceholderEvidence,
+  missingSelectedAtomPreflightRows,
   validateDesignFusionSection,
   validateReviewerHandoff,
   validateReviewReportDoD,
@@ -1797,7 +1994,6 @@ export {
   PLAN_HEADING,
   PLAN_REQUIRED_SUBS,
   ROLE_LOG,
-  validateSkillAndPlaceholderEvidence,
   validateDevUrlDebugFlag,
   readSelectedAtomsForLink,
   extractMarkdownSection,
@@ -1809,6 +2005,7 @@ async function main() {
   const input = parseHookInput(stdin);
 
   const projectDir =
+    process.env.CODEBUDDY_PROJECT_DIR ||
     process.env.CLAUDE_PROJECT_DIR ||
     process.env.CURSOR_PROJECT_DIR ||
     process.cwd();

package/project-templates/threejs/.claude/skills/playcraft-playable-optimization/SKILL.md

@@ -51,35 +51,35 @@ PlayCraft 是 **Vite** 项目，`ensure-project` 会检测到 `vite.config.ts` +
 
 ## 与 PlayCraft growth-rings 的接点
 
-| iteration / loop               | 谁调用                  | 调用什么                                   | 产出                           |
-| ------------------------------ | ----------------------- | ------------------------------------------ | ------------------------------ |
-| ring 1 `loop: build`（收尾）   | Developer               | `state:get` 披露的 contract/lifecycle/firstwin | 轻量 HOOK 生命周期 + 首关可胜 |
-| ring 2+ `loop: build`（收尾）  | Developer               | 仅运行 `state:get.nextCommands` 中的 `verify:ui` / `record:mp4` | 当前 Ring 证据 |
-| ring 4 `loop: verify`          | Reviewer                | `verify:ui` → `playwright-cli` 截图        | asset/layout 先行拦截          |
-| ring 4 verify ui_diff fail     | Developer / TA / Artist | 读 `playable-validate` 子 skill 做最小 fix | 修复后重跑 verify + record     |
-| ring 4 optional optimization   | Reviewer / Orchestrator | `playable-validate` loop                   | `validate/PLAYABLE-*.md` + MP4 |
+| iteration / loop              | 谁调用                  | 调用什么                                                        | 产出                           |
+| ----------------------------- | ----------------------- | --------------------------------------------------------------- | ------------------------------ |
+| ring 1 `loop: build`（收尾）  | Developer               | `state:get` 披露的 contract/lifecycle/firstwin                  | 轻量 HOOK 生命周期 + 首关可胜  |
+| ring 2+ `loop: build`（收尾） | Developer               | 仅运行 `state:get.nextCommands` 中的 `verify:ui` / `record:mp4` | 当前 Ring 证据                 |
+| ring 4 `loop: verify`         | Reviewer                | `verify:ui` → `playwright-cli` 截图                             | asset/layout 先行拦截          |
+| ring 4 verify ui_diff fail    | Developer / TA / Artist | 读 `playable-validate` 子 skill 做最小 fix                      | 修复后重跑 verify + record     |
+| ring 4 optional optimization  | Reviewer / Orchestrator | `playable-validate` loop                                        | `validate/PLAYABLE-*.md` + MP4 |
 
 ---
 
 ## 一句话指令表
 
-| 用户/Agent 意图          | 命令/入口                                                              |
-| ------------------------ | ---------------------------------------------------------------------- |
-| 查看当前可运行命令       | `npm run state:get -- --json`                                          |
-| 整片优化到可交付         | 读 `skills/playable-validate/SKILL.md` § Agent 入口                    |
-| 检查 UI / atlas / layout | 仅当 `state:get.nextCommands` 披露：`npm run verify:ui`                |
+| 用户/Agent 意图          | 命令/入口                                                                     |
+| ------------------------ | ----------------------------------------------------------------------------- |
+| 查看当前可运行命令       | `npm run state:get -- --json`                                                 |
+| 整片优化到可交付         | 读 `skills/playable-validate/SKILL.md` § Agent 入口                           |
+| 检查 UI / atlas / layout | 仅当 `state:get.nextCommands` 披露：`npm run verify:ui`                       |
 | 录完整局 headed MP4      | 仅当 `state:get.nextCommands` 披露：`npm run record:mp4 -- --headed --fps=60` |
-| 只录某个 focus zone      | `npm run record:focus -- --scope=PHASE --fixture=endcard-win --headed` |
-| 优化 match 碎裂 FX       | 读 `skills/playable-fx-decompose/SKILL.md`                             |
-| 优化帧光效 / burst       | 读 `skills/playable-fx-peak/SKILL.md`                                  |
-| 优化动效手感             | 读 `skills/playable-animate/SKILL.md`                                  |
-| 局部 L→G 穷举            | `npm run sweep:L1` / `npm run sweep:G1`                                |
+| 只录某个 focus zone      | `npm run record:focus -- --scope=PHASE --fixture=endcard-win --headed`        |
+| 优化 match 碎裂 FX       | 读 `skills/playable-fx-decompose/SKILL.md`                                    |
+| 优化帧光效 / burst       | 读 `skills/playable-fx-peak/SKILL.md`                                         |
+| 优化动效手感             | 读 `skills/playable-animate/SKILL.md`                                         |
+| 局部 L→G 穷举            | `npm run sweep:L1` / `npm run sweep:G1`                                       |
 
 ---
 
 ## Vite 项目注意事项
 
-PlayCraft 项目用 Vite，`record:mp4` 默认脚本已经带了 `--use-dev --url=http://localhost:3000/`。只在当前 Ring 已披露 `record:mp4` 时运行：
+PlayCraft 项目用 Vite，`record:mp4` 默认脚本已经带了 `--use-dev --url=http://localhost:5173/`。只在当前 Ring 已披露 `record:mp4` 时运行：
 
 ```bash
 npm run record:mp4 -- --headed --fps=60
@@ -88,10 +88,10 @@ npm run record:mp4 -- --headed --fps=60
 这会：
 
 1. 在当前目录启动 `npm run dev`。
-2. 等待 `http://localhost:3000/` 可访问。
+2. 等待 `http://localhost:5173/` 可访问。
 3. 用 Playwright 打开该 URL 并录制。
 
-如果 Vite 端口不是 3000，改 `package.json` 里的 `record:mp4` 脚本，或手动：
+如果 Vite 端口不是 5173，改 `package.json` 里的 `record:mp4` 脚本，或手动：
 
 ```bash
 # 终端 1

package/project-templates/threejs/.cursor/rules/playcraft-orchestrator.mdc

@@ -123,7 +123,7 @@ When executing `next_orchestrator_action`, **also** update `iteration` / `loop`
 
 | iteration | loop | Typical `next_orchestrator_action` |
 | --------- | ---- | ---------------------------------- |
-| 1 | clarify | Invoke `@game-designer` — engine root + core loop spec |
+| 1 | clarify | `@game-designer` mechanism lock → read `creative-director-kickoff-guide.md` → `@creative-director` (PGS wrap) → `@game-designer` spec; `CREATIVE_DIRECTOR_SPLIT=0` for monolithic control |
 | 1 | build | Invoke `@developer` — engine boot + placeholder core gameplay |
 | 1 | verify | Developer self-gate → `npm run ring:gate -- --iteration 1` → Ring Gate (no `@reviewer`) |
 | 2 | clarify | `@game-designer` — periphery atoms (HUD / flow) |