feat(setup): Game guided flow to a Godot project (E6) (#5665)

* docs(setup): design the Game guided flow to a Godot project (E6)

A sixth entry card on the New Project surface that walks from a sentence to
an exported Godot 4.3 project on the existing SetupFlow shell. The build is a
slot-filling workflow graph built without a model call, ending in an export
node that wraps the existing Godot join, so the graph re-runs and the agent
takes over for the playtest loop.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(setup): game style tiles, template cards and harness docs (G3)

Nine deterministic PNGs drawn by scripts/make-game-style-tiles.mjs from each
preset's palette and each template's own placeholder art, with a --check that
fails on a changed byte or a missing tile. The harness docs, the AGENTS.md
table row and the godot-game skill point at the flow's graph.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(protocol): game flow contracts — settings.game, designer, slot prompt, graph builder (G1a)

The designer writes cast, level and one prompt per slot against a schema that
pins the manifest's slot ids; the slot prompt sizes each generation to the
slot's exact pixels; gameGraphPlacement is a pure function of manifest, design
and choices, so no model decides which chain a slot gets. Six game style
presets join the storyboard ones.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* test(audio-nodes): read the pacer test's clock before constructing the pacer

RealtimePacer's origin is its construction time. The test captured its own
start afterwards, so on a loaded CI runner the gap shortened the measured
wait (52 ms against a 70 ms floor) and failed a diff that never touched
audio-nodes. Reading the clock first makes the measured wait a lower bound.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(web): Game guided flow — steps, hooks, landing checklist, ui_game_* tools (G2)

The sixth entry card on the New Project surface. Idea, Template with the
designer, Design review, Look with game style presets and one model per slot
kind, then Build places the slot-filling graph through the node tools and
runs it once. The landing checklist folds the run's per-node results into
assets, export and verification rows and reports Verified only on a true
export output. Four ui_game_* tools give the flow headless parity.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(game-nodes): ExportGodotProject node, game seeds and capabilities, game-flow harness (G1b)

packages/game-nodes holds nodetool.game.ExportGodotProject and the export
join extracted from the export_godot_project capability, which now calls it.
The node takes one dynamic input per slot, exports the template with its
placeholders for slots left unfilled, writes the zip beside the directory,
and reports verified only when Godot ran. The checker fills carry the asset
id the node needs; nodetool.image.ResizeImage joins the registry it was
missing from. games.templates and games.stylePresets serve the flow, the
four game setup capabilities mirror the ui_game_* tools, and the game-flow
harness entry runs every suite the flow depends on.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(web): mount the game landing checklist in the canvas chat dock

The panel renders above the conversation only for a workflow whose
settings.game reads stage done with a recorded build, and the build record
is written onto settings.game so a reload still shows it. Build opens the
dock; the next steps open the folder, download the zip, stage the play-test
turn for the project agent, or run the graph again.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* feat(game-nodes): one export node for the flow and the capability

After merging main, the flow builds on main's game-nodes package. The
ExportGodotProject node gains the flow's behaviours: empty fills export the
template's placeholders, unfilled slots keep theirs, the zip lands beside the
directory, and verified stays false unless Godot ran clean. The graph builder
feeds every checker's output into the node's fills list, the flow's prompt
builder rides on slotPrompt, and the capability imports the shared join.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* fix(game): address review — templates array, named run outputs, resume on reopen, placeholder sentinels

F1: games.templates returns the array, so the hook reads it as one and the
router's slot type is the protocol's, which drops the client cast. F2: the
landing summary reads the focused job's completed generation outputs, which
keep handle names and are never edge-suppressed; the old source lost the
export node's named handles and every checker's asset row. F3: the workflow
editor surface renders the game setup host while settings.game.stage is not
done, so a reload during Design or Look resumes the flow. F4: one protocol
helper normalizes the keep-placeholder sentinel for both the browser flow and
the build_game capability.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* fix(game): restore the finished export after a reload, count checkers only

The landing panel read the export outcome from the focused job's live
generations, so a reload lost it. Persist the outcome once on
settings.game.build.export keyed by job id and read it back only when
no job is focused. The checked count now counts a slot only when its
checker node produced outputs without an error, with the checker node
types exported from the graph builder so both sides agree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TDqhsPX3jAxwKFUvvK9qkf

* fix(game): recover exports from completed jobs

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: georgi

.claude/skills/godot-game/SKILL.md

@@ -20,6 +20,13 @@ sheet generated with a different model than the tileset reads as two games.
 
 Each phase ends with a report and a wait. The user approves before the next spends.
 
+Look at the project's workflows first. The Game entry card builds a slot-filling
+workflow that ends in `nodetool.game.ExportGodotProject`, so when the project
+already holds one, a first build is a re-run rather than P0-P2 by hand: run the
+whole workflow to refill every slot, or re-run one slot's chain to replace a
+single asset, then pick up at P3. Do the phases below by hand when there is no
+such workflow.
+
 ### P0 — Brief to design
 
 1. `list_game_templates`. Pick the template whose loop matches the brief; say why.

AGENTS.md

@@ -502,6 +502,7 @@ reference is [docs/harnesses.md](docs/harnesses.md) plus [docs/cli.md](docs/cli.
 | Re-run an approved storyboard, script, timeline or entity from a graph | `npm run fixtures:graph-resources` — seeds a scratch install and runs the four shipped examples on the fake provider | `create_storyboard`, `get_storyboard`, `list_entities`, `get_script`, `validate_timeline` on what the graph wrote | minutes |
 | Build or fix a 3D scene with no editor open | no command of its own — the `capability-suites` selfcheck the `model3d` harness entry names | `list_model3ds`, `create_model3d`, `get_model3d`, `edit_model3d`, `validate_model3d` | sub-second |
 | Fill a Godot template with generated sprites, tiles and audio, export the project, and run it headless | no command of its own — the `capability-suites` selfcheck the `godot` harness entry names; real Godot runs when `GODOT_BIN` is set | `list_game_templates`, `export_godot_project`, `verify_godot_project`; the `nodetool.game.*` nodes fill slots | seconds; Godot import and smoke tens of seconds |
+| Take one sentence to a running Godot project — design, slot-filling graph, export | no command of its own — the suites the `game-flow` harness entry names, run by `harness gate` on diffs touching the flow | `ui_game_set_setup`, `ui_game_design`, `ui_game_update_design`, `ui_game_build`; the graph ends in `nodetool.game.ExportGodotProject` | seconds to build, the run as long as its models take |
 | Season a prompt with the entity library | no command of its own — the `capability-suites` selfcheck the `entities` harness entry names | `list_entities`, `get_entity`, `apply_entities` | sub-second |
 | Measure a clip instead of watching it — duration, loudness, frequency content, motion, cuts | no command of its own — the `capability-suites` selfcheck the `agent-capabilities` harness entry names | `analyze_audio`, `analyze_audio_spectrum`, `detect_audio_events`, `analyze_video`, `detect_video_scenes` | seconds, no ffmpeg |
 | See what a timeline looks like at a timecode — tracks layered, animations mid-flight, transitions part way, text drawn | no command of its own — the `capability-suites` selfcheck the `agent-capabilities` harness entry names | `preview_timeline_frame` (composited frames + per-layer opacity/z-order/wipe), then `view_image` | seconds, no GPU or browser |

docs/creation-flows/game-prd.md

@@ -6,6 +6,7 @@
 **Shipped plan this builds on:** [plans/project-view/PLAN.md](../plans/project-view/PLAN.md) (Phases 0 and 4)
 **Tasks:** [tasks.md](tasks.md)
 **Related:** [creative-agent.md](../creative-agent.md), [agentic-video-product.md](../agentic-video-product.md), [script-storyboard-link/prd.md](../script-storyboard-link/prd.md), [timeline-editor-prd.md](../timeline-editor-prd.md), [image-editor-prd.md](../image-editor-prd.md), [triggers-prd.md](../triggers-prd.md)
+**Sixth flow:** [game-prd.md](game-prd.md) — E6 Game, the guided flow to a Godot project, built on this shell
 
 ---
 

docs/creation-flows/prd.md

@@ -411,6 +411,89 @@ of each other. Inside a phase, tasks are listed in dependency order.
 - [ ] **Entry.** Enable the Workflow card on the New Project surface (not
       Studio); resume by stage in the workflow editor surface.
 
+## P10 — Game flow
+
+> Spec: [game-prd.md](game-prd.md). Depends on P2 (the shell) and P9 (the
+> build-from-placement path it mirrors). Sub-phases G1a → (G1b ∥ G2 ∥ G3).
+
+### G1a — Contracts (protocol only, first)
+
+- [x] **Settings shape.** `settings.game` per game-prd § 5.1: `gameSetup`,
+      `readGameSetup`, `writeGameSetup` beside the workflow setup helpers in
+      `packages/protocol/src/api-schemas/workflows.ts`. Tests: a workflow
+      without `game` reads null; every stage round-trips; a patch keeps the
+      other settings keys.
+- [x] **Designer contract.** `packages/protocol/src/game-design.ts`:
+      system prompt, `buildGameDesignSchema(manifest)` with slot ids pinned
+      as enums, `parseGameDesign` filling skipped slots from the manifest
+      and reporting them, `GAME_INSPIRATION_CHIPS` with a pinned design per
+      shipped template. Tests: a design missing a slot prompt is filled and
+      reported; a chip's design has one cast entry per spritesheet slot.
+- [x] **Slot prompt.** `packages/protocol/src/game-flow-prompt.ts`, on top of
+      `slotPrompt`, per § 5.3. Test table: sizes per kind for every slot in the three shipped
+      manifests, style descriptor present verbatim, cast descriptor present
+      only on the slot that names it, closest aspect ratio.
+- [x] **Graph builder.** `packages/protocol/src/game-graph.ts`
+      `gameGraphPlacement` per § 5.3, returning a `WorkflowPlacement`.
+      Tests: one chain per slot kind, audio chains omitted when unchosen,
+      every checker's stamped output feeds the one export node's `fills` list
+      and nothing else does, an unknown node type is an issue and no node.
+- [x] **Style presets.** `GAME_STYLE_PRESETS` in `style-presets.ts` per
+      § 5.6, thumbnails as `package://nodetool-base/styles/game-<id>.png`.
+
+### G1b — Node, seeds, harness (backend)
+
+- [x] **`packages/game-nodes`.** `nodetool.game.ExportGodotProject` per
+      § 5.5, the export join (`joinGodotProject` in `src/project.ts`) that the
+      node and `packages/agents/src/capabilities/godot.ts` both call, the zip
+      beside the directory. Registered in `@nodetool-ai/base-nodes`,
+      the root workspaces, the backend bundle. Tests: the filled fixture
+      exports and reports `verified: false` with a reason without Godot; no
+      fills exports the placeholders; an unfilled slot keeps its own; a fill
+      for a slot the template lacks is an error naming it.
+- [x] **Templates query and seeds.** `games.templates` trpc query;
+      `seedStylePresets` takes a preset list; `games.stylePresets` seeds the
+      six game presets idempotently.
+- [x] **Headless setup capabilities.** `ui_game_*`'s server mirrors in
+      `packages/agents/src/capabilities/workflows.ts`, capability table rows,
+      `npm run capabilities:check` green.
+- [x] **Harness.** `game-flow` entry in `packages/cli/src/harness/registry.ts`
+      whose selfcheck runs the protocol suites, a `packages/base-nodes` suite
+      that builds every chip's placement against the real registry and
+      passes it through the validator (criterion 5), the game-nodes suite,
+      and the web suites. `harness gate` maps the new paths to it. Docs:
+      `docs/harnesses.md` entry, AGENTS.md harness table row.
+
+### G2 — Web flow
+
+- [x] **Hooks.** `web/src/hooks/game/useGameSetup.ts` (reader, stage, writer
+      over `settings.game`), `useDesignGame.ts` (one `generate_text` call),
+      `useBuildGame.ts` (place, validate, run per § 5.4), `useGameTemplates.ts`
+      (the trpc query), `useGameStylePresets.ts`.
+- [x] **Steps.** `web/src/components/setup/game/`: `IdeaStep`, `TemplateStep`,
+      `ReviewStep`, `LookStep`, `useGameSetupFlow.ts`, `GameSetupHost.tsx`,
+      `templates.ts` (card copy), `GameLandingChecklist.tsx`. Copy from
+      game-prd Appendix A. Blocked reasons per § 4.2 and § 4.3.
+- [x] **Entry.** `game` in `EntryFlowId` and `ENTRY_CARDS` (not Studio),
+      `startGameFlow` and the `game` setup target in `NewProjectSurface`,
+      landing through `handleSetupFinished` with the checklist in the agent
+      panel. Update the "five flows" tests to six.
+- [x] **Tools.** `ui_game_set_setup`, `ui_game_design`,
+      `ui_game_update_design`, `ui_game_build` in
+      `web/src/lib/tools/builtin/gameSetup.ts`, registered in the index,
+      tests in `__tests__/gameSetupTools.test.ts`.
+- [x] **Tests.** Each step, the flow config at every stage, the checklist's
+      verified-only-when-true rule (criterion 7), the entry card.
+
+### G3 — Assets and docs
+
+- [x] **Tiles.** `scripts/make-game-style-tiles.mjs` and its nine PNGs under
+      `packages/base-nodes/nodetool/assets/nodetool-base/` per § 6.2 and
+      § 6.3, each under the asset budget.
+- [x] **Docs.** `docs/harnesses.md` game-flow entry, `docs/creation-flows/prd.md`
+      link, `.claude/skills/godot-game/SKILL.md` gains a line pointing the
+      agent at the flow's graph for a first build.
+
 ## Cross-cutting, every phase
 
 - [ ] UI primitives only, design tokens only, media through `ResponsiveImage`

docs/creation-flows/tasks.md

@@ -1151,6 +1151,47 @@ through `GODOT_BIN` or `godot`/`godot4`/`Godot` on `PATH`; the suites that
 need it skip with a named reason when it is absent. Implementations:
 `packages/agents/src/capabilities/godot.ts`.
 
+### Game flow (guided build: design, graph, export)
+
+The Game entry card turns one sentence into a graph that fills every slot the
+pipeline above declares and ends in `nodetool.game.ExportGodotProject`. Three
+pure pieces carry it, each with its own suite: `packages/protocol/src/game-design.ts`
+holds the designer contract that writes the cast, the level and one prompt per
+slot; `game-flow-prompt.ts` wraps `slotPrompt` so the reviewed subject, the
+style preset and the slot's cast member become a sized prompt with the aspect
+ratio the generator takes; and `game-graph.ts`'s `gameGraphPlacement` is a pure
+function of manifest, design and choices, so nothing a model decides changes
+the chain a slot gets. The flow's state is `settings.game` on the workflow, so
+a half-built game resumes at the step it stopped on.
+
+`game-flow` is the harness over that path. Its selfcheck runs the `game`
+suites in `packages/protocol`; the `game-graph-chips` suite in
+`packages/base-nodes`, which builds each shipped inspiration chip's pinned
+design against the real node registry and passes the result through
+`validateGraph`, so a slot chain naming a node type nobody registered fails
+here instead of on a creator's canvas; the `packages/game-nodes` suite over the
+export node; the `capabilities-game-setup` and `capabilities-godot` suites in
+`packages/agents`, which drive the four `ui_game_*` mirrors and the export join
+both the node and the capability call; the `trpc-games` suite in
+`packages/websocket` over the templates query and the preset seed; and the web
+suites under `web/src/components/setup/game`, `web/src/hooks/game` and
+`web/src/lib/tools/builtin/__tests__/gameSetupTools.test.ts`. `harness gate`
+fires it on any diff touching those paths.
+
+It simulates everything up to the art. A design is parsed and the slots the
+model skipped are filled from the manifest and reported, prompts are sized from
+the slot spec, the placement is built and validated against the registry, the
+export node writes the project directory and the zip from the filled fixture in
+`packages/protocol/fixtures/game-assets/`, and the `ui_game_*` tools drive
+every step with no browser open.
+
+It does not generate art, call a provider, or assume Godot. No image, sound or
+music model runs, so whether a sheet still reads at the slot's exact cell size
+is not answered here (game-prd R8) — `nodetool debug` on the built graph is
+where that shows up. Godot runs only where `GODOT_BIN` or a binary on `PATH` is
+found; without one the export node reports `verified: false` with a reason, and
+the suite asserts the reason rather than skipping the case.
+
 ### Entity library tools (no browser)
 
 The reusable production entities — characters, locations, styles, props — are

docs/harnesses.md

@@ -161,6 +161,8 @@
     "gen:example-thumbnails": "node scripts/generate-example-thumbnails.mjs",
     "gen:icons": "node scripts/generate-brand-icons.mjs",
     "gen:icons:check": "node scripts/generate-brand-icons.mjs --check",
+    "gen:game-tiles": "node scripts/make-game-style-tiles.mjs",
+    "gen:game-tiles:check": "node scripts/make-game-style-tiles.mjs --check",
     "build:example-storyboards": "node scripts/build-example-storyboards.mjs",
     "build:example-storyboards:check": "node scripts/build-example-storyboards.mjs --check",
     "examples:smoke": "node scripts/smoke-examples.mjs",

package-lock.json

@@ -27,6 +27,7 @@
     "@nodetool-ai/browser": "*",
     "@nodetool-ai/config": "*",
     "@nodetool-ai/execution": "*",
+    "@nodetool-ai/game-nodes": "*",
     "@nodetool-ai/godot": "*",
     "@nodetool-ai/godot-templates": "*",
     "@nodetool-ai/image-editor": "*",