diwad-code · diwad-code · May 23, 2026 · May 23, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -103,13 +103,13 @@ Do not block MVP on broad coverage targets.
 
 ## Copilot workflow
 
-- Use `/prompt-game-dev` for project orchestration.
-- Use `/prompt-new-scene` for Phaser scenes.
-- Use `/prompt-new-system` for systems.
-- Use `/prompt-new-event` for event data.
-- Use `/prompt-data-schema` for JSON + Zod models.
-- Use `/prompt-pwa-check` before mobile testing.
-- Use `/prompt-mobile-ux` for phone/tablet UI review.
-- Use `/prompt-code-review` after implementation chunks.
-
-`/prompt-game-dev` is a custom project prompt file, not a built-in Copilot command.
+- Use `/game-dev` for project orchestration.
+- Use `/new-scene` for Phaser scenes.
+- Use `/new-system` for systems.
+- Use `/new-event` for event data.
+- Use `/data-schema` for JSON + Zod models.
+- Use `/pwa-check` before mobile testing.
+- Use `/mobile-ux` for phone/tablet UI review.
+- Use `/code-review` after implementation chunks.
+
+These custom slash commands come from the `name:` field in each file under `.github/prompts/`.
diff --git a/.github/prompts/code-review.prompt.md b/.github/prompts/code-review.prompt.md
@@ -8,7 +8,7 @@ tools:
   - read/problems
 ---
 
-# /prompt-code-review
+# /code-review
 
 Review the current changes for SpaceshipGame.
 

diff --git a/.github/prompts/data-schema.prompt.md b/.github/prompts/data-schema.prompt.md
@@ -10,7 +10,7 @@ tools:
   - execute/runTests
 ---
 
-# /prompt-data-schema
+# /data-schema
 
 Create or update the data schema for: `${input:schemaName}`.
 

diff --git a/.github/prompts/game-dev.prompt.md b/.github/prompts/game-dev.prompt.md
@@ -11,7 +11,7 @@ tools:
   - execute/runTests
 ---
 
-# /prompt-game-dev
+# /game-dev
 
 You are the project orchestrator for SpaceshipGame.
 

diff --git a/.github/prompts/mobile-ux.prompt.md b/.github/prompts/mobile-ux.prompt.md
@@ -8,7 +8,7 @@ tools:
   - read/problems
 ---
 
-# /prompt-mobile-ux
+# /mobile-ux
 
 Review the current UI for mobile and tablet usability.
 

diff --git a/.github/prompts/new-event.prompt.md b/.github/prompts/new-event.prompt.md
@@ -9,7 +9,7 @@ tools:
   - read/problems
 ---
 
-# /prompt-new-event
+# /new-event
 
 Create a new event for theme: `${input:theme}`.
 

diff --git a/.github/prompts/new-scene.prompt.md b/.github/prompts/new-scene.prompt.md
@@ -9,7 +9,7 @@ tools:
   - read/problems
 ---
 
-# /prompt-new-scene
+# /new-scene
 
 Create or update a Phaser 4 scene for: `${input:sceneName}`.
 

diff --git a/.github/prompts/new-system.prompt.md b/.github/prompts/new-system.prompt.md
@@ -10,7 +10,7 @@ tools:
   - execute/runTests
 ---
 
-# /prompt-new-system
+# /new-system
 
 Create or update a game system for: `${input:systemName}`.
 

diff --git a/.github/prompts/pwa-check.prompt.md b/.github/prompts/pwa-check.prompt.md
@@ -9,7 +9,7 @@ tools:
   - execute/runInTerminal
 ---
 
-# /prompt-pwa-check
+# /pwa-check
 
 Audit the project for PWA readiness.
 

diff --git a/.github/prompts/skills-adoption.prompt.md b/.github/prompts/skills-adoption.prompt.md
@@ -11,7 +11,7 @@ tools:
   - execute/runTests
 ---
 
-# /prompt-skills-adoption
+# /skills-adoption
 
 Autonomously execute the approved skills and MCP adoption plan for SpaceshipGame.
 

diff --git a/README.md b/README.md
@@ -23,7 +23,7 @@ Pre-initialization / Sprint 0. No production code has been scaffolded yet. The `
 - `docs/ARCHITECTURE.md` — approved architecture and integration points for future mechanics.
 - `docs/SCOPE.md` — what is and is not in the MVP.
 - `docs/IDEAS_LATER.md` — deferred ideas and scope-control list.
-- `docs/COPILOT_WORKFLOW.md` — natural-language guide for using `/prompt-game-dev`, `/prompt-new-scene`, `/prompt-new-system`, and related prompts.
+- `docs/COPILOT_WORKFLOW.md` — natural-language guide for using `/game-dev`, `/new-scene`, `/new-system`, and related prompts.
 - `docs/ADRs/ADR-001-stack.md` — stack decision record.
 - `SKILLS_RECOMMENDATIONS.txt` — curated good-plus set of recommended skills and MCP servers for the repo.
 - `docs/skills-adoption/README.md` — expanded research and adoption order for skills/MCP rollout.
@@ -35,7 +35,17 @@ Pre-initialization / Sprint 0. No production code has been scaffolded yet. The `
 
 Use the project Copilot assets first, then scaffold the codebase:
 
-1. Run `/prompt-game-dev` in Copilot Chat after opening this folder in VS Code.
-2. Let it verify project foundations.
-3. Use `/prompt-skills-adoption` when you want the agent to execute the approved skills/MCP rollout from the research docs.
-4. Scaffold the Vite + Phaser project only after the documentation and `.github/` assets are in place.
+1. Open this folder in VS Code with GitHub Copilot Chat enabled.
+2. Use the custom prompt slash commands that match each prompt file `name:` field:
+   - `/game-dev` — check repo state and ask for the next 1-3 steps
+   - `/skills-adoption` — execute the approved skills/MCP rollout from the research docs
+   - `/new-scene`, `/new-system`, `/new-event`, `/data-schema`, `/pwa-check`, `/mobile-ux`, `/code-review`
+3. Start with `/game-dev`, let it verify project foundations, and only scaffold the Vite + Phaser project after the documentation and `.github/` assets are in place.
+4. Because this repository is still in Sprint 0, there is no `package.json`, no `src/`, and no runnable npm command yet.
+
+## If the slash commands do not appear
+
+1. Make sure you opened the repository root in VS Code, not a parent folder.
+2. Confirm the prompt files exist in `.github/prompts/`.
+3. Use the command names above without the `prompt-` prefix, because Copilot takes the slash command name from each prompt file's `name:` field.
+4. If VS Code still does not list them, reload the window and try again; as a fallback, open the matching file in `.github/prompts/` and paste its instructions into chat manually.
diff --git a/SKILLS_RECOMMENDATIONS.txt b/SKILLS_RECOMMENDATIONS.txt
@@ -284,4 +284,4 @@ If we want a stronger non-minimum stack for this repo, the best direction is:
 2. Add authoring support next: skill-creator, content-research-writer, changelog-generator.
 3. Add Phaser- and UI-aligned MCPs next: Phaser MCP, Phaser Editor MCP Server, Figma MCP Server.
 4. Add testing/CI/PWA delivery support as soon as the app and workflows actually exist.
-5. Use docs/skills-adoption/README.md plus /prompt-skills-adoption as the autonomous adoption mechanism for executing this order.
+5. Use docs/skills-adoption/README.md plus /skills-adoption as the autonomous adoption mechanism for executing this order.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
@@ -39,6 +39,7 @@ SpaceshipGame/
 │   │   └── mobile-ux.instructions.md
 │   ├── prompts/
 │   │   ├── game-dev.prompt.md
+│   │   ├── skills-adoption.prompt.md
 │   │   ├── new-scene.prompt.md
 │   │   ├── new-system.prompt.md
 │   │   ├── new-event.prompt.md
@@ -70,7 +71,6 @@ SpaceshipGame/
 │   ├── models/
 │   ├── scenes/
 │   ├── systems/
-│   ├── state/
 │   ├── storage/
 │   ├── ui/
 │   ├── types/
@@ -82,6 +82,8 @@ SpaceshipGame/
 
 ## Source of truth order
 
+Custom Copilot slash commands come from each prompt file `name:` field, so the active commands are `/game-dev`, `/skills-adoption`, `/new-scene`, `/new-system`, `/new-event`, `/data-schema`, `/pwa-check`, `/mobile-ux`, and `/code-review`.
+
 When documents overlap, resolve conflicts in this order:
 
 1. `mechanika/` for final gameplay mechanics.