bmad-method 6.0.0-alpha.10 → 6.0.0-alpha.11

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 (107) hide show
  1. package/CHANGELOG.md +215 -1109
  2. package/README.md +129 -359
  3. package/docs/custom-agent-installation.md +169 -0
  4. package/{v6-open-items.md → docs/v6-open-items.md} +1 -1
  5. package/package.json +2 -1
  6. package/src/core/resources/excalidraw/README.md +160 -0
  7. package/src/core/resources/excalidraw/library-loader.md +50 -0
  8. package/src/modules/bmb/docs/agent-compilation.md +340 -0
  9. package/src/modules/bmb/docs/agent-menu-patterns.md +524 -0
  10. package/src/modules/bmb/docs/expert-agent-architecture.md +364 -0
  11. package/src/modules/bmb/docs/index.md +55 -0
  12. package/src/modules/bmb/docs/module-agent-architecture.md +367 -0
  13. package/src/modules/bmb/docs/simple-agent-architecture.md +288 -0
  14. package/src/modules/bmb/docs/understanding-agent-types.md +184 -0
  15. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/README.md +242 -0
  16. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/breakthroughs.md +24 -0
  17. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/instructions.md +108 -0
  18. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/memories.md +46 -0
  19. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper-sidecar/mood-patterns.md +39 -0
  20. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml +152 -0
  21. package/src/modules/bmb/reference/agents/module-examples/README.md +50 -0
  22. package/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml +53 -0
  23. package/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml +57 -0
  24. package/src/modules/bmb/reference/agents/simple-examples/README.md +223 -0
  25. package/src/modules/bmb/reference/agents/simple-examples/commit-poet.agent.yaml +126 -0
  26. package/src/modules/bmb/reference/readme.md +3 -0
  27. package/src/modules/bmb/workflows/create-agent/agent-validation-checklist.md +174 -0
  28. package/src/modules/bmb/workflows/create-agent/brainstorm-context.md +99 -120
  29. package/src/modules/bmb/workflows/create-agent/communication-presets.csv +61 -0
  30. package/src/modules/bmb/workflows/create-agent/instructions.md +126 -65
  31. package/src/modules/bmb/workflows/create-agent/workflow.yaml +19 -12
  32. package/src/modules/bmb/workflows/edit-agent/README.md +174 -47
  33. package/src/modules/bmb/workflows/edit-agent/instructions.md +397 -33
  34. package/src/modules/bmb/workflows/edit-agent/workflow.yaml +24 -8
  35. package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +1 -1
  36. package/src/modules/bmm/agents/analyst.agent.yaml +2 -2
  37. package/src/modules/bmm/agents/architect.agent.yaml +10 -2
  38. package/src/modules/bmm/agents/dev.agent.yaml +2 -2
  39. package/src/modules/bmm/agents/pm.agent.yaml +7 -3
  40. package/src/modules/bmm/agents/sm.agent.yaml +2 -2
  41. package/src/modules/bmm/agents/tea.agent.yaml +2 -2
  42. package/src/modules/bmm/agents/tech-writer.agent.yaml +15 -3
  43. package/src/modules/bmm/agents/ux-designer.agent.yaml +6 -2
  44. package/src/modules/bmm/docs/README.md +4 -0
  45. package/src/modules/bmm/docs/images/workflow-method-greenfield.excalidraw +5919 -0
  46. package/src/modules/bmm/docs/images/workflow-method-greenfield.svg +2 -0
  47. package/src/modules/bmm/docs/quick-start.md +6 -0
  48. package/src/modules/bmm/docs/scale-adaptive-system.md +6 -0
  49. package/src/modules/bmm/docs/workflows-implementation.md +10 -0
  50. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +4 -4
  51. package/src/modules/bmm/workflows/{2-plan-workflows → 3-solutioning}/create-epics-and-stories/workflow.yaml +5 -5
  52. package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +1 -1
  53. package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-dataflow/instructions.md +7 -8
  54. package/src/modules/bmm/workflows/diagrams/create-dataflow/workflow.yaml +27 -0
  55. package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-diagram/instructions.md +9 -10
  56. package/src/modules/bmm/workflows/diagrams/create-diagram/workflow.yaml +27 -0
  57. package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-flowchart/instructions.md +4 -5
  58. package/src/modules/bmm/workflows/diagrams/create-flowchart/workflow.yaml +27 -0
  59. package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-wireframe/instructions.md +3 -3
  60. package/src/modules/bmm/workflows/diagrams/create-wireframe/workflow.yaml +27 -0
  61. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +18 -30
  62. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +2 -14
  63. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +2 -14
  64. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +2 -14
  65. package/src/modules/cis/agents/presentation-master.agent.yaml +60 -0
  66. package/tools/cli/commands/agent-install.js +409 -0
  67. package/tools/cli/installers/lib/core/installer.js +119 -0
  68. package/tools/cli/installers/lib/ide/_base-ide.js +25 -0
  69. package/tools/cli/installers/lib/ide/antigravity.js +463 -0
  70. package/tools/cli/installers/lib/ide/claude-code.js +43 -0
  71. package/tools/cli/installers/lib/ide/codex.js +217 -32
  72. package/tools/cli/installers/lib/ide/cursor.js +48 -0
  73. package/tools/cli/installers/lib/ide/github-copilot.js +74 -0
  74. package/tools/cli/installers/lib/ide/manager.js +35 -0
  75. package/tools/cli/installers/lib/ide/opencode.js +45 -0
  76. package/tools/cli/installers/lib/ide/windsurf.js +47 -0
  77. package/tools/cli/lib/agent/compiler.js +390 -0
  78. package/tools/cli/lib/agent/installer.js +725 -0
  79. package/tools/cli/lib/agent/template-engine.js +152 -0
  80. package/docs/installers-bundlers/web-bundler-usage.md +0 -54
  81. package/src/modules/bmb/workflows/create-agent/README.md +0 -203
  82. package/src/modules/bmb/workflows/create-agent/agent-architecture.md +0 -415
  83. package/src/modules/bmb/workflows/create-agent/agent-command-patterns.md +0 -759
  84. package/src/modules/bmb/workflows/create-agent/agent-types.md +0 -292
  85. package/src/modules/bmb/workflows/create-agent/checklist.md +0 -62
  86. package/src/modules/bmb/workflows/create-agent/communication-styles.md +0 -202
  87. package/src/modules/bmb/workflows/edit-agent/checklist.md +0 -112
  88. package/src/modules/bmb/workflows/redoc/README.md +0 -87
  89. package/src/modules/bmb/workflows/redoc/checklist.md +0 -99
  90. package/src/modules/bmb/workflows/redoc/instructions.md +0 -265
  91. package/src/modules/bmb/workflows/redoc/workflow.yaml +0 -34
  92. package/src/modules/bmm/agents/frame-expert.agent.yaml +0 -42
  93. package/src/modules/bmm/workflows/frame-expert/create-dataflow/workflow.yaml +0 -24
  94. package/src/modules/bmm/workflows/frame-expert/create-diagram/workflow.yaml +0 -25
  95. package/src/modules/bmm/workflows/frame-expert/create-flowchart/workflow.yaml +0 -28
  96. package/src/modules/bmm/workflows/frame-expert/create-wireframe/workflow.yaml +0 -24
  97. package/src/modules/bmm/workflows/workflow-status/paths/game-design.yaml +0 -52
  98. /package/src/{modules/bmm/workflows/frame-expert/_shared → core/resources/excalidraw}/excalidraw-helpers.md +0 -0
  99. /package/src/{modules/bmm/workflows/frame-expert/_shared → core/resources/excalidraw}/validate-json-instructions.md +0 -0
  100. /package/src/modules/bmm/workflows/{2-plan-workflows → 3-solutioning}/create-epics-and-stories/epics-template.md +0 -0
  101. /package/src/modules/bmm/workflows/{2-plan-workflows → 3-solutioning}/create-epics-and-stories/instructions.md +0 -0
  102. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/_shared/excalidraw-library.json +0 -0
  103. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/_shared/excalidraw-templates.yaml +0 -0
  104. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-dataflow/checklist.md +0 -0
  105. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-diagram/checklist.md +0 -0
  106. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-flowchart/checklist.md +0 -0
  107. /package/src/modules/bmm/workflows/{frame-expert → diagrams}/create-wireframe/checklist.md +0 -0
@@ -21,7 +21,7 @@
21
21
  4. Tablet App
22
22
  5. Multi-platform
23
23
  </action>
24
- <action>WAIT for selection, store in {{wireframe_type}}</action>
24
+ <action>WAIT for selection</action>
25
25
  </step>
26
26
 
27
27
  <step n="2" goal="Gather Requirements" elicit="true">
@@ -108,12 +108,12 @@
108
108
 
109
109
  <step n="8" goal="Optimize and Save">
110
110
  <action>Strip unused elements and elements with isDeleted: true</action>
111
- <action>Save to {{save_location}}</action>
111
+ <action>Save to {{default_output_file}}</action>
112
112
  </step>
113
113
 
114
114
  <step n="9" goal="Validate JSON Syntax">
115
115
  <critical>NEVER delete the file if validation fails - always fix syntax errors</critical>
116
- <action>Run: node -e "JSON.parse(require('fs').readFileSync('{{save_location}}', 'utf8')); console.log('✓ Valid JSON')"</action>
116
+ <action>Run: node -e "JSON.parse(require('fs').readFileSync('{{default_output_file}}', 'utf8')); console.log('✓ Valid JSON')"</action>
117
117
  <check if="validation fails (exit code 1)">
118
118
  <action>Read the error message carefully - it shows the syntax error and position</action>
119
119
  <action>Open the file and navigate to the error location</action>
@@ -0,0 +1,27 @@
1
+ name: create-excalidraw-wireframe
2
+ description: "Create website or app wireframes in Excalidraw format"
3
+ author: "BMad"
4
+
5
+ # Config values
6
+ config_source: "{project-root}/{bmad_folder}/bmm/config.yaml"
7
+ output_folder: "{config_source}:output_folder"
8
+
9
+ # Workflow components
10
+ installed_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/create-wireframe"
11
+ shared_path: "{project-root}/{bmad_folder}/bmm/workflows/diagrams/_shared"
12
+ instructions: "{installed_path}/instructions.md"
13
+ validation: "{installed_path}/checklist.md"
14
+
15
+ # Core Excalidraw resources (universal knowledge)
16
+ helpers: "{project-root}/{bmad_folder}/core/resources/excalidraw/excalidraw-helpers.md"
17
+ json_validation: "{project-root}/{bmad_folder}/core/resources/excalidraw/validate-json-instructions.md"
18
+
19
+ # Domain-specific resources (technical diagrams)
20
+ templates: "{shared_path}/excalidraw-templates.yaml"
21
+ library: "{shared_path}/excalidraw-library.json"
22
+
23
+ # Output file (respects user's configured output_folder)
24
+ default_output_file: "{output_folder}/diagrams/wireframe-{timestamp}.excalidraw"
25
+
26
+ standalone: true
27
+ web_bundle: false
@@ -60,24 +60,12 @@ phases:
60
60
  agent: "pm"
61
61
  command: "validate-prd"
62
62
 
63
- - id: "create-epics-and-stories"
64
- optional: true
65
- agent: "pm"
66
- command: "create-epics-and-stories"
67
- note: "Optional: Create epic breakdown early (basic structure only)"
68
-
69
63
  - id: "create-design"
70
64
  recommended: true
71
65
  agent: "ux-designer"
72
66
  command: "create-design"
73
67
  note: "Recommended - must integrate with existing UX patterns"
74
68
 
75
- - id: "create-epics-and-stories-after-ux"
76
- optional: true
77
- agent: "pm"
78
- command: "create-epics-and-stories"
79
- note: "Optional: Create epic breakdown with UX context"
80
-
81
69
  - phase: 2
82
70
  name: "Solutioning"
83
71
  required: true
@@ -89,6 +77,12 @@ phases:
89
77
  output: "Integration architecture with enterprise considerations"
90
78
  note: "Distills brownfield context + adds security/scalability/compliance design"
91
79
 
80
+ - id: "create-epics-and-stories"
81
+ required: true
82
+ agent: "pm"
83
+ command: "create-epics-and-stories"
84
+ note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
85
+
92
86
  - id: "test-design"
93
87
  required: true
94
88
  agent: "tea"
@@ -96,31 +90,25 @@ phases:
96
90
  output: "System-level testability review"
97
91
  note: "Enterprise requires testability validation - auto-detects system-level mode"
98
92
 
99
- - id: "create-security-architecture"
100
- optional: true
101
- agent: "architect"
102
- command: "create-security-architecture"
103
- output: "Security architecture for brownfield integration"
104
- note: "Future workflow - optional extended enterprise workflow for threat model, auth integration, audit requirements"
93
+ # - id: "create-security-architecture"
94
+ # optional: true
95
+ # agent: "architect"
96
+ # command: "create-security-architecture"
97
+ # output: "Security architecture for brownfield integration"
98
+ # note: "Future workflow - optional extended enterprise workflow for threat model, auth integration, audit requirements"
105
99
 
106
- - id: "create-devops-strategy"
107
- optional: true
108
- agent: "architect"
109
- command: "create-devops-strategy"
110
- output: "DevOps strategy for brownfield deployment"
111
- note: "Future workflow - optional extended enterprise workflow for CI/CD integration, deployment strategy, monitoring"
100
+ # - id: "create-devops-strategy"
101
+ # optional: true
102
+ # agent: "architect"
103
+ # command: "create-devops-strategy"
104
+ # output: "DevOps strategy for brownfield deployment"
105
+ # note: "Future workflow - optional extended enterprise workflow for CI/CD integration, deployment strategy, monitoring"
112
106
 
113
107
  - id: "validate-architecture"
114
108
  recommended: true
115
109
  agent: "architect"
116
110
  command: "validate-architecture"
117
111
 
118
- - id: "create-epics-and-stories-final"
119
- required: true
120
- agent: "pm"
121
- command: "create-epics-and-stories"
122
- note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
123
-
124
112
  - id: "implementation-readiness"
125
113
  required: true
126
114
  agent: "architect"
@@ -48,24 +48,12 @@ phases:
48
48
  agent: "pm"
49
49
  command: "validate-prd"
50
50
 
51
- - id: "create-epics-and-stories"
52
- optional: true
53
- agent: "pm"
54
- command: "create-epics-and-stories"
55
- note: "Optional: Create epic breakdown early (basic structure only)"
56
-
57
51
  - id: "create-design"
58
52
  recommended: true
59
53
  agent: "ux-designer"
60
54
  command: "create-design"
61
55
  note: "Highly recommended for enterprise - design system and patterns"
62
56
 
63
- - id: "create-epics-and-stories-after-ux"
64
- optional: true
65
- agent: "pm"
66
- command: "create-epics-and-stories"
67
- note: "Optional: Create epic breakdown with UX context"
68
-
69
57
  - phase: 2
70
58
  name: "Solutioning"
71
59
  required: true
@@ -103,11 +91,11 @@ phases:
103
91
  agent: "architect"
104
92
  command: "validate-architecture"
105
93
 
106
- - id: "create-epics-and-stories-final"
94
+ - id: "create-epics-and-stories"
107
95
  required: true
108
96
  agent: "pm"
109
97
  command: "create-epics-and-stories"
110
- note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
98
+ note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
111
99
 
112
100
  - id: "implementation-readiness"
113
101
  required: true
@@ -59,23 +59,11 @@ phases:
59
59
  agent: "pm"
60
60
  command: "validate-prd"
61
61
 
62
- - id: "create-epics-and-stories"
63
- optional: true
64
- agent: "pm"
65
- command: "create-epics-and-stories"
66
- note: "Optional: Create epic breakdown early (basic structure only)"
67
-
68
62
  - id: "create-design"
69
63
  conditional: "if_has_ui"
70
64
  agent: "ux-designer"
71
65
  command: "create-design"
72
66
 
73
- - id: "create-epics-and-stories-after-ux"
74
- optional: true
75
- agent: "pm"
76
- command: "create-epics-and-stories"
77
- note: "Optional: Create epic breakdown with UX context"
78
-
79
67
  - phase: 2
80
68
  name: "Solutioning"
81
69
  required: true
@@ -87,11 +75,11 @@ phases:
87
75
  output: "Integration architecture - solution design for THIS project"
88
76
  note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
89
77
 
90
- - id: "create-epics-and-stories-final"
78
+ - id: "create-epics-and-stories"
91
79
  required: true
92
80
  agent: "pm"
93
81
  command: "create-epics-and-stories"
94
- note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
82
+ note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
95
83
 
96
84
  - id: "test-design"
97
85
  recommended: true
@@ -48,24 +48,12 @@ phases:
48
48
  command: "validate-prd"
49
49
  note: "Quality check for PRD completeness"
50
50
 
51
- - id: "create-epics-and-stories"
52
- optional: true
53
- agent: "pm"
54
- command: "create-epics-and-stories"
55
- note: "Optional: Create epic breakdown early (basic structure only)"
56
-
57
51
  - id: "create-design"
58
52
  conditional: "if_has_ui"
59
53
  agent: "ux-designer"
60
54
  command: "create-design"
61
55
  note: "Determined after PRD - user/agent decides if needed"
62
56
 
63
- - id: "create-epics-and-stories-after-ux"
64
- optional: true
65
- agent: "pm"
66
- command: "create-epics-and-stories"
67
- note: "Optional: Create epic breakdown with UX context"
68
-
69
57
  - phase: 2
70
58
  name: "Solutioning"
71
59
  required: true
@@ -77,11 +65,11 @@ phases:
77
65
  output: "System architecture document"
78
66
  note: "Complete system design for greenfield projects"
79
67
 
80
- - id: "create-epics-and-stories-final"
68
+ - id: "create-epics-and-stories"
81
69
  required: true
82
70
  agent: "pm"
83
71
  command: "create-epics-and-stories"
84
- note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
72
+ note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
85
73
 
86
74
  - id: "test-design"
87
75
  recommended: true
@@ -0,0 +1,60 @@
1
+ # Caravaggio - Visual Communication & Presentation Expert Agent Definition
2
+
3
+ agent:
4
+ metadata:
5
+ id: "{bmad_folder}/cis/agents/presentation-master.md"
6
+ name: Caravaggio
7
+ title: Visual Communication & Presentation Expert
8
+ icon: 🎨
9
+ module: cis
10
+
11
+ persona:
12
+ role: Visual Communication Expert + Presentation Designer + Educator
13
+ identity: Master presentation designer who's dissected thousands of successful presentations—from viral YouTube explainers to funded pitch decks to TED talks. Understands visual hierarchy, audience psychology, and information design. Knows when to be bold and casual, when to be polished and professional. Expert in Excalidraw's frame-based presentation capabilities and visual storytelling across all contexts.
14
+ communication_style: Energetic creative director with sarcastic wit and experimental flair. Talks like you're in the editing room together—dramatic reveals, visual metaphors, "what if we tried THIS?!" energy. Treats every project like a creative challenge, celebrates bold choices, roasts bad design decisions with humor.
15
+ principles: |
16
+ - Know your audience - pitch decks ≠ YouTube thumbnails ≠ conference talks
17
+ - Visual hierarchy drives attention - design the eye's journey deliberately
18
+ - Clarity over cleverness - unless cleverness serves the message
19
+ - Every frame needs a job - inform, persuade, transition, or cut it
20
+ - Test the 3-second rule - can they grasp the core idea that fast?
21
+ - White space builds focus - cramming kills comprehension
22
+ - Consistency signals professionalism - establish and maintain visual language
23
+ - Story structure applies everywhere - hook, build tension, deliver payoff
24
+
25
+ menu:
26
+ - trigger: slide-deck
27
+ workflow: "todo"
28
+ description: Create multi-slide presentation with professional layouts and visual hierarchy
29
+
30
+ - trigger: explainer
31
+ workflow: "todo"
32
+ description: Design YouTube/video explainer layout with visual script and engagement hooks
33
+
34
+ - trigger: pitch-deck
35
+ workflow: "todo"
36
+ description: Craft investor pitch presentation with data visualization and narrative arc
37
+
38
+ - trigger: talk
39
+ workflow: "todo"
40
+ description: Build conference or workshop presentation materials with speaker notes
41
+
42
+ - trigger: infographic
43
+ workflow: "todo"
44
+ description: Design creative information visualization with visual storytelling
45
+
46
+ - trigger: visual-metaphor
47
+ workflow: "todo"
48
+ description: Create conceptual illustrations (Rube Goldberg machines, journey maps, creative processes)
49
+
50
+ - trigger: concept-visual
51
+ workflow: "todo"
52
+ description: Generate single expressive image that explains ideas creatively and memorably
53
+
54
+ - trigger: party-mode
55
+ workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
56
+ description: Consult with other expert agents from the party
57
+
58
+ - trigger: advanced-elicitation
59
+ exec: "{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml"
60
+ description: Advanced elicitation techniques to challenge the LLM to get better results