bmad-method 5.1.3 → 6.0.0-alpha.1

package/src/modules/bmm/workflows/2-plan-workflows/gdd/game-types/text-based.md

@@ -0,0 +1,91 @@
+## Text-Based Game Specific Elements
+
+<narrative-workflow-critical>
+This game type is **narrative-critical**. You MUST run the Narrative Design workflow after completing the GDD to create:
+- Complete story and all narrative paths
+- Room descriptions and atmosphere
+- Puzzle solutions and hints
+- Character dialogue
+- World lore and backstory
+- Parser vocabulary (if parser-based)
+</narrative-workflow-critical>
+
+### Input System
+
+{{input_system}}
+
+**Core interface:**
+
+- Parser-based (natural language commands)
+- Choice-based (numbered/lettered options)
+- Hybrid system
+- Command vocabulary depth
+- Synonyms and flexibility
+- Error messaging and hints
+
+### Room/Location Structure
+
+{{location_structure}}
+
+**World design:**
+
+- Room count and scope
+- Room descriptions (length, detail)
+- Connection types (doors, paths, obstacles)
+- Map structure (linear, branching, maze-like, open)
+- Landmarks and navigation aids
+- Fast travel or mapping system
+
+### Item and Inventory System
+
+{{item_inventory}}
+
+**Object interaction:**
+
+- Examinable objects
+- Takeable vs. scenery objects
+- Item use and combinations
+- Inventory management
+- Object descriptions
+- Hidden objects and clues
+
+### Puzzle Design
+
+{{puzzle_design}}
+
+**Challenge structure:**
+
+- Puzzle types (logic, inventory, knowledge, exploration)
+- Difficulty curve
+- Hint system (gradual reveals)
+- Red herrings vs. crucial clues
+- Puzzle integration with story
+- Non-linear puzzle solving
+
+### Narrative and Writing
+
+{{narrative_writing}}
+
+**Story delivery:**
+
+- Writing tone and style
+- Descriptive density
+- Character voice
+- Dialogue systems
+- Branching narrative (if applicable)
+- Multiple endings (if applicable)
+
+**Note:** All narrative content must be written in the Narrative Design Document.
+
+### Game Flow and Pacing
+
+{{game_flow}}
+
+**Structure:**
+
+- Game length target
+- Acts or chapters
+- Save system
+- Undo/rewind mechanics
+- Walkthrough or hint accessibility
+- Replayability considerations

package/src/modules/bmm/workflows/2-plan-workflows/gdd/game-types/tower-defense.md

@@ -0,0 +1,79 @@
+## Tower Defense Specific Elements
+
+### Tower Types and Upgrades
+
+{{tower_types}}
+
+**Tower design:**
+
+- Tower categories (damage, slow, splash, support, special)
+- Tower stats (damage, range, fire rate, cost)
+- Upgrade paths (linear, branching)
+- Tower synergies
+- Tier progression
+- Special abilities and targeting
+
+### Enemy Wave Design
+
+{{wave_design}}
+
+**Enemy systems:**
+
+- Enemy types (fast, tank, flying, immune, boss)
+- Wave composition
+- Wave difficulty scaling
+- Wave scheduling and pacing
+- Boss encounters
+- Endless mode scaling (if applicable)
+
+### Path and Placement Strategy
+
+{{path_placement}}
+
+**Strategic space:**
+
+- Path structure (fixed, custom, maze-building)
+- Placement restrictions (grid, free placement)
+- Terrain types (buildable, non-buildable, special)
+- Choke points and strategic locations
+- Multiple paths (if applicable)
+- Line of sight and range visualization
+
+### Economy and Resources
+
+{{economy}}
+
+**Resource management:**
+
+- Starting resources
+- Resource generation (per wave, per kill, passive)
+- Resource spending (towers, upgrades, abilities)
+- Selling/refund mechanics
+- Special currencies (if applicable)
+- Economic optimization strategies
+
+### Abilities and Powers
+
+{{abilities_powers}}
+
+**Active mechanics:**
+
+- Player-activated abilities (airstrikes, freezes, etc.)
+- Cooldown systems
+- Ability unlocks
+- Ability upgrade paths
+- Strategic timing
+- Resource cost vs. cooldown
+
+### Difficulty and Replayability
+
+{{difficulty_replay}}
+
+**Challenge systems:**
+
+- Difficulty levels
+- Mission objectives (perfect clear, no lives lost, etc.)
+- Star ratings
+- Challenge modifiers
+- Randomized elements
+- New Game+ or prestige modes

package/src/modules/bmm/workflows/2-plan-workflows/gdd/game-types/turn-based-tactics.md

@@ -0,0 +1,88 @@
+## Turn-Based Tactics Specific Elements
+
+<narrative-workflow-recommended>
+This game type is **narrative-moderate to heavy**. Consider running the Narrative Design workflow after completing the GDD to create:
+- Campaign story and mission briefings
+- Character backstories and development
+- Faction lore and motivations
+- Mission narratives
+</narrative-workflow-recommended>
+
+### Grid System and Movement
+
+{{grid_movement}}
+
+**Spatial design:**
+
+- Grid type (square, hex, free-form)
+- Movement range calculation
+- Movement types (walk, fly, teleport)
+- Terrain movement costs
+- Zone of control
+- Pathfinding visualization
+
+### Unit Types and Classes
+
+{{unit_classes}}
+
+**Unit design:**
+
+- Class roster (warrior, archer, mage, healer, etc.)
+- Class abilities and specializations
+- Unit progression (leveling, promotions)
+- Unit customization
+- Unique units (heroes, named characters)
+- Class balance and counters
+
+### Action Economy
+
+{{action_economy}}
+
+**Turn structure:**
+
+- Action points system (fixed, variable, pooled)
+- Action types (move, attack, ability, item, wait)
+- Free actions vs. costing actions
+- Opportunity attacks
+- Turn order (initiative, simultaneous, alternating)
+- Time limits per turn (if applicable)
+
+### Positioning and Tactics
+
+{{positioning_tactics}}
+
+**Strategic depth:**
+
+- Flanking mechanics
+- High ground advantage
+- Cover system
+- Formation bonuses
+- Area denial
+- Chokepoint tactics
+- Line of sight and vision
+
+### Terrain and Environmental Effects
+
+{{terrain_effects}}
+
+**Map design:**
+
+- Terrain types (grass, water, lava, ice, etc.)
+- Terrain effects (defense bonus, movement penalty, damage)
+- Destructible terrain
+- Interactive objects
+- Weather effects
+- Elevation and verticality
+
+### Campaign Structure
+
+{{campaign}}
+
+**Mission design:**
+
+- Campaign length and pacing
+- Mission variety (defeat all, survive, escort, capture, etc.)
+- Optional objectives
+- Branching campaigns
+- Permadeath vs. casualty systems
+- Resource management between missions

package/src/modules/bmm/workflows/2-plan-workflows/gdd/game-types/visual-novel.md

@@ -0,0 +1,89 @@
+## Visual Novel Specific Elements
+
+<narrative-workflow-critical>
+This game type is **narrative-critical**. You MUST run the Narrative Design workflow after completing the GDD to create:
+- Complete story structure and script
+- All character profiles and development arcs
+- Branching story flowcharts
+- Scene-by-scene breakdown
+- Dialogue drafts
+- Multiple route planning
+</narrative-workflow-critical>
+
+### Branching Story Structure
+
+{{branching_structure}}
+
+**Narrative design:**
+
+- Story route types (character routes, plot branches)
+- Branch points (choices, stats, flags)
+- Convergence points
+- Route length and pacing
+- True/golden ending requirements
+- Branch complexity (simple, moderate, complex)
+
+### Choice Impact System
+
+{{choice_impact}}
+
+**Decision mechanics:**
+
+- Choice types (immediate, delayed, hidden)
+- Choice visualization (explicit, subtle, invisible)
+- Point systems (affection, alignment, stats)
+- Flag tracking
+- Choice consequences
+- Meaningful vs. cosmetic choices
+
+### Route Design
+
+{{route_design}}
+
+**Route structure:**
+
+- Common route (shared beginning)
+- Individual routes (character-specific paths)
+- Route unlock conditions
+- Route length balance
+- Route independence vs. interconnection
+- Recommended play order
+
+### Character Relationship Systems
+
+{{relationship_systems}}
+
+**Character mechanics:**
+
+- Affection/friendship points
+- Relationship milestones
+- Character-specific scenes
+- Dialogue variations based on relationship
+- Multiple romance options (if applicable)
+- Platonic vs. romantic paths
+
+### Save/Load and Flowchart
+
+{{save_flowchart}}
+
+**Player navigation:**
+
+- Save point frequency
+- Quick save/load
+- Scene skip functionality
+- Flowchart/scene select (after completion)
+- Branch tracking visualization
+- Completion percentage
+
+### Art Asset Requirements
+
+{{art_assets}}
+
+**Visual content:**
+
+- Character sprites (poses, expressions)
+- Background art (locations, times of day)
+- CG artwork (key moments, endings)
+- UI elements
+- Special effects
+- Asset quantity estimates

package/src/modules/bmm/workflows/2-plan-workflows/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/modules/bmm/workflows/2-plan-workflows/gdd/gdd-template.md

@@ -0,0 +1,153 @@
+# {{game_name}} - Game Design Document
+
+**Author:** {{user_name}}
+**Game Type:** {{game_type}}
+**Target Platform(s):** {{platforms}}
+
+---
+
+## Executive Summary
+
+### Core Concept
+
+{{description}}
+
+### Target Audience
+
+{{target_audience}}
+
+### Unique Selling Points (USPs)
+
+{{unique_selling_points}}
+
+---
+
+## Goals and Context
+
+### Project Goals
+
+{{goals}}
+
+### Background and Rationale
+
+{{context}}
+
+---
+
+## Core Gameplay
+
+### Game Pillars
+
+{{game_pillars}}
+
+### Core Gameplay Loop
+
+{{gameplay_loop}}
+
+### Win/Loss Conditions
+
+{{win_loss_conditions}}
+
+---
+
+## Game Mechanics
+
+### Primary Mechanics
+
+{{primary_mechanics}}
+
+### Controls and Input
+
+{{controls}}
+
+---
+
+{{GAME_TYPE_SPECIFIC_SECTIONS}}
+
+---
+
+## Progression and Balance
+
+### Player Progression
+
+{{player_progression}}
+
+### Difficulty Curve
+
+{{difficulty_curve}}
+
+### Economy and Resources
+
+{{economy_resources}}
+
+---
+
+## Level Design Framework
+
+### Level Types
+
+{{level_types}}
+
+### Level Progression
+
+{{level_progression}}
+
+---
+
+## Art and Audio Direction
+
+### Art Style
+
+{{art_style}}
+
+### Audio and Music
+
+{{audio_music}}
+
+---
+
+## Technical Specifications
+
+### Performance Requirements
+
+{{performance_requirements}}
+
+### Platform-Specific Details
+
+{{platform_details}}
+
+### Asset Requirements
+
+{{asset_requirements}}
+
+---
+
+## Development Epics
+
+### Epic Structure
+
+{{epics}}
+
+---
+
+## Success Metrics
+
+### Technical Metrics
+
+{{technical_metrics}}
+
+### Gameplay Metrics
+
+{{gameplay_metrics}}
+
+---
+
+## Out of Scope
+
+{{out_of_scope}}
+
+---
+
+## Assumptions and Dependencies
+
+{{assumptions_and_dependencies}}