@loonylabs/create-game 0.1.0

package/bin/create-game.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+/**
+ * create-game.js — Scaffold a new game project from @loonylabs/create-game templates.
+ *
+ * Usage:
+ *   npx @loonylabs/create-game <game-name> <target-dir>
+ *
+ * Example:
+ *   npx @loonylabs/create-game shadow-dungeon ~/Desktop/shadow-dungeon
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+const FRAMEWORK_VERSION = '0.1.0';
+
+// ─── Args ────────────────────────────────────────────────────────────────────
+
+const [, , gameName, targetDir] = process.argv;
+
+if (!gameName || !targetDir) {
+  console.error('Usage: npx @loonylabs/create-game <game-name> <target-dir>');
+  process.exit(1);
+}
+
+const target = path.resolve(targetDir);
+const gameDataPackage = `@${gameName}/game-data`;
+
+if (fs.existsSync(target)) {
+  console.error(`Error: Target directory already exists: ${target}`);
+  process.exit(1);
+}
+
+console.log(`\n🎮 Creating game project: ${gameName}`);
+console.log(`   Target: ${target}\n`);
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+const SKIP_DIRS = new Set(['node_modules', 'dist', '.turbo', '.git']);
+
+function copyDir(src, dest, transformFn = null) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (SKIP_DIRS.has(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    const stat = fs.statSync(srcPath);
+    if (stat.isDirectory()) {
+      copyDir(srcPath, destPath, transformFn);
+    } else if (stat.isFile()) {
+      let content = fs.readFileSync(srcPath);
+      if (transformFn && (srcPath.endsWith('.json') || srcPath.endsWith('.ts') || srcPath.endsWith('.js') || srcPath.endsWith('.md') || srcPath.endsWith('.svelte') || srcPath.endsWith('.html'))) {
+        content = Buffer.from(transformFn(content.toString(), srcPath));
+      }
+      fs.writeFileSync(destPath, content);
+    }
+  }
+}
+
+function writeJson(filePath, obj) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\n');
+}
+
+function writeText(filePath, text) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, text);
+}
+
+// ─── Step 1: Root config files ───────────────────────────────────────────────
+
+console.log('📁 Creating project structure...');
+
+writeJson(path.join(target, 'package.json'), {
+  name: gameName,
+  private: true,
+  type: 'module',
+  scripts: {
+    dev: 'turbo dev --ui=stream',
+    build: 'turbo build',
+    test: 'turbo test',
+  },
+  packageManager: 'pnpm@10.30.2',
+  devDependencies: {
+    turbo: 'latest',
+    typescript: '^5.0.0',
+  },
+  engines: { node: '>=18.0.0', pnpm: '>=8.0.0' },
+  pnpm: { onlyBuiltDependencies: ['better-sqlite3', 'esbuild'] },
+});
+
+writeText(path.join(target, 'pnpm-workspace.yaml'), 'packages:\n  - \'apps/*\'\n');
+
+writeJson(path.join(target, 'turbo.json'), {
+  $schema: 'https://turbo.build/schema.json',
+  tasks: {
+    build: { dependsOn: ['^build'], outputs: ['dist/**'] },
+    dev: { persistent: true, cache: false },
+    test: { dependsOn: ['^build'] },
+  },
+});
+
+writeText(path.join(target, '.gitignore'),
+  'node_modules/\ndist/\n.turbo/\n*.db\n*.db-shm\n*.db-wal\n');
+
+writeText(path.join(target, '.npmrc'),
+  'public-hoist-pattern[]=@loonylabs/*\n');
+
+// ─── Step 2: game-data app ───────────────────────────────────────────────────
+
+console.log('📦 Copying game-data...');
+
+copyDir(
+  path.join(TEMPLATE_DIR, 'apps', 'game-data', 'src'),
+  path.join(target, 'apps', 'game-data', 'src')
+);
+
+writeJson(path.join(target, 'apps', 'game-data', 'package.json'), {
+  name: gameDataPackage,
+  version: '0.1.0',
+  type: 'module',
+  private: true,
+  exports: { '.': './src/index.ts' },
+  dependencies: {
+    '@loonylabs/gamedev-core': FRAMEWORK_VERSION,
+  },
+});
+
+// ─── Step 3: client app ──────────────────────────────────────────────────────
+
+console.log('🖥️  Copying client app...');
+
+function transformClientDeps(content, filePath) {
+  if (!filePath.endsWith('package.json')) return content;
+  const pkg = JSON.parse(content);
+  if (pkg.dependencies?.['@loonylabs/game-data']) {
+    pkg.dependencies[gameDataPackage] = 'workspace:*';
+    delete pkg.dependencies['@loonylabs/game-data'];
+  }
+  for (const key of ['@loonylabs/gamedev-core', '@loonylabs/gamedev-client', '@loonylabs/gamedev-server', '@loonylabs/gamedev-protocol']) {
+    if (pkg.dependencies?.[key]) pkg.dependencies[key] = FRAMEWORK_VERSION;
+    if (pkg.devDependencies?.[key]) pkg.devDependencies[key] = FRAMEWORK_VERSION;
+  }
+  return JSON.stringify(pkg, null, 2) + '\n';
+}
+
+function transformImports(content, filePath) {
+  if (filePath.endsWith('package.json')) return transformClientDeps(content, filePath);
+  let result = content;
+  result = result.replaceAll('gamedev-ai-toolkit', gameName);
+  result = result.replaceAll('@loonylabs/game-data', gameDataPackage);
+  result = result.replace(/['"](?:\.\.\/)+packages\/core\/src\/[^'"]+['"]/g, "'@loonylabs/gamedev-core'");
+  result = result.replace(/['"](?:\.\.\/)+packages\/server\/src\/[^'"]+['"]/g, "'@loonylabs/gamedev-server'");
+  result = result.replace(/['"](?:\.\.\/)+packages\/client\/src\/[^'"]+['"]/g, "'@loonylabs/gamedev-client'");
+  return result;
+}
+
+copyDir(
+  path.join(TEMPLATE_DIR, 'apps', 'client'),
+  path.join(target, 'apps', 'client'),
+  transformImports
+);
+
+// ─── Step 4: server app ──────────────────────────────────────────────────────
+
+console.log('🖥️  Copying server app...');
+
+copyDir(
+  path.join(TEMPLATE_DIR, 'apps', 'server'),
+  path.join(target, 'apps', 'server'),
+  transformImports
+);
+
+// ─── Step 4b: experiences ────────────────────────────────────────────────────
+
+console.log('🗺️  Copying experiences...');
+
+copyDir(
+  path.join(TEMPLATE_DIR, 'apps', 'experiences'),
+  path.join(target, 'apps', 'experiences'),
+  transformImports
+);
+
+// ─── Step 5: aigdtk skills ───────────────────────────────────────────────────
+
+console.log('🤖 Copying aigdtk skills...');
+
+const skillsToCopy = ['aigdtk-new-game', 'aigdtk-create-game-stories', 'aigdtk-implement-game-stories', 'aigdtk-shared'];
+for (const skill of skillsToCopy) {
+  const src = path.join(TEMPLATE_DIR, '.claude', 'skills', skill);
+  if (fs.existsSync(src)) {
+    copyDir(src, path.join(target, '.claude', 'skills', skill));
+  }
+}
+
+// ─── Done ────────────────────────────────────────────────────────────────────
+
+console.log(`
+✅ Game project created: ${gameName}
+
+Next steps:
+  cd ${target}
+  pnpm install
+  pnpm dev
+
+Then open http://localhost:3200 in your browser.
+
+To start building your game with AI:
+  /aigdtk-new-game
+`);

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@loonylabs/create-game",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-game": "./bin/create-game.js"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/template/.claude/skills/aigdtk-create-game-stories/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: aigdtk-create-game-stories
+description: Creates implementation-ready game stories from a saved Game Brief. Run after /aigdtk-new-game in a new session.
+disable-model-invocation: true
+---
+
+# Create Game Stories
+
+## Supporting files (shared knowledge base)
+- Framework reference: [../aigdtk-shared/framework.md](../aigdtk-shared/framework.md)
+- ASCII room grammar: [../aigdtk-shared/ascii-grammar.md](../aigdtk-shared/ascii-grammar.md)
+- Enemy definitions reference: [../aigdtk-shared/enemies.md](../aigdtk-shared/enemies.md)
+- Cell visuals / palettes: [../aigdtk-shared/visuals.md](../aigdtk-shared/visuals.md)
+
+<activation CRITICAL="TRUE">
+You are now in game story generation mode. Your role is **technical architect**.
+You translate a developer's game vision into implementation-ready stories.
+
+## NON-NEGOTIABLE RULES
+
+1. **NEVER ask technical questions** to the developer.
+2. **NEVER ask the developer to make technical decisions.** You decide everything.
+3. **Ask only if something is genuinely ambiguous about the game vision** — and only
+   product-level questions (e.g. "Should the second area feel like an overworld or
+   another dungeon?"), never technical ones.
+4. **Generate complete, ready-to-implement stories** — no placeholders, no TODOs
+   in acceptance criteria, no "TBD" in technical specs.
+
+---
+
+## STEP 1 — Read the Game Brief
+
+Read `docs/aigdtk/game-brief.md` now.
+
+If the file does not exist, stop and tell the developer:
+> "Kein Game Brief gefunden. Bitte starte zuerst mit `/aigdtk-new-game`."
+
+---
+
+## STEP 2 — Read framework reference and derive area type
+
+Read `../aigdtk-shared/framework.md`.
+
+From the Game Brief's Core Loop and Happy When, decide:
+- **Area type**: `dungeon` (room-based exploration/combat) or `voxel` (open world) or both
+- **Number of rooms**: 2–3 minimal, 4–6 if the Happy When demands more variety
+- **Number of enemy types**: 1 base + 1–2 variants minimum
+
+Do NOT ask — decide.
+
+---
+
+## STEP 3 — Read enemy reference and derive enemy definitions
+
+Read `../aigdtk-shared/enemies.md`.
+
+Generate complete enemy stats for:
+- The enemy described in the Game Brief (map description to archetype)
+- 1–2 additional variants (one easier, one harder — or a boss if Happy When mentions it)
+
+Derive color from description keywords using the color table in enemies.md.
+
+---
+
+## STEP 4 — Read ASCII grammar and plan rooms
+
+Read `../aigdtk-shared/ascii-grammar.md`.
+
+Plan the room set:
+- 1 start room (with `S`, `tags: ["start"]`)
+- 1–2 combat rooms with doors
+- 1 special room if Happy When mentions a goal (boss, loot, exit)
+
+Draft the ASCII layouts mentally — they go in the stories.
+
+---
+
+## STEP 5 — Read visuals reference and derive palette
+
+Read `../aigdtk-shared/visuals.md`.
+
+Pick or compose a color palette that fits the reference game + enemy description.
+Derive all 7 `GameCellType` colors and heights. Do not leave any unset.
+
+---
+
+## STEP 6 — Derive story prefix
+
+From the game name, derive a short prefix:
+- Take first letter of each word, lowercase
+- Examples: "Shadow Dungeon" → `sd`, "Bone Crawler" → `bc`, "The Last Keeper" → `tlk`
+- If the result is less than 2 chars, use first 2–3 letters of the first word
+
+---
+
+## STEP 7 — Write the stories
+
+Write 2–3 stories to `docs/stories/`.
+**Do NOT read any existing files in `docs/stories/`.**
+
+Use `story-template.md` (in this skill's directory) as the format reference.
+Read it now and follow it exactly for every story you write.
+
+### Story 1: `[prefix]01_enemies-and-visuals.md`
+
+**Scope**: Generate and write `enemy-defs.json` + `cell-visuals.ts`
+
+Technical spec must include:
+- Complete `enemy-defs.json` array with all enemy objects (filled, not placeholder)
+- Complete `cell-visuals.ts` with all 7 cell types and derived colors/heights
+
+Task list:
+- [ ] Write `apps/game-data/src/enemies/enemy-defs.json`
+- [ ] Write `apps/game-data/src/dungeon/cell-visuals.ts`
+- [ ] Run `pnpm test:changed` — all green
+- [ ] Lessons Learned ausfüllen
+- [ ] Handover für Story 2 schreiben
+
+### Story 2: `[prefix]02_rooms-and-areas.md`
+
+**Scope**: Generate and write `room_*.json` files + `area-manifest.json`
+
+Technical spec must include:
+- All planned room files with complete ASCII layouts (filled, valid per ascii-grammar.md rules)
+- Complete `area-manifest.json` with correct area type
+
+Task list:
+- [ ] Write `apps/game-data/src/rooms/room_start.json`
+- [ ] Write `apps/game-data/src/rooms/room_combat.json` (and others if planned)
+- [ ] Write `apps/game-data/src/areas/area-manifest.json`
+- [ ] Run `pnpm test:changed` — all green
+- [ ] Run `pnpm dev` und prüfen ob Welt sichtbar ist
+- [ ] Lessons Learned ausfüllen
+- [ ] Handover schreiben (oder "Fertig" wenn keine weitere Story)
+
+### Story 3 (optional): `[prefix]03_[topic].md`
+
+Only create if the developer's "Happy When" requires it (e.g. boss room, second area, transitions).
+
+---
+
+## STEP 8 — Update Derived Decisions in Game Brief
+
+Append to the `## Derived Decisions` section of `docs/aigdtk/game-brief.md`:
+
+```markdown
+## Derived Decisions
+
+_Filled by /aigdtk-create-game-stories_
+
+- **Area type:** [dungeon / voxel / both]
+- **Color palette:** [mood name]
+- **Enemy archetypes:** [list]
+- **Rooms planned:** [count + types]
+- **Story prefix:** [prefix]
+- **Stories created:** [prefix]01, [prefix]02, ...
+```
+
+---
+
+## STEP 9 — Handover message
+
+Output:
+
+```
+✅ [N] Stories erstellt unter docs/stories/
+
+- [prefix]01_enemies-and-visuals.md
+- [prefix]02_rooms-and-areas.md
+[- prefix03_... falls erstellt]
+
+Starte eine neue Claude Code Session und führe aus:
+
+/aigdtk-implement-game-stories docs/stories/[prefix]01_enemies-and-visuals.md docs/stories/[prefix]02_rooms-and-areas.md
+```
+
+</activation>

package/template/.claude/skills/aigdtk-create-game-stories/story-template.md

@@ -0,0 +1,85 @@
+# Story [N]: [Title]
+
+**Feature**: [Feature Name]
+**Type**: New Feature
+**Estimated Effort**: 1 Session (~3-4h)
+**Dependencies**: Story [N-1] or "None"
+
+---
+
+## Context & Background
+
+### The Problem
+[1-2 sentences: what is missing or broken]
+
+### The Solution
+[1-2 sentences: what this story builds]
+
+---
+
+## Acceptance Criteria
+
+### ✅ Definition of Done
+
+#### [Category, e.g. Enemies]
+- [ ] [Concrete, verifiable criterion]
+- [ ] [Concrete, verifiable criterion]
+
+#### [Category, e.g. Visuals]
+- [ ] [Concrete, verifiable criterion]
+
+---
+
+## Technical Specification
+
+### [File: path/to/file.json]
+
+```json
+// Complete file contents — no placeholders
+```
+
+### [File: path/to/file.ts]
+
+```typescript
+// Complete file contents — no placeholders
+```
+
+---
+
+## Task List
+
+- [ ] Write [file 1]
+- [ ] Write [file 2]
+- [ ] Run `pnpm test:changed` — all green
+- [ ] **Lessons Learned ausfüllen**
+- [ ] **Handover für Follow-up Story schreiben**
+
+---
+
+## Lessons Learned
+
+<!-- FILL IN AFTER IMPLEMENTATION -->
+
+### What went well
+
+### Architecture decisions
+
+### Important files created/changed
+
+### Open items for follow-up
+
+---
+
+## Handover for Follow-up Story
+
+<!-- FILL IN AFTER IMPLEMENTATION -->
+
+### Context Summary
+
+### Relevant files to read
+
+### Start prompt for next story
+
+---
+
+**End of Story [N]**

package/template/.claude/skills/aigdtk-implement-game-stories/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: aigdtk-implement-game-stories
+description: Implements game stories generated by /aigdtk-create-game-stories. Pass story file paths as arguments.
+disable-model-invocation: true
+---
+
+# Implement Game Stories
+
+$ARGUMENTS
+
+---
+
+<activation CRITICAL="TRUE">
+You are now in game implementation mode. Your role is **developer executing stories**.
+Implement exactly ONE story per session. Stop after completing it.
+
+## SETUP — Branch check
+
+Check the current git branch. If on `master` or `main`:
+- Create a new branch: `git checkout -b game/[game-name]-implementation`
+- Tell the developer which branch was created
+
+---
+
+## STEP 1 — Read all stories
+
+Read ALL story files passed as arguments in `$ARGUMENTS` completely:
+- Read every section including Lessons Learned and Handover (may contain prior context)
+- Note which tasks are already checked off
+- Identify the **first story with incomplete tasks** — that is the one to implement
+
+If no story files are passed, look for story files in `docs/stories/` that match a game prefix
+(non-`ng` and non-`cb` prefixes). If ambiguous, ask the developer which to implement.
+
+---
+
+## STEP 2 — Implement the story
+
+Implement **only the identified story** — do not touch the next story.
+
+During implementation:
+- Check off each task in the story file as you complete it (`- [ ]` → `- [x]`)
+- All game content files go into `apps/game-data/src/` — never anywhere else
+- Do not modify framework code (`packages/`, `apps/client/`, `apps/server/`, `apps/protocol/`)
+- Use the technical spec in the story as the source of truth for file contents
+
+### Game content file locations
+
+| Content | Path |
+|---------|------|
+| Enemy definitions | `apps/game-data/src/enemies/enemy-defs.json` |
+| Room files | `apps/game-data/src/rooms/room_*.json` |
+| Area manifest | `apps/game-data/src/areas/area-manifest.json` |
+| Cell visuals | `apps/game-data/src/dungeon/cell-visuals.ts` |
+
+---
+
+## STEP 3 — Run tests
+
+Run: `pnpm test:changed`
+
+- If all green: proceed to commit
+- If tests fail: fix the issue first, then re-run. Do not commit with failing tests.
+
+---
+
+## STEP 4 — Commit
+
+Create a commit with:
+```
+feat([game-name]): implement [story name] — [short description]
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
+```
+
+---
+
+## STEP 5 — Fill in Lessons Learned and Handover
+
+In the story file, fill in:
+
+### Lessons Learned
+- What went well
+- Architecture decisions (with reasoning)
+- Technical debt or workarounds
+- Important files created/changed
+
+### Handover for Follow-up Story
+- Context summary (2–3 sentences)
+- Relevant files to read
+- Start prompt for next story (copy-paste ready `/aigdtk-implement-game-stories [next-path]`)
+
+---
+
+## STEP 6 — Completion report
+
+Output a compact report:
+
+```
+## Story abgeschlossen: [Story Name]
+
+**Was wurde gebaut:**
+- [Punkt 1]
+- [Punkt 2]
+- [Punkt 3]
+
+**Geänderte Dateien:**
+- [Datei 1]
+- [Datei 2]
+
+**Tests:** pnpm test:changed — ✅ alle grün
+**Commit:** [commit hash / message]
+
+**Manuell testen:**
+pnpm dev → http://localhost:5173
+[Was der Dev konkret prüfen soll]
+
+**Nächste Story:**
+/aigdtk-implement-game-stories [next-story-path]
+```
+
+---
+
+## STEP 7 — STOP
+
+**Stop here.** Do NOT implement the next story automatically.
+The developer decides when and whether to continue.
+
+</activation>