@playcraft/cli 0.0.53 → 0.0.56

package/project-template/.claude/agents/refs/README.md

@@ -21,6 +21,12 @@
 
 | 文件                                 | 引用来源                                                       | 内容摘要                                                                                 |
 | ------------------------------------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `creative-discovery-guide.md`        | `agents/creative-director.md`                                  | Ring 1 creative: Micro-Story Spine + MDA reverse + five-phase process                    |
+| `creative-north-star-examples.md`    | `state:get` → `referenceReads`                                 | Bronze/Silver/Gold North Star examples + genre table                                     |
+| `creative-director-kickoff-guide.md` | orchestrator only (not CD)                                     | Orchestrator spawn template for @creative-director                                       |
+| `creative-director-guide.md`         | `agents/creative-director.md`                                  | Short index → creative-discovery-guide                                                   |
+| `templates/five-axis-framework.md`   | `state:get` → `referenceReads` (CD + GD)                       | Narrative Level (Axis 4) + Emotional Arc (Axis 5) — **disclosure single channel**        |
+| `templates/design-methodology.md`    | `state:get` → `referenceReads` (CD + GD)                       | MDA + JTBD foundations — **disclosure single channel**                                   |
 | `game-designer-workflow-detail.md`   | `agents/game-designer.md` workflow interface                   | Game Designer 在 ring 1 `loop: clarify` 主设计任务下的执行流程                           |
 | `skill-selector-guide.md`            | `docs/team/atom-tree-format.md`                                | temporary ref-flow atom-selection subagent 产出 `atom-tree` 双文件时使用的速查式选择指南 |
 | `docs/team/atom-tree-format.md`      | `atom-tree.template.md`, future atom workflow docs             | atom-tree JSON 主 + markdown skill/reference companion                                   |
@@ -51,6 +57,8 @@
 
 | iteration / loop / 触发              | Sub-agent                   | 应该读的 refs（按顺序）                                                                                    |
 | ------------------------------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| ring 1 `loop: clarify`（creative）   | `@creative-director`        | `creative-discovery-guide.md` + `referenceReads` (five-axis, methodology, examples)                        |
+| ring 1 `loop: clarify`（spec）       | Game Designer (spec mode)   | `game-designer-workflow-detail.md` + `referenceReads`                                                      |
 | ring 1 `loop: clarify`               | Game Designer               | `game-designer-workflow-detail.md`                                                                         |
 | ring 1 `loop: clarify`（atom-tree）  | temporary ref-flow subagent | `skill-selector-guide.md` + `docs/team/atom-tree-format.md`                                                |
 | ring 2+ `loop: clarify`（atom-tree） | ref-flow subagent           | `skill-selector-guide.md` + `docs/team/atom-tree-format.md`                                                |

package/project-template/.claude/agents/refs/creative-director-guide.md

@@ -0,0 +1,35 @@
+# Creative Director Guide
+
+> **Superseded for execution:** use [creative-discovery-guide.md](./creative-discovery-guide.md) — this file remains a short index.
+
+## Quick links
+
+| Need                              | Read                                                                       |
+| --------------------------------- | -------------------------------------------------------------------------- |
+| Step-by-step Ring 1 creative      | [creative-discovery-guide.md](./creative-discovery-guide.md)               |
+| Good/bad North Star examples      | [creative-north-star-examples.md](./creative-north-star-examples.md)       |
+| Narrative Level + Emotional Arc   | `templates/five-axis-framework.md` (via `state:get` → `referenceReads`)    |
+| MDA + JTBD                        | `templates/design-methodology.md` (via `referenceReads`)                   |
+| Orchestrator kickoff (not for CD) | [creative-director-kickoff-guide.md](./creative-director-kickoff-guide.md) |
+
+## Objective
+
+Discover a **playable idea with soul** — Micro-Story Spine + System Dynamic the player can feel, not a mechanism chain disguised as a one-liner.
+
+## Forbidden reads (context pollution)
+
+Do **not** open:
+
+- `templates/design.template.md`
+- `skills/_shared/scripts/verify-design-consistency.mjs`
+- `.claude/agents/refs/skill-selector-guide.md`
+- `docs/team/atom-tree-format.md`
+- `docs/DESIGN.md`
+
+Do **not** run `playcraft skills *`, `npm run verify:design`, or `npm run levels:validate`.
+
+## STOP contract
+
+- Write `handoffContext.northStarSummary` (≤80 words) via `npm run state:set`.
+- Set `next_orchestrator_action` to invoke `@game-designer` for ring 1 design spec.
+- Do **not** seed `sliceState`, write `DESIGN.md`, or run verifiers.

package/project-template/.claude/agents/refs/creative-director-kickoff-guide.md

@@ -0,0 +1,52 @@
+# Creative Director Kickoff Guide — Orchestrator Only
+
+> **Audience**: Orchestrator when spawning `@creative-director` for Ring 1 `loop: clarify` (`1:creative`).
+> **Prerequisite**: `@game-designer` mechanism lock STOP — `handoffContext.primaryGameplaySkill` + `docs/atom-tree.json` `meta.skillsMatch`.
+> **Not for CD**: the subagent reads `creative-discovery-guide.md` instead.
+
+## Before spawn
+
+1. Run `npm run state:get` — confirm `nextRole: creative-director`.
+2. Read this guide.
+3. **Do not** forward the user's mechanism spec verbatim as the only prompt.
+
+## Task prompt template
+
+Copy into the `@creative-director` Task message:
+
+```markdown
+You are @creative-director for this PlayCraft playable-ad project.
+
+## Mechanism seed（已锁定 PGS，不是自由发明）
+
+Primary skill: `{handoffContext.primaryGameplaySkill from state:get}`
+
+{paste user's high-level intent — e.g. arrow + tray match-3 fusion, 8×8}
+
+## Creative question（CD 必须回答）
+
+在 **已 read 的 primary gameplay PGS** 上：Hook 帧是什么？压力在玩家世界里意味着什么？Payoff 必须拍到 **path slide out / fly to tray / tray match** 中的至少一个核心瞬间 — 不得用 rotate 或纯棋盘 cascade 替换。
+
+## JTBD guess / Emotional arc hint（仅 hint，CD 可改）
+
+{Stress Relief → Relaxation | Challenge → Urgency | …}
+注：Orchestrator **不预设 Narrative Level**；L0/L1/L2 由 CD 在 Phase 3 裁决。
+若用户明确要求「纯机制 / 不要故事」，在此原文标注，供 CD 走 L0。
+
+## Deliverables
+
+docs/north-star.md（含 Micro-Story Spine）+ docs/creative-process.md
+
+## Read on start
+
+.claude/agents/refs/creative-discovery-guide.md
+npm run state:get -- --json referenceReads contextPacket
+playcraft skills read {primaryGameplaySkill}
+```
+
+## Rules
+
+- Translate user intent into a **Creative question** grounded in the **read PGS** — never spawn CD with only "build arrow match-3 on 8×8".
+- Optional: write `handoffContext.creativeBrief` via `state:set` (hint for GD spec phase).
+- Use `bypassPermissions` for nested subagent Bash if harness/live test (known P0).
+- After CD STOP: invoke `@game-designer` for ring 1 design spec only — do not inline creative work.

package/project-template/.claude/agents/refs/creative-discovery-guide.md

@@ -0,0 +1,76 @@
+# Creative Discovery Guide
+
+> Purpose: step-by-step execution for `@creative-director` — produce **`docs/north-star.md`** (with Micro-Story Spine) + **`docs/creative-process.md`** before any spec work.
+>
+> Scope: creative discovery only. Does not define skills match, level-sketch, atom-tree, or DESIGN.md mechanics tables.
+
+## Step 0 — Read state + methodology
+
+```bash
+npm run state:get -- --json dispatchPacket contextPacket referenceReads
+```
+
+1. Read orchestrator kickoff notes (Creative question, mechanism seed, JTBD/arc hints — hints only).
+2. Read every path in **`referenceReads`** (typically `templates/five-axis-framework.md` §4–§5, `templates/design-methodology.md` §A–B, `.claude/agents/refs/creative-north-star-examples.md`).
+3. Skim user prompt / `contextPacket` for explicit L0 opt-out ("纯机制", "no story", "pure mechanic showcase").
+
+## Step 1 — MDA reverse + Narrative Level
+
+From user intent, pick:
+
+- **2–3 target Aesthetics** (Fantasy, Challenge, Urgency, …) — see design-methodology §A.
+- **Narrative Level** (you decide):
+  - **Default L1 or L2** — light story that fits the mechanic.
+  - **L0 only** if user explicitly opted out of story — quote their words in Phase 3.
+  - **Never L3** — downgrade to L2 if tempted.
+
+Lock Emotional Arc (Axis 5): Urgency | Challenge | Competence | Curiosity | Relaxation.
+
+## Step 2 — Phase 1 diverge (≥3 candidates)
+
+Use `templates/game-designer-creative-process.template.md`. Each candidate **must** include:
+
+- Core moment
+- **Story hook** (15s filmable frame)
+- **Who / Stakes** (one line each)
+
+Do not write DESIGN.md yet.
+
+## Step 3 — Phase 2 adversarial (five questions)
+
+Fill the five-question table. Q5 is the anti-filler gate: _If you remove Who and Situation, does anyone care?_
+
+Produce ≥2 falsifiable vulnerability bullets.
+
+## Step 4 — Phase 3 commitment
+
+- Pick one candidate.
+- Record **Narrative level** + reason (L0: paste user's opt-out quote).
+- Write patch promises addressing vulnerabilities.
+
+## Step 5 — Write north-star + creative-process
+
+**`docs/north-star.md`** from `templates/north-star.template.md`:
+
+| Field        | L1/L2                        | L0                             |
+| ------------ | ---------------------------- | ------------------------------ |
+| Who          | Required — concrete identity | `n/a — pure mechanic showcase` |
+| Situation    | Required — Hook frame        | Required — mechanism spectacle |
+| Stakes       | Required — narrative meaning | Required — missed experience   |
+| Payoff image | Required                     | Required                       |
+| One-liner    | Must name Who or Situation   | Hook + mechanic payoff OK      |
+
+**`docs/creative-process.md`:** Phases 1–3 complete + Phase 4 Design Intent line (= One-liner verbatim).
+
+## Step 6 — Self-check before STOP
+
+1. Can you describe the Hook frame in one breath?
+2. Does removing Who/Situation kill the pitch? (L1/L2 must survive Q5.)
+3. Is the story **fitted to the mechanic**, not a generic mascot pasted on?
+4. Design Intent === One-liner character-for-character?
+5. Compare against Bronze/Silver/Gold in `creative-north-star-examples.md` — are you at least Silver?
+
+## STOP handoff
+
+- `handoffContext.northStarSummary` ≤80 words (include Who + Hook).
+- `next_orchestrator_action`: Invoke @game-designer — ring 1 design spec.

package/project-template/.claude/agents/refs/creative-north-star-examples.md

@@ -0,0 +1,82 @@
+# Creative North Star — Examples (Micro-Story Spine)
+
+> **Used by**: `@creative-director` via `referenceReads` on `state:get`.
+> **Narrative Level** terms align with `templates/five-axis-framework.md` Axis 4 (L0–L2 only; L3 forbidden).
+
+---
+
+## Tier guide
+
+| Tier       | Meaning                                        |
+| ---------- | ---------------------------------------------- |
+| **Bronze** | Passes tension-word lint but no filmable story |
+| **Silver** | Strong metaphor but missing Who/Situation      |
+| **Gold**   | Complete Micro-Story Spine — target for L1/L2  |
+
+---
+
+## Bronze — Arrow Debt Tray (live smoke v1)
+
+**Narrative level**: L1 (claimed) — **incomplete**
+
+| Field     | Content                                                                                                                     |
+| --------- | --------------------------------------------------------------------------------------------------------------------------- |
+| Who       | _(missing)_                                                                                                                 |
+| Situation | _(missing)_                                                                                                                 |
+| Stakes    | Abstract "debt / burst"                                                                                                     |
+| Payoff    | Abstract "cash in match-3"                                                                                                  |
+| One-liner | "Play the nerve of opening one-way escape routes while the tray's growing debt dares you to cash in just before it bursts." |
+
+**Why Bronze:** tension vocabulary without a story object. Player cannot answer "who am I" or "what am I escaping."
+
+---
+
+## Silver — Arrow Elim Fusion (fixture)
+
+**Narrative level**: L1 — **incomplete**
+
+| Field     | Content                                                                    |
+| --------- | -------------------------------------------------------------------------- |
+| Who       | _(missing)_                                                                |
+| Situation | _(missing)_                                                                |
+| Stakes    | "颜色是债务" metaphor                                                      |
+| Payoff    | "走钢丝上排雷"                                                             |
+| One-liner | "颜色是债务——每推一条箭头进托盘，都在为未来的自己挖坑，像在走钢丝上排雷。" |
+
+**Why Silver:** memorable metaphor, still no filmable Hook frame or identity.
+
+---
+
+## Gold — Night-Shift Cargo Gate (arrow + tray fusion, L2)
+
+**Narrative level**: L2
+
+| Field         | Content                                                                                                                         |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Who           | Night-shift warehouse loader                                                                                                    |
+| Situation     | One-way chutes jammed with color-coded crates; bay lights flash amber — gate closes in minutes                                  |
+| Stakes        | Bay locks when staging slots fill — next truck and the loader are stuck inside                                                  |
+| Payoff image  | Third matching crate slides in, bay door hisses open, chute clears with a satisfying rush                                       |
+| Emotional arc | Urgency                                                                                                                         |
+| One-liner     | "Help the night loader beat the closing gate — every crate you push buys seconds until three matching colors pop the bay open." |
+
+---
+
+## Genre table (L1/L2 patterns)
+
+| Genre                          | Narrative level | Who                | Situation                        | Stakes                     | Payoff                    |
+| ------------------------------ | --------------- | ------------------ | -------------------------------- | -------------------------- | ------------------------- |
+| Arrow + tray fusion            | L2              | Night-shift loader | Chutes jammed, bay nearly full   | Gate locks, loader trapped | Triple match, door opens  |
+| Screw puzzle                   | L2              | Repair hand        | Board pins reward corner peeking | Mechanism never clears     | Last panel drops          |
+| Pure match-3 (L0 opt-out only) | L0              | n/a                | Board one move from huge clear   | Miss the "almost" cascade  | Full-board chain reaction |
+| Chase / runner                 | L2              | Fugitive           | Pursuer visible behind           | Caught at the gap          | Narrow squeeze through    |
+
+---
+
+## Anti-patterns (do not ship)
+
+- **Generic mascot:** "Help the cute hamster" with no tie to mechanic pressure.
+- **Abstract tension only:** debt / bet / burst / nerve without Who or Situation.
+- **Mechanism chain one-liner:** "Tap arrow → tray → match three → win."
+- **PGS core-loop replacement:** rotate 90° / clockwise aim / board-only cascade instead of path slide → tray match from the locked skill.
+- **L0 without opt-out quote:** choosing pure mechanic when user never asked for it.

package/project-template/.claude/agents/refs/developer-dev-handoff.md

@@ -12,7 +12,7 @@ npm run dev:start   # starts persistent dev server + records the real devUrl
 ```
 
 - **Not** `playcraft start`, and **not** a bare `npm run dev`. `dev:start` wraps the project's `scripts.dev` and additionally:
-  - detects the actual listening port from Vite output (handles port drift when 3000 is taken),
+  - detects the actual listening port from Vite output (handles port drift when 5173 is taken),
   - appends `?debug=1`,
   - writes `devUrl` through the same programmatic state layer `state:set` uses.
 - **Do not** read a port from the terminal or hand-edit `devUrl` — `dev:start` is the source of truth for it.

package/project-template/.claude/agents/refs/game-designer-fusion-depth-playbook.md

@@ -0,0 +1,28 @@
+# Game Designer — Fusion Depth Playbook
+
+Lightweight narrative templates for Ring 1 fusion designs. Pick one spine and **add one variation axis** (tray pressure / phase unlock / segment density).
+
+## Template 1 — Path → Tray → Match
+
+- **Board**: fixed 8×8; paths are polylines with blocked dependencies (DAG).
+- **Gesture**: tap path head → slide_out along direction → fly_to_tray.
+- **Payoff**: match_clear in tray when 3 same color; tray peak forces color order.
+- **Variation axis**: {tray pressure curve | opening removable count | segment density}
+
+## Template 2 — Phase Unlock (same grid)
+
+- **Board**: 8×8 with masked regions (`boardPhases` in level-sketch optional).
+- **Unlock**: each match_clear or N paths removed reveals new paths in unlocked zone.
+- **Variation axis**: unlock cadence vs tray pressure — not board resize.
+
+## Template 3 — Tray Pressure Puzzle
+
+- **Board**: pure dependency puzzle; match-3 **only in tray**.
+- **Failure**: tray full without match; success requires reading color order before tap.
+- **Variation axis**: dependency depth (≥2 waves) + max opening removable (1–2).
+
+## Anti-patterns (do not ship)
+
+- 8×8 with ≤4 paths or all-free opening
+- Board swap match-3 + path tap without interaction contract
+- DESIGN lists two parent skills with no **interaction contract**

package/project-template/.claude/agents/refs/game-designer-gameplay-sufficiency.md

@@ -1,6 +1,6 @@
 # Gameplay Sufficiency Self-Check
 
-> **When to read**: Game Designer reads this at Step 2, after brainstorm is complete and the living brief is structurally complete. This is a **blocking gate** — do not proceed to Five-Axis Evaluation (Step 3) until all angles pass.
+> **When to read**: `@game-designer` during Ring 1 clarify/spec when the living brief is structurally complete. This is a **blocking gate** — do not proceed to skills match / DESIGN seed until all angles pass.
 >
 > **Pattern**: Modeled on Flow B's "玩法核心充分性 Review" — 8 angles covering MDA, Game Feel, visual readability, and Playable Ad flow completeness.
 
@@ -8,9 +8,9 @@
 
 ## Purpose
 
-Verify that the design-brief contains enough gameplay depth to support module selection, five-axis evaluation, and downstream production. This check prevents the common failure mode of "proceeding with a technically complete but experientially shallow brief."
+Verify that the design-brief contains enough gameplay depth to support module selection, five-axis choices (see `referenceReads`), and downstream production. This check prevents the common failure mode of "proceeding with a technically complete but experientially shallow brief."
 
-**Why before Five-Axis**: Five-Axis evaluation and Style Direction must serve the core gameplay. If the gameplay itself is underspecified, five-axis choices become disconnected from player experience.
+**Why before spec construction**: Narrative Level and Style Direction must serve the core gameplay. If the gameplay itself is underspecified, five-axis choices become disconnected from player experience.
 
 ---
 
@@ -56,7 +56,7 @@ Write self-check results in internal notes or briefly in design-brief appendix:
 
 ## Decision
 
-- **All 8 ✅** → Proceed to Step 3 (Five-Axis Evaluation)
+- **All 8 ✅** → Proceed to skills match + DESIGN seed (Ring 1 spec construction)
 - **Any ❌** → Return to Step 1 with specific angle as the brainstorm target. Ask user only about the gap (not re-do entire brainstorm).
 
 ---

package/project-template/.claude/agents/reviewer.md

@@ -109,6 +109,17 @@ You must not:
 - set user acceptance state
 - ask the user directly from a subagent
 
+## Ring 1 Design Adversarial (harness A2 / A3 only)
+
+When `dispatchPacket.doWhat` or env `GD_CREATIVE_ARM` is `A2` or `A3`, and the packet asks for **design adversarial review**:
+
+- **Read only**: `docs/creative-process.md` (phase 1 draft), `docs/design-brief.md`, optional partial `docs/DESIGN.md`
+- **Do not** edit `game/**` or rewrite DESIGN — output a **vulnerability list** only
+- Run the **four adversarial questions** on each candidate (second tap / ignore mechanism / white-box / depth ceiling)
+- Format output as markdown section `## Design Adversarial Findings` in `logs/review-report.md` or append to `docs/creative-process.md` phase 2
+- No aesthetic veto ("not fun enough") — only falsifiable logic gaps
+- End with `PLAYCRAFT_STOP` — hand back to Game Designer for phase 3–4
+
 ## Legacy Fallback
 
 Only when `dispatchPacket` is null and `sliceState` is empty, follow [`refs/reviewer-legacy-fallback.md`](refs/reviewer-legacy-fallback.md).

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);
 }