name: godot-dev description: Develop / test / debug the WorldOS GT2 Godot painterly-isometric reference/extension renderer (the extensions/renderers/godot/ archive). Use only for explicit Godot extension work or a renderer-migration issue that reopens Godot; current isometric/visual-renderer work routes through the Unity/current-renderer and visual-critic lane instead. Encodes the thin-client invariants, the dimetric-2:1 projection, how to run/validate locally, and points at the full knowledge base.

WorldOS GT2 Godot reference renderer — dev skill

The GT2 renderer is a stateless thin client over the zone-based WorldOS engine, kept as reference/extension material while the current renderer lane is Unity/current-renderer plus deterministic SceneGrid/visual-critic checks. Read extensions/renderers/godot/HANDOFF.md first — it is the full Godot knowledge base (architecture diagrams, the isometric/painterly/Pillars research, gotchas, the prioritized backlog). Companions: extensions/renderers/godot/ISO-PROJECTION.md (the locked projection), extensions/renderers/godot/tools/README.md (asset pipeline).

The non-negotiables (full list in HANDOFF.md §7)

• Engine = sole writer; the renderer owns ZERO state but the /events cursor.
• Ignore all surface x/y — re-derive every screen position from named zones.
• No engine facing field, ever — facing is renderer-derived (conformance-locked).
• Writes only the frozen /move vocab (…/travel/inspect/move_to_zone).
• Projection is dimetric 2:1 (~26.57°), irreversible once finals bake — cite ISO-PROJECTION.md.
• Engine snapshot always overrides optimistic UI (never move a token from the click).

Run / validate (Godot 4.6.3 at /Applications/Godot.app/Contents/MacOS/Godot)

• Parse/compile: godot --headless --path extensions/renderers/godot --import
• Logic smoke: godot --headless --path extensions/renderers/godot --quit-after 180 -- --smoke-intent
• Visual proof (window): godot --path extensions/renderers/godot --demo-occlusion --quit-after 300 → /tmp/wos_godot_occlusion_*.png
• CI archive: extensions/renderers/godot/ci/github-actions-godot.yml (import + conformance + Web/Linux export + screenshot), no model keys.

Making art (see the asset-gen skill)

Characters/props/backdrops come from the AI asset toolkit → the Blender bake → the sprite-sheet manifest. Tripo (rig+animate) and Meshy make 3D characters; Scenario makes painterly backdrops (non-Eva); finals live gitignored in content/worlds/_private/.../images/<scope>/. Invoke the asset-gen skill for the job matrix, keys, wrappers, and MCPs.

Backlog (HANDOFF.md §9)

Next: #1090 (narration/dialogue in-view) → #1089 (painterly backdrop, via asset-gen/Scenario) → #1063 (serve _private finals) → #1092 (full party) → #1060 (combat tokens) → #1091 (real rigged animation, via asset-gen/Tripo). Delivery: #1057–#1059. Epic #1050.

Dev loop

Only use this loop for explicit extensions/renderers/godot/ reference/extension work. Worktree off origin/main → additive change → local Godot validate → PR → squash-merge → prune. Multi-session repo: never branch-flip the shared checkout; Godot extension-only PRs are optional/manual proof and not a required branch-protection lane.

Gotchas (cost real time — see HANDOFF.md §8)

• export_presets.cfg is in Godot's default .gitignore, but godot --headless --export fails "no preset named X" without it. Remove it from .gitignore and commit minimal Web + Linux presets. Validate a preset locally without templates by checking the error is "export template not found" (preset OK) vs "no preset named X" (preset wrong).
• Asset bake output is gitignored — destroyed on git worktree remove. Run the bake (meshy_gen/tripo_gen → bake_sprites.py → pack_sheet.py) so finals land in the canonical repo's content/worlds/_private/.../images/<scope>/, never inside a WorldOS-worktrees/wt-*/ worktree.
• Art generation → the asset-gen skill; integrating a new gen service → wire-external-api-service.