ivx-game-design-studio

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Game Design Studio

## Overview

The Game Design Studio provides structured design workflows adapted from professional game development practices. It combines 15 document templates, AI-assisted brainstorming via `IVXAIContentGenerator`, design review checklists, systems dependency mapping, and a **Starter Project Generator** that outputs a fully-wired, runnable "Hello IntelliVerseX" game for any of the 11 supported engines. Every IVX game gets a design-first workflow that scales from solo developers to teams.

```
Brainstorm → Game Concept → Systems Map → Per-System GDD → Design Review → Engine Selection
    │              │              │              │               │              │
    ▼              ▼              ▼              ▼               ▼              ▼
 AI Assist    Concept Doc    Systems Index   GDD Sections    8-Point Check  Starter Project
                                                                                │
                                                                 ┌──────────────┼──────────────┐
                                                                 ▼              ▼              ▼
                                                            Auth + Login   Economy + Store  Retention
                                                            Hiro Systems   Satori Flags    Engagement
                                                            Leaderboards   Multiplayer     AI Features
```

---

## 1. Design Frameworks

### MDA Framework

Every game design starts with the MDA (Mechanics, Dynamics, Aesthetics) framework:

| Layer | Definition | Example (Trivia Game) |
|-------|-----------|----------------------|
| **Aesthetics** | The emotional experience players have | Challenge, Fellowship, Discovery |
| **Dynamics** | Emergent behavior from mechanics | Time pressure creates excitement |
| **Mechanics** | The formal rules and systems | Question timer, scoring, lifelines |

### Self-Determination Theory

Player motivation analysis through three needs:

| Need | Design Application | Example |
|------|-------------------|---------|
| **Autonomy** | Meaningful choices | Category selection, difficulty preference |
| **Competence** | Achievable mastery | Progressive difficulty, skill-based scoring |
| **Relatedness** | Social connection | Multiplayer, leaderboards, friend challenges |

### Bartle Player Types

Audience targeting for feature prioritization:

| Type | Motivated By | Features |
|------|-------------|----------|
| **Achiever** | Completion, mastery | Achievements, progression, collectibles |
| **Explorer** | Discovery, knowledge | Content variety, hidden features, lore |
| **Socializer** | Relationships | Chat, guilds, cooperative play |
| **Killer** | Competition | PvP, leaderboards, ranking |

---

## 2. Document Templates

### Available Templates

| Template | File | Purpose |
|----------|------|---------|
| **Game Concept** | `design/gdd/game-concept.md` | Initial vision, core loop, pillars |
| **Game Design Document** | `design/gdd/{system}-gdd.md` | Per-system detailed design |
| **Systems Index** | `design/gdd/systems-index.md` | All systems with dependencies |
| **Economy Model** | `design/gdd/economy-model.md` | Currency flows, pricing, balance |
| **Level Design Doc** | `design/gdd/level-design.md` | Level structure, pacing, difficulty |
| **Narrative Design** | `design/gdd/narrative.md` | Story, characters, dialog |
| **Art Bible** | `design/art-bible.md` | Visual style, color palette, reference |
| **Sound Bible** | `design/sound-bible.md` | Audio style, music, SFX |
| **Technical Design** | `docs/architecture/tdd-{feature}.md` | Architecture, data flow, APIs |
| **Pitch Document** | `design/pitch.md` | Investor/publisher pitch |
| **Faction Design** | `design/gdd/factions.md` | Faction mechanics, progression |
| **Character Sheet** | `design/gdd/characters/{name}.md` | Character stats, abilities, lore |
| **Test Plan** | `docs/quality/test-plan.md` | QA strategy, test matrix |
| **Post-Mortem** | `docs/post-mortem.md` | Retrospective analysis |
| **Sprint Plan** | `production/sprints/sprint-{n}.md` | Sprint goals, tasks, estimates |

### Creating Documents from Templates

```csharp
using IntelliVerseX.Design;

await IVXDesignAssistant.Instance.CreateFromTemplateAsync(
    template: DesignTemplate.GameConcept,
    outputPath: "design/gdd/game-concept.md"
);
```

---

## 3. AI-Assisted Brainstorming

### IVXDesignAssistant

Uses `IVXAIContentGenerator` to help with design workflows:

```csharp
using IntelliVerseX.Design;

var concepts = await IVXDesignAssistant.Instance.BrainstormAsync(new BrainstormRequest
{
    Genre = "casual trivia",
    TargetAudience = "mobile, ages 18-45",
    SessionLength = "5-10 minutes",
    Monetization = "F2P with ads and IAP",
    Constraints = new[] { "single developer", "3 month timeline" },
    Count = 3,
});

foreach (var concept in concepts)
{
    Debug.Log($"--- {concept.Title} ---");
    Debug.Log($"Core Loop: {concept.CoreLoop}");
    Debug.Log($"Hook: {concept.Hook}");
    Debug.Log($"Pillars: {string.Join(", ", concept.Pillars)}");
}
```

From intelli-verse-x/Intelli-verse-X-SDK, MIT.

More from intelli-verse-x/Intelli-verse-X-SDK