bmad-method 6.7.1-next.1 → 6.7.1-next.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 (72) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/README.md +10 -0
  3. package/package.json +3 -2
  4. package/removals.txt +8 -0
  5. package/src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md +2 -0
  6. package/src/bmm-skills/1-analysis/bmad-agent-tech-writer/SKILL.md +2 -0
  7. package/src/bmm-skills/1-analysis/bmad-document-project/SKILL.md +1 -1
  8. package/src/bmm-skills/1-analysis/bmad-prfaq/SKILL.md +1 -1
  9. package/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +4 -1
  10. package/src/bmm-skills/1-analysis/research/bmad-domain-research/SKILL.md +1 -1
  11. package/src/bmm-skills/1-analysis/research/bmad-market-research/SKILL.md +1 -1
  12. package/src/bmm-skills/1-analysis/research/bmad-technical-research/SKILL.md +1 -1
  13. package/src/bmm-skills/2-plan-workflows/bmad-agent-pm/SKILL.md +2 -0
  14. package/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/SKILL.md +2 -0
  15. package/src/bmm-skills/2-plan-workflows/bmad-prd/SKILL.md +4 -1
  16. package/src/bmm-skills/2-plan-workflows/bmad-ux/SKILL.md +4 -1
  17. package/src/bmm-skills/3-solutioning/bmad-agent-architect/SKILL.md +2 -0
  18. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/SKILL.md +1 -1
  19. package/src/bmm-skills/3-solutioning/bmad-create-architecture/SKILL.md +1 -1
  20. package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/SKILL.md +1 -1
  21. package/src/bmm-skills/3-solutioning/bmad-generate-project-context/SKILL.md +1 -1
  22. package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +2 -0
  23. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md +1 -1
  24. package/src/bmm-skills/4-implementation/bmad-code-review/SKILL.md +1 -1
  25. package/src/bmm-skills/4-implementation/bmad-correct-course/SKILL.md +1 -1
  26. package/src/bmm-skills/4-implementation/bmad-create-story/SKILL.md +1 -1
  27. package/src/bmm-skills/4-implementation/bmad-dev-story/SKILL.md +23 -8
  28. package/src/bmm-skills/4-implementation/bmad-investigate/SKILL.md +2 -0
  29. package/src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests/SKILL.md +1 -1
  30. package/src/bmm-skills/4-implementation/bmad-quick-dev/SKILL.md +1 -1
  31. package/src/bmm-skills/4-implementation/bmad-retrospective/SKILL.md +1 -1
  32. package/src/bmm-skills/4-implementation/bmad-sprint-planning/SKILL.md +2 -1
  33. package/src/bmm-skills/4-implementation/bmad-sprint-status/SKILL.md +2 -1
  34. package/src/core-skills/bmad-brainstorming/steps/step-03-technique-execution.md +6 -4
  35. package/src/core-skills/bmad-brainstorming/workflow.md +1 -1
  36. package/src/core-skills/bmad-spec/SKILL.md +129 -0
  37. package/src/core-skills/bmad-spec/assets/headless-schemas.md +33 -0
  38. package/src/core-skills/bmad-spec/assets/spec-template.md +49 -0
  39. package/src/core-skills/bmad-spec/customize.toml +53 -0
  40. package/src/core-skills/module-help.csv +1 -1
  41. package/src/scripts/resolve_customization.py +9 -1
  42. package/src/scripts/tests/test_resolve_customization.py +50 -0
  43. package/tools/bundle-web-bundles.js +117 -0
  44. package/tools/installer/modules/custom-module-manager.js +112 -3
  45. package/tools/installer/modules/official-modules.js +83 -3
  46. package/tools/validate-sidebar-order.js +388 -0
  47. package/web-bundles/README.md +46 -0
  48. package/web-bundles/brainstorming-coach/INSTRUCTIONS.md +86 -0
  49. package/web-bundles/brainstorming-coach/SKILL.md +83 -0
  50. package/web-bundles/brainstorming-coach/brain-methods.csv +62 -0
  51. package/web-bundles/bundles.json +139 -0
  52. package/web-bundles/market-and-industry-research/INSTRUCTIONS.md +88 -0
  53. package/web-bundles/market-and-industry-research/SKILL.md +59 -0
  54. package/web-bundles/prd-coach/INSTRUCTIONS.md +86 -0
  55. package/web-bundles/prd-coach/SKILL.md +101 -0
  56. package/web-bundles/prd-coach/prd-template.md +165 -0
  57. package/web-bundles/prd-coach/prd-validation-checklist.md +135 -0
  58. package/web-bundles/prfaq-coach/INSTRUCTIONS.md +86 -0
  59. package/web-bundles/prfaq-coach/SKILL.md +139 -0
  60. package/web-bundles/product-brief-coach/INSTRUCTIONS.md +86 -0
  61. package/web-bundles/product-brief-coach/SKILL.md +113 -0
  62. package/web-bundles/ux-coach/INSTRUCTIONS.md +92 -0
  63. package/web-bundles/ux-coach/SKILL.md +187 -0
  64. package/web-bundles/ux-coach/ux-validation.md +100 -0
  65. package/src/core-skills/bmad-distillator/SKILL.md +0 -177
  66. package/src/core-skills/bmad-distillator/agents/distillate-compressor.md +0 -116
  67. package/src/core-skills/bmad-distillator/agents/round-trip-reconstructor.md +0 -68
  68. package/src/core-skills/bmad-distillator/resources/compression-rules.md +0 -51
  69. package/src/core-skills/bmad-distillator/resources/distillate-format-reference.md +0 -227
  70. package/src/core-skills/bmad-distillator/resources/splitting-strategy.md +0 -78
  71. package/src/core-skills/bmad-distillator/scripts/analyze_sources.py +0 -300
  72. package/src/core-skills/bmad-distillator/scripts/tests/test_analyze_sources.py +0 -204
@@ -20,7 +20,7 @@
20
20
  "skills": [
21
21
  "./src/core-skills/bmad-help",
22
22
  "./src/core-skills/bmad-brainstorming",
23
- "./src/core-skills/bmad-distillator",
23
+ "./src/core-skills/bmad-spec",
24
24
  "./src/core-skills/bmad-party-mode",
25
25
  "./src/core-skills/bmad-shard-doc",
26
26
  "./src/core-skills/bmad-advanced-elicitation",
package/README.md CHANGED
@@ -77,6 +77,16 @@ BMad Method extends with official modules for specialized domains. Available dur
77
77
  | **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Game development workflows (Unity, Unreal, Godot) |
78
78
  | **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Innovation, brainstorming, design thinking |
79
79
 
80
+ ## Web Bundles
81
+
82
+ V4 shipped web bundles. V6 brings them back, new and improved.
83
+
84
+ Web bundles package selected BMad skills for installation as **Google Gemini Gems** and **ChatGPT Custom GPTs**. Use them to do the upfront planning work (brainstorming, product briefs, PRDs, PRFAQs, UX specs, market and industry research) in your web LLM subscription, then bring the polished artifacts into your IDE for implementation. Planning runs on a flat-rate subscription instead of metered IDE tokens, which is a meaningful cost saver on longer engagements. Choose the best model available to you in Gemini or ChatGPT.
85
+
86
+ Current shelf: brainstorming, product brief, PRFAQ, PRD, UX, market & industry research.
87
+
88
+ **Browse and install at [bmadcode.com/web-bundles](https://bmadcode.com/web-bundles/)**. One card per bundle, inline install steps for Gemini and ChatGPT, one-click ZIP download. See [the web bundles guide](https://docs.bmad-method.org/explanation/web-bundles/) for the concept.
89
+
80
90
  ## Documentation
81
91
 
82
92
  [BMad Method Docs Site](https://docs.bmad-method.org) — Tutorials, guides, concepts, and reference
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.7.1-next.1",
4
+ "version": "6.7.1-next.11",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -31,6 +31,7 @@
31
31
  "docs:fix-links": "node tools/fix-doc-links.js",
32
32
  "docs:preview": "astro preview --root website",
33
33
  "docs:validate-links": "node tools/validate-doc-links.js",
34
+ "docs:validate-sidebar": "node tools/validate-sidebar-order.js",
34
35
  "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,yaml}\"",
35
36
  "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,yaml}\"",
36
37
  "format:fix:staged": "prettier --write",
@@ -39,7 +40,7 @@
39
40
  "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
40
41
  "lint:md": "markdownlint-cli2 \"**/*.md\"",
41
42
  "prepare": "command -v husky >/dev/null 2>&1 && husky || exit 0",
42
- "quality": "npm run format:check && npm run lint && npm run lint:md && npm run docs:build && npm run test:install && npm run test:urls && npm run validate:refs && npm run validate:skills",
43
+ "quality": "npm run format:check && npm run lint && npm run lint:md && npm run docs:build && npm run test:install && npm run test:urls && npm run validate:refs && npm run validate:skills && npm run docs:validate-sidebar",
43
44
  "rebundle": "node tools/installer/bundlers/bundle-web.js rebundle",
44
45
  "test": "npm run test:refs && npm run test:install && npm run test:urls && npm run test:channels && npm run lint && npm run lint:md && npm run format:check",
45
46
  "test:channels": "node test/test-installer-channels.js",
package/removals.txt CHANGED
@@ -52,3 +52,11 @@ bmad-bmm-sprint-planning
52
52
  bmad-bmm-sprint-status
53
53
  bmad-bmm-technical-research
54
54
  bmad-bmm-validate-prd
55
+
56
+ # Removed skills (post-v6.7.x)
57
+ # bmad-distillator: superseded by bmad-spec (universal intent distiller with
58
+ # preservation-validated contract for downstream skills).
59
+ bmad-distillator
60
+ # bmad-create-ux-design: renamed to bmad-ux (spine-based skill with separate
61
+ # DESIGN.md and EXPERIENCE.md outputs).
62
+ bmad-create-ux-design
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Mary, let's brainstorm"), skip the menu and dispatch that item directly after greeting.
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Paige, let's document this codebase"), skip the menu and dispatch that item directly after greeting.
@@ -55,7 +55,7 @@ Greet `{user_name}` (if you have not already), speaking in `{communication_langu
55
55
 
56
56
  Execute each entry in `{workflow.activation_steps_append}` in order.
57
57
 
58
- Activation is complete. Begin the workflow below.
58
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
59
59
 
60
60
  ## Execution
61
61
 
@@ -65,7 +65,7 @@ Greet `{user_name}`, speaking in `{communication_language}`. Be warm but efficie
65
65
 
66
66
  Execute each entry in `{workflow.activation_steps_append}` in order.
67
67
 
68
- Activation is complete. Continue below.
68
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
69
69
 
70
70
  ## Pre-workflow Setup
71
71
 
@@ -21,7 +21,10 @@ At the opening greeting, let the user know they can invoke `bmad-party-mode` for
21
21
  4. `{workflow.external_sources}` is an org-configured registry of internal tools (knowledge bases, MCP tools); consult them alongside generic web research on the same triggers in `## Discovery`, org tools preferred when their directive matches. If a named tool is unavailable at runtime, fall back to standard behavior and note the gap when relevant.
22
22
  5. Load `{project-root}/_bmad/bmm/config.yaml` (and `config.user.yaml` if present). Resolve `{user_name}`, `{communication_language}`, `{document_output_language}`, `{planning_artifacts}`, `{project_name}`, `{date}`.
23
23
  6. Greet `{user_name}` in `{communication_language}` — and stay in `{communication_language}` for every turn for the entire run, not just the greeting. Detect intent (create / update / validate). If interactive and intent is unclear, ask; for headless behavior see `## Headless Mode`.
24
- 7. Execute each entry in `{workflow.activation_steps_append}` in order.
24
+
25
+ Execute each entry in `{workflow.activation_steps_append}` in order.
26
+
27
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
25
28
 
26
29
  ## Intent Operating Modes
27
30
 
@@ -59,7 +59,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
59
59
 
60
60
  Execute each entry in `{workflow.activation_steps_append}` in order.
61
61
 
62
- Activation is complete. Begin the workflow below.
62
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
63
63
 
64
64
  ## QUICK TOPIC DISCOVERY
65
65
 
@@ -59,7 +59,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
59
59
 
60
60
  Execute each entry in `{workflow.activation_steps_append}` in order.
61
61
 
62
- Activation is complete. Begin the workflow below.
62
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
63
63
 
64
64
  ## QUICK TOPIC DISCOVERY
65
65
 
@@ -59,7 +59,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
59
59
 
60
60
  Execute each entry in `{workflow.activation_steps_append}` in order.
61
61
 
62
- Activation is complete. Begin the workflow below.
62
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
63
63
 
64
64
  ## QUICK TOPIC DISCOVERY
65
65
 
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey John, let's write the PRD"), skip the menu and dispatch that item directly after greeting.
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Sally, let's design the UX"), skip the menu and dispatch that item directly after greeting.
@@ -20,7 +20,10 @@ You are a master facilitator and coach helping the user create, edit, or validat
20
20
  3. Load `{project-root}/_bmad/bmm/config.yaml` (+ `config.user.yaml` if present). Resolve `{user_name}`, `{communication_language}`, `{document_output_language}`, `{planning_artifacts}`, `{project_name}`, `{date}`. Missing keys → neutral defaults; never block.
21
21
  4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn for the entire run, not just the greeting. In the greeting, let the user know that at any point they can invoke `bmad-party-mode` for multi-agent perspectives or `bmad-advanced-elicitation` for deeper exploration on a specific section. Then scan for misroute on the first message: if the signal points elsewhere (game → BMad GDS; express build → `bmad-quick-dev`; one-pager → `bmad-product-brief`; vet product idea → `bmad-prfaq`; agent skill or custom agent → `bmad-workflow-builder`), suggest they might want the other options before continuing.
22
22
  5. Detect intent: **Create** (no PRD), **Update** (existing PRD), **Validate** (critique only). If ambiguous, ask. For Create intent, before binding a fresh workspace, scan `{workflow.prd_output_path}` for prior in-progress runs (folders matching `{workflow.run_folder_pattern}` whose `prd.md` frontmatter `status` is not `final`); if any exist, offer to resume rather than starting over.
23
- 6. Run `{workflow.activation_steps_append}`.
23
+
24
+ Run `{workflow.activation_steps_append}`.
25
+
26
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
24
27
 
25
28
  ## Intent Modes
26
29
 
@@ -35,7 +35,10 @@ UX may lead, follow, or stand alone. Inherit `sources:` by reference; the spines
35
35
  3. Load `{project-root}/_bmad/bmm/config.yaml` (+ `config.user.yaml` if present). Resolve `{user_name}`, `{communication_language}`, `{document_output_language}`, `{planning_artifacts}`, `{project_name}`, `{date}`. Missing keys → neutral defaults; never block.
36
36
  4. If headless, follow `references/headless.md` for the whole run. Otherwise greet the user **by name** using `{user_name}` and **in their language** using `{communication_language}` — and stay in `{communication_language}` for every turn. In the greeting, let the user know `bmad-party-mode` and `bmad-advanced-elicitation` are always available. Then scan for misroute on the first message: PRD → `bmad-prd`; architecture → `bmad-create-architecture`; game UX → BMad GDS; agent/skill → `bmad-workflow-builder`; brief → `bmad-product-brief`.
37
37
  5. Detect intent: **Create**, **Update**, **Validate**. For Create, before binding a fresh workspace, scan `{workflow.ux_output_path}` for prior in-progress runs (folders matching `{workflow.run_folder_pattern}` whose `DESIGN.md` frontmatter `status` is not `final`) and offer to resume rather than starting over.
38
- 6. Run `{workflow.activation_steps_append}`.
38
+
39
+ Run `{workflow.activation_steps_append}`.
40
+
41
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
39
42
 
40
43
  ## Modes
41
44
 
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Winston, let's architect this"), skip the menu and dispatch that item directly after greeting.
@@ -84,7 +84,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
84
84
 
85
85
  Execute each entry in `{workflow.activation_steps_append}` in order.
86
86
 
87
- Activation is complete. Begin the workflow below.
87
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
88
88
 
89
89
  ## Execution
90
90
 
@@ -65,7 +65,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
65
65
 
66
66
  Execute each entry in `{workflow.activation_steps_append}` in order.
67
67
 
68
- Activation is complete. Begin the workflow below.
68
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
69
69
 
70
70
  ## Execution
71
71
 
@@ -86,7 +86,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
86
86
 
87
87
  Execute each entry in `{workflow.activation_steps_append}` in order.
88
88
 
89
- Activation is complete. Begin the workflow below.
89
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
90
90
 
91
91
  ## Execution
92
92
 
@@ -65,7 +65,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
65
65
 
66
66
  Execute each entry in `{workflow.activation_steps_append}` in order.
67
67
 
68
- Activation is complete. Begin the workflow below.
68
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
69
69
 
70
70
  ## Paths
71
71
 
@@ -63,6 +63,8 @@ Continue to prefix your messages with `{agent.icon}` throughout the session so t
63
63
 
64
64
  Execute each entry in `{agent.activation_steps_append}` in order.
65
65
 
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
+
66
68
  ### Step 8: Dispatch or Present the Menu
67
69
 
68
70
  If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Amelia, let's implement the next story"), skip the menu and dispatch that item directly after greeting.
@@ -55,7 +55,7 @@ Greet the user, speaking in `{communication_language}`.
55
55
 
56
56
  Execute each entry in `{workflow.activation_steps_append}` in order.
57
57
 
58
- Activation is complete. Begin the workflow below.
58
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
59
59
 
60
60
  ## Global Step Rules (apply to every step)
61
61
 
@@ -58,7 +58,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
58
58
 
59
59
  Execute each entry in `{workflow.activation_steps_append}` in order.
60
60
 
61
- Activation is complete. Begin the workflow below.
61
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
62
62
 
63
63
  ## WORKFLOW ARCHITECTURE
64
64
 
@@ -62,7 +62,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
62
62
 
63
63
  Execute each entry in `{workflow.activation_steps_append}` in order.
64
64
 
65
- Activation is complete. Begin the workflow below.
65
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
66
66
 
67
67
  ## Paths
68
68
 
@@ -63,7 +63,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
63
63
 
64
64
  Execute each entry in `{workflow.activation_steps_append}` in order.
65
65
 
66
- Activation is complete. Begin the workflow below.
66
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
67
 
68
68
  ## Paths
69
69
 
@@ -10,7 +10,7 @@ description: 'Execute story implementation following a context filled story spec
10
10
  **Your Role:** Developer implementing the story.
11
11
  - Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}
12
12
  - Generate all documents in {document_output_language}
13
- - Only modify the story file in these areas: Tasks/Subtasks checkboxes, Dev Agent Record (Debug Log, Completion Notes), File List, Change Log, and Status
13
+ - Only modify the story file in these areas: YAML frontmatter `baseline_commit`, Tasks/Subtasks checkboxes, Dev Agent Record (Debug Log, Completion Notes), File List, Change Log, and Status
14
14
  - Execute ALL steps in exact order; do NOT skip steps
15
15
  - Absolutely DO NOT stop because of "milestones", "significant progress", or "session boundaries". Continue in a single execution until the story is COMPLETE (all ACs satisfied and all tasks/subtasks checked) UNLESS a HALT condition is triggered or the USER gives other instruction.
16
16
  - Do NOT schedule a "next session" or request review pauses unless a HALT condition applies. Only Step 9 decides completion.
@@ -54,6 +54,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
54
54
  - `user_skill_level`
55
55
  - `implementation_artifacts`
56
56
  - `date` as system-generated current datetime
57
+ - `project_context` = `**/project-context.md` (load if exists)
57
58
 
58
59
  ### Step 5: Greet the User
59
60
 
@@ -63,7 +64,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
63
64
 
64
65
  Execute each entry in `{workflow.activation_steps_append}` in order.
65
66
 
66
- Activation is complete. Begin the workflow below.
67
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
67
68
 
68
69
  ## Paths
69
70
 
@@ -75,7 +76,7 @@ Activation is complete. Begin the workflow below.
75
76
  <workflow>
76
77
  <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
77
78
  <critical>Generate all documents in {document_output_language}</critical>
78
- <critical>Only modify the story file in these areas: Tasks/Subtasks checkboxes, Dev Agent Record (Debug Log, Completion Notes), File List,
79
+ <critical>Only modify the story file in these areas: YAML frontmatter `baseline_commit`, Tasks/Subtasks checkboxes, Dev Agent Record (Debug Log, Completion Notes), File List,
79
80
  Change Log, and Status</critical>
80
81
  <critical>Execute ALL steps in exact order; do NOT skip steps</critical>
81
82
  <critical>Absolutely DO NOT stop because of "milestones", "significant progress", or "session boundaries". Continue in a single execution
@@ -260,26 +261,40 @@ Activation is complete. Begin the workflow below.
260
261
  </step>
261
262
 
262
263
  <step n="4" goal="Mark story in-progress" tag="sprint-status">
264
+ <action>If story file YAML frontmatter already contains `baseline_commit`, preserve the existing value and do not overwrite it</action>
265
+
263
266
  <check if="{{sprint_status}} file exists">
264
267
  <action>Load the FULL file: {{sprint_status}}</action>
265
268
  <action>Read all development_status entries to find {{story_key}}</action>
266
- <action>Get current status value for development_status[{{story_key}}]</action>
269
+ <action>Set {{current_status}} to development_status[{{story_key}}]</action>
270
+ </check>
271
+
272
+ <check if="{{sprint_status}} file does NOT exist">
273
+ <action>Set {{current_status}} to the story file Status section value</action>
274
+ </check>
275
+
276
+ <check if="{{current_status}} == 'ready-for-dev' AND story file YAML frontmatter does NOT contain baseline_commit">
277
+ <action>Run `git rev-parse HEAD` to capture current commit into {{baseline_commit}}; if git/version control is unavailable, set {{baseline_commit}} = `NO_VCS`</action>
278
+ <action>If story file YAML frontmatter exists, add `baseline_commit: {{baseline_commit}}` to the frontmatter</action>
279
+ <action>If story file has no YAML frontmatter, create frontmatter at the top containing only `baseline_commit: {{baseline_commit}}`</action>
280
+ </check>
267
281
 
268
- <check if="current status == 'ready-for-dev' OR review_continuation == true">
282
+ <check if="{{sprint_status}} file exists">
283
+ <check if="{{current_status}} == 'ready-for-dev' OR (review_continuation == true AND {{current_status}} != 'in-progress')">
269
284
  <action>Update the story in the sprint status report to = "in-progress"</action>
270
285
  <action>Update last_updated field to current date</action>
271
286
  <output>🚀 Starting work on story {{story_key}}
272
- Status updated: ready-for-dev → in-progress
287
+ Status updated: {{current_status}} → in-progress
273
288
  </output>
274
289
  </check>
275
290
 
276
- <check if="current status == 'in-progress'">
291
+ <check if="{{current_status}} == 'in-progress'">
277
292
  <output>⏯️ Resuming work on story {{story_key}}
278
293
  Story is already marked in-progress
279
294
  </output>
280
295
  </check>
281
296
 
282
- <check if="current status is neither ready-for-dev nor in-progress">
297
+ <check if="{{current_status}} is neither ready-for-dev nor in-progress">
283
298
  <output>⚠️ Unexpected story status: {{current_status}}
284
299
  Expected ready-for-dev or in-progress. Continuing anyway...
285
300
  </output>
@@ -79,6 +79,8 @@ Greet `{user_name}` in `{communication_language}`.
79
79
 
80
80
  Run each entry in `{workflow.activation_steps_append}` in order.
81
81
 
82
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
83
+
82
84
  ### Step 7: Acknowledge and route
83
85
 
84
86
  Acknowledge the input as a reference (record paths and IDs; don't read raw content). Path to an existing case file →
@@ -56,7 +56,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
56
56
 
57
57
  Execute each entry in `{workflow.activation_steps_append}` in order.
58
58
 
59
- Activation is complete. Begin the workflow below.
59
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
60
60
 
61
61
  ## Paths
62
62
 
@@ -79,7 +79,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
79
79
 
80
80
  Execute each entry in `{workflow.activation_steps_append}` in order.
81
81
 
82
- Activation is complete. Begin the workflow below.
82
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
83
83
 
84
84
  ## WORKFLOW ARCHITECTURE
85
85
 
@@ -73,7 +73,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
73
73
 
74
74
  Execute each entry in `{workflow.activation_steps_append}` in order.
75
75
 
76
- Activation is complete. Begin the workflow below.
76
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
77
77
 
78
78
  ## Paths
79
79
 
@@ -47,6 +47,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
47
47
  - `implementation_artifacts`
48
48
  - `planning_artifacts`
49
49
  - `date` as system-generated current datetime
50
+ - `project_context` = `**/project-context.md` (load if exists)
50
51
  - YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
51
52
  - Generate all documents in `{document_output_language}`
52
53
 
@@ -58,7 +59,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
58
59
 
59
60
  Execute each entry in `{workflow.activation_steps_append}` in order.
60
61
 
61
- Activation is complete. Begin the workflow below.
62
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
62
63
 
63
64
  ## Paths
64
65
 
@@ -46,6 +46,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
46
46
  - `communication_language`, `document_output_language`
47
47
  - `implementation_artifacts`
48
48
  - `date` as system-generated current datetime
49
+ - `project_context` = `**/project-context.md` (load if exists)
49
50
  - YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
50
51
 
51
52
  ### Step 5: Greet the User
@@ -56,7 +57,7 @@ Greet `{user_name}`, speaking in `{communication_language}`.
56
57
 
57
58
  Execute each entry in `{workflow.activation_steps_append}` in order.
58
59
 
59
- Activation is complete. Begin the workflow below.
60
+ Activation is complete. If `activation_steps_prepend` or `activation_steps_append` were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.
60
61
 
61
62
  ## Paths
62
63
 
@@ -7,7 +7,7 @@
7
7
  ## MANDATORY EXECUTION RULES (READ FIRST):
8
8
 
9
9
  - ✅ YOU ARE A CREATIVE FACILITATOR, engaging in genuine back-and-forth coaching
10
- - 🎯 AIM FOR 100+ IDEAS before suggesting organization - quantity unlocks quality (quality must grow as we progress)
10
+ - 🎯 AIM FOR 100+ COLLABORATIVE IDEAS before suggesting organization - quantity unlocks quality, but do not batch-generate ideas to satisfy the count
11
11
  - 🔄 DEFAULT IS TO KEEP EXPLORING - only move to organization when user explicitly requests it
12
12
  - 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?"
13
13
  - 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact).
@@ -29,6 +29,7 @@ _Novelty_: [What makes this different from obvious solutions]
29
29
  ## EXECUTION PROTOCOLS:
30
30
 
31
31
  - 🎯 Present one technique element at a time for deep exploration
32
+ - 🛑 Present at most one new idea, provocation, or angle before asking for user input
32
33
  - ⚠️ Ask "Continue with current technique?" before moving to next technique
33
34
  - 💾 Document insights and ideas using the **IDEA FORMAT TEMPLATE**
34
35
  - 📖 Follow user's creative energy and interests within technique structure
@@ -171,7 +172,7 @@ Before moving to next technique element:
171
172
  - **Switch techniques** for a fresh perspective?
172
173
  - Or are you feeling like we've **thoroughly explored** this space?
173
174
 
174
- Remember: The goal is quantity first - we can organize later. What feels right?"
175
+ Remember: The goal is quantity through collaboration, not a generated list. What feels right?"
175
176
 
176
177
  **IMPORTANT:** Default to continuing exploration. Only suggest organization if:
177
178
 
@@ -292,7 +293,7 @@ After final technique element:
292
293
 
293
294
  **HALT — wait for user selection before proceeding.**
294
295
 
295
- **Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted.
296
+ **Default recommendation:** Unless you feel we've developed enough ideas together, I suggest we keep exploring. The best insights often come after the obvious ideas are exhausted.
296
297
 
297
298
  ### 8. Handle Menu Selection
298
299
 
@@ -362,7 +363,7 @@ When user selects 'C', append the content directly to `{brainstorming_session_ou
362
363
 
363
364
  ## SUCCESS METRICS:
364
365
 
365
- Minimum 100 ideas generated before organization is offered
366
+ Substantial collaborative idea volume before organization is offered
366
367
  ✅ User explicitly confirms readiness to conclude (not AI-initiated)
367
368
  ✅ Multiple technique exploration encouraged over single-technique completion
368
369
  ✅ True back-and-forth facilitation rather than question-answer format
@@ -376,6 +377,7 @@ When user selects 'C', append the content directly to `{brainstorming_session_ou
376
377
  ## FAILURE MODES:
377
378
 
378
379
  ❌ Offering organization after only one technique or <20 ideas
380
+ ❌ Batch-generating idea lists instead of facilitating dialogue
379
381
  ❌ AI initiating conclusion without user explicitly requesting it
380
382
  ❌ Treating technique completion as session completion signal
381
383
  ❌ Rushing to document rather than staying in generative mode
@@ -12,7 +12,7 @@ context_file: '' # Optional context file path for project-specific guidance
12
12
 
13
13
  **Anti-Bias Protocol:** LLMs naturally drift toward semantic clustering (sequential bias). To combat this, you MUST consciously shift your creative domain every 10 ideas. If you've been focusing on technical aspects, pivot to user experience, then to business viability, then to edge cases or "black swan" events. Force yourself into orthogonal categories to maintain true divergence.
14
14
 
15
- **Quantity Goal:** Aim for 100+ ideas before any organization. The first 20 ideas are usually obvious - the magic happens in ideas 50-100.
15
+ **Quantity Goal:** Aim for 100+ collaboratively developed ideas before any organization. This is a session goal, not a request to generate a large list. Ideas count only when they emerge through dialogue with the user or are accepted and developed by the user.
16
16
 
17
17
  ---
18
18