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.
- package/.github/ISSUE_TEMPLATE/bug_report.md +3 -3
- package/.github/ISSUE_TEMPLATE/feature_request.md +3 -3
- package/.github/workflows/discord.yaml +11 -2
- package/.github/workflows/format-check.yaml +42 -0
- package/.github/workflows/manual-release.yaml +173 -0
- package/.husky/pre-commit +3 -0
- package/.vscode/settings.json +26 -1
- package/CHANGELOG.md +0 -11
- package/README.md +2 -0
- package/bmad-core/agent-teams/team-all.yaml +1 -1
- package/bmad-core/agents/bmad-orchestrator.md +1 -1
- package/bmad-core/agents/dev.md +4 -4
- package/bmad-core/data/bmad-kb.md +1 -1
- package/bmad-core/data/test-levels-framework.md +12 -12
- package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
- package/bmad-core/tasks/nfr-assess.md +10 -10
- package/bmad-core/tasks/qa-gate.md +23 -23
- package/bmad-core/tasks/review-story.md +18 -18
- package/bmad-core/tasks/risk-profile.md +25 -25
- package/bmad-core/tasks/test-design.md +9 -9
- package/bmad-core/tasks/trace-requirements.md +21 -21
- package/bmad-core/templates/architecture-tmpl.yaml +49 -49
- package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
- package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
- package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
- package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
- package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
- package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
- package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
- package/bmad-core/templates/market-research-tmpl.yaml +2 -2
- package/bmad-core/templates/prd-tmpl.yaml +9 -9
- package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
- package/bmad-core/templates/qa-gate-tmpl.yaml +9 -9
- package/bmad-core/templates/story-tmpl.yaml +12 -12
- package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
- package/bmad-core/workflows/brownfield-service.yaml +1 -1
- package/bmad-core/workflows/brownfield-ui.yaml +1 -1
- package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
- package/bmad-core/workflows/greenfield-service.yaml +1 -1
- package/bmad-core/workflows/greenfield-ui.yaml +1 -1
- package/common/utils/bmad-doc-template.md +5 -5
- package/dist/agents/analyst.txt +28 -15
- package/dist/agents/architect.txt +220 -190
- package/dist/agents/bmad-master.txt +298 -255
- package/dist/agents/bmad-orchestrator.txt +1 -1
- package/dist/agents/pm.txt +20 -20
- package/dist/agents/po.txt +11 -11
- package/dist/agents/qa.txt +275 -618
- package/dist/agents/sm.txt +11 -11
- package/dist/agents/ux-expert.txt +23 -23
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -109
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -77
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -41
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +483 -474
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +1 -1
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -149
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -20
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +371 -358
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -25
- package/dist/teams/team-all.txt +581 -881
- package/dist/teams/team-fullstack.txt +316 -273
- package/dist/teams/team-ide-minimal.txt +276 -619
- package/dist/teams/team-no-ui.txt +281 -238
- package/docs/versioning-and-releases.md +114 -44
- package/eslint.config.mjs +119 -0
- 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
- package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
- package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
- package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
- package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
- package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
- package/package.json +62 -39
- package/prettier.config.mjs +32 -0
- package/release_notes.md +30 -0
- package/tools/bmad-npx-wrapper.js +10 -10
- package/tools/builders/web-builder.js +124 -130
- package/tools/bump-all-versions.js +42 -33
- package/tools/bump-expansion-version.js +23 -16
- package/tools/cli.js +10 -12
- package/tools/flattener/aggregate.js +10 -10
- package/tools/flattener/binary.js +44 -17
- package/tools/flattener/discovery.js +19 -18
- package/tools/flattener/files.js +6 -6
- package/tools/flattener/ignoreRules.js +125 -125
- package/tools/flattener/main.js +201 -304
- package/tools/flattener/projectRoot.js +75 -73
- package/tools/flattener/prompts.js +9 -9
- package/tools/flattener/stats.helpers.js +131 -67
- package/tools/flattener/stats.js +3 -3
- package/tools/flattener/test-matrix.js +201 -193
- package/tools/flattener/xml.js +33 -31
- package/tools/installer/bin/bmad.js +130 -89
- package/tools/installer/config/ide-agent-config.yaml +1 -1
- package/tools/installer/config/install.config.yaml +2 -2
- package/tools/installer/lib/config-loader.js +46 -42
- package/tools/installer/lib/file-manager.js +91 -113
- package/tools/installer/lib/ide-base-setup.js +57 -56
- package/tools/installer/lib/ide-setup.js +375 -343
- package/tools/installer/lib/installer.js +875 -714
- package/tools/installer/lib/memory-profiler.js +54 -53
- package/tools/installer/lib/module-manager.js +19 -15
- package/tools/installer/lib/resource-locator.js +26 -28
- package/tools/installer/package.json +19 -19
- package/tools/lib/dependency-resolver.js +26 -30
- package/tools/lib/yaml-utils.js +7 -7
- package/tools/preview-release-notes.js +66 -0
- package/tools/shared/bannerArt.js +3 -3
- package/tools/sync-installer-version.js +7 -9
- package/tools/update-expansion-version.js +14 -15
- package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
- package/tools/version-bump.js +41 -26
- package/tools/yaml-format.js +56 -43
- package/.github/workflows/promote-to-stable.yml +0 -144
- package/.github/workflows/release.yaml +0 -60
- package/.releaserc.json +0 -21
- 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**:
|
|
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.
|
package/dist/agents/pm.txt
CHANGED
|
@@ -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
|
package/dist/agents/po.txt
CHANGED
|
@@ -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
|