summer-engine 1.5.0 → 2.0.0

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.0.0",
+  "description": "Superpowers for AI game dev. 24 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,33 @@
     "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/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/"
   ],
   "hooks": "./hooks/hooks.json",
   "mcpServers": "./.mcp.json",

package/.codex-plugin/plugin.json

@@ -1,26 +1,54 @@
 {
   "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.0.0",
+  "description": "Superpowers for AI game dev. 24 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/vfx/",
+    "./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/"
+  ],
   "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. 24 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 — 37 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 +58,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.0.0",
+  "description": "Superpowers for AI game dev. 24 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,33 @@
   ],
   "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/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/"
   ],
   "hooks": "./hooks/hooks-cursor.json",
   "mcpServers": "./.mcp.json"

package/.opencode/INSTALL.md

@@ -0,0 +1,69 @@
+# 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/plugins/summer.js"
+  ]
+}
+```
+
+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 }) => {

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).