@playcraft/cli 0.0.53 → 0.0.56

package/project-template/skills/playable-record/scripts/lib/dev-server.mjs

@@ -5,36 +5,61 @@
  * real listening URL. Previously these were copy-pasted into verify-contract,
  * verify-firstwin and record-playable, which let the port-detection logic drift.
  *
- * Vite runs with strictPort:false, so when the preferred port (3000) is taken it
+ * Vite runs with strictPort:false, so when the preferred port (5173) is taken it
  * auto-increments. `detectDevUrl` parses Vite's `Local:` stdout line to recover
  * the actual port instead of guessing — this is what keeps devUrl correct under
  * port drift (see docs/harness/experiment-lessons.md §9.2).
+ * Do not use 6000: Chromium treats it as an unsafe port (ERR_UNSAFE_PORT).
  */
 
 import { spawn } from 'node:child_process';
+import http from 'node:http';
+
+/** Preferred Vite dev port — avoids PlayCraft frontend (:3000) and backend (:3001). */
+export const DEFAULT_DEV_PORT = 5173;
+export const DEFAULT_DEV_URL = `http://127.0.0.1:${DEFAULT_DEV_PORT}/`;
 
 const LOCAL_URL_RE = /Local:\s+(http:\/\/(?:localhost|127\.0\.0\.1):\d+\/)/;
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+
+/** Probe a URL with node:http (undici `fetch` can fail on 127.0.0.1 in some runtimes). */
+function probeHttp(url) {
+  return new Promise((resolve, reject) => {
+    const req = http.get(url, (res) => {
+      res.resume();
+      resolve(res.statusCode ?? 0);
+    });
+    req.setTimeout(2000, () => {
+      req.destroy();
+      reject(new Error('probe timeout'));
+    });
+    req.on('error', reject);
+  });
+}
 
-/** Poll a URL with HEAD until it responds or the timeout elapses. */
+/** Poll a URL until any non-5xx response arrives. */
 export async function waitForHttp(url, timeoutMs = 30000) {
   const start = Date.now();
+  let lastErr = '';
   while (Date.now() - start < timeoutMs) {
     try {
-      const res = await fetch(url, { method: 'HEAD' });
-      if (res.ok) return;
-    } catch {
-      /* retry */
+      const status = await probeHttp(url);
+      if (status < 500) return;
+      lastErr = `HTTP ${status}`;
+    } catch (err) {
+      lastErr = err instanceof Error ? err.message : String(err);
     }
     await new Promise((r) => setTimeout(r, 250));
   }
-  throw new Error(`Server not ready: ${url}`);
+  throw new Error(`Server not ready: ${url}${lastErr ? ` (${lastErr})` : ''}`);
 }
 
 /** Spawn `npm run dev` (Vite) bound to 127.0.0.1 with piped stdio for URL detection. */
 export function startDevServer(cwd) {
-  return spawn('npm', ['run', 'dev', '--', '--host', '127.0.0.1'], {
+  return spawn('npm', ['run', 'dev', '--', '--host', '127.0.0.1', '--port', String(DEFAULT_DEV_PORT), '--no-open'], {
     cwd,
     stdio: ['ignore', 'pipe', 'pipe'],
+    env: { ...process.env, BROWSER: 'none' },
   });
 }
 
@@ -53,7 +78,7 @@ export function startHttpServer(port, cwd) {
  * @returns {string | null}
  */
 export function parseLocalUrl(text) {
-  const m = String(text).match(LOCAL_URL_RE);
+  const m = String(text).replace(ANSI_RE, '').match(LOCAL_URL_RE);
   return m ? m[1] : null;
 }
 
@@ -66,25 +91,35 @@ export function parseLocalUrl(text) {
  * @returns {Promise<string>}
  */
 export function detectDevUrl(child, preferredUrl, timeoutMs = 30000) {
-  return new Promise((res) => {
+  return new Promise((res, rej) => {
+    let buf = '';
     const timer = setTimeout(() => {
       cleanup();
       res(preferredUrl);
     }, timeoutMs);
     const onData = (data) => {
-      const url = parseLocalUrl(data);
+      buf += String(data);
+      const url = parseLocalUrl(buf);
       if (url) {
         clearTimeout(timer);
         cleanup();
         res(url);
       }
     };
+    const onExit = (code) => {
+      clearTimeout(timer);
+      cleanup();
+      const tail = buf.trim().slice(-1500);
+      rej(new Error(`dev server exited ${code} before publishing a Local URL${tail ? `\n${tail}` : ''}`));
+    };
     const cleanup = () => {
       child.stdout?.off('data', onData);
       child.stderr?.off('data', onData);
+      child.off('exit', onExit);
     };
     child.stdout?.on('data', onData);
     child.stderr?.on('data', onData);
+    child.once('exit', onExit);
   });
 }
 

package/project-template/skills/playable-record/scripts/record-playable.mjs

@@ -11,6 +11,7 @@ import { chromium } from 'playwright';
 import { evaluateContract, snapshotContractInPage } from './verify-contract.mjs';
 import {
   detectDevUrl,
+  DEFAULT_DEV_URL,
   pickServerPort,
   startDevServer,
   startHttpServer,
@@ -314,7 +315,7 @@ async function main() {
     externalServer = true;
   } else if (opts.useDev) {
     server = startDevServer(projectRoot);
-    const preferredUrl = opts.url || 'http://127.0.0.1:3000/';
+    const preferredUrl = opts.url || DEFAULT_DEV_URL;
     console.log(`[record] Starting dev server, waiting for ${preferredUrl}`);
     const detectedUrl = await detectDevUrl(server, preferredUrl, 30000);
     opts.url = detectedUrl;

package/project-template/skills/playable-record/scripts/verify-contract.mjs

@@ -19,14 +19,14 @@
  * Exit 0 = contract satisfied, 2 = contract broken, 1 = unexpected error.
  *
  * Usage:
- *   node skills/playable-record/scripts/verify-contract.mjs --root=. --use-dev --url=http://localhost:3000/
+ *   node skills/playable-record/scripts/verify-contract.mjs --root=. --use-dev --url=http://localhost:5173/
  *   node skills/playable-record/scripts/verify-contract.mjs --root=.            # standalone http-server
- *   node skills/playable-record/scripts/verify-contract.mjs --url=http://localhost:3000/ --json
+ *   node skills/playable-record/scripts/verify-contract.mjs --url=http://localhost:5173/ --json
  */
 
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { detectDevUrl, startDevServer, startHttpServer, waitForHttp } from './lib/dev-server.mjs';
+import { detectDevUrl, startDevServer, startHttpServer, waitForHttp, DEFAULT_DEV_URL } from './lib/dev-server.mjs';
 import { writeValidatorArtifact } from '../../_shared/scripts/lib/validator-artifacts.mjs';
 
 const DEFAULT_SCENE = 'MainScene';
@@ -178,7 +178,7 @@ export async function runContractProbe(opts) {
     external = true;
   } else if (opts.useDev) {
     server = startDevServer(projectRoot);
-    url = await detectDevUrl(server, opts.url || 'http://127.0.0.1:3000/', 30000);
+    url = await detectDevUrl(server, opts.url || DEFAULT_DEV_URL, 30000);
   } else {
     server = startHttpServer(opts.port, projectRoot);
     url = `http://127.0.0.1:${opts.port}/game/index.html`;

package/project-template/skills/playable-record/scripts/verify-firstwin.mjs

@@ -6,7 +6,7 @@
  * polls getState() until isGameOver && currentPhase === 'ENDCARD', then exits 0.
  *
  * Usage:
- *   node skills/playable-record/scripts/verify-firstwin.mjs --root=. --use-dev --url=http://localhost:3000/
+ *   node skills/playable-record/scripts/verify-firstwin.mjs --root=. --use-dev --url=http://localhost:5173/
  *   npm run verify:firstwin
  *
  * Exit 0 = first level winnable (ENDCARD reached)
@@ -18,7 +18,7 @@ import { readdir, readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { evaluateContract, snapshotContractInPage } from './verify-contract.mjs';
-import { detectDevUrl, startDevServer, startHttpServer, waitForHttp } from './lib/dev-server.mjs';
+import { detectDevUrl, startDevServer, startHttpServer, waitForHttp, DEFAULT_DEV_URL } from './lib/dev-server.mjs';
 import { writeValidatorArtifact } from '../../_shared/scripts/lib/validator-artifacts.mjs';
 
 const DEFAULT_SCENE = 'MainScene';
@@ -198,7 +198,7 @@ export async function runFirstWinProbe(opts) {
     /* external server */
   } else if (opts.useDev) {
     server = startDevServer(projectRoot);
-    url = await detectDevUrl(server, opts.url || 'http://127.0.0.1:3000/', 30000);
+    url = await detectDevUrl(server, opts.url || DEFAULT_DEV_URL, 30000);
   } else {
     server = startHttpServer(opts.port, projectRoot);
     url = `http://127.0.0.1:${opts.port}/game/index.html`;

package/project-template/skills/playable-record/scripts/verify-fusion.mjs

@@ -19,8 +19,14 @@ import { readFile, readdir } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join, resolve, basename } from 'node:path';
 import { writeValidatorArtifact } from '../../_shared/scripts/lib/validator-artifacts.mjs';
+import {
+  detectFusionIntent,
+  readFusionIntentFromProject,
+} from '../../_shared/scripts/lib/fusion-intent.mjs';
 
 // `[*_\s]*` tolerates markdown emphasis in the §6 template form `- **Fusion type**:`.
+const FUSION_COMPOSITE_ATOMS = new Set(['arrow_pick_match_rules.aigameplay']);
+
 const FUSION_TYPE_RE =
   /Fusion\s+type[*_\s]*:\s*(Single|A-Visual|B1-Passive|B2-Active|C-Sequential|D-Parallel)/i;
 const REAL_FUSION_TYPES = new Set(['A-Visual', 'B1-Passive', 'B2-Active', 'C-Sequential', 'D-Parallel']);
@@ -56,6 +62,19 @@ export const GAMEPLAY_SIGNATURES = {
     'escape_core',
     'canMoveArrow',
   ],
+  'path_elimination_rules.aigameplay': [
+    'path_elimination',
+    'canPathExitBoard',
+    'removedPaths',
+    'findFirstRemovablePath',
+  ],
+  'arrow_pick_match_rules.aigameplay': [
+    'arrow_pick_match',
+    'slideOutToTray',
+    'trayCapacity',
+    'LevelValidator',
+    'pick_and_match',
+  ],
 };
 
 function parseArgs(argv) {
@@ -212,7 +231,23 @@ export async function verifyFusion(root, overrides = {}) {
     gameplayAtoms = readSelectedGameplayAtoms(tree);
   }
 
-  if (gameplayAtoms.length < 2) {
+  const singleCompositeFusion =
+    gameplayAtoms.length === 1 && FUSION_COMPOSITE_ATOMS.has(gameplayAtoms[0] ?? '');
+
+  if (gameplayAtoms.length < 2 && !singleCompositeFusion) {
+    const { intentTags, rawIntent } = readFusionIntentFromProject(root);
+    if (detectFusionIntent(intentTags, rawIntent)) {
+      const selected = gameplayAtoms[0] ?? '(none)';
+      return {
+        ok: false,
+        skipped: false,
+        problems: [
+          `fusion intent detected but only one gameplay atom selected (${selected}) — pick a fusion skill (e.g. arrow_pick_match_rules.aigameplay) or document Single + downgrade reason in DESIGN.md ## 6`,
+        ],
+        gameplayAtoms,
+        fusionIntent: true,
+      };
+    }
     return { ok: true, skipped: true, reason: 'single gameplay atom — fusion no-op PASS' };
   }
 
@@ -224,7 +259,7 @@ export async function verifyFusion(root, overrides = {}) {
 
   if (!type) {
     problems.push('DESIGN.md missing Fusion type: — classify fusion in ## 6. Gameplay Fusion');
-  } else if (type === 'Single' && !isPseudoFusion) {
+  } else if (type === 'Single' && !isPseudoFusion && !singleCompositeFusion) {
     problems.push(
       `DESIGN.md Fusion type is Single but atom-tree selected ${gameplayAtoms.length} gameplay atoms — use a real fusion type or document pseudo-fusion`,
     );

package/project-template/skills/playable-record/scripts/verify-slice.mjs

@@ -21,7 +21,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { detectDevUrl, startDevServer, startHttpServer, waitForHttp } from './lib/dev-server.mjs';
+import { detectDevUrl, startDevServer, startHttpServer, waitForHttp, DEFAULT_DEV_URL } from './lib/dev-server.mjs';
 import { getActiveSlice, readState } from '../../_shared/scripts/state-store.mjs';
 
 function parseArgs(argv) {
@@ -57,7 +57,7 @@ export async function runSliceProbe(opts) {
     /* external server */
   } else if (opts.useDev) {
     server = startDevServer(root);
-    url = await detectDevUrl(server, opts.url || 'http://127.0.0.1:3000/', 30000);
+    url = await detectDevUrl(server, opts.url || DEFAULT_DEV_URL, 30000);
   } else {
     server = startHttpServer(opts.port, root);
     url = `http://127.0.0.1:${opts.port}/game/index.html`;

package/project-template/templates/design-brief.template.md

@@ -56,6 +56,40 @@ Append-only evidence (newest first or chronological — pick one and stay consis
 
 ## Brainstorm Log
 
+### Creative Angle
+
+- **Idea hook**: {If only one core moment survives — from Phase 1 candidates}
+- **Emotional payoff**: {What the player should feel after the first win}
+- **Anti-generic**: {Why this is not "ordinary arrow + tray match-3"}
+
+### Pattern picked
+
+- Pattern: {id from `playcraft patterns match`} [{SOURCE}]
+- Why this over alternatives: {one line}
+
+### Reference insight
+
+- {3–5 bullets from patterns match or `playcraft tools research --focus gameplay`} [{WEB|SKILL}]
+- researchSkippedReason: {only if no research/patterns — explain why}
+
+### Motion moments (Ring 1)
+
+- First tap: {slide_out visual — what moves, how long}
+- First blocked: {blocked shake/tint — teach dependency}
+- First match-3: {match_clear in tray — payoff moment}
+- Rejected motion: {why not swap/gravity cascade / board match3 — e.g. "主手势是 path tap，三消仅在托盘"}
+
+### Mechanic variation
+
+- {One axis beyond stitching two skills: e.g. tray pressure curve / blocked dependency layers / board phase unlock}
+- rejectedShallowFusion: {why not all-free opening or ≤4 paths on 8×8}
+
+### Gameplay Lens (3 questions)
+
+1. Core action in one verb: {…}
+2. After 3–5 steps the player gets: {…}
+3. With sound off for 10s, gameplay guessable? {yes/no + why}
+
 ### Round 1
 
 - Asked: {question and why it mattered for core action / feedback}

package/project-template/templates/design-methodology.md

@@ -1,7 +1,6 @@
 # Design Methodology Foundations
 
-> **When to read**: Game Designer reads this before Step 4 (Five-Axis Evaluation) to ground decisions in theory.
-> Artist and Reviewer may also reference this for context on emotional intent.
+> **When to read**: `@creative-director` and `@game-designer` during Ring 1 creative/spec (via `npm run state:get` → `referenceReads`). Ground Narrative Level and Emotional Arc before writing north-star or DESIGN §0.
 
 ---
 

package/project-template/templates/design.template.md

@@ -13,6 +13,32 @@
 
 ---
 
+## 0. Creative North Star
+
+> Ring 1 reader entry. Write this **before** mechanics tables. Copy from `docs/north-star.md`: **One-liner** verbatim; **Micro-Story Spine** field-value match (trim per field).
+
+### Micro-Story Spine
+
+**Narrative level**: {L0 | L1 | L2}
+**Who**: {from north-star}
+**Situation**: {from north-star}
+**Stakes**: {from north-star}
+**Payoff image**: {from north-star}
+**Emotional arc**: {from north-star}
+
+**One-liner**: {One vivid sentence — what feeling/tension the player is playing with, not a mechanic checklist.}
+
+**System Dynamic**: {One sentence — what system tension keeps the player acting.}
+
+**Why this fusion**: {2–3 sentences — how arrow / elimination / tray **serve** the idea above, not "because the user asked for fusion". Start with: "This fusion serves §0 because…"}
+
+**Rejected vibe**:
+
+- {Not this — e.g. not a casual match-3 binge}
+- {Not this — e.g. not a pure arrow logic puzzle with no payoff}
+
+---
+
 ## Player Action
 
 {What the player can do first: tap / drag / aim / choose. Name the visible target and why the action is obvious.}
@@ -48,3 +74,42 @@
 ## Open Assumptions
 
 {Only list assumptions that materially affect Ring 1. Use "none" if clear.}
+
+---
+
+## 6. Gameplay Fusion
+
+Fusion type: {Single | A-Visual | B1-Passive | B2-Active | C-Sequential | D-Parallel}
+
+This fusion serves §0 because {link back to One-liner / System Dynamic keywords}.
+
+{One paragraph: which parent mechanics combine, interaction contract (not just skill names), and why this fusion is playable first.}
+
+## 7. Gameplay Seed
+
+First Level Scenario: {8×8 board, path count, blocked vs opening moves, tray pressure — must match docs/level-sketch.json}
+
+Player Fantasy: {2–3 sentences from the player's POV. **Expand from Micro-Story Who + Situation** — not a generic "solve puzzle + match-3" line.}
+
+Decision Moment: {One aha or mis-tap moment — e.g. blocked path feedback → find unlock order.}
+
+## 8. Feedback & Animation Spine
+
+### 8.1 Event Catalog（必填）
+
+| Event       | Trigger                     | Visual (Ring 1)                         | Audio placeholder | Duration budget | Blocks input? |
+| ----------- | --------------------------- | --------------------------------------- | ----------------- | --------------- | ------------- |
+| slide_out   | valid tap on free path      | path container tween along direction    | sfx_slide         | 300–400ms       | yes           |
+| blocked     | invalid tap on blocked path | board shake + path red tint             | sfx_blocked       | ~300ms          | no            |
+| fly_to_tray | after slide_out             | head bezier to tray slot                | sfx_land          | 350–450ms       | yes           |
+| match_clear | 3 same color in tray        | tray burst + scale pop                  | sfx_match         | 200–300ms       | yes           |
+| win         | board empty + tray clear    | overlay + optional confetti placeholder | sfx_win           | ≤800ms          | yes           |
+
+### 8.2 Atom / Skill refs
+
+- Primary: `slide_out_to_tray_animation.aicomponent` (defaults: slide 350ms, fly 400ms)
+- Secondary: `path_animation.aicomponent` (blocked shake)
+
+### 8.3 Juice escalation (Ring 1 minimal)
+
+- Combo/streak: optional; if n/a, state "flat feedback, escalate in Ring 2"

package/project-template/templates/developer-log.template.md

@@ -18,6 +18,17 @@
 
 ---
 
+## Dispatch Context
+
+> **Source of disclosure**: `dispatchPacket.requiredContext.mustRead` is the only authority for this run's required reading set.
+
+- **mustRead loaded**: {{yes/no — list every path from dispatchPacket.requiredContext.mustRead}}
+- **atomTreeFocus readFields**: {{meta.engineDecision / meta.selectedAtoms / meta.skillsMatch.mediaGroups / meta.rings}}
+- **selectedAtomsPolicy**: {{read-all-selected-skills-before-game-edit / n-a}}
+- **slice skillRefs focus**: {{current slice skillRefs or fromScratchReason}}
+
+---
+
 ## Spec Quick-Check
 
 > **Before coding**, confirm the spec is actually implementable in the current project.
@@ -31,7 +42,7 @@
 
 ## Skill Preflight
 
-> **Before coding**, read the Skills referenced in your atoms and record what they contribute.
+> **Before coding**, read every selected atom Skill disclosed by `dispatchPacket.requiredContext.mustRead`. Add one row per `docs/atom-tree.json → meta.selectedAtoms[]` item; `skillRefs` only narrows current implementation focus.
 
 | selectedAtomRef        | Read path / source                     | 提供了什么               | 怎么用                                    | 注意         |
 | ---------------------- | -------------------------------------- | ------------------------ | ----------------------------------------- | ------------ |

package/project-template/templates/five-axis-framework.md

@@ -65,6 +65,18 @@ For every non-`Single` option, answer:
 
 If these answers are weak, the fusion is probably decorative complexity.
 
+### Mechanic Depth beyond Stitching
+
+| Pattern                                       | When to use                                | Depth signal                                               |
+| --------------------------------------------- | ------------------------------------------ | ---------------------------------------------------------- |
+| **Composite atom** (`arrow_pick_match_rules`) | Path + tray match already fused in one PGS | Single interaction contract; prefer over stitching parents |
+| **Pseudo-fusion B1**                          | Visual dual system, single reducer         | Secondary mechanic auto-triggers — document reducer        |
+| **Board phase B1**                            | Same 8×8 grid, mask unlock                 | Board "changes" via phase, not resize                      |
+
+**Forbidden in DESIGN:** listing two parent skill names without **interaction contract** (who acts, where match happens, what blocked teaches).
+
+See also: `.claude/agents/refs/game-designer-fusion-depth-playbook.md`
+
 ### Decision Rules
 
 ```

package/project-template/templates/game-designer-creative-process.template.md

@@ -0,0 +1,99 @@
+# Creative Process — {Game Name}
+
+<!--
+  Ring 1 clarify audit trail. Fill phases 1–4 BEFORE finalizing DESIGN.md.
+  Source: templates/game-designer-creative-process.template.md
+-->
+
+**Created**: {YYYY-MM-DD}
+**Creative arm**: {A1 | A2 | A3 — from GD_CREATIVE_ARM env if harness}
+
+---
+
+## Phase 1 — Radical Diverge
+
+List ≥3 **gameplay core-moment** candidates. Do not write DESIGN.md yet.
+
+### Candidate A
+
+- **Core moment**: {one sentence}
+- **Story hook**: {15s filmable Hook frame}
+- **Who / Stakes**: {one line each}
+- **Why interesting**: {…}
+- **Core challenge**: {…}
+- **Worst case**: {what breaks if player ignores rules}
+
+### Candidate B
+
+- **Core moment**: {…}
+- **Story hook**: {…}
+- **Who / Stakes**: {…}
+- **Why interesting**: {…}
+- **Core challenge**: {…}
+- **Worst case**: {…}
+
+### Candidate C
+
+- **Core moment**: {…}
+- **Story hook**: {…}
+- **Who / Stakes**: {…}
+- **Why interesting**: {…}
+- **Core challenge**: {…}
+- **Worst case**: {…}
+
+---
+
+## Phase 2 — Adversarial Review (five questions)
+
+For each candidate, answer **evidence-based** questions — not aesthetic veto.
+
+| Candidate | Q1 Second tap? | Q2 Ignore mechanism? | Q3 White-box fun? | Q4 Depth ceiling? | Q5 Strip story — still care? |
+| --------- | -------------- | -------------------- | ----------------- | ----------------- | ---------------------------- |
+| A         | {…}            | {…}                  | {…}               | {…}               | {…}                          |
+| B         | {…}            | {…}                  | {…}               | {…}               | {…}                          |
+| C         | {…}            | {…}                  | {…}               | {…}               | {…}                          |
+
+**Vulnerability list** (falsifiable, not "not fun"):
+
+- {bullet}
+- {bullet}
+
+---
+
+## Phase 3 — Commitment
+
+**Chosen candidate**: {A | B | C}
+
+**Narrative level**: {L0 | L1 | L2} — {CD decides; if L0, quote user's explicit opt-out request here}
+
+**Patch promises** (how this design addresses vulnerabilities):
+
+- {…}
+
+**Rejected alternatives**:
+
+- {B}: deferred because {…}
+- {C}: deferred because {…}
+
+**Pressure test memo** (≤30 lines):
+
+- White-box: {…}
+- 1-minute test: {…}
+- Depth test: {…}
+
+---
+
+## Phase 4 — Design Intent
+
+**Design Intent**: {e.g. "Player aha at move 3 when blocked path unlocks tray combo"}
+
+> **Mandatory sync**: Copy **Design Intent verbatim** into `docs/DESIGN.md` §0 **One-liner**. Copy **System Dynamic** into §0 second field. Copy **Micro-Story Spine** fields field-for-field from `docs/north-star.md`.
+
+**Mechanic variation** (vs pure stitch): {one axis — tray pressure / phase unlock / segment density}
+
+**Rejected shallow fusion**: {e.g. all-free 4 paths on 8×8}
+
+**Pattern / skills locked after commitment**:
+
+- Pattern: {from playcraft patterns match}
+- Primary skill: {e.g. arrow_pick_match_rules.aigameplay}

package/project-template/templates/level-sketch.template.json

@@ -0,0 +1,56 @@
+{
+  "name": 1,
+  "row": 8,
+  "col": 8,
+  "levelTime": 0,
+  "trayCapacity": 7,
+  "matchCount": 3,
+  "colors": ["red", "red", "red", "blue", "blue", "blue"],
+  "arrows": [
+    [
+      [0, 0],
+      [1, 0],
+      [2, 0],
+      [3, 0],
+      [4, 0],
+      [5, 0]
+    ],
+    [
+      [7, 1],
+      [6, 1],
+      [5, 1],
+      [4, 1],
+      [3, 1],
+      [2, 1]
+    ],
+    [
+      [2, 2],
+      [2, 3],
+      [2, 4],
+      [2, 5],
+      [2, 6]
+    ],
+    [
+      [0, 7],
+      [1, 7],
+      [2, 7],
+      [3, 7],
+      [4, 7]
+    ],
+    [
+      [7, 6],
+      [6, 6],
+      [5, 6],
+      [4, 6],
+      [3, 6]
+    ],
+    [
+      [6, 3],
+      [6, 4],
+      [6, 5],
+      [5, 5],
+      [4, 5],
+      [3, 5]
+    ]
+  ]
+}

package/project-template/templates/north-star.template.md

@@ -0,0 +1,43 @@
+# Creative North Star — {Game Name}
+
+<!--
+  Ring 1 creative discovery output (written by @creative-director).
+  @game-designer-spec copies §0 fields from this file into docs/DESIGN.md §0.
+  One-liner: verbatim. Micro-Story Spine: field-value match (trimmed per field).
+  Source: templates/north-star.template.md
+-->
+
+**Date**: {YYYY-MM-DD}
+
+---
+
+## Micro-Story Spine
+
+**Narrative level**: L1 | L2 <!-- default L1; L0 only when user explicitly opts out of story; L3 forbidden -->
+**Who**: {player identity; L0 may use n/a — pure mechanic showcase}
+**Situation**: {opening Hook frame — one glance readable scene/situation}
+**Stakes**: {what core pressure means in the player's world — not abstract game over}
+**Payoff image**: {first core payoff moment — must film a PGS beat: path slide out, fly to tray, or tray match burst}
+**Emotional arc**: {Urgency | Challenge | Competence | Curiosity | Relaxation}
+
+## One-liner
+
+{L1/L2: one vivid pitch — must name Who or Situation; no pure debt/bet abstract stacking.}
+{L0: Hook spectacle + mechanic payoff; Who optional.}
+
+## System Dynamic
+
+{One sentence — what system tension keeps the player acting.}
+
+## Why this fusion
+
+{2–3 sentences — how parent mechanics **serve** the idea above. Start with intent, not grid sizes.}
+
+## Rejected vibe
+
+- {Not this — e.g. not a casual match-3 binge}
+- {Not this — e.g. not a pure arrow logic puzzle with no payoff}
+
+## Design Intent
+
+{Phase 4 single line — must match One-liner verbatim when copied to DESIGN §0.}

package/project-template/templates/project-state.template.md

@@ -55,7 +55,7 @@
 
 Each iteration runs inner loops: `clarify` → `build` → `verify` → **Ring Gate** (user acceptance) → next iteration.
 
-<!-- Iteration definitions: see CLAUDE.md § Growth-Ring Model -->
+<!-- Iteration definitions: see docs/team/collaboration.md (growth-rings-v1) -->
 
 ## Ring DoD (current iteration)