bmad-method 5.0.0-beta.2 → 5.0.1

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 (131) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +3 -3
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +3 -3
  3. package/.github/workflows/discord.yaml +11 -2
  4. package/.github/workflows/format-check.yaml +42 -0
  5. package/.github/workflows/manual-release.yaml +173 -0
  6. package/.husky/pre-commit +3 -0
  7. package/.vscode/settings.json +26 -1
  8. package/CHANGELOG.md +0 -11
  9. package/README.md +2 -0
  10. package/bmad-core/agent-teams/team-all.yaml +1 -1
  11. package/bmad-core/agents/bmad-orchestrator.md +1 -1
  12. package/bmad-core/agents/dev.md +4 -4
  13. package/bmad-core/data/bmad-kb.md +1 -1
  14. package/bmad-core/data/test-levels-framework.md +12 -12
  15. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  16. package/bmad-core/tasks/nfr-assess.md +10 -10
  17. package/bmad-core/tasks/qa-gate.md +23 -23
  18. package/bmad-core/tasks/review-story.md +18 -18
  19. package/bmad-core/tasks/risk-profile.md +25 -25
  20. package/bmad-core/tasks/test-design.md +9 -9
  21. package/bmad-core/tasks/trace-requirements.md +21 -21
  22. package/bmad-core/templates/architecture-tmpl.yaml +49 -49
  23. package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
  24. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
  25. package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
  26. package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
  27. package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
  28. package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
  29. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
  30. package/bmad-core/templates/market-research-tmpl.yaml +2 -2
  31. package/bmad-core/templates/prd-tmpl.yaml +9 -9
  32. package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
  33. package/bmad-core/templates/qa-gate-tmpl.yaml +9 -9
  34. package/bmad-core/templates/story-tmpl.yaml +12 -12
  35. package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
  36. package/bmad-core/workflows/brownfield-service.yaml +1 -1
  37. package/bmad-core/workflows/brownfield-ui.yaml +1 -1
  38. package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
  39. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  40. package/bmad-core/workflows/greenfield-ui.yaml +1 -1
  41. package/common/utils/bmad-doc-template.md +5 -5
  42. package/dist/agents/analyst.txt +28 -15
  43. package/dist/agents/architect.txt +220 -190
  44. package/dist/agents/bmad-master.txt +298 -255
  45. package/dist/agents/bmad-orchestrator.txt +1 -1
  46. package/dist/agents/pm.txt +20 -20
  47. package/dist/agents/po.txt +11 -11
  48. package/dist/agents/qa.txt +275 -618
  49. package/dist/agents/sm.txt +11 -11
  50. package/dist/agents/ux-expert.txt +23 -23
  51. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -109
  52. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -77
  53. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -41
  54. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +483 -474
  55. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +1 -1
  56. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -149
  57. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -20
  58. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +371 -358
  59. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -25
  60. package/dist/teams/team-all.txt +581 -881
  61. package/dist/teams/team-fullstack.txt +316 -273
  62. package/dist/teams/team-ide-minimal.txt +276 -619
  63. package/dist/teams/team-no-ui.txt +281 -238
  64. package/docs/versioning-and-releases.md +114 -44
  65. package/eslint.config.mjs +119 -0
  66. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +26 -26
  67. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
  68. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
  69. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
  70. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
  71. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
  72. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
  73. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
  74. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  75. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  76. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
  77. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
  78. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
  79. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
  80. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
  81. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
  82. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  83. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  84. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
  85. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
  86. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
  87. package/package.json +62 -39
  88. package/prettier.config.mjs +32 -0
  89. package/release_notes.md +30 -0
  90. package/tools/bmad-npx-wrapper.js +10 -10
  91. package/tools/builders/web-builder.js +124 -130
  92. package/tools/bump-all-versions.js +42 -33
  93. package/tools/bump-expansion-version.js +23 -16
  94. package/tools/cli.js +10 -12
  95. package/tools/flattener/aggregate.js +10 -10
  96. package/tools/flattener/binary.js +44 -17
  97. package/tools/flattener/discovery.js +19 -18
  98. package/tools/flattener/files.js +6 -6
  99. package/tools/flattener/ignoreRules.js +125 -125
  100. package/tools/flattener/main.js +201 -304
  101. package/tools/flattener/projectRoot.js +75 -73
  102. package/tools/flattener/prompts.js +9 -9
  103. package/tools/flattener/stats.helpers.js +131 -67
  104. package/tools/flattener/stats.js +3 -3
  105. package/tools/flattener/test-matrix.js +201 -193
  106. package/tools/flattener/xml.js +33 -31
  107. package/tools/installer/bin/bmad.js +130 -89
  108. package/tools/installer/config/ide-agent-config.yaml +1 -1
  109. package/tools/installer/config/install.config.yaml +2 -2
  110. package/tools/installer/lib/config-loader.js +46 -42
  111. package/tools/installer/lib/file-manager.js +91 -113
  112. package/tools/installer/lib/ide-base-setup.js +57 -56
  113. package/tools/installer/lib/ide-setup.js +375 -343
  114. package/tools/installer/lib/installer.js +875 -714
  115. package/tools/installer/lib/memory-profiler.js +54 -53
  116. package/tools/installer/lib/module-manager.js +19 -15
  117. package/tools/installer/lib/resource-locator.js +26 -28
  118. package/tools/installer/package.json +19 -19
  119. package/tools/lib/dependency-resolver.js +26 -30
  120. package/tools/lib/yaml-utils.js +7 -7
  121. package/tools/preview-release-notes.js +66 -0
  122. package/tools/shared/bannerArt.js +3 -3
  123. package/tools/sync-installer-version.js +7 -9
  124. package/tools/update-expansion-version.js +14 -15
  125. package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
  126. package/tools/version-bump.js +41 -26
  127. package/tools/yaml-format.js +56 -43
  128. package/.github/workflows/promote-to-stable.yml +0 -144
  129. package/.github/workflows/release.yaml +0 -60
  130. package/.releaserc.json +0 -21
  131. package/tools/semantic-release-sync-installer.js +0 -30
@@ -775,7 +775,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
775
775
 
776
776
  - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
777
777
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
778
- - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
778
+ - **Windsurf**: `/agent-name` (e.g., `/bmad-master`)
779
779
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
780
780
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-master`)
781
781
  - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
@@ -1210,7 +1210,7 @@ sections:
1210
1210
  condition: PRD has UX/UI requirements
1211
1211
  instruction: |
1212
1212
  Capture high-level UI/UX vision to guide Design Architect and to inform story creation. Steps:
1213
-
1213
+
1214
1214
  1. Pre-fill all subsections with educated guesses based on project context
1215
1215
  2. Present the complete rendered section to user
1216
1216
  3. Clearly let the user know where assumptions were made
@@ -1252,7 +1252,7 @@ sections:
1252
1252
  title: Technical Assumptions
1253
1253
  instruction: |
1254
1254
  Gather technical decisions that will guide the Architect. Steps:
1255
-
1255
+
1256
1256
  1. Check if .bmad-core/data/technical-preferences.yaml or an attached technical-preferences file exists - use it to pre-populate choices
1257
1257
  2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
1258
1258
  3. For unknowns, offer guidance based on project goals and MVP scope
@@ -1280,9 +1280,9 @@ sections:
1280
1280
  title: Epic List
1281
1281
  instruction: |
1282
1282
  Present a high-level list of all epics for user approval. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
1283
-
1283
+
1284
1284
  CRITICAL: Epics MUST be logically sequential following agile best practices:
1285
-
1285
+
1286
1286
  - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
1287
1287
  - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page - remember this when we produce the stories for the first epic!
1288
1288
  - Each subsequent epic builds upon previous epics' functionality delivering major blocks of functionality that provide tangible value to users or business when deployed
@@ -1301,11 +1301,11 @@ sections:
1301
1301
  repeatable: true
1302
1302
  instruction: |
1303
1303
  After the epic list is approved, present each epic with all its stories and acceptance criteria as a complete review unit.
1304
-
1304
+
1305
1305
  For each epic provide expanded goal (2-3 sentences describing the objective and value all the stories will achieve).
1306
-
1306
+
1307
1307
  CRITICAL STORY SEQUENCING REQUIREMENTS:
1308
-
1308
+
1309
1309
  - Stories within each epic MUST be logically sequential
1310
1310
  - Each story should be a "vertical slice" delivering complete functionality aside from early enabler stories for project foundation
1311
1311
  - No story should depend on work from a later story or epic
@@ -1333,7 +1333,7 @@ sections:
1333
1333
  repeatable: true
1334
1334
  instruction: |
1335
1335
  Define clear, comprehensive, and testable acceptance criteria that:
1336
-
1336
+
1337
1337
  - Precisely define what "done" means from a functional perspective
1338
1338
  - Are unambiguous and serve as basis for verification
1339
1339
  - Include any critical non-functional requirements from the PRD
@@ -1375,19 +1375,19 @@ sections:
1375
1375
  title: Intro Project Analysis and Context
1376
1376
  instruction: |
1377
1377
  IMPORTANT - SCOPE ASSESSMENT REQUIRED:
1378
-
1378
+
1379
1379
  This PRD is for SIGNIFICANT enhancements to existing projects that require comprehensive planning and multiple stories. Before proceeding:
1380
-
1380
+
1381
1381
  1. **Assess Enhancement Complexity**: If this is a simple feature addition or bug fix that could be completed in 1-2 focused development sessions, STOP and recommend: "For simpler changes, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead. This full PRD process is designed for substantial enhancements that require architectural planning and multiple coordinated stories."
1382
-
1382
+
1383
1383
  2. **Project Context**: Determine if we're working in an IDE with the project already loaded or if the user needs to provide project information. If project files are available, analyze existing documentation in the docs folder. If insufficient documentation exists, recommend running the document-project task first.
1384
-
1384
+
1385
1385
  3. **Deep Assessment Requirement**: You MUST thoroughly analyze the existing project structure, patterns, and constraints before making ANY suggestions. Every recommendation must be grounded in actual project analysis, not assumptions.
1386
-
1386
+
1387
1387
  Gather comprehensive information about the existing project. This section must be completed before proceeding with requirements.
1388
-
1388
+
1389
1389
  CRITICAL: Throughout this analysis, explicitly confirm your understanding with the user. For every assumption you make about the existing project, ask: "Based on my analysis, I understand that [assumption]. Is this correct?"
1390
-
1390
+
1391
1391
  Do not proceed with any recommendations until the user has validated your understanding of the existing system.
1392
1392
  sections:
1393
1393
  - id: existing-project-overview
@@ -1413,7 +1413,7 @@ sections:
1413
1413
  - Note: "Document-project analysis available - using existing technical documentation"
1414
1414
  - List key documents created by document-project
1415
1415
  - Skip the missing documentation check below
1416
-
1416
+
1417
1417
  Otherwise, check for existing documentation:
1418
1418
  sections:
1419
1419
  - id: available-docs
@@ -1537,7 +1537,7 @@ sections:
1537
1537
  If document-project output available:
1538
1538
  - Extract from "Actual Tech Stack" table in High Level Architecture section
1539
1539
  - Include version numbers and any noted constraints
1540
-
1540
+
1541
1541
  Otherwise, document the current technology stack:
1542
1542
  template: |
1543
1543
  **Languages**: {{languages}}
@@ -1576,7 +1576,7 @@ sections:
1576
1576
  - Reference "Technical Debt and Known Issues" section
1577
1577
  - Include "Workarounds and Gotchas" that might impact enhancement
1578
1578
  - Note any identified constraints from "Critical Technical Debt"
1579
-
1579
+
1580
1580
  Build risk assessment incorporating existing known issues:
1581
1581
  template: |
1582
1582
  **Technical Risks**: {{technical_risks}}
@@ -1599,7 +1599,7 @@ sections:
1599
1599
  title: "Epic 1: {{enhancement_title}}"
1600
1600
  instruction: |
1601
1601
  Comprehensive epic that delivers the brownfield enhancement while maintaining existing functionality
1602
-
1602
+
1603
1603
  CRITICAL STORY SEQUENCING FOR BROWNFIELD:
1604
1604
  - Stories must ensure existing functionality remains intact
1605
1605
  - Each story should include verification that existing features still work
@@ -1612,7 +1612,7 @@ sections:
1612
1612
  - Each story must deliver value while maintaining system integrity
1613
1613
  template: |
1614
1614
  **Epic Goal**: {{epic_goal}}
1615
-
1615
+
1616
1616
  **Integration Requirements**: {{integration_requirements}}
1617
1617
  sections:
1618
1618
  - id: story
@@ -600,7 +600,7 @@ workflow:
600
600
  elicitation: advanced-elicitation
601
601
 
602
602
  agent_config:
603
- editable_sections:
603
+ editable_sections:
604
604
  - Status
605
605
  - Story
606
606
  - Acceptance Criteria
@@ -617,7 +617,7 @@ sections:
617
617
  instruction: Select the current status of the story
618
618
  owner: scrum-master
619
619
  editors: [scrum-master, dev-agent]
620
-
620
+
621
621
  - id: story
622
622
  title: Story
623
623
  type: template-text
@@ -629,7 +629,7 @@ sections:
629
629
  elicit: true
630
630
  owner: scrum-master
631
631
  editors: [scrum-master]
632
-
632
+
633
633
  - id: acceptance-criteria
634
634
  title: Acceptance Criteria
635
635
  type: numbered-list
@@ -637,7 +637,7 @@ sections:
637
637
  elicit: true
638
638
  owner: scrum-master
639
639
  editors: [scrum-master]
640
-
640
+
641
641
  - id: tasks-subtasks
642
642
  title: Tasks / Subtasks
643
643
  type: bullet-list
@@ -654,7 +654,7 @@ sections:
654
654
  elicit: true
655
655
  owner: scrum-master
656
656
  editors: [scrum-master, dev-agent]
657
-
657
+
658
658
  - id: dev-notes
659
659
  title: Dev Notes
660
660
  instruction: |
@@ -678,7 +678,7 @@ sections:
678
678
  elicit: true
679
679
  owner: scrum-master
680
680
  editors: [scrum-master]
681
-
681
+
682
682
  - id: change-log
683
683
  title: Change Log
684
684
  type: table
@@ -686,7 +686,7 @@ sections:
686
686
  instruction: Track changes made to this story document
687
687
  owner: scrum-master
688
688
  editors: [scrum-master, dev-agent, qa-agent]
689
-
689
+
690
690
  - id: dev-agent-record
691
691
  title: Dev Agent Record
692
692
  instruction: This section is populated by the development agent during implementation
@@ -699,25 +699,25 @@ sections:
699
699
  instruction: Record the specific AI agent model and version used for development
700
700
  owner: dev-agent
701
701
  editors: [dev-agent]
702
-
702
+
703
703
  - id: debug-log-references
704
704
  title: Debug Log References
705
705
  instruction: Reference any debug logs or traces generated during development
706
706
  owner: dev-agent
707
707
  editors: [dev-agent]
708
-
708
+
709
709
  - id: completion-notes
710
710
  title: Completion Notes List
711
711
  instruction: Notes about the completion of tasks and any issues encountered
712
712
  owner: dev-agent
713
713
  editors: [dev-agent]
714
-
714
+
715
715
  - id: file-list
716
716
  title: File List
717
717
  instruction: List all files created, modified, or affected during story implementation
718
718
  owner: dev-agent
719
719
  editors: [dev-agent]
720
-
720
+
721
721
  - id: qa-results
722
722
  title: QA Results
723
723
  instruction: Results from QA Agent QA review of the completed story implementation