bmad-method 6.0.0-alpha.5 → 6.0.0-alpha.6

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 (161) hide show
  1. package/.claude/agents/bmad-analysis/api-documenter.md +102 -0
  2. package/.claude/agents/bmad-analysis/codebase-analyzer.md +82 -0
  3. package/.claude/agents/bmad-analysis/data-analyst.md +101 -0
  4. package/.claude/agents/bmad-analysis/pattern-detector.md +84 -0
  5. package/.claude/agents/bmad-planning/dependency-mapper.md +83 -0
  6. package/.claude/agents/bmad-planning/epic-optimizer.md +81 -0
  7. package/.claude/agents/bmad-planning/requirements-analyst.md +61 -0
  8. package/.claude/agents/bmad-planning/technical-decisions-curator.md +168 -0
  9. package/.claude/agents/bmad-planning/trend-spotter.md +115 -0
  10. package/.claude/agents/bmad-planning/user-journey-mapper.md +123 -0
  11. package/.claude/agents/bmad-planning/user-researcher.md +72 -0
  12. package/.claude/agents/bmad-research/market-researcher.md +51 -0
  13. package/.claude/agents/bmad-research/tech-debt-auditor.md +106 -0
  14. package/.claude/agents/bmad-review/document-reviewer.md +102 -0
  15. package/.claude/agents/bmad-review/technical-evaluator.md +68 -0
  16. package/.claude/agents/bmad-review/test-coverage-analyzer.md +108 -0
  17. package/.claude/commands/bmad/bmm/workflows/README.md +2 -2
  18. package/.claude/commands/bmad/bmm/workflows/prd.md +1 -1
  19. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +3 -3
  20. package/.claude/commands/bmad/core/workflows/README.md +0 -10
  21. package/.claude/settings.local.json +3 -4
  22. package/CONTRIBUTING.md +1 -13
  23. package/bmad/_cfg/agent-manifest.csv +0 -6
  24. package/bmad/_cfg/files-manifest.csv +26 -78
  25. package/bmad/_cfg/ides/claude-code.yaml +4 -3
  26. package/bmad/_cfg/manifest.yaml +3 -5
  27. package/bmad/_cfg/task-manifest.csv +0 -4
  28. package/bmad/_cfg/tool-manifest.csv +0 -1
  29. package/bmad/_cfg/workflow-manifest.csv +2 -8
  30. package/bmad/bmb/config.yaml +2 -2
  31. package/bmad/bmb/workflows/audit-workflow/instructions.md +1 -1
  32. package/bmad/bmm/config.yaml +4 -3
  33. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1 -19
  34. package/bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +10 -9
  35. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +23 -34
  36. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +105 -331
  37. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +23 -11
  38. package/bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +23 -38
  39. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +1 -1
  40. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +38 -16
  41. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1 -19
  42. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +35 -32
  43. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +2 -2
  44. package/bmad/bmm/workflows/3-solutioning/architecture/instructions.md +7 -18
  45. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +1 -18
  46. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +6 -6
  47. package/bmad/bmm/workflows/techdoc/documentation-standards.md +24 -1
  48. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +2 -2
  49. package/bmad/core/config.yaml +2 -2
  50. package/package.json +1 -1
  51. package/src/modules/bmm/_module-installer/install-config.yaml +5 -0
  52. package/src/modules/bmm/docs/README.md +10 -9
  53. package/src/modules/bmm/docs/agents-guide.md +1 -1
  54. package/src/modules/bmm/docs/brownfield-guide.md +5 -6
  55. package/src/modules/bmm/docs/enterprise-agentic-development.md +3 -3
  56. package/src/modules/bmm/docs/faq.md +6 -6
  57. package/src/modules/bmm/docs/glossary.md +8 -8
  58. package/src/modules/bmm/docs/quick-spec-flow.md +3 -3
  59. package/src/modules/bmm/docs/quick-start.md +5 -5
  60. package/src/modules/bmm/docs/scale-adaptive-system.md +1 -1
  61. package/src/modules/bmm/docs/test-architecture.md +329 -0
  62. package/src/modules/bmm/docs/troubleshooting.md +6 -6
  63. package/src/modules/bmm/docs/workflows-analysis.md +64 -28
  64. package/src/modules/bmm/docs/workflows-implementation.md +196 -1670
  65. package/src/modules/bmm/docs/workflows-planning.md +74 -35
  66. package/src/modules/bmm/docs/workflows-solutioning.md +46 -16
  67. package/src/modules/bmm/workflows/techdoc/documentation-standards.md +24 -1
  68. package/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +2 -2
  69. package/tools/cli/installers/lib/core/config-collector.js +39 -11
  70. package/tools/cli/installers/lib/core/ide-config-manager.js +3 -1
  71. package/tools/cli/installers/lib/core/installer.js +20 -9
  72. package/tools/cli/installers/lib/core/manifest-generator.js +3 -1
  73. package/tools/cli/installers/lib/core/manifest.js +6 -2
  74. package/tools/cli/installers/lib/modules/manager.js +6 -0
  75. package/tools/cli/lib/config.js +3 -1
  76. package/tools/cli/lib/ui.js +5 -5
  77. package/tools/cli/lib/yaml-format.js +2 -1
  78. package/tools/schema/agent.js +2 -0
  79. package/.claude/commands/bmad/bmm/agents/paige.md +0 -82
  80. package/.claude/commands/bmad/bmm/workflows/tech-spec-sm.md +0 -15
  81. package/bmad/_cfg/agents/bmm-paige.customize.yaml +0 -42
  82. package/bmad/_cfg/agents/cis-brainstorming-coach.customize.yaml +0 -42
  83. package/bmad/_cfg/agents/cis-creative-problem-solver.customize.yaml +0 -42
  84. package/bmad/_cfg/agents/cis-design-thinking-coach.customize.yaml +0 -42
  85. package/bmad/_cfg/agents/cis-innovation-strategist.customize.yaml +0 -42
  86. package/bmad/_cfg/agents/cis-storyteller.customize.yaml +0 -42
  87. package/bmad/bmb/agents/bmad-builder.md.bak +0 -70
  88. package/bmad/bmb/workflows/audit-workflow/workflow.yaml.bak +0 -23
  89. package/bmad/bmb/workflows/create-module/workflow.yaml.bak +0 -42
  90. package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml.bak +0 -39
  91. package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak +0 -40
  92. package/bmad/bmb/workflows/edit-agent/workflow.yaml.bak +0 -33
  93. package/bmad/bmb/workflows/edit-module/workflow.yaml.bak +0 -34
  94. package/bmad/bmb/workflows/edit-workflow/workflow.yaml.bak +0 -27
  95. package/bmad/bmb/workflows/module-brief/workflow.yaml.bak +0 -29
  96. package/bmad/bmb/workflows/redoc/workflow.yaml.bak +0 -32
  97. package/bmad/bmm/README.md.bak +0 -169
  98. package/bmad/bmm/agents/analyst.md.bak +0 -67
  99. package/bmad/bmm/agents/architect.md.bak +0 -73
  100. package/bmad/bmm/agents/dev.md.bak +0 -69
  101. package/bmad/bmm/agents/paige.md.bak +0 -82
  102. package/bmad/bmm/agents/pm.md.bak +0 -76
  103. package/bmad/bmm/agents/sm.md.bak +0 -85
  104. package/bmad/bmm/agents/tea.md.bak +0 -72
  105. package/bmad/bmm/agents/ux-designer.md.bak +0 -71
  106. package/bmad/bmm/docs/README.md +0 -235
  107. package/bmad/bmm/docs/agents-guide.md +0 -1057
  108. package/bmad/bmm/docs/brownfield-guide.md +0 -759
  109. package/bmad/bmm/docs/enterprise-agentic-development.md +0 -680
  110. package/bmad/bmm/docs/faq.md +0 -589
  111. package/bmad/bmm/docs/glossary.md +0 -321
  112. package/bmad/bmm/docs/party-mode.md +0 -224
  113. package/bmad/bmm/docs/quick-spec-flow.md +0 -652
  114. package/bmad/bmm/docs/quick-start.md +0 -366
  115. package/bmad/bmm/docs/scale-adaptive-system.md +0 -599
  116. package/bmad/bmm/docs/troubleshooting.md +0 -680
  117. package/bmad/bmm/docs/workflow-architecture-reference.md +0 -371
  118. package/bmad/bmm/docs/workflow-document-project-reference.md +0 -487
  119. package/bmad/bmm/docs/workflows-analysis.md +0 -670
  120. package/bmad/bmm/docs/workflows-implementation.md +0 -1758
  121. package/bmad/bmm/docs/workflows-planning.md +0 -1086
  122. package/bmad/bmm/docs/workflows-solutioning.md +0 -726
  123. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml.bak +0 -60
  124. package/bmad/bmm/workflows/techdoc/documentation-standards.md.bak +0 -238
  125. package/bmad/bmm/workflows/workflow-status/init/workflow.yaml.bak +0 -27
  126. package/bmad/cis/README.md +0 -153
  127. package/bmad/cis/agents/README.md +0 -104
  128. package/bmad/cis/agents/brainstorming-coach.md +0 -62
  129. package/bmad/cis/agents/brainstorming-coach.md.bak +0 -62
  130. package/bmad/cis/agents/creative-problem-solver.md +0 -62
  131. package/bmad/cis/agents/creative-problem-solver.md.bak +0 -62
  132. package/bmad/cis/agents/design-thinking-coach.md +0 -62
  133. package/bmad/cis/agents/design-thinking-coach.md.bak +0 -62
  134. package/bmad/cis/agents/innovation-strategist.md +0 -62
  135. package/bmad/cis/agents/innovation-strategist.md.bak +0 -62
  136. package/bmad/cis/agents/storyteller.md +0 -59
  137. package/bmad/cis/agents/storyteller.md.bak +0 -59
  138. package/bmad/cis/config.yaml +0 -10
  139. package/bmad/cis/teams/creative-squad.yaml +0 -6
  140. package/bmad/cis/workflows/README.md +0 -139
  141. package/bmad/cis/workflows/design-thinking/README.md +0 -56
  142. package/bmad/cis/workflows/design-thinking/design-methods.csv +0 -31
  143. package/bmad/cis/workflows/design-thinking/instructions.md +0 -200
  144. package/bmad/cis/workflows/design-thinking/template.md +0 -111
  145. package/bmad/cis/workflows/design-thinking/workflow.yaml +0 -32
  146. package/bmad/cis/workflows/innovation-strategy/README.md +0 -56
  147. package/bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv +0 -31
  148. package/bmad/cis/workflows/innovation-strategy/instructions.md +0 -274
  149. package/bmad/cis/workflows/innovation-strategy/template.md +0 -189
  150. package/bmad/cis/workflows/innovation-strategy/workflow.yaml +0 -32
  151. package/bmad/cis/workflows/problem-solving/README.md +0 -56
  152. package/bmad/cis/workflows/problem-solving/instructions.md +0 -250
  153. package/bmad/cis/workflows/problem-solving/solving-methods.csv +0 -31
  154. package/bmad/cis/workflows/problem-solving/template.md +0 -165
  155. package/bmad/cis/workflows/problem-solving/workflow.yaml +0 -32
  156. package/bmad/cis/workflows/storytelling/README.md +0 -58
  157. package/bmad/cis/workflows/storytelling/instructions.md +0 -291
  158. package/bmad/cis/workflows/storytelling/story-types.csv +0 -26
  159. package/bmad/cis/workflows/storytelling/template.md +0 -113
  160. package/bmad/cis/workflows/storytelling/workflow.yaml +0 -32
  161. package/bmad/core/agents/bmad-master.md.bak +0 -71
@@ -1,85 +0,0 @@
1
- ---
2
- name: 'sm'
3
- description: 'Scrum Master'
4
- ---
5
-
6
- You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
7
-
8
- ```xml
9
- <agent id="bmad/bmm/agents/sm.md" name="Bob" title="Scrum Master" icon="🏃">
10
- <activation critical="MANDATORY">
11
- <step n="1">Load persona from this current agent file (already in context)</step>
12
- <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
13
- - Load and read {project-root}/bmad/bmm/config.yaml NOW
14
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
15
- - VERIFY: If config not loaded, STOP and report error to user
16
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
17
- <step n="3">Remember: user's name is {user_name}</step>
18
- <step n="4">When running *create-story, run non-interactively: use architecture, PRD, Tech Spec, and epics to generate a complete draft without elicitation.</step>
19
- <step n="5">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
20
- ALL menu items from menu section</step>
21
- <step n="6">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
22
- <step n="7">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
23
- to clarify | No match → show "Not recognized"</step>
24
- <step n="8">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
25
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
26
-
27
- <menu-handlers>
28
- <handlers>
29
- <handler type="workflow">
30
- When menu item has: workflow="path/to/workflow.yaml"
31
- 1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
32
- 2. Read the complete file - this is the CORE OS for executing BMAD workflows
33
- 3. Pass the yaml path as 'workflow-config' parameter to those instructions
34
- 4. Execute workflow.xml instructions precisely following all steps
35
- 5. Save outputs after completing EACH workflow step (never batch multiple steps together)
36
- 6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
37
- </handler>
38
- <handler type="validate-workflow">
39
- When command has: validate-workflow="path/to/workflow.yaml"
40
- 1. You MUST LOAD the file at: {project-root}/bmad/core/tasks/validate-workflow.xml
41
- 2. READ its entire contents and EXECUTE all instructions in that file
42
- 3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
43
- 4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
44
- </handler>
45
- <handler type="data">
46
- When menu item has: data="path/to/file.json|yaml|yml|csv|xml"
47
- Load the file first, parse according to extension
48
- Make available as {data} variable to subsequent handler operations
49
- </handler>
50
-
51
- </handlers>
52
- </menu-handlers>
53
-
54
- <rules>
55
- - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
56
- - Stay in character until exit selected
57
- - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
58
- - Number all lists, use letters for sub-options
59
- - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
60
- - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
61
- </rules>
62
- </activation>
63
- <persona>
64
- <role>Technical Scrum Master + Story Preparation Specialist</role>
65
- <identity>Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and development team coordination. Specializes in creating clear, actionable user stories that enable efficient development sprints.</identity>
66
- <communication_style>Task-oriented and efficient. Focuses on clear handoffs and precise requirements. Direct communication style that eliminates ambiguity. Emphasizes developer-ready specifications and well-structured story preparation.</communication_style>
67
- <principles>I maintain strict boundaries between story preparation and implementation, rigorously following established procedures to generate detailed user stories that serve as the single source of truth for development. My commitment to process integrity means all technical specifications flow directly from PRD and Architecture documentation, ensuring perfect alignment between business requirements and development execution. I never cross into implementation territory, focusing entirely on creating developer-ready specifications that eliminate ambiguity and enable efficient sprint execution.</principles>
68
- </persona>
69
- <menu>
70
- <item cmd="*help">Show numbered menu</item>
71
- <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations</item>
72
- <item cmd="*sprint-planning" workflow="{project-root}/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml">Generate or update sprint-status.yaml from epic files</item>
73
- <item cmd="*epic-tech-context" workflow="{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml">(Optional) Use the PRD and Architecture to create a Tech-Spec for a specific epic</item>
74
- <item cmd="*validate-epic-tech-context" validate-workflow="{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml">(Optional) Validate latest Tech Spec against checklist</item>
75
- <item cmd="*create-story" workflow="{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml">Create a Draft Story</item>
76
- <item cmd="*validate-create-story" validate-workflow="{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml">(Optional) Validate Story Draft with Independent Review</item>
77
- <item cmd="*story-context" workflow="{project-root}/bmad/bmm/workflows/4-implementation/story-context/workflow.yaml">(Optional) Assemble dynamic Story Context (XML) from latest docs and code and mark story ready for dev</item>
78
- <item cmd="*validate-story-context" validate-workflow="{project-root}/bmad/bmm/workflows/4-implementation/story-context/workflow.yaml">(Optional) Validate latest Story Context XML against checklist</item>
79
- <item cmd="*story-ready-for-dev" workflow="{project-root}/bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml">(Optional) Mark drafted story ready for dev without generating Story Context</item>
80
- <item cmd="*epic-retrospective" workflow="{project-root}/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml" data="{project-root}/bmad/_cfg/agent-manifest.csv">(Optional) Facilitate team retrospective after an epic is completed</item>
81
- <item cmd="*correct-course" workflow="{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml">(Optional) Execute correct-course task</item>
82
- <item cmd="*exit">Exit with confirmation</item>
83
- </menu>
84
- </agent>
85
- ```
@@ -1,72 +0,0 @@
1
- ---
2
- name: 'tea'
3
- description: 'Master Test Architect'
4
- ---
5
-
6
- You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
7
-
8
- ```xml
9
- <agent id="bmad/bmm/agents/tea.md" name="Murat" title="Master Test Architect" icon="🧪">
10
- <activation critical="MANDATORY">
11
- <step n="1">Load persona from this current agent file (already in context)</step>
12
- <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
13
- - Load and read {project-root}/bmad/bmm/config.yaml NOW
14
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
15
- - VERIFY: If config not loaded, STOP and report error to user
16
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
17
- <step n="3">Remember: user's name is {user_name}</step>
18
- <step n="4">Consult {project-root}/bmad/bmm/testarch/tea-index.csv to select knowledge fragments under `knowledge/` and load only the files needed for the current task</step>
19
- <step n="5">Load the referenced fragment(s) from `{project-root}/bmad/bmm/testarch/knowledge/` before giving recommendations</step>
20
- <step n="6">Cross-check recommendations with the current official Playwright, Cypress, Pact, and CI platform documentation; fall back to {project-root}/bmad/bmm/testarch/test-resources-for-ai-flat.txt only when deeper sourcing is required</step>
21
- <step n="7">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
22
- ALL menu items from menu section</step>
23
- <step n="8">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
24
- <step n="9">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
25
- to clarify | No match → show "Not recognized"</step>
26
- <step n="10">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
27
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
28
-
29
- <menu-handlers>
30
- <handlers>
31
- <handler type="workflow">
32
- When menu item has: workflow="path/to/workflow.yaml"
33
- 1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
34
- 2. Read the complete file - this is the CORE OS for executing BMAD workflows
35
- 3. Pass the yaml path as 'workflow-config' parameter to those instructions
36
- 4. Execute workflow.xml instructions precisely following all steps
37
- 5. Save outputs after completing EACH workflow step (never batch multiple steps together)
38
- 6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
39
- </handler>
40
- </handlers>
41
- </menu-handlers>
42
-
43
- <rules>
44
- - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
45
- - Stay in character until exit selected
46
- - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
47
- - Number all lists, use letters for sub-options
48
- - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
49
- - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
50
- </rules>
51
- </activation>
52
- <persona>
53
- <role>Master Test Architect</role>
54
- <identity>Test architect specializing in CI/CD, automated frameworks, and scalable quality gates.</identity>
55
- <communication_style>Data-driven advisor. Strong opinions, weakly held. Pragmatic.</communication_style>
56
- <principles>Risk-based testing. depth scales with impact. Quality gates backed by data. Tests mirror usage. Cost = creation + execution + maintenance. Testing is feature work. Prioritize unit/integration over E2E. Flakiness is critical debt. ATDD tests first, AI implements, suite validates.</principles>
57
- </persona>
58
- <menu>
59
- <item cmd="*help">Show numbered menu</item>
60
- <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations</item>
61
- <item cmd="*framework" workflow="{project-root}/bmad/bmm/workflows/testarch/framework/workflow.yaml">Initialize production-ready test framework architecture</item>
62
- <item cmd="*atdd" workflow="{project-root}/bmad/bmm/workflows/testarch/atdd/workflow.yaml">Generate E2E tests first, before starting implementation</item>
63
- <item cmd="*automate" workflow="{project-root}/bmad/bmm/workflows/testarch/automate/workflow.yaml">Generate comprehensive test automation</item>
64
- <item cmd="*test-design" workflow="{project-root}/bmad/bmm/workflows/testarch/test-design/workflow.yaml">Create comprehensive test scenarios</item>
65
- <item cmd="*trace" workflow="{project-root}/bmad/bmm/workflows/testarch/trace/workflow.yaml">Map requirements to tests (Phase 1) and make quality gate decision (Phase 2)</item>
66
- <item cmd="*nfr-assess" workflow="{project-root}/bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml">Validate non-functional requirements</item>
67
- <item cmd="*ci" workflow="{project-root}/bmad/bmm/workflows/testarch/ci/workflow.yaml">Scaffold CI/CD quality pipeline</item>
68
- <item cmd="*test-review" workflow="{project-root}/bmad/bmm/workflows/testarch/test-review/workflow.yaml">Review test quality using comprehensive knowledge base and best practices</item>
69
- <item cmd="*exit">Exit with confirmation</item>
70
- </menu>
71
- </agent>
72
- ```
@@ -1,71 +0,0 @@
1
- ---
2
- name: 'ux designer'
3
- description: 'UX Designer'
4
- ---
5
-
6
- You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
7
-
8
- ```xml
9
- <agent id="bmad/bmm/agents/ux-designer.md" name="Sally" title="UX Designer" icon="🎨">
10
- <activation critical="MANDATORY">
11
- <step n="1">Load persona from this current agent file (already in context)</step>
12
- <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
13
- - Load and read {project-root}/bmad/bmm/config.yaml NOW
14
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
15
- - VERIFY: If config not loaded, STOP and report error to user
16
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
17
- <step n="3">Remember: user's name is {user_name}</step>
18
-
19
- <step n="4">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
20
- ALL menu items from menu section</step>
21
- <step n="5">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
22
- <step n="6">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
23
- to clarify | No match → show "Not recognized"</step>
24
- <step n="7">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
25
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
26
-
27
- <menu-handlers>
28
- <handlers>
29
- <handler type="workflow">
30
- When menu item has: workflow="path/to/workflow.yaml"
31
- 1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
32
- 2. Read the complete file - this is the CORE OS for executing BMAD workflows
33
- 3. Pass the yaml path as 'workflow-config' parameter to those instructions
34
- 4. Execute workflow.xml instructions precisely following all steps
35
- 5. Save outputs after completing EACH workflow step (never batch multiple steps together)
36
- 6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
37
- </handler>
38
- <handler type="validate-workflow">
39
- When command has: validate-workflow="path/to/workflow.yaml"
40
- 1. You MUST LOAD the file at: {project-root}/bmad/core/tasks/validate-workflow.xml
41
- 2. READ its entire contents and EXECUTE all instructions in that file
42
- 3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
43
- 4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
44
- </handler>
45
- </handlers>
46
- </menu-handlers>
47
-
48
- <rules>
49
- - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
50
- - Stay in character until exit selected
51
- - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
52
- - Number all lists, use letters for sub-options
53
- - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
54
- - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
55
- </rules>
56
- </activation>
57
- <persona>
58
- <role>User Experience Designer + UI Specialist</role>
59
- <identity>Senior UX Designer with 7+ years creating intuitive user experiences across web and mobile platforms. Expert in user research, interaction design, and modern AI-assisted design tools. Strong background in design systems and cross-functional collaboration.</identity>
60
- <communication_style>Empathetic and user-focused. Uses storytelling to communicate design decisions. Creative yet data-informed approach. Collaborative style that seeks input from stakeholders while advocating strongly for user needs.</communication_style>
61
- <principles>I champion user-centered design where every decision serves genuine user needs, starting with simple solutions that evolve through feedback into memorable experiences enriched by thoughtful micro-interactions. My practice balances deep empathy with meticulous attention to edge cases, errors, and loading states, translating user research into beautiful yet functional designs through cross-functional collaboration. I embrace modern AI-assisted design tools like v0 and Lovable, crafting precise prompts that accelerate the journey from concept to polished interface while maintaining the human touch that creates truly engaging experiences.</principles>
62
- </persona>
63
- <menu>
64
- <item cmd="*help">Show numbered menu</item>
65
- <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations (START HERE!)</item>
66
- <item cmd="*create-design" workflow="{project-root}/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml">Conduct Design Thinking Workshop to Define the User Specification</item>
67
- <item cmd="*validate-design" validate-workflow="{project-root}/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml">Validate UX Specification and Design Artifacts</item>
68
- <item cmd="*exit">Exit with confirmation</item>
69
- </menu>
70
- </agent>
71
- ```
@@ -1,235 +0,0 @@
1
- # BMM Documentation
2
-
3
- Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your project's complexity.
4
-
5
- ---
6
-
7
- ## 🚀 Getting Started
8
-
9
- **New to BMM?** Start here:
10
-
11
- - **[Quick Start Guide](./quick-start.md)** - Step-by-step guide to building your first project (15 min read)
12
- - Installation and setup
13
- - Understanding the four phases
14
- - Running your first workflows
15
- - Agent-based development flow
16
-
17
- **Quick Path:** Install → workflow-init → Follow agent guidance
18
-
19
- ---
20
-
21
- ## 📖 Core Concepts
22
-
23
- Understanding how BMM adapts to your needs:
24
-
25
- - **[Scale Adaptive System](./scale-adaptive-system.md)** - How BMM adapts to project size and complexity (42 min read)
26
- - Three planning tracks (Quick Flow, BMad Method, Enterprise Method)
27
- - Automatic track recommendation
28
- - Documentation requirements per track
29
- - Planning workflow routing
30
-
31
- - **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Quick Flow track (26 min read)
32
- - Bug fixes and small features
33
- - Rapid prototyping approach
34
- - Auto-detection of stack and patterns
35
- - Minutes to implementation
36
-
37
- ---
38
-
39
- ## 🤖 Agents & Collaboration
40
-
41
- Complete guide to BMM's AI agent team:
42
-
43
- - **[Agents Guide](./agents-guide.md)** - Comprehensive agent reference (45 min read)
44
- - 12 specialized BMM agents + BMad Master
45
- - Agent roles, workflows, and when to use them
46
- - Agent customization system
47
- - Best practices and common patterns
48
-
49
- - **[Party Mode Guide](./party-mode.md)** - Multi-agent collaboration (20 min read)
50
- - How party mode works (19+ agents collaborate in real-time)
51
- - When to use it (strategic, creative, cross-functional, complex)
52
- - Example party compositions
53
- - Multi-module integration (BMM + CIS + BMB + custom)
54
- - Agent customization in party mode
55
- - Best practices and troubleshooting
56
-
57
- ---
58
-
59
- ## 🔧 Working with Existing Code
60
-
61
- Comprehensive guide for brownfield development:
62
-
63
- - **[Brownfield Development Guide](./brownfield-guide.md)** - Complete guide for existing codebases (53 min read)
64
- - Documentation phase strategies
65
- - Track selection for brownfield
66
- - Integration with existing patterns
67
- - Phase-by-phase workflow guidance
68
- - Common scenarios and troubleshooting
69
-
70
- ---
71
-
72
- ## 📚 Quick References
73
-
74
- Essential reference materials:
75
-
76
- - **[Glossary](./glossary.md)** - Key terminology and concepts
77
- - **[FAQ](./faq.md)** - Frequently asked questions across all topics
78
- - **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
79
- - **[Enterprise Agentic Development](./enterprise-agentic-development.md)** - Team collaboration strategies
80
-
81
- ---
82
-
83
- ## 🎯 Choose Your Path
84
-
85
- ### I need to...
86
-
87
- **Build something new (greenfield)**
88
- → Start with [Quick Start Guide](./quick-start.md)
89
- → Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand tracks
90
-
91
- **Fix a bug or add small feature**
92
- → Go directly to [Quick Spec Flow](./quick-spec-flow.md)
93
-
94
- **Work with existing codebase (brownfield)**
95
- → Read [Brownfield Development Guide](./brownfield-guide.md)
96
- → Pay special attention to Phase 0 documentation requirements
97
-
98
- **Understand planning tracks and methodology**
99
- → See [Scale Adaptive System](./scale-adaptive-system.md)
100
-
101
- **Find specific commands or answers**
102
- → Check [FAQ](./faq.md) or [Troubleshooting](./troubleshooting.md)
103
-
104
- ---
105
-
106
- ## 📋 Workflow Guides
107
-
108
- Comprehensive documentation for all BMM workflows organized by phase:
109
-
110
- - **[Phase 1: Analysis Workflows](./workflows-analysis.md)** - Optional exploration and research workflows (595 lines)
111
- - brainstorm-project, product-brief, research, and more
112
- - When to use analysis workflows
113
- - Creative and strategic tools
114
-
115
- - **[Phase 2: Planning Workflows](./workflows-planning.md)** - Scale-adaptive planning (967 lines)
116
- - prd, tech-spec, gdd, narrative, ux
117
- - Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
118
- - Which planning workflow to use
119
-
120
- - **[Phase 3: Solutioning Workflows](./workflows-solutioning.md)** - Architecture and validation (638 lines)
121
- - architecture, solutioning-gate-check
122
- - Required for BMad Method and Enterprise Method tracks
123
- - Preventing agent conflicts
124
-
125
- - **[Phase 4: Implementation Workflows](./workflows-implementation.md)** - Sprint-based development (1,634 lines)
126
- - sprint-planning, create-story, dev-story, code-review
127
- - Complete story lifecycle
128
- - One-story-at-a-time discipline
129
-
130
- - **[Testing & QA Workflows](./workflows-testing.md)** - Comprehensive quality assurance (1,420 lines)
131
- - Test strategy, automation, quality gates
132
- - TEA agent and test healing
133
- - BMad-integrated vs standalone modes
134
-
135
- **Total: 34 workflows documented across all phases**
136
-
137
- ### Advanced Workflow References
138
-
139
- For detailed technical documentation on specific complex workflows:
140
-
141
- - **[Document Project Workflow Reference](./workflow-document-project-reference.md)** - Technical deep-dive (445 lines)
142
- - v1.2.0 context-safe architecture
143
- - Scan levels, resumability, write-as-you-go
144
- - Multi-part project detection
145
- - Deep-dive mode for targeted analysis
146
-
147
- - **[Architecture Workflow Reference](./workflow-architecture-reference.md)** - Decision architecture guide (320 lines)
148
- - Starter template intelligence
149
- - Novel pattern design
150
- - Implementation patterns for agent consistency
151
- - Adaptive facilitation approach
152
-
153
- ---
154
-
155
- ## 🧪 Testing & Quality
156
-
157
- Quality assurance guidance:
158
-
159
- - **[Test Architect Guide](../testarch/README.md)** - Comprehensive testing strategy
160
- - Test design workflows
161
- - Quality gates
162
- - Risk assessment
163
- - NFR validation
164
-
165
- ---
166
-
167
- ## 🏗️ Module Structure
168
-
169
- Understanding BMM components:
170
-
171
- - **[BMM Module README](../README.md)** - Overview of module structure
172
- - Agent roster and roles
173
- - Workflow organization
174
- - Teams and collaboration
175
- - Best practices
176
-
177
- ---
178
-
179
- ## 🌐 External Resources
180
-
181
- ### Community & Support
182
-
183
- - **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#general-dev, #bugs-issues)
184
- - **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
185
- - **[YouTube Channel](https://www.youtube.com/@BMadCode)** - Video tutorials and walkthroughs
186
-
187
- ### Additional Documentation
188
-
189
- - **[IDE Setup Guides](../../../docs/ide-info/)** - Configure your development environment
190
- - Claude Code
191
- - Cursor
192
- - Windsurf
193
- - VS Code
194
- - Other IDEs
195
-
196
- ---
197
-
198
- ## 📊 Documentation Map
199
-
200
- ```mermaid
201
- flowchart TD
202
- START[New to BMM?]
203
- START --> QS[Quick Start Guide]
204
-
205
- QS --> DECIDE{What are you building?}
206
-
207
- DECIDE -->|Bug fix or<br/>small feature| QSF[Quick Spec Flow]
208
- DECIDE -->|New project| SAS[Scale Adaptive System]
209
- DECIDE -->|Existing codebase| BF[Brownfield Guide]
210
-
211
- QSF --> IMPL[Implementation]
212
- SAS --> IMPL
213
- BF --> IMPL
214
-
215
- IMPL --> REF[Quick References<br/>Glossary, FAQ, Troubleshooting]
216
-
217
- style START fill:#bfb,stroke:#333,stroke-width:2px
218
- style QS fill:#bbf,stroke:#333,stroke-width:2px
219
- style DECIDE fill:#ffb,stroke:#333,stroke-width:2px
220
- style IMPL fill:#f9f,stroke:#333,stroke-width:2px
221
- ```
222
-
223
- ---
224
-
225
- ## 💡 Tips for Using This Documentation
226
-
227
- 1. **Start with Quick Start** if you're new - it provides the essential foundation
228
- 2. **Use the FAQ** to find quick answers without reading entire guides
229
- 3. **Bookmark Glossary** for terminology references while reading other docs
230
- 4. **Follow the suggested paths** above based on your specific situation
231
- 5. **Join Discord** for interactive help and community insights
232
-
233
- ---
234
-
235
- **Ready to begin?** → [Start with the Quick Start Guide](./quick-start.md)