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
@@ -8,14 +8,14 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
8
8
 
9
9
  2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
10
 
11
- - `==================== START: folder#filename ====================`
12
- - `==================== END: folder#filename ====================`
11
+ - `==================== START: .bmad-core/folder/filename.md ====================`
12
+ - `==================== END: .bmad-core/folder/filename.md ====================`
13
13
 
14
14
  When you need to reference a resource mentioned in your instructions:
15
15
 
16
16
  - Look for the corresponding START/END tags
17
- - The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
18
- - If a section is specified (e.g., `tasks#create-story#section-name`), navigate to that section within the file
17
+ - The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
19
 
20
20
  **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
21
 
@@ -29,8 +29,8 @@ dependencies:
29
29
 
30
30
  These references map directly to bundle sections:
31
31
 
32
- - `utils: template-format` → Look for `==================== START: utils#template-format ====================`
33
- - `tasks: create-story` → Look for `==================== START: tasks#create-story ====================`
32
+ - `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
@@ -38,7 +38,8 @@ These references map directly to bundle sections:
38
38
 
39
39
  ---
40
40
 
41
- ==================== START: agents#qa ====================
41
+
42
+ ==================== START: .bmad-core/agents/qa.md ====================
42
43
  # qa
43
44
 
44
45
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -91,9 +92,9 @@ dependencies:
91
92
  utils:
92
93
  - template-format
93
94
  ```
94
- ==================== END: agents#qa ====================
95
+ ==================== END: .bmad-core/agents/qa.md ====================
95
96
 
96
- ==================== START: tasks#review-story ====================
97
+ ==================== START: .bmad-core/tasks/review-story.md ====================
97
98
  # review-story
98
99
 
99
100
  When a developer marks a story as "Ready for Review", perform a comprehensive senior developer code review with the ability to refactor and improve code directly.
@@ -239,15 +240,15 @@ After review:
239
240
  1. If all items are checked and approved: Update story status to "Done"
240
241
  2. If unchecked items remain: Keep status as "Review" for dev to address
241
242
  3. Always provide constructive feedback and explanations for learning
242
- ==================== END: tasks#review-story ====================
243
+ ==================== END: .bmad-core/tasks/review-story.md ====================
243
244
 
244
- ==================== START: data#technical-preferences ====================
245
+ ==================== START: .bmad-core/data/technical-preferences.md ====================
245
246
  # User-Defined Preferred Patterns and Preferences
246
247
 
247
248
  None Listed
248
- ==================== END: data#technical-preferences ====================
249
+ ==================== END: .bmad-core/data/technical-preferences.md ====================
249
250
 
250
- ==================== START: utils#template-format ====================
251
+ ==================== START: .bmad-core/utils/template-format.md ====================
251
252
  # Template Format Conventions
252
253
 
253
254
  Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
@@ -274,4 +275,4 @@ Templates in the BMad method use standardized markup for AI processing. These co
274
275
  - Template elements are for AI processing only
275
276
  - Focus on faithful template execution and clean output
276
277
  - All template-specific instructions are embedded within templates
277
- ==================== END: utils#template-format ====================
278
+ ==================== END: .bmad-core/utils/template-format.md ====================
@@ -8,14 +8,14 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
8
8
 
9
9
  2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
10
 
11
- - `==================== START: folder#filename ====================`
12
- - `==================== END: folder#filename ====================`
11
+ - `==================== START: .bmad-core/folder/filename.md ====================`
12
+ - `==================== END: .bmad-core/folder/filename.md ====================`
13
13
 
14
14
  When you need to reference a resource mentioned in your instructions:
15
15
 
16
16
  - Look for the corresponding START/END tags
17
- - The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
18
- - If a section is specified (e.g., `tasks#create-story#section-name`), navigate to that section within the file
17
+ - The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
19
 
20
20
  **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
21
 
@@ -29,8 +29,8 @@ dependencies:
29
29
 
30
30
  These references map directly to bundle sections:
31
31
 
32
- - `utils: template-format` → Look for `==================== START: utils#template-format ====================`
33
- - `tasks: create-story` → Look for `==================== START: tasks#create-story ====================`
32
+ - `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
@@ -38,7 +38,8 @@ These references map directly to bundle sections:
38
38
 
39
39
  ---
40
40
 
41
- ==================== START: agents#sm ====================
41
+
42
+ ==================== START: .bmad-core/agents/sm.md ====================
42
43
  # sm
43
44
 
44
45
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -86,9 +87,9 @@ dependencies:
86
87
  utils:
87
88
  - template-format
88
89
  ```
89
- ==================== END: agents#sm ====================
90
+ ==================== END: .bmad-core/agents/sm.md ====================
90
91
 
91
- ==================== START: tasks#create-next-story ====================
92
+ ==================== START: .bmad-core/tasks/create-next-story.md ====================
92
93
  # Create Next Story Task
93
94
 
94
95
  ## Purpose
@@ -203,16 +204,16 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
203
204
  - Any deviations or conflicts noted between epic and architecture
204
205
  - Checklist Results
205
206
  - Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `validate-next-story`
206
- ==================== END: tasks#create-next-story ====================
207
+ ==================== END: .bmad-core/tasks/create-next-story.md ====================
207
208
 
208
- ==================== START: tasks#execute-checklist ====================
209
+ ==================== START: .bmad-core/tasks/execute-checklist.md ====================
209
210
  # Checklist Validation Task
210
211
 
211
212
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
212
213
 
213
214
  ## Available Checklists
214
215
 
215
- If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the {root}/checklists folder to select the appropriate one to run.
216
+ If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
216
217
 
217
218
  ## Instructions
218
219
 
@@ -221,7 +222,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
221
222
  - If user or the task being run provides a checklist name:
222
223
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
223
224
  - If multiple matches found, ask user to clarify
224
- - Load the appropriate checklist from {root}/checklists/
225
+ - Load the appropriate checklist from .bmad-core/checklists/
225
226
  - If no checklist specified:
226
227
  - Ask the user which checklist they want to use
227
228
  - Present the available options from the files in the checklists folder
@@ -299,9 +300,9 @@ The LLM will:
299
300
  - Execute the complete checklist validation
300
301
  - Present a final report with pass/fail rates and key findings
301
302
  - Offer to provide detailed analysis of any section, especially those with warnings or failures
302
- ==================== END: tasks#execute-checklist ====================
303
+ ==================== END: .bmad-core/tasks/execute-checklist.md ====================
303
304
 
304
- ==================== START: tasks#correct-course ====================
305
+ ==================== START: .bmad-core/tasks/correct-course.md ====================
305
306
  # Correct Course Task
306
307
 
307
308
  ## Purpose
@@ -375,9 +376,9 @@ The LLM will:
375
376
  - A summary of the `change-checklist` analysis (issue, impact, rationale for the chosen path).
376
377
  - Specific, clearly drafted proposed edits for all affected project artifacts.
377
378
  - **Implicit:** An annotated `change-checklist` (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
378
- ==================== END: tasks#correct-course ====================
379
+ ==================== END: .bmad-core/tasks/correct-course.md ====================
379
380
 
380
- ==================== START: templates#story-tmpl ====================
381
+ ==================== START: .bmad-core/templates/story-tmpl.md ====================
381
382
  ---
382
383
  defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md
383
384
  smAgent:
@@ -436,9 +437,9 @@ smAgent:
436
437
  ### File List
437
438
 
438
439
  ## QA Results
439
- ==================== END: templates#story-tmpl ====================
440
+ ==================== END: .bmad-core/templates/story-tmpl.md ====================
440
441
 
441
- ==================== START: checklists#story-draft-checklist ====================
442
+ ==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
442
443
  # Story Draft Checklist
443
444
 
444
445
  The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -595,9 +596,9 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
595
596
  - READY: The story provides sufficient context for implementation
596
597
  - NEEDS REVISION: The story requires updates (see issues)
597
598
  - BLOCKED: External information required (specify what information)
598
- ==================== END: checklists#story-draft-checklist ====================
599
+ ==================== END: .bmad-core/checklists/story-draft-checklist.md ====================
599
600
 
600
- ==================== START: utils#template-format ====================
601
+ ==================== START: .bmad-core/utils/template-format.md ====================
601
602
  # Template Format Conventions
602
603
 
603
604
  Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
@@ -624,4 +625,4 @@ Templates in the BMad method use standardized markup for AI processing. These co
624
625
  - Template elements are for AI processing only
625
626
  - Focus on faithful template execution and clean output
626
627
  - All template-specific instructions are embedded within templates
627
- ==================== END: utils#template-format ====================
628
+ ==================== END: .bmad-core/utils/template-format.md ====================
@@ -8,14 +8,14 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
8
8
 
9
9
  2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
10
 
11
- - `==================== START: folder#filename ====================`
12
- - `==================== END: folder#filename ====================`
11
+ - `==================== START: .bmad-core/folder/filename.md ====================`
12
+ - `==================== END: .bmad-core/folder/filename.md ====================`
13
13
 
14
14
  When you need to reference a resource mentioned in your instructions:
15
15
 
16
16
  - Look for the corresponding START/END tags
17
- - The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
18
- - If a section is specified (e.g., `tasks#create-story#section-name`), navigate to that section within the file
17
+ - The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
19
 
20
20
  **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
21
 
@@ -29,8 +29,8 @@ dependencies:
29
29
 
30
30
  These references map directly to bundle sections:
31
31
 
32
- - `utils: template-format` → Look for `==================== START: utils#template-format ====================`
33
- - `tasks: create-story` → Look for `==================== START: tasks#create-story ====================`
32
+ - `utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
@@ -38,7 +38,8 @@ These references map directly to bundle sections:
38
38
 
39
39
  ---
40
40
 
41
- ==================== START: agents#ux-expert ====================
41
+
42
+ ==================== START: .bmad-core/agents/ux-expert.md ====================
42
43
  # ux-expert
43
44
 
44
45
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -93,9 +94,9 @@ dependencies:
93
94
  utils:
94
95
  - template-format
95
96
  ```
96
- ==================== END: agents#ux-expert ====================
97
+ ==================== END: .bmad-core/agents/ux-expert.md ====================
97
98
 
98
- ==================== START: tasks#generate-ai-frontend-prompt ====================
99
+ ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
99
100
  # Create AI Frontend Prompt Task
100
101
 
101
102
  ## Purpose
@@ -147,9 +148,9 @@ You will now synthesize the inputs and the above principles into a final, compre
147
148
  - Output the complete, generated prompt in a clear, copy-pasteable format (e.g., a large code block).
148
149
  - Explain the structure of the prompt and why certain information was included, referencing the principles above.
149
150
  - <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
150
- ==================== END: tasks#generate-ai-frontend-prompt ====================
151
+ ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
151
152
 
152
- ==================== START: tasks#create-deep-research-prompt ====================
153
+ ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
153
154
  # Create Deep Research Prompt Task
154
155
 
155
156
  This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -451,9 +452,9 @@ Present these numbered options to the user:
451
452
  - Balance comprehensiveness with focus
452
453
  - Document assumptions and limitations clearly
453
454
  - Plan for iterative refinement based on initial findings
454
- ==================== END: tasks#create-deep-research-prompt ====================
455
+ ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
455
456
 
456
- ==================== START: tasks#create-doc ====================
457
+ ==================== START: .bmad-core/tasks/create-doc.md ====================
457
458
  # Create Document from Template Task
458
459
 
459
460
  ## Purpose
@@ -473,7 +474,7 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
473
474
 
474
475
  [[LLM: Check if plan tracking is enabled in core-config.yaml]]
475
476
 
476
- - If `workflow.trackProgress: true`, check for active plan using utils#plan-management
477
+ - If `workflow.trackProgress: true`, check for active plan using .bmad-core/utils/plan-management.md
477
478
  - If plan exists and this document creation is part of the plan:
478
479
  - Verify this is the expected next step
479
480
  - If out of sequence and `enforceSequence: true`, warn user and halt without user override
@@ -482,7 +483,7 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
482
483
 
483
484
  ### 1. Identify Template
484
485
 
485
- - Load from `templates#*` or `{root}/templates directory`
486
+ - Load from `.bmad-core/templates/*.md` or `.bmad-core/templates directory`
486
487
  - Agent-specific templates are listed in agent's dependencies
487
488
  - If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
488
489
 
@@ -500,14 +501,14 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
500
501
 
501
502
  ### 4. Key Execution Patterns
502
503
 
503
- **When you see:** `[[LLM: Draft X and immediately execute tasks#advanced-elicitation]]`
504
+ **When you see:** `[[LLM: Draft X and immediately execute .bmad-core/tasks/advanced-elicitation.md]]`
504
505
 
505
506
  - Draft the content
506
507
  - Present it to user
507
508
  - IMMEDIATELY execute the task
508
509
  - Wait for completion before continuing
509
510
 
510
- **When you see:** `[[LLM: After section completion, apply tasks#Y]]`
511
+ **When you see:** `[[LLM: After section completion, apply .bmad-core/tasks/Y.md]]`
511
512
 
512
513
  - Finish the section
513
514
  - STOP and execute the task
@@ -545,16 +546,16 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
545
546
  ## Remember
546
547
 
547
548
  Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
548
- ==================== END: tasks#create-doc ====================
549
+ ==================== END: .bmad-core/tasks/create-doc.md ====================
549
550
 
550
- ==================== START: tasks#execute-checklist ====================
551
+ ==================== START: .bmad-core/tasks/execute-checklist.md ====================
551
552
  # Checklist Validation Task
552
553
 
553
554
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
554
555
 
555
556
  ## Available Checklists
556
557
 
557
- If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the {root}/checklists folder to select the appropriate one to run.
558
+ If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-core/checklists folder to select the appropriate one to run.
558
559
 
559
560
  ## Instructions
560
561
 
@@ -563,7 +564,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
563
564
  - If user or the task being run provides a checklist name:
564
565
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
565
566
  - If multiple matches found, ask user to clarify
566
- - Load the appropriate checklist from {root}/checklists/
567
+ - Load the appropriate checklist from .bmad-core/checklists/
567
568
  - If no checklist specified:
568
569
  - Ask the user which checklist they want to use
569
570
  - Present the available options from the files in the checklists folder
@@ -641,9 +642,9 @@ The LLM will:
641
642
  - Execute the complete checklist validation
642
643
  - Present a final report with pass/fail rates and key findings
643
644
  - Offer to provide detailed analysis of any section, especially those with warnings or failures
644
- ==================== END: tasks#execute-checklist ====================
645
+ ==================== END: .bmad-core/tasks/execute-checklist.md ====================
645
646
 
646
- ==================== START: templates#front-end-spec-tmpl ====================
647
+ ==================== START: .bmad-core/templates/front-end-spec-tmpl.md ====================
647
648
  # {{Project Name}} UI/UX Specification
648
649
 
649
650
  [[LLM: The default path and filename unless specified is docs/front-end-spec.md]]
@@ -1057,15 +1058,15 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
1057
1058
  ## Checklist Results
1058
1059
 
1059
1060
  [[LLM: If a UI/UX checklist exists, run it against this document and report results here.]]
1060
- ==================== END: templates#front-end-spec-tmpl ====================
1061
+ ==================== END: .bmad-core/templates/front-end-spec-tmpl.md ====================
1061
1062
 
1062
- ==================== START: data#technical-preferences ====================
1063
+ ==================== START: .bmad-core/data/technical-preferences.md ====================
1063
1064
  # User-Defined Preferred Patterns and Preferences
1064
1065
 
1065
1066
  None Listed
1066
- ==================== END: data#technical-preferences ====================
1067
+ ==================== END: .bmad-core/data/technical-preferences.md ====================
1067
1068
 
1068
- ==================== START: utils#template-format ====================
1069
+ ==================== START: .bmad-core/utils/template-format.md ====================
1069
1070
  # Template Format Conventions
1070
1071
 
1071
1072
  Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
@@ -1092,4 +1093,4 @@ Templates in the BMad method use standardized markup for AI processing. These co
1092
1093
  - Template elements are for AI processing only
1093
1094
  - Focus on faithful template execution and clean output
1094
1095
  - All template-specific instructions are embedded within templates
1095
- ==================== END: utils#template-format ====================
1096
+ ==================== END: .bmad-core/utils/template-format.md ====================
@@ -8,14 +8,14 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
8
8
 
9
9
  2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
10
 
11
- - `==================== START: folder#filename ====================`
12
- - `==================== END: folder#filename ====================`
11
+ - `==================== START: .bmad-2d-phaser-game-dev/folder/filename.md ====================`
12
+ - `==================== END: .bmad-2d-phaser-game-dev/folder/filename.md ====================`
13
13
 
14
14
  When you need to reference a resource mentioned in your instructions:
15
15
 
16
16
  - Look for the corresponding START/END tags
17
- - The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
18
- - If a section is specified (e.g., `tasks#create-story#section-name`), navigate to that section within the file
17
+ - The format is always the full path with dot prefix (e.g., `.bmad-2d-phaser-game-dev/personas/analyst.md`, `.bmad-2d-phaser-game-dev/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
19
 
20
20
  **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
21
 
@@ -29,8 +29,8 @@ dependencies:
29
29
 
30
30
  These references map directly to bundle sections:
31
31
 
32
- - `utils: template-format` → Look for `==================== START: utils#template-format ====================`
33
- - `tasks: create-story` → Look for `==================== START: tasks#create-story ====================`
32
+ - `utils: template-format` → Look for `==================== START: .bmad-2d-phaser-game-dev/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .bmad-2d-phaser-game-dev/tasks/create-story.md ====================`
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
@@ -38,7 +38,8 @@ These references map directly to bundle sections:
38
38
 
39
39
  ---
40
40
 
41
- ==================== START: agents#game-designer ====================
41
+
42
+ ==================== START: .bmad-2d-phaser-game-dev/agents/game-designer.md ====================
42
43
  # game-designer
43
44
 
44
45
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -97,9 +98,9 @@ dependencies:
97
98
  checklists:
98
99
  - game-design-checklist
99
100
  ```
100
- ==================== END: agents#game-designer ====================
101
+ ==================== END: .bmad-2d-phaser-game-dev/agents/game-designer.md ====================
101
102
 
102
- ==================== START: tasks#create-doc ====================
103
+ ==================== START: .bmad-2d-phaser-game-dev/tasks/create-doc.md ====================
103
104
  # Create Document from Template Task
104
105
 
105
106
  ## Purpose
@@ -119,7 +120,7 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
119
120
 
120
121
  [[LLM: Check if plan tracking is enabled in core-config.yaml]]
121
122
 
122
- - If `workflow.trackProgress: true`, check for active plan using utils#plan-management
123
+ - If `workflow.trackProgress: true`, check for active plan using .bmad-2d-phaser-game-dev/utils/plan-management.md
123
124
  - If plan exists and this document creation is part of the plan:
124
125
  - Verify this is the expected next step
125
126
  - If out of sequence and `enforceSequence: true`, warn user and halt without user override
@@ -128,7 +129,7 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
128
129
 
129
130
  ### 1. Identify Template
130
131
 
131
- - Load from `templates#*` or `{root}/templates directory`
132
+ - Load from `.bmad-2d-phaser-game-dev/templates/*.md` or `.bmad-2d-phaser-game-dev/templates directory`
132
133
  - Agent-specific templates are listed in agent's dependencies
133
134
  - If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
134
135
 
@@ -146,14 +147,14 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
146
147
 
147
148
  ### 4. Key Execution Patterns
148
149
 
149
- **When you see:** `[[LLM: Draft X and immediately execute tasks#advanced-elicitation]]`
150
+ **When you see:** `[[LLM: Draft X and immediately execute .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md]]`
150
151
 
151
152
  - Draft the content
152
153
  - Present it to user
153
154
  - IMMEDIATELY execute the task
154
155
  - Wait for completion before continuing
155
156
 
156
- **When you see:** `[[LLM: After section completion, apply tasks#Y]]`
157
+ **When you see:** `[[LLM: After section completion, apply .bmad-2d-phaser-game-dev/tasks/Y.md]]`
157
158
 
158
159
  - Finish the section
159
160
  - STOP and execute the task
@@ -191,16 +192,16 @@ Generate documents from templates by EXECUTING (not just reading) embedded instr
191
192
  ## Remember
192
193
 
193
194
  Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
194
- ==================== END: tasks#create-doc ====================
195
+ ==================== END: .bmad-2d-phaser-game-dev/tasks/create-doc.md ====================
195
196
 
196
- ==================== START: tasks#execute-checklist ====================
197
+ ==================== START: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
197
198
  # Checklist Validation Task
198
199
 
199
200
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
200
201
 
201
202
  ## Available Checklists
202
203
 
203
- If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the {root}/checklists folder to select the appropriate one to run.
204
+ If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the .bmad-2d-phaser-game-dev/checklists folder to select the appropriate one to run.
204
205
 
205
206
  ## Instructions
206
207
 
@@ -209,7 +210,7 @@ If the user asks or does not specify a specific checklist, list the checklists a
209
210
  - If user or the task being run provides a checklist name:
210
211
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
211
212
  - If multiple matches found, ask user to clarify
212
- - Load the appropriate checklist from {root}/checklists/
213
+ - Load the appropriate checklist from .bmad-2d-phaser-game-dev/checklists/
213
214
  - If no checklist specified:
214
215
  - Ask the user which checklist they want to use
215
216
  - Present the available options from the files in the checklists folder
@@ -287,9 +288,9 @@ The LLM will:
287
288
  - Execute the complete checklist validation
288
289
  - Present a final report with pass/fail rates and key findings
289
290
  - Offer to provide detailed analysis of any section, especially those with warnings or failures
290
- ==================== END: tasks#execute-checklist ====================
291
+ ==================== END: .bmad-2d-phaser-game-dev/tasks/execute-checklist.md ====================
291
292
 
292
- ==================== START: tasks#game-design-brainstorming ====================
293
+ ==================== START: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ====================
293
294
  # Game Design Brainstorming Techniques Task
294
295
 
295
296
  This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
@@ -598,9 +599,9 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
598
599
  - Consider accessibility and inclusivity from the start
599
600
  - Balance innovation with market viability
600
601
  - Plan for iteration based on player feedback
601
- ==================== END: tasks#game-design-brainstorming ====================
602
+ ==================== END: .bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md ====================
602
603
 
603
- ==================== START: tasks#create-deep-research-prompt ====================
604
+ ==================== START: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ====================
604
605
  # Create Deep Research Prompt Task
605
606
 
606
607
  This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -902,9 +903,9 @@ Present these numbered options to the user:
902
903
  - Balance comprehensiveness with focus
903
904
  - Document assumptions and limitations clearly
904
905
  - Plan for iterative refinement based on initial findings
905
- ==================== END: tasks#create-deep-research-prompt ====================
906
+ ==================== END: .bmad-2d-phaser-game-dev/tasks/create-deep-research-prompt.md ====================
906
907
 
907
- ==================== START: tasks#advanced-elicitation ====================
908
+ ==================== START: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
908
909
  # Advanced Game Design Elicitation Task
909
910
 
910
911
  ## Purpose
@@ -1016,9 +1017,9 @@ The questions and perspectives offered should always consider:
1016
1017
  - Performance implications for 60 FPS targets
1017
1018
  - Cross-platform compatibility (desktop and mobile)
1018
1019
  - Game development best practices and common pitfalls
1019
- ==================== END: tasks#advanced-elicitation ====================
1020
+ ==================== END: .bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md ====================
1020
1021
 
1021
- ==================== START: templates#game-design-doc-tmpl ====================
1022
+ ==================== START: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.md ====================
1022
1023
  # {{Game Title}} Game Design Document (GDD)
1023
1024
 
1024
1025
  [[LLM: This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.
@@ -1350,9 +1351,9 @@ If available, review any provided documents or ask if any are optionally availab
1350
1351
  - {{reference_1}}
1351
1352
  - {{reference_2}}
1352
1353
  - {{reference_3}}
1353
- ==================== END: templates#game-design-doc-tmpl ====================
1354
+ ==================== END: .bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.md ====================
1354
1355
 
1355
- ==================== START: templates#level-design-doc-tmpl ====================
1356
+ ==================== START: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md ====================
1356
1357
  # {{Game Title}} Level Design Document
1357
1358
 
1358
1359
  [[LLM: This template creates comprehensive level design documentation that guides both content creation and technical implementation. This document should provide enough detail for developers to create level loading systems and for designers to create specific levels.
@@ -1823,9 +1824,9 @@ Difficulty
1823
1824
  - Mechanic integration effectiveness: {{integration_score}}
1824
1825
  - Player guidance clarity: {{guidance_score}}
1825
1826
  - Content accessibility: {{accessibility_rate}}%
1826
- ==================== END: templates#level-design-doc-tmpl ====================
1827
+ ==================== END: .bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md ====================
1827
1828
 
1828
- ==================== START: templates#game-brief-tmpl ====================
1829
+ ==================== START: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.md ====================
1829
1830
  # {{Game Title}} Game Brief
1830
1831
 
1831
1832
  [[LLM: This template creates a comprehensive game brief that serves as the foundation for all subsequent game development work. The brief should capture the essential vision, scope, and requirements needed to create a detailed Game Design Document.
@@ -2171,9 +2172,9 @@ This brief is typically created early in the ideation process, often after brain
2171
2172
 
2172
2173
  | Date | Version | Description | Author |
2173
2174
  | :--- | :------ | :---------- | :----- |
2174
- ==================== END: templates#game-brief-tmpl ====================
2175
+ ==================== END: .bmad-2d-phaser-game-dev/templates/game-brief-tmpl.md ====================
2175
2176
 
2176
- ==================== START: checklists#game-design-checklist ====================
2177
+ ==================== START: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================
2177
2178
  # Game Design Document Quality Checklist
2178
2179
 
2179
2180
  ## Document Completeness
@@ -2375,4 +2376,4 @@ _List any critical items that need attention before moving to implementation pha
2375
2376
 
2376
2377
  **Next Steps:**
2377
2378
  _Outline immediate next actions for the team based on this assessment._
2378
- ==================== END: checklists#game-design-checklist ====================
2379
+ ==================== END: .bmad-2d-phaser-game-dev/checklists/game-design-checklist.md ====================