diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md index 49618093..6ae19619 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md @@ -117,7 +117,8 @@ Try to discover the following: #### C. Present Initialization Results **Setup Report to User:** -"Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}. + +Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}. **Document Setup:** @@ -133,11 +134,14 @@ Try to discover the following: **Files loaded:** {list of specific file names or "No additional documents found"} -Do you have any other documents you'd like me to include, or shall we continue to the next step?" +Do you have any other documents you'd like me to include, or shall we continue to the next step? + ### 4. Present MENU OPTIONS -Display: "**Proceeding to product vision discovery...**" + +**Proceeding to product vision discovery...** + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md index 99b2495f..bfb6984e 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md @@ -75,7 +75,8 @@ Review the frontmatter to understand: ### 3. Present Current Progress **Progress Report to User:** -"Welcome back {{user_name}}! I'm resuming our product brief collaboration for {{project_name}}. + +Welcome back {{user_name}}! I'm resuming our product brief collaboration for {{project_name}}. **Current Progress:** @@ -88,7 +89,8 @@ Review the frontmatter to understand: - Current product brief is ready with all completed sections - Ready to continue from where we left off -Does this look right, or do you want to make any adjustments before we proceed?" +Does this look right, or do you want to make any adjustments before we proceed? + ### 4. Determine Continuation Path @@ -104,7 +106,8 @@ Based on `lastStep` value, determine which step to load next: ### 5. Handle Workflow Completion **If workflow already complete (`lastStep = 6`):** -"Great news! It looks like we've already completed the product brief workflow for {{project_name}}. + +Great news! It looks like we've already completed the product brief workflow for {{project_name}}. The final document is ready at `{outputFile}` with all sections completed through step 6. @@ -114,14 +117,17 @@ Would you like me to: - Suggest next workflow steps (like PRD creation) - Start a new product brief revision -What would be most helpful?" +What would be most helpful? + ### 6. Present MENU OPTIONS **If workflow not complete:** -Display: "Ready to continue with Step {nextStepNumber}: {nextStepTitle}? + +Ready to continue with Step {nextStepNumber}: {nextStepTitle}? -**Select an Option:** [C] Continue to Step {nextStepNumber}" +**Select an Option:** [C] Continue to Step {nextStepNumber} + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md index f00e18fa..38f4dd38 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md @@ -61,7 +61,8 @@ Conduct comprehensive product vision discovery to define the core problem, solut ### 1. Begin Vision Discovery **Opening Conversation:** -"As your PM peer, I'm excited to help you shape the vision for {{project_name}}. Let's start with the foundation. + +As your PM peer, I'm excited to help you shape the vision for {{project_name}}. Let's start with the foundation. **Tell me about the product you envision:** @@ -70,7 +71,8 @@ Conduct comprehensive product vision discovery to define the core problem, solut - What would success look like for the people you're helping? - What excites you most about this solution? -Let's start with the problem space before we get into solutions." +Let's start with the problem space before we get into solutions. + ### 2. Deep Problem Understanding @@ -147,12 +149,17 @@ Prepare the following structure for document append: ### 7. Present MENU OPTIONS **Content Presentation:** -"I've drafted the executive summary and core vision based on our conversation. This captures the essence of {{project_name}} and what makes it special. + +I've drafted the executive summary and core vision based on our conversation. This captures the essence of {{project_name}} and what makes it special. **Here's what I'll add to the document:** + + [Show the complete markdown content from step 6] -**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md index cba26641..cff8b88f 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md @@ -61,7 +61,8 @@ Define target users with rich personas and map their key interactions with the p ### 1. Begin User Discovery **Opening Exploration:** -"Now that we understand what {{project_name}} does, let's define who it's for. + +Now that we understand what {{project_name}} does, let's define who it's for. **User Discovery:** @@ -70,7 +71,8 @@ Define target users with rich personas and map their key interactions with the p - Who gets the most value from this solution? - Are there primary users and secondary users we should consider? -Let's start by identifying the main user groups." +Let's start by identifying the main user groups. + ### 2. Primary User Segment Development @@ -150,12 +152,17 @@ Prepare the following structure for document append: ### 6. Present MENU OPTIONS **Content Presentation:** -"I've mapped out who {{project_name}} serves and how they'll interact with it. This helps us ensure we're building something that real people will love to use. + +I've mapped out who {{project_name}} serves and how they'll interact with it. This helps us ensure we're building something that real people will love to use. **Here's what I'll add to the document:** + + [Show the complete markdown content from step 5] -**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md index e6b297c3..9be0a58a 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md @@ -61,7 +61,8 @@ Define comprehensive success metrics that include user success, business objecti ### 1. Begin Success Metrics Discovery **Opening Exploration:** -"Now that we know who {{project_name}} serves and what problem it solves, let's define what success looks like. + +Now that we know who {{project_name}} serves and what problem it solves, let's define what success looks like. **Success Discovery:** @@ -69,7 +70,8 @@ Define comprehensive success metrics that include user success, business objecti - What would make users say 'this was worth it'? - What metrics show we're creating real value? -Let's start with the user perspective." +Let's start with the user perspective. + ### 2. User Success Metrics @@ -153,12 +155,17 @@ Prepare the following structure for document append: ### 7. Present MENU OPTIONS **Content Presentation:** -"I've defined success metrics that will help us track whether {{project_name}} is creating real value for users and achieving business objectives. + +I've defined success metrics that will help us track whether {{project_name}} is creating real value for users and achieving business objectives. **Here's what I'll add to the document:** + + [Show the complete markdown content from step 6] -**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md index 0914b835..1c3afd51 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md @@ -61,7 +61,8 @@ Define MVP scope with clear boundaries and outline future vision through collabo ### 1. Begin Scope Definition **Opening Exploration:** -"Now that we understand what {{project_name}} does, who it serves, and how we'll measure success, let's define what we need to build first. + +Now that we understand what {{project_name}} does, who it serves, and how we'll measure success, let's define what we need to build first. **Scope Discovery:** @@ -69,7 +70,8 @@ Define MVP scope with clear boundaries and outline future vision through collabo - What features would make users say 'this solves my problem'? - How do we balance ambition with getting something valuable to users quickly? -Let's start with the MVP mindset: what's the smallest version that creates real value?" +Let's start with the MVP mindset: what's the smallest version that creates real value? + ### 2. MVP Core Features Definition @@ -167,12 +169,17 @@ Prepare the following structure for document append: ### 7. Present MENU OPTIONS **Content Presentation:** -"I've defined the MVP scope for {{project_name}} that balances delivering real value with realistic boundaries. This gives us a clear path forward while keeping our options open for future growth. + +I've defined the MVP scope for {{project_name}} that balances delivering real value with realistic boundaries. This gives us a clear path forward while keeping our options open for future growth. **Here's what I'll add to the document:** + + [Show the complete markdown content from step 6] -**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md index 91c1ba66..160390cb 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md @@ -56,7 +56,8 @@ Complete the product brief workflow, update status files, and provide guidance o ### 1. Announce Workflow Completion **Completion Announcement:** -"🎉 **Product Brief Complete, {{user_name}}!** + +🎉 **Product Brief Complete, {{user_name}}!** I've successfully collaborated with you to create a comprehensive Product Brief for {{project_name}}. @@ -71,7 +72,8 @@ I've successfully collaborated with you to create a comprehensive Product Brief **The complete Product Brief is now available at:** `{outputFile}` -This brief serves as the foundation for all subsequent product development activities and strategic decisions." +This brief serves as the foundation for all subsequent product development activities and strategic decisions. + ### 2. Document Quality Check @@ -116,7 +118,9 @@ Provide guidance on logical next workflows: ### 4. Congrats to the user -"**Your Product Brief for {{project_name}} is now complete and ready for the next phase!**" + +**Your Product Brief for {{project_name}} is now complete and ready for the next phase!** + Recap that the brief captures everything needed to guide subsequent product development: diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md index 27d056b1..8575ac22 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md @@ -37,7 +37,9 @@ Confirm domain research scope and approach for **{{research_topic}}** with the u ### 1. Begin Scope Confirmation Start with domain scope understanding: -"I understand you want to conduct **domain research** for **{{research_topic}}** with these goals: {{research_goals}} + + +I understand you want to conduct **domain research** for **{{research_topic}}** with these goals: {{research_goals}} **Domain Research Scope:** @@ -53,11 +55,14 @@ Start with domain scope understanding: - Multi-source validation for critical domain claims - Confidence levels for uncertain domain information - Comprehensive domain coverage with industry-specific insights + ### 2. Scope Confirmation Present clear scope confirmation: -"**Domain Research Scope Confirmation:** + + +**Domain Research Scope Confirmation:** For **{{research_topic}}**, I will research: @@ -71,6 +76,7 @@ For **{{research_topic}}**, I will research: **Does this domain research scope and approach align with your goals?** [C] Continue - Begin domain research with this scope + ### 3. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md index bb4cbb63..0b8a7a06 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md @@ -41,7 +41,9 @@ Conduct industry analysis focusing on market size, growth, and industry dynamics **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different industry areas simultaneously and thoroughly. Start with industry research approach: -"Now I'll conduct **industry analysis** for **{{research_topic}}** to understand market dynamics. + + +Now I'll conduct **industry analysis** for **{{research_topic}}** to understand market dynamics. **Industry Analysis Focus:** @@ -51,7 +53,8 @@ Start with industry research approach: - Industry trends and evolution patterns - Economic impact and value creation -**Let me search for current industry insights.**" +**Let me search for current industry insights.** + ### 2. Parallel Industry Research Execution @@ -74,7 +77,8 @@ Search the web: "{{research_topic}} industry trends evolution" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate industry findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate industry findings: **Research Coverage:** @@ -87,7 +91,8 @@ Search the web: "{{research_topic}} industry trends evolution" [Identify patterns connecting market dynamics, segmentation, and trends] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Industry Analysis Content @@ -152,7 +157,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **industry analysis** for {{research_topic}}. + +I've completed **industry analysis** for {{research_topic}}. **Key Industry Findings:** @@ -164,6 +170,7 @@ _Source: [URL]_ **Ready to proceed to competitive landscape analysis?** [C] Continue - Save this to document and proceed to competitive landscape + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md index 0dc2de6e..961705be 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md @@ -41,7 +41,9 @@ Conduct competitive landscape analysis focusing on key players, market share, an **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different competitive areas simultaneously and thoroughly. Start with competitive research approach: -"Now I'll conduct **competitive landscape analysis** for **{{research_topic}}** to understand the competitive ecosystem. + + +Now I'll conduct **competitive landscape analysis** for **{{research_topic}}** to understand the competitive ecosystem. **Competitive Landscape Focus:** @@ -51,7 +53,8 @@ Start with competitive research approach: - Business models and value propositions - Entry barriers and competitive dynamics -**Let me search for current competitive insights.**" +**Let me search for current competitive insights.** + ### 2. Parallel Competitive Research Execution @@ -74,7 +77,8 @@ Search the web: "{{research_topic}} entry barriers competitive dynamics" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate competitive findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate competitive findings: **Research Coverage:** @@ -87,7 +91,8 @@ Search the web: "{{research_topic}} entry barriers competitive dynamics" [Identify patterns connecting players, strategies, and market dynamics] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Competitive Landscape Content @@ -161,7 +166,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **competitive landscape analysis** for {{research_topic}}. + +I've completed **competitive landscape analysis** for {{research_topic}}. **Key Competitive Findings:** @@ -173,6 +179,7 @@ _Source: [URL]_ **Ready to proceed to regulatory focus analysis?** [C] Continue - Save this to document and proceed to regulatory focus + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md index e98010c7..cbd61444 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md @@ -39,7 +39,9 @@ Conduct focused regulatory and compliance analysis with emphasis on requirements ### 1. Begin Regulatory Analysis Start with regulatory research approach: -"Now I'll focus on **regulatory and compliance requirements** that impact **{{research_topic}}**. + + +Now I'll focus on **regulatory and compliance requirements** that impact **{{research_topic}}**. **Regulatory Focus Areas:** @@ -49,7 +51,8 @@ Start with regulatory research approach: - Data protection and privacy regulations - Environmental and safety requirements -**Let me search for current regulatory requirements.**" +**Let me search for current regulatory requirements.** + ### 2. Web Search for Specific Regulations @@ -136,7 +139,9 @@ _Source: [URL]_ ### 6. Present Analysis and Continue Option Show the generated regulatory analysis and present continue option: -"I've completed **regulatory requirements analysis** for {{research_topic}}. + + +I've completed **regulatory requirements analysis** for {{research_topic}}. **Key Regulatory Findings:** @@ -148,6 +153,7 @@ Show the generated regulatory analysis and present continue option: **Ready to proceed to technical trends?** [C] Continue - Save this to the document and move to technical trends + ### 7. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md index 55e834cd..3146c500 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md @@ -39,7 +39,9 @@ Conduct comprehensive technical trends analysis using current web data with emph ### 1. Begin Technical Trends Analysis Start with technology research approach: -"Now I'll conduct **technical trends and emerging technologies** analysis for **{{research_topic}}** using current data. + + +Now I'll conduct **technical trends and emerging technologies** analysis for **{{research_topic}}** using current data. **Technical Trends Focus:** @@ -49,7 +51,8 @@ Start with technology research approach: - New business models enabled by technology - Future technology projections and roadmaps -**Let me search for current technology developments.**" +**Let me search for current technology developments.** + ### 2. Web Search for Emerging Technologies @@ -148,7 +151,9 @@ _Source: [URL]_ ### 6. Present Analysis and Complete Option Show the generated technical analysis and present complete option: -"I've completed **technical trends and innovation analysis** for {{research_topic}}. + + +I've completed **technical trends and innovation analysis** for {{research_topic}}. **Technical Highlights:** @@ -167,6 +172,7 @@ Show the generated technical analysis and present complete option: **Ready to proceed to research synthesis and recommendations?** [C] Continue - Save this to document and proceed to synthesis + ### 7. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md b/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md index 1c7db8c0..da6eefc8 100644 --- a/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +++ b/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md @@ -339,7 +339,8 @@ _This comprehensive research document serves as an authoritative reference on {{ **Document Completion Presentation:** -"I've completed the **comprehensive research document synthesis** for **{{research_topic}}**, producing an authoritative research document with: + +I've completed the **comprehensive research document synthesis** for **{{research_topic}}**, producing an authoritative research document with: **Document Features:** @@ -368,6 +369,7 @@ _This comprehensive research document serves as an authoritative reference on {{ **Ready to complete this comprehensive research document?** [C] Complete Research - Save final comprehensive document + ### 6. Handle Final Completion diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md b/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md index 5ab85939..1108f235 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md @@ -39,7 +39,9 @@ Initialize market research by confirming understanding of {{research_topic}} and **INITIALIZE - DO NOT RESEARCH YET** Start with research confirmation: -"I understand you want to conduct **market research** for **{{research_topic}}** with these goals: {{research_goals}} + + +I understand you want to conduct **market research** for **{{research_topic}}** with these goals: {{research_goals}} **My Understanding of Your Research Needs:** @@ -55,7 +57,8 @@ Start with research confirmation: - Competitive landscape and positioning - Strategic recommendations and implementation guidance -**Does this accurately capture what you're looking for?**" +**Does this accurately capture what you're looking for?** + ### 2. Refine Research Scope @@ -117,7 +120,9 @@ Write initial research scope to document: ### 4. Present Confirmation and Continue Option Show initial scope document and present continue option: -"I've documented our understanding and initial scope for **{{research_topic}}** market research. + + +I've documented our understanding and initial scope for **{{research_topic}}** market research. **What I've established:** @@ -131,6 +136,7 @@ Show initial scope document and present continue option: **Ready to begin detailed market research?** [C] Continue - Confirm scope and proceed to customer insights analysis [Modify] Suggest changes to research scope before proceeding + ### 5. Handle User Response diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md b/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md index f707a0a3..dfceb493 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md @@ -41,7 +41,9 @@ Conduct customer behavior and segment analysis with emphasis on patterns and dem **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer behavior areas simultaneously and thoroughly. Start with customer behavior research approach: -"Now I'll conduct **customer behavior analysis** for **{{research_topic}}** to understand customer patterns. + + +Now I'll conduct **customer behavior analysis** for **{{research_topic}}** to understand customer patterns. **Customer Behavior Focus:** @@ -51,7 +53,8 @@ Start with customer behavior research approach: - Behavior drivers and influences - Customer interaction patterns and engagement -**Let me search for current customer behavior insights.**" +**Let me search for current customer behavior insights.** + ### 2. Parallel Customer Behavior Research Execution @@ -74,7 +77,8 @@ Search the web: "{{research_topic}} customer behavior drivers" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate customer behavior findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate customer behavior findings: **Research Coverage:** @@ -88,7 +92,8 @@ Search the web: "{{research_topic}} customer behavior drivers" [Identify patterns connecting demographics, psychographics, and behaviors] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Customer Behavior Content @@ -160,7 +165,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **customer behavior analysis** for {{research_topic}}, focusing on customer patterns. + +I've completed **customer behavior analysis** for {{research_topic}}, focusing on customer patterns. **Key Customer Behavior Findings:** @@ -172,6 +178,7 @@ _Source: [URL]_ **Ready to proceed to customer pain points?** [C] Continue - Save this to document and proceed to pain points analysis + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md b/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md index f4d2ae6d..b130fa1a 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md @@ -42,7 +42,9 @@ Conduct customer pain points and needs analysis with emphasis on challenges and **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer pain point areas simultaneously and thoroughly. Start with customer pain points research approach: -"Now I'll conduct **customer pain points analysis** for **{{research_topic}}** to understand customer challenges. + + +Now I'll conduct **customer pain points analysis** for **{{research_topic}}** to understand customer challenges. **Customer Pain Points Focus:** @@ -52,7 +54,8 @@ Start with customer pain points research approach: - Service and support pain points - Customer satisfaction gaps -**Let me search for current customer pain points insights.**" +**Let me search for current customer pain points insights.** + ### 2. Parallel Pain Points Research Execution @@ -75,7 +78,8 @@ Search the web: "{{research_topic}} customer barriers to adoption" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate customer pain points findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate customer pain points findings: **Research Coverage:** @@ -88,7 +92,8 @@ Search the web: "{{research_topic}} customer barriers to adoption" [Identify patterns connecting different types of pain points] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Customer Pain Points Content @@ -171,7 +176,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **customer pain points analysis** for {{research_topic}}, focusing on customer challenges. + +I've completed **customer pain points analysis** for {{research_topic}}, focusing on customer challenges. **Key Pain Points Findings:** @@ -183,6 +189,7 @@ _Source: [URL]_ **Ready to proceed to customer decision processes?** [C] Continue - Save this to document and proceed to decision processes analysis + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md b/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md index 21544335..09819c1c 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md @@ -42,7 +42,9 @@ Conduct customer decision processes and journey analysis with emphasis on decisi **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer decision areas simultaneously and thoroughly. Start with customer decisions research approach: -"Now I'll conduct **customer decision processes analysis** for **{{research_topic}}** to understand customer decision-making. + + +Now I'll conduct **customer decision processes analysis** for **{{research_topic}}** to understand customer decision-making. **Customer Decisions Focus:** @@ -52,7 +54,8 @@ Start with customer decisions research approach: - Purchase decision influencers - Information gathering patterns -**Let me search for current customer decision insights.**" +**Let me search for current customer decision insights.** + ### 2. Parallel Decisions Research Execution @@ -75,7 +78,8 @@ Search the web: "{{research_topic}} decision influencing factors" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate customer decision findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate customer decision findings: **Research Coverage:** @@ -88,7 +92,8 @@ Search the web: "{{research_topic}} decision influencing factors" [Identify patterns connecting decision factors and journey stages] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Customer Decisions Content @@ -181,7 +186,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **customer decision processes analysis** for {{research_topic}}, focusing on customer decision-making. + +I've completed **customer decision processes analysis** for {{research_topic}}, focusing on customer decision-making. **Key Decision Findings:** @@ -193,6 +199,7 @@ _Source: [URL]_ **Ready to proceed to competitive analysis?** [C] Continue - Save this to document and proceed to competitive analysis + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md b/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md index d7387a4f..13e42a2c 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md @@ -36,7 +36,9 @@ Conduct comprehensive competitive analysis with emphasis on market positioning. ### 1. Begin Competitive Analysis Start with competitive research approach: -"Now I'll conduct **competitive analysis** to understand the competitive landscape. + + +Now I'll conduct **competitive analysis** to understand the competitive landscape. **Competitive Analysis Focus:** @@ -46,7 +48,8 @@ Start with competitive research approach: - Market differentiation opportunities - Competitive threats and challenges -**Let me search for current competitive information.**" +**Let me search for current competitive information.** + ### 2. Generate Competitive Analysis Content @@ -98,7 +101,9 @@ _Source: [URL]_ ### 3. Present Analysis and Complete Option Show the generated competitive analysis and present complete option: -"I've completed the **competitive analysis** for the competitive landscape. + + +I've completed the **competitive analysis** for the competitive landscape. **Key Competitive Findings:** @@ -110,6 +115,7 @@ Show the generated competitive analysis and present complete option: **Ready to complete the market research?** [C] Complete Research - Save final document and conclude + ### 4. Handle Complete Selection diff --git a/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md b/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md index 42d7d7d9..7bd3d8a5 100644 --- a/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +++ b/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md @@ -39,7 +39,9 @@ Produce a comprehensive, authoritative market research document on **{{research_ ### 1. Begin Strategic Synthesis Start with strategic synthesis approach: -"Now I'll complete our market research with **strategic synthesis and recommendations** . + + +Now I'll complete our market research with **strategic synthesis and recommendations** . **Strategic Synthesis Focus:** @@ -49,7 +51,8 @@ Start with strategic synthesis approach: - Risk assessment and mitigation approaches - Actionable next steps and implementation guidance -**Let me search for current strategic insights and best practices.**" +**Let me search for current strategic insights and best practices.** + ### 2. Web Search for Market Entry Strategies @@ -356,7 +359,8 @@ _This comprehensive market research document serves as an authoritative market r **Market Research Document Completion Presentation:** -"I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with: + +I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with: **Document Features:** @@ -384,6 +388,7 @@ _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 + ### 6. Handle Complete Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md index b286822d..93d8beb1 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md @@ -37,7 +37,9 @@ Confirm technical research scope and approach for **{{research_topic}}** with th ### 1. Begin Scope Confirmation Start with technical scope understanding: -"I understand you want to conduct **technical research** for **{{research_topic}}** with these goals: {{research_goals}} + + +I understand you want to conduct **technical research** for **{{research_topic}}** with these goals: {{research_goals}} **Technical Research Scope:** @@ -53,11 +55,14 @@ Start with technical scope understanding: - Multi-source validation for critical technical claims - Confidence levels for uncertain technical information - Comprehensive technical coverage with architecture-specific insights + ### 2. Scope Confirmation Present clear scope confirmation: -"**Technical Research Scope Confirmation:** + + +**Technical Research Scope Confirmation:** For **{{research_topic}}**, I will research: @@ -71,6 +76,7 @@ For **{{research_topic}}**, I will research: **Does this technical research scope and approach align with your goals?** [C] Continue - Begin technical research with this scope + ### 3. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md index 78151eb0..7d39feb6 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md @@ -41,7 +41,9 @@ Conduct technology stack analysis focusing on languages, frameworks, tools, and **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different technology stack areas simultaneously and thoroughly. Start with technology stack research approach: -"Now I'll conduct **technology stack analysis** for **{{research_topic}}** to understand the technology landscape. + + +Now I'll conduct **technology stack analysis** for **{{research_topic}}** to understand the technology landscape. **Technology Stack Focus:** @@ -51,7 +53,8 @@ Start with technology stack research approach: - Development tools and platforms - Cloud infrastructure and deployment platforms -**Let me search for current technology stack insights.**" +**Let me search for current technology stack insights.** + ### 2. Parallel Technology Stack Research Execution @@ -74,7 +77,8 @@ Search the web: "{{research_topic}} cloud infrastructure platforms" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate technology stack findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate technology stack findings: **Research Coverage:** @@ -87,7 +91,8 @@ Search the web: "{{research_topic}} cloud infrastructure platforms" [Identify patterns connecting language choices, frameworks, and platform decisions] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Technology Stack Content @@ -161,7 +166,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **technology stack analysis** of the technology landscape for {{research_topic}}. + +I've completed **technology stack analysis** of the technology landscape for {{research_topic}}. **Key Technology Stack Findings:** @@ -173,6 +179,7 @@ _Source: [URL]_ **Ready to proceed to integration patterns analysis?** [C] Continue - Save this to document and proceed to integration patterns + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md index 68e2b70f..60dd96d5 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md @@ -41,7 +41,9 @@ Conduct integration patterns analysis focusing on APIs, communication protocols, **UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different integration areas simultaneously and thoroughly. Start with integration patterns research approach: -"Now I'll conduct **integration patterns analysis** for **{{research_topic}}** to understand system integration approaches. + + +Now I'll conduct **integration patterns analysis** for **{{research_topic}}** to understand system integration approaches. **Integration Patterns Focus:** @@ -51,7 +53,8 @@ Start with integration patterns research approach: - Microservices integration patterns - Event-driven architectures and messaging -**Let me search for current integration patterns insights.**" +**Let me search for current integration patterns insights.** + ### 2. Parallel Integration Patterns Research Execution @@ -74,7 +77,8 @@ Search the web: "{{research_topic}} microservices integration patterns" **Collect and analyze findings from all parallel searches:** -"After executing comprehensive parallel web searches, let me analyze and aggregate integration patterns findings: + +After executing comprehensive parallel web searches, let me analyze and aggregate integration patterns findings: **Research Coverage:** @@ -87,7 +91,8 @@ Search the web: "{{research_topic}} microservices integration patterns" [Identify patterns connecting API choices, communication protocols, and system design] **Quality Assessment:** -[Overall confidence levels and research gaps identified]" +[Overall confidence levels and research gaps identified] + ### 4. Generate Integration Patterns Content @@ -170,7 +175,8 @@ _Source: [URL]_ **Show analysis and present continue option:** -"I've completed **integration patterns analysis** of system integration approaches for {{research_topic}}. + +I've completed **integration patterns analysis** of system integration approaches for {{research_topic}}. **Key Integration Patterns Findings:** @@ -182,6 +188,7 @@ _Source: [URL]_ **Ready to proceed to architectural patterns analysis?** [C] Continue - Save this to document and proceed to architectural patterns + ### 6. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md index 426cc662..92f111c3 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md @@ -39,7 +39,9 @@ Conduct comprehensive architectural patterns analysis with emphasis on design de ### 1. Begin Architectural Patterns Analysis Start with architectural research approach: -"Now I'll focus on **architectural patterns and design decisions** for effective architecture approaches for [technology/domain]. + + +Now I'll focus on **architectural patterns and design decisions** for effective architecture approaches for [technology/domain]. **Architectural Patterns Focus:** @@ -49,7 +51,8 @@ Start with architectural research approach: - Integration and communication patterns - Security and performance architectural considerations -**Let me search for current architectural patterns and approaches.**" +**Let me search for current architectural patterns and approaches.** + ### 2. Web Search for System Architecture Patterns @@ -137,7 +140,9 @@ _Source: [URL]_ ### 6. Present Analysis and Continue Option Show the generated architectural patterns and present continue option: -"I've completed the **architectural patterns analysis** for effective architecture approaches. + + +I've completed the **architectural patterns analysis** for effective architecture approaches. **Key Architectural Findings:** @@ -149,6 +154,7 @@ Show the generated architectural patterns and present continue option: **Ready to proceed to implementation research?** [C] Continue - Save this to the document and move to implementation research + ### 7. Handle Continue Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md index 7117d525..e796583c 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md @@ -36,7 +36,9 @@ Conduct comprehensive implementation research with emphasis on practical impleme ### 1. Begin Implementation Research Start with implementation research approach: -"Now I'll complete our technical research with **implementation approaches and technology adoption** analysis. + + +Now I'll complete our technical research with **implementation approaches and technology adoption** analysis. **Implementation Research Focus:** @@ -46,7 +48,8 @@ Start with implementation research approach: - Team organization and skill requirements - Cost optimization and resource management -**Let me search for current implementation and adoption strategies.**" +**Let me search for current implementation and adoption strategies.** + ### 2. Web Search for Technology Adoption @@ -152,7 +155,9 @@ _Source: [URL]_ ### 6. Present Analysis and Complete Option Show the generated implementation research and present complete option: -"I've completed the **implementation research and technology adoption** analysis, finalizing our comprehensive technical research. + + +I've completed the **implementation research and technology adoption** analysis, finalizing our comprehensive technical research. **Implementation Highlights:** @@ -171,6 +176,7 @@ Show the generated implementation research and present complete option: **Ready to complete the technical research report?** [C] Complete Research - Save final document and conclude + ### 7. Handle Complete Selection diff --git a/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md b/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md index 7dc28a2d..7479c6dc 100644 --- a/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +++ b/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md @@ -382,7 +382,8 @@ _This comprehensive technical research document serves as an authoritative techn **Technical Document Completion Presentation:** -"I've completed the **comprehensive technical research document synthesis** for **{{research_topic}}**, producing an authoritative technical research document with: + +I've completed the **comprehensive technical research document synthesis** for **{{research_topic}}**, producing an authoritative technical research document with: **Technical Document Features:** @@ -411,6 +412,7 @@ _This comprehensive technical research document serves as an authoritative techn **Ready to complete this comprehensive technical research document?** [C] Complete Research - Save final comprehensive technical document + ### 6. Handle Final Technical Completion diff --git a/src/bmm/workflows/1-analysis/research/workflow.md b/src/bmm/workflows/1-analysis/research/workflow.md index 64f62bef..8865a713 100644 --- a/src/bmm/workflows/1-analysis/research/workflow.md +++ b/src/bmm/workflows/1-analysis/research/workflow.md @@ -91,7 +91,8 @@ Execute research type discovery and routing: ### Collaborative Research Discovery -"Welcome {{user_name}}! I'm excited to work with you as your research partner. I bring web research capabilities with rigorous source verification, while you bring the domain expertise and research direction. + +Welcome {{user_name}}! I'm excited to work with you as your research partner. I bring web research capabilities with rigorous source verification, while you bring the domain expertise and research direction. **Let me help you clarify what you'd like to research.** @@ -104,6 +105,7 @@ For example: - 'AI implementation in financial services' - 'Sustainable packaging regulations' - 'Or anything else you have in mind...' + ### Topic Exploration and Clarification diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01-init.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01-init.md index 4b53688d..ee6d000a 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01-init.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01-init.md @@ -121,7 +121,8 @@ Try to discover the following: **Setup Report to User:** -"Welcome {{user_name}}! I've set up your PRD workspace for {{project_name}}. + +Welcome {{user_name}}! I've set up your PRD workspace for {{project_name}}. **Document Setup:** @@ -141,7 +142,8 @@ Try to discover the following: 📋 **Note:** This is a **brownfield project**. Your existing project documentation has been loaded. In the next step, I'll ask specifically about what new features or changes you want to add to your existing system. {/if} -Do you have any other documents you'd like me to include, or shall we continue to the next step?" +Do you have any other documents you'd like me to include, or shall we continue to the next step? + ### 4. Present MENU OPTIONS diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01b-continue.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01b-continue.md index 4f9198af..82d6707e 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01b-continue.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-01b-continue.md @@ -86,7 +86,9 @@ Review the frontmatter to understand: ### 4. Handle Workflow Completion **If `stepsCompleted` array contains `"step-11-complete.md"`:** -"Great news! It looks like we've already completed the PRD workflow for {{project_name}}. + + +Great news! It looks like we've already completed the PRD workflow for {{project_name}}. The final document is ready at `{outputFile}` with all sections completed. @@ -96,12 +98,15 @@ Would you like me to: - Suggest next workflow steps (like architecture or epic creation) - Start a new PRD revision -What would be most helpful?" +What would be most helpful? + ### 5. Present Current Progress **If workflow not complete:** -"Welcome back {{user_name}}! I'm resuming our PRD collaboration for {{project_name}}. + + +Welcome back {{user_name}}! I'm resuming our PRD collaboration for {{project_name}}. **Current Progress:** - Last completed: {last step filename from stepsCompleted array} @@ -112,11 +117,14 @@ What would be most helpful?" - Current PRD document is ready with all completed sections - Ready to continue from where we left off -Does this look right, or do you want to make any adjustments before we proceed?" +Does this look right, or do you want to make any adjustments before we proceed? + ### 6. Present MENU OPTIONS -Display: "**Select an Option:** [C] Continue to {next step name}" + +**Select an Option:** [C] Continue to {next step name} + #### Menu Handling Logic: diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md index 4829a4d3..fa271c84 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md @@ -83,20 +83,23 @@ Read the frontmatter from `{outputFile}` to get document counts: **Announce your understanding:** -"From step 1, I have loaded: + +From step 1, I have loaded: - Product briefs: {{briefCount}} - Research: {{researchCount}} - Brainstorming: {{brainstormingCount}} - Project docs: {{projectDocsCount}} -{{if projectDocsCount > 0}}This is a brownfield project - I'll focus on understanding what you want to add or change.{{else}}This is a greenfield project - I'll help you define the full product vision.{{/if}}" +{{if projectDocsCount > 0}}This is a brownfield project - I'll focus on understanding what you want to add or change.{{else}}This is a greenfield project - I'll help you define the full product vision.{{/if}} + ### 2. Load Classification Data **Attempt subprocess data lookup:** **Project Type Lookup:** -"Your task: Lookup data in {projectTypesCSV} + +Your task: Lookup data in {projectTypesCSV} **Search criteria:** - Find row where project_type matches {{detectedProjectType}} @@ -105,10 +108,11 @@ Read the frontmatter from `{outputFile}` to get document counts: Return ONLY the matching row as a YAML-formatted object with these fields: project_type, detection_signals -**Do NOT return the entire CSV - only the matching row.**" +**Do NOT return the entire CSV - only the matching row.** **Domain Complexity Lookup:** -"Your task: Lookup data in {domainComplexityCSV} + +Your task: Lookup data in {domainComplexityCSV} **Search criteria:** - Find row where domain matches {{detectedDomain}} @@ -117,7 +121,7 @@ project_type, detection_signals Return ONLY the matching row as a YAML-formatted object with these fields: domain, complexity, typical_concerns, compliance_requirements -**Do NOT return the entire CSV - only the matching row.**" +**Do NOT return the entire CSV - only the matching row.** **Graceful degradation (if Task tool unavailable):** - Load the CSV files directly @@ -147,12 +151,14 @@ As the user describes their product, match against: Once you have enough understanding, share your classification: -"I'm hearing this as: + +I'm hearing this as: - **Project Type:** {{detectedType}} - **Domain:** {{detectedDomain}} - **Complexity:** {{complexityLevel}} -Does this sound right to you?" +Does this sound right to you? + Let the user confirm or refine your classification. @@ -171,7 +177,8 @@ classification: Present the project classification for review, then display menu: -"Based on our conversation, I've discovered and classified your project. + +Based on our conversation, I've discovered and classified your project. **Here's the classification:** @@ -180,9 +187,12 @@ Present the project classification for review, then display menu: **Complexity:** {{complexityLevel}} **Project Context:** {{greenfield|brownfield}} -**What would you like to do?**" +**What would you like to do?** + -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Product Vision (Step 2b of 13)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Product Vision (Step 2b of 13) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current classification, process the enhanced insights that come back, ask user if they accept the improvements, if yes update classification then redisplay menu, if no keep original classification then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md index 9a3c5e34..b50ca080 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md @@ -172,7 +172,9 @@ Present the success criteria content for user review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of the conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md index 314dab56..56ae4069 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md @@ -152,7 +152,9 @@ Present the user journey content for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Domain Requirements (Step 5 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Domain Requirements (Step 5 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current journey content, process the enhanced journey insights that come back, ask user "Accept these improvements to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md index 9539527d..1433cbc6 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md @@ -80,9 +80,12 @@ For complex domains, explore what makes this domain special: **If complexity is LOW:** Offer to skip: -"The domain complexity from our discovery is low. We may not need deep domain-specific requirements. Would you like to: + + +The domain complexity from our discovery is low. We may not need deep domain-specific requirements. Would you like to: - [C] Skip this step and move to Innovation -- [D] Do domain exploration anyway" +- [D] Do domain exploration anyway + **If complexity is MEDIUM or HIGH:** @@ -92,7 +95,7 @@ Proceed with domain exploration. **Attempt subprocess data lookup:** -"Your task: Lookup data in {domainComplexityCSV} +Your task: Lookup data in {domainComplexityCSV} **Search criteria:** - Find row where domain matches {{domainFromStep02}} @@ -101,7 +104,7 @@ Proceed with domain exploration. Return ONLY the matching row as a YAML-formatted object with these fields: domain, complexity, typical_concerns, compliance_requirements -**Do NOT return the entire CSV - only the matching row.**" +**Do NOT return the entire CSV - only the matching row.** **Graceful degradation (if Task tool unavailable):** - Load the CSV file directly @@ -147,11 +150,15 @@ Acknowledge the domain and explore what makes it complex: **Check with the user:** -"Are there other domain-specific concerns we should consider? For [this domain], what typically gets overlooked?" + +Are there other domain-specific concerns we should consider? For [this domain], what typically gets overlooked? + ### N. Present MENU OPTIONS -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md index 440ccf2d..f2ca60f7 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md @@ -152,7 +152,9 @@ Present the innovation content for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current innovation content, process the enhanced innovation insights that come back, ask user "Accept these improvements to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu @@ -172,7 +174,9 @@ If no genuine innovation signals are found after exploration: - Note this is fine - many successful products are excellent executions of existing concepts - Ask if they'd like to try finding innovative angles or proceed -Display: "**Select:** [A] Advanced Elicitation - Let's try to find innovative angles [C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11)" + +**Select:** [A] Advanced Elicitation - Let's try to find innovative angles [C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11) + ### Menu Handling Logic: - IF A: Proceed with content generation anyway, then return to menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md index c078d6db..9ffceb4c 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md @@ -55,7 +55,7 @@ Conduct project-type specific discovery using CSV-driven guidance to define tech **Attempt subprocess data lookup:** -"Your task: Lookup data in {projectTypesCSV} +Your task: Lookup data in {projectTypesCSV} **Search criteria:** - Find row where project_type matches {{projectTypeFromStep02}} @@ -64,7 +64,7 @@ Conduct project-type specific discovery using CSV-driven guidance to define tech Return ONLY the matching row as a YAML-formatted object with these fields: project_type, key_questions, required_sections, skip_sections, innovation_signals -**Do NOT return the entire CSV - only the matching row.**" +**Do NOT return the entire CSV - only the matching row.** **Graceful degradation (if Task tool unavailable):** - Load the CSV file directly @@ -161,15 +161,21 @@ When saving to document, append these Level 2 and Level 3 sections: Present the project-type content for review, then display menu: -"Based on our conversation and best practices for this product type, I've documented the {project_type}-specific requirements for {{project_name}}. + +Based on our conversation and best practices for this product type, I've documented the {project_type}-specific requirements for {{project_name}}. **Here's what I'll add to the document:** + [Show the complete markdown content from section 5] -**What would you like to do?**" + +**What would you like to do?** + -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current project-type content, process the enhanced technical insights that come back, ask user "Accept these improvements to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md index da9230ad..99a24963 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md @@ -117,11 +117,14 @@ Create phased development approach: Identify and mitigate scoping risks: **Technical Risks:** -"Looking at your innovation and domain requirements: + + +Looking at your innovation and domain requirements: - What's the most technically challenging aspect? - Could we simplify the initial implementation? -- What's the riskiest assumption about technology feasibility?" +- What's the riskiest assumption about technology feasibility? + **Market Risks:** @@ -180,7 +183,9 @@ Present the scoping decisions for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md index d689ebf3..58306704 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md @@ -176,9 +176,11 @@ Present the functional requirements for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -**What would you like to do?**" +**What would you like to do?** -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current FR list, process the enhanced capability coverage that comes back, ask user if they accept the additions, if yes update content then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md index 40919635..5bd279fb 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md @@ -165,7 +165,9 @@ Present the non-functional requirements for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the current NFR content, process the enhanced quality attribute insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md index 70bf198c..64f3758d 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md @@ -166,7 +166,9 @@ Present the polished document for review, then display menu: - Ask if they'd like to refine further, get other perspectives, or proceed - Present menu options naturally as part of conversation -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Complete PRD (Step 12 of 12)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Complete PRD (Step 12 of 12) + #### Menu Handling Logic: - IF A: Read fully and follow: {advancedElicitationTask} with the polished document, process the enhanced refinements that come back, ask user "Accept these polish improvements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md index 8f47cd55..6b8d7b84 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md @@ -70,11 +70,13 @@ This file defines what makes a great BMAD PRD. Internalize this understanding - ### 2. Discover PRD to Edit -"**PRD Edit Workflow** + +**PRD Edit Workflow** Which PRD would you like to edit? -Please provide the path to the PRD file you want to edit." +Please provide the path to the PRD file you want to edit. + **Wait for user to provide PRD path.** @@ -96,8 +98,8 @@ ls -t {prd_folder_path}/validation-report-*.md 2>/dev/null | head -1 **If validation report found:** -Display: -"**📋 Found Validation Report** + +**📋 Found Validation Report** I found a validation report from {validation_date} in the PRD folder. @@ -105,7 +107,8 @@ This report contains findings from previous validation checks and can help guide **Would you like to:** - **[U] Use validation report** - Load it to guide and prioritize edits -- **[S] Skip** - Proceed with manual edit discovery" +- **[S] Skip** - Proceed with manual edit discovery + **Wait for user input.** @@ -125,11 +128,13 @@ This report contains findings from previous validation checks and can help guide ### 5. Ask About Validation Report -"**Do you have a validation report to guide edits?** + +**Do you have a validation report to guide edits?** If you've run the validation workflow on this PRD, I can use that report to guide improvements and prioritize changes. -Validation report path (or type 'none'):" +Validation report path (or type 'none'): + **Wait for user input.** @@ -144,7 +149,8 @@ Validation report path (or type 'none'):" ### 6. Discover Edit Requirements -"**What would you like to edit in this PRD?** + +**What would you like to edit in this PRD?** Please describe the changes you want to make. For example: - Fix specific issues (information density, implementation leakage, etc.) @@ -154,7 +160,8 @@ Please describe the changes you want to make. For example: - General improvements - Other changes -**Describe your edit goals:**" +**Describe your edit goals:** + **Wait for user to describe their requirements.** @@ -181,25 +188,29 @@ Analyze the loaded PRD: **IF validation report provided OR PRD is BMAD Standard/Variant:** -Display: "**Edit Requirements Understood** + +**Edit Requirements Understood** **PRD Format:** {classification} {If validation report: "**Validation Guide:** Yes - will use validation report findings"} **Edit Goals:** {summary of user's requirements} -**Proceeding to deep review and analysis...**" +**Proceeding to deep review and analysis...** + Read fully and follow: next step (step-e-02-review.md) **IF PRD is Legacy (Non-Standard) AND no validation report:** -Display: "**Format Detected:** Legacy PRD + +**Format Detected:** Legacy PRD This PRD does not follow BMAD standard structure (only {count}/6 core sections present). **Your edit goals:** {user's requirements} -**How would you like to proceed?**" +**How would you like to proceed?** + Present MENU OPTIONS below for user selection @@ -217,7 +228,7 @@ Present MENU OPTIONS below for user selection #### Menu Handling Logic: - IF C (Convert): Read fully and follow: {altStepFile} (step-e-01b-legacy-conversion.md) -- IF E (Edit As-Is): Display "Proceeding with edits..." then load next step +- IF E (Edit As-Is): Proceeding with edits... then load next step - IF X (Exit): Display summary and exit - IF Any other: help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01b-legacy-conversion.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01b-legacy-conversion.md index d13531d2..72eefa3c 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01b-legacy-conversion.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-01b-legacy-conversion.md @@ -126,9 +126,8 @@ Return conversion assessment with gap analysis and effort estimate." ### 3. Present Conversion Assessment -Display: - -"**Legacy PRD Conversion Assessment** + +**Legacy PRD Conversion Assessment** **Current PRD Structure:** - Core sections present: {count}/6 @@ -146,7 +145,8 @@ Display: **Recommendation:** {Based on effort and user goals, recommend best approach} -**How would you like to proceed?**" +**How would you like to proceed?** + ### 4. Present MENU OPTIONS @@ -175,12 +175,14 @@ Store conversion decision for next step: - **Edit requirements:** [user's requirements from step e-01] - **Gap analysis:** [summary of gaps identified] -Display: "**Conversion Strategy Documented** + +**Conversion Strategy Documented** Mode: {conversion mode} Edit goals: {summary} -**Proceeding to deep review...**" +**Proceeding to deep review...** + Read fully and follow: {nextStepFile} (step-e-02-review.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md index f34de79f..717df4b5 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md @@ -144,9 +144,8 @@ Return detailed change plan with section breakdown." ### 4. Present Change Plan to User -Display: - -"**Deep Review Complete - Change Plan** + +**Deep Review Complete - Change Plan** **PRD Analysis:** {Brief summary of PRD current state} @@ -175,7 +174,8 @@ Display: 2. Any sections I should add/remove/reprioritize? 3. Any concerns before I proceed with edits? -**Review the plan and let me know if you'd like any adjustments.**" +**Review the plan and let me know if you'd like any adjustments.** + ### 5. Get User Confirmation @@ -198,11 +198,13 @@ Store approved change plan for next step: - **Priority order:** Sequence to apply changes - **User confirmed:** Yes -Display: "**Change Plan Approved** + +**Change Plan Approved** {Brief summary of approved plan} -**Proceeding to edit step...**" +**Proceeding to edit step...** + Read fully and follow: {nextStepFile} (step-e-03-edit.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-03-edit.md index 65c12946..97c0b620 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-03-edit.md @@ -64,13 +64,15 @@ From step e-02, retrieve: - **Priority order:** Sequence to apply changes - **User requirements:** Edit goals from step e-01 -Display: "**Starting PRD Edits** + +**Starting PRD Edits** **Change Plan:** {summary} **Total Changes:** {count} **Estimated Effort:** {effort level} -**Proceeding with edits section by section...**" +**Proceeding with edits section by section...** + ### 2. Attempt Sub-Process Edits (For Complex Changes) @@ -120,9 +122,11 @@ Apply changes and return updated section." - Verify changes applied correctly **Display progress after each section:** -"**Section Updated:** {section_name} + +**Section Updated:** {section_name} Changes: {brief summary} -{More sections remaining...}" +{More sections remaining...} + ### 4. Handle Restructuring (If Needed) @@ -145,9 +149,11 @@ Changes: {brief summary} 8. Functional Requirements 9. Non-Functional Requirements -Display: "**PRD Restructured** + +**PRD Restructured** BMAD standard structure applied. -{Sections added/reordered}" +{Sections added/reordered} + ### 5. Update PRD Frontmatter @@ -192,9 +198,8 @@ editHistory: ### 7. Confirm Completion -Display: - -"**PRD Edits Complete** + +**PRD Edits Complete** **Changes Applied:** {count} sections modified **PRD Updated:** {prd_file_path} @@ -206,7 +211,8 @@ Display: - Use in downstream workflows (UX, Architecture) - Validation (if not yet validated) -**What would you like to do next?**" +**What would you like to do next?** + ### 8. Present MENU OPTIONS @@ -222,7 +228,7 @@ Display: #### Menu Handling Logic: -- IF V (Validate): Display "Starting validation workflow..." then read fully and follow: steps-v/step-v-01-discovery.md +- IF V (Validate): Starting validation workflow... then read fully and follow: steps-v/step-v-01-discovery.md - IF S (Summary): Present edit summary and exit - IF A (Adjust): Accept additional requirements, loop back to editing - IF X (Exit): Display summary and exit diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-04-complete.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-04-complete.md index 5d681fee..90441efe 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-04-complete.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-e/step-e-04-complete.md @@ -78,9 +78,8 @@ From step e-03 change execution, compile: ### 2. Present Completion Summary -Display: - -"**✓ PRD Edit Complete** + +**✓ PRD Edit Complete** **Updated PRD:** {prd_file_path} @@ -97,16 +96,17 @@ Display: - Validation to ensure quality - Production use -**What would you like to do next?**" +**What would you like to do next?** + ### 3. Present MENU OPTIONS -Display: - + **[V] Run Full Validation** - Execute complete validation workflow (steps-v) to verify PRD quality **[E] Edit More** - Make additional edits to the PRD **[S] Summary** - End with detailed summary of changes **[X] Exit** - Exit edit workflow + #### EXECUTION RULES: @@ -116,17 +116,22 @@ Display: #### Menu Handling Logic: - **IF V (Run Full Validation):** - - Display: "**Starting Validation Workflow**" - - Display: "This will run all 13 validation checks on the updated PRD." - - Display: "Preparing to validate: {prd_file_path}" - - Display: "**Proceeding to validation...**" + - + **Starting Validation Workflow** + + This will run all 13 validation checks on the updated PRD. + + Preparing to validate: {prd_file_path} + + **Proceeding to validation...** + - Read fully and follow: {validationWorkflow} (steps-v/step-v-01-discovery.md) - Note: This hands off to the validation workflow which will run its complete 13-step process - **IF E (Edit More):** - - Display: "**Additional Edits**" + - **Additional Edits** - Ask: "What additional edits would you like to make?" - - Accept input, then display: "**Returning to edit step...**" + - Accept input, then **Returning to edit step...** - Read fully and follow: step-e-03-edit.md again - **IF S (Summary):** @@ -134,12 +139,12 @@ Display: - Complete list of all changes made - Before/after comparison (key improvements) - Recommendations for next steps - - Display: "**Edit Workflow Complete**" + - **Edit Workflow Complete** - Exit - **IF X (Exit):** - Display summary - - Display: "**Edit Workflow Complete**" + - **Edit Workflow Complete** - Exit - **IF Any other:** Help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md index b79e12fe..57c6cca2 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md @@ -71,11 +71,14 @@ This file contains the BMAD PRD philosophy, standards, and validation criteria t - Use provided path **If no PRD path provided:** -"**PRD Validation Workflow** + + +**PRD Validation Workflow** Which PRD would you like to validate? -Please provide the path to the PRD file you want to validate." +Please provide the path to the PRD file you want to validate. + **Wait for user to provide PRD path.** @@ -112,7 +115,8 @@ For each document listed in `inputDocuments`: ### 6. Ask About Additional Reference Documents -"**I've loaded the following documents from your PRD frontmatter:** + +**I've loaded the following documents from your PRD frontmatter:** {list loaded documents with file names} @@ -124,7 +128,8 @@ These could include: - Standards or compliance documents - Competitive analysis or benchmarks -Please provide paths to any additional documents, or type 'none' to proceed." +Please provide paths to any additional documents, or type 'none' to proceed. + **Load any additional documents provided by user.** @@ -161,7 +166,8 @@ validationStatus: IN_PROGRESS ### 8. Present Discovery Summary -"**Setup Complete!** + +**Setup Complete!** **PRD to Validate:** {prd_path} @@ -173,11 +179,14 @@ validationStatus: IN_PROGRESS **Validation Report:** {validationReportPath} -**Ready to begin validation.**" +**Ready to begin validation.** + ### 9. Present MENU OPTIONS -Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Format Detection + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Format Detection + #### EXECUTION RULES: diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md index a354b5af..5e9785a5 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md @@ -132,19 +132,23 @@ Append to validation report: **IF format is BMAD Standard or BMAD Variant:** -Display: "**Format Detected:** {classification} + +**Format Detected:** {classification} -Proceeding to systematic validation checks..." +Proceeding to systematic validation checks... + Without delay, read fully and follow: {nextStepFile} (step-v-03-density-validation.md) **IF format is Non-Standard (< 3 core sections):** -Display: "**Format Detected:** Non-Standard PRD + +**Format Detected:** Non-Standard PRD This PRD does not follow BMAD standard structure (only {count}/6 core sections present). -You have options:" +You have options: + Present MENU OPTIONS below for user selection @@ -162,7 +166,7 @@ Present MENU OPTIONS below for user selection #### Menu Handling Logic: - IF A (Parity Check): Read fully and follow: {altStepFile} (step-v-02b-parity-check.md) -- IF B (Validate As-Is): Display "Proceeding with validation..." then read fully and follow: {nextStepFile} +- IF B (Validate As-Is): Proceeding with validation... then read fully and follow: {nextStepFile} - IF C (Exit): Display format findings summary and exit validation - IF Any other: help user respond, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md index 604265a9..d8d987b7 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md @@ -153,9 +153,8 @@ Append to validation report: ### 4. Present Parity Analysis and Options -Display: - -"**Parity Analysis Complete** + +**Parity Analysis Complete** Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to reach BMAD standard is: **{effort level}** @@ -165,7 +164,8 @@ Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to r **Recommendation:** {recommendation from analysis} -**How would you like to proceed?**" +**How would you like to proceed?** + ### 5. Present MENU OPTIONS @@ -180,7 +180,7 @@ Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to r #### Menu Handling Logic: -- IF C (Continue): Display "Proceeding with validation..." then read fully and follow: {nextStepFile} +- IF C (Continue): Proceeding with validation... then read fully and follow: {nextStepFile} - IF E (Exit): Display parity summary and exit validation - IF S (Save): Confirm saved, display summary, exit - IF Any other: help user respond, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md index d00478c1..3cf96c1c 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md @@ -43,7 +43,7 @@ Validate PRD meets BMAD information density standards by scanning for conversati - 🎯 Scan PRD for density anti-patterns systematically - 💾 Append density findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -142,11 +142,13 @@ Append to validation report: ### 5. Display Progress and Auto-Proceed -Display: "**Information Density Validation Complete** + +**Information Density Validation Complete** Severity: {Critical/Warning/Pass} -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-04-brief-coverage-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md index 60ad8684..87ed207d 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md @@ -46,7 +46,7 @@ Validate that PRD covers all content from Product Brief (if brief was used as in - 💬 If no brief: Skip this check and report "N/A - No Product Brief" - 🎯 If brief exists: Map brief content to PRD sections - 💾 Append coverage findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -72,9 +72,11 @@ Append to validation report: **Status:** N/A - No Product Brief was provided as input ``` -Display: "**Product Brief Coverage: Skipped** (No Product Brief provided) + +**Product Brief Coverage: Skipped** (No Product Brief provided) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} @@ -180,11 +182,13 @@ Append to validation report: ### 6. Display Progress and Auto-Proceed -Display: "**Product Brief Coverage Validation Complete** + +**Product Brief Coverage Validation Complete** Overall Coverage: {assessment} -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-05-measurability-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md index a9718718..fca47cc0 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md @@ -44,7 +44,7 @@ Validate that all Functional Requirements (FRs) and Non-Functional Requirements - 🎯 Extract all FRs and NFRs from PRD - 💾 Validate each for measurability and format - 📖 Append findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -195,11 +195,13 @@ Append to validation report: ### 5. Display Progress and Auto-Proceed -Display: "**Measurability Validation Complete** + +**Measurability Validation Complete** Total Violations: {count} ({severity}) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-06-traceability-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md index 84bf9cce..abe6ae6e 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md @@ -44,7 +44,7 @@ Validate the traceability chain from Executive Summary → Success Criteria → - 🎯 Build and validate traceability matrix - 💾 Identify broken chains and orphan requirements - 📖 Append findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -183,11 +183,13 @@ Append to validation report: ### 5. Display Progress and Auto-Proceed -Display: "**Traceability Validation Complete** + +**Traceability Validation Complete** Total Issues: {count} ({severity}) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-07-implementation-leakage-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md index 923f9969..79ffcf03 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md @@ -44,7 +44,7 @@ Ensure Functional Requirements and Non-Functional Requirements don't include imp - 🎯 Scan FRs and NFRs for implementation terms - 💾 Distinguish capability-relevant vs leakage - 📖 Append findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -172,11 +172,13 @@ Append to validation report: ### 5. Display Progress and Auto-Proceed -Display: "**Implementation Leakage Validation Complete** + +**Implementation Leakage Validation Complete** Total Violations: {count} ({severity}) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-08-domain-compliance-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md index 562697ed..b62ba3c9 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md @@ -47,7 +47,7 @@ Validate domain-specific requirements are present for high-complexity domains (H - 💬 If low complexity (general): Skip detailed checks - 🎯 If high complexity: Validate required special sections - 💾 Append compliance findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -155,11 +155,13 @@ Append to validation report: **Note:** This PRD is for a standard domain without regulatory compliance requirements. ``` -Display: "**Domain Compliance Validation Skipped** + +**Domain Compliance Validation Skipped** Domain: {domain} (low complexity) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} @@ -206,12 +208,14 @@ Append to validation report: ### 7. Display Progress and Auto-Proceed -Display: "**Domain Compliance Validation Complete** + +**Domain Compliance Validation Complete** Domain: {domain} ({complexity}) Compliance Status: {status} -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-09-project-type-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md index aea41d92..63dd94ba 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md @@ -47,7 +47,7 @@ Validate project-type specific requirements are properly documented - different - 🎯 Validate required sections for that project type are present - 🎯 Validate excluded sections for that project type are absent - 💾 Append compliance findings to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -227,12 +227,14 @@ Append to validation report: ### 7. Display Progress and Auto-Proceed -Display: "**Project-Type Compliance Validation Complete** + +**Project-Type Compliance Validation Complete** Project Type: {projectType} Compliance: {score}% -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-10-smart-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md index e937c752..7a6b60d6 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md @@ -46,7 +46,7 @@ Validate Functional Requirements meet SMART quality criteria (Specific, Measurab - 🎯 Score each FR on SMART criteria (Specific, Measurable, Attainable, Relevant, Traceable) - 💾 Flag FRs with score < 3 in any category - 📖 Append scoring table and suggestions to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -173,11 +173,13 @@ Append to validation report: ### 5. Display Progress and Auto-Proceed -Display: "**SMART Requirements Validation Complete** + +**SMART Requirements Validation Complete** FR Quality: {percentage}% with acceptable scores ({severity}) -**Proceeding to next validation check...**" +**Proceeding to next validation check...** + Without delay, read fully and follow: {nextStepFile} (step-v-11-holistic-quality-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md index 698b6f65..460a9df4 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md @@ -46,7 +46,7 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du - 🎯 Use Advanced Elicitation for multi-perspective assessment - 🎯 Evaluate document flow, dual audience, BMAD principles - 💾 Append comprehensive assessment to validation report -- 📖 Display "Proceeding to next check..." and load next step +- 📖 Proceeding to next check... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -226,11 +226,13 @@ Append to validation report: ### 4. Display Progress and Auto-Proceed -Display: "**Holistic Quality Assessment Complete** + +**Holistic Quality Assessment Complete** Overall Rating: {rating}/5 - {label} -**Proceeding to final validation checks...**" +**Proceeding to final validation checks...** + Without delay, read fully and follow: {nextStepFile} (step-v-12-completeness-validation.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md index 00c47798..9ab86791 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md @@ -47,7 +47,7 @@ Final comprehensive completeness check - validate no template variables remain, - 🎯 Validate section-specific completeness - 🎯 Validate frontmatter completeness - 💾 Append completeness matrix to validation report -- 📖 Display "Proceeding to final step..." and load next step +- 📖 Proceeding to final step... and load next step - 🚫 FORBIDDEN to pause or request user input ## CONTEXT BOUNDARIES: @@ -206,11 +206,13 @@ Append to validation report: ### 4. Display Progress and Auto-Proceed -Display: "**Completeness Validation Complete** + +**Completeness Validation Complete** Overall Completeness: {percentage}% ({severity}) -**Proceeding to final step...**" +**Proceeding to final step...** + Without delay, read fully and follow: {nextStepFile} (step-v-13-report-complete.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md index 08465604..ed55c4fb 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md @@ -123,9 +123,8 @@ overallStatus: '{Pass/Warning/Critical based on all findings}' ### 4. Present Summary to User Conversationally -Display: - -"**✓ PRD Validation Complete** + +**✓ PRD Validation Complete** **Overall Status:** {Pass/Warning/Critical} @@ -154,16 +153,17 @@ Display: - Warning: "PRD is usable but has issues that should be addressed. Review warnings and improve where needed." - Critical: "PRD has significant issues that should be fixed before use. Focus on critical issues above."} -**What would you like to do next?**" +**What would you like to do next?** + ### 5. Present MENU OPTIONS -Display: - + **[R] Review Detailed Findings** - Walk through validation report section by section **[E] Use Edit Workflow** - Use validation report with Edit workflow for systematic improvements **[F] Fix Simpler Items** - Immediate fixes for simple issues (anti-patterns, leakage, missing headers) **[X] Exit** - Exit and Suggest Next Steps. + #### EXECUTION RULES: @@ -195,8 +195,11 @@ Display: - Return to menu - **IF X (Exit):** - - Display: "**Validation Report Saved:** {validationReportPath}" - - Display: "**Summary:** {overall status} - {recommendation}" + + **Validation Report Saved:** {validationReportPath} + + **Summary:** {overall status} - {recommendation} + - PRD Validation complete. Read fully and follow: `_bmad/core/tasks/bmad-help.md` with argument `Validate PRD`. - **IF Any other:** Help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/workflow.md b/src/bmm/workflows/2-plan-workflows/create-prd/workflow.md index b13d7a7c..346ad1f0 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/workflow.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/workflow.md @@ -40,30 +40,53 @@ Determine which mode to invoke based on: 3. **Menu Selection (if unclear):** If mode cannot be determined from invocation: -"**PRD Workflow - Select Mode:** + + +**PRD Workflow - Select Mode:** **[C] Create** - Create a new PRD from scratch **[V] Validate** - Validate an existing PRD against BMAD standards **[E] Edit** - Improve an existing PRD -Which mode would you like?" +Which mode would you like? + Wait for user selection. ### Route to Appropriate Workflow **IF Create Mode:** -"**Create Mode: Creating a new PRD from scratch.**" + + +**Create Mode: Creating a new PRD from scratch.** + + Read fully and follow: `{nextStep}` (steps-c/step-01-init.md) **IF Validate Mode:** -"**Validate Mode: Validating an existing PRD against BMAD standards.**" -Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file." + + +**Validate Mode: Validating an existing PRD against BMAD standards.** + + +Prompt for PRD path: + + +Which PRD would you like to validate? Please provide the path to the PRD.md file. + Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md) **IF Edit Mode:** -"**Edit Mode: Improving an existing PRD.**" -Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file." + + +**Edit Mode: Improving an existing PRD.** + + +Prompt for PRD path: + + +Which PRD would you like to edit? Please provide the path to the PRD.md file. + Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md) --- @@ -113,13 +136,15 @@ This uses **step-file architecture** for disciplined execution: **If mode is still unclear, ask user:** -"**PRD Workflow - Select Mode:** + +**PRD Workflow - Select Mode:** **[C] Create** - Create a new PRD from scratch **[V] Validate** - Validate an existing PRD against BMAD standards **[E] Edit** - Improve an existing PRD -Which mode would you like?" +Which mode would you like? + Wait for user selection. @@ -136,15 +161,37 @@ Load and read full config from {main_config} and resolve: ### 3. Route to Appropriate Workflow **IF mode == create:** -"**Create Mode: Creating a new PRD from scratch.**" + + +**Create Mode: Creating a new PRD from scratch.** + + Read fully and follow: `{nextStep}` (steps-c/step-01-init.md) **IF mode == validate:** -"**Validate Mode: Validating an existing PRD against BMAD standards.**" -Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file." + + +**Validate Mode: Validating an existing PRD against BMAD standards.** + + +Prompt for PRD path: + + +Which PRD would you like to validate? Please provide the path to the PRD.md file. + + Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md) **IF mode == edit:** -"**Edit Mode: Improving an existing PRD.**" -Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file." + + +**Edit Mode: Improving an existing PRD.** + + +Prompt for PRD path: + + +Which PRD would you like to edit? Please provide the path to the PRD.md file. + + Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md) diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md index 62969baf..1e1d9162 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md @@ -94,7 +94,8 @@ Complete setup and report to user: **Input Documents Discovered:** Report what was found: -"Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}. + +Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}. **Documents Found:** @@ -106,7 +107,8 @@ Report what was found: Do you have any other documents you'd like me to include, or shall we continue to the next step? -[C] Continue to UX discovery" +[C] Continue to UX discovery + ## NEXT STEP: diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md index 3d0f647e..91bb736e 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md @@ -52,7 +52,8 @@ Reload the context documents listed in `inputDocuments`: ### 3. Summarize Current Progress Welcome the user back and provide context: -"Welcome back {{user_name}}! I'm resuming our UX design collaboration for {{project_name}}. + +Welcome back {{user_name}}! I'm resuming our UX design collaboration for {{project_name}}. **Current Progress:** @@ -66,7 +67,8 @@ Welcome the user back and provide context: - Current UX design document is ready with all completed sections - Ready to continue from where we left off -Does this look right, or do you want to make any adjustments before we proceed?" +Does this look right, or do you want to make any adjustments before we proceed? + ### 4. Determine Next Step @@ -81,9 +83,11 @@ Based on `lastStep` value, determine which step to load next: ### 5. Present Continuation Options After presenting current progress, ask: -"Ready to continue with Step {nextStepNumber}: {nextStepTitle}? + +Ready to continue with Step {nextStepNumber}: {nextStepTitle}? -[C] Continue to Step {nextStepNumber}" +[C] Continue to Step {nextStepNumber} + ## SUCCESS METRICS: @@ -106,7 +110,8 @@ After presenting current progress, ask: ## WORKFLOW ALREADY COMPLETE? If `lastStep` indicates the final step is completed: -"Great news! It looks like we've already completed the UX design workflow for {{project_name}}. + +Great news! It looks like we've already completed the UX design workflow for {{project_name}}. The final UX design specification is ready at {output_folder}/ux-design-specification.md with all sections completed through step {finalStepNumber}. @@ -118,7 +123,8 @@ Would you like me to: - Suggest next workflow steps (like wireframe generation or architecture) - Start a new UX design revision -What would be most helpful?" +What would be most helpful? + ## NEXT STEP: diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md index 7ab275a8..3d53029a 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md @@ -51,7 +51,8 @@ Understand the project context, target users, and what makes this product specia ### 1. Review Loaded Context Start by analyzing what we know from the loaded documents: -"Based on the project documentation we have loaded, let me confirm what I'm understanding about {{project_name}}. + +Based on the project documentation we have loaded, let me confirm what I'm understanding about {{project_name}}. **From the documents:** {summary of key insights from loaded PRD, briefs, and other context documents} @@ -62,12 +63,14 @@ Start by analyzing what we know from the loaded documents: **Key Features/Goals:** {summary of main features and goals from loaded documents} -Does this match your understanding? Are there any corrections or additions you'd like to make?" +Does this match your understanding? Are there any corrections or additions you'd like to make? + ### 2. Fill Context Gaps (If no documents or gaps exist) If no documents were loaded or key information is missing: -"Since we don't have complete documentation, let's start with the essentials: + +Since we don't have complete documentation, let's start with the essentials: **What are you building?** (Describe your product in 1-2 sentences) @@ -75,12 +78,14 @@ If no documents were loaded or key information is missing: **What makes this special or different?** (What's the unique value proposition?) -**What's the main thing users will do with this?** (Core user action or goal)" +**What's the main thing users will do with this?** (Core user action or goal) + ### 3. Explore User Context Deeper Dive into user understanding: -"Let me understand your users better to inform the UX design: + +Let me understand your users better to inform the UX design: **User Context Questions:** @@ -89,12 +94,14 @@ Dive into user understanding: - What would make them say 'this is exactly what I needed'? - How tech-savvy are your target users? - What devices will they use most? -- When/where will they use this product?" +- When/where will they use this product? + ### 4. Identify UX Design Challenges Surface the key UX challenges to address: -"From what we've discussed, I'm seeing some key UX design considerations: + +From what we've discussed, I'm seeing some key UX design considerations: **Design Challenges:** @@ -107,7 +114,8 @@ Surface the key UX challenges to address: - [Identify 2-3 areas where great UX could create competitive advantage] - [Note any opportunities for innovative UX patterns] -Does this capture the key UX considerations we need to address?" +Does this capture the key UX considerations we need to address? + ### 5. Generate Project Understanding Content @@ -140,14 +148,18 @@ When saving to document, append these Level 2 and Level 3 sections: ### 6. Present Content and Menu Show the generated project understanding content and present choices: -"I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward. + +I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward. **Here's what I'll add to the document:** + [Show the complete markdown content from step 5] + **What would you like to do?** -[C] Continue - Save this to the document and move to core experience definition" +[C] Continue - Save this to the document and move to core experience definition + ### 7. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md index c64c8423..233ba725 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md @@ -51,7 +51,8 @@ Define the core user experience, platform requirements, and what makes the inter ### 1. Define Core User Action Start by identifying the most important user interaction: -"Now let's dig into the heart of the user experience for {{project_name}}. + +Now let's dig into the heart of the user experience for {{project_name}}. **Core Experience Questions:** @@ -60,12 +61,14 @@ Start by identifying the most important user interaction: - What should be completely effortless for users? - If we nail one interaction, everything else follows - what is it? -Think about the core loop or primary action that defines your product's value." +Think about the core loop or primary action that defines your product's value. + ### 2. Explore Platform Requirements Determine where and how users will interact: -"Let's define the platform context for {{project_name}}: + +Let's define the platform context for {{project_name}}: **Platform Questions:** @@ -73,34 +76,40 @@ Determine where and how users will interact: - Will this be primarily touch-based or mouse/keyboard? - Any specific platform requirements or constraints? - Do we need to consider offline functionality? -- Any device-specific capabilities we should leverage?" +- Any device-specific capabilities we should leverage? + ### 3. Identify Effortless Interactions Surface what should feel magical or completely seamless: -"**Effortless Experience Design:** + +**Effortless Experience Design:** - What user actions should feel completely natural and require zero thought? - Where do users currently struggle with similar products? - What interaction, if made effortless, would create delight? - What should happen automatically without user intervention? -- Where can we eliminate steps that competitors require?" +- Where can we eliminate steps that competitors require? + ### 4. Define Critical Success Moments Identify the moments that determine success or failure: -"**Critical Success Moments:** + +**Critical Success Moments:** - What's the moment where users realize 'this is better'? - When does the user feel successful or accomplished? - What interaction, if failed, would ruin the experience? - What are the make-or-break user flows? -- Where does first-time user success happen?" +- Where does first-time user success happen? + ### 5. Synthesize Experience Principles Extract guiding principles from the conversation: -"Based on our discussion, I'm hearing these core experience principles for {{project_name}}: + +Based on our discussion, I'm hearing these core experience principles for {{project_name}}: **Experience Principles:** @@ -109,7 +118,8 @@ Extract guiding principles from the conversation: - [Principle 3 based on platform considerations] - [Principle 4 based on critical success moments] -These principles will guide all our UX decisions. Do these capture what's most important?" +These principles will guide all our UX decisions. Do these capture what's most important? + ### 6. Generate Core Experience Content @@ -146,16 +156,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated core experience content and present choices: -"I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions. + +I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine the core experience definition [P] Party Mode - Bring different perspectives on the user experience -[C] Continue - Save this to the document and move to emotional response definition" +[C] Continue - Save this to the document and move to emotional response definition + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md index 247a61e2..92246bb8 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md @@ -51,7 +51,8 @@ Define the desired emotional responses users should feel when using the product. ### 1. Explore Core Emotional Goals Start by understanding the emotional objectives: -"Now let's think about how {{project_name}} should make users feel. + +Now let's think about how {{project_name}} should make users feel. **Emotional Response Questions:** @@ -60,23 +61,27 @@ Start by understanding the emotional objectives: - How should users feel after accomplishing their primary goal? - What feeling differentiates this from competitors? -Common emotional goals: Empowered and in control? Delighted and surprised? Efficient and productive? Creative and inspired? Calm and focused? Connected and engaged?" +Common emotional goals: Empowered and in control? Delighted and surprised? Efficient and productive? Creative and inspired? Calm and focused? Connected and engaged? + ### 2. Identify Emotional Journey Mapping Explore feelings at different stages: -"**Emotional Journey Considerations:** + +**Emotional Journey Considerations:** - How should users feel when they first discover the product? - What emotion during the core experience/action? - How should they feel after completing their task? - What if something goes wrong - what emotional response do we want? -- How should they feel when returning to use it again?" +- How should they feel when returning to use it again? + ### 3. Define Micro-Emotions Surface subtle but important emotional states: -"**Micro-Emotions to Consider:** + +**Micro-Emotions to Consider:** - Confidence vs. Confusion - Trust vs. Skepticism @@ -85,12 +90,14 @@ Surface subtle but important emotional states: - Delight vs. Satisfaction - Belonging vs. Isolation -Which of these emotional states are most critical for your product's success?" +Which of these emotional states are most critical for your product's success? + ### 4. Connect Emotions to UX Decisions Link feelings to design implications: -"**Design Implications:** + +**Design Implications:** - If we want users to feel [emotional state], what UX choices support this? - What interactions might create negative emotions we want to avoid? @@ -101,18 +108,21 @@ Link feelings to design implications: - [Emotion 1] → [UX design approach] - [Emotion 2] → [UX design approach] -- [Emotion 3] → [UX design approach]" +- [Emotion 3] → [UX design approach] + ### 5. Validate Emotional Goals Check if emotional goals align with product vision: -"Let me make sure I understand the emotional vision for {{project_name}}: + +Let me make sure I understand the emotional vision for {{project_name}}: **Primary Emotional Goal:** [Summarize main emotional response] **Secondary Feelings:** [List supporting emotional states] **Emotions to Avoid:** [List negative emotions to prevent] -Does this capture the emotional experience you want to create? Any adjustments needed?" +Does this capture the emotional experience you want to create? Any adjustments needed? + ### 6. Generate Emotional Response Content @@ -149,16 +159,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated emotional response content and present choices: -"I've defined the desired emotional responses for {{project_name}}. These emotional goals will guide our design decisions to create the right user experience. + +I've defined the desired emotional responses for {{project_name}}. These emotional goals will guide our design decisions to create the right user experience. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine the emotional response definition [P] Party Mode - Bring different perspectives on user emotional needs -[C] Continue - Save this to the document and move to inspiration analysis" +[C] Continue - Save this to the document and move to inspiration analysis + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md index 87fe5603..7ab96ac4 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md @@ -51,7 +51,8 @@ Analyze inspiring products and UX patterns to inform design decisions for the cu ### 1. Identify User's Favorite Apps Start by gathering inspiration sources: -"Let's learn from products your users already love and use regularly. + +Let's learn from products your users already love and use regularly. **Inspiration Questions:** @@ -60,12 +61,14 @@ Start by gathering inspiration sources: - What makes the experience compelling or delightful? - What keeps users coming back to these apps? -Think about apps in your category or even unrelated products that have great UX." +Think about apps in your category or even unrelated products that have great UX. + ### 2. Analyze UX Patterns and Principles Break down what makes these apps successful: -"For each inspiring app, let's analyze their UX success: + +For each inspiring app, let's analyze their UX success: **For [App Name]:** @@ -74,12 +77,14 @@ Break down what makes these apps successful: - How do they handle navigation and information hierarchy? - What are their most innovative or delightful interactions? - What visual design choices support the user experience? -- How do they handle errors or edge cases?" +- How do they handle errors or edge cases? + ### 3. Extract Transferable Patterns Identify patterns that could apply to your project: -"**Transferable UX Patterns:** + +**Transferable UX Patterns:** Looking across these inspiring apps, I see patterns we could adapt: **Navigation Patterns:** @@ -97,24 +102,28 @@ Looking across these inspiring apps, I see patterns we could adapt: - [Pattern 1] - supports your [emotional goal] - [Pattern 2] - aligns with your [platform requirements] -Which of these patterns resonate most for your product?" +Which of these patterns resonate most for your product? + ### 4. Identify Anti-Patterns to Avoid Surface what not to do based on analysis: -"**UX Anti-Patterns to Avoid:** + +**UX Anti-Patterns to Avoid:** From analyzing both successes and failures in your space, here are patterns to avoid: - [Anti-pattern 1] - users find this confusing/frustrating - [Anti-pattern 2] - this creates unnecessary friction - [Anti-pattern 3] - doesn't align with your [emotional goals] -Learning from others' mistakes is as important as learning from their successes." +Learning from others' mistakes is as important as learning from their successes. + ### 5. Define Design Inspiration Strategy Create a clear strategy for using this inspiration: -"**Design Inspiration Strategy:** + +**Design Inspiration Strategy:** **What to Adopt:** @@ -131,7 +140,8 @@ Create a clear strategy for using this inspiration: - [Specific anti-pattern] - conflicts with [your goals] - [Specific anti-pattern] - doesn't fit [your platform] -This strategy will guide our design decisions while keeping {{project_name}} unique." +This strategy will guide our design decisions while keeping {{project_name}} unique. + ### 6. Generate Inspiration Analysis Content @@ -164,16 +174,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated inspiration analysis content and present choices: -"I've analyzed inspiring UX patterns and products to inform our design strategy for {{project_name}}. This gives us a solid foundation of proven patterns to build upon. + +I've analyzed inspiring UX patterns and products to inform our design strategy for {{project_name}}. This gives us a solid foundation of proven patterns to build upon. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's deepen our UX pattern analysis [P] Party Mode - Bring different perspectives on inspiration sources -[C] Continue - Save this to the document and move to design system choice" +[C] Continue - Save this to the document and move to design system choice + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md index 70d566ad..4ffdae0a 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md @@ -51,7 +51,8 @@ Choose appropriate design system approach based on project requirements and cons ### 1. Present Design System Options Educate about design system approaches: -"For {{project_name}}, we need to choose a design system foundation. Think of design systems like LEGO blocks for UI - they provide proven components and patterns, ensuring consistency and speeding development. + +For {{project_name}}, we need to choose a design system foundation. Think of design systems like LEGO blocks for UI - they provide proven components and patterns, ensuring consistency and speeding development. **Design System Approaches:** @@ -76,12 +77,14 @@ Educate about design system approaches: - Moderate learning curve - Good balance of speed and uniqueness -Which direction feels right for your project?" +Which direction feels right for your project? + ### 2. Analyze Project Requirements Guide decision based on project context: -"**Let's consider your specific needs:** + +**Let's consider your specific needs:** **Based on our previous conversations:** @@ -97,12 +100,14 @@ Guide decision based on project context: - Brand guidelines or existing visual identity - Team's design expertise - Long-term maintenance considerations -- Integration requirements with existing systems" +- Integration requirements with existing systems + ### 3. Explore Specific Design System Options Dive deeper into relevant options: -"**Recommended Options Based on Your Needs:** + +**Recommended Options Based on Your Needs:** **For [Your Platform Type]:** @@ -117,12 +122,14 @@ Dive deeper into relevant options: - Customization capabilities - Accessibility compliance - Performance characteristics -- Learning curve for your team" +- Learning curve for your team + ### 4. Facilitate Decision Process Help user make informed choice: -"**Decision Framework:** + +**Decision Framework:** 1. What's most important: Speed, uniqueness, or balance? 2. How much design expertise does your team have? @@ -130,12 +137,14 @@ Help user make informed choice: 4. What's your timeline and budget? 5. Long-term maintenance needs? -Let's evaluate options based on your answers to these questions." +Let's evaluate options based on your answers to these questions. + ### 5. Finalize Design System Choice Confirm and document the decision: -"Based on our analysis, I recommend [Design System Choice] for {{project_name}}. + +Based on our analysis, I recommend [Design System Choice] for {{project_name}}. **Rationale:** @@ -149,7 +158,8 @@ Confirm and document the decision: - Define component strategy for custom components needed - Establish design tokens and patterns -Does this design system choice feel right to you?" +Does this design system choice feel right to you? + ### 6. Generate Design System Content @@ -182,16 +192,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated design system content and present choices: -"I've documented our design system choice for {{project_name}}. This foundation will ensure consistency and speed up development. + +I've documented our design system choice for {{project_name}}. This foundation will ensure consistency and speed up development. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our design system decision [P] Party Mode - Bring technical perspectives on design systems [C] Continue - Save this to the document and move to defining experience + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md index 7e904b94..7d4cd600 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md @@ -51,7 +51,8 @@ Define the core interaction that, if nailed, makes everything else follow in the ### 1. Identify the Defining Experience Focus on the core interaction: -"Every successful product has a defining experience - the core interaction that, if we nail it, everything else follows. + +Every successful product has a defining experience - the core interaction that, if we nail it, everything else follows. **Think about these famous examples:** @@ -63,12 +64,14 @@ Focus on the core interaction: **For {{project_name}}:** What's the core action that users will describe to their friends? What's the interaction that makes users feel successful? -If we get ONE thing perfectly right, what should it be?" +If we get ONE thing perfectly right, what should it be? + ### 2. Explore the User's Mental Model Understand how users think about the core task: -"**User Mental Model Questions:** + +**User Mental Model Questions:** - How do users currently solve this problem? - What mental model do they bring to this task? @@ -79,12 +82,14 @@ Understand how users think about the core task: - What do users love/hate about existing approaches? - What shortcuts or workarounds do they use? -- What makes existing solutions feel magical or terrible?" +- What makes existing solutions feel magical or terrible? + ### 3. Define Success Criteria for Core Experience Establish what makes the core interaction successful: -"**Core Experience Success Criteria:** + +**Core Experience Success Criteria:** - What makes users say 'this just works'? - When do they feel smart or accomplished? @@ -96,12 +101,14 @@ Establish what makes the core interaction successful: - [Success indicator 1] - [Success indicator 2] -- [Success indicator 3]" +- [Success indicator 3] + ### 4. Identify Novel vs. Established Patterns Determine if we need to innovate or can use proven patterns: -"**Pattern Analysis:** + +**Pattern Analysis:** Looking at your core experience, does this: - Use established UX patterns that users already understand? @@ -118,12 +125,14 @@ Looking at your core experience, does this: - Which proven patterns should we adopt? - How can we innovate within familiar patterns? -- What's our unique twist on established interactions?" +- What's our unique twist on established interactions? + ### 5. Define Experience Mechanics Break down the core interaction into details: -"**Core Experience Mechanics:** + +**Core Experience Mechanics:** Let's design the step-by-step flow for [defining experience]: **1. Initiation:** @@ -147,7 +156,8 @@ Let's design the step-by-step flow for [defining experience]: - How do users know they're done? - What's the successful outcome? -- What's next?" +- What's next? + ### 6. Generate Defining Experience Content @@ -184,16 +194,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated defining experience content and present choices: -"I've defined the core experience for {{project_name}} - the interaction that will make users love this product. + +I've defined the core experience for {{project_name}} - the interaction that will make users love this product. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine the core experience definition [P] Party Mode - Bring different perspectives on the defining interaction [C] Continue - Save this to the document and move to visual foundation + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md index bd764a60..7a91d600 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md @@ -51,24 +51,29 @@ Establish the visual design foundation including color themes, typography, and s ### 1. Brand Guidelines Assessment Check for existing brand requirements: -"Do you have existing brand guidelines or a specific color palette I should follow? (y/n) + +Do you have existing brand guidelines or a specific color palette I should follow? (y/n) If yes, I'll extract and document your brand colors and create semantic color mappings. -If no, I'll generate theme options based on your project's personality and emotional goals from our earlier discussion." +If no, I'll generate theme options based on your project's personality and emotional goals from our earlier discussion. + ### 2. Generate Color Theme Options (If no brand guidelines) Create visual exploration opportunities: -"If no existing brand guidelines, I'll create a color theme visualizer to help you explore options. + +If no existing brand guidelines, I'll create a color theme visualizer to help you explore options. 🎨 I can generate comprehensive HTML color theme visualizers with multiple theme options, complete UI examples, and the ability to see how colors work in real interface contexts. -This will help you make an informed decision about the visual direction for {{project_name}}." +This will help you make an informed decision about the visual direction for {{project_name}}. + ### 3. Define Typography System Establish the typographic foundation: -"**Typography Questions:** + +**Typography Questions:** - What should the overall tone feel like? (Professional, friendly, modern, classic?) - How much text content will users read? (Headings only? Long-form content?) @@ -80,12 +85,14 @@ Establish the typographic foundation: - Choose primary and secondary typefaces - Establish type scale (h1, h2, h3, body, etc.) - Define line heights and spacing relationships -- Consider readability and accessibility" +- Consider readability and accessibility + ### 4. Establish Spacing and Layout Foundation Define the structural foundation: -"**Spacing and Layout Foundation:** + +**Spacing and Layout Foundation:** - How should the overall layout feel? (Dense and efficient? Airy and spacious?) - What spacing unit should we use? (4px, 8px, 12px base?) @@ -96,12 +103,14 @@ Define the structural foundation: - [Layout principle 1 based on product type] - [Layout principle 2 based on user needs] -- [Layout principle 3 based on platform requirements]" +- [Layout principle 3 based on platform requirements] + ### 5. Create Visual Foundation Strategy Synthesize all visual decisions: -"**Visual Foundation Strategy:** + +**Visual Foundation Strategy:** **Color System:** @@ -121,7 +130,8 @@ Synthesize all visual decisions: - Grid system approach - Component spacing relationships -This foundation will ensure consistency across all our design decisions." +This foundation will ensure consistency across all our design decisions. + ### 6. Generate Visual Foundation Content @@ -154,16 +164,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated visual foundation content and present choices: -"I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design. + +I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our visual foundation [P] Party Mode - Bring design perspectives on visual choices [C] Continue - Save this to the document and move to design directions + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md index a50ed503..f4f894ae 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md @@ -51,7 +51,8 @@ Generate comprehensive design direction mockups showing different visual approac ### 1. Generate Design Direction Variations Create diverse visual explorations: -"I'll generate 6-8 different design direction variations exploring: + +I'll generate 6-8 different design direction variations exploring: - Different layout approaches and information hierarchy - Various interaction patterns and visual weights @@ -59,12 +60,14 @@ Create diverse visual explorations: - Different density and spacing approaches - Various navigation and component arrangements -Each mockup will show a complete vision for {{project_name}} with all our design decisions applied." +Each mockup will show a complete vision for {{project_name}} with all our design decisions applied. + ### 2. Create HTML Design Direction Showcase Generate interactive visual exploration: -"🎨 Design Direction Mockups Generated! + +🎨 Design Direction Mockups Generated! I'm creating a comprehensive HTML design direction showcase at `{planning_artifacts}/ux-design-directions.html` @@ -76,12 +79,14 @@ I'm creating a comprehensive HTML design direction showcase at `{planning_artifa - Complete UI examples with real content - Responsive behavior demonstrations -Each mockup represents a complete visual direction for your app's look and feel." +Each mockup represents a complete visual direction for your app's look and feel. + ### 3. Present Design Exploration Framework Guide evaluation criteria: -"As you explore the design directions, look for: + +As you explore the design directions, look for: ✅ **Layout Intuitiveness** - Which information hierarchy matches your priorities? ✅ **Interaction Style** - Which interaction style fits your core experience? @@ -90,12 +95,14 @@ Guide evaluation criteria: ✅ **Component Usage** - How well do the components support your user journeys? ✅ **Brand Alignment** - Which direction best supports your emotional goals? -Take your time exploring - this is a crucial decision that will guide all our design work!" +Take your time exploring - this is a crucial decision that will guide all our design work! + ### 4. Facilitate Design Direction Selection Help user choose or combine elements: -"After exploring all the design directions: + +After exploring all the design directions: **Which approach resonates most with you?** @@ -109,19 +116,22 @@ Help user choose or combine elements: - Which layout feels most intuitive for your users? - Which visual weight matches your brand personality? - Which interaction style supports your core experience? -- Are there elements from different directions you'd like to combine?" +- Are there elements from different directions you'd like to combine? + ### 5. Document Design Direction Decision Capture the chosen approach: -"Based on your exploration, I'm understanding your design direction preference: + +Based on your exploration, I'm understanding your design direction preference: **Chosen Direction:** [Direction number or combination] **Key Elements:** [Specific elements you liked] **Modifications Needed:** [Any changes requested] **Rationale:** [Why this direction works for your product] -This will become our design foundation moving forward. Are we ready to lock this in, or do you want to explore variations?" +This will become our design foundation moving forward. Are we ready to lock this in, or do you want to explore variations? + ### 6. Generate Design Direction Content @@ -154,16 +164,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated design direction content and present choices: -"I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work. + +I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our design direction [P] Party Mode - Bring different perspectives on visual choices [C] Continue - Save this to the document and move to user journey flows + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md index 985577f0..e2d9f788 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md @@ -51,7 +51,8 @@ Design detailed user journey flows for critical user interactions. ### 1. Load PRD User Journeys as Foundation Start with user journeys already defined in the PRD: -"Great! Since we have the PRD available, let's build on the user journeys already documented there. + +Great! Since we have the PRD available, let's build on the user journeys already documented there. **Existing User Journeys from PRD:** I've already loaded these user journeys from your PRD: @@ -66,14 +67,16 @@ Looking at the PRD journeys, I need to design detailed interaction flows for: - [Critical journey 2 identified from PRD narratives] - [Critical journey 3 identified from PRD narratives] -The PRD gave us the stories - now we design the mechanics!" +The PRD gave us the stories - now we design the mechanics! + ### 2. Design Each Journey Flow For each critical journey, design detailed flow: **For [Journey Name]:** -"Let's design the flow for users accomplishing [journey goal]. + +Let's design the flow for users accomplishing [journey goal]. **Flow Design Questions:** @@ -83,12 +86,14 @@ For each critical journey, design detailed flow: - How do they know they're progressing successfully? - What does success look like for this journey? - Where might they get confused or stuck? -- How do they recover from errors?" +- How do they recover from errors? + ### 3. Create Flow Diagrams Visualize each journey with Mermaid diagrams: -"I'll create detailed flow diagrams for each journey showing: + +I'll create detailed flow diagrams for each journey showing: **[Journey Name] Flow:** @@ -98,12 +103,14 @@ Visualize each journey with Mermaid diagrams: - Error recovery mechanisms - Progressive disclosure of information -Each diagram will map the complete user experience from start to finish." +Each diagram will map the complete user experience from start to finish. + ### 4. Optimize for Efficiency and Delight Refine flows for optimal user experience: -"**Flow Optimization:** + +**Flow Optimization:** For each journey, let's ensure we're: - Minimizing steps to value (getting users to success quickly) @@ -116,12 +123,14 @@ For each journey, let's ensure we're: - [Optimization 1 for journey efficiency] - [Optimization 2 for user delight] -- [Optimization 3 for error handling]" +- [Optimization 3 for error handling] + ### 5. Document Journey Patterns Extract reusable patterns across journeys: -"**Journey Patterns:** + +**Journey Patterns:** Across these flows, I'm seeing some common patterns we can standardize: **Navigation Patterns:** @@ -139,7 +148,8 @@ Across these flows, I'm seeing some common patterns we can standardize: - [Feedback pattern 1] - [Feedback pattern 2] -These patterns will ensure consistency across all user experiences." +These patterns will ensure consistency across all user experiences. + ### 6. Generate User Journey Content @@ -172,16 +182,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated user journey content and present choices: -"I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction. + +I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our user journey designs [P] Party Mode - Bring different perspectives on user flows [C] Continue - Save this to the document and move to component strategy + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md index deef19b7..db4e19bb 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md @@ -51,7 +51,8 @@ Define component library strategy and design custom components not covered by th ### 1. Analyze Design System Coverage Review what components are available vs. needed: -"Based on our chosen design system [design system from step 6], let's identify what components are already available and what we need to create custom. + +Based on our chosen design system [design system from step 6], let's identify what components are already available and what we need to create custom. **Available from Design System:** [List of components available in chosen design system] @@ -66,14 +67,16 @@ Looking at our user journeys and design direction, we need: **Gap Analysis:** - [Gap 1 - needed but not available] -- [Gap 2 - needed but not available]" +- [Gap 2 - needed but not available] + ### 2. Design Custom Components For each custom component needed, design thoroughly: **For each custom component:** -"**[Component Name] Design:** + +**[Component Name] Design:** **Purpose:** What does this component do for users? **Content:** What information or data does it display? @@ -82,7 +85,8 @@ For each custom component needed, design thoroughly: **Variants:** Are there different sizes or styles needed? **Accessibility:** What ARIA labels and keyboard support needed? -Let's walk through each custom component systematically." +Let's walk through each custom component systematically. + ### 3. Document Component Specifications @@ -106,7 +110,8 @@ Create detailed specifications for each component: ### 4. Define Component Strategy Establish overall component library approach: -"**Component Strategy:** + +**Component Strategy:** **Foundation Components:** (from design system) @@ -123,12 +128,14 @@ Establish overall component library approach: - Build custom components using design system tokens - Ensure consistency with established patterns - Follow accessibility best practices -- Create reusable patterns for common use cases" +- Create reusable patterns for common use cases + ### 5. Plan Implementation Roadmap Define how and when to build components: -"**Implementation Roadmap:** + +**Implementation Roadmap:** **Phase 1 - Core Components:** @@ -145,7 +152,8 @@ Define how and when to build components: - [Component 5] - optimizes [user journey] - [Component 6] - adds [special feature] -This roadmap helps prioritize development based on user journey criticality." +This roadmap helps prioritize development based on user journey criticality. + ### 6. Generate Component Strategy Content @@ -178,16 +186,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated component strategy content and present choices: -"I've defined the component strategy for {{project_name}}. This balances using proven design system components with custom components for your unique needs. + +I've defined the component strategy for {{project_name}}. This balances using proven design system components with custom components for your unique needs. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our component strategy [P] Party Mode - Bring technical perspectives on component design [C] Continue - Save this to the document and move to UX patterns + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md index 4708b52a..e212796a 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md @@ -51,7 +51,8 @@ Establish UX consistency patterns for common situations like buttons, forms, nav ### 1. Identify Pattern Categories Determine which patterns need definition for your product: -"Let's establish consistency patterns for how {{project_name}} behaves in common situations. + +Let's establish consistency patterns for how {{project_name}} behaves in common situations. **Pattern Categories to Define:** @@ -63,14 +64,16 @@ Determine which patterns need definition for your product: - Empty states and loading states - Search and filtering patterns -Which categories are most critical for your product? We can go through each thoroughly or focus on the most important ones." +Which categories are most critical for your product? We can go through each thoroughly or focus on the most important ones. + ### 2. Define Critical Patterns First Focus on patterns most relevant to your product: **For [Critical Pattern Category]:** -"**[Pattern Type] Patterns:** + +**[Pattern Type] Patterns:** What should users see/do when they need to [pattern action]? **Considerations:** @@ -86,7 +89,8 @@ What should users see/do when they need to [pattern action]? - [Example 1 for this pattern type] - [Example 2 for this pattern type] -How should {{project_name}} handle [pattern type] interactions?" +How should {{project_name}} handle [pattern type] interactions? + ### 3. Establish Pattern Guidelines @@ -108,7 +112,8 @@ Document specific design decisions: ### 4. Design System Integration Ensure patterns work with chosen design system: -"**Integration with [Design System]:** + +**Integration with [Design System]:** - How do these patterns complement our design system components? - What customizations are needed? @@ -118,7 +123,8 @@ Ensure patterns work with chosen design system: - [Custom rule 1] - [Custom rule 2] -- [Custom rule 3]" +- [Custom rule 3] + ### 5. Create Pattern Documentation @@ -167,16 +173,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated UX patterns content and present choices: -"I've established UX consistency patterns for {{project_name}}. These patterns ensure users have a consistent, predictable experience across all interactions. + +I've established UX consistency patterns for {{project_name}}. These patterns ensure users have a consistent, predictable experience across all interactions. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our UX patterns [P] Party Mode - Bring different perspectives on consistency patterns [C] Continue - Save this to the document and move to responsive design + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md index 80b81d4c..752241e1 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md @@ -51,7 +51,8 @@ Define responsive design strategy and accessibility requirements for the product ### 1. Define Responsive Strategy Establish how the design adapts across devices: -"Let's define how {{project_name}} adapts across different screen sizes and devices. + +Let's define how {{project_name}} adapts across different screen sizes and devices. **Responsive Design Questions:** @@ -71,12 +72,14 @@ Establish how the design adapts across devices: - Bottom navigation or hamburger menu? - How do layouts collapse on small screens? -- What's the most critical information to show mobile-first?" +- What's the most critical information to show mobile-first? + ### 2. Establish Breakpoint Strategy Define when and how layouts change: -"**Breakpoint Strategy:** + +**Breakpoint Strategy:** We need to define screen size breakpoints where layouts adapt. **Common Breakpoints:** @@ -89,12 +92,14 @@ We need to define screen size breakpoints where layouts adapt. - Use standard breakpoints or custom ones? - Focus on mobile-first or desktop-first design? -- Have specific breakpoints for your key use cases?" +- Have specific breakpoints for your key use cases? + ### 3. Design Accessibility Strategy Define accessibility requirements and compliance level: -"**Accessibility Strategy:** + +**Accessibility Strategy:** What level of WCAG compliance does {{project_name}} need? **WCAG Levels:** @@ -113,12 +118,14 @@ What level of WCAG compliance does {{project_name}} need? - Keyboard navigation support - Screen reader compatibility - Touch target sizes (minimum 44x44px) -- Focus indicators and skip links" +- Focus indicators and skip links + ### 4. Define Testing Strategy Plan how to ensure responsive design and accessibility: -"**Testing Strategy:** + +**Testing Strategy:** **Responsive Testing:** @@ -137,12 +144,14 @@ Plan how to ensure responsive design and accessibility: - Include users with disabilities in testing - Test with diverse assistive technologies -- Validate with actual target devices" +- Validate with actual target devices + ### 5. Document Implementation Guidelines Create specific guidelines for developers: -"**Implementation Guidelines:** + +**Implementation Guidelines:** **Responsive Development:** @@ -157,7 +166,8 @@ Create specific guidelines for developers: - ARIA labels and roles - Keyboard navigation implementation - Focus management and skip links -- High contrast mode support" +- High contrast mode support + ### 6. Generate Responsive & Accessibility Content @@ -194,16 +204,20 @@ When saving to document, append these Level 2 and Level 3 sections: ### 7. Present Content and Menu Show the generated responsive and accessibility content and present choices: -"I've defined the responsive design and accessibility strategy for {{project_name}}. This ensures your product works beautifully across all devices and is accessible to all users. + +I've defined the responsive design and accessibility strategy for {{project_name}}. This ensures your product works beautifully across all devices and is accessible to all users. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Let's refine our responsive/accessibility strategy [P] Party Mode - Bring different perspectives on inclusive design [C] Continue - Save this to the document and complete the workflow + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md index fe784788..a1044e9c 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md @@ -44,7 +44,8 @@ Complete the UX design workflow, update status files, and suggest next steps for ### 1. Announce Workflow Completion Inform user that the UX design is complete: -"🎉 **UX Design Complete, {{user_name}}!** + +🎉 **UX Design Complete, {{user_name}}!** I've successfully collaborated with you to create a comprehensive UX design specification for {{project_name}}. @@ -69,7 +70,8 @@ I've successfully collaborated with you to create a comprehensive UX design spec - Color themes visualizer: `{planning_artifacts}/ux-color-themes.html` - Design directions mockups: `{planning_artifacts}/ux-design-directions.html` -This specification is now ready to guide visual design, implementation, and development." +This specification is now ready to guide visual design, implementation, and development. + ### 2. Workflow Status Update diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md index fccb7da2..26215949 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md @@ -54,14 +54,16 @@ To discover, inventory, and organize all project documents, identifying duplicat ### 1. Initialize Document Discovery -"Beginning **Document Discovery** to inventory all project files. + +Beginning **Document Discovery** to inventory all project files. I will: 1. Search for all required documents (PRD, Architecture, Epics, UX) 2. Group sharded documents together 3. Identify any duplicates (whole + sharded versions) -4. Present findings for your confirmation" +4. Present findings for your confirmation + ### 2. Document Search Patterns @@ -133,7 +135,8 @@ Initialize {outputFile} with {templateFile}. ### 6. Present Findings and Get Confirmation Display findings and ask: -"**Document Discovery Complete** + +**Document Discovery Complete** [Show organized file list] @@ -147,11 +150,14 @@ Display findings and ask: - If duplicates exist: Please remove/rename one version - Confirm which documents to use for assessment -**Ready to proceed?** [C] Continue after resolving issues" +**Ready to proceed?** [C] Continue after resolving issues + ### 7. Present MENU OPTIONS -Display: **Select an Option:** [C] Continue to File Validation + +**Select an Option:** [C] Continue to File Validation + #### EXECUTION RULES: diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md index 5dd08705..66e0b407 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md @@ -54,7 +54,8 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun ### 1. Initialize PRD Analysis -"Beginning **PRD Analysis** to extract all requirements. + +Beginning **PRD Analysis** to extract all requirements. I will: @@ -62,7 +63,8 @@ I will: 2. Read it completely and thoroughly 3. Extract ALL Functional Requirements (FRs) 4. Extract ALL Non-Functional Requirements (NFRs) -5. Document findings for coverage validation" +5. Document findings for coverage validation + ### 2. Load and Read PRD diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md index 981a5b63..4343f3cb 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md @@ -53,14 +53,16 @@ To validate that all Functional Requirements from the PRD are captured in the ep ### 1. Initialize Coverage Validation -"Beginning **Epic Coverage Validation**. + +Beginning **Epic Coverage Validation**. I will: 1. Load the epics and stories document 2. Extract FR coverage information 3. Compare against PRD FRs from previous step -4. Identify any FRs not covered in epics" +4. Identify any FRs not covered in epics + ### 2. Load Epics Document diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md index 33aad045..107c5730 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md @@ -53,13 +53,15 @@ To check if UX documentation exists and validate that it aligns with PRD require ### 1. Initialize UX Validation -"Beginning **UX Alignment** validation. + +Beginning **UX Alignment** validation. I will: 1. Check if UX documentation exists 2. If UX exists: validate alignment with PRD and Architecture -3. If no UX: determine if UX is implied and document warning" +3. If no UX: determine if UX is implied and document warning + ### 2. Search for UX Documentation diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md index 0203cdc1..0ab81a68 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md @@ -55,7 +55,8 @@ To validate epics and stories against the best practices defined in create-epics ### 1. Initialize Best Practices Validation -"Beginning **Epic Quality Review** against create-epics-and-stories standards. + +Beginning **Epic Quality Review** against create-epics-and-stories standards. I will rigorously validate: @@ -64,7 +65,8 @@ I will rigorously validate: - Story dependencies (no forward references) - Proper story sizing and completeness -Any deviation from best practices will be flagged as a defect." +Any deviation from best practices will be flagged as a defect. + ### 2. Epic Structure Validation diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md index cc826ee9..afd8208c 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md @@ -52,14 +52,16 @@ To provide a comprehensive summary of all findings and give the report a final p ### 1. Initialize Final Assessment -"Completing **Final Assessment**. + +Completing **Final Assessment**. I will now: 1. Review all findings from previous steps 2. Provide a comprehensive summary 3. Add specific recommendations -4. Determine overall readiness status" +4. Determine overall readiness status + ### 2. Review Previous Findings @@ -104,12 +106,13 @@ This assessment identified [X] issues across [Y] categories. Address the critica ### 5. Present Completion -Display: -"**Implementation Readiness Assessment Complete** + +**Implementation Readiness Assessment Complete** Report generated: {outputFile} -The assessment found [number] issues requiring attention. Review the detailed report for specific findings and recommendations." +The assessment found [number] issues requiring attention. Review the detailed report for specific findings and recommendations. + ## WORKFLOW COMPLETE diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md index 93a83c70..fbc2c9b3 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md @@ -108,7 +108,8 @@ Complete setup and report to user: **Input Documents Discovered:** Report what was found: -"Welcome {{user_name}}! I've set up your Architecture workspace for {{project_name}}. + +Welcome {{user_name}}! I've set up your Architecture workspace for {{project_name}}. **Documents Found:** @@ -123,6 +124,7 @@ Report what was found: Ready to begin architectural decision making. Do you have any other documents you'd like me to include? [C] Continue to project context analysis + ## SUCCESS METRICS: diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md index 6e800e7f..805ba468 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md @@ -55,7 +55,8 @@ Read the existing architecture document completely and analyze: Show the user their current progress: -"Welcome back {{user_name}}! I found your Architecture work for {{project_name}}. + +Welcome back {{user_name}}! I found your Architecture work for {{project_name}}. **Current Progress:** @@ -77,7 +78,7 @@ Show the user their current progress: [C] Continue to next logical step [O] Overview of all remaining steps [X] Start over (will overwrite existing work) -" + ### 3. Handle User Choice diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md index 1e9c6b9a..ed2f1624 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md @@ -94,7 +94,8 @@ Calculate and present project complexity: Present your analysis back to user for validation: -"I'm reviewing your project documentation for {{project_name}}. + +I'm reviewing your project documentation for {{project_name}}. {if_epics_loaded}I see {{epic_count}} epics with {{story_count}} total stories.{/if_epics_loaded} {if_no_epics}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{/if_no_epics} @@ -116,7 +117,8 @@ Present your analysis back to user for validation: This analysis will help me guide you through the architectural decisions needed to ensure AI agents implement this consistently. -Does this match your understanding of the project scope and requirements?" +Does this match your understanding of the project scope and requirements? + ### 4. Generate Project Context Content @@ -155,16 +157,20 @@ Prepare the content to append to the document: Show the generated content and present choices: -"I've drafted the Project Context Analysis based on your requirements. This sets the foundation for our architectural decisions. + +I've drafted the Project Context Analysis based on your requirements. This sets the foundation for our architectural decisions. **Here's what I'll add to the document:** + [Show the complete markdown content from step 4] + **What would you like to do?** [A] Advanced Elicitation - Let's dive deeper into architectural implications [P] Party Mode - Bring different perspectives to analyze requirements -[C] Continue - Save this analysis and begin architectural decisions" +[C] Continue - Save this analysis and begin architectural decisions + ### 6. Handle Menu Selection diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md index bccea19d..37f4fd22 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md @@ -53,7 +53,8 @@ Discover technical preferences and evaluate starter template options, leveraging ### 0. Check Technical Preferences & Context **Check Project Context for Existing Technical Preferences:** -"Before we dive into starter templates, let me check if you have any technical preferences already documented. + +Before we dive into starter templates, let me check if you have any technical preferences already documented. {{if_project_context_exists}} I found some technical rules in your project context file: @@ -68,10 +69,12 @@ I found some technical rules in your project context file: {{else}} No existing technical preferences found in project context file. We'll establish your technical preferences now. -{{/if_project_context}}" +{{/if_project_context}} + **Discover User Technical Preferences:** -"Based on your project context, let's discuss your technical preferences: + +Based on your project context, let's discuss your technical preferences: {{primary_technology_category}} Preferences: @@ -94,7 +97,8 @@ No existing technical preferences found in project context file. We'll establish - Any existing systems or APIs you need to integrate with? - Third-party services you plan to use (payment, authentication, analytics, etc.)? -These preferences will help me recommend the most suitable starter templates and guide our architectural decisions." +These preferences will help me recommend the most suitable starter templates and guide our architectural decisions. + ### 1. Identify Primary Technology Domain @@ -173,28 +177,34 @@ For each viable starter option, document: Based on user skill level and project needs: **For Expert Users:** -"Found {{starter_name}} which provides: + +Found {{starter_name}} which provides: {{quick_decision_list_of_key_decisions}} -This would establish our base architecture with these technical decisions already made. Use it?" +This would establish our base architecture with these technical decisions already made. Use it? + **For Intermediate Users:** -"I found {{starter_name}}, which is a well-maintained starter for {{project_type}} projects. + +I found {{starter_name}}, which is a well-maintained starter for {{project_type}} projects. It makes these architectural decisions for us: {{decision_list_with_explanations}} -This gives us a solid foundation following current best practices. Should we use it?" +This gives us a solid foundation following current best practices. Should we use it? + **For Beginner Users:** -"I found {{starter_name}}, which is like a pre-built foundation for your project. + +I found {{starter_name}}, which is like a pre-built foundation for your project. Think of it like buying a prefab house frame instead of cutting each board yourself. It makes these decisions for us: {{friendly_explanation_of_decisions}} -This is a great starting point that follows best practices and saves us from making dozens of small technical choices. Should we use it?" +This is a great starting point that follows best practices and saves us from making dozens of small technical choices. Should we use it? + ### 7. Get Current CLI Commands @@ -256,22 +266,24 @@ Prepare the content to append to the document: **Note:** Project initialization using this command should be the first implementation story. -``` - ### 9. Present Content and Menu Show the generated content and present choices: -"I've analyzed starter template options for {{project_type}} projects. + +I've analyzed starter template options for {{project_type}} projects. **Here's what I'll add to the document:** + [Show the complete markdown content from step 8] + **What would you like to do?** [A] Advanced Elicitation - Explore custom approaches or unconventional starters [P] Party Mode - Evaluate trade-offs from different perspectives -[C] Continue - Save this decision and move to architectural decisions" +[C] Continue - Save this decision and move to architectural decisions + ### 10. Handle Menu Selection @@ -328,4 +340,3 @@ When user selects 'C', append the content directly to the document using the str After user selects 'C' and content is saved to document, load `./step-04-decisions.md` to begin making specific architectural decisions. Remember: Do NOT proceed to step-04 until user explicitly selects 'C' from the A/P/C menu and content is saved! -``` diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md index c9f5cded..093a176a 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md @@ -55,7 +55,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech ### 1. Load Decision Framework & Check Existing Preferences **Review Technical Preferences from Step 3:** -"Based on our technical preferences discussion in step 3, let's build on those foundations: + +Based on our technical preferences discussion in step 3, let's build on those foundations: **Your Technical Preferences:** {{user_technical_preferences_from_step_3}} @@ -64,7 +65,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech {{starter_template_decisions}} **Project Context Technical Rules:** -{{project_context_technical_rules}}" +{{project_context_technical_rules}} + **Identify Remaining Decisions:** Based on technical preferences, starter template choice, and project context, identify remaining critical decisions: @@ -129,24 +131,29 @@ For each category, facilitate collaborative decision making: Based on user skill level and project context: **Expert Mode:** -"{{Decision_Category}}: {{Specific_Decision}} + +{{Decision_Category}}: {{Specific_Decision}} Options: {{concise_option_list_with_tradeoffs}} -What's your preference for this decision?" +What's your preference for this decision? + **Intermediate Mode:** -"Next decision: {{Human_Friendly_Category}} + +Next decision: {{Human_Friendly_Category}} We need to choose {{Specific_Decision}}. Common options: {{option_list_with_brief_explanations}} -For your project, I'd lean toward {{recommendation}} because {{reason}}. What are your thoughts?" +For your project, I'd lean toward {{recommendation}} because {{reason}}. What are your thoughts? + **Beginner Mode:** -"Let's talk about {{Human_Friendly_Category}}. + +Let's talk about {{Human_Friendly_Category}}. {{Educational_Context_About_Why_This_Matters}} @@ -158,7 +165,8 @@ Your main options: My suggestion: {{recommendation}} This is good for you because {{beginner_friendly_reason}}. -What feels right to you?" +What feels right to you? + **Verify Technology Versions:** If decision involves specific technology: @@ -170,7 +178,9 @@ Search the web: "{{technology}} production readiness" ``` **Get User Input:** -"What's your preference? (or 'explain more' for details)" + +What's your preference? (or 'explain more' for details) + **Handle User Response:** @@ -191,10 +201,12 @@ Search the web: "{{technology}} production readiness" After each major decision, identify related decisions: -"This choice means we'll also need to decide: + +This choice means we'll also need to decide: - {{related_decision_1}} -- {{related_decision_2}}" +- {{related_decision_2}} + ### 5. Generate Decisions Content @@ -249,16 +261,20 @@ After facilitating all decision categories, prepare the content to append: Show the generated decisions content and present choices: -"I've documented all the core architectural decisions we've made together. + +I've documented all the core architectural decisions we've made together. **Here's what I'll add to the document:** + [Show the complete markdown content from step 5] + **What would you like to do?** [A] Advanced Elicitation - Explore innovative approaches to any specific decisions [P] Party Mode - Review decisions from multiple perspectives -[C] Continue - Save these decisions and move to implementation patterns" +[C] Continue - Save these decisions and move to implementation patterns + ### 7. Handle Menu Selection diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md index cbfd99d1..e45a2cd2 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md @@ -99,23 +99,29 @@ Based on the chosen technology stack and decisions, identify where AI agents cou For each conflict category, facilitate collaborative pattern definition: **Present the Conflict Point:** -"Given that we're using {{tech_stack}}, different AI agents might handle {{conflict_area}} differently. + +Given that we're using {{tech_stack}}, different AI agents might handle {{conflict_area}} differently. For example, one agent might name database tables 'users' while another uses 'Users' - this would cause conflicts. -We need to establish consistent patterns that all agents follow." +We need to establish consistent patterns that all agents follow. + **Show Options and Trade-offs:** -"Common approaches for {{pattern_category}}: + +Common approaches for {{pattern_category}}: 1. {{option_1}} - {{pros_and_cons}} 2. {{option_2}} - {{pros_and_cons}} 3. {{option_3}} - {{pros_and_cons}} -Which approach makes the most sense for our project?" +Which approach makes the most sense for our project? + **Get User Decision:** -"What's your preference for this pattern? (or discuss the trade-offs more)" + +What's your preference for this pattern? (or discuss the trade-offs more) + ### 3. Define Pattern Categories @@ -290,16 +296,20 @@ Prepare the content to append to the document: Show the generated patterns content and present choices: -"I've documented implementation patterns that will prevent conflicts between AI agents working on this project. + +I've documented implementation patterns that will prevent conflicts between AI agents working on this project. **Here's what I'll add to the document:** + [Show the complete markdown content from step 4] + **What would you like to do?** [A] Advanced Elicitation - Explore additional consistency patterns [P] Party Mode - Review patterns from different implementation perspectives -[C] Continue - Save these patterns and move to project structure" +[C] Continue - Save these patterns and move to project structure + ### 6. Handle Menu Selection diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md index 3df89e6c..7e0a1d5e 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md @@ -55,14 +55,18 @@ Define the complete project structure and architectural boundaries based on all Map project requirements to architectural components: **From Epics (if available):** -"Epic: {{epic_name}} → Lives in {{module/directory/service}}" + +Epic: {{epic_name}} → Lives in {{module/directory/service}} + - User stories within the epic - Cross-epic dependencies - Shared components needed **From FR Categories (if no epics):** -"FR Category: {{fr_category_name}} → Lives in {{module/directory/service}}" + +FR Category: {{fr_category_name}} → Lives in {{module/directory/service}} + - Related functional requirements - Shared functionality across categories @@ -214,22 +218,26 @@ project-name/ Create explicit mapping from project requirements to specific files/directories: **Epic/Feature Mapping:** -"Epic: User Management + +Epic: User Management - Components: src/components/features/users/ - Services: src/services/users/ - API Routes: src/app/api/users/ - Database: prisma/migrations/_*users*_ -- Tests: tests/features/users/" +- Tests: tests/features/users/ + **Cross-Cutting Concerns:** -"Authentication System + +Authentication System - Components: src/components/auth/ - Services: src/services/auth/ - Middleware: src/middleware/auth.ts - Guards: src/guards/auth.guard.ts -- Tests: tests/auth/" +- Tests: tests/auth/ + ### 6. Generate Structure Content @@ -310,16 +318,20 @@ Prepare the content to append to the document: Show the generated project structure content and present choices: -"I've created a complete project structure based on all our architectural decisions. + +I've created a complete project structure based on all our architectural decisions. **Here's what I'll add to the document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Explore innovative project organization approaches [P] Party Mode - Review structure from different development perspectives -[C] Continue - Save this structure and move to architecture validation" +[C] Continue - Save this structure and move to architecture validation + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md index b2dc2c46..29472f2b 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md @@ -155,25 +155,31 @@ Identify and document any missing elements: For any issues found, facilitate resolution: **Critical Issues:** -"I found some issues that need to be addressed before implementation: + +I found some issues that need to be addressed before implementation: {{critical_issue_description}} -These could cause implementation problems. How would you like to resolve this?" +These could cause implementation problems. How would you like to resolve this? + **Important Issues:** -"I noticed a few areas that could be improved: + +I noticed a few areas that could be improved: {{important_issue_description}} -These aren't blocking, but addressing them would make implementation smoother. Should we work on these?" +These aren't blocking, but addressing them would make implementation smoother. Should we work on these? + **Minor Issues:** -"Here are some minor suggestions for improvement: + +Here are some minor suggestions for improvement: {{minor_issue_description}} -These are optional refinements. Would you like to address any of these?" +These are optional refinements. Would you like to address any of these? + ### 6. Generate Validation Content @@ -284,7 +290,8 @@ Prepare the content to append to the document: Show the validation results and present choices: -"I've completed a comprehensive validation of your architecture. + +I've completed a comprehensive validation of your architecture. **Validation Summary:** @@ -293,13 +300,16 @@ Show the validation results and present choices: - ✅ Readiness: AI agents can implement consistently **Here's what I'll add to complete the architecture document:** + [Show the complete markdown content from step 6] + **What would you like to do?** [A] Advanced Elicitation - Address any complex architectural concerns [P] Party Mode - Review validation from different implementation perspectives [C] Continue - Complete the architecture and finish workflow + ### 8. Handle Menu Selection diff --git a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md index c8d6b133..6f5e4e72 100644 --- a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +++ b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md @@ -219,7 +219,9 @@ After extraction and confirmation, update {outputFile} with: ### 10. Present MENU OPTIONS -Display: `**Confirm the Requirements are complete and correct to [C] continue:**` + +**Confirm the Requirements are complete and correct to [C] continue:** + #### EXECUTION RULES: diff --git a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md index 1b497c2a..7ed15999 100644 --- a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +++ b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md @@ -190,7 +190,9 @@ After approval, update {outputFile}: ### 8. Present MENU OPTIONS -Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md index 2e13f9b2..76037fc4 100644 --- a/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +++ b/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md @@ -140,12 +140,12 @@ For each epic in the approved epics_list: #### A. Epic Overview -Display: - + - Epic number and title - Epic goal statement - FRs covered by this epic - Any NFRs or additional requirements relevant + #### B. Story Breakdown @@ -227,7 +227,9 @@ The final {outputFile} must follow this structure exactly: After all epics and stories are complete: -Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue" + +**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue + #### Menu Handling Logic: diff --git a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md index 4ea630b1..045ac098 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md @@ -88,7 +88,9 @@ Use holistic judgment, not mechanical keyword matching. ### No Escalation (simple request) -Display: "**Select:** [P] Plan first (tech-spec) [E] Execute directly" + +**Select:** [P] Plan first (tech-spec) [E] Execute directly + #### Menu Handling Logic: @@ -104,13 +106,15 @@ Display: "**Select:** [P] Plan first (tech-spec) [E] Execute directly" ### Escalation Triggered - Level 0-2 -Present: "This looks like a focused feature with multiple components." - -Display: + +This looks like a focused feature with multiple components. + + **[P] Plan first (tech-spec)** (recommended) **[W] Seems bigger than quick-dev** - Recommend the Full BMad Flow PRD Process **[E] Execute directly** + #### Menu Handling Logic: @@ -127,13 +131,15 @@ Display: ### Escalation Triggered - Level 3+ -Present: "This sounds like platform/system work." - -Display: + +This sounds like platform/system work. + + **[W] Start BMad Method** (recommended) **[P] Plan first (tech-spec)** (lighter planning) **[E] Execute directly** - feeling lucky + #### Menu Handling Logic: diff --git a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md index 6179ebba..ec5898e9 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md @@ -74,8 +74,7 @@ If `{execution_mode}` is "tech-spec": ## IMPLEMENTATION SUMMARY -Present summary to transition to review: - + ``` **Implementation Complete!** @@ -86,6 +85,7 @@ Present summary to transition to review: Proceeding to adversarial code review... ``` + --- diff --git a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md index 4ab367c6..034a6ffa 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md @@ -25,13 +25,15 @@ From previous steps: ## RESOLUTION OPTIONS -Present: "How would you like to handle these findings?" - -Display: + +How would you like to handle these findings? + + **[W] Walk through** - Discuss each finding individually **[F] Fix automatically** - Automatically fix issues classified as "real" **[S] Skip** - Acknowledge and proceed to commit + ### Menu Handling Logic: diff --git a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md index a7cde555..6b20e36e 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md @@ -67,7 +67,9 @@ a) **Menu Handling:** a) **Greet the user briefly:** -"Hey {user_name}! What are we building today?" + +Hey {user_name}! What are we building today? + b) **Get their initial description.** Don't ask detailed questions yet - just understand enough to know where to look. @@ -150,19 +152,23 @@ a) **Create the tech-spec WIP file:** b) **Report to user:** -"Created: `{wipFile}` + +Created: `{wipFile}` **Captured:** - Title: {title} - Problem: {problem_statement_summary} -- Scope: {scope_summary}" +- Scope: {scope_summary} + ### 6. Present Checkpoint Menu a) **Display menu:** -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Deep Investigation (Step 2 of 4)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Deep Investigation (Step 2 of 4) + b) **HALT and wait for user selection.** diff --git a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md index 1b0d0cee..1afb6824 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md @@ -45,7 +45,9 @@ a) **Build on Step 1's Quick Scan** Review what was found in Step 1's orient scan. Then ask: -"Based on my quick look, I see [files/patterns found]. Are there other files or directories I should investigate deeply?" + +Based on my quick look, I see [files/patterns found]. Are there other files or directories I should investigate deeply? + b) **Read and Analyze Code** @@ -106,16 +108,20 @@ Fill in: **Report to user:** -"**Context Gathered:** + +**Context Gathered:** - Tech Stack: {tech_stack_summary} - Files to Modify: {files_count} files identified - Patterns: {patterns_summary} -- Tests: {test_patterns_summary}" +- Tests: {test_patterns_summary} + ### 4. Present Checkpoint Menu -Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Generate Spec (Step 3 of 4)" + +**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Generate Spec (Step 3 of 4) + **HALT and wait for user selection.** diff --git a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md index a223a2e4..44227845 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md @@ -31,19 +31,25 @@ wipFile: '{implementation_artifacts}/tech-spec-wip.md' **Present to user:** -"Here's your complete tech-spec. Please review:" + +Here's your complete tech-spec. Please review: + [Display the complete spec content - all sections] -"**Quick Summary:** + +**Quick Summary:** - {task_count} tasks to implement - {ac_count} acceptance criteria to verify -- {files_count} files to modify" +- {files_count} files to modify + **Present review menu:** -Display: "**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode" + +**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode + **HALT and wait for user selection.** @@ -106,7 +112,7 @@ b) **Rename WIP file to final filename:** a) **Display completion message and menu:** -``` + **Tech-Spec Complete!** Saved to: {finalFile} @@ -127,12 +133,12 @@ Once you are fully satisfied with the spec (ideally after **Adversarial Review** Copy this prompt to start dev: -\`\`\` +``` quick-dev {finalFile} -\`\`\` +``` This ensures the dev agent has clean context focused solely on implementation. -``` + b) **HALT and wait for user selection.** @@ -173,7 +179,8 @@ b) **HALT and wait for user selection.** **When user selects [D]:** -"**All done!** Your tech-spec is ready at: + +**All done!** Your tech-spec is ready at: `{finalFile}` @@ -183,7 +190,8 @@ When you're ready to implement, run: quick-dev {finalFile} ``` -Ship it!" +Ship it! + --- diff --git a/src/bmm/workflows/document-project/instructions.md b/src/bmm/workflows/document-project/instructions.md index 2f567fa3..9eff8548 100644 --- a/src/bmm/workflows/document-project/instructions.md +++ b/src/bmm/workflows/document-project/instructions.md @@ -94,7 +94,7 @@ Your choice [1/2/3]: Skip loading project-types.csv and architecture_registry.csv (not needed on resume) Store loaded doc requirements for use in remaining steps - Display: "Resuming {{workflow_mode}} from {{current_step}} with cached project type(s): {{cached_project_types}}" + Resuming {{workflow_mode}} from {{current_step}} with cached project type(s): {{cached_project_types}} Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md with resume context @@ -114,12 +114,12 @@ Your choice [1/2/3]: - Display: "Exiting workflow without changes." + Exiting workflow without changes. Exit workflow - Display: "Found old state file (>24 hours). Starting fresh scan." + Found old state file (>24 hours). Starting fresh scan. Archive old state file to: {output_folder}/.archive/project-scan-report-{{timestamp}}.json Set resume_mode = false Continue to Step 0.5 @@ -147,7 +147,7 @@ Your choice [1/2/3]: Set workflow_mode = "full_rescan" - Display: "Starting full project rescan..." + Starting full project rescan... Read fully and follow: {installed_path}/workflows/full-scan-instructions.md After sub-workflow completes, continue to Step 4 @@ -155,7 +155,7 @@ Your choice [1/2/3]: Set workflow_mode = "deep_dive" Set scan_level = "exhaustive" - Display: "Starting deep-dive documentation mode..." + Starting deep-dive documentation mode... Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md After sub-workflow completes, continue to Step 4 @@ -168,7 +168,7 @@ Your choice [1/2/3]: Set workflow_mode = "initial_scan" - Display: "No existing documentation found. Starting initial project scan..." + No existing documentation found. Starting initial project scan... Read fully and follow: {installed_path}/workflows/full-scan-instructions.md After sub-workflow completes, continue to Step 4 diff --git a/src/bmm/workflows/document-project/workflows/full-scan-instructions.md b/src/bmm/workflows/document-project/workflows/full-scan-instructions.md index 1340f75e..77b09cfd 100644 --- a/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +++ b/src/bmm/workflows/document-project/workflows/full-scan-instructions.md @@ -37,9 +37,9 @@ This workflow uses a single comprehensive CSV file to intelligently document you Load documentation-requirements.csv from: {documentation_requirements_csv} Store all 12 rows indexed by project_type_id for project detection and requirements lookup -Display: "Loaded documentation requirements for 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)" +Loaded documentation requirements for 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded) -Display: "✓ Documentation requirements loaded successfully. Ready to begin project analysis." +✓ Documentation requirements loaded successfully. Ready to begin project analysis. @@ -114,17 +114,17 @@ Your choice [1/2/3] (default: 1): Set scan_level = "quick" - Display: "Using Quick Scan (pattern-based, no source file reading)" + Using Quick Scan (pattern-based, no source file reading) Set scan_level = "deep" - Display: "Using Deep Scan (reading critical files per project type)" + Using Deep Scan (reading critical files per project type) Set scan_level = "exhaustive" - Display: "Using Exhaustive Scan (reading all source files)" + Using Exhaustive Scan (reading all source files) Initialize state file: {output_folder}/project-scan-report.json @@ -915,7 +915,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all': - Store result in {{selected_items}} array - Display: "Generating {{selected_items.length}} document(s)..." + Generating {{selected_items.length}} document(s)... For each item in {{selected_items}}: @@ -927,7 +927,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all': 2. **Route to appropriate generation substep based on doc_type:** **If doc_type == "architecture":** - - Display: "Generating architecture documentation for {{part_id}}..." + - Generating architecture documentation for {{part_id}}... - Load architecture_match for this part from state file (Step 3 cache) - Re-run Step 8 architecture generation logic ONLY for this specific part - Use matched template and fill with cached data from state file @@ -935,7 +935,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all': - Validate completeness **If doc_type == "api-contracts":** - - Display: "Generating API contracts for {{part_id}}..." + - Generating API contracts for {{part_id}}... - Load part data and documentation_requirements - Re-run Step 4 API scan substep targeting ONLY this part - Use scan_level from state file (quick/deep/exhaustive) @@ -943,35 +943,35 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all': - Validate document structure **If doc_type == "data-models":** - - Display: "Generating data models documentation for {{part_id}}..." + - Generating data models documentation for {{part_id}}... - Re-run Step 4 data models scan substep targeting ONLY this part - Use schema_migration_patterns from documentation_requirements - Generate data-models-{{part_id}}.md - Validate completeness **If doc_type == "component-inventory":** - - Display: "Generating component inventory for {{part_id}}..." + - Generating component inventory for {{part_id}}... - Re-run Step 9 component inventory generation for this specific part - Scan components/, ui/, widgets/ folders - Generate component-inventory-{{part_id}}.md - Validate structure **If doc_type == "development-guide":** - - Display: "Generating development guide for {{part_id}}..." + - Generating development guide for {{part_id}}... - Re-run Step 9 development guide generation for this specific part - Use key_file_patterns and test_file_patterns from documentation_requirements - Generate development-guide-{{part_id}}.md - Validate completeness **If doc_type == "deployment-guide":** - - Display: "Generating deployment guide..." + - Generating deployment guide... - Re-run Step 6 deployment configuration scan - Re-run Step 9 deployment guide generation - Generate deployment-guide.md - Validate structure **If doc_type == "integration-architecture":** - - Display: "Generating integration architecture..." + - Generating integration architecture... - Re-run Step 7 integration analysis for all parts - Generate integration-architecture.md - Validate completeness @@ -980,7 +980,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all': - Confirm file was written successfully - Update state file with newly generated output - Add to {{newly_generated_docs}} tracking list - - Display: "✓ Generated: {{file_path}}" + - ✓ Generated: {{file_path}} 4. **Handle errors:** - If generation fails, log error and continue with next item @@ -1101,6 +1101,6 @@ When ready to plan new features, run the PRD workflow and provide this index as - Write final state file -Display: "State file saved: {{output_folder}}/project-scan-report.json" +State file saved: {{output_folder}}/project-scan-report.json diff --git a/src/bmm/workflows/generate-project-context/steps/step-01-discover.md b/src/bmm/workflows/generate-project-context/steps/step-01-discover.md index fa36993d..ac401a91 100644 --- a/src/bmm/workflows/generate-project-context/steps/step-01-discover.md +++ b/src/bmm/workflows/generate-project-context/steps/step-01-discover.md @@ -36,7 +36,7 @@ First, check if project context already exists: - Look for file at `{project_knowledge}/project-context.md or {project-root}/**/project-context.md` - If exists: Read complete file to understand existing rules -- Present to user: "Found existing project context with {number_of_sections} sections. Would you like to update this or create a new one?" +- Found existing project context with {number_of_sections} sections. Would you like to update this or create a new one? ### 2. Discover Project Technology Stack @@ -135,7 +135,8 @@ Set frontmatter `sections_completed` to track what will be updated Report findings to user: -"Welcome {{user_name}}! I've analyzed your project for {{project_name}} to discover the context that AI agents need. + +Welcome {{user_name}}! I've analyzed your project for {{project_name}} to discover the context that AI agents need. **Technology Stack Discovered:** {{list_of_technologies_with_versions}} @@ -158,7 +159,8 @@ Report findings to user: Ready to create/update your project context. This will help AI agents implement code consistently with your project's standards. -[C] Continue to context generation" +[C] Continue to context generation + ## SUCCESS METRICS: diff --git a/src/bmm/workflows/generate-project-context/steps/step-02-generate.md b/src/bmm/workflows/generate-project-context/steps/step-02-generate.md index c2b428c5..c1fc966d 100644 --- a/src/bmm/workflows/generate-project-context/steps/step-02-generate.md +++ b/src/bmm/workflows/generate-project-context/steps/step-02-generate.md @@ -55,13 +55,16 @@ Document the exact technology stack from discovery: Based on user skill level, present findings: **Expert Mode:** -"Technology stack from your architecture and package files: + +Technology stack from your architecture and package files: {{exact_technologies_with_versions}} -Any critical version constraints I should document for agents?" +Any critical version constraints I should document for agents? + **Intermediate Mode:** -"I found your technology stack: + +I found your technology stack: **Core Technologies:** {{main_technologies_with_versions}} @@ -69,10 +72,12 @@ Any critical version constraints I should document for agents?" **Key Dependencies:** {{important_dependencies_with_versions}} -Are there any version constraints or compatibility notes agents should know about?" +Are there any version constraints or compatibility notes agents should know about? + **Beginner Mode:** -"Here are the technologies you're using: + +Here are the technologies you're using: **Main Technologies:** {{friendly_description_of_tech_stack}} @@ -80,14 +85,16 @@ Are there any version constraints or compatibility notes agents should know abou **Important Notes:** {{key_things_agents_need_to_know_about_versions}} -Should I document any special version rules or compatibility requirements?" +Should I document any special version rules or compatibility requirements? + ### 2. Language-Specific Rules Focus on unobvious language patterns agents might miss: **TypeScript/JavaScript Rules:** -"Based on your codebase, I notice some specific patterns: + +Based on your codebase, I notice some specific patterns: **Configuration Requirements:** {{typescript_config_rules}} @@ -98,7 +105,8 @@ Focus on unobvious language patterns agents might miss: **Error Handling Patterns:** {{error_handling_requirements}} -Are these patterns correct? Any other language-specific rules agents should follow?" +Are these patterns correct? Any other language-specific rules agents should follow? + **Python/Ruby/Other Language Rules:** Adapt to the actual language in use with similar focused questions. @@ -108,7 +116,8 @@ Adapt to the actual language in use with similar focused questions. Document framework-specific patterns: **React Rules (if applicable):** -"For React development, I see these patterns: + +For React development, I see these patterns: **Hooks Usage:** {{hooks_usage_patterns}} @@ -122,7 +131,8 @@ Document framework-specific patterns: **Performance Rules:** {{performance_optimization_requirements}} -Should I add any other React-specific rules?" +Should I add any other React-specific rules? + **Other Framework Rules:** Adapt for Vue, Angular, Next.js, Express, etc. @@ -132,7 +142,8 @@ Adapt for Vue, Angular, Next.js, Express, etc. Focus on testing patterns that ensure consistency: **Test Structure Rules:** -"Your testing setup shows these patterns: + +Your testing setup shows these patterns: **Test Organization:** {{test_file_organization}} @@ -146,14 +157,16 @@ Focus on testing patterns that ensure consistency: **Integration vs Unit Test Rules:** {{test_boundary_patterns}} -Are there testing rules agents should always follow?" +Are there testing rules agents should always follow? + ### 5. Code Quality & Style Rules Document critical style and quality rules: **Linting/Formatting:** -"Your code style configuration requires: + +Your code style configuration requires: **ESLint/Prettier Rules:** {{specific_linting_rules}} @@ -167,14 +180,16 @@ Document critical style and quality rules: **Documentation Requirements:** {{comment_and_documentation_patterns}} -Any additional code quality rules?" +Any additional code quality rules? + ### 6. Development Workflow Rules Document workflow patterns that affect implementation: **Git/Repository Rules:** -"Your project uses these patterns: + +Your project uses these patterns: **Branch Naming:** {{branch_naming_conventions}} @@ -188,14 +203,16 @@ Document workflow patterns that affect implementation: **Deployment Patterns:** {{deployment_considerations}} -Should I document any other workflow rules?" +Should I document any other workflow rules? + ### 7. Critical Don't-Miss Rules Identify rules that prevent common mistakes: **Anti-Patterns to Avoid:** -"Based on your codebase, here are critical things agents must NOT do: + +Based on your codebase, here are critical things agents must NOT do: {{critical_anti_patterns_with_examples}} @@ -208,7 +225,8 @@ Identify rules that prevent common mistakes: **Performance Gotchas:** {{performance_patterns_to_avoid}} -Are there other 'gotchas' agents should know about?" +Are there other 'gotchas' agents should know about? + ### 8. Generate Context Content @@ -252,16 +270,20 @@ For each category, prepare lean content for the project context file: After each category, show the generated rules and present choices: -"I've drafted the {{category_name}} rules for your project context. + +I've drafted the {{category_name}} rules for your project context. **Here's what I'll add:** + [Show the complete markdown content for this category] + **What would you like to do?** [A] Advanced Elicitation - Explore nuanced rules for this category [P] Party Mode - Review from different implementation perspectives -[C] Continue - Save these rules and move to next category" +[C] Continue - Save these rules and move to next category + ### 10. Handle Menu Selection diff --git a/src/bmm/workflows/generate-project-context/steps/step-03-complete.md b/src/bmm/workflows/generate-project-context/steps/step-03-complete.md index 85dd4db7..3e01a4c1 100644 --- a/src/bmm/workflows/generate-project-context/steps/step-03-complete.md +++ b/src/bmm/workflows/generate-project-context/steps/step-03-complete.md @@ -133,14 +133,17 @@ Last Updated: {{date}} Based on user skill level, present the completion: **Expert Mode:** -"Project context complete. Optimized for LLM consumption with {{rule_count}} critical rules across {{section_count}} sections. + +Project context complete. Optimized for LLM consumption with {{rule_count}} critical rules across {{section_count}} sections. File saved to: `{output_folder}/project-context.md` -Ready for AI agent integration." +Ready for AI agent integration. + **Intermediate Mode:** -"Your project context is complete and optimized for AI agents! + +Your project context is complete and optimized for AI agents! **What we created:** @@ -160,10 +163,12 @@ Ready for AI agent integration." - AI agents should read this file before implementing - Update as your project evolves -- Review periodically for optimization" +- Review periodically for optimization + **Beginner Mode:** -"Excellent! Your project context guide is ready! 🎉 + +Excellent! Your project context guide is ready! 🎉 **What this does:** Think of this as a 'rules of the road' guide for AI agents working on your project. It ensures they all follow the same patterns and avoid common mistakes. @@ -178,7 +183,8 @@ Think of this as a 'rules of the road' guide for AI agents working on your proje **How AI agents use it:** They read this file before writing any code, ensuring everything they create follows your project's standards perfectly. -Your project context is saved and ready to help agents implement consistently!" +Your project context is saved and ready to help agents implement consistently! + ### 5. Final File Updates @@ -225,7 +231,8 @@ Final checks before completion: Present final completion to user: -"✅ **Project Context Generation Complete!** + +✅ **Project Context Generation Complete!** Your optimized project context file is ready at: `{output_folder}/project-context.md` @@ -250,7 +257,8 @@ Your optimized project context file is ready at: 2. Update this file when your technology stack or patterns evolve 3. Review quarterly to optimize and remove outdated rules -Your project context will help ensure high-quality, consistent implementation across all development work. Great work capturing your project's critical implementation requirements!" +Your project context will help ensure high-quality, consistent implementation across all development work. Great work capturing your project's critical implementation requirements! + ## SUCCESS METRICS: diff --git a/src/core/tasks/workflow.xml b/src/core/tasks/workflow.xml index fcf6f96b..d3139b43 100644 --- a/src/core/tasks/workflow.xml +++ b/src/core/tasks/workflow.xml @@ -131,6 +131,7 @@ template-output - Save content checkpoint critical - Cannot be skipped example - Show example output + display - Present enclosed content to user verbatim (no file save, no pause) diff --git a/src/core/workflows/brainstorming/steps/step-01-session-setup.md b/src/core/workflows/brainstorming/steps/step-01-session-setup.md index 7e1cb2cd..23bda6d9 100644 --- a/src/core/workflows/brainstorming/steps/step-01-session-setup.md +++ b/src/core/workflows/brainstorming/steps/step-01-session-setup.md @@ -72,7 +72,8 @@ cp "{template_path}" "{output_folder}/brainstorming/brainstorming-session-{{date #### C. Session Context Gathering -"Welcome {{user_name}}! I'm excited to facilitate your brainstorming session. I'll guide you through proven creativity techniques to generate innovative ideas and breakthrough solutions. + +Welcome {{user_name}}! I'm excited to facilitate your brainstorming session. I'll guide you through proven creativity techniques to generate innovative ideas and breakthrough solutions. **Context Loading:** [If context_file provided, indicate context is loaded] **Context-Based Guidance:** [If context available, briefly mention focus areas] @@ -82,21 +83,25 @@ cp "{template_path}" "{output_folder}/brainstorming/brainstorming-session-{{date **Session Discovery Questions:** 1. **What are we brainstorming about?** (The central topic or challenge) -2. **What specific outcomes are you hoping for?** (Types of ideas, solutions, or insights)" +2. **What specific outcomes are you hoping for?** (Types of ideas, solutions, or insights) + #### D. Process User Responses Wait for user responses, then: **Session Analysis:** -"Based on your responses, I understand we're focusing on **[summarized topic]** with goals around **[summarized objectives]**. + + +Based on your responses, I understand we're focusing on **[summarized topic]** with goals around **[summarized objectives]**. **Session Parameters:** - **Topic Focus:** [Clear topic articulation] - **Primary Goals:** [Specific outcome objectives] -**Does this accurately capture what you want to achieve?**" +**Does this accurately capture what you want to achieve?** + #### E. Update Frontmatter and Document @@ -138,7 +143,8 @@ When user selects approach, append the session overview content directly to `{ou ### E. Continue to Technique Selection -"**Session setup complete!** I have a clear understanding of your goals and can select the perfect techniques for your brainstorming needs. + +**Session setup complete!** I have a clear understanding of your goals and can select the perfect techniques for your brainstorming needs. **Ready to explore technique approaches?** [1] User-Selected Techniques - Browse our complete technique library @@ -146,7 +152,8 @@ When user selects approach, append the session overview content directly to `{ou [3] Random Technique Selection - Discover unexpected creative methods [4] Progressive Technique Flow - Start broad, then systematically narrow focus -Which approach appeals to you most? (Enter 1-4)" +Which approach appeals to you most? (Enter 1-4) + ### 4. Handle User Selection and Initial Document Append diff --git a/src/core/workflows/brainstorming/steps/step-01b-continue.md b/src/core/workflows/brainstorming/steps/step-01b-continue.md index 23205c0d..842ec944 100644 --- a/src/core/workflows/brainstorming/steps/step-01b-continue.md +++ b/src/core/workflows/brainstorming/steps/step-01b-continue.md @@ -41,7 +41,9 @@ Load existing document and analyze current state: - Identify current stage and next logical steps **Session Status Assessment:** -"Welcome back {{user_name}}! I can see your brainstorming session on **[session_topic]** from **[date]**. + + +Welcome back {{user_name}}! I can see your brainstorming session on **[session_topic]** from **[date]**. **Current Session Status:** @@ -51,28 +53,35 @@ Load existing document and analyze current state: - **Current Stage:** [Assess where they left off] **Session Progress:** -[Brief summary of what was accomplished and what remains]" +[Brief summary of what was accomplished and what remains] + ### 2. Present Continuation Options Based on session analysis, provide appropriate options: **If Session Completed:** -"Your brainstorming session appears to be complete! + + +Your brainstorming session appears to be complete! **Options:** [1] Review Results - Go through your documented ideas and insights [2] Start New Session - Begin brainstorming on a new topic -[3) Extend Session - Add more techniques or explore new angles" +[3) Extend Session - Add more techniques or explore new angles + **If Session In Progress:** -"Let's continue where we left off! + + +Let's continue where we left off! **Current Progress:** [Description of current stage and accomplishments] **Next Steps:** -[Continue with appropriate next step based on workflow state]" +[Continue with appropriate next step based on workflow state] + ### 3. Handle User Choice diff --git a/src/core/workflows/brainstorming/steps/step-02a-user-selected.md b/src/core/workflows/brainstorming/steps/step-02a-user-selected.md index 2b523db8..32d0bcee 100644 --- a/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +++ b/src/core/workflows/brainstorming/steps/step-02a-user-selected.md @@ -34,9 +34,11 @@ Load and present brainstorming techniques from CSV, allowing user to browse and Load techniques from CSV on-demand: -"Perfect! Let's explore our complete brainstorming techniques library. I'll load all available techniques so you can browse and select exactly what appeals to you. + +Perfect! Let's explore our complete brainstorming techniques library. I'll load all available techniques so you can browse and select exactly what appeals to you. -**Loading Brain Techniques Library...**" +**Loading Brain Techniques Library...** + **Load CSV and parse:** @@ -48,7 +50,8 @@ Load techniques from CSV on-demand: Show available categories with brief descriptions: -"**Our Brainstorming Technique Library - 36+ Techniques Across 7 Categories:** + +**Our Brainstorming Technique Library - 36+ Techniques Across 7 Categories:** **[1] Structured Thinking** (6 techniques) @@ -85,7 +88,8 @@ Show available categories with brief descriptions: - Inner wisdom and authentic exploration approaches - Includes: Inner Child Conference, Shadow Work Mining, Values Archaeology -**Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.**" +**Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.** + ### 3. Handle Category Selection @@ -93,9 +97,11 @@ After user selects category: #### Load Category Techniques: -"**[Selected Category] Techniques:** + +**[Selected Category] Techniques:** -**Loading specific techniques from this category...**" +**Loading specific techniques from this category...** + **Present 3-5 techniques from selected category:** For each technique: @@ -106,7 +112,9 @@ For each technique: - Example prompt: [Sample facilitation prompt] **Example presentation format:** -"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate) + + +**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate) - Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - Best for: Product improvement, innovation challenges, systematic idea generation @@ -117,10 +125,12 @@ For each technique: - Explore problems through six distinct perspectives for comprehensive analysis - Best for: Complex decisions, team alignment, thorough exploration - Example prompt: "White hat thinking: What facts do we know for certain about this challenge?" + ### 4. Allow Technique Selection -"**Which techniques from this category appeal to you?** + +**Which techniques from this category appeal to you?** You can: @@ -135,13 +145,16 @@ You can: - [Details] for more information about any technique - [Categories] to return to category list - [Back] to return to approach selection + ### 5. Handle Technique Confirmation When user selects techniques: **Confirmation Process:** -"**Your Selected Techniques:** + + +**Your Selected Techniques:** - [Technique 1]: [Why this matches their session goals] - [Technique 2]: [Why this complements the first] @@ -152,7 +165,8 @@ This combination will take approximately [total_time] and focus on [expected out **Confirm these choices?** [C] Continue - Begin technique execution -[Back] - Modify technique selection" +[Back] - Modify technique selection + ### 6. Update Frontmatter and Continue diff --git a/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md b/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md index f928ff04..d13f6e5a 100644 --- a/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md @@ -34,7 +34,8 @@ Analyze session context and recommend optimal brainstorming techniques based on Load techniques from CSV for analysis: -"Great choice! Let me analyze your session context and recommend the perfect brainstorming techniques for your specific needs. + +Great choice! Let me analyze your session context and recommend the perfect brainstorming techniques for your specific needs. **Analyzing Your Session Goals:** @@ -43,7 +44,8 @@ Load techniques from CSV for analysis: - Constraints: [constraints] - Session Type: [session_type] -**Loading Brain Techniques Library for AI Analysis...**" +**Loading Brain Techniques Library for AI Analysis...** + **Load CSV and parse:** @@ -86,7 +88,8 @@ Analyze user's session context across multiple dimensions: Based on context analysis, create tailored recommendations: -"**My AI Analysis Results:** + +**My AI Analysis Results:** Based on your session context, I recommend this customized technique sequence: @@ -109,7 +112,8 @@ Based on your session context, I recommend this customized technique sequence: - **Expected outcome:** [How this leads to actionable results] **Total Estimated Time:** [Sum of durations] -**Session Focus:** [Primary benefit and outcome description]" +**Session Focus:** [Primary benefit and outcome description] + ### 4. Present Recommendation Details @@ -117,7 +121,8 @@ Provide deeper insight into each recommended technique: **Detailed Technique Explanations:** -"For each recommended technique, here's what makes it perfect for your session: + +For each recommended technique, here's what makes it perfect for your session: **1. [Technique 1]:** @@ -138,11 +143,13 @@ Provide deeper insight into each recommended technique: - **Description:** [Detailed explanation] - **Best for:** [Why this completes the sequence effectively] - **Sample facilitation:** [Example of how we'll use this] -- **Your role:** [What you'll do during this technique]" +- **Your role:** [What you'll do during this technique] + ### 5. Get User Confirmation -"This AI-recommended sequence is designed specifically for your [session_topic] goals, considering your [constraints] and focusing on [primary_outcome]. + +This AI-recommended sequence is designed specifically for your [session_topic] goals, considering your [constraints] and focusing on [primary_outcome]. **Does this approach sound perfect for your session?** @@ -151,6 +158,7 @@ Provide deeper insight into each recommended technique: [Modify] - I'd like to adjust the technique selection [Details] - Tell me more about any specific technique [Back] - Return to approach selection + ### 6. Handle User Response diff --git a/src/core/workflows/brainstorming/steps/step-02c-random-selection.md b/src/core/workflows/brainstorming/steps/step-02c-random-selection.md index def91d0a..bc75f096 100644 --- a/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +++ b/src/core/workflows/brainstorming/steps/step-02c-random-selection.md @@ -34,7 +34,8 @@ Use random selection to discover unexpected brainstorming techniques that will b Create anticipation for serendipitous technique discovery: -"Exciting choice! You've chosen the path of creative serendipity. Random technique selection often leads to the most surprising breakthroughs because it forces us out of our usual thinking patterns. + +Exciting choice! You've chosen the path of creative serendipity. Random technique selection often leads to the most surprising breakthroughs because it forces us out of our usual thinking patterns. **The Magic of Random Selection:** @@ -43,7 +44,8 @@ Create anticipation for serendipitous technique discovery: - Find unexpected connections between different creativity methods - Experience the joy of genuine creative surprise -**Loading our complete Brain Techniques Library for Random Discovery...**" +**Loading our complete Brain Techniques Library for Random Discovery...** + **Load CSV and parse:** @@ -56,9 +58,12 @@ Create anticipation for serendipitous technique discovery: Perform random selection with basic intelligence for good combinations: **Selection Process:** -"I'm now randomly selecting 3 complementary techniques from our library of 36+ methods. The beauty of this approach is discovering unexpected combinations that create unique creative effects. -**Randomizing Technique Selection...**" + +I'm now randomly selecting 3 complementary techniques from our library of 36+ methods. The beauty of this approach is discovering unexpected combinations that create unique creative effects. + +**Randomizing Technique Selection...** + **Selection Logic:** @@ -71,7 +76,8 @@ Perform random selection with basic intelligence for good combinations: Reveal the randomly selected techniques with enthusiasm: -"**🎲 Your Randomly Selected Creative Techniques! 🎲** + +**🎲 Your Randomly Selected Creative Techniques! 🎲** **Phase 1: Exploration** **[Random Technique 1]** from [Category] (Duration: [time], Energy: [level]) @@ -95,13 +101,15 @@ Reveal the randomly selected techniques with enthusiasm: - **Random discovery bonus:** [Unexpected insight about the overall flow] **Total Random Session Time:** [Combined duration] -**Serendipity Factor:** [Enthusiastic description of creative potential]" +**Serendipity Factor:** [Enthusiastic description of creative potential] + ### 4. Highlight the Creative Potential Emphasize the unique value of this random combination: -"**Why This Random Combination is Perfect:** + +**Why This Random Combination is Perfect:** **Unexpected Synergy:** These three techniques might seem unrelated, but that's exactly where the magic happens! [Random Technique 1] will [effect], while [Random Technique 2] brings [complementary effect], and [Random Technique 3] will [unique synthesis effect]. @@ -123,6 +131,7 @@ You're about to experience brainstorming in a completely new way. These unexpect [Shuffle] - Randomize another combination for different adventure [Details] - Tell me more about any specific technique [Back] - Return to approach selection + ### 5. Handle User Response diff --git a/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md b/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md index 96aa2d90..a152c56a 100644 --- a/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md @@ -34,7 +34,8 @@ Design a progressive technique flow that takes users from expansive exploration Explain the value of systematic creative progression: -"Excellent choice! Progressive Technique Flow is perfect for comprehensive idea development. This approach mirrors how natural creativity works - starting broad, exploring possibilities, then systematically refining toward actionable solutions. + +Excellent choice! Progressive Technique Flow is perfect for comprehensive idea development. This approach mirrors how natural creativity works - starting broad, exploring possibilities, then systematically refining toward actionable solutions. **The Creative Journey We'll Take:** @@ -62,7 +63,8 @@ Explain the value of systematic creative progression: - Identify resources, timelines, and success metrics - Transform ideas into actionable plans -**Loading Brain Techniques Library for Journey Design...**" +**Loading Brain Techniques Library for Journey Design...** + **Load CSV and parse:** @@ -76,7 +78,8 @@ Select optimal techniques for each progressive phase: **Phase 1: Expansive Exploration Techniques** -"For **Expansive Exploration**, I'm selecting techniques that maximize creative breadth and wild thinking: + +For **Expansive Exploration**, I'm selecting techniques that maximize creative breadth and wild thinking: **Recommended Technique: [Exploration Technique]** @@ -85,11 +88,13 @@ Select optimal techniques for each progressive phase: - **Expected Outcome:** [Number]+ raw ideas across diverse categories - **Creative Energy:** High energy, expansive thinking -**Alternative if time-constrained:** [Simpler exploration technique]" +**Alternative if time-constrained:** [Simpler exploration technique] + **Phase 2: Pattern Recognition Techniques** -"For **Pattern Recognition**, we need techniques that help organize and find meaning in the creative abundance: + +For **Pattern Recognition**, we need techniques that help organize and find meaning in the creative abundance: **Recommended Technique: [Analysis Technique]** @@ -98,35 +103,41 @@ Select optimal techniques for each progressive phase: - **Expected Outcome:** Clear patterns and priority insights - **Analytical Focus:** Organized thinking and pattern discovery -**Alternative for different session type:** [Alternative analysis technique]" +**Alternative for different session type:** [Alternative analysis technique] + **Phase 3: Idea Development Techniques** -"For **Idea Development**, we select techniques that refine and elaborate promising concepts: + +For **Idea Development**, we select techniques that refine and elaborate promising concepts: **Recommended Technique: [Development Technique]** - **Category:** Structured/Collaborative techniques - **Why for Phase 3:** Perfect for building depth and detail around strong concepts - **Expected Outcome:** Well-developed solutions with implementation considerations -- **Refinement Focus:** Practical enhancement and feasibility exploration" +- **Refinement Focus:** Practical enhancement and feasibility exploration + **Phase 4: Action Planning Techniques** -"For **Action Planning**, we choose techniques that create concrete implementation pathways: + +For **Action Planning**, we choose techniques that create concrete implementation pathways: **Recommended Technique: [Planning Technique]** - **Category:** Structured/Analytical techniques - **Why for Phase 4:** Ideal for transforming ideas into actionable steps - **Expected Outcome:** Clear implementation plan with timelines and resources -- **Implementation Focus:** Practical next steps and success metrics" +- **Implementation Focus:** Practical next steps and success metrics + ### 3. Present Complete Journey Map Show the full progressive flow with timing and transitions: -"**Your Complete Creative Journey Map:** + +**Your Complete Creative Journey Map:** **⏰ Total Journey Time:** [Combined duration] **🎯 Session Focus:** Systematic development from ideas to action @@ -175,12 +186,14 @@ Show the full progressive flow with timing and transitions: [Customize] - I'd like to modify any phase techniques [Details] - Tell me more about any specific phase or technique [Back] - Return to approach selection + ### 4. Handle Customization Requests If user wants customization: -"**Customization Options:** + +**Customization Options:** **Phase Modifications:** @@ -195,7 +208,8 @@ If user wants customization: - **Extended Journey:** Add bonus technique at any phase for deeper exploration - **Focused Journey:** Emphasize specific phases based on your goals -**Which customization would you like to make?**" +**Which customization would you like to make?** + ### 5. Update Frontmatter and Document diff --git a/src/core/workflows/brainstorming/steps/step-03-technique-execution.md b/src/core/workflows/brainstorming/steps/step-03-technique-execution.md index 362bead3..c77420d3 100644 --- a/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +++ b/src/core/workflows/brainstorming/steps/step-03-technique-execution.md @@ -51,7 +51,8 @@ Facilitate brainstorming techniques through genuine interactive coaching, respon Set up collaborative facilitation approach: -"**Outstanding! Let's begin our first technique with true collaborative facilitation.** + +**Outstanding! Let's begin our first technique with true collaborative facilitation.** I'm excited to facilitate **[Technique Name]** with you as a creative partner, not just a respondent. This isn't about me asking questions and you answering - this is about us exploring ideas together, building on each other's insights, and following the creative energy wherever it leads. @@ -68,7 +69,8 @@ I'm excited to facilitate **[Technique Name]** with you as a creative partner, n **Focus:** [Primary goal of this technique] **Energy:** [High/Reflective/Playful/etc.] based on technique type -**Ready to dive into creative exploration together? Let's start with our first element!**" +**Ready to dive into creative exploration together? Let's start with our first element!** + ### 2. Execute First Technique Element Interactively @@ -76,9 +78,11 @@ Begin with genuine facilitation of the first technique component: **For Creative Techniques (What If, Analogical, etc.):** -"**Let's start with: [First provocative question/concept]** + +**Let's start with: [First provocative question/concept]** -I'm not just looking for a quick answer - I want to explore this together. What immediately comes to mind? Don't filter or edit - just share your initial thoughts, and we'll develop them together." +I'm not just looking for a quick answer - I want to explore this together. What immediately comes to mind? Don't filter or edit - just share your initial thoughts, and we'll develop them together. + **Wait for user response, then coach deeper:** @@ -88,9 +92,11 @@ I'm not just looking for a quick answer - I want to explore this together. What **For Structured Techniques (SCAMPER, Six Thinking Hats, etc.):** -"**Let's explore [Specific letter/perspective]: [Prompt]** + +**Let's explore [Specific letter/perspective]: [Prompt]** -Instead of just listing possibilities, let's really dive into one promising direction. What's the most exciting or surprising thought you have about this?" +Instead of just listing possibilities, let's really dive into one promising direction. What's the most exciting or surprising thought you have about this? + **Coach the exploration:** @@ -106,7 +112,9 @@ Follow the user's creative energy with genuine coaching: **Responsive Facilitation Patterns:** **When user shares exciting idea:** -"That's brilliant! I can feel the creative energy there. Let's explore this more deeply: + + +That's brilliant! I can feel the creative energy there. Let's explore this more deeply: **Development Questions:** @@ -115,24 +123,30 @@ Follow the user's creative energy with genuine coaching: - What are the most innovative aspects of this approach? - Could this be applied in unexpected ways? -**Let me build on your idea:** [Extend concept with your own creative contribution]" +**Let me build on your idea:** [Extend concept with your own creative contribution] + **When user seems uncertain:** -"Great starting point! Sometimes the most powerful ideas need space to develop. Let's try this angle: + + +Great starting point! Sometimes the most powerful ideas need space to develop. Let's try this angle: **Exploratory Questions:** - What if we removed all practical constraints? - How would [stakeholder] respond to this idea? - What's the most unexpected version of this concept? -- Could we combine this with something completely different?" +- Could we combine this with something completely different? + **When user gives detailed response:** -"Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing: + +Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing: **Key Insight:** [Extract and highlight their best point] **Building on That:** [Develop their idea further] -**Additional Direction:** [Suggest new angles based on their thinking]" +**Additional Direction:** [Suggest new angles based on their thinking] + ### 4. Check Technique Continuation @@ -140,7 +154,8 @@ Before moving to next technique element: **Check Engagement and Interest:** -"This has been incredibly productive! We've generated some fantastic ideas around [current element]. + +This has been incredibly productive! We've generated some fantastic ideas around [current element]. **Before we move to the next technique element, I want to check in with you:** @@ -157,13 +172,15 @@ Before moving to next technique element: - **Take a different angle** on current element - **Jump to most exciting idea** we've discovered so far -**Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique!" +**Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique! + ### 4.1. Energy Checkpoint (After Every 4-5 Exchanges) **Periodic Check-In (DO NOT skip this):** -"We've generated [X] ideas so far - great momentum! + +We've generated [X] ideas so far - great momentum! **Quick energy check:** @@ -171,7 +188,8 @@ Before moving to next technique element: - **Switch techniques** for a fresh perspective? - Or are you feeling like we've **thoroughly explored** this space? -Remember: The goal is quantity first - we can organize later. What feels right?" +Remember: The goal is quantity first - we can organize later. What feels right? + **IMPORTANT:** Default to continuing exploration. Only suggest organization if: @@ -184,7 +202,9 @@ Remember: The goal is quantity first - we can organize later. What feels right?" **When user says "next technique" or "move on":** **Immediate Response:** -"**Got it! Let's transition to the next technique.** + + +**Got it! Let's transition to the next technique.** **Documenting our progress with [Current Technique]:** @@ -201,7 +221,8 @@ Remember: The goal is quantity first - we can organize later. What feels right?" This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on or contrasts with what we discovered about [key insight from current technique]. -**Let's begin fresh with this new approach!**" +**Let's begin fresh with this new approach!** + **Then restart step 3 for the next technique:** @@ -215,7 +236,8 @@ If multiple techniques selected: **Transition Between Techniques:** -"**Fantastic work with [Previous Technique]!** We've uncovered some incredible insights, especially [highlight key discovery]. + +**Fantastic work with [Previous Technique]!** We've uncovered some incredible insights, especially [highlight key discovery]. **Now let's transition to [Next Technique]:** @@ -229,7 +251,8 @@ This technique will help us [what this technique adds]. I'm particularly excited **Ready to continue our creative journey with this new approach?** -Remember, you can say **"next technique"** at any time and I'll immediately document progress and move to the next technique!" +Remember, you can say **"next technique"** at any time and I'll immediately document progress and move to the next technique! + ### 6. Document Ideas Organically @@ -237,15 +260,18 @@ Capture insights as they emerge during interactive facilitation: **During Facilitation:** -"That's a powerful insight - let me capture that: _[Key idea with context]_ + +That's a powerful insight - let me capture that: _[Key idea with context]_ I'm noticing a theme emerging here: _[Pattern recognition]_ -This connects beautifully with what we discovered earlier about _[previous connection]_" +This connects beautifully with what we discovered earlier about _[previous connection]_ + **After Deep Exploration:** -"Let me summarize what we've uncovered in this exploration using our **IDEA FORMAT TEMPLATE**: + +Let me summarize what we've uncovered in this exploration using our **IDEA FORMAT TEMPLATE**: **Key Ideas Generated:** @@ -259,13 +285,15 @@ _Novelty_: [What makes this different from obvious solutions] **Energy and Engagement:** [Observation about user's creative flow] -**Should I document these ideas before we continue, or keep the creative momentum going?**" +**Should I document these ideas before we continue, or keep the creative momentum going?** + ### 7. Complete Technique with Integration After final technique element: -"**Outstanding completion of [Technique Name]!** + +**Outstanding completion of [Technique Name]!** **What We've Discovered Together:** @@ -291,6 +319,7 @@ After final technique element: [C] **Move to organization** - Only when you feel we've thoroughly explored **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. + ### 8. Handle Menu Selection diff --git a/src/core/workflows/brainstorming/steps/step-04-idea-organization.md b/src/core/workflows/brainstorming/steps/step-04-idea-organization.md index afe56ff7..efc877d2 100644 --- a/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +++ b/src/core/workflows/brainstorming/steps/step-04-idea-organization.md @@ -34,7 +34,8 @@ Organize all brainstorming ideas into coherent themes, facilitate prioritization Begin systematic review of all generated ideas: -"**Outstanding creative work!** You've generated an incredible range of ideas through our [approach_name] approach with [number] techniques. + +**Outstanding creative work!** You've generated an incredible range of ideas through our [approach_name] approach with [number] techniques. **Session Achievement Summary:** @@ -44,14 +45,17 @@ Begin systematic review of all generated ideas: **Now let's organize these creative gems and identify your most promising opportunities for action.** -**Loading all generated ideas for systematic organization...**" +**Loading all generated ideas for systematic organization...** + ### 2. Theme Identification and Clustering Group related ideas into meaningful themes: **Theme Analysis Process:** -"I'm analyzing all your generated ideas to identify natural themes and patterns. This will help us see the bigger picture and prioritize effectively. + + +I'm analyzing all your generated ideas to identify natural themes and patterns. This will help us see the bigger picture and prioritize effectively. **Emerging Themes I'm Identifying:** @@ -77,7 +81,8 @@ _Focus: [Description of what this theme covers]_ - **[Cross-cutting Ideas]:** [Ideas that span multiple themes] - **[Breakthrough Concepts]:** [Particularly innovative or surprising ideas] -- **[Implementation-Ready Ideas]:** [Ideas that seem immediately actionable]" +- **[Implementation-Ready Ideas]:** [Ideas that seem immediately actionable] + ### 3. Present Organized Idea Themes @@ -85,7 +90,8 @@ Display systematically organized ideas for user review: **Organized by Theme:** -"**Your Brainstorming Results - Organized by Theme:** + +**Your Brainstorming Results - Organized by Theme:** **[Theme 1]: [Theme Description]** @@ -108,7 +114,8 @@ Display systematically organized ideas for user review: - **[Innovative Idea]:** [Why this represents a significant breakthrough] - **[Unexpected Connection]:** [How this creates new possibilities] -**Which themes or specific ideas stand out to you as most valuable?**" +**Which themes or specific ideas stand out to you as most valuable?** + ### 4. Facilitate Prioritization @@ -116,7 +123,8 @@ Guide user through strategic prioritization: **Prioritization Framework:** -"Now let's identify your most promising ideas based on what matters most for your **[session_goals]**. + +Now let's identify your most promising ideas based on what matters most for your **[session_goals]**. **Prioritization Criteria for Your Session:** @@ -133,7 +141,8 @@ Review your organized ideas and identify: 2. **Easiest Quick Wins:** Which ideas could be implemented fastest? 3. **Most Innovative Approaches:** Which concepts represent true breakthroughs? -**What stands out to you as most valuable? Share your top priorities and I'll help you develop action plans.**" +**What stands out to you as most valuable? Share your top priorities and I'll help you develop action plans.** + ### 5. Develop Action Plans @@ -141,7 +150,8 @@ Create concrete next steps for prioritized ideas: **Action Planning Process:** -"**Excellent choices!** Let's develop actionable plans for your top priority ideas. + +**Excellent choices!** Let's develop actionable plans for your top priority ideas. **For each selected idea, let's explore:** @@ -162,7 +172,8 @@ Create concrete next steps for prioritized ideas: **Timeline:** [Implementation estimate] **Success Indicators:** [How to measure progress] -**Would you like me to develop similar action plans for your other top ideas?**" +**Would you like me to develop similar action plans for your other top ideas?** + ### 6. Create Comprehensive Session Documentation @@ -170,7 +181,8 @@ Prepare final session output: **Session Documentation Structure:** -"**Creating your comprehensive brainstorming session documentation...** + +**Creating your comprehensive brainstorming session documentation...** This document will include: @@ -180,7 +192,8 @@ This document will include: - **Action Plans:** Concrete next steps for implementation - **Session Insights:** Key learnings and creative breakthroughs -**Your brainstorming session has produced [number] organized ideas across [number] themes, with [number] prioritized concepts ready for action planning.**" +**Your brainstorming session has produced [number] organized ideas across [number] themes, with [number] prioritized concepts ready for action planning.** + **Append to document:** @@ -217,7 +230,8 @@ Provide final session wrap-up and forward guidance: **Session Completion:** -"**Congratulations on an incredibly productive brainstorming session!** + +**Congratulations on an incredibly productive brainstorming session!** **Your Creative Achievements:** @@ -248,6 +262,7 @@ Provide final session wrap-up and forward guidance: **Ready to complete your session documentation?** [C] Complete - Generate final brainstorming session document + ### 8. Handle Completion Selection diff --git a/src/core/workflows/party-mode/steps/step-01-agent-loading.md b/src/core/workflows/party-mode/steps/step-01-agent-loading.md index 001ad9d4..2c36f102 100644 --- a/src/core/workflows/party-mode/steps/step-01-agent-loading.md +++ b/src/core/workflows/party-mode/steps/step-01-agent-loading.md @@ -34,9 +34,11 @@ Load the complete agent roster from manifest and initialize party mode with enga Begin agent loading process: -"Now initializing **Party Mode** with our complete BMAD agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion. + +Now initializing **Party Mode** with our complete BMAD agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion. -**Agent Manifest Loading:**" +**Agent Manifest Loading:** + Load and parse the agent manifest CSV from `{project-root}/_bmad/_config/agent-manifest.csv` @@ -72,7 +74,8 @@ Create complete agent roster with merged personalities: Generate enthusiastic party mode introduction: -"🎉 PARTY MODE ACTIVATED! 🎉 + +🎉 PARTY MODE ACTIVATED! 🎉 Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discussion with our complete BMAD team. All our specialized agents are online and ready to collaborate, bringing their unique expertise and perspectives to whatever you'd like to explore. @@ -86,16 +89,19 @@ Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discu **[Total Count] agents** are ready to contribute their expertise! -**What would you like to discuss with the team today?**" +**What would you like to discuss with the team today?** + ### 5. Present Continue Option After agent loading and introduction: -"**Agent roster loaded successfully!** All our BMAD experts are excited to collaborate with you. + +**Agent roster loaded successfully!** All our BMAD experts are excited to collaborate with you. **Ready to start the discussion?** [C] Continue - Begin multi-agent conversation + ### 6. Handle Continue Selection diff --git a/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md b/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md index 361c1937..289e4ffb 100644 --- a/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +++ b/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md @@ -33,7 +33,9 @@ Orchestrate dynamic multi-agent conversations with intelligent agent selection, For each user message or topic: **Input Analysis Process:** -"Analyzing your message for the perfect agent collaboration..." + +Analyzing your message for the perfect agent collaboration... + **Analysis Criteria:** @@ -103,7 +105,7 @@ When an agent asks the user a specific question: - End that response round immediately after the question - Clearly highlight: **[Agent Name] asks: [Their question]** -- Display: _[Awaiting user response...]_ +- _[Awaiting user response...]_ - WAIT for user input before continuing **Rhetorical Questions:** diff --git a/src/core/workflows/party-mode/steps/step-03-graceful-exit.md b/src/core/workflows/party-mode/steps/step-03-graceful-exit.md index eef37877..5869927e 100644 --- a/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +++ b/src/core/workflows/party-mode/steps/step-03-graceful-exit.md @@ -34,9 +34,11 @@ Provide satisfying agent farewells and conclude the party mode session with grat Begin exit process with warm acknowledgment: -"What an incredible collaborative session! Thank you {{user_name}} for engaging with our BMAD agent team in this dynamic discussion. Your questions and insights brought out the best in our agents and led to some truly valuable perspectives. + +What an incredible collaborative session! Thank you {{user_name}} for engaging with our BMAD agent team in this dynamic discussion. Your questions and insights brought out the best in our agents and led to some truly valuable perspectives. -**Before we wrap up, let a few of our agents say goodbye...**" +**Before we wrap up, let a few of our agents say goodbye...** + ### 2. Generate Agent Farewells @@ -68,13 +70,16 @@ For each selected agent: Briefly acknowledge key discussion outcomes: **Session Recognition:** -"**Session Highlights:** Today we explored [main topic] through [number] different perspectives, generating valuable insights on [key outcomes]. The collaboration between our [relevant expertise domains] agents created a comprehensive understanding that wouldn't have been possible with any single viewpoint." + +**Session Highlights:** Today we explored [main topic] through [number] different perspectives, generating valuable insights on [key outcomes]. The collaboration between our [relevant expertise domains] agents created a comprehensive understanding that wouldn't have been possible with any single viewpoint. + ### 4. Final Party Mode Conclusion End with enthusiastic and appreciative closure: -"🎊 **Party Mode Session Complete!** 🎊 + +🎊 **Party Mode Session Complete!** 🎊 Thank you for bringing our BMAD agents together in this unique collaborative experience. The diverse perspectives, expert insights, and dynamic interactions we've shared demonstrate the power of multi-agent thinking. @@ -82,7 +87,8 @@ Thank you for bringing our BMAD agents together in this unique collaborative exp **Ready for your next challenge**? Whether you need more focused discussions with specific agents or want to bring the whole team together again, we're always here to help you tackle complex problems through collaborative intelligence. -**Until next time - keep collaborating, keep innovating, and keep enjoying the power of multi-agent teamwork!** 🚀" +**Until next time - keep collaborating, keep innovating, and keep enjoying the power of multi-agent teamwork!** 🚀 + ### 5. Complete Workflow Exit @@ -112,9 +118,11 @@ workflow_completed: true Execute final workflow termination: -"[PARTY MODE WORKFLOW COMPLETE] + +[PARTY MODE WORKFLOW COMPLETE] -Thank you for using BMAD Party Mode for collaborative multi-agent discussions!" +Thank you for using BMAD Party Mode for collaborative multi-agent discussions! + ## SUCCESS METRICS: diff --git a/src/core/workflows/party-mode/workflow.md b/src/core/workflows/party-mode/workflow.md index eaec3c93..2499bd51 100644 --- a/src/core/workflows/party-mode/workflow.md +++ b/src/core/workflows/party-mode/workflow.md @@ -75,7 +75,8 @@ Execute party mode activation and conversation orchestration: **Welcome Activation:** -"🎉 PARTY MODE ACTIVATED! 🎉 + +🎉 PARTY MODE ACTIVATED! 🎉 Welcome {{user_name}}! All BMAD agents are here and ready for a dynamic group discussion. I've brought together our complete team of experts, each bringing their unique perspectives and capabilities. @@ -83,7 +84,8 @@ Welcome {{user_name}}! All BMAD agents are here and ready for a dynamic group di [Load agent roster and display 2-3 most diverse agents as examples] -**What would you like to discuss with the team today?**" +**What would you like to discuss with the team today?** + ### Agent Selection Intelligence