bmad-game-dev-studio 0.1.0

package/src/workflows/2-design/gdd/game-types.csv

@@ -0,0 +1,25 @@
+id,name,description,genre_tags,fragment_file
+action-platformer,Action Platformer,"Side-scrolling or 3D platforming with combat mechanics","action,platformer,combat,movement",action-platformer.md
+puzzle,Puzzle,"Logic-based challenges and problem-solving","puzzle,logic,cerebral",puzzle.md
+rpg,RPG,"Character progression, stats, inventory, quests","rpg,stats,inventory,quests,narrative",rpg.md
+strategy,Strategy,"Resource management, tactical decisions, long-term planning","strategy,tactics,resources,planning",strategy.md
+shooter,Shooter,"Projectile combat, aiming mechanics, arena/level design","shooter,combat,aiming,fps,tps",shooter.md
+adventure,Adventure,"Story-driven exploration and narrative","adventure,narrative,exploration,story",adventure.md
+simulation,Simulation,"Realistic systems, management, building","simulation,management,sandbox,systems",simulation.md
+roguelike,Roguelike,"Procedural generation, permadeath, run-based progression","roguelike,procedural,permadeath,runs",roguelike.md
+moba,MOBA,"Multiplayer team battles, hero/champion selection, lanes","moba,multiplayer,pvp,heroes,lanes",moba.md
+fighting,Fighting,"1v1 combat, combos, frame data, competitive","fighting,combat,competitive,combos,pvp",fighting.md
+racing,Racing,"Vehicle control, tracks, speed, lap times","racing,vehicles,tracks,speed",racing.md
+sports,Sports,"Team-based or individual sports simulation","sports,teams,realistic,physics",sports.md
+survival,Survival,"Resource gathering, crafting, persistent threats","survival,crafting,resources,danger",survival.md
+horror,Horror,"Atmosphere, tension, limited resources, fear mechanics","horror,atmosphere,tension,fear",horror.md
+idle-incremental,Idle/Incremental,"Passive progression, upgrades, automation","idle,incremental,automation,progression",idle-incremental.md
+card-game,Card Game,"Deck building, card mechanics, turn-based strategy","card,deck-building,strategy,turns",card-game.md
+tower-defense,Tower Defense,"Wave-based defense, tower placement, resource management","tower-defense,waves,placement,strategy",tower-defense.md
+metroidvania,Metroidvania,"Interconnected world, ability gating, exploration","metroidvania,exploration,abilities,interconnected",metroidvania.md
+visual-novel,Visual Novel,"Narrative choices, branching story, dialogue","visual-novel,narrative,choices,story",visual-novel.md
+rhythm,Rhythm,"Music synchronization, timing-based gameplay","rhythm,music,timing,beats",rhythm.md
+turn-based-tactics,Turn-Based Tactics,"Grid-based movement, turn order, positioning","tactics,turn-based,grid,positioning",turn-based-tactics.md
+sandbox,Sandbox,"Creative freedom, building, minimal objectives","sandbox,creative,building,freedom",sandbox.md
+text-based,Text-Based,"Text input/output, parser or choice-based","text,parser,interactive-fiction,mud",text-based.md
+party-game,Party Game,"Local multiplayer, minigames, casual fun","party,multiplayer,minigames,casual",party-game.md

package/src/workflows/2-design/gdd/workflow.yaml

@@ -0,0 +1,101 @@
+# Game Design Document (GDD) Workflow
+name: gdd
+description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/gds/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+game_dev_experience: "{config_source}:game_dev_experience"
+date: system-generated
+
+# Workflow components - Step-file architecture
+installed_path: "{project-root}/_bmad/gds/workflows/2-design/gdd"
+instructions: "{installed_path}/workflow.md"
+template: "{installed_path}/templates/gdd-template.md"
+game_types_csv: "{installed_path}/game-types.csv"
+
+# Output configuration
+default_output_file: "{output_folder}/gdd.md"
+
+# Game type references (loaded based on game type selection)
+game_type_guides: "{installed_path}/game-types/"
+
+# Smart input file references - handles both whole docs and sharded docs
+# Priority: Whole document first, then sharded version
+input_file_patterns:
+  game_brief:
+    description: "Game vision and core concept (optional)"
+    whole: "{output_folder}/*game-brief*.md"
+    sharded: "{output_folder}/*game-brief*/index.md"
+    load_strategy: "INDEX_GUIDED"
+
+  research:
+    description: "Market or domain research (optional)"
+    whole: "{output_folder}/*research*.md"
+    sharded: "{output_folder}/*research*/index.md"
+    load_strategy: "FULL_LOAD"
+
+  document_project:
+    description: "Brownfield project documentation (optional)"
+    sharded: "{output_folder}/index.md"
+    load_strategy: "INDEX_GUIDED"
+
+standalone: true
+
+web_bundle:
+  name: "gdd"
+  description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
+  author: "BMad"
+  instructions: "_bmad/gds/workflows/2-design/gdd/workflow.md"
+  web_bundle_files:
+    # Main workflow file
+    - "_bmad/gds/workflows/2-design/gdd/workflow.md"
+    # Step files
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-01-init.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-01b-continue.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-02-context.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-03-platforms.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-04-vision.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-05-core-gameplay.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-06-mechanics.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-07-game-type.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-08-progression.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-09-levels.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-10-art-audio.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-11-technical.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-12-epics.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-13-metrics.md"
+    - "_bmad/gds/workflows/2-design/gdd/steps/step-14-complete.md"
+    # Template
+    - "_bmad/gds/workflows/2-design/gdd/templates/gdd-template.md"
+    # Data files
+    - "_bmad/gds/workflows/2-design/gdd/game-types.csv"
+    # Game type guides
+    - "_bmad/gds/workflows/2-design/gdd/game-types/action-platformer.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/adventure.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/card-game.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/fighting.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/horror.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/idle-incremental.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/metroidvania.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/moba.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/party-game.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/puzzle.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/racing.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/rhythm.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/roguelike.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/rpg.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/sandbox.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/shooter.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/simulation.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/sports.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/strategy.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/survival.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/text-based.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/tower-defense.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/turn-based-tactics.md"
+    - "_bmad/gds/workflows/2-design/gdd/game-types/visual-novel.md"

package/src/workflows/2-design/narrative/workflow.yaml

@@ -0,0 +1,77 @@
+# Narrative Design Workflow
+name: narrative
+description: "Narrative design workflow for story-driven games. Creates comprehensive narrative documentation including story structure, character arcs, world-building, dialogue systems, and production planning."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/gds/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+game_dev_experience: "{config_source}:game_dev_experience"
+date: system-generated
+
+# Workflow components - Step-file architecture
+installed_path: "{project-root}/_bmad/gds/workflows/2-design/narrative"
+instructions: "{installed_path}/workflow.md"
+template: "{installed_path}/templates/narrative-template.md"
+validation: "{installed_path}/checklist.md"
+
+# Smart input file references
+input_file_patterns:
+  gdd:
+    description: "Game Design Document with mechanics and systems"
+    whole: "{output_folder}/*gdd*.md"
+    sharded: "{output_folder}/*gdd*/index.md"
+    load_strategy: "INDEX_GUIDED"
+
+  brief:
+    description: "Game Brief with vision (optional)"
+    whole: "{output_folder}/*brief*.md"
+    sharded: "{output_folder}/*brief*/index.md"
+    load_strategy: "INDEX_GUIDED"
+
+# Output configuration
+default_output_file: "{output_folder}/narrative-design.md"
+
+# Workflow metadata
+version: "2.0.0"
+paradigm: "step-file-architecture"
+features:
+  - "Step-file architecture for modular execution"
+  - "Narrative complexity assessment"
+  - "Character development facilitation"
+  - "World-building guidance"
+  - "Dialogue system design"
+  - "Environmental storytelling planning"
+  - "Production scope estimation"
+  - "State tracking via frontmatter"
+
+standalone: true
+
+web_bundle:
+  name: "narrative"
+  description: "Narrative design workflow for story-driven games"
+  author: "BMad"
+  instructions: "_bmad/gds/workflows/2-design/narrative/workflow.md"
+  web_bundle_files:
+    # Main workflow file
+    - "_bmad/gds/workflows/2-design/narrative/workflow.md"
+    # Step files
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-01-init.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-01b-continue.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-02-foundation.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-03-story.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-04-characters.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-05-world.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-06-dialogue.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-07-environmental.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-08-delivery.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-09-integration.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-10-production.md"
+    - "_bmad/gds/workflows/2-design/narrative/steps/step-11-complete.md"
+    # Template
+    - "_bmad/gds/workflows/2-design/narrative/templates/narrative-template.md"
+    # Validation checklist
+    - "_bmad/gds/workflows/2-design/narrative/checklist.md"

package/src/workflows/3-technical/game-architecture/architecture-patterns.yaml

@@ -0,0 +1,321 @@
+# Architecture Patterns - Common patterns identified from requirements
+
+requirement_patterns:
+  realtime_collaboration:
+    triggers:
+      - "real-time"
+      - "collaborative"
+      - "live updates"
+      - "multi-user"
+      - "simultaneous editing"
+    decisions_needed:
+      - websocket_solution
+      - conflict_resolution
+      - state_synchronization
+      - presence_tracking
+      - optimistic_updates
+    suggested_stack:
+      - "Socket.io or WebSocket native"
+      - "Redis for pub/sub"
+      - "Operational Transforms or CRDTs for conflict resolution"
+      - "PostgreSQL for persistence"
+
+  ecommerce:
+    triggers:
+      - "shopping cart"
+      - "checkout"
+      - "payments"
+      - "inventory"
+      - "product catalog"
+    decisions_needed:
+      - payment_processor
+      - cart_persistence
+      - inventory_management
+      - order_workflow
+      - tax_calculation
+    suggested_stack:
+      - "Stripe or PayPal for payments"
+      - "PostgreSQL for products and orders"
+      - "Redis for cart sessions"
+      - "BullMQ for order processing"
+
+  saas_platform:
+    triggers:
+      - "multi-tenant"
+      - "subscription"
+      - "billing"
+      - "team management"
+      - "roles and permissions"
+    decisions_needed:
+      - tenancy_model
+      - subscription_billing
+      - permission_system
+      - team_collaboration
+      - usage_tracking
+    suggested_stack:
+      - "PostgreSQL with Row Level Security"
+      - "Stripe Billing for subscriptions"
+      - "RBAC or ABAC for permissions"
+      - "NextAuth or Clerk for auth"
+
+  content_platform:
+    triggers:
+      - "CMS"
+      - "blog"
+      - "publishing"
+      - "content management"
+      - "editorial workflow"
+    decisions_needed:
+      - content_storage
+      - rich_text_editor
+      - media_handling
+      - version_control
+      - publishing_workflow
+    suggested_stack:
+      - "PostgreSQL for structured content"
+      - "S3 or Cloudinary for media"
+      - "Tiptap or Slate for rich text"
+      - "Algolia for search"
+
+  data_analytics:
+    triggers:
+      - "dashboards"
+      - "reporting"
+      - "metrics"
+      - "analytics"
+      - "data visualization"
+    decisions_needed:
+      - data_warehouse
+      - etl_pipeline
+      - visualization_library
+      - query_optimization
+      - caching_strategy
+    suggested_stack:
+      - "PostgreSQL or ClickHouse"
+      - "Apache Airflow or Temporal for ETL"
+      - "Chart.js or D3 for visualization"
+      - "Redis for query caching"
+
+  social_platform:
+    triggers:
+      - "social network"
+      - "feed"
+      - "following"
+      - "likes"
+      - "comments"
+    decisions_needed:
+      - graph_relationships
+      - feed_algorithm
+      - notification_system
+      - content_moderation
+      - privacy_controls
+    suggested_stack:
+      - "PostgreSQL with graph extensions or Neo4j"
+      - "Redis for feed caching"
+      - "Elasticsearch for user search"
+      - "WebSockets for notifications"
+
+  marketplace:
+    triggers:
+      - "marketplace"
+      - "vendors"
+      - "buyers and sellers"
+      - "transactions"
+      - "escrow"
+    decisions_needed:
+      - payment_splitting
+      - escrow_handling
+      - vendor_management
+      - dispute_resolution
+      - commission_model
+    suggested_stack:
+      - "Stripe Connect for payments"
+      - "PostgreSQL for transactions"
+      - "BullMQ for async processing"
+      - "S3 for vendor assets"
+
+  streaming_platform:
+    triggers:
+      - "video streaming"
+      - "live streaming"
+      - "media delivery"
+      - "broadcast"
+    decisions_needed:
+      - video_encoding
+      - cdn_strategy
+      - streaming_protocol
+      - bandwidth_optimization
+      - drm_protection
+    suggested_stack:
+      - "AWS MediaConvert or Mux"
+      - "CloudFront or Fastly CDN"
+      - "HLS or DASH protocol"
+      - "S3 for video storage"
+
+  iot_platform:
+    triggers:
+      - "IoT"
+      - "sensors"
+      - "device management"
+      - "telemetry"
+      - "edge computing"
+    decisions_needed:
+      - message_protocol
+      - time_series_database
+      - device_authentication
+      - data_ingestion
+      - edge_processing
+    suggested_stack:
+      - "MQTT or CoAP protocol"
+      - "TimescaleDB or InfluxDB"
+      - "Apache Kafka for ingestion"
+      - "Grafana for monitoring"
+
+  ai_application:
+    triggers:
+      - "machine learning"
+      - "AI features"
+      - "LLM integration"
+      - "computer vision"
+      - "NLP"
+    decisions_needed:
+      - model_serving
+      - vector_database
+      - prompt_management
+      - token_optimization
+      - fallback_strategy
+    suggested_stack:
+      - "OpenAI or Anthropic API"
+      - "Pinecone or pgvector for embeddings"
+      - "Redis for prompt caching"
+      - "Langchain or LlamaIndex"
+
+# Quality attribute patterns
+quality_attributes:
+  high_availability:
+    triggers:
+      - "99.9% uptime"
+      - "high availability"
+      - "fault tolerance"
+      - "disaster recovery"
+    architectural_needs:
+      - load_balancing
+      - database_replication
+      - health_checks
+      - circuit_breakers
+      - graceful_degradation
+
+  high_performance:
+    triggers:
+      - "millisecond response"
+      - "high throughput"
+      - "low latency"
+      - "performance critical"
+    architectural_needs:
+      - caching_layers
+      - database_optimization
+      - cdn_strategy
+      - code_splitting
+      - lazy_loading
+
+  high_security:
+    triggers:
+      - "compliance"
+      - "HIPAA"
+      - "GDPR"
+      - "financial data"
+      - "PCI DSS"
+    architectural_needs:
+      - encryption_at_rest
+      - encryption_in_transit
+      - audit_logging
+      - access_controls
+      - data_isolation
+
+  scalability:
+    triggers:
+      - "millions of users"
+      - "elastic scale"
+      - "global reach"
+      - "viral growth"
+    architectural_needs:
+      - horizontal_scaling
+      - database_sharding
+      - microservices
+      - queue_systems
+      - auto_scaling
+
+# Integration patterns
+integration_requirements:
+  payment_processing:
+    common_choices:
+      - "Stripe - most developer friendly"
+      - "PayPal - widest consumer adoption"
+      - "Square - best for in-person + online"
+    considerations:
+      - transaction_fees
+      - international_support
+      - subscription_handling
+      - marketplace_capabilities
+
+  email_service:
+    common_choices:
+      - "Resend - modern, developer friendly"
+      - "SendGrid - mature, scalable"
+      - "Amazon SES - cost effective at scale"
+      - "Postmark - transactional focus"
+    considerations:
+      - deliverability
+      - template_management
+      - analytics_needs
+      - cost_per_email
+
+  sms_notifications:
+    common_choices:
+      - "Twilio - most comprehensive"
+      - "Amazon SNS - AWS integrated"
+      - "Vonage - competitive pricing"
+    considerations:
+      - international_coverage
+      - delivery_rates
+      - two_way_messaging
+      - cost_per_message
+
+  authentication_providers:
+    social_providers:
+      - "Google - highest adoption"
+      - "GitHub - developer focused"
+      - "Microsoft - enterprise"
+      - "Apple - iOS users"
+    enterprise_providers:
+      - "SAML 2.0"
+      - "OAuth 2.0"
+      - "OpenID Connect"
+      - "Active Directory"
+
+# Decision heuristics
+decision_rules:
+  database_selection:
+    if_requirements_include:
+      - complex_relationships: "PostgreSQL"
+      - flexible_schema: "MongoDB"
+      - time_series: "TimescaleDB"
+      - graph_data: "Neo4j or PostgreSQL with extensions"
+      - key_value: "Redis"
+      - wide_column: "Cassandra"
+
+  api_pattern_selection:
+    if_requirements_include:
+      - simple_crud: "REST"
+      - complex_queries: "GraphQL"
+      - type_safety_critical: "tRPC"
+      - microservices: "gRPC"
+      - public_api: "REST with OpenAPI"
+
+  deployment_selection:
+    if_requirements_include:
+      - nextjs_only: "Vercel"
+      - complex_infrastructure: "AWS"
+      - quick_prototype: "Railway"
+      - global_edge: "Fly.io"
+      - kubernetes_needed: "GCP or AWS EKS"