bmad-method 5.1.2 → 6.0.0-alpha.0

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

@@ -0,0 +1,87 @@
+## Metroidvania Specific Elements
+
+<narrative-workflow-recommended>
+This game type is **narrative-moderate**. Consider running the Narrative Design workflow after completing the GDD to create:
+- World lore and environmental storytelling
+- Character encounters and NPC arcs
+- Backstory reveals through exploration
+- Optional narrative depth
+</narrative-workflow-recommended>
+
+### Interconnected World Map
+
+{{world_map}}
+
+**Map design:**
+
+- World structure (regions, zones, biomes)
+- Interconnection points (shortcuts, elevators, warps)
+- Verticality and layering
+- Secret areas
+- Map reveal mechanics
+- Fast travel system (if applicable)
+
+### Ability-Gating System
+
+{{ability_gating}}
+
+**Progression gates:**
+
+- Core abilities (double jump, dash, wall climb, swim, etc.)
+- Ability locations and pacing
+- Soft gates vs. hard gates
+- Optional abilities
+- Sequence breaking considerations
+- Ability synergies
+
+### Backtracking Design
+
+{{backtracking}}
+
+**Return mechanics:**
+
+- Obvious backtrack opportunities
+- Hidden backtrack rewards
+- Fast travel to reduce tedium
+- Enemy respawn considerations
+- Changed world state (if applicable)
+- Completionist incentives
+
+### Exploration Rewards
+
+{{exploration_rewards}}
+
+**Discovery incentives:**
+
+- Health/energy upgrades
+- Ability upgrades
+- Collectibles (lore, cosmetics)
+- Secret bosses
+- Optional areas
+- Completion percentage tracking
+
+### Combat System
+
+{{combat_system}}
+
+**Combat mechanics:**
+
+- Attack types (melee, ranged, magic)
+- Boss fight design
+- Enemy variety and placement
+- Combat progression
+- Defensive options
+- Difficulty balance
+
+### Sequence Breaking
+
+{{sequence_breaking}}
+
+**Advanced play:**
+
+- Intended vs. unintended skips
+- Speedrun considerations
+- Difficulty of sequence breaks
+- Reward for sequence breaking
+- Developer stance on breaks
+- Game completion without all abilities

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

@@ -0,0 +1,74 @@
+## MOBA Specific Elements
+
+### Hero/Champion Roster
+
+{{hero_roster}}
+
+**Character design:**
+
+- Hero count (initial roster, planned additions)
+- Hero roles (tank, support, carry, assassin, mage, etc.)
+- Unique abilities per hero (Q, W, E, R + passive)
+- Hero complexity tiers (beginner-friendly vs. advanced)
+- Visual and thematic diversity
+- Counter-pick dynamics
+
+### Lane Structure & Map
+
+{{lane_map}}
+
+**Map design:**
+
+- Lane configuration (3-lane, 2-lane, custom)
+- Jungle/neutral areas
+- Objective locations (towers, inhibitors, nexus/ancient)
+- Spawn points and fountains
+- Vision mechanics (wards, fog of war)
+
+### Item & Build System
+
+{{item_build}}
+
+**Itemization:**
+
+- Item categories (offensive, defensive, utility, consumables)
+- Gold economy
+- Build paths and item trees
+- Situational itemization
+- Starting items vs. late-game items
+
+### Team Composition & Roles
+
+{{team_composition}}
+
+**Team strategy:**
+
+- Role requirements (1-3-1, 2-1-2, etc.)
+- Team synergies
+- Draft/ban phase (if applicable)
+- Meta considerations
+- Flexible vs. rigid compositions
+
+### Match Phases
+
+{{match_phases}}
+
+**Game flow:**
+
+- Early game (laning phase)
+- Mid game (roaming, objectives)
+- Late game (team fights, sieging)
+- Phase transition mechanics
+- Comeback mechanics
+
+### Objectives & Win Conditions
+
+{{objectives_victory}}
+
+**Strategic objectives:**
+
+- Primary objective (destroy base/nexus/ancient)
+- Secondary objectives (towers, dragons, baron, roshan, etc.)
+- Neutral camps
+- Vision control objectives
+- Time limits and sudden death (if applicable)

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

@@ -0,0 +1,79 @@
+## Party Game Specific Elements
+
+### Minigame Variety
+
+{{minigame_variety}}
+
+**Minigame design:**
+
+- Minigame count (launch + DLC)
+- Genre variety (racing, puzzle, reflex, trivia, etc.)
+- Minigame length (15-60 seconds typical)
+- Skill vs. luck balance
+- Team vs. FFA minigames
+- Accessibility across skill levels
+
+### Turn Structure
+
+{{turn_structure}}
+
+**Game flow:**
+
+- Board game structure (if applicable)
+- Turn order (fixed, random, earned)
+- Turn actions (roll dice, move, minigame, etc.)
+- Event spaces
+- Special mechanics (warp, steal, bonus)
+- Match length (rounds, turns, time)
+
+### Player Elimination vs. Points
+
+{{scoring_elimination}}
+
+**Competition design:**
+
+- Points-based (everyone plays to the end)
+- Elimination (last player standing)
+- Hybrid systems
+- Comeback mechanics
+- Handicap systems
+- Victory conditions
+
+### Local Multiplayer UX
+
+{{local_multiplayer}}
+
+**Couch co-op design:**
+
+- Controller sharing vs. individual controllers
+- Screen layout (split-screen, shared screen)
+- Turn clarity (whose turn indicators)
+- Spectator experience (watching others play)
+- Player join/drop mechanics
+- Tutorial integration for new players
+
+### Accessibility & Skill Range
+
+{{accessibility}}
+
+**Inclusive design:**
+
+- Skill floor (easy to understand)
+- Skill ceiling (depth for experienced players)
+- Luck elements to balance skill gaps
+- Assist modes or handicaps
+- Child-friendly content
+- Colorblind modes and accessibility
+
+### Session Length
+
+{{session_length}}
+
+**Time management:**
+
+- Quick play (5-10 minutes)
+- Standard match (15-30 minutes)
+- Extended match (30+ minutes)
+- Drop-in/drop-out support
+- Pause and resume
+- Party management (hosting, invites)

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

@@ -0,0 +1,58 @@
+## Puzzle Game Specific Elements
+
+### Core Puzzle Mechanics
+
+{{puzzle_mechanics}}
+
+**Puzzle elements:**
+
+- Primary puzzle mechanic(s)
+- Supporting mechanics
+- Mechanic interactions
+- Constraint systems
+
+### Puzzle Progression
+
+{{puzzle_progression}}
+
+**Difficulty progression:**
+
+- Tutorial/introduction puzzles
+- Core concept puzzles
+- Combined mechanic puzzles
+- Expert/bonus puzzles
+- Pacing and difficulty curve
+
+### Level Structure
+
+{{level_structure}}
+
+**Level organization:**
+
+- Number of levels/puzzles
+- World/chapter grouping
+- Unlock progression
+- Optional/bonus content
+
+### Player Assistance
+
+{{player_assistance}}
+
+**Help systems:**
+
+- Hint system
+- Undo/reset mechanics
+- Skip puzzle options
+- Tutorial integration
+
+### Replayability
+
+{{replayability}}
+
+**Replay elements:**
+
+- Par time/move goals
+- Perfect solution challenges
+- Procedural generation (if applicable)
+- Daily/weekly puzzles
+- Challenge modes

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

@@ -0,0 +1,88 @@
+## Racing Game Specific Elements
+
+### Vehicle Handling & Physics
+
+{{vehicle_physics}}
+
+**Handling systems:**
+
+- Physics model (arcade vs. simulation vs. hybrid)
+- Vehicle stats (speed, acceleration, handling, braking, weight)
+- Drift mechanics
+- Collision physics
+- Vehicle damage system (if applicable)
+
+### Vehicle Roster
+
+{{vehicle_roster}}
+
+**Vehicle design:**
+
+- Vehicle types (cars, bikes, boats, etc.)
+- Vehicle classes (lightweight, balanced, heavyweight)
+- Unlock progression
+- Customization options (visual, performance)
+- Balance considerations
+
+### Track Design
+
+{{track_design}}
+
+**Course design:**
+
+- Track variety (circuits, point-to-point, open world)
+- Track length and lap counts
+- Hazards and obstacles
+- Shortcuts and alternate paths
+- Track-specific mechanics
+- Environmental themes
+
+### Race Mechanics
+
+{{race_mechanics}}
+
+**Core racing:**
+
+- Starting mechanics (countdown, reaction time)
+- Checkpoint system
+- Lap tracking and position
+- Slipstreaming/drafting
+- Pit stops (if applicable)
+- Weather and time-of-day effects
+
+### Powerups & Boost
+
+{{powerups_boost}}
+
+**Enhancement systems (if arcade-style):**
+
+- Powerup types (offensive, defensive, utility)
+- Boost mechanics (drift boost, nitro, slipstream)
+- Item balance
+- Counterplay mechanics
+- Powerup placement on track
+
+### Game Modes
+
+{{game_modes}}
+
+**Mode variety:**
+
+- Standard race
+- Time trial
+- Elimination/knockout
+- Battle/arena modes
+- Career/campaign mode
+- Online multiplayer modes
+
+### Progression & Unlocks
+
+{{progression}}
+
+**Player advancement:**
+
+- Career structure
+- Unlockable vehicles and tracks
+- Currency/rewards system
+- Achievements and challenges
+- Skill-based unlocks vs. time-based

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

@@ -0,0 +1,79 @@
+## Rhythm Game Specific Elements
+
+### Music Synchronization
+
+{{music_sync}}
+
+**Core mechanics:**
+
+- Beat/rhythm detection
+- Note types (tap, hold, slide, etc.)
+- Synchronization accuracy
+- Audio-visual feedback
+- Lane systems (4-key, 6-key, circular, etc.)
+- Offset calibration
+
+### Note Charts & Patterns
+
+{{note_charts}}
+
+**Chart design:**
+
+- Charting philosophy (fun, challenge, accuracy to song)
+- Pattern vocabulary (streams, jumps, chords, etc.)
+- Difficulty representation
+- Special patterns (gimmicks, memes)
+- Chart preview
+- Custom chart support (if applicable)
+
+### Timing Windows
+
+{{timing_windows}}
+
+**Judgment system:**
+
+- Judgment tiers (perfect, great, good, bad, miss)
+- Timing windows (frame-perfect vs. lenient)
+- Visual feedback for timing
+- Audio feedback
+- Combo system
+- Health/life system (if applicable)
+
+### Scoring System
+
+{{scoring}}
+
+**Score design:**
+
+- Base score calculation
+- Combo multipliers
+- Accuracy weighting
+- Max score calculation
+- Grade/rank system (S, A, B, C)
+- Leaderboards and competition
+
+### Difficulty Tiers
+
+{{difficulty_tiers}}
+
+**Progression:**
+
+- Difficulty levels (easy, normal, hard, expert, etc.)
+- Difficulty representation (stars, numbers)
+- Unlock conditions
+- Difficulty curve
+- Accessibility options
+- Expert+ content
+
+### Song Selection
+
+{{song_selection}}
+
+**Music library:**
+
+- Song count (launch + planned DLC)
+- Genre diversity
+- Licensing vs. original music
+- Song length targets
+- Song unlock progression
+- Favorites and playlists

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

@@ -0,0 +1,69 @@
+## Roguelike Specific Elements
+
+### Run Structure
+
+{{run_structure}}
+
+**Run design:**
+
+- Run length (time, stages)
+- Starting conditions
+- Difficulty scaling per run
+- Victory conditions
+
+### Procedural Generation
+
+{{procedural_generation}}
+
+**Generation systems:**
+
+- Level generation algorithm
+- Enemy placement
+- Item/loot distribution
+- Biome/theme variation
+- Seed system (if deterministic)
+
+### Permadeath & Progression
+
+{{permadeath_progression}}
+
+**Death mechanics:**
+
+- Permadeath rules
+- What persists between runs
+- Meta-progression systems
+- Unlock conditions
+
+### Item & Upgrade System
+
+{{item_upgrade_system}}
+
+**Item mechanics:**
+
+- Item types (passive, active, consumable)
+- Rarity system
+- Item synergies
+- Build variety
+- Curse/risk mechanics
+
+### Character Selection
+
+{{character_selection}}
+
+**Playable characters:**
+
+- Starting characters
+- Unlockable characters
+- Character unique abilities
+- Character playstyle differences
+
+### Difficulty Modifiers
+
+{{difficulty_modifiers}}
+
+**Challenge systems:**
+
+- Difficulty tiers
+- Modifiers/curses
+- Challenge runs
+- Achievement conditions

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

@@ -0,0 +1,70 @@
+## RPG Specific Elements
+
+### Character System
+
+{{character_system}}
+
+**Character attributes:**
+
+- Stats (Strength, Dexterity, Intelligence, etc.)
+- Classes/roles
+- Leveling system
+- Skill trees
+
+### Inventory & Equipment
+
+{{inventory_equipment}}
+
+**Equipment system:**
+
+- Item types (weapons, armor, accessories)
+- Rarity tiers
+- Item stats and modifiers
+- Inventory management
+
+### Quest System
+
+{{quest_system}}
+
+**Quest structure:**
+
+- Main story quests
+- Side quests
+- Quest tracking
+- Branching questlines
+- Quest rewards
+
+### World & Exploration
+
+{{world_exploration}}
+
+**World design:**
+
+- Map structure (open world, hub-based, linear)
+- Towns and safe zones
+- Dungeons and combat zones
+- Fast travel system
+- Points of interest
+
+### NPC & Dialogue
+
+{{npc_dialogue}}
+
+**NPC interaction:**
+
+- Dialogue trees
+- Relationship/reputation system
+- Companion system
+- Merchant NPCs
+
+### Combat System
+
+{{combat_system}}
+
+**Combat mechanics:**
+
+- Combat style (real-time, turn-based, tactical)
+- Ability system
+- Magic/skill system
+- Status effects
+- Party composition (if applicable)

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

@@ -0,0 +1,79 @@
+## Sandbox Game Specific Elements
+
+### Creation Tools
+
+{{creation_tools}}
+
+**Building mechanics:**
+
+- Tool types (place, delete, modify, paint)
+- Object library (blocks, props, entities)
+- Precision controls (snap, free, grid)
+- Copy/paste and templates
+- Undo/redo system
+- Import/export functionality
+
+### Physics & Building Systems
+
+{{physics_building}}
+
+**System simulation:**
+
+- Physics engine (rigid body, soft body, fluids)
+- Structural integrity (if applicable)
+- Destruction mechanics
+- Material properties
+- Constraint systems (joints, hinges, motors)
+- Interactive simulations
+
+### Sharing & Community
+
+{{sharing_community}}
+
+**Social features:**
+
+- Creation sharing (workshop, gallery)
+- Discoverability (search, trending, featured)
+- Rating and feedback systems
+- Collaboration tools
+- Modding support
+- User-generated content moderation
+
+### Constraints & Rules
+
+{{constraints_rules}}
+
+**Game design:**
+
+- Creative mode (unlimited resources, no objectives)
+- Challenge mode (limited resources, objectives)
+- Budget/point systems (if competitive)
+- Build limits (size, complexity)
+- Rulesets and game modes
+- Victory conditions (if applicable)
+
+### Tools & Editing
+
+{{tools_editing}}
+
+**Advanced features:**
+
+- Logic gates/scripting (if applicable)
+- Animation tools
+- Terrain editing
+- Weather/environment controls
+- Lighting and effects
+- Testing/preview modes
+
+### Emergent Gameplay
+
+{{emergent_gameplay}}
+
+**Player creativity:**
+
+- Unintended creations (embracing exploits)
+- Community-defined challenges
+- Speedrunning player creations
+- Cross-creation interaction
+- Viral moments and showcases
+- Evolution of the meta