Kleinstadt-Krise (Pocket Providence)

SECTION 01 // EXECUTIVE GDD

A turn-based systemic micro-god puzzle game where you watch over a miniature toy-like town from above. Instead of micromanaging Sims-style needs, citizens ("Menschli") and town events act as deterministic clockwork hazards. Every divine weather intervention solves one crisis while threatening to trigger a chain-reaction catastrophe somewhere else.

⚡ The Systemic Interaction Matrix (Tools × Hazards)

Target / Entity	🌬️ Wind Gust (1 AP)	🌧️ Raincloud (1 AP)	❄️ Snap Freeze (1 AP)	☀️ Sunbeam (1 AP)
🔥 Burning House	DANGER: Fans flames 1 tile downwind!	SOLVES: Extinguishes fire immediately.	Cools roof (+1 turn before spread).	DANGER: Intensifies heat!
🎈 Runaway Balloon	SOLVES: Pushes balloon 2 tiles toward Child.	Heavy rain weighs balloon down.	Frosts balloon in place.	Warm thermal lifts balloon.
🎺 Town Parade	Headwind halts march for 1 turn.	FAIL: Parade gets soaked and scatters!	DANGER: Parade float slips on ice!	BONUS: Festive sunshine boost!
🦹‍♂️ Fleeing Burglar	Affects sky entities only.	Wets street (slows sprint from 2 to 1 tile).	SOLVES: Burglar slips & is Stunned!	Melts ice under Burglar.
🚓 Police Patrol	No direct effect.	Wet road slows pursuit.	COMBO: Police slides 2 tiles across ice!	Dries road for normal patrol.
🌊 Lake / River	Pushes clouds over or off water.	HAZARD: Water +1. At >3, floods neighbors!	SOLVES: Freezes lake cap (prevents overflow).	SOLVES: Evaporates water (-1 level).

SECTION 02 // GODOT 4.6 SCENE TREE

Godot 4.6 Node Hierarchy & Dual-Plane Architecture

MainGame (Node2D) [main_game.gd]
├── TurnManager (Node) [turn_manager.gd]
├── CommandHistory (Node) [command_history.gd] # Deterministic Snapshot Undo stack
├── GridController (Node2D) [grid_controller.gd]
│   ├── GroundTileLayer (TileMapLayer) # Streets, Grass, Lakes
│   ├── SurfaceStateLayer (TileMapLayer) # Ice, Wet, Flooded overlays
│   ├── IntentOverlayLayer (Node2D) # Telegraphed movement arrows
│   ├── GroundEntities (Node2D) # Y-Sorted Menschli & Buildings
│   └── SkyEntities (Node2D) # Rendered above ground with drop-shadows
└── CanvasLayerUI (CanvasLayer) [hud_controller.gd]

SECTION 03 // GOOGLE STITCH UI PROMPTS

Google Stitch Prompts (Zoom-Out-Zoom-In Framework)

STITCH PROMPT #1 // MASTER GAMEPLAY HUD

Context & Product:
Design a desktop game HUD overlay screen (16:9 widescreen layout) for "Kleinstadt-Krise" (Pocket Providence), a cozy turn-based tactical puzzle god-game where players look down at a miniature toy town diorama on an 8x8 tile grid and use weather powers to stop comical town crises.

Target User & Goal of the Screen:
Strategy and puzzle players (fans of Into the Breach and Dorfromantik). The primary goal of this screen is to let the player read upcoming turn hazards at a glance, select a Divine Weather Tool card from the bottom dock, inspect tile states, and end or undo their turn without obscuring the central 70% diorama viewport.

Layout & Component Hierarchy:
1. Top Center Weather & Turn Forecast Bar (Floating Pill Header):
   - Turn Counter badge ("Turn 3 / 6").
   - Ambient Wind Indicator with directional arrow pill ("Ambient Wind: EAST 1 Tile ->").
   - Town Lake Water Level meter ("Lake Capacity: 2/3 Drops" with a warning amber state).
2. Left Collapsible Crisis Objectives Card (Floating Translucent Card):
   - Header: "Active Town Crises"
   - 3 checklist items with status pills:
     a) "Keep Mayor's Parade Dry (2/4 Tiles to Square)" - Active
     b) "Extinguish Bakery Fire (2 Turns left)" - Urgent Red
     c) "Help Police Catch Burglar (Stun with Ice)" - In Progress
3. Center Canvas Area (70% open space):
   - A clean isometric/top-down 8x8 diorama grid placeholder with a selected tile callout tooltip floating near the center: "Cobblestone Street | State: FROZEN (2 Turns) | Occupant: Fleeing Burglar (Stunned)".
4. Bottom Center Divine Tool Dock (Tactile Toy-like Card Bar):
   - Action Point counter badge on the left ("Divine Mana: 2 / 3 AP").
   - 4 selectable Weather Tool Cards arranged horizontally with icon, title, AP cost badge, and 1-line systemic effect:
     1) "Gust of Wind" (1 AP - Push Cloud/Balloon 2 tiles; fans fire)
     2) "Raincloud" (1 AP - Extinguish fire; +1 Lake water; ruins parade)
     3) "Snap Freeze" (1 AP - Selected/Highlighted state - Freeze road 2 turns; slips burglar)
     4) "Sunbeam" (1 AP - Evaporate flood/ice; -1 Lake water)
5. Bottom Right Turn Control Cluster:
   - Secondary button: "Undo Action (Z)" and "Reset Turn".
   - Primary high-emphasis CTA button: "End Turn & Resolve Weather ->" in warm amber/gold.

Visual Direction & Constraints:
- Style: Cozy tactile tabletop diorama UI, inspired by Dorfromantik, Into the Breach, and Mini Motorways.
- Color Palette: Warm cream/parchment card surfaces (#F8F5EE) or frosted slate glass panels, crisp dark charcoal typography (#1E293B), sky blue (#38BDF8) for weather accents, warm amber (#F59E0B) for primary actions, and coral red (#F43F5E) for hazard warnings.

STITCH PROMPT #2 // LEVEL SELECT

Context & Product:
Design a desktop Level Selection & Crisis Briefing screen for "Kleinstadt-Krise", a cozy turn-based puzzle god-game.

Layout & Components:
1. Top Bar: Game Title logo, Total Karma Stars earned ("14 / 18 Stars"), and Settings icon.
2. Left 60% Area: Stylized miniature town map showing 5 connected diorama islands (Level 1: "The Red Balloon", Level 2: "Rain on the Parade", Level 3: "Slippery Heist" [Selected], Level 4: "River Overflow", Level 5: "Town Festival Chaos") with 1-to-3 star rating badges.
3. Right 40% Panel: "Crisis Briefing Folder" card for Level 3 showing Turn Limit, Ambient Wind Forecast chip, Active Hazards list, Available Divine Tools, and "Start Intervention" CTA button.

STITCH PROMPT #3 // FOLLOW-UPS

# Refinement 1 (Add Collateral Warning Banner):
On the top center below the Weather Forecast Bar, add a compact warning pill in coral red (#F43F5E) that reads: "⚠️ Collateral Alert: Raincloud on (3,2) will overflow Town Lake next turn!"

# Refinement 2 (Improve Tool Card Readability):
In the bottom Divine Tool Dock, give each of the 4 tool cards a split layout: top half with a clean weather illustration and AP cost pill, bottom half with a green "Helps:" line and a red "Risk:" line.

SECTION 04 // NANO BANANA BATCH PROMPTS

Nano Banana Prompts (6 Low-Cost Sprite Sheet Batches)

MASTER STYLE LOCK PREFIX

2D game sprite sheet, orthographic 3/4 top-down isometric diorama view, stylized miniature painted wooden and matte clay toy aesthetic inspired by Dorfromantik and Link's Awakening Switch, clean crisp silhouettes, soft studio lighting, vibrant cozy palette, isolated on a pure flat solid white background (#FFFFFF) with generous padding between items, no text, no watermarks, no drop shadows bleeding between items.

NANO BANANA #1 // TERRAIN TILESET

2D game sprite sheet, 3x3 grid of 9 square isometric/top-down diorama terrain tiles, stylized miniature painted wooden and matte clay toy aesthetic inspired by Dorfromantik, isolated on a pure flat solid white background (#FFFFFF) with generous spacing: 1. Cozy cobblestone street (dry), 2. Wet puddled street, 3. Glossy blue-white icy street, 4. Lush green park grass, 5. Calm blue lake water, 6. Swollen high-water lake brimming at edges, 7. Flooded street under shallow rippling water, 8. Festive town square with bunting ribbons, 9. Stone canal bridge. Clean edges, no text.

NANO BANANA #2 // BUILDINGS SHEET

2D game sprite sheet, 2x3 grid of 6 miniature European town buildings, orthographic 3/4 top-down diorama view, stylized painted wooden and matte clay toy aesthetic, isolated on pure flat white background (#FFFFFF): 1. Half-timbered German townhouse intact, 2. Same townhouse with cartoon roof flames and smoke, 3. Same townhouse wet with white steam puffs, 4. Small town Bank with gold coin emblem, 5. Miniature Police Station with blue siren lamp, 6. Festive Town Hall with clock tower. No text.

NANO BANANA #3 // MENSCHLI PAWNS

2D game sprite sheet, 2x3 grid of 6 miniature board-game pawn characters ("Menschli") and vehicles, 3/4 top-down diorama view, chunky toy proportions like Carcassonne meets claymation, isolated on pure flat white (#FFFFFF): 1. Sneaky cartoon burglar in striped shirt carrying loot sack, 2. Burglar slipping flat on back on ice with dizzy stars, 3. Chunky miniature green-and-white Police patrol car, 4. Colorful Town Parade brass band and float, 5. Little town child looking up with outstretched hand, 6. Glossy red party balloon on string. No text.

NANO BANANA #4 // WEATHER & SKY VFX

2D game sprite sheet, 2x3 grid of 6 stylized tactile weather effects, 3/4 top-down diorama view, matte clay and paper-craft aesthetic, isolated on pure flat white (#FFFFFF): 1. Fluffy white cumulus cloud, 2. Plump dark blue raincloud pouring raindrops, 3. Swirling cyan wind gust ribbons, 4. Sparkling crystalline ice frost tile patch, 5. Golden sunbeam light column, 6. Directional telegraph arrows (blue, red dashed, gold). No text.

NANO BANANA #5 // UI TOOL EMBLEMS

2D game UI icon sheet, 2x2 grid of 4 square rounded emblem illustrations for divine god-game tool cards, cozy storybook gouache and clay-relief style, isolated on pure flat white (#FFFFFF): 1. "Windstoß" blowing turquoise gust, 2. "Regenwolke" hands squeezing plump raincloud, 3. "Vereisen" frost snowflake freezing cobblestone, 4. "Sonnenstrahl" radiant golden sun parting clouds. No text.

NANO BANANA #6 // KEY ART

Wide 16:9 key art illustration of a floating miniature German toy-town island diorama on a tabletop, tilt-shift photography feel, clay and painted wood aesthetic. Parade marching on left while raincloud hovers; burglar slipping on ice in front of tiny police car on right; red balloon drifting toward child in center. Warm sunlit atmosphere, no text.

SECTION 06 // ANTIGRAVITY + GODOT 4.6 PLAYBOOK

Claude vs. Gemini 4 Argon Strategy & Sequential Prompts

Use Claude Sonnet 5.5 / Opus first for fast GDScript scaffolding, UI layout, and Tween polish (Phases 1, 4, 5). Switch to Gemini 4 Argon (Thinking: High) for complex deterministic state resolution, AStarGrid2D AI, and multi-file bug audits (Phases 2, 3, 6).

MCP CONFIG // mcp_config.json

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["-y", "@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "C:/Path/To/Godot_v4.6-stable_win64.exe",
        "PROJECT_PATH": "C:/Path/To/KleinstadtKrise"
      }
    }
  }
}

RULES // .antigravity/rules.md

# Kleinstadt-Krise — Godot 4.6 Workspace Rules
- NEVER use Godot 3 syntax (KinematicBody2D, TileMap, yield, export var).
- ALWAYS use Godot 4.6 typed GDScript (@export, @onready, TileMapLayer, await, create_tween()).
- Separate grid state into GroundCell and SkyCell dictionaries keyed by Vector2i.
- Implement to_snapshot() and restore_snapshot() using deep dictionary duplicates for O(1) Undo.

PHASE 1 (Claude) // Grid Data & Procedural Board Renderer

We are building "Kleinstadt-Krise" (Pocket Providence), a turn-based systemic micro-god puzzle game in Godot 4.6.
Please implement Phase 1: Project Scaffolding, Dual-Layer Grid Data Model (`GridEnums`, `GridState` with `to_snapshot()` and `restore_snapshot()`, flood-fill BFS lake clusters), and an isometric/top-down procedural `BoardView` (`_draw()`) with drop-shadows for Sky entities so we can test immediately in Godot 4.6.

PHASE 2 (Gemini 4 Argon) // Turn Manager & Weather Chain Reactions

Implement Phase 2: Deterministic `TurnManager`, Undo Stack, and the 4 Divine Tools (`WIND_GUST`, `RAINCLOUD`, `SNAP_FREEZE`, `SUNBEAM`) with all systemic collateral rules: Wind pushes Sky entities 2 tiles but spreads Fire downwind; Rain extinguishes Fire and wets streets but ruins Parades and increments connected Lake water_level (flooding adjacent tiles when > 3); Freeze creates slippery ice for 2 turns that stuns Burglars, slides Police 2 tiles, and caps Lakes; Sunbeam evaporates water (-1 Lake) and melts ice.

PHASE 3 (Gemini 4 Argon) // Menschli AI & Intent Telegraph Arrows

Implement Phase 3: End-of-turn Ambient Wind sky drift, Cloud precipitation, AStarGrid2D street pathfinding for `BURGLAR` (2 tiles/turn, stunned on FROZEN) and `POLICE` (chases Burglar, slides 2 tiles on FROZEN, arrests when adjacent/same tile), `PARADE` route march, `BALLOON` rescue check, and live Intent Telegraph Arrows on `BoardView`.

PHASE 4 (Claude) // Tactile Diorama HUD & Collateral Warning Previews

Implement Phase 4: Tactile HUD in `CanvasLayer` (`hud_controller.gd`) featuring Top Forecast Bar (Turn, Ambient Wind, Lake meter), Left Crisis Checklist, Bottom Divine Tool Card Dock with hover ghost previews on `BoardView`, and real-time Collateral Warning callouts when an action will fan fire, soak the parade, or overflow the lake.

PHASE 5 (Claude / Flash) // 5 Campaign Levels & Hop Tweens

Implement Phase 5: `LevelCatalog` with 5 solvable escalating puzzle levels ("Der Rote Ballon", "Trockene Parade", "Glatteis-Gauner", "Hochwasser am Markt", "Stadtfest im Chaos"), board-piece hop animations via `create_tween()`, and weather particles.

PHASE 6 (Gemini 4 Argon High) // Deep Multi-File Bug Audit

Switch reasoning to High and perform a full multi-file architectural audit of `res://scripts/` and `res://scenes/`: verify Godot 4.6 static typing, ensure `to_snapshot()` deep-copies all nested dictionaries for leak-free Undo (`Z`), and verify that telegraph preview arrows 100% match `end_turn()` resolution.

Town Saved!