From da4426237ef51dde9054249ec3e68bc2ddc8f9f6 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sat, 14 Mar 2026 20:11:09 -0600 Subject: [PATCH] fix: resolve skill validation findings in market-research - Add co-located HALT instructions after every menu in all 6 step files - Fix step-05 to route to step-06 instead of declaring workflow complete - Rename market-steps/ to steps/ for standard naming convention Co-Authored-By: Claude Opus 4.6 (1M context) --- .../{market-steps => steps}/step-01-init.md | 2 ++ .../step-02-customer-behavior.md | 2 ++ .../step-03-customer-pain-points.md | 2 ++ .../step-04-customer-decisions.md | 2 ++ .../step-05-competitive-analysis.md | 18 +++++++----------- .../step-06-research-completion.md | 2 ++ .../research/bmad-market-research/workflow.md | 2 +- 7 files changed, 18 insertions(+), 12 deletions(-) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-01-init.md (99%) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-02-customer-behavior.md (99%) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-03-customer-pain-points.md (99%) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-04-customer-decisions.md (99%) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-05-competitive-analysis.md (91%) rename src/bmm/workflows/1-analysis/research/bmad-market-research/{market-steps => steps}/step-06-research-completion.md (99%) diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-01-init.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-01-init.md similarity index 99% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-01-init.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-01-init.md index ae9a3ba82..4cf627634 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-01-init.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-01-init.md @@ -132,6 +132,8 @@ Show initial scope document and present continue option: [C] Continue - Confirm scope and proceed to customer insights analysis [Modify] Suggest changes to research scope before proceeding +**HALT — wait for user response before proceeding.** + ### 5. Handle User Response #### If 'C' (Continue): diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-02-customer-behavior.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-02-customer-behavior.md similarity index 99% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-02-customer-behavior.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-02-customer-behavior.md index f707a0a3e..810e22de8 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-02-customer-behavior.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-02-customer-behavior.md @@ -173,6 +173,8 @@ _Source: [URL]_ **Ready to proceed to customer pain points?** [C] Continue - Save this to document and proceed to pain points analysis +**HALT — wait for user response before proceeding.** + ### 6. Handle Continue Selection #### If 'C' (Continue): diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-03-customer-pain-points.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-03-customer-pain-points.md similarity index 99% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-03-customer-pain-points.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-03-customer-pain-points.md index f4d2ae6d8..280730c30 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-03-customer-pain-points.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-03-customer-pain-points.md @@ -184,6 +184,8 @@ _Source: [URL]_ **Ready to proceed to customer decision processes?** [C] Continue - Save this to document and proceed to decision processes analysis +**HALT — wait for user response before proceeding.** + ### 6. Handle Continue Selection #### If 'C' (Continue): diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-04-customer-decisions.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-04-customer-decisions.md similarity index 99% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-04-customer-decisions.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-04-customer-decisions.md index 21544335b..4f0e5504a 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-04-customer-decisions.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-04-customer-decisions.md @@ -194,6 +194,8 @@ _Source: [URL]_ **Ready to proceed to competitive analysis?** [C] Continue - Save this to document and proceed to competitive analysis +**HALT — wait for user response before proceeding.** + ### 6. Handle Continue Selection #### If 'C' (Continue): diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-05-competitive-analysis.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-05-competitive-analysis.md similarity index 91% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-05-competitive-analysis.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-05-competitive-analysis.md index d7387a4fc..868b12421 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-05-competitive-analysis.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-05-competitive-analysis.md @@ -109,15 +109,17 @@ Show the generated competitive analysis and present complete option: - Competitive threats and challenges documented **Ready to complete the market research?** -[C] Complete Research - Save final document and conclude +[C] Complete Research - Save competitive analysis and proceed to research completion + +**HALT — wait for user response before proceeding.** ### 4. Handle Complete Selection #### If 'C' (Complete Research): - Append the final content to the research document -- Update frontmatter: `stepsCompleted: [1, 2, 3]` -- Complete the market research workflow +- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]` +- Load: `./step-06-research-completion.md` ## APPEND TO DOCUMENT: @@ -166,12 +168,6 @@ When 'C' is selected: - Market research workflow status updated - Final recommendations provided to user -## NEXT STEPS: +## NEXT STEP: -Market research workflow complete. User may: - -- Use market research to inform product development strategies -- Conduct additional competitive research on specific companies -- Combine market research with other research types for comprehensive insights - -Congratulations on completing comprehensive market research! 🎉 +After user selects 'C', load `./step-06-research-completion.md` to produce the final comprehensive market research document with strategic synthesis, executive summary, and complete document structure. diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-06-research-completion.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-06-research-completion.md similarity index 99% rename from src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-06-research-completion.md rename to src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-06-research-completion.md index 0073b554e..59ca4ae89 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/market-steps/step-06-research-completion.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-06-research-completion.md @@ -385,6 +385,8 @@ _This comprehensive market research document serves as an authoritative market r **Ready to complete this comprehensive market research document?** [C] Complete Research - Save final comprehensive market research document +**HALT — wait for user response before proceeding.** + ### 6. Handle Complete Selection #### If 'C' (Complete Research): diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md index 1809266b2..23822ca3b 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md @@ -42,7 +42,7 @@ After gathering the topic and goals: 2. Set `research_topic = [discovered topic from discussion]` 3. Set `research_goals = [discovered goals from discussion]` 4. Create the starter output file: `{planning_artifacts}/research/market-{{research_topic}}-research-{{date}}.md` with exact copy of the `./research.template.md` contents -5. Load: `./market-steps/step-01-init.md` with topic context +5. Load: `./steps/step-01-init.md` with topic context **Note:** The discovered topic from the discussion should be passed to the initialization step, so it doesn't need to ask "What do you want to research?" again - it can focus on refining the scope for market research.