summer-engine 1.5.0 → 2.2.0

package/{marketplace.json → .claude-plugin/marketplace.json}

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
-  "name": "summer",
+  "name": "summer-engine",
   "description": "Summer Engine plugins for Claude Code",
   "owner": { "name": "Summer Engine", "email": "founders@summerengine.com" },
   "plugins": [
     {
       "name": "summer",
       "source": "./",
-      "version": "1.4.0",
-      "description": "AI game-dev studio: 19 skills under summer: namespace, MCP bridge, session-start + pre-commit hooks.",
+      "version": "2.2.0",
+      "description": "Superpowers for AI game dev. 60 auto-trigger skills under summer: namespace, MCP bridge to the local Summer Engine, session-start + pre-commit hooks.",
       "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
       "category": "game-development",
       "tags": ["game-dev", "godot", "ai-game-engine"],

package/.claude-plugin/plugin.json

@@ -1,15 +1,15 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "summer",
-  "version": "1.4.0",
-  "description": "AI game-dev studio for Godot/Summer projects: 12 workflow skills + 7 specialists + lifecycle hooks + MCP bridge to the local Summer Engine.",
+  "version": "2.2.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer-engine-cli",
+  "repository": "https://github.com/SummerEngine/summer",
   "license": "MIT",
   "keywords": [
     "game-dev",
@@ -26,25 +26,66 @@
     "performance"
   ],
   "skills": [
+    "./skills/_meta/using-summer/",
+    "./skills/_meta/skill-create/",
+    "./skills/_meta/skill-improve/",
+    "./skills/_meta/skill-test/",
     "./skills/scene-and-project/brainstorm-game/",
-    "./skills/debugging/debug/",
+    "./skills/scene-and-project/new-project/",
+    "./skills/scene-and-project/browse-templates/",
     "./skills/scene-and-project/play/",
+    "./skills/scene-and-project/scene-composition/",
+    "./skills/scene-and-project/make-game/",
+    "./skills/debugging/debug/",
     "./skills/gameplay-mechanics/design-mechanic/",
     "./skills/level-design/design-level/",
     "./skills/rendering-and-lighting/art-direction/",
+    "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
-    "./skills/visual-effects/vfx/",
+    "./skills/visual-effects/game-feel/",
     "./skills/performance/tune-performance/",
     "./skills/ai-and-npcs/design-npc/",
     "./skills/multiplayer-and-networking/setup-multiplayer/",
+    "./skills/multiplayer-and-networking/host-authoritative-state/",
+    "./skills/multiplayer-and-networking/peer-to-peer-multiplayer/",
     "./skills/deployment/export-and-ship/",
     "./skills/character-controllers/fps-controller/",
-    "./skills/rendering-and-lighting/3d-lighting/",
-    "./skills/scripting/gdscript-patterns/",
-    "./skills/scene-and-project/scene-composition/",
-    "./skills/ui/ui-basics/",
-    "./skills/assets/asset-strategy/",
-    "./skills/scene-and-project/make-game/"
+    "./skills/scripting-patterns/gdscript-patterns/",
+    "./skills/ui-and-ux/ui-basics/",
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
   ],
   "hooks": "./hooks/hooks.json",
   "mcpServers": "./.mcp.json",

package/.codex-plugin/plugin.json

@@ -1,26 +1,87 @@
 {
   "name": "summer",
-  "version": "1.4.0",
-  "description": "AI game-dev studio for Godot: 19 skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
+  "version": "2.2.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer-engine-cli",
+  "repository": "https://github.com/SummerEngine/summer",
   "license": "MIT",
   "keywords": [
     "game-dev", "godot", "ai-game-engine", "skills",
     "workflow", "level-design", "vfx", "multiplayer"
   ],
-  "skills": "./skills/",
+  "skills": [
+    "./skills/_meta/using-summer/",
+    "./skills/_meta/skill-create/",
+    "./skills/_meta/skill-improve/",
+    "./skills/_meta/skill-test/",
+    "./skills/scene-and-project/brainstorm-game/",
+    "./skills/scene-and-project/new-project/",
+    "./skills/scene-and-project/browse-templates/",
+    "./skills/scene-and-project/play/",
+    "./skills/scene-and-project/scene-composition/",
+    "./skills/scene-and-project/make-game/",
+    "./skills/debugging/debug/",
+    "./skills/gameplay-mechanics/design-mechanic/",
+    "./skills/level-design/design-level/",
+    "./skills/rendering-and-lighting/art-direction/",
+    "./skills/rendering-and-lighting/3d-lighting/",
+    "./skills/audio/audio-direction/",
+    "./skills/visual-effects/game-feel/",
+    "./skills/performance/tune-performance/",
+    "./skills/ai-and-npcs/design-npc/",
+    "./skills/multiplayer-and-networking/setup-multiplayer/",
+    "./skills/multiplayer-and-networking/host-authoritative-state/",
+    "./skills/multiplayer-and-networking/peer-to-peer-multiplayer/",
+    "./skills/deployment/export-and-ship/",
+    "./skills/character-controllers/fps-controller/",
+    "./skills/scripting-patterns/gdscript-patterns/",
+    "./skills/ui-and-ux/ui-basics/",
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
+  ],
   "mcpServers": "./.mcp.json",
   "hooks": "./hooks/hooks.json",
   "interface": {
-    "displayName": "Summer Engine",
-    "shortDescription": "Build games by talking. AI game-dev studio for Godot.",
-    "longDescription": "Summer Engine turns Codex into a game-dev studio. 12 workflow skills (brainstorm-game, design-mechanic, design-level, art-direction, audio-direction, vfx, tune-performance, design-npc, setup-multiplayer, export-and-ship, debug, play) + 7 auto-trigger specialists. The MCP bridge talks to the local Summer Engine fork of Godot for scene mutation, asset import, render, play, diagnostics. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
+    "displayName": "Summer",
+    "shortDescription": "Superpowers for AI game dev. Build games by talking.",
+    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine — the AI-native game engine. 60 auto-trigger skills covering brainstorm, design, build, play, debug, ship — plus a using-summer meta-skill that establishes workflow priority on session start. The MCP bridge talks to the local Summer Engine for scene mutation, asset import, render, play, and diagnostics — 38 focused tools across scene/debug/project/asset/generate, with file/git/shell/grep deferred to the host agent. Summer Engine is compatible with Godot 4.5 — write code in GDScript, drive the engine via MCP. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": ["Interactive", "Read", "Write"],
@@ -30,7 +91,7 @@
     "defaultPrompt": [
       "I want to make a game.",
       "/summer:brainstorm-game",
-      "Open this Godot project and tell me what's broken."
+      "Open this Summer Engine project and tell me what's broken."
     ],
     "brandColor": "#FF8F17",
     "screenshots": []

package/.cursor-plugin/plugin.json

@@ -1,13 +1,13 @@
 {
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
   "name": "summer",
-  "displayName": "Summer Engine",
-  "version": "1.4.0",
-  "description": "AI game-dev studio for Godot: workflow skills, specialists, lifecycle hooks, and MCP bridge to the local Summer Engine.",
+  "displayName": "Summer",
+  "version": "2.2.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
   "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
   "publisher": "summer-engine",
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer-engine-cli",
+  "repository": "https://github.com/SummerEngine/summer",
   "license": "MIT",
   "category": "developer-tools",
   "keywords": [
@@ -17,25 +17,66 @@
   ],
   "tags": ["game-dev", "ai", "godot", "creative", "design"],
   "skills": [
+    "./skills/_meta/using-summer/",
+    "./skills/_meta/skill-create/",
+    "./skills/_meta/skill-improve/",
+    "./skills/_meta/skill-test/",
     "./skills/scene-and-project/brainstorm-game/",
-    "./skills/debugging/debug/",
+    "./skills/scene-and-project/new-project/",
+    "./skills/scene-and-project/browse-templates/",
     "./skills/scene-and-project/play/",
+    "./skills/scene-and-project/scene-composition/",
+    "./skills/scene-and-project/make-game/",
+    "./skills/debugging/debug/",
     "./skills/gameplay-mechanics/design-mechanic/",
     "./skills/level-design/design-level/",
     "./skills/rendering-and-lighting/art-direction/",
+    "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
-    "./skills/visual-effects/vfx/",
+    "./skills/visual-effects/game-feel/",
     "./skills/performance/tune-performance/",
     "./skills/ai-and-npcs/design-npc/",
     "./skills/multiplayer-and-networking/setup-multiplayer/",
+    "./skills/multiplayer-and-networking/host-authoritative-state/",
+    "./skills/multiplayer-and-networking/peer-to-peer-multiplayer/",
     "./skills/deployment/export-and-ship/",
     "./skills/character-controllers/fps-controller/",
-    "./skills/rendering-and-lighting/3d-lighting/",
-    "./skills/scripting/gdscript-patterns/",
-    "./skills/scene-and-project/scene-composition/",
-    "./skills/ui/ui-basics/",
-    "./skills/assets/asset-strategy/",
-    "./skills/scene-and-project/make-game/"
+    "./skills/scripting-patterns/gdscript-patterns/",
+    "./skills/ui-and-ux/ui-basics/",
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
   ],
   "hooks": "./hooks/hooks-cursor.json",
   "mcpServers": "./.mcp.json"

package/.factory-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "summer",
+  "description": "Superpowers for AI game dev. 24 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.0.1",
+  "author": {
+    "name": "Summer Engine",
+    "email": "founders@summerengine.com",
+    "url": "https://summerengine.com"
+  },
+  "homepage": "https://summerengine.com",
+  "repository": "https://github.com/SummerEngine/summer",
+  "license": "MIT",
+  "keywords": [
+    "game-dev",
+    "godot",
+    "ai-game-engine",
+    "skills",
+    "mcp"
+  ]
+}

package/.opencode/INSTALL.md

@@ -0,0 +1,75 @@
+# Installing Summer in OpenCode
+
+OpenCode loads plugins as JavaScript modules from `node_modules`, so installation = `npm install` of this package into your OpenCode project.
+
+## Quick install
+
+From your OpenCode project root, run:
+
+```bash
+npm install --save-dev summer-engine
+```
+
+Then add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": ["summer-engine"]
+}
+```
+
+OpenCode resolves `summer-engine` via the package's `main` field, which points to the Summer plugin entry. You can also pin to git for unreleased changes:
+
+```json
+{
+  "plugin": ["summer-engine@git+https://github.com/SummerEngine/summer.git"]
+}
+```
+
+Restart OpenCode. The orientation banner ("Summer Engine is loaded. N skills available…") will appear at the top of every new session, and skills will auto-discover from `node_modules/summer-engine/skills/`.
+
+## What this gives you
+
+- **24 auto-trigger skills** under the `summer:` namespace, including `using-summer`, `brainstorm-game`, `debug`, `play`, `fps-controller`, `gdscript-patterns`, `scene-composition`, `art-direction`, and more.
+- **A `summer-engine` MCP server** — start it with `npx summer-engine mcp` and OpenCode will route scene/diagnostics/asset tools to your local Summer Engine running on `localhost:6550`.
+- **Session-start orientation** — first user message of every session is prefixed with the using-summer primer so the model invokes skills before responding.
+
+## Configure the MCP server
+
+Add this block to your `opencode.json` so OpenCode launches the MCP server on demand:
+
+```json
+{
+  "mcp": {
+    "summer-engine": {
+      "command": "npx",
+      "args": ["summer-engine", "mcp"]
+    }
+  }
+}
+```
+
+## Verify
+
+In a fresh OpenCode session, ask:
+
+> Let's make an FPS in Summer Engine.
+
+The model should auto-invoke the `summer:fps-controller` skill before writing any code. If it doesn't, the plugin isn't loaded — check `opencode.json` and your `node_modules/summer-engine/` install.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| No orientation banner appears | Verify `plugin` array in `opencode.json` and that `summer-engine` is installed in `node_modules/`. |
+| MCP tools return "not connected" | Run `summer run` to launch the engine. The MCP server lazy-connects on the first tool call. |
+| `summer` command not found | `npm install -g summer-engine` for the global CLI. |
+| Skills don't auto-trigger | The using-summer skill loads on first user message; if that message is empty (e.g. a startup probe), they'll trigger on the second. |
+
+## Uninstall
+
+```bash
+npm uninstall summer-engine
+```
+
+Remove the `plugin` and `mcp` entries from `opencode.json`.

package/.opencode/plugins/summer.js

@@ -12,10 +12,15 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const skillsDir = path.resolve(__dirname, '../../skills');
 
 const ORIENTATION = `<EXTREMELY_IMPORTANT>
-Summer Engine is loaded. 19 skills available under the summer plugin.
-Workflow skills (slash menu): brainstorm-game, debug, play, design-mechanic, design-level, art-direction, audio-direction, vfx, tune-performance, design-npc, setup-multiplayer, export-and-ship.
-Specialists auto-trigger: fps-controller, 3d-lighting, gdscript-patterns, scene-composition, ui-basics, asset-strategy, make-game.
-Use OpenCode's native skill tool to load any of them. The summer-engine MCP server (npx summer-engine mcp) provides scene mutation, asset import, render, play, and diagnostics tools.
+Summer is loaded. 24 skills available under the summer: namespace.
+
+Activate summer:using-summer FIRST in any Summer Engine session — it sets workflow priority and the red-flag list.
+
+Process skills (run before building): brainstorm-game, debug, play.
+Discipline skills (shape what you build): gdscript-patterns, scene-composition, art-direction, audio-direction, asset-strategy.
+Build skills (produce artifacts): fps-controller, design-mechanic, design-level, setup-multiplayer, host-authoritative-state, peer-to-peer-multiplayer, design-npc, 3d-lighting, ui-basics, vfx, tune-performance, export-and-ship, make-game.
+
+Always check for a relevant skill before responding. The summer-engine MCP server (npx summer-engine mcp) provides scene mutation, asset import, render, play, and diagnostics tools — file ops, git, shell, and grep are NOT exposed (use OpenCode's native tools).
 </EXTREMELY_IMPORTANT>`;
 
 export const SummerPlugin = async ({ client, directory }) => {
@@ -45,5 +50,3 @@ export const SummerPlugin = async ({ client, directory }) => {
     }
   };
 };
-
-export default SummerPlugin;

package/AGENTS.md

@@ -0,0 +1,51 @@
+# Summer — Agent Context
+
+This file is for any AI agent that loads context from `AGENTS.md` (Codex CLI, Factory Droid, etc). It mirrors the Summer onboarding rules — see `GEMINI.md` for the same content keyed for Gemini.
+
+## What you're working with
+
+**Summer Engine** is the AI-native game engine the user is building in. Editor, scene graph, asset pipeline, and runtime are all instrumented for programmatic control via the `summer-engine` MCP server. Summer Engine is compatible with Godot 4.5 — projects use GDScript (`.gd`), C# (`.cs`), scenes (`.tscn`/`.scn`), and resources (`.tres`/`.res`). Write code in those languages; talk to the engine through MCP tools.
+
+## Critical rules
+
+1. **Always check for a relevant Summer skill before responding.** Even a 1% chance a skill applies = invoke it. Start with `summer:using-summer` on every fresh Summer Engine session.
+2. **The user owns fix decisions.** Diagnose first, propose, ask, then edit.
+3. **Don't grep the whole project before reading the actual error.** Use `summer_get_script_errors` first.
+4. **Don't edit `.tscn` files directly while the engine is running.** Use the `summer_*` MCP tools — direct edits get overwritten when the editor saves.
+5. **Never call `summer_set_resource_property` against an inline `sub_resource`** — it silently drops the value. Instantiate via `summer_set_prop` with a class-name string first.
+
+## Skill priority
+
+- **Process** (`brainstorm-game`, `debug`, `play`) → how to approach.
+- **Discipline** (`gdscript-patterns`, `scene-composition`, `art-direction`) → how to shape it.
+- **Build** (`fps-controller`, `design-mechanic`, `design-level`, `setup-multiplayer`, `vfx`, `tune-performance`, `export-and-ship`) → produce the artifact.
+
+## MCP tool palette (engine on `localhost:6550`)
+
+37 tools total. Categories:
+
+- Scene: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_open_scene`, `summer_replace_node`, `summer_inspect_node`, `summer_inspect_resource`, `summer_get_scene_tree`, `summer_batch`, `summer_select_node`, `summer_instantiate_scene`, `summer_connect_signal`.
+- Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`.
+- Runtime: `summer_play`, `summer_stop`, `summer_is_running`.
+- Project: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`, `summer_get_agent_playbook`.
+- Assets: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_import_from_url_batch`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
+
+File ops, git, shell, and grep are NOT exposed — use the host's native tools.
+
+## Type-system gotchas
+
+`SetProp` values are engine-formatted strings (Godot type-system compatible), not JSON objects:
+- `"Vector3(0, 10, 0)"`
+- `"Color(1, 0.5, 0, 1)"` (RGBA, 4 components)
+- `"Transform3D(1,0,0, 0,1,0, 0,0,1, 0,5,0)"`
+
+Resources are class names: `"BoxMesh"`, `"StandardMaterial3D"`, `"CapsuleShape3D"`.
+
+## When something is off
+
+| Situation | Action |
+|---|---|
+| MCP tool returns "Summer Engine is not running" | Tell user `summer run`. Continue with non-MCP work. |
+| Skill loads but seems wrong | Re-read it. Skills evolve. |
+| Skill not found | Check `summer skills list`, then `summer setup <agent> --yes`. |
+| Generic engine errors on launch | Run `summer doctor` first — usually reveals auth/port/path issues. |

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to summer-engine will be documented here. Following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
 
+## [2.0.0] — 2026-05-09 — "Superpowers"
+
+The plugin rebrand. Summer is now positioned as superpowers for AI game dev — installable in Claude Code, Codex (CLI + App), Cursor, Factory Droid, Gemini CLI, OpenCode, GitHub Copilot CLI, and Windsurf with one canonical command per harness.
+
+### Added
+- **`summer:using-summer`** meta-skill — establishes workflow priority, red-flag list, and skill-invocation discipline. Auto-loads on session start. Modeled on `superpowers:using-superpowers`.
+- **`summer:debug`** skill — the missing flagship skill. Disciplined script-errors → console → debugger → hypothesize → propose → fix → verify loop. Honors all 4 cases in `_tests/specs/debug.md`.
+- **Manifest validator** (`src/lib/plugin-manifests.test.ts`) — vitest test that walks every plugin manifest and verifies each referenced skill resolves to a real `SKILL.md` on disk. Also enforces the "Use when…" auto-trigger pattern in every skill's description.
+- **`AGENTS.md`** + **`GEMINI.md`** at repo root — context primer for harnesses that read AGENTS-style files (Codex, Factory) and the Gemini extension.
+- **`.opencode/INSTALL.md`** — explicit OpenCode setup guide.
+- **`docs/marketplace-repo/`** — drop-in contents for the separate `SummerEngine/summer-marketplace` repo (Claude marketplace listing).
+- Multiplayer skills (`host-authoritative-state`, `peer-to-peer-multiplayer`) added to all plugin manifests.
+
+### Changed
+- **Brand:** "Summer" replaces "Summer Engine CLI" across all plugin descriptions, READMEs, and orientation banners. The npm package stays `summer-engine` (continuity).
+- **README** rewritten in superpowers-homepage style — install matrix per harness, philosophy section, basic workflow walkthrough.
+- **MCP_STRATEGY.md** updated: documents the deliberate decision to NOT ship file/git/shell/grep tools (host agents have those natively). 37 tools shipped.
+- All 22 user-facing skill descriptions audited and rewritten to lead with "Use when X" for tighter auto-trigger.
+- `.codex-plugin/plugin.json` `longDescription` rewritten — accurate skill count, mentions the host-native tool exclusion.
+- `.opencode/plugins/summer.js` orientation banner updated to 22 skills with explicit process / discipline / build priority.
+
+### Fixed
+- **Critical:** 4 broken skill paths in `.claude-plugin/plugin.json` and `.cursor-plugin/plugin.json`. Plugin install would silently fail for `gdscript-patterns`, `ui-basics`, `asset-strategy`, and `debug` (the latter didn't exist at all). All paths now resolve.
+- 2 missing HAVE-status multiplayer skills now listed in all manifests.
+- TypeScript build excludes `*.test.ts` so `npx tsc` produces clean dist without vitest type leakage.
+
+### Notes for plugin install
+- After v2, `claude /plugin install summer@summer-marketplace` resolves cleanly. The `SummerEngine/summer-marketplace` repo (one-file marketplace) needs to be created and pushed; contents are in `docs/marketplace-repo/`.
+- Existing `1.x` users updating: `npm update -g summer-engine` then `summer setup <agent> --yes` to refresh skill installs.
+
 ## [1.3.2] — 2026-05-05
 
 ### Fixed
@@ -51,7 +81,7 @@ All notable changes to summer-engine will be documented here. Following [Keep a
 - `summer mcp setup <agent>` — idempotent JSON/TOML config writer.
 - Multi-agent skills install (codex, claude-code, cursor, windsurf with user/project scopes; Cursor `.mdc` rule generation; Windsurf rule blocks).
 - Skill registry (`src/lib/skills-registry.ts`) with category metadata.
-- Per-agent docs (AGENT_KIT, CLAUDE_CODE, CODEX, CURSOR, SKILLS, TEMPLATES).
+- Per-agent docs (OVERVIEW, CLAUDE_CODE, CODEX, CURSOR, SKILLS, TEMPLATES).
 
 ### Changed
 - `/api/mcp/assets`: removed Pro gate; public/community asset search now free for all signed-in users (deployed on summerengine.com).

package/CLAUDE.md

@@ -0,0 +1,5 @@
+# Summer — Claude context
+
+This file primes Claude Code on Summer when it loads from this repo. The full agent workflow lives in `skills/_meta/using-summer/SKILL.md`; activate that skill on every fresh session.
+
+@./skills/_meta/using-summer/SKILL.md

package/GEMINI.md

@@ -0,0 +1,56 @@
+# Summer — Context Primer for Gemini
+
+Summer is the AI game-dev studio for **Summer Engine** — the AI-native game engine. When you see this file in a session, it means the user has installed the Summer Gemini extension and you have access to the `summer-engine` MCP server plus 24 skills under the `summer:` namespace.
+
+## What Summer Engine is
+
+A game engine designed for AI agents — editor, scene graph, asset pipeline, and runtime are all instrumented for programmatic control via MCP. Summer Engine is compatible with Godot 4.5: projects use GDScript (`.gd`), C# (`.cs`), scenes (`.tscn`/`.scn`), and resources (`.tres`/`.res`). Write code in those languages; talk to the engine through `summer_*` tools.
+
+## How to behave
+
+**Always check for a relevant Summer skill before writing code or running tools.** Skills encode discipline that matters — debug protocols, scene-composition rules, GDScript idioms Gemini regularly gets wrong. If a skill might apply, even at 1% probability, activate it via `activate_skill`.
+
+The single most important skill to know is `summer:using-summer` — it explains the workflow, priority, and the red-flag table of rationalizations the model needs to resist. Activate it first thing in any Summer Engine session.
+
+## Skill priority
+
+1. **Process skills first**: `brainstorm-game`, `debug`, `play`. These determine HOW.
+2. **Discipline skills second**: `gdscript-patterns`, `scene-composition`, `art-direction`, `audio-direction`. These shape content.
+3. **Build skills third**: `fps-controller`, `design-mechanic`, `design-level`, `setup-multiplayer`, `vfx`, `tune-performance`, `export-and-ship`.
+
+## MCP tools (when the engine is running on `localhost:6550`)
+
+The `summer-engine` MCP server exposes 37 focused tools. The most important:
+
+- **Scene mutation**: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_replace_node`, `summer_batch`.
+- **Scene inspection**: `summer_get_scene_tree`, `summer_inspect_node`, `summer_inspect_resource`.
+- **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`.
+- **Run game**: `summer_play`, `summer_stop`, `summer_is_running`.
+- **Project**: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`.
+- **Assets**: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
+
+File ops (Read/Write/Edit), git, shell, and grep are deliberately **not** exposed via MCP — Gemini already has those natively.
+
+## Type-system traps
+
+`SetProp` values are engine-formatted **strings** (Godot 4.5 type-system compatible):
+
+- `"Vector3(0, 10, 0)"` — NOT `{x: 0, y: 10, z: 0}`.
+- `"Color(1, 0.5, 0, 1)"` — RGBA, 4 components.
+- `"Transform3D(1,0,0, 0,1,0, 0,0,1, 0,5,0)"`.
+
+Resources are class names: `"BoxMesh"`, `"StandardMaterial3D"`, `"CapsuleShape3D"`.
+
+**Trap**: never call `summer_set_resource_property` against an inline `sub_resource` — the value silently drops. Use `summer_set_prop` with a class-name string first to instantiate a standalone resource, then drill in.
+
+## When the engine isn't running
+
+Tools return "Summer Engine is not running." Tell the user to run `summer run` (or open the engine and load the project), then continue with non-MCP work in the meantime. Do NOT fall back to editing `.tscn` files directly — the editor holds in-memory state that diverges from disk.
+
+## Setup help
+
+If skills aren't loading or the MCP server fails:
+
+- `npm install -g summer-engine` — global CLI.
+- `summer setup gemini --yes` — writes the right MCP config.
+- `summer doctor` — reports auth, engine, port, skill state.