@playcraft/cli 0.0.55 → 0.0.57

package/project-template/.claude/hooks/README.md

@@ -4,16 +4,16 @@ Hooks for **Claude Code** (`.claude/settings.json`), also shared with **Cursor**
 
 ## Hook inventory
 
-| Hook                               | Event                        | When                                                                | What                                                                                                                                   |
-| ---------------------------------- | ---------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `validate-atom-tree-selection.mjs` | `PostToolUse`                | atom-tree.json written/edited                                       | Validates selected atoms and skill references                                                                                          |
-| `gate-runner.mjs`                  | manual / `npm run ring:gate` | Before Ring Gate per iteration                                      | Runs objective DoD verifiers, writes `ringDoD` + Ring Gate Runner verdict                                                              |
-| `gate-dispatcher.mjs`              | `PostToolUse`                | AskUserQuestion called                                              | Identifies gate confirmations, dispatches to `gate.mjs`                                                                                |
-| `gate.mjs`                         | (called by dispatcher)       | Ring Gate confirmed by user                                         | Runs snapshot, writes gate log, and advances state when accepted                                                                       |
-| `user-prompt.mjs`                  | `UserPromptSubmit`           | Every user prompt                                                   | Increments turn counter, snapshots project, writes prompt log; **iteration 1** injects Ring 1 Dispatch Path (orchestrator → subagents) |
-| `block-ring1-tasklist.mjs`         | `PreToolUse`                 | TaskCreate/Update/List/Get/Output/Stop                              | Blocks internal Task lists during iteration 1; **Task / @game-designer / temporary ref-flow / @developer spawn still allowed**         |
-| `validate-workflow-stop.mjs`       | `SubagentStop`               | TA/Developer/Artist/Reviewer/Game Designer/temporary ref-flow stops | Validates logs, handoff, and ring docs before subagent may stop                                                                        |
-| `snapshot-milestone.mjs`           | `SubagentStop`               | Subagent stops                                                      | Detects milestone events (gate passed, dev ready) and snapshots                                                                        |
+| Hook                               | Event                        | When                                                                | What                                                                                                                                                |
+| ---------------------------------- | ---------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `validate-atom-tree-selection.mjs` | `PostToolUse`                | atom-tree.json written/edited                                       | Validates selected atoms and skill references                                                                                                       |
+| `gate-runner.mjs`                  | manual / `npm run ring:gate` | Before Ring Gate per iteration                                      | Runs objective DoD verifiers, writes `ringDoD` + Ring Gate Runner verdict                                                                           |
+| `gate-dispatcher.mjs`              | `PostToolUse`                | AskUserQuestion called                                              | Identifies gate confirmations, dispatches to `gate.mjs`                                                                                             |
+| `gate.mjs`                         | (called by dispatcher)       | Ring Gate confirmed by user                                         | Runs snapshot, writes gate log, and advances state when accepted                                                                                    |
+| `user-prompt.mjs`                  | `UserPromptSubmit`           | Every user prompt                                                   | Increments turn counter, snapshots project, writes prompt log; **iteration 1** injects Ring 1 Dispatch Path (orchestrator → subagents)              |
+| `block-ring1-tasklist.mjs`         | `PreToolUse`                 | TaskCreate/Update/List/Get/Output/Stop                              | Blocks internal Task lists during iteration 1; **Task / @creative-director / @game-designer / temporary ref-flow / @developer spawn still allowed** |
+| `validate-workflow-stop.mjs`       | `SubagentStop`               | TA/Developer/Artist/Reviewer/Game Designer/temporary ref-flow stops | Validates logs, handoff, and ring docs before subagent may stop                                                                                     |
+| `snapshot-milestone.mjs`           | `SubagentStop`               | Subagent stops                                                      | Detects milestone events (gate passed, dev ready) and snapshots                                                                                     |
 
 ## `validate-atom-tree-selection.mjs`
 
@@ -84,7 +84,7 @@ Triggered **on every `UserPromptSubmit`**. Actions:
 1. **Increment turn counter** — stored in `.claude/logs/session.json`
 2. **Snapshot project** — calls `../snapshot.mjs` with a sanitized prompt prefix as name
 3. **Write prompt log** — appends to `logs/hook.log` with timestamp, turn number, and prompt preview
-4. **Ring 1 dispatch injection** — when `iteration: 1` in state, emits `hookSpecificOutput.additionalContext` with orchestrator dispatch recipe (invoke `@game-designer` / temporary ref-flow / `@developer`; no inline role-play; no internal Task lists)
+4. **Ring 1 dispatch injection** — when `iteration: 1` in state, emits `hookSpecificOutput.additionalContext` with orchestrator dispatch recipe (invoke `@creative-director` → `@game-designer` / temporary ref-flow / `@developer`; no inline role-play; no internal Task lists)
 
 Non-blocking — snapshot failures are logged but never prevent the prompt from being processed.
 
@@ -92,7 +92,7 @@ Non-blocking — snapshot failures are logged but never prevent the prompt from
 
 Triggered **before `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` / `TaskOutput` / `TaskStop`** when `iteration: 1`.
 
-- Denies the tool call with `permissionDecision: deny` and points the agent to dispatch subagents via `Task` / `@game-designer` / temporary ref-flow / `@developer`
+- Denies the tool call with `permissionDecision: deny` and points the agent to dispatch subagents via `Task` / `@creative-director` / `@game-designer` / temporary ref-flow / `@developer`
 - Ring 2+ passes through unchanged
 
 On deny: exit `2` + JSON `hookSpecificOutput.permissionDecision: deny`

package/project-template/.claude/hooks/block-developer-preflight.mjs

@@ -44,20 +44,28 @@ function readIteration(projectDir) {
 }
 
 /** Selected atoms that should be linked into .claude/skills/ (excludes bundled playcraft-* skills). */
-function readSelectedAtoms(projectDir) {
+function readAtomTree(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 readSelectedAtoms(projectDir) {
+  return readAtomTree(projectDir).atoms;
+}
+
 /** Atoms with no linked dir under .claude/skills/. */
 function missingLinks(projectDir, atoms) {
   const skillsDir = path.join(projectDir, '.claude', 'skills');
@@ -87,13 +95,28 @@ function countFilledRows(section) {
   return count;
 }
 
-function isSkillPreflightFilled(projectDir, atomCount) {
+function missingPreflightEvidence(projectDir, atoms) {
   const logPath = path.join(projectDir, 'logs', 'developer-log.md');
-  if (!fs.existsSync(logPath)) return false;
+  if (!fs.existsSync(logPath)) return ['logs/developer-log.md missing'];
   const content = fs.readFileSync(logPath, 'utf8');
+  const missing = [];
+  if (!content.includes('docs/atom-tree.json')) missing.push('docs/atom-tree.json');
   const section = extractSection(content, '## Skill Preflight');
-  if (!section) return false;
-  return countFilledRows(section) >= Math.max(1, atomCount);
+  if (!section) {
+    missing.push('logs/developer-log.md § Skill Preflight');
+    return missing;
+  }
+  for (const atom of atoms) {
+    const skillPath = `.claude/skills/${atom}/SKILL.md`;
+    if (!section.includes(atom) || !section.includes(skillPath)) missing.push(skillPath);
+  }
+  if (atoms.length === 0 && countFilledRows(section) < 1) missing.push('one non-template Skill Preflight row');
+  return missing;
+}
+
+function isSkillPreflightFilled(projectDir, atomCount) {
+  const atoms = readSelectedAtoms(projectDir);
+  return missingPreflightEvidence(projectDir, atoms).length === 0 && atoms.length >= atomCount;
 }
 
 function isGameSourcePath(filePath, projectDir) {
@@ -158,7 +181,18 @@ async function main() {
   const iteration = readIteration(projectDir);
   if (iteration < 1 || iteration > 3) process.exit(0);
 
-  const atoms = readSelectedAtoms(projectDir);
+  const atomTree = readAtomTree(projectDir);
+  if (!atomTree.exists) {
+    emitDeny(
+      'Developer preflight gate: missing docs/atom-tree.json. '
+      + 'Run the atom-tree selection/scaffold path before editing game/ so dispatchPacket.requiredContext can disclose selected atom Skills.',
+    );
+  }
+  if (atomTree.parseError) {
+    emitDeny('Developer preflight gate: docs/atom-tree.json is not valid JSON; fix it before editing game/.');
+  }
+
+  const atoms = atomTree.atoms;
 
   const unlinked = missingLinks(projectDir, atoms);
   if (unlinked.length > 0) {
@@ -168,10 +202,12 @@ async function main() {
     );
   }
 
-  if (!isSkillPreflightFilled(projectDir, atoms.length)) {
+  const missingEvidence = missingPreflightEvidence(projectDir, atoms);
+  if (missingEvidence.length > 0) {
     emitDeny(
       'Developer preflight gate: logs/developer-log.md § Skill Preflight is not filled. '
-      + 'Before editing game/, read .claude/skills/<atom>/SKILL.md for each selected atom and fill the § Skill Preflight table (one non-template row per atom: what it provides + how you use it). '
+      + `Missing required reading evidence: ${missingEvidence.join(', ')}. `
+      + 'Before editing game/, read docs/atom-tree.json and .claude/skills/<atom>/SKILL.md for each selected atom, then fill one exact-path row per atom (what it provides + how you use it). '
       + 'Then generate placeholders (npm run placeholder:gen) and resume coding.',
     );
   }

package/project-template/.claude/hooks/block-ring1-tasklist.mjs

@@ -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-template/.claude/hooks/user-prompt.mjs

@@ -14,11 +14,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
-import {
-  parseHandoffBlock,
-  parseHandoffYaml,
-  resolveProjectStatePath,
-} from '../../skills/_shared/scripts/state-handoff.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -123,7 +118,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:
@@ -134,12 +129,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) {
@@ -181,11 +176,6 @@ async function main() {
   ];
   writeHookLog(projectDir, lines.join('\n'));
 
-  const { iteration } = readHandoffState(projectDir);
-  if (iteration === 1) {
-    emitAdditionalContext(ring1DirectPathContext(projectDir));
-  }
-
   console.error(`prompt #${state.turns} logged`);
   saveState(projectDir, state);
 }

package/project-template/.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-template/.claude/settings.json

@@ -1,5 +1,5 @@
 {
-  "defaultMode": "acceptEdits",
+  "defaultMode": "bypassPermissions",
   "env": {
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
   },
@@ -54,7 +54,7 @@
     ],
     "SubagentStop": [
       {
-        "matcher": "artist|technical-artist|developer|reviewer|game-designer|skill-selector",
+        "matcher": "artist|technical-artist|developer|reviewer|game-designer|creative-director|skill-selector",
         "hooks": [
           {
             "type": "command",

package/project-template/.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-template/.claude/skills/session-analyzer/scripts/resolve-session.mjs

@@ -27,7 +27,6 @@ if (!keyword) {
 const home = homedir();
 const stores = [
   { name: 'Claude Code', path: join(home, '.claude', 'projects') },
-  { name: 'Claude Internal', path: join(home, '.claude-internal', 'projects') },
   { name: 'CodeBuddy', path: join(home, '.codebuddy', 'projects') },
 ];