@bmad/bmad-game-dev-studio 0.1.4

package/src/workflows/3-technical/game-architecture/decision-catalog.yaml

@@ -0,0 +1,340 @@
+# Decision Catalog - Composability knowledge for game architectural decisions
+# This provides RELATIONSHIPS and WORKFLOW LOGIC, not generic tech knowledge
+#
+# ⚠️ CRITICAL: All version/feature info MUST be verified via WebSearch during workflow
+# This file only provides: triggers, relationships (pairs_with), and opinionated stacks
+
+decision_categories:
+  game_engine:
+    triggers: ["engine", "framework", "game framework", "renderer", "runtime"]
+    importance: "critical"
+    affects: "all epics"
+    options:
+      unity:
+        pairs_with: ["C#", "URP", "HDRP", "Unity Input System", "Addressables", "Unity Gaming Services"]
+      unreal:
+        pairs_with: ["C++", "Blueprints", "Nanite", "Lumen", "Enhanced Input", "Unreal Online Subsystem"]
+      godot:
+        pairs_with: ["GDScript", "C#", "GDExtension", "Godot Physics", "GodotSteam"]
+      phaser:
+        pairs_with: ["JavaScript", "TypeScript", "Matter.js", "Arcade Physics"]
+      bevy:
+        pairs_with: ["Rust", "ECS", "wgpu"]
+      monogame:
+        pairs_with: ["C#", "FNA", "FMOD"]
+
+  rendering_pipeline:
+    triggers: ["graphics", "rendering", "shaders", "visual style", "art style", "2D", "3D", "pixel art"]
+    importance: "critical"
+    affects: "all visual epics"
+    options:
+      unity_urp:
+        pairs_with: ["Unity", "Shader Graph", "2D Renderer", "mobile targets"]
+      unity_hdrp:
+        pairs_with: ["Unity", "Shader Graph", "ray tracing", "high-end PC/console"]
+      unreal_nanite_lumen:
+        pairs_with: ["Unreal", "virtual geometry", "global illumination", "high-end PC/console"]
+      unreal_forward:
+        pairs_with: ["Unreal", "mobile", "VR", "stylized rendering"]
+      godot_vulkan:
+        pairs_with: ["Godot", "Forward+", "mid-range hardware"]
+      godot_compatibility:
+        pairs_with: ["Godot", "OpenGL", "mobile", "web export"]
+      custom_2d:
+        pairs_with: ["Phaser", "SDL", "sprite batching", "pixel art"]
+
+  physics_system:
+    triggers: ["physics", "collision", "rigid body", "character controller", "raycasting", "platformer movement"]
+    importance: "high"
+    affects: "gameplay and movement epics"
+    options:
+      engine_native:
+        pairs_with: ["PhysX (Unity)", "Chaos (Unreal)", "Godot Physics"]
+      jolt:
+        pairs_with: ["Godot (Jolt plugin)", "custom engines"]
+      box2d:
+        pairs_with: ["2D games", "Godot", "Phaser (Matter.js alternative)"]
+      custom_controller:
+        pairs_with: ["platformers", "raycasting", "kinematic bodies"]
+      deterministic:
+        pairs_with: ["rollback netcode", "fixed-point math", "lockstep multiplayer"]
+
+  audio_system:
+    triggers: ["audio", "music", "sound effects", "SFX", "adaptive music", "spatial audio", "voice"]
+    importance: "medium"
+    affects: "audio and ambiance epics"
+    options:
+      engine_native:
+        pairs_with: ["Unity Audio", "Unreal MetaSounds", "Godot AudioStreamPlayer"]
+      fmod:
+        pairs_with: ["Unity", "Unreal", "Godot (via plugin)", "adaptive music", "large projects"]
+      wwise:
+        pairs_with: ["Unity", "Unreal", "AAA projects", "spatial audio", "large sound libraries"]
+
+  networking:
+    triggers: ["multiplayer", "online", "netcode", "co-op", "PvP", "lobby", "matchmaking", "dedicated server"]
+    importance: "critical"
+    affects: "all multiplayer epics"
+    options:
+      unity_netcode:
+        pairs_with: ["Unity", "Netcode for GameObjects", "Unity Relay", "Unity Lobby"]
+      photon:
+        pairs_with: ["Unity", "Photon Fusion", "Photon Quantum", "Photon Voice"]
+      mirror:
+        pairs_with: ["Unity", "open source", "server authoritative"]
+      unreal_replication:
+        pairs_with: ["Unreal", "built-in replication", "dedicated servers", "listen servers"]
+      eos:
+        pairs_with: ["Epic Online Services", "cross-platform", "lobbies", "voice", "anti-cheat"]
+      steam_networking:
+        pairs_with: ["Steamworks", "peer-to-peer", "relay", "PC-focused"]
+      godot_multiplayer:
+        pairs_with: ["Godot", "MultiplayerAPI", "ENet", "WebSocket"]
+      custom_udp:
+        pairs_with: ["ENet", "LiteNetLib", "GameServer.io", "custom protocol"]
+
+  input_system:
+    triggers: ["input", "controls", "controller", "gamepad", "keyboard", "touch", "gesture", "rebinding"]
+    importance: "high"
+    affects: "player interaction epics"
+    options:
+      unity_input_system:
+        pairs_with: ["Unity", "action maps", "rebinding", "multiple devices"]
+      unreal_enhanced_input:
+        pairs_with: ["Unreal", "input actions", "modifiers", "triggers"]
+      godot_input_map:
+        pairs_with: ["Godot", "InputMap", "action system"]
+      rewired:
+        pairs_with: ["Unity", "advanced controller support", "Steam Input"]
+      custom_buffer:
+        pairs_with: ["fighting games", "input buffering", "command parsing"]
+
+  ai_system:
+    triggers: ["AI", "enemies", "NPC", "behavior", "pathfinding", "navigation", "companion"]
+    importance: "high"
+    affects: "AI and gameplay epics"
+    options:
+      behavior_trees:
+        pairs_with: ["Unity (Behavior Designer)", "Unreal (Behavior Trees)", "Godot (LimboAI)"]
+      state_machines:
+        pairs_with: ["any engine", "simple enemy AI", "animation state"]
+      goap:
+        pairs_with: ["emergent behavior", "complex NPCs", "simulation games"]
+      utility_ai:
+        pairs_with: ["dynamic decision making", "The Sims-style", "squad tactics"]
+      navigation_mesh:
+        pairs_with: ["Unity NavMesh", "Unreal NavMesh", "Godot NavigationServer", "3D pathfinding"]
+      astar_grid:
+        pairs_with: ["2D games", "tile-based", "grid pathfinding", "RTS"]
+
+  save_persistence:
+    triggers: ["save", "load", "persistence", "progress", "cloud save", "save file", "checkpoint"]
+    importance: "high"
+    affects: "progression and data epics"
+    options:
+      player_prefs:
+        pairs_with: ["Unity PlayerPrefs", "Godot ConfigFile", "simple key-value", "settings only"]
+      serialized_json:
+        pairs_with: ["any engine", "JSON save files", "versioned schema", "complex state"]
+      sqlite:
+        pairs_with: ["large save data", "queryable state", "inventory-heavy games"]
+      platform_cloud:
+        pairs_with: ["Steam Cloud", "PSN", "Xbox Cloud", "iCloud", "Google Play"]
+      custom_binary:
+        pairs_with: ["performance-sensitive", "large worlds", "anti-tamper"]
+
+  ui_framework:
+    triggers: ["UI", "HUD", "menu", "inventory screen", "dialogue box", "health bar", "minimap"]
+    importance: "medium"
+    affects: "UI and UX epics"
+    options:
+      unity_ui_toolkit:
+        pairs_with: ["Unity", "USS styling", "UXML layout", "runtime UI"]
+      unity_ugui:
+        pairs_with: ["Unity", "Canvas", "legacy but mature", "wide plugin support"]
+      unreal_umg:
+        pairs_with: ["Unreal", "UMG widgets", "Blueprints", "Slate (C++)"]
+      godot_control:
+        pairs_with: ["Godot", "Control nodes", "themes", "containers"]
+      imgui:
+        pairs_with: ["debug tools", "dev UI", "any engine via binding"]
+
+  asset_pipeline:
+    triggers: ["assets", "textures", "models", "sprites", "animation", "import", "asset bundles", "streaming"]
+    importance: "medium"
+    affects: "content and loading epics"
+    options:
+      unity_addressables:
+        pairs_with: ["Unity", "async loading", "content updates", "DLC"]
+      unity_resources:
+        pairs_with: ["Unity", "simple projects", "no remote content"]
+      unreal_asset_manager:
+        pairs_with: ["Unreal", "async loading", "streaming levels", "pak files"]
+      godot_resource_loader:
+        pairs_with: ["Godot", "ResourceLoader", "threaded loading", "PCK files"]
+
+  deployment_platform:
+    triggers: ["platform", "target", "build", "export", "Steam", "console", "mobile", "web"]
+    importance: "high"
+    affects: "all epics"
+    options:
+      steam_pc:
+        pairs_with: ["Steamworks SDK", "Steam Cloud", "Steam Input", "achievements"]
+      console:
+        pairs_with: ["platform SDK (NDA)", "certification requirements", "platform-specific APIs"]
+      mobile_ios:
+        pairs_with: ["App Store", "Metal", "Game Center", "StoreKit"]
+      mobile_android:
+        pairs_with: ["Google Play", "Vulkan/OpenGL ES", "Google Play Games Services"]
+      web_html5:
+        pairs_with: ["WebGL", "WebAssembly", "itch.io", "Newgrounds"]
+      vr_headset:
+        pairs_with: ["OpenXR", "Meta SDK", "SteamVR", "platform store"]
+
+# Opinionated stack combinations for common game types
+common_stacks:
+  unity_3d_action:
+    name: "Unity 3D Action/Adventure"
+    components: ["Unity", "URP", "C#", "Cinemachine", "Unity Input System", "FMOD or native audio", "Addressables"]
+    good_for: "3D action games, third-person, first-person, adventure"
+
+  unity_2d_platformer:
+    name: "Unity 2D Platformer"
+    components: ["Unity", "URP 2D Renderer", "C#", "Tilemap", "Unity Input System", "custom character controller"]
+    good_for: "2D platformers, metroidvanias, side-scrollers"
+
+  unreal_high_fidelity:
+    name: "Unreal High-Fidelity 3D"
+    components: ["Unreal Engine", "Nanite", "Lumen", "C++ and Blueprints", "Enhanced Input", "MetaSounds"]
+    good_for: "AAA-quality 3D, open world, realistic visuals"
+
+  unreal_multiplayer:
+    name: "Unreal Multiplayer"
+    components: ["Unreal Engine", "Replication", "Dedicated Servers", "Enhanced Input", "EOS"]
+    good_for: "Competitive multiplayer, team shooters, battle royale"
+
+  godot_2d:
+    name: "Godot 2D"
+    components: ["Godot", "GDScript", "TileMap", "AnimationPlayer", "Godot Physics 2D"]
+    good_for: "2D games, pixel art, indie, rapid prototyping, web export"
+
+  godot_3d:
+    name: "Godot 3D"
+    components: ["Godot", "GDScript or C#", "Forward+ renderer", "NavigationServer", "Jolt Physics"]
+    good_for: "Mid-scope 3D games, open source priority, multi-platform"
+
+  web_browser_game:
+    name: "Browser/HTML5 Game"
+    components: ["Phaser or Godot HTML5", "JavaScript/TypeScript", "WebGL", "Howler.js for audio"]
+    good_for: "Web games, game jams, itch.io, casual browser games"
+
+  mobile_casual:
+    name: "Mobile Casual"
+    components: ["Unity or Godot", "lightweight renderer", "touch input", "ad SDK", "IAP SDK", "cloud save"]
+    good_for: "Mobile F2P, hyper-casual, idle games"
+
+  vr_experience:
+    name: "VR Game"
+    components: ["Unity XR Toolkit or Unreal OpenXR", "OpenXR", "spatial audio", "hand tracking", "fixed foveated rendering"]
+    good_for: "VR games, XR experiences, room-scale interaction"
+
+# Starter templates and what decisions they pre-make
+starter_templates:
+  unity_2d_urp:
+    name: "Unity 2D (URP)"
+    command_search: "Unity Hub → New Project → 2D (URP)"
+    decisions_provided: ["Unity engine", "URP rendering", "2D Renderer", "C# language", "basic project structure"]
+    good_for: ["2D games", "pixel art", "platformers", "top-down"]
+
+  unity_3d_urp:
+    name: "Unity 3D (URP)"
+    command_search: "Unity Hub → New Project → 3D (URP)"
+    decisions_provided: ["Unity engine", "URP rendering", "3D pipeline", "C# language", "basic project structure"]
+    good_for: ["3D games", "mobile 3D", "stylized visuals", "cross-platform"]
+
+  unity_3d_hdrp:
+    name: "Unity 3D (HDRP)"
+    command_search: "Unity Hub → New Project → 3D (HDRP)"
+    decisions_provided: ["Unity engine", "HDRP rendering", "high-end pipeline", "C# language"]
+    good_for: ["High-fidelity 3D", "PC/console", "realistic rendering"]
+
+  unity_vr:
+    name: "Unity VR"
+    command_search: "Unity Hub → New Project → VR"
+    decisions_provided: ["Unity engine", "XR Plugin Management", "XR Interaction Toolkit", "URP"]
+    good_for: ["VR games", "XR experiences"]
+
+  unreal_blank:
+    name: "Unreal Blank Project"
+    command_search: "Epic Games Launcher → Unreal → Blank"
+    decisions_provided: ["Unreal engine", "C++ and Blueprints", "Chaos physics", "MetaSounds"]
+    good_for: ["Custom game types", "full control over setup"]
+
+  unreal_third_person:
+    name: "Unreal Third Person"
+    command_search: "Epic Games Launcher → Unreal → Third Person"
+    decisions_provided: ["Unreal engine", "character movement", "Enhanced Input", "third-person camera", "mannequin animations"]
+    good_for: ["3D action/adventure", "third-person games"]
+
+  unreal_first_person:
+    name: "Unreal First Person"
+    command_search: "Epic Games Launcher → Unreal → First Person"
+    decisions_provided: ["Unreal engine", "FPS movement", "Enhanced Input", "first-person camera", "projectile system"]
+    good_for: ["FPS games", "first-person exploration"]
+
+  godot_default:
+    name: "Godot Default Project"
+    command_search: "Godot → Project Manager → New Project"
+    decisions_provided: ["Godot engine", "GDScript", "scene tree architecture", "2D and 3D capable"]
+    good_for: ["Any Godot game", "rapid prototyping", "2D or 3D"]
+
+  phaser_vite:
+    name: "Phaser + Vite"
+    command_search: "npm create @phaserjs/game@latest"
+    decisions_provided: ["Phaser framework", "TypeScript option", "Vite bundler", "Arcade Physics"]
+    good_for: ["Browser games", "2D web games", "game jams"]
+
+  bevy_default:
+    name: "Bevy Default"
+    command_search: "cargo init && cargo add bevy"
+    decisions_provided: ["Bevy engine", "Rust language", "ECS architecture", "wgpu renderer"]
+    good_for: ["Rust game development", "data-oriented design", "custom pipelines"]
+
+# Starter selection heuristics (workflow logic)
+starter_selection_rules:
+  by_game_type:
+    2d_platformer:
+      recommended: ["unity_2d_urp", "godot_default"]
+      considerations: "Asset store needs? → Unity. Open source? → Godot. Web export? → Godot or Phaser"
+
+    3d_action:
+      recommended: ["unreal_third_person", "unity_3d_urp"]
+      considerations: "High fidelity? → Unreal. Cross-platform mobile? → Unity URP. Stylized? → Either"
+
+    fps_shooter:
+      recommended: ["unreal_first_person", "unity_3d_urp"]
+      considerations: "Multiplayer replication? → Unreal. Mobile? → Unity. Competitive netcode? → Both viable"
+
+    open_world:
+      recommended: ["unreal_blank", "unity_3d_urp"]
+      considerations: "Large-scale streaming? → Unreal (World Partition). Mid-scope? → Unity or Godot"
+
+    mobile_casual:
+      recommended: ["unity_2d_urp", "godot_default"]
+      considerations: "Ad/IAP SDKs? → Unity (best ecosystem). Open source? → Godot. Web-first? → Phaser"
+
+    vr_game:
+      recommended: ["unity_vr", "unreal_blank"]
+      considerations: "XR Toolkit maturity? → Unity. Visual fidelity? → Unreal. Cross-headset? → Both via OpenXR"
+
+    browser_game:
+      recommended: ["phaser_vite", "godot_default"]
+      considerations: "Pure web? → Phaser. May expand to desktop? → Godot. Game jam? → Either"
+
+    strategy_rts:
+      recommended: ["unity_3d_urp", "godot_default", "unreal_blank"]
+      considerations: "Large unit counts? → ECS approach in any engine. Mod support? → Godot. Polish? → Unity or Unreal"
+
+    narrative_rpg:
+      recommended: ["unity_3d_urp", "unity_2d_urp", "godot_default"]
+      considerations: "Yarn Spinner/Ink integration? → Unity or Godot. Dialogue-heavy? → Godot (built-in). AAA RPG? → Unreal"

package/src/workflows/3-technical/game-architecture/engine-mcps.yaml

@@ -0,0 +1,270 @@
+# Engine MCP Servers - Game engine MCP integrations for AI-assisted development
+# Used during Step 3 (engine selection) to recommend relevant MCP servers
+#
+# ⚠️ CRITICAL: All MCP availability and versions MUST be verified via WebSearch
+# This file provides: known MCPs, search terms for discovery, and capability descriptions
+# MCP ecosystem evolves rapidly - always verify repos are active and maintained
+#
+# MCP (Model Context Protocol) servers give AI agents direct access to game engine
+# features like scene inspection, asset queries, and live debugging - dramatically
+# improving AI-assisted game development.
+
+engine_mcps:
+  unity:
+    engine: "Unity"
+    mcps:
+      mcp_unity:
+        name: "MCP Unity (CoderGamester)"
+        repo: "CoderGamester/mcp-unity"
+        search_term: "CoderGamester mcp-unity github"
+        description: "Full-featured MCP bridge for Unity Editor with 30+ tools for scene, asset, and component management"
+        capabilities:
+          - "Create, load, save, and delete scenes"
+          - "Create, select, update, duplicate, delete, and reparent GameObjects"
+          - "Add and update components with property access"
+          - "Create, assign, and modify materials"
+          - "Add assets to scenes, manage packages"
+          - "Run Unity Test Runner tests"
+          - "Recompile scripts, execute menu items"
+          - "Batch execute multiple commands atomically"
+          - "Access Unity console logs and output"
+        install_type: "Unity Package Manager (git URL) + Node.js MCP server"
+        install_steps:
+          - "Install Node.js 18+"
+          - "In Unity: Window > Package Manager > + > Add package from git URL"
+          - "URL: https://github.com/CoderGamester/mcp-unity.git"
+          - "In Unity: Tools > MCP Unity > Server Window > Configure"
+          - "Click Start Server"
+        requirements: "Unity 6+, Node.js 18+, npm 9+"
+        supported_clients: ["Claude Desktop", "Claude Code", "Cursor", "Windsurf", "Codex CLI", "GitHub Copilot"]
+        license: "MIT"
+        benefit_summary: "AI agents get 30+ tools to directly inspect and modify your Unity scenes, GameObjects, components, and materials - no copy-pasting descriptions needed."
+
+      unity_mcp_coplay:
+        name: "Unity MCP (CoplayDev)"
+        repo: "CoplayDev/unity-mcp"
+        search_term: "CoplayDev unity-mcp github"
+        description: "AI bridge for Unity Editor with natural language control, asset and scene management, and batch operations"
+        capabilities:
+          - "Natural language control of Unity Editor"
+          - "Manage assets, scenes, materials, and scripts"
+          - "Batch execute operations (10-100x faster than individual calls)"
+          - "Two-way communication between AI and Unity"
+        install_type: "Unity Package Manager (git URL) or Unity Asset Store or OpenUPM"
+        install_steps:
+          - "In Unity: Window > Package Manager > + > Add package from git URL"
+          - "URL: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity"
+          - "Configure your MCP client to connect"
+        requirements: "Unity 2021.3 LTS+"
+        supported_clients: ["Claude Desktop", "Cursor", "Windsurf"]
+        license: "MIT"
+        benefit_summary: "Broad Unity version support (2021.3+) with natural language control and fast batch operations for AI-driven scene building."
+
+  unreal:
+    engine: "Unreal Engine"
+    mcps:
+      unreal_mcp:
+        name: "Unreal MCP (chongdashu)"
+        repo: "chongdashu/unreal-mcp"
+        search_term: "chongdashu unreal-mcp github"
+        description: "Enables AI assistants to control Unreal Engine through natural language via C++ plugin and Python server"
+        capabilities:
+          - "Create, delete, and transform actors in levels"
+          - "Query actor properties and list level contents"
+          - "Create Blueprint classes with custom components"
+          - "Configure Blueprint properties and compile"
+          - "Add event nodes, function calls, and variables to Blueprint graphs"
+          - "Focus viewport on actors, control camera orientation"
+          - "Create input action mappings"
+        install_type: "Unreal plugin (C++) + Python MCP server"
+        install_steps:
+          - "Copy UnrealMCP plugin to your project's Plugins folder"
+          - "Enable via Edit > Plugins > search 'UnrealMCP'"
+          - "Generate Visual Studio files and build (Development Editor)"
+          - "Install Python 3.12+ and set up the Python server per Python/README.md"
+          - "Configure MCP client with provided JSON config"
+        requirements: "Unreal Engine 5.5+, Python 3.12+"
+        supported_clients: ["Claude Desktop", "Cursor", "Windsurf"]
+        license: "MIT"
+        note: "Experimental status - breaking changes possible between versions"
+        benefit_summary: "AI agents can create actors, build Blueprints, edit node graphs, and control the viewport directly in Unreal Editor."
+
+      unreal_mcp_comprehensive:
+        name: "Unreal MCP (ChiR24)"
+        repo: "ChiR24/Unreal_mcp"
+        search_term: "ChiR24 Unreal_mcp github"
+        description: "Comprehensive MCP server with C++ Automation Bridge, TypeScript server, and optional WASM acceleration"
+        capabilities:
+          - "Manage Blueprints, Materials, Textures, Static Meshes, Skeletal Meshes"
+          - "C++ native automation bridge for high-performance operations"
+          - "Optional WASM acceleration for compute-intensive tasks"
+          - "Optional GraphQL endpoint for complex queries"
+          - "Asset type management across the project"
+        install_type: "Unreal plugin (C++) + TypeScript MCP server"
+        install_steps:
+          - "Clone repo and copy plugin to project Plugins folder"
+          - "Build the TypeScript MCP server"
+          - "Configure MCP client"
+        requirements: "Unreal Engine 5.5+"
+        supported_clients: ["Claude Desktop", "Cursor", "Windsurf"]
+        license: "MIT"
+        benefit_summary: "High-performance C++ bridge with broad asset type support and optional WASM acceleration for heavy operations."
+
+  godot:
+    engine: "Godot"
+    mcps:
+      godot_mcp_bradypp:
+        name: "Godot MCP (bradypp)"
+        repo: "bradypp/godot-mcp"
+        search_term: "bradypp godot-mcp github"
+        description: "Comprehensive MCP server for Godot with project management, scene editing, and optional read-only mode"
+        capabilities:
+          - "Launch Godot Editor and execute projects in debug mode"
+          - "Generate scenes with specified root node types"
+          - "Insert, modify, and remove nodes with customizable properties"
+          - "Modify positions, scales, textures, and node attributes"
+          - "Auto-load textures into Sprite2D nodes"
+          - "Convert 3D scenes to MeshLibrary for GridMap"
+          - "Retrieve console output and error messages in real time"
+          - "UID management for resource links (Godot 4.4+)"
+          - "Read-only mode for safe analysis (CI/CD, code reviews)"
+        install_type: "Node.js MCP server (no Godot plugin needed)"
+        install_steps:
+          - "git clone https://github.com/bradypp/godot-mcp.git"
+          - "cd godot-mcp && npm install && npm run build"
+          - "Configure MCP client to point to the built index.js"
+        requirements: "Godot 3.5+ or 4.0+ (4.4+ for UID features), Node.js"
+        supported_clients: ["Claude Desktop", "Cursor", "Cline", "Roo Code"]
+        license: "MIT"
+        benefit_summary: "Broad Godot version support (3.5+/4.0+) with scene editing, debug output capture, and a read-only mode for safe project analysis."
+
+      godot_mcp_ee0pdt:
+        name: "Godot MCP (ee0pdt)"
+        repo: "ee0pdt/Godot-MCP"
+        search_term: "ee0pdt Godot-MCP github"
+        description: "Bidirectional AI bridge for Godot with full project access for scripts, scenes, nodes, and resources"
+        capabilities:
+          - "Create, delete, and modify nodes in scenes"
+          - "Edit and analyze scripts"
+          - "Manipulate scenes and project resources"
+          - "Access and modify project configuration"
+          - "Run projects from the editor"
+          - "Two-way communication between AI and Godot"
+        install_type: "Node.js MCP server + Godot addon"
+        install_steps:
+          - "git clone https://github.com/ee0pdt/Godot-MCP.git"
+          - "npm install && npm run build"
+          - "Copy Godot addon folder to your project's addons directory"
+          - "Enable addon in Project > Project Settings > Plugins"
+          - "Configure MCP client with server path"
+        requirements: "Godot 4.x, Node.js"
+        supported_clients: ["Claude Desktop", "Cursor"]
+        license: "MIT"
+        benefit_summary: "Full bidirectional Godot integration - AI agents can read and write scripts, scenes, and nodes directly."
+
+      godot_mcp_docs:
+        name: "Godot MCP Docs"
+        repo: "Nihilantropy/godot-mcp-docs"
+        search_term: "Nihilantropy godot-mcp-docs github"
+        description: "Serves the complete Godot Engine documentation to AI assistants via MCP"
+        capabilities:
+          - "Query Godot class reference documentation"
+          - "Look up tutorials and feature guides"
+          - "Search across all Godot documentation"
+          - "Retrieve API signatures and usage examples"
+        install_type: "Docker container"
+        install_steps:
+          - "Clone repo and build Docker image"
+          - "Configure MCP client to run the containerized server"
+        requirements: "Docker, Godot 4.x documentation"
+        supported_clients: ["Claude Desktop", "Cursor"]
+        license: "MIT"
+        benefit_summary: "AI agents get access to the full Godot documentation for accurate API usage without relying on training data."
+
+  general:
+    engine: "Any"
+    description: "General-purpose MCPs useful for any game engine"
+    mcps:
+      context7:
+        name: "Context7"
+        repo: "upstash/context7"
+        search_term: "upstash context7 MCP github"
+        description: "Pulls up-to-date, version-specific documentation and code examples for any library directly into AI prompts"
+        capabilities:
+          - "Resolve library names to documentation sources"
+          - "Retrieve current API documentation for any library or framework"
+          - "Pull version-specific code examples and usage patterns"
+          - "Verify API signatures against current docs"
+        install_type: "npx command or Docker"
+        install_steps:
+          - "claude mcp add context7 -- npx -y @upstash/context7-mcp"
+          - "Or configure in claude_desktop_config.json / .mcp.json"
+          - "Optional: get API key at context7.com/dashboard for higher rate limits"
+        requirements: "Node.js (for npx) or Docker"
+        supported_clients: ["Claude Desktop", "Claude Code", "Cursor", "Windsurf", "Zed"]
+        license: "Apache-2.0"
+        benefit_summary: "AI agents look up current library documentation instead of relying on training data - reduces outdated API usage across any engine or framework."
+
+# Recommendation logic used by the workflow
+recommendation_rules:
+  always_recommend:
+    - "Engine-specific MCP if one exists for the chosen engine"
+    - "Context7 for up-to-date API documentation lookup"
+
+  multiple_options:
+    note: "When multiple MCPs exist for an engine, present the top 1-2 options and let the user choose"
+    unity_default: "mcp_unity"
+    unity_alternative: "unity_mcp_coplay"
+    unreal_default: "unreal_mcp"
+    godot_default: "godot_mcp_bradypp"
+    godot_alternative: "godot_mcp_ee0pdt"
+
+  recommend_if:
+    godot_docs_needed:
+      trigger: "Godot selected AND beginner game_dev_experience"
+      recommend: "godot_mcp_docs for built-in documentation access"
+
+  presentation_order:
+    - "engine_specific"
+    - "documentation"
+
+# How to present MCPs based on skill level
+presentation_guidance:
+  expert:
+    style: "Concise list with repo links and capabilities"
+    example: |
+      Available MCPs for {{engine}}:
+      - **{{mcp_name}}** ({{repo}}): {{one_line_description}}
+        Install: {{install_type}}
+      Want to include MCP setup in your architecture? [y/n]
+
+  intermediate:
+    style: "Brief explanation with benefits"
+    example: |
+      **AI Development Tools (MCP Servers)**
+
+      MCP servers let your AI assistant interact directly with {{engine}}.
+      For your project, I'd recommend:
+
+      - **{{mcp_name}}**: {{benefit_summary}}
+        Repo: {{repo}}
+
+      These are optional but significantly improve AI-assisted development.
+      Include MCP setup in your architecture? [y/n]
+
+  beginner:
+    style: "Full explanation of what MCPs are and why they help"
+    example: |
+      **AI Development Tools**
+
+      There's a way to give your AI assistant "eyes" into {{engine}} -
+      called MCP (Model Context Protocol) servers. Think of it like giving
+      your AI assistant a window into your game editor.
+
+      For {{engine}}, there's **{{mcp_name}}** which lets the AI:
+      {{friendly_capability_list}}
+
+      This means instead of describing your scene layout in chat,
+      the AI can just look at it directly.
+
+      Want to set this up? [y/n]

package/src/workflows/3-technical/game-architecture/pattern-categories.csv

@@ -0,0 +1,13 @@
+category,when_needed,what_to_define,why_critical
+naming_patterns,Any technology with named entities,How things are named (format/case/structure),Agents will create different names for same concept
+structure_patterns,Any technology with organization,How things are organized (folders/modules/layers),Agents will put things in different places
+format_patterns,Any technology with data exchange,How data is formatted (JSON/XML/responses),Agents will use incompatible formats
+communication_patterns,Any technology with inter-component communication,How components talk (protocols/events/messages),Agents will use different communication methods
+lifecycle_patterns,Any technology with state or flow,How state changes and flows work,Agents will handle state transitions differently
+location_patterns,Any technology with storage or routing,Where things go (URLs/paths/storage),Agents will put things in different locations
+consistency_patterns,Always,Cross-cutting concerns (dates/errors/logs),Every agent will do these differently
+
+# PRINCIPLE FOR LLM:
+# Any time multiple agents might make the SAME decision DIFFERENTLY, that's a pattern to capture.
+# Think about: What could an agent encounter where they'd have to guess?
+# If they'd guess, define the pattern. If it's obvious from the tech choice, skip it.