bmad-plus 0.5.0 → 0.6.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 (73) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/README.md +4 -2
  3. package/package.json +1 -1
  4. package/readme-international/README.de.md +1 -1
  5. package/readme-international/README.es.md +1 -1
  6. package/readme-international/README.fr.md +1 -1
  7. package/src/bmad-plus/module.yaml +33 -0
  8. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -0
  9. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +74 -0
  10. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +62 -0
  11. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +96 -0
  12. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +96 -0
  13. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +135 -0
  14. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +81 -0
  15. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +74 -0
  16. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +96 -0
  17. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +74 -0
  18. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +74 -0
  19. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +93 -0
  20. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +81 -0
  21. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +91 -0
  22. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -0
  23. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -0
  24. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -0
  25. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -0
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -0
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -0
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -0
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -0
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +82 -0
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +68 -0
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -0
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -0
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -0
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +132 -0
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +90 -0
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +301 -0
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +429 -0
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +74 -0
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -0
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +485 -0
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +194 -0
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +176 -0
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +111 -0
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1512 -0
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +299 -0
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +297 -0
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +30 -0
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +75 -0
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +30 -0
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +74 -0
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +90 -0
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +74 -0
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +30 -0
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +142 -0
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -0
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -0
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -0
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +111 -0
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +177 -0
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -0
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -0
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -0
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -0
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +128 -0
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -0
  67. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -0
  68. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -0
  69. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -0
  70. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -0
  71. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -0
  72. package/tools/cli/commands/install.js +10 -1
  73. package/tools/cli/i18n.js +10 -10
@@ -0,0 +1,328 @@
1
+ # BMAD+ Workflow Markup Language (BWML) — Specification v1.0
2
+
3
+ > **Pack:** Dev Studio
4
+ > **Purpose:** Define the BMAD+ proprietary workflow DSL that surpasses BMAD-METHOD v6 XML format
5
+ > **Created by:** Laurent Rochetta — https://github.com/lrochetta/BMAD-PLUS
6
+ > **License:** MIT
7
+
8
+ ---
9
+
10
+ ## Overview
11
+
12
+ BWML (BMAD+ Workflow Markup Language) is an XML-based DSL optimized for LLM execution. It extends the concepts from BMAD-METHOD v6 with advanced orchestration primitives: multi-agent delegation, parallel execution, validation gates, memory persistence, anti-regression guards, and structured artifact emission.
13
+
14
+ LLMs parse XML natively and reliably. BWML leverages this with semantically meaningful tags that guide deterministic execution while preserving LLM reasoning flexibility.
15
+
16
+ ---
17
+
18
+ ## Core Elements (inherited from BMAD v6, enhanced)
19
+
20
+ ### `<workflow>` — Root container
21
+ ```xml
22
+ <workflow id="dev-story" version="1.0" agent="oholiab">
23
+ <!-- All steps live here -->
24
+ </workflow>
25
+ ```
26
+
27
+ ### `<phase>` — Named execution phase (NEW)
28
+ Groups steps into logical phases with optional gating.
29
+ ```xml
30
+ <phase name="analysis" gate="required">
31
+ <step>...</step>
32
+ <step>...</step>
33
+ </phase>
34
+ ```
35
+ - `gate="required"` — Must complete before next phase
36
+ - `gate="optional"` — Can be skipped
37
+
38
+ ### `<step>` — Numbered execution step
39
+ ```xml
40
+ <step n="1" goal="Load project context" tag="init">
41
+ <action>...</action>
42
+ </step>
43
+ ```
44
+
45
+ ### `<action>` — Single action to execute
46
+ ```xml
47
+ <action>Read the complete story file</action>
48
+ <action if="no stories found">HALT: inform user</action>
49
+ ```
50
+
51
+ ### `<check>` — Conditional branch
52
+ ```xml
53
+ <check if="sprint_status file exists">
54
+ <action>Load sprint data</action>
55
+ </check>
56
+ ```
57
+
58
+ ### `<critical>` — Must-follow rule (violation = HALT)
59
+ ```xml
60
+ <critical>Execute ALL steps in exact order; do NOT skip steps</critical>
61
+ ```
62
+
63
+ ### `<output>` — Formatted user-facing output
64
+ ```xml
65
+ <output>✅ **Context Loaded** — Story and project context ready</output>
66
+ ```
67
+
68
+ ### `<ask>` — Prompt user for input
69
+ ```xml
70
+ <ask>Which story would you like to develop?</ask>
71
+ ```
72
+
73
+ ### `<goto>` — Jump to step or anchor
74
+ ```xml
75
+ <goto step="9">Completion sequence</goto>
76
+ <goto anchor="task_check" />
77
+ ```
78
+
79
+ ### `<anchor>` — Jump target
80
+ ```xml
81
+ <anchor id="task_check" />
82
+ ```
83
+
84
+ ---
85
+
86
+ ## BMAD+ Extensions (NEW — our competitive advantage)
87
+
88
+ ### `<agent>` — Invoke another BMAD+ agent inline
89
+ Enables cross-agent orchestration without leaving the workflow.
90
+ ```xml
91
+ <agent name="bezalel" task="Review this architecture decision">
92
+ <context>Current PRD and technical constraints</context>
93
+ <expect>Architecture recommendation with trade-offs</expect>
94
+ </agent>
95
+ ```
96
+ - `name` — BMAD+ agent to invoke (Torah personas or pack agents)
97
+ - `task` — What to ask the agent
98
+ - `<context>` — What context to pass
99
+ - `<expect>` — Expected output format
100
+
101
+ ### `<parallel>` — Execute multiple actions concurrently
102
+ ```xml
103
+ <parallel>
104
+ <action>Run unit tests</action>
105
+ <action>Run linting checks</action>
106
+ <action>Validate acceptance criteria</action>
107
+ </parallel>
108
+ ```
109
+
110
+ ### `<loop>` — Iterative execution with break conditions
111
+ ```xml
112
+ <loop over="incomplete_tasks" as="task">
113
+ <action>Implement {{task}}</action>
114
+ <action>Run tests for {{task}}</action>
115
+ <validate>All tests pass for {{task}}</validate>
116
+ <action>Mark {{task}} complete</action>
117
+ <break if="HALT condition triggered" />
118
+ </loop>
119
+ ```
120
+
121
+ ### `<validate>` — Built-in validation gate with pass/fail
122
+ ```xml
123
+ <validate id="dod-check" severity="blocking">
124
+ <criterion>All tasks marked [x]</criterion>
125
+ <criterion>All acceptance criteria satisfied</criterion>
126
+ <criterion>Full test suite passes with 0 failures</criterion>
127
+ <criterion>No regressions detected</criterion>
128
+ <on-fail>HALT — Do NOT proceed until all criteria pass</on-fail>
129
+ <on-pass>Continue to next step</on-pass>
130
+ </validate>
131
+ ```
132
+
133
+ ### `<guard>` — Anti-regression protection
134
+ Prevents common AI mistakes explicitly.
135
+ ```xml
136
+ <guard type="anti-regression">
137
+ Never delete existing code without explicit user approval
138
+ </guard>
139
+ <guard type="scope">
140
+ Only modify files listed in the story spec
141
+ </guard>
142
+ <guard type="quality">
143
+ Never mark a task complete without running tests
144
+ </guard>
145
+ ```
146
+
147
+ ### `<emit>` — Produce structured artifacts
148
+ ```xml
149
+ <emit type="story-status" format="yaml">
150
+ story_key: {{story_key}}
151
+ status: review
152
+ completed_tasks: {{completed_count}}
153
+ date: {{date}}
154
+ </emit>
155
+ ```
156
+ - `type` — Artifact type (story-status, report, checklist, etc.)
157
+ - `format` — Output format (yaml, markdown, json)
158
+
159
+ ### `<context>` — Load external context
160
+ ```xml
161
+ <context source="file" path="**/project-context.md" />
162
+ <context source="file" path="architecture.md" optional="true" />
163
+ <context source="memory" key="last-sprint-decisions" />
164
+ ```
165
+
166
+ ### `<memory>` — Persist/recall across sessions
167
+ ```xml
168
+ <memory action="store" key="sprint-velocity" value="{{calculated_velocity}}" />
169
+ <memory action="recall" key="last-review-findings" />
170
+ ```
171
+
172
+ ### `<escalate>` — Escalation to human or higher agent
173
+ ```xml
174
+ <escalate to="user" severity="high">
175
+ Architecture decision required: monolith vs microservices.
176
+ Trade-offs documented in {{arch_doc_path}}.
177
+ </escalate>
178
+ <escalate to="bezalel" severity="medium">
179
+ Implementation diverges from architecture — review needed.
180
+ </escalate>
181
+ ```
182
+
183
+ ### `<retry>` — Auto-retry with limits
184
+ ```xml
185
+ <retry max="3" backoff="progressive">
186
+ <action>Run failing test suite</action>
187
+ <action>Fix identified issues</action>
188
+ <on-exhaust>HALT — 3 consecutive failures, request human guidance</on-exhaust>
189
+ </retry>
190
+ ```
191
+
192
+ ### `<fallback>` — Graceful degradation
193
+ ```xml
194
+ <fallback>
195
+ <try>
196
+ <agent name="miriam" task="Analyze market data" />
197
+ </try>
198
+ <catch>
199
+ <action>Perform analysis directly using available context</action>
200
+ </catch>
201
+ </fallback>
202
+ ```
203
+
204
+ ### `<metric>` — Track quantitative progress
205
+ ```xml
206
+ <metric name="test-coverage" target="80%" current="{{coverage}}" />
207
+ <metric name="tasks-completed" value="{{done}}/{{total}}" />
208
+ ```
209
+
210
+ ---
211
+
212
+ ## Composition Example
213
+
214
+ ```xml
215
+ <workflow id="dev-story" version="1.0" agent="oholiab">
216
+ <critical>Execute ALL steps in exact order; do NOT skip</critical>
217
+ <critical>Never stop for "milestones" or "session boundaries"</critical>
218
+
219
+ <guard type="anti-regression">
220
+ Never delete existing functionality without explicit approval
221
+ </guard>
222
+ <guard type="scope">
223
+ Only modify files specified in the story tasks
224
+ </guard>
225
+
226
+ <phase name="initialization" gate="required">
227
+ <step n="1" goal="Find and load story">
228
+ <context source="file" path="sprint-status.yaml" optional="true" />
229
+ <check if="story_path provided">
230
+ <action>Load story file directly</action>
231
+ <goto anchor="implementation" />
232
+ </check>
233
+ <check if="sprint status exists">
234
+ <action>Find first ready-for-dev story</action>
235
+ </check>
236
+ <escalate to="user" if="no ready stories found">
237
+ No stories available. Options: create-story, validate existing, or specify path.
238
+ </escalate>
239
+ </step>
240
+ </phase>
241
+
242
+ <phase name="implementation" gate="required">
243
+ <anchor id="implementation" />
244
+ <loop over="incomplete_tasks" as="task">
245
+ <step goal="Implement {{task}} following TDD">
246
+ <!-- RED -->
247
+ <action>Write FAILING tests first</action>
248
+ <validate severity="info">Tests fail as expected</validate>
249
+
250
+ <!-- GREEN -->
251
+ <action>Implement MINIMAL code to pass tests</action>
252
+ <validate severity="blocking">All tests pass</validate>
253
+
254
+ <!-- REFACTOR -->
255
+ <action>Improve code structure, keep tests green</action>
256
+ <validate severity="blocking">No regressions after refactor</validate>
257
+
258
+ <action>Mark {{task}} [x] in story file</action>
259
+ <metric name="tasks-completed" value="{{done}}/{{total}}" />
260
+ </step>
261
+
262
+ <retry max="3">
263
+ <action>Fix any failing tests</action>
264
+ <on-exhaust>
265
+ <escalate to="user">3 consecutive failures on {{task}}</escalate>
266
+ </on-exhaust>
267
+ </retry>
268
+ </loop>
269
+ </phase>
270
+
271
+ <phase name="completion" gate="required">
272
+ <step goal="Story completion and review">
273
+ <validate id="definition-of-done" severity="blocking">
274
+ <criterion>All tasks marked [x]</criterion>
275
+ <criterion>All acceptance criteria satisfied</criterion>
276
+ <criterion>Full test suite passes</criterion>
277
+ <criterion>File list complete</criterion>
278
+ <criterion>Dev notes documented</criterion>
279
+ <on-fail>HALT — Complete remaining items</on-fail>
280
+ </validate>
281
+
282
+ <emit type="story-update" format="yaml">
283
+ status: review
284
+ completed: {{date}}
285
+ </emit>
286
+
287
+ <output>✅ Story {{story_key}} complete and ready for review</output>
288
+
289
+ <escalate to="user" severity="info">
290
+ Recommended: run code-review with a DIFFERENT LLM
291
+ </escalate>
292
+ </step>
293
+ </phase>
294
+ </workflow>
295
+ ```
296
+
297
+ ---
298
+
299
+ ## BWML vs BMAD v6 Comparison
300
+
301
+ | Feature | BMAD v6 | BWML (BMAD+) |
302
+ |---------|---------|--------------|
303
+ | Steps & Actions | ✅ | ✅ |
304
+ | Conditional checks | ✅ | ✅ |
305
+ | Goto/Anchors | ✅ | ✅ |
306
+ | Critical rules | ✅ | ✅ |
307
+ | User prompts | ✅ | ✅ |
308
+ | **Phases with gates** | ❌ | ✅ |
309
+ | **Multi-agent delegation** | ❌ | ✅ `<agent>` |
310
+ | **Parallel execution** | ❌ | ✅ `<parallel>` |
311
+ | **Loops with break** | ❌ | ✅ `<loop>` |
312
+ | **Validation gates** | ❌ | ✅ `<validate>` |
313
+ | **Anti-regression guards** | ❌ | ✅ `<guard>` |
314
+ | **Artifact emission** | ❌ | ✅ `<emit>` |
315
+ | **Context loading** | ❌ | ✅ `<context>` |
316
+ | **Memory persistence** | ❌ | ✅ `<memory>` |
317
+ | **Escalation** | ❌ | ✅ `<escalate>` |
318
+ | **Auto-retry** | ❌ | ✅ `<retry>` |
319
+ | **Graceful fallback** | ❌ | ✅ `<fallback>` |
320
+ | **Progress metrics** | ❌ | ✅ `<metric>` |
321
+ | Python dependency | ✅ Required | ❌ None |
322
+ | TOML config | ✅ Required | ❌ Self-contained |
323
+
324
+ ---
325
+
326
+ ## Attribution
327
+
328
+ BWML is inspired by the workflow DSL in [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.6.0 by BMad Code, LLC (MIT License). Extended with BMAD+ proprietary orchestration primitives by [Laurent Rochetta](https://github.com/lrochetta/BMAD-PLUS).
@@ -0,0 +1,32 @@
1
+ module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs
2
+ BMad Method,_meta,,,,,,,,,false,https://docs.bmad-method.org/llms.txt,
3
+ BMad Method,bmad-document-project,Document Project,DP,Analyze an existing project to produce useful documentation.,,,anytime,,,false,project-knowledge,*
4
+ BMad Method,bmad-generate-project-context,Generate Project Context,GPC,Scan existing codebase to generate a lean LLM-optimized project-context.md. Essential for brownfield projects.,,,anytime,,,false,output_folder,project context
5
+ BMad Method,bmad-quick-dev,Quick Dev,QQ,Unified intent-in code-out workflow: clarify plan implement review and present.,,,anytime,,,false,implementation_artifacts,spec and project implementation
6
+ BMad Method,bmad-correct-course,Correct Course,CC,Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories.,,,anytime,,,false,planning_artifacts,change proposal
7
+ BMad Method,bmad-agent-tech-writer,Write Document,WD,"Describe in detail what you want, and the agent will follow documentation best practices. Multi-turn conversation with subprocess for research/review.",write,,anytime,,,false,project-knowledge,document
8
+ BMad Method,bmad-agent-tech-writer,Update Standards,US,Update agent memory documentation-standards.md with your specific preferences if you discover missing document conventions.,update-standards,,anytime,,,false,_bmad/_memory/tech-writer-sidecar,standards
9
+ BMad Method,bmad-agent-tech-writer,Mermaid Generate,MG,Create a Mermaid diagram based on user description. Will suggest diagram types if not specified.,mermaid,,anytime,,,false,planning_artifacts,mermaid diagram
10
+ BMad Method,bmad-agent-tech-writer,Validate Document,VD,Review the specified document against documentation standards and best practices. Returns specific actionable improvement suggestions organized by priority.,validate,[path],anytime,,,false,planning_artifacts,validation report
11
+ BMad Method,bmad-agent-tech-writer,Explain Concept,EC,Create clear technical explanations with examples and diagrams for complex concepts.,explain,[topic],anytime,,,false,project_knowledge,explanation
12
+ BMad Method,bmad-brainstorming,Brainstorm Project,BP,Expert guided facilitation through a single or multiple techniques.,,,1-analysis,,,false,planning_artifacts,brainstorming session
13
+ BMad Method,bmad-market-research,Market Research,MR,Market analysis competitive landscape customer needs and trends.,,,1-analysis,,,false,planning_artifacts|project-knowledge,research documents
14
+ BMad Method,bmad-domain-research,Domain Research,DR,Industry domain deep dive subject matter expertise and terminology.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
15
+ BMad Method,bmad-technical-research,Technical Research,TR,Technical feasibility architecture options and implementation approaches.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
16
+ BMad Method,bmad-product-brief,Create Brief,CB,An expert guided experience to nail down your product idea in a brief. a gentler approach than PRFAQ when you are already sure of your concept and nothing will sway you.,,-A,1-analysis,,,false,planning_artifacts,product brief
17
+ BMad Method,bmad-prfaq,PRFAQ Challenge,WB,Working Backwards guided experience to forge and stress-test your product concept to ensure you have a great product that users will love and need through the PRFAQ gauntlet to determine feasibility and alignment with user needs. alternative to product brief.,,-H,1-analysis,,,false,planning_artifacts,prfaq document
18
+ BMad Method,bmad-prd,Create Edit and Review PRD,PRD,"Facilitated PRD workflow — create a new PRD via coached discovery, update an existing one against a change signal, or validate a finished PRD against a checklist with an HTML findings report.",,,2-planning,bmad-product-brief,,true,planning_artifacts,prd
19
+ BMad Method,bmad-create-ux-design,Create UX,CU,"Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project.",,,2-planning,bmad-prd,,false,planning_artifacts,ux design
20
+ BMad Method,bmad-create-architecture,Create Architecture,CA,Guided workflow to document technical decisions.,,,3-solutioning,,,true,planning_artifacts,architecture
21
+ BMad Method,bmad-create-epics-and-stories,Create Epics and Stories,CE,,,,3-solutioning,bmad-create-architecture,,true,planning_artifacts,epics and stories
22
+ BMad Method,bmad-check-implementation-readiness,Check Implementation Readiness,IR,Ensure PRD UX Architecture and Epics Stories are aligned.,,,3-solutioning,bmad-create-epics-and-stories,,true,planning_artifacts,readiness report
23
+ BMad Method,bmad-sprint-planning,Sprint Planning,SP,Kicks off implementation by producing a plan the implementation agents will follow in sequence for every story.,,,4-implementation,,,true,implementation_artifacts,sprint status
24
+ BMad Method,bmad-sprint-status,Sprint Status,SS,Anytime: Summarize sprint status and route to next workflow.,,,4-implementation,bmad-sprint-planning,,false,,
25
+ BMad Method,bmad-create-story,Create Story,CS,Story cycle start: Prepare first found story in the sprint plan that is next or a specific epic/story designation.,create,,4-implementation,bmad-sprint-planning,bmad-create-story:validate,true,implementation_artifacts,story
26
+ BMad Method,bmad-create-story,Validate Story,VS,Validates story readiness and completeness before development work begins.,validate,,4-implementation,bmad-create-story:create,bmad-dev-story,false,implementation_artifacts,story validation report
27
+ BMad Method,bmad-dev-story,Dev Story,DS,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed.,,,4-implementation,bmad-create-story:validate,,true,,
28
+ BMad Method,bmad-code-review,Code Review,CR,Story cycle: If issues back to DS if approved then next CS or ER if epic complete.,,,4-implementation,bmad-dev-story,,false,,
29
+ BMad Method,bmad-checkpoint-preview,Checkpoint,CK,Guided walkthrough of a change from purpose and context into details. Use for human review of commits branches or PRs.,,,4-implementation,,,false,,
30
+ BMad Method,bmad-qa-generate-e2e-tests,QA Automation Test,QA,Generate automated API and E2E tests for implemented code. NOT for code review or story validation — use CR for that.,,,4-implementation,bmad-dev-story,,false,implementation_artifacts,test suite
31
+ BMad Method,bmad-retrospective,Retrospective,ER,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC.,,,4-implementation,bmad-code-review,,false,implementation_artifacts,retrospective
32
+ BMad Method,bmad-investigate,Investigate,IN,Forensic case investigation calibrated to the input. Evidence-graded analysis with hypothesis tracking. Produces a structured case file.,,4-implementation,,,false,implementation_artifacts,investigation report
@@ -0,0 +1,81 @@
1
+ # Pack Dev Studio — upstream-sync.yaml
2
+ # Tracks the source commit and version from BMAD-METHOD for future updates
3
+
4
+ upstream:
5
+ repository: https://github.com/bmad-code-org/BMAD-METHOD
6
+ version: "6.6.0"
7
+ commit: "0f852a38ac7c0ac30340b3aedc3aba4505b7c14a"
8
+ synced_at: "2026-05-17"
9
+ license: MIT
10
+
11
+ adaptations:
12
+ format: "BMAD+ BWML (Workflow Markup Language)"
13
+ personas:
14
+ Mary: Miriam (מרים)
15
+ Paige: Huldah (חולדה)
16
+ John: Yosef (יוסף)
17
+ Sally: Rachel (רחל)
18
+ Winston: Bezalel (בצלאל)
19
+ Amelia: Oholiab (אהליאב)
20
+ removed_dependencies:
21
+ - customize.toml (3-layer TOML config system)
22
+ - resolve_customization.py (Python variable resolver)
23
+ - resolve_config.py (Python config merger)
24
+ - analyze_sources.py (Python source analyzer)
25
+ - config.yaml (per-project config)
26
+ added:
27
+ - BWML specification (shared/bwml-spec.md)
28
+ - Dev Studio orchestrator
29
+ - Torah-inspired persona naming
30
+ - BMAD+ pack integration (module.yaml, CLI, i18n)
31
+
32
+ source_mapping:
33
+ categories/analysis:
34
+ - src/bmm-skills/1-analysis/bmad-agent-analyst → analyst-agent.md
35
+ - src/bmm-skills/1-analysis/bmad-agent-tech-writer → tech-writer-agent.md
36
+ - src/bmm-skills/1-analysis/bmad-product-brief → product-brief.md
37
+ - src/bmm-skills/1-analysis/bmad-prfaq → prfaq.md
38
+ - src/bmm-skills/1-analysis/bmad-document-project → document-project.md
39
+ - src/bmm-skills/1-analysis/research/bmad-market-research → market-research.md
40
+ - src/bmm-skills/1-analysis/research/bmad-domain-research → domain-research.md
41
+ - src/bmm-skills/1-analysis/research/bmad-technical-research → technical-research.md
42
+ categories/planning:
43
+ - src/bmm-skills/2-plan-workflows/bmad-agent-pm → pm-agent.md
44
+ - src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer → ux-designer-agent.md
45
+ - src/bmm-skills/2-plan-workflows/bmad-create-prd → create-prd.md
46
+ - src/bmm-skills/2-plan-workflows/bmad-create-ux-design → create-ux-design.md
47
+ - src/bmm-skills/2-plan-workflows/bmad-edit-prd → edit-prd.md
48
+ - src/bmm-skills/2-plan-workflows/bmad-prd → prd.md
49
+ - src/bmm-skills/2-plan-workflows/bmad-validate-prd → validate-prd.md
50
+ categories/architecture:
51
+ - src/bmm-skills/3-solutioning/bmad-agent-architect → architect-agent.md
52
+ - src/bmm-skills/3-solutioning/bmad-create-architecture → create-architecture.md + steps/
53
+ - src/bmm-skills/3-solutioning/bmad-create-epics-and-stories → create-epics-stories.md
54
+ - src/bmm-skills/3-solutioning/bmad-check-implementation-readiness → implementation-readiness.md
55
+ - src/bmm-skills/3-solutioning/bmad-generate-project-context → generate-project-context.md
56
+ categories/implementation:
57
+ - src/bmm-skills/4-implementation/bmad-agent-dev → dev-agent.md
58
+ - src/bmm-skills/4-implementation/bmad-dev-story → dev-story.md + checklist
59
+ - src/bmm-skills/4-implementation/bmad-create-story → create-story.md
60
+ - src/bmm-skills/4-implementation/bmad-sprint-planning → sprint-planning.md
61
+ - src/bmm-skills/4-implementation/bmad-sprint-status → sprint-status.md
62
+ - src/bmm-skills/4-implementation/bmad-code-review → code-review.md + steps/
63
+ - src/bmm-skills/4-implementation/bmad-quick-dev → quick-dev.md
64
+ - src/bmm-skills/4-implementation/bmad-correct-course → correct-course.md
65
+ - src/bmm-skills/4-implementation/bmad-checkpoint-preview → checkpoint-preview.md
66
+ - src/bmm-skills/4-implementation/bmad-investigate → investigate.md
67
+ - src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests → qa-e2e-tests.md
68
+ - src/bmm-skills/4-implementation/bmad-retrospective → retrospective.md
69
+ categories/utilities:
70
+ - src/core-skills/bmad-distillator → distillator.md
71
+ - src/core-skills/bmad-party-mode → party-mode.md
72
+ - src/core-skills/bmad-brainstorming → brainstorming.md
73
+ - src/core-skills/bmad-editorial-review-prose → editorial-review-prose.md
74
+ - src/core-skills/bmad-editorial-review-structure → editorial-review-structure.md
75
+ - src/core-skills/bmad-review-adversarial-general → adversarial-review.md
76
+ - src/core-skills/bmad-review-edge-case-hunter → edge-case-hunter.md
77
+ - src/core-skills/bmad-advanced-elicitation → advanced-elicitation.md
78
+ - src/core-skills/bmad-shard-doc → shard-doc.md
79
+ - src/core-skills/bmad-index-docs → index-docs.md
80
+ - src/core-skills/bmad-help → bmad-help.md
81
+ - src/core-skills/bmad-customize → customize.md
@@ -511,11 +511,20 @@ function generateIDEConfig(userName, language, packs) {
511
511
  agents.push('- **Shield** (GRC) — 38 compliance agents (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)');
512
512
  }
513
513
 
514
+ if (packs.includes('dev-studio')) {
515
+ agents.push('- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs');
516
+ agents.push('- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review');
517
+ agents.push('- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization');
518
+ agents.push('- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping');
519
+ agents.push('- **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories');
520
+ agents.push('- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation');
521
+ }
522
+
514
523
  return `# BMAD+ — AI Agent Configuration
515
524
 
516
525
  ## Project Context
517
526
  This project uses BMAD+, an augmented AI-driven development framework.
518
- Based on BMAD-METHOD v6.2.0 with multi-role agents, autopilot mode, and parallel execution.
527
+ Based on BMAD-METHOD v6.6.0 with multi-role agents, autopilot mode, and parallel execution.
519
528
 
520
529
  ## Agents
521
530
  To activate an agent, say its name or persona:
package/tools/cli/i18n.js CHANGED
@@ -10,7 +10,7 @@ const LANGUAGES = {
10
10
  flag: '🇬🇧',
11
11
  name: 'English',
12
12
  locale: 'en',
13
- installer_title: ' BMAD+ Installer v0.5.0 ',
13
+ installer_title: ' BMAD+ Installer v0.6.0 ',
14
14
  select_language: 'Select your language',
15
15
  installing_to: 'Installing to',
16
16
  select_packs: 'Which packs to install? (Core is always included)',
@@ -82,7 +82,7 @@ const LANGUAGES = {
82
82
  flag: '🇫🇷',
83
83
  name: 'Français',
84
84
  locale: 'fr',
85
- installer_title: ' BMAD+ Installeur v0.5.0 ',
85
+ installer_title: ' BMAD+ Installeur v0.6.0 ',
86
86
  select_language: 'Choisissez votre langue',
87
87
  installing_to: 'Installation dans',
88
88
  select_packs: 'Quels packs installer ? (Core est toujours inclus)',
@@ -152,7 +152,7 @@ const LANGUAGES = {
152
152
  flag: '🇪🇸',
153
153
  name: 'Español',
154
154
  locale: 'es',
155
- installer_title: ' BMAD+ Instalador v0.5.0 ',
155
+ installer_title: ' BMAD+ Instalador v0.6.0 ',
156
156
  select_language: 'Seleccione su idioma',
157
157
  installing_to: 'Instalando en',
158
158
  select_packs: '¿Qué packs instalar? (Core siempre está incluido)',
@@ -222,7 +222,7 @@ const LANGUAGES = {
222
222
  flag: '🇩🇪',
223
223
  name: 'Deutsch',
224
224
  locale: 'de',
225
- installer_title: ' BMAD+ Installer v0.5.0 ',
225
+ installer_title: ' BMAD+ Installer v0.6.0 ',
226
226
  select_language: 'Wählen Sie Ihre Sprache',
227
227
  installing_to: 'Installiere in',
228
228
  select_packs: 'Welche Packs installieren? (Core ist immer enthalten)',
@@ -292,7 +292,7 @@ const LANGUAGES = {
292
292
  flag: '🇧🇷',
293
293
  name: 'Português (Brasil)',
294
294
  locale: 'pt-BR',
295
- installer_title: ' BMAD+ Instalador v0.5.0 ',
295
+ installer_title: ' BMAD+ Instalador v0.6.0 ',
296
296
  select_language: 'Selecione seu idioma',
297
297
  installing_to: 'Instalando em',
298
298
  select_packs: 'Quais packs instalar? (Core sempre está incluído)',
@@ -362,7 +362,7 @@ const LANGUAGES = {
362
362
  flag: '🇷🇺',
363
363
  name: 'Русский',
364
364
  locale: 'ru',
365
- installer_title: ' BMAD+ Установщик v0.5.0 ',
365
+ installer_title: ' BMAD+ Установщик v0.6.0 ',
366
366
  select_language: 'Выберите язык',
367
367
  installing_to: 'Установка в',
368
368
  select_packs: 'Какие пакеты установить? (Core всегда включён)',
@@ -432,7 +432,7 @@ const LANGUAGES = {
432
432
  flag: '🇨🇳',
433
433
  name: '中文 (简体)',
434
434
  locale: 'zh-CN',
435
- installer_title: ' BMAD+ 安装程序 v0.5.0 ',
435
+ installer_title: ' BMAD+ 安装程序 v0.6.0 ',
436
436
  select_language: '选择您的语言',
437
437
  installing_to: '安装到',
438
438
  select_packs: '安装哪些包?(Core 始终包含)',
@@ -502,7 +502,7 @@ const LANGUAGES = {
502
502
  flag: '🇮🇱',
503
503
  name: 'עברית',
504
504
  locale: 'he',
505
- installer_title: ' BMAD+ מתקין v0.5.0 ',
505
+ installer_title: ' BMAD+ מתקין v0.6.0 ',
506
506
  select_language: 'בחר את השפה שלך',
507
507
  installing_to: 'מתקין ב',
508
508
  select_packs: 'אילו חבילות להתקין? (Core תמיד כלול)',
@@ -572,7 +572,7 @@ const LANGUAGES = {
572
572
  flag: '🇯🇵',
573
573
  name: '日本語',
574
574
  locale: 'ja',
575
- installer_title: ' BMAD+ インストーラー v0.5.0 ',
575
+ installer_title: ' BMAD+ インストーラー v0.6.0 ',
576
576
  select_language: '言語を選択してください',
577
577
  installing_to: 'インストール先',
578
578
  select_packs: 'どのパックをインストールしますか?(Coreは常に含まれます)',
@@ -642,7 +642,7 @@ const LANGUAGES = {
642
642
  flag: '🇮🇹',
643
643
  name: 'Italiano',
644
644
  locale: 'it',
645
- installer_title: ' BMAD+ Installatore v0.5.0 ',
645
+ installer_title: ' BMAD+ Installatore v0.6.0 ',
646
646
  select_language: 'Seleziona la tua lingua',
647
647
  installing_to: 'Installazione in',
648
648
  select_packs: 'Quali pack installare? (Core è sempre incluso)',