@bmad/bmad-game-dev-studio 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.markdownlint-cli2.yaml +35 -0
  2. package/.nvmrc +1 -0
  3. package/.prettierignore +9 -0
  4. package/LICENSE +26 -0
  5. package/README.md +119 -0
  6. package/eslint.config.mjs +152 -0
  7. package/package.json +91 -0
  8. package/prettier.config.mjs +32 -0
  9. package/src/_module-installer/installer.js +110 -0
  10. package/src/_module-installer/platform-specifics/claude-code.js +23 -0
  11. package/src/_module-installer/platform-specifics/windsurf.js +18 -0
  12. package/src/agents/game-architect.agent.yaml +40 -0
  13. package/src/agents/game-designer.agent.yaml +45 -0
  14. package/src/agents/game-dev.agent.yaml +49 -0
  15. package/src/agents/game-qa.agent.yaml +63 -0
  16. package/src/agents/game-scrum-master.agent.yaml +56 -0
  17. package/src/agents/game-solo-dev.agent.yaml +49 -0
  18. package/src/agents/tech-writer/tech-writer.agent.yaml +45 -0
  19. package/src/gametest/qa-index.csv +18 -0
  20. package/src/module-help.csv +26 -0
  21. package/src/module.yaml +65 -0
  22. package/src/teams/default-party.csv +12 -0
  23. package/src/teams/team-gamedev.yaml +29 -0
  24. package/src/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv +26 -0
  25. package/src/workflows/1-preproduction/brainstorm-game/workflow.yaml +62 -0
  26. package/src/workflows/1-preproduction/game-brief/workflow.yaml +67 -0
  27. package/src/workflows/2-design/gdd/game-types.csv +25 -0
  28. package/src/workflows/2-design/gdd/workflow.yaml +101 -0
  29. package/src/workflows/2-design/narrative/workflow.yaml +77 -0
  30. package/src/workflows/3-technical/game-architecture/architecture-patterns.yaml +507 -0
  31. package/src/workflows/3-technical/game-architecture/decision-catalog.yaml +340 -0
  32. package/src/workflows/3-technical/game-architecture/engine-mcps.yaml +270 -0
  33. package/src/workflows/3-technical/game-architecture/pattern-categories.csv +13 -0
  34. package/src/workflows/3-technical/game-architecture/workflow.yaml +101 -0
  35. package/src/workflows/4-production/code-review/instructions.xml +226 -0
  36. package/src/workflows/4-production/code-review/workflow.yaml +64 -0
  37. package/src/workflows/4-production/correct-course/workflow.yaml +65 -0
  38. package/src/workflows/4-production/create-story/instructions.xml +345 -0
  39. package/src/workflows/4-production/create-story/workflow.yaml +61 -0
  40. package/src/workflows/4-production/dev-story/instructions.xml +410 -0
  41. package/src/workflows/4-production/dev-story/workflow.yaml +27 -0
  42. package/src/workflows/4-production/retrospective/workflow.yaml +58 -0
  43. package/src/workflows/4-production/sprint-planning/sprint-status-template.yaml +55 -0
  44. package/src/workflows/4-production/sprint-planning/workflow.yaml +54 -0
  45. package/src/workflows/4-production/sprint-status/workflow.yaml +35 -0
  46. package/src/workflows/document-project/documentation-requirements.csv +12 -0
  47. package/src/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  48. package/src/workflows/document-project/workflow.yaml +30 -0
  49. package/src/workflows/document-project/workflows/deep-dive.yaml +31 -0
  50. package/src/workflows/document-project/workflows/full-scan.yaml +31 -0
  51. package/src/workflows/gametest/automate/workflow.yaml +50 -0
  52. package/src/workflows/gametest/e2e-scaffold/workflow.yaml +145 -0
  53. package/src/workflows/gametest/performance/workflow.yaml +48 -0
  54. package/src/workflows/gametest/playtest-plan/workflow.yaml +59 -0
  55. package/src/workflows/gametest/test-design/workflow.yaml +47 -0
  56. package/src/workflows/gametest/test-framework/workflow.yaml +48 -0
  57. package/src/workflows/gametest/test-review/workflow.yaml +48 -0
package/src/workflows/1-preproduction/game-brief/workflow.yaml ADDED
@@ -0,0 +1,67 @@
1
+ # Game Brief - Interactive Workflow Configuration
2
+ name: game-brief
3
+ description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
4
+ author: "BMad"
5
+
6
+ # Critical variables from config
7
+ config_source: "{project-root}/_bmad/gds/config.yaml"
8
+ output_folder: "{config_source}:output_folder"
9
+ user_name: "{config_source}:user_name"
10
+ communication_language: "{config_source}:communication_language"
11
+ document_output_language: "{config_source}:document_output_language"
12
+ game_dev_experience: "{config_source}:game_dev_experience"
13
+ date: system-generated
14
+
15
+ # Workflow components - Step-file architecture
16
+ installed_path: "{project-root}/_bmad/gds/workflows/1-preproduction/game-brief"
17
+ instructions: "{installed_path}/workflow.md"
18
+ template: "{installed_path}/templates/game-brief-template.md"
19
+ validation: "{installed_path}/checklist.md"
20
+
21
+ # Smart input file references - handles brainstorming/research docs
22
+ input_file_patterns:
23
+ brainstorm:
24
+ description: "Brainstorming or ideation documents (optional)"
25
+ whole: "{output_folder}/*brainstorm*.md"
26
+ sharded: "{output_folder}/*brainstorm*/index.md"
27
+ load_strategy: "FULL_LOAD"
28
+
29
+ research:
30
+ description: "Market or domain research (optional)"
31
+ whole: "{output_folder}/*research*.md"
32
+ sharded: "{output_folder}/*research*/index.md"
33
+ load_strategy: "FULL_LOAD"
34
+
35
+ inspiration:
36
+ description: "Inspiration or reference documents (optional)"
37
+ whole: "{output_folder}/*inspiration*.md"
38
+ sharded: "{output_folder}/*inspiration*/index.md"
39
+ load_strategy: "FULL_LOAD"
40
+
41
+ # Output configuration
42
+ default_output_file: "{output_folder}/game-brief.md"
43
+
44
+ standalone: true
45
+
46
+ web_bundle:
47
+ name: "game-brief"
48
+ description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
49
+ author: "BMad"
50
+ instructions: "_bmad/gds/workflows/1-preproduction/game-brief/workflow.md"
51
+ web_bundle_files:
52
+ # Main workflow file
53
+ - "_bmad/gds/workflows/1-preproduction/game-brief/workflow.md"
54
+ # Step files
55
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-01-init.md"
56
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-01b-continue.md"
57
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-02-vision.md"
58
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-03-market.md"
59
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md"
60
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-05-scope.md"
61
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-06-references.md"
62
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-07-content.md"
63
+ - "_bmad/gds/workflows/1-preproduction/game-brief/steps/step-08-complete.md"
64
+ # Template
65
+ - "_bmad/gds/workflows/1-preproduction/game-brief/templates/game-brief-template.md"
66
+ # Validation checklist
67
+ - "_bmad/gds/workflows/1-preproduction/game-brief/checklist.md"
package/src/workflows/2-design/gdd/game-types.csv ADDED
@@ -0,0 +1,25 @@
1
+ id,name,description,genre_tags,fragment_file
2
+ action-platformer,Action Platformer,"Side-scrolling or 3D platforming with combat mechanics","action,platformer,combat,movement",action-platformer.md
3
+ puzzle,Puzzle,"Logic-based challenges and problem-solving","puzzle,logic,cerebral",puzzle.md
4
+ rpg,RPG,"Character progression, stats, inventory, quests","rpg,stats,inventory,quests,narrative",rpg.md
5
+ strategy,Strategy,"Resource management, tactical decisions, long-term planning","strategy,tactics,resources,planning",strategy.md
6
+ shooter,Shooter,"Projectile combat, aiming mechanics, arena/level design","shooter,combat,aiming,fps,tps",shooter.md
7
+ adventure,Adventure,"Story-driven exploration and narrative","adventure,narrative,exploration,story",adventure.md
8
+ simulation,Simulation,"Realistic systems, management, building","simulation,management,sandbox,systems",simulation.md
9
+ roguelike,Roguelike,"Procedural generation, permadeath, run-based progression","roguelike,procedural,permadeath,runs",roguelike.md
10
+ moba,MOBA,"Multiplayer team battles, hero/champion selection, lanes","moba,multiplayer,pvp,heroes,lanes",moba.md
11
+ fighting,Fighting,"1v1 combat, combos, frame data, competitive","fighting,combat,competitive,combos,pvp",fighting.md
12
+ racing,Racing,"Vehicle control, tracks, speed, lap times","racing,vehicles,tracks,speed",racing.md
13
+ sports,Sports,"Team-based or individual sports simulation","sports,teams,realistic,physics",sports.md
14
+ survival,Survival,"Resource gathering, crafting, persistent threats","survival,crafting,resources,danger",survival.md
15
+ horror,Horror,"Atmosphere, tension, limited resources, fear mechanics","horror,atmosphere,tension,fear",horror.md
16
+ idle-incremental,Idle/Incremental,"Passive progression, upgrades, automation","idle,incremental,automation,progression",idle-incremental.md
17
+ card-game,Card Game,"Deck building, card mechanics, turn-based strategy","card,deck-building,strategy,turns",card-game.md
18
+ tower-defense,Tower Defense,"Wave-based defense, tower placement, resource management","tower-defense,waves,placement,strategy",tower-defense.md
19
+ metroidvania,Metroidvania,"Interconnected world, ability gating, exploration","metroidvania,exploration,abilities,interconnected",metroidvania.md
20
+ visual-novel,Visual Novel,"Narrative choices, branching story, dialogue","visual-novel,narrative,choices,story",visual-novel.md
21
+ rhythm,Rhythm,"Music synchronization, timing-based gameplay","rhythm,music,timing,beats",rhythm.md
22
+ turn-based-tactics,Turn-Based Tactics,"Grid-based movement, turn order, positioning","tactics,turn-based,grid,positioning",turn-based-tactics.md
23
+ sandbox,Sandbox,"Creative freedom, building, minimal objectives","sandbox,creative,building,freedom",sandbox.md
24
+ text-based,Text-Based,"Text input/output, parser or choice-based","text,parser,interactive-fiction,mud",text-based.md
25
+ party-game,Party Game,"Local multiplayer, minigames, casual fun","party,multiplayer,minigames,casual",party-game.md
package/src/workflows/2-design/gdd/workflow.yaml ADDED
@@ -0,0 +1,101 @@
1
+ # Game Design Document (GDD) Workflow
2
+ name: gdd
3
+ 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."
4
+ author: "BMad"
5
+
6
+ # Critical variables from config
7
+ config_source: "{project-root}/_bmad/gds/config.yaml"
8
+ output_folder: "{config_source}:output_folder"
9
+ user_name: "{config_source}:user_name"
10
+ communication_language: "{config_source}:communication_language"
11
+ document_output_language: "{config_source}:document_output_language"
12
+ game_dev_experience: "{config_source}:game_dev_experience"
13
+ date: system-generated
14
+
15
+ # Workflow components - Step-file architecture
16
+ installed_path: "{project-root}/_bmad/gds/workflows/2-design/gdd"
17
+ instructions: "{installed_path}/workflow.md"
18
+ template: "{installed_path}/templates/gdd-template.md"
19
+ game_types_csv: "{installed_path}/game-types.csv"
20
+
21
+ # Output configuration
22
+ default_output_file: "{output_folder}/gdd.md"
23
+
24
+ # Game type references (loaded based on game type selection)
25
+ game_type_guides: "{installed_path}/game-types/"
26
+
27
+ # Smart input file references - handles both whole docs and sharded docs
28
+ # Priority: Whole document first, then sharded version
29
+ input_file_patterns:
30
+ game_brief:
31
+ description: "Game vision and core concept (optional)"
32
+ whole: "{output_folder}/*game-brief*.md"
33
+ sharded: "{output_folder}/*game-brief*/index.md"
34
+ load_strategy: "INDEX_GUIDED"
35
+
36
+ research:
37
+ description: "Market or domain research (optional)"
38
+ whole: "{output_folder}/*research*.md"
39
+ sharded: "{output_folder}/*research*/index.md"
40
+ load_strategy: "FULL_LOAD"
41
+
42
+ document_project:
43
+ description: "Brownfield project documentation (optional)"
44
+ sharded: "{output_folder}/index.md"
45
+ load_strategy: "INDEX_GUIDED"
46
+
47
+ standalone: true
48
+
49
+ web_bundle:
50
+ name: "gdd"
51
+ 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."
52
+ author: "BMad"
53
+ instructions: "_bmad/gds/workflows/2-design/gdd/workflow.md"
54
+ web_bundle_files:
55
+ # Main workflow file
56
+ - "_bmad/gds/workflows/2-design/gdd/workflow.md"
57
+ # Step files
58
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-01-init.md"
59
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-01b-continue.md"
60
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-02-context.md"
61
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-03-platforms.md"
62
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-04-vision.md"
63
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-05-core-gameplay.md"
64
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-06-mechanics.md"
65
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-07-game-type.md"
66
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-08-progression.md"
67
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-09-levels.md"
68
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-10-art-audio.md"
69
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-11-technical.md"
70
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-12-epics.md"
71
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-13-metrics.md"
72
+ - "_bmad/gds/workflows/2-design/gdd/steps/step-14-complete.md"
73
+ # Template
74
+ - "_bmad/gds/workflows/2-design/gdd/templates/gdd-template.md"
75
+ # Data files
76
+ - "_bmad/gds/workflows/2-design/gdd/game-types.csv"
77
+ # Game type guides
78
+ - "_bmad/gds/workflows/2-design/gdd/game-types/action-platformer.md"
79
+ - "_bmad/gds/workflows/2-design/gdd/game-types/adventure.md"
80
+ - "_bmad/gds/workflows/2-design/gdd/game-types/card-game.md"
81
+ - "_bmad/gds/workflows/2-design/gdd/game-types/fighting.md"
82
+ - "_bmad/gds/workflows/2-design/gdd/game-types/horror.md"
83
+ - "_bmad/gds/workflows/2-design/gdd/game-types/idle-incremental.md"
84
+ - "_bmad/gds/workflows/2-design/gdd/game-types/metroidvania.md"
85
+ - "_bmad/gds/workflows/2-design/gdd/game-types/moba.md"
86
+ - "_bmad/gds/workflows/2-design/gdd/game-types/party-game.md"
87
+ - "_bmad/gds/workflows/2-design/gdd/game-types/puzzle.md"
88
+ - "_bmad/gds/workflows/2-design/gdd/game-types/racing.md"
89
+ - "_bmad/gds/workflows/2-design/gdd/game-types/rhythm.md"
90
+ - "_bmad/gds/workflows/2-design/gdd/game-types/roguelike.md"
91
+ - "_bmad/gds/workflows/2-design/gdd/game-types/rpg.md"
92
+ - "_bmad/gds/workflows/2-design/gdd/game-types/sandbox.md"
93
+ - "_bmad/gds/workflows/2-design/gdd/game-types/shooter.md"
94
+ - "_bmad/gds/workflows/2-design/gdd/game-types/simulation.md"
95
+ - "_bmad/gds/workflows/2-design/gdd/game-types/sports.md"
96
+ - "_bmad/gds/workflows/2-design/gdd/game-types/strategy.md"
97
+ - "_bmad/gds/workflows/2-design/gdd/game-types/survival.md"
98
+ - "_bmad/gds/workflows/2-design/gdd/game-types/text-based.md"
99
+ - "_bmad/gds/workflows/2-design/gdd/game-types/tower-defense.md"
100
+ - "_bmad/gds/workflows/2-design/gdd/game-types/turn-based-tactics.md"
101
+ - "_bmad/gds/workflows/2-design/gdd/game-types/visual-novel.md"
package/src/workflows/2-design/narrative/workflow.yaml ADDED
@@ -0,0 +1,77 @@
1
+ # Narrative Design Workflow
2
+ name: narrative
3
+ description: "Narrative design workflow for story-driven games. Creates comprehensive narrative documentation including story structure, character arcs, world-building, dialogue systems, and production planning."
4
+ author: "BMad"
5
+
6
+ # Critical variables from config
7
+ config_source: "{project-root}/_bmad/gds/config.yaml"
8
+ output_folder: "{config_source}:output_folder"
9
+ user_name: "{config_source}:user_name"
10
+ communication_language: "{config_source}:communication_language"
11
+ document_output_language: "{config_source}:document_output_language"
12
+ game_dev_experience: "{config_source}:game_dev_experience"
13
+ date: system-generated
14
+
15
+ # Workflow components - Step-file architecture
16
+ installed_path: "{project-root}/_bmad/gds/workflows/2-design/narrative"
17
+ instructions: "{installed_path}/workflow.md"
18
+ template: "{installed_path}/templates/narrative-template.md"
19
+ validation: "{installed_path}/checklist.md"
20
+
21
+ # Smart input file references
22
+ input_file_patterns:
23
+ gdd:
24
+ description: "Game Design Document with mechanics and systems"
25
+ whole: "{output_folder}/*gdd*.md"
26
+ sharded: "{output_folder}/*gdd*/index.md"
27
+ load_strategy: "INDEX_GUIDED"
28
+
29
+ brief:
30
+ description: "Game Brief with vision (optional)"
31
+ whole: "{output_folder}/*brief*.md"
32
+ sharded: "{output_folder}/*brief*/index.md"
33
+ load_strategy: "INDEX_GUIDED"
34
+
35
+ # Output configuration
36
+ default_output_file: "{output_folder}/narrative-design.md"
37
+
38
+ # Workflow metadata
39
+ version: "2.0.0"
40
+ paradigm: "step-file-architecture"
41
+ features:
42
+ - "Step-file architecture for modular execution"
43
+ - "Narrative complexity assessment"
44
+ - "Character development facilitation"
45
+ - "World-building guidance"
46
+ - "Dialogue system design"
47
+ - "Environmental storytelling planning"
48
+ - "Production scope estimation"
49
+ - "State tracking via frontmatter"
50
+
51
+ standalone: true
52
+
53
+ web_bundle:
54
+ name: "narrative"
55
+ description: "Narrative design workflow for story-driven games"
56
+ author: "BMad"
57
+ instructions: "_bmad/gds/workflows/2-design/narrative/workflow.md"
58
+ web_bundle_files:
59
+ # Main workflow file
60
+ - "_bmad/gds/workflows/2-design/narrative/workflow.md"
61
+ # Step files
62
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-01-init.md"
63
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-01b-continue.md"
64
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-02-foundation.md"
65
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-03-story.md"
66
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-04-characters.md"
67
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-05-world.md"
68
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-06-dialogue.md"
69
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-07-environmental.md"
70
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-08-delivery.md"
71
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-09-integration.md"
72
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-10-production.md"
73
+ - "_bmad/gds/workflows/2-design/narrative/steps/step-11-complete.md"
74
+ # Template
75
+ - "_bmad/gds/workflows/2-design/narrative/templates/narrative-template.md"
76
+ # Validation checklist
77
+ - "_bmad/gds/workflows/2-design/narrative/checklist.md"