bmad-method 4.26.0 → 4.27.0

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 (55) hide show
  1. package/.vscode/settings.json +2 -0
  2. package/CHANGELOG.md +15 -0
  3. package/README.md +29 -282
  4. package/bmad-core/agents/analyst.md +3 -1
  5. package/bmad-core/agents/bmad-master.md +5 -1
  6. package/bmad-core/agents/bmad-orchestrator.md +1 -1
  7. package/bmad-core/core-config.yaml +1 -1
  8. package/bmad-core/data/bmad-kb.md +74 -15
  9. package/bmad-core/data/brainstorming-techniques.md +36 -0
  10. package/bmad-core/data/elicitation-methods.md +134 -0
  11. package/bmad-core/tasks/advanced-elicitation.md +82 -57
  12. package/bmad-core/tasks/facilitate-brainstorming-session.md +136 -0
  13. package/bmad-core/templates/architecture-tmpl.md +23 -23
  14. package/bmad-core/templates/brainstorming-output-tmpl.md +149 -0
  15. package/bmad-core/templates/prd-tmpl.md +6 -6
  16. package/bmad-core/templates/prd-tmpl2.yaml +202 -0
  17. package/bmad-core/utils/plan-management.md +9 -13
  18. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  19. package/common/tasks/create-doc.md +4 -4
  20. package/common/tasks/create-doc2.md +65 -0
  21. package/common/utils/bmad-doc-template.md +296 -0
  22. package/dist/agents/analyst.txt +481 -305
  23. package/dist/agents/architect.txt +60 -59
  24. package/dist/agents/bmad-master.txt +694 -399
  25. package/dist/agents/bmad-orchestrator.txt +197 -116
  26. package/dist/agents/dev.txt +18 -17
  27. package/dist/agents/pm.txt +47 -46
  28. package/dist/agents/po.txt +31 -30
  29. package/dist/agents/qa.txt +15 -14
  30. package/dist/agents/sm.txt +23 -22
  31. package/dist/agents/ux-expert.txt +29 -28
  32. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +33 -32
  33. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +19 -18
  34. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +21 -20
  35. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +385 -297
  36. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +103 -77
  37. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +29 -28
  38. package/dist/teams/team-all.txt +610 -438
  39. package/dist/teams/team-fullstack.txt +597 -425
  40. package/dist/teams/team-ide-minimal.txt +238 -157
  41. package/dist/teams/team-no-ui.txt +583 -411
  42. package/docs/agentic-tools/github-copilot-guide.md +29 -9
  43. package/docs/bmad-workflow-guide.md +2 -2
  44. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  45. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +2 -2
  46. package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
  47. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  48. package/package.json +1 -1
  49. package/tools/builders/web-builder.js +117 -22
  50. package/tools/installer/config/install.config.yaml +2 -2
  51. package/tools/installer/lib/ide-setup.js +2 -2
  52. package/tools/installer/package.json +1 -1
  53. package/tools/lib/dependency-resolver.js +3 -3
  54. package/tools/md-assets/web-agent-startup-instructions.md +10 -10
  55. package/bmad-core/tasks/brainstorming-techniques.md +0 -238
@@ -33,13 +33,15 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
33
33
 
34
34
  ### The Two-Phase Approach
35
35
 
36
- **Phase 1: Planning (Web UI - Cost Effective)**
36
+ #### Phase 1: Planning (Web UI - Cost Effective)
37
+
37
38
  - Use large context windows (Gemini's 1M tokens)
38
39
  - Generate comprehensive documents (PRD, Architecture)
39
40
  - Leverage multiple agents for brainstorming
40
41
  - Create once, use throughout development
41
42
 
42
- **Phase 2: Development (IDE - Implementation)**
43
+ #### Phase 2: Development (IDE - Implementation)
44
+
43
45
  - Shard documents into manageable pieces
44
46
  - Execute focused SM → Dev cycles
45
47
  - One story at a time, sequential progress
@@ -69,6 +71,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
69
71
  ### Quick Start Options
70
72
 
71
73
  #### Option 1: Web UI
74
+
72
75
  **Best for**: ChatGPT, Claude, Gemini users who want to start immediately
73
76
 
74
77
  1. Navigate to `dist/teams/`
@@ -78,6 +81,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
78
81
  5. Type `/help` to see available commands
79
82
 
80
83
  #### Option 2: IDE Integration
84
+
81
85
  **Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
82
86
 
83
87
  ```bash
@@ -86,6 +90,7 @@ npx bmad-method install
86
90
  ```
87
91
 
88
92
  **Installation Steps**:
93
+
89
94
  - Choose "Complete installation"
90
95
  - Select your IDE from supported options:
91
96
  - **Cursor**: Native AI integration
@@ -94,11 +99,12 @@ npx bmad-method install
94
99
  - **Trae**: Built-in AI capabilities
95
100
  - **Cline**: VS Code extension with AI features
96
101
  - **Roo Code**: Web-based IDE with agent support
97
- - **Github Copilot**: AI-powered coding assistant
102
+ - **GitHub Copilot**: VS Code extension with AI peer programming assistant
98
103
 
99
104
  **Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
100
105
 
101
106
  **Verify Installation**:
107
+
102
108
  - `.bmad-core/` folder created with all agents
103
109
  - IDE-specific integration files created
104
110
  - All agent commands/rules/modes available
@@ -108,12 +114,14 @@ npx bmad-method install
108
114
  ### Environment Selection Guide
109
115
 
110
116
  **Use Web UI for**:
117
+
111
118
  - Initial planning and documentation (PRD, architecture)
112
119
  - Cost-effective document creation (especially with Gemini)
113
120
  - Brainstorming and analysis phases
114
121
  - Multi-agent consultation and planning
115
122
 
116
123
  **Use IDE for**:
124
+
117
125
  - Active development and coding
118
126
  - File operations and project integration
119
127
  - Document sharding and story management
@@ -126,35 +134,41 @@ npx bmad-method install
126
134
  **Can you do everything in IDE?** Yes, but understand the tradeoffs:
127
135
 
128
136
  **Pros of IDE-Only**:
137
+
129
138
  - Single environment workflow
130
139
  - Direct file operations from start
131
140
  - No copy/paste between environments
132
141
  - Immediate project integration
133
142
 
134
143
  **Cons of IDE-Only**:
144
+
135
145
  - Higher token costs for large document creation
136
146
  - Smaller context windows (varies by IDE/model)
137
147
  - May hit limits during planning phases
138
148
  - Less cost-effective for brainstorming
139
149
 
140
150
  **Using Web Agents in IDE**:
151
+
141
152
  - **NOT RECOMMENDED**: Web agents (PM, Architect) have rich dependencies designed for large contexts
142
153
  - **Why it matters**: Dev agents are kept lean to maximize coding context
143
154
  - **The principle**: "Dev agents code, planning agents plan" - mixing breaks this optimization
144
155
 
145
156
  **About bmad-master and bmad-orchestrator**:
157
+
146
158
  - **bmad-master**: CAN do any task without switching agents, BUT...
147
159
  - **Still use specialized agents for planning**: PM, Architect, and UX Expert have tuned personas that produce better results
148
160
  - **Why specialization matters**: Each agent's personality and focus creates higher quality outputs
149
161
  - **If using bmad-master/orchestrator**: Fine for planning phases, but...
150
162
 
151
163
  **CRITICAL RULE for Development**:
164
+
152
165
  - **ALWAYS use SM agent for story creation** - Never use bmad-master/orchestrator
153
166
  - **ALWAYS use Dev agent for implementation** - Never use bmad-master/orchestrator
154
167
  - **Why this matters**: SM and Dev agents are specifically optimized for the development workflow
155
168
  - **No exceptions**: Even if using bmad-master for everything else, switch to SM → Dev for implementation
156
169
 
157
170
  **Best Practice for IDE-Only**:
171
+
158
172
  1. Use PM/Architect/UX agents for planning (better than bmad-master)
159
173
  2. Create documents directly in project
160
174
  3. Shard immediately after creation
@@ -178,17 +192,20 @@ This configuration file acts as a map for BMad agents, telling them exactly wher
178
192
  ### Key Configuration Areas
179
193
 
180
194
  #### PRD Configuration
195
+
181
196
  - **prdVersion**: Tells agents if PRD follows v3 or v4 conventions
182
197
  - **prdSharded**: Whether epics are embedded (false) or in separate files (true)
183
198
  - **prdShardedLocation**: Where to find sharded epic files
184
199
  - **epicFilePattern**: Pattern for epic filenames (e.g., `epic-{n}*.md`)
185
200
 
186
201
  #### Architecture Configuration
202
+
187
203
  - **architectureVersion**: v3 (monolithic) or v4 (sharded)
188
204
  - **architectureSharded**: Whether architecture is split into components
189
205
  - **architectureShardedLocation**: Where sharded architecture files live
190
206
 
191
207
  #### Developer Files
208
+
192
209
  - **devLoadAlwaysFiles**: List of files the dev agent loads for every task
193
210
  - **devDebugLog**: Where dev agent logs repeated failures
194
211
  - **agentCoreDump**: Export location for chat conversations
@@ -203,6 +220,7 @@ This configuration file acts as a map for BMad agents, telling them exactly wher
203
220
  ### Common Configurations
204
221
 
205
222
  **Legacy V3 Project**:
223
+
206
224
  ```yaml
207
225
  prdVersion: v3
208
226
  prdSharded: false
@@ -211,6 +229,7 @@ architectureSharded: false
211
229
  ```
212
230
 
213
231
  **V4 Optimized Project**:
232
+
214
233
  ```yaml
215
234
  prdVersion: v4
216
235
  prdSharded: true
@@ -276,18 +295,21 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
276
295
  #### IDE-Specific Syntax
277
296
 
278
297
  **Agent Loading by IDE**:
298
+
279
299
  - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
280
300
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
281
301
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
282
302
  - **Trae**: `@agent-name` (e.g., `@bmad-master`)
283
303
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
284
- - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
304
+ - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
285
305
 
286
306
  **Chat Management Guidelines**:
307
+
287
308
  - **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
288
309
  - **Roo Code**: Switch modes within the same conversation
289
310
 
290
311
  **Common Task Commands**:
312
+
291
313
  - `*help` - Show available commands
292
314
  - `*status` - Show current context/progress
293
315
  - `*exit` - Exit the agent mode
@@ -296,6 +318,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
296
318
  - `*create` - Run create-next-story task (SM agent)
297
319
 
298
320
  **In Web UI**:
321
+
299
322
  ```text
300
323
  /pm create-doc prd
301
324
  /architect review system design
@@ -309,16 +332,19 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
309
332
  ### Pre-Built Teams
310
333
 
311
334
  #### Team All
335
+
312
336
  - **Includes**: All 10 agents + orchestrator
313
337
  - **Use Case**: Complete projects requiring all roles
314
338
  - **Bundle**: `team-all.txt`
315
339
 
316
340
  #### Team Fullstack
341
+
317
342
  - **Includes**: PM, Architect, Developer, QA, UX Expert
318
343
  - **Use Case**: End-to-end web/mobile development
319
344
  - **Bundle**: `team-fullstack.txt`
320
345
 
321
346
  #### Team No-UI
347
+
322
348
  - **Includes**: PM, Architect, Developer, QA (no UX Expert)
323
349
  - **Use Case**: Backend services, APIs, system development
324
350
  - **Bundle**: `team-no-ui.txt`
@@ -332,22 +358,26 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
332
358
  ### Key Architectural Components
333
359
 
334
360
  #### 1. Agents (`bmad-core/agents/`)
361
+
335
362
  - **Purpose**: Each markdown file defines a specialized AI agent for a specific Agile role (PM, Dev, Architect, etc.)
336
363
  - **Structure**: Contains YAML headers specifying the agent's persona, capabilities, and dependencies
337
364
  - **Dependencies**: Lists of tasks, templates, checklists, and data files the agent can use
338
365
  - **Startup Instructions**: Can load project-specific documentation for immediate context
339
366
 
340
367
  #### 2. Agent Teams (`bmad-core/agent-teams/`)
368
+
341
369
  - **Purpose**: Define collections of agents bundled together for specific purposes
342
370
  - **Examples**: `team-all.yaml` (comprehensive bundle), `team-fullstack.yaml` (full-stack development)
343
371
  - **Usage**: Creates pre-packaged contexts for web UI environments
344
372
 
345
373
  #### 3. Workflows (`bmad-core/workflows/`)
374
+
346
375
  - **Purpose**: YAML files defining prescribed sequences of steps for specific project types
347
376
  - **Types**: Greenfield (new projects) and Brownfield (existing projects) for UI, service, and fullstack development
348
377
  - **Structure**: Defines agent interactions, artifacts created, and transition conditions
349
378
 
350
379
  #### 4. Reusable Resources
380
+
351
381
  - **Templates** (`bmad-core/templates/`): Markdown templates for PRDs, architecture specs, user stories
352
382
  - **Tasks** (`bmad-core/tasks/`): Instructions for specific repeatable actions like "shard-doc" or "create-next-story"
353
383
  - **Checklists** (`bmad-core/checklists/`): Quality assurance checklists for validation and review
@@ -387,6 +417,7 @@ BMad employs a sophisticated template system with three key components:
387
417
  ### Technical Preferences Integration
388
418
 
389
419
  The `technical-preferences.md` file serves as a persistent technical profile that:
420
+
390
421
  - Ensures consistency across all agents and projects
391
422
  - Eliminates repetitive technology specification
392
423
  - Provides personalized recommendations aligned with user preferences
@@ -395,6 +426,7 @@ The `technical-preferences.md` file serves as a persistent technical profile tha
395
426
  ### Build and Delivery Process
396
427
 
397
428
  The `web-builder.js` tool creates web-ready bundles by:
429
+
398
430
  1. Reading agent or team definition files
399
431
  2. Recursively resolving all dependencies
400
432
  3. Concatenating content into single text files with clear separators
@@ -409,11 +441,13 @@ This architecture enables seamless operation across environments while maintaini
409
441
  **Ideal for cost efficiency with Gemini's massive context:**
410
442
 
411
443
  **For Brownfield Projects - Start Here!**:
444
+
412
445
  1. **Upload entire project to Gemini Web** (GitHub URL, files, or zip)
413
446
  2. **Document existing system**: `/analyst` → `*document-project`
414
447
  3. **Creates comprehensive docs** from entire codebase analysis
415
448
 
416
449
  **For All Projects**:
450
+
417
451
  1. **Optional Analysis**: `/analyst` - Market research, competitive analysis
418
452
  2. **Project Brief**: Create foundation document (Analyst or user)
419
453
  3. **PRD Creation**: `/pm create-doc prd` - Comprehensive product requirements
@@ -424,12 +458,14 @@ This architecture enables seamless operation across environments while maintaini
424
458
  #### Example Planning Prompts
425
459
 
426
460
  **For PRD Creation**:
461
+
427
462
  ```text
428
463
  "I want to build a [type] application that [core purpose].
429
464
  Help me brainstorm features and create a comprehensive PRD."
430
465
  ```
431
466
 
432
467
  **For Architecture Design**:
468
+
433
469
  ```text
434
470
  "Based on this PRD, design a scalable technical architecture
435
471
  that can handle [specific requirements]."
@@ -447,7 +483,7 @@ that can handle [specific requirements]."
447
483
 
448
484
  **Prerequisites**: Planning documents must exist in `docs/` folder
449
485
 
450
- 1. **Document Sharding** (CRITICAL STEP):
486
+ 1. **Document Sharding** (CRITICAL STEP):
451
487
  - Documents created by PM/Architect (in Web or IDE) MUST be sharded for development
452
488
  - Two methods to shard:
453
489
  a) **Manual**: Drag `shard-doc` task + document file into chat
@@ -461,32 +497,33 @@ that can handle [specific requirements]."
461
497
  - Source tree document and coding standards for dev agent reference
462
498
  - Sharded docs for SM agent story creation
463
499
 
464
- **Resulting Folder Structure**:
500
+ Resulting Folder Structure:
501
+
465
502
  - `docs/prd/` - Broken down PRD sections
466
503
  - `docs/architecture/` - Broken down architecture sections
467
504
  - `docs/stories/` - Generated user stories
468
505
 
469
- 3. **Development Cycle** (Sequential, one story at a time):
506
+ 1. **Development Cycle** (Sequential, one story at a time):
470
507
 
471
508
  **CRITICAL CONTEXT MANAGEMENT**:
472
509
  - **Context windows matter!** Always use fresh, clean context windows
473
510
  - **Model selection matters!** Use most powerful thinking model for SM story creation
474
511
  - **ALWAYS start new chat between SM, Dev, and QA work**
475
512
 
476
- **Step 1 - Story Creation**:
513
+ **Step 1 - Story Creation**:
477
514
  - **NEW CLEAN CHAT** → Select powerful model → `@sm` → `*create`
478
515
  - SM executes create-next-story task
479
516
  - Review generated story in `docs/stories/`
480
517
  - Update status from "Draft" to "Approved"
481
-
482
- **Step 2 - Story Implementation**:
518
+
519
+ **Step 2 - Story Implementation**:
483
520
  - **NEW CLEAN CHAT** → `@dev`
484
521
  - Agent asks which story to implement
485
522
  - Include story file content to save dev agent lookup time
486
523
  - Dev follows tasks/subtasks, marking completion
487
524
  - Dev maintains File List of all changes
488
525
  - Dev marks story as "Review" when complete with all tests passing
489
-
526
+
490
527
  **Step 3 - Senior QA Review**:
491
528
  - **NEW CLEAN CHAT** → `@qa` → execute review-story task
492
529
  - QA performs senior developer code review
@@ -494,7 +531,7 @@ that can handle [specific requirements]."
494
531
  - QA appends results to story's QA Results section
495
532
  - If approved: Status → "Done"
496
533
  - If changes needed: Status stays "Review" with unchecked items for dev
497
-
534
+
498
535
  **Step 4 - Repeat**: Continue SM → Dev → QA cycle until all epic stories complete
499
536
 
500
537
  **Important**: Only 1 story in progress at a time, worked sequentially until all epic stories complete.
@@ -502,6 +539,7 @@ that can handle [specific requirements]."
502
539
  ### Status Tracking Workflow
503
540
 
504
541
  Stories progress through defined statuses:
542
+
505
543
  - **Draft** → **Approved** → **InProgress** → **Done**
506
544
 
507
545
  Each status change requires user verification and approval before proceeding.
@@ -509,6 +547,7 @@ Each status change requires user verification and approval before proceeding.
509
547
  ### Workflow Types
510
548
 
511
549
  #### Greenfield Development
550
+
512
551
  - Business analysis and market research
513
552
  - Product requirements and feature definition
514
553
  - System architecture and design
@@ -522,6 +561,7 @@ Each status change requires user verification and approval before proceeding.
522
561
  **Complete Brownfield Workflow Options**:
523
562
 
524
563
  **Option 1: PRD-First (Recommended for Large Codebases/Monorepos)**:
564
+
525
565
  1. **Upload project to Gemini Web** (GitHub URL, files, or zip)
526
566
  2. **Create PRD first**: `@pm` → `*create-doc brownfield-prd`
527
567
  3. **Focused documentation**: `@analyst` → `*document-project`
@@ -532,18 +572,19 @@ Each status change requires user verification and approval before proceeding.
532
572
  - Avoids bloating docs with unused code
533
573
 
534
574
  **Option 2: Document-First (Good for Smaller Projects)**:
575
+
535
576
  1. **Upload project to Gemini Web**
536
577
  2. **Document everything**: `@analyst` → `*document-project`
537
578
  3. **Then create PRD**: `@pm` → `*create-doc brownfield-prd`
538
579
  - More thorough but can create excessive documentation
539
580
 
540
- 2. **Requirements Gathering**:
581
+ 4. **Requirements Gathering**:
541
582
  - **Brownfield PRD**: Use PM agent with `brownfield-prd-tmpl`
542
583
  - **Analyzes**: Existing system, constraints, integration points
543
584
  - **Defines**: Enhancement scope, compatibility requirements, risk assessment
544
585
  - **Creates**: Epic and story structure for changes
545
586
 
546
- 3. **Architecture Planning**:
587
+ 5. **Architecture Planning**:
547
588
  - **Brownfield Architecture**: Use Architect agent with `brownfield-architecture-tmpl`
548
589
  - **Integration Strategy**: How new features integrate with existing system
549
590
  - **Migration Planning**: Gradual rollout and backwards compatibility
@@ -552,10 +593,12 @@ Each status change requires user verification and approval before proceeding.
552
593
  **Brownfield-Specific Resources**:
553
594
 
554
595
  **Templates**:
596
+
555
597
  - `brownfield-prd-tmpl.md`: Comprehensive enhancement planning with existing system analysis
556
598
  - `brownfield-architecture-tmpl.md`: Integration-focused architecture for existing systems
557
599
 
558
600
  **Tasks**:
601
+
559
602
  - `document-project`: Generates comprehensive documentation from existing codebase
560
603
  - `brownfield-create-epic`: Creates single epic for focused enhancements (when full PRD is overkill)
561
604
  - `brownfield-create-story`: Creates individual story for small, isolated changes
@@ -563,18 +606,21 @@ Each status change requires user verification and approval before proceeding.
563
606
  **When to Use Each Approach**:
564
607
 
565
608
  **Full Brownfield Workflow** (Recommended for):
609
+
566
610
  - Major feature additions
567
611
  - System modernization
568
612
  - Complex integrations
569
613
  - Multiple related changes
570
614
 
571
615
  **Quick Epic/Story Creation** (Use when):
616
+
572
617
  - Single, focused enhancement
573
618
  - Isolated bug fixes
574
619
  - Small feature additions
575
620
  - Well-documented existing system
576
621
 
577
622
  **Critical Success Factors**:
623
+
578
624
  1. **Documentation First**: Always run `document-project` if docs are outdated/missing
579
625
  2. **Context Matters**: Provide agents access to relevant code sections
580
626
  3. **Integration Focus**: Emphasize compatibility and non-breaking changes
@@ -590,6 +636,7 @@ Each status change requires user verification and approval before proceeding.
590
636
  - `docs/architecture.md` - System Architecture Document
591
637
 
592
638
  **Why These Names Matter**:
639
+
593
640
  - Agents automatically reference these files during development
594
641
  - Sharding tasks expect these specific filenames
595
642
  - Workflow automation depends on standard naming
@@ -608,6 +655,7 @@ Each status change requires user verification and approval before proceeding.
608
655
  Templates with Level 2 headings (`##`) can be automatically sharded:
609
656
 
610
657
  **Original PRD**:
658
+
611
659
  ```markdown
612
660
  ## Goals and Background Context
613
661
  ## Requirements
@@ -616,6 +664,7 @@ Templates with Level 2 headings (`##`) can be automatically sharded:
616
664
  ```
617
665
 
618
666
  **After Sharding**:
667
+
619
668
  - `docs/prd/goals-and-background-context.md`
620
669
  - `docs/prd/requirements.md`
621
670
  - `docs/prd/user-interface-design-goals.md`
@@ -628,12 +677,14 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
628
677
  ### Environment-Specific Usage
629
678
 
630
679
  **Web UI Best For**:
680
+
631
681
  - Initial planning and documentation phases
632
682
  - Cost-effective large document creation
633
683
  - Agent consultation and brainstorming
634
684
  - Multi-agent workflows with orchestrator
635
685
 
636
686
  **IDE Best For**:
687
+
637
688
  - Active development and implementation
638
689
  - File operations and project integration
639
690
  - Story management and development cycles
@@ -668,6 +719,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
668
719
  For full details, see `CONTRIBUTING.md`. Key points:
669
720
 
670
721
  **Fork Workflow**:
722
+
671
723
  1. Fork the repository
672
724
  2. Create feature branches
673
725
  3. Submit PRs to `next` branch (default) or `main` for critical fixes only
@@ -675,12 +727,14 @@ For full details, see `CONTRIBUTING.md`. Key points:
675
727
  5. One feature/fix per PR
676
728
 
677
729
  **PR Requirements**:
730
+
678
731
  - Clear descriptions (max 200 words) with What/Why/How/Testing
679
732
  - Use conventional commits (feat:, fix:, docs:)
680
733
  - Atomic commits - one logical change per commit
681
734
  - Must align with guiding principles
682
735
 
683
736
  **Core Principles** (from GUIDING-PRINCIPLES.md):
737
+
684
738
  - **Dev Agents Must Be Lean**: Minimize dependencies, save context for code
685
739
  - **Natural Language First**: Everything in markdown, no code in core
686
740
  - **Core vs Expansion Packs**: Core for universal needs, packs for specialized domains
@@ -702,12 +756,14 @@ Expansion packs extend BMad-Method beyond traditional software development into
702
756
  ### Available Expansion Packs
703
757
 
704
758
  **Technical Packs**:
759
+
705
760
  - **Infrastructure/DevOps**: Cloud architects, SRE experts, security specialists
706
761
  - **Game Development**: Game designers, level designers, narrative writers
707
762
  - **Mobile Development**: iOS/Android specialists, mobile UX experts
708
763
  - **Data Science**: ML engineers, data scientists, visualization experts
709
764
 
710
765
  **Non-Technical Packs**:
766
+
711
767
  - **Business Strategy**: Consultants, financial analysts, marketing strategists
712
768
  - **Creative Writing**: Plot architects, character developers, world builders
713
769
  - **Health & Wellness**: Fitness trainers, nutritionists, habit engineers
@@ -715,6 +771,7 @@ Expansion packs extend BMad-Method beyond traditional software development into
715
771
  - **Legal Support**: Contract analysts, compliance checkers
716
772
 
717
773
  **Specialty Packs**:
774
+
718
775
  - **Expansion Creator**: Tools to build your own expansion packs
719
776
  - **RPG Game Master**: Tabletop gaming assistance
720
777
  - **Life Event Planning**: Wedding planners, event coordinators
@@ -724,11 +781,13 @@ Expansion packs extend BMad-Method beyond traditional software development into
724
781
 
725
782
  1. **Browse Available Packs**: Check `expansion-packs/` directory
726
783
  2. **Get Inspiration**: See `docs/expansion-packs.md` for detailed examples and ideas
727
- 3. **Install via CLI**:
784
+ 3. **Install via CLI**:
785
+
728
786
  ```bash
729
787
  npx bmad-method install
730
788
  # Select "Install expansion pack" option
731
789
  ```
790
+
732
791
  4. **Use in Your Workflow**: Installed packs integrate seamlessly with existing agents
733
792
 
734
793
  ### Creating Custom Expansion Packs
@@ -0,0 +1,36 @@
1
+ # Brainstorming Techniques Data
2
+
3
+ ## Creative Expansion
4
+
5
+ 1. **What If Scenarios**: Ask one provocative question, get their response, then ask another
6
+ 2. **Analogical Thinking**: Give one example analogy, ask them to find 2-3 more
7
+ 3. **Reversal/Inversion**: Pose the reverse question, let them work through it
8
+ 4. **First Principles Thinking**: Ask "What are the fundamentals?" and guide them to break it down
9
+
10
+ ## Structured Frameworks
11
+
12
+ 5. **SCAMPER Method**: Go through one letter at a time, wait for their ideas before moving to next
13
+ 6. **Six Thinking Hats**: Present one hat, ask for their thoughts, then move to next hat
14
+ 7. **Mind Mapping**: Start with central concept, ask them to suggest branches
15
+
16
+ ## Collaborative Techniques
17
+
18
+ 8. **"Yes, And..." Building**: They give idea, you "yes and" it, they "yes and" back - alternate
19
+ 9. **Brainwriting/Round Robin**: They suggest idea, you build on it, ask them to build on yours
20
+ 10. **Random Stimulation**: Give one random prompt/word, ask them to make connections
21
+
22
+ ## Deep Exploration
23
+
24
+ 11. **Five Whys**: Ask "why" and wait for their answer before asking next "why"
25
+ 12. **Morphological Analysis**: Ask them to list parameters first, then explore combinations together
26
+ 13. **Provocation Technique (PO)**: Give one provocative statement, ask them to extract useful ideas
27
+
28
+ ## Advanced Techniques
29
+
30
+ 14. **Forced Relationships**: Connect two unrelated concepts and ask them to find the bridge
31
+ 15. **Assumption Reversal**: Challenge their core assumptions and ask them to build from there
32
+ 16. **Role Playing**: Ask them to brainstorm from different stakeholder perspectives
33
+ 17. **Time Shifting**: "How would you solve this in 1995? 2030?"
34
+ 18. **Resource Constraints**: "What if you had only $10 and 1 hour?"
35
+ 19. **Metaphor Mapping**: Use extended metaphors to explore solutions
36
+ 20. **Question Storming**: Generate questions instead of answers first
@@ -0,0 +1,134 @@
1
+ # Elicitation Methods Data
2
+
3
+ ## Core Reflective Methods
4
+
5
+ **Expand or Contract for Audience**
6
+ - Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
7
+ - Identify specific target audience if relevant
8
+ - Tailor content complexity and depth accordingly
9
+
10
+ **Explain Reasoning (CoT Step-by-Step)**
11
+ - Walk through the step-by-step thinking process
12
+ - Reveal underlying assumptions and decision points
13
+ - Show how conclusions were reached from current role's perspective
14
+
15
+ **Critique and Refine**
16
+ - Review output for flaws, inconsistencies, or improvement areas
17
+ - Identify specific weaknesses from role's expertise
18
+ - Suggest refined version reflecting domain knowledge
19
+
20
+ ## Structural Analysis Methods
21
+
22
+ **Analyze Logical Flow and Dependencies**
23
+ - Examine content structure for logical progression
24
+ - Check internal consistency and coherence
25
+ - Identify and validate dependencies between elements
26
+ - Confirm effective ordering and sequencing
27
+
28
+ **Assess Alignment with Overall Goals**
29
+ - Evaluate content contribution to stated objectives
30
+ - Identify any misalignments or gaps
31
+ - Interpret alignment from specific role's perspective
32
+ - Suggest adjustments to better serve goals
33
+
34
+ ## Risk and Challenge Methods
35
+
36
+ **Identify Potential Risks and Unforeseen Issues**
37
+ - Brainstorm potential risks from role's expertise
38
+ - Identify overlooked edge cases or scenarios
39
+ - Anticipate unintended consequences
40
+ - Highlight implementation challenges
41
+
42
+ **Challenge from Critical Perspective**
43
+ - Adopt critical stance on current content
44
+ - Play devil's advocate from specified viewpoint
45
+ - Argue against proposal highlighting weaknesses
46
+ - Apply YAGNI principles when appropriate (scope trimming)
47
+
48
+ ## Creative Exploration Methods
49
+
50
+ **Tree of Thoughts Deep Dive**
51
+ - Break problem into discrete "thoughts" or intermediate steps
52
+ - Explore multiple reasoning paths simultaneously
53
+ - Use self-evaluation to classify each path as "sure", "likely", or "impossible"
54
+ - Apply search algorithms (BFS/DFS) to find optimal solution paths
55
+
56
+ **Hindsight is 20/20: The 'If Only...' Reflection**
57
+ - Imagine retrospective scenario based on current content
58
+ - Identify the one "if only we had known/done X..." insight
59
+ - Describe imagined consequences humorously or dramatically
60
+ - Extract actionable learnings for current context
61
+
62
+ ## Multi-Persona Collaboration Methods
63
+
64
+ **Agile Team Perspective Shift**
65
+ - Rotate through different Scrum team member viewpoints
66
+ - Product Owner: Focus on user value and business impact
67
+ - Scrum Master: Examine process flow and team dynamics
68
+ - Developer: Assess technical implementation and complexity
69
+ - QA: Identify testing scenarios and quality concerns
70
+
71
+ **Stakeholder Round Table**
72
+ - Convene virtual meeting with multiple personas
73
+ - Each persona contributes unique perspective on content
74
+ - Identify conflicts and synergies between viewpoints
75
+ - Synthesize insights into actionable recommendations
76
+
77
+ **Meta-Prompting Analysis**
78
+ - Step back to analyze the structure and logic of current approach
79
+ - Question the format and methodology being used
80
+ - Suggest alternative frameworks or mental models
81
+ - Optimize the elicitation process itself
82
+
83
+ ## Advanced 2025 Techniques
84
+
85
+ **Self-Consistency Validation**
86
+ - Generate multiple reasoning paths for same problem
87
+ - Compare consistency across different approaches
88
+ - Identify most reliable and robust solution
89
+ - Highlight areas where approaches diverge and why
90
+
91
+ **ReWOO (Reasoning Without Observation)**
92
+ - Separate parametric reasoning from tool-based actions
93
+ - Create reasoning plan without external dependencies
94
+ - Identify what can be solved through pure reasoning
95
+ - Optimize for efficiency and reduced token usage
96
+
97
+ **Persona-Pattern Hybrid**
98
+ - Combine specific role expertise with elicitation pattern
99
+ - Architect + Risk Analysis: Deep technical risk assessment
100
+ - UX Expert + User Journey: End-to-end experience critique
101
+ - PM + Stakeholder Analysis: Multi-perspective impact review
102
+
103
+ **Emergent Collaboration Discovery**
104
+ - Allow multiple perspectives to naturally emerge
105
+ - Identify unexpected insights from persona interactions
106
+ - Explore novel combinations of viewpoints
107
+ - Capture serendipitous discoveries from multi-agent thinking
108
+
109
+ ## Game-Based Elicitation Methods
110
+
111
+ **Red Team vs Blue Team**
112
+ - Red Team: Attack the proposal, find vulnerabilities
113
+ - Blue Team: Defend and strengthen the approach
114
+ - Competitive analysis reveals blind spots
115
+ - Results in more robust, battle-tested solutions
116
+
117
+ **Innovation Tournament**
118
+ - Pit multiple alternative approaches against each other
119
+ - Score each approach across different criteria
120
+ - Crowd-source evaluation from different personas
121
+ - Identify winning combination of features
122
+
123
+ **Escape Room Challenge**
124
+ - Present content as constraints to work within
125
+ - Find creative solutions within tight limitations
126
+ - Identify minimum viable approach
127
+ - Discover innovative workarounds and optimizations
128
+
129
+ ## Process Control
130
+
131
+ **Proceed / No Further Actions**
132
+ - Acknowledge choice to finalize current work
133
+ - Accept output as-is or move to next step
134
+ - Prepare to continue without additional elicitation