refactor(ux-designer): improve step completion flow and document handling

- Add "Save Previous Step Content" section to all steps
- Change immediate saving to draft review before confirmation
- Update PO controller to clarify review process
- Streamline initial discovery step content generation

Author: moazbuilds

prompts/templates/bmad/03-ux-designer/chained/step-01-discovery.md

@@ -20,7 +20,7 @@ description: 'Understand project context and user needs for UX design'
 
 ## CONTEXT BOUNDARIES:
 
-- PRD and product brief already loaded in workflow context
+- PRD and product brief content is provided above
 - This step creates the UX Design Specification document with initial content
 - **Output Path:** `.codemachine/artifacts/ux-design-spec-{date}.md`
 
@@ -30,25 +30,23 @@ Understand the project context, target users, and what makes this product specia
 
 ## PROJECT DISCOVERY SEQUENCE:
 
-### 1. Review Loaded Context
+### 1. Leverage Input Documents
 
-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}}.
+**If PRD and Product Brief exist (content visible above):**
+"Based on your project documentation, here's what I understand about {{project_name}}:
 
-**From the documents:**
-{summary of key insights from loaded PRD, briefs, and other context documents}
+**Project Vision:**
+{{extracted_vision_summary}}
 
 **Target Users:**
-{summary of user information from loaded documents}
+{{extracted_users_summary}}
 
 **Key Features/Goals:**
-{summary of main features and goals from loaded documents}
+{{extracted_features_summary}}
 
-Does this match your understanding? Are there any corrections or additions you'd like to make?"
+Does this match your understanding? Any corrections or additions?"
 
-### 2. Fill Context Gaps (If no documents or gaps exist)
-
-If no documents were loaded or key information is missing:
+**If documents are empty or missing:**
 "Since we don't have complete documentation, let's start with the essentials:
 
 **What are you building?** (Describe your product in 1-2 sentences)
@@ -59,7 +57,7 @@ If no documents were loaded or key information is missing:
 
 **What's the main thing users will do with this?** (Core user action or goal)"
 
-### 3. Explore User Context Deeper
+### 2. Explore User Context Deeper
 
 Dive into user understanding:
 "Let me understand your users better to inform the UX design:
@@ -73,7 +71,7 @@ Dive into user understanding:
 - What devices will they use most?
 - When/where will they use this product?"
 
-### 4. Identify UX Design Challenges
+### 3. Identify UX Design Challenges
 
 Surface the key UX challenges to address:
 "From what we've discussed, I'm seeing some key UX design considerations:
@@ -91,7 +89,7 @@ Surface the key UX challenges to address:
 
 Does this capture the key UX considerations we need to address?"
 
-### 5. Generate UX Design Specification Document
+### 4. Generate UX Design Specification Document
 
 Based on the conversation, prepare the content to create the document:
 
@@ -129,22 +127,22 @@ status: 'draft'
 [Design opportunities identified based on conversation]
 ```
 
-### 6. Step Completion
+### 5. Step Completion
 
-**Save Content:**
-Create the UX Design Specification document at `.codemachine/artifacts/ux-design-spec-{date}.md` using the structure from step 5 now.
+**Show Draft:**
+Present the content from step 4 to the user for review.
 
 **Confirmation:**
-"Document created and saved.
+"Here's what I'll save to the UX Design Specification document:
 
-I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward.
+[Show the complete markdown content from step 4]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 
-✅ All available context documents reviewed and synthesized
+✅ PRD and product brief content analyzed and synthesized
 ✅ Project vision clearly articulated
 ✅ Target users well understood
 ✅ Key UX challenges identified
@@ -153,7 +151,7 @@ I've documented our understanding of {{project_name}} from a UX perspective. Thi
 
 ## FAILURE MODES:
 
-❌ Not reviewing loaded context documents thoroughly
+❌ Not analyzing the PRD and product brief content provided
 ❌ Making assumptions about users without asking
 ❌ Missing key UX challenges that will impact design
 ❌ Not identifying design opportunities

prompts/templates/bmad/03-ux-designer/chained/step-02-core-experience.md

@@ -30,6 +30,10 @@ Define the core user experience, platform requirements, and what makes the inter
 
 ## CORE EXPERIENCE DISCOVERY SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Create the UX Design Specification document at `.codemachine/artifacts/ux-design-spec-{date}.md` using the content confirmed in Step 1.
+
 ### 1. Define Core User Action
 
 Start by identifying the most important user interaction:
@@ -125,16 +129,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-03-emotional-response.md

@@ -30,6 +30,10 @@ Define the desired emotional responses users should feel when using the product.
 
 ## EMOTIONAL RESPONSE DISCOVERY SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 2 to the UX Design Specification document.
+
 ### 1. Explore Core Emotional Goals
 
 Start by understanding the emotional objectives:
@@ -128,16 +132,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-I've defined the desired emotional responses for {{project_name}}. These emotional goals will guide our design decisions to create the right user experience.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-04-inspiration.md

@@ -30,6 +30,10 @@ Analyze inspiring products and UX patterns to inform design decisions for the cu
 
 ## INSPIRATION ANALYSIS SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 3 to the UX Design Specification document.
+
 ### 1. Identify User's Favorite Apps
 
 Start by gathering inspiration sources:
@@ -143,16 +147,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-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.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-05-design-system.md

@@ -31,6 +31,10 @@ Choose appropriate design system approach based on project requirements and cons
 
 ## DESIGN SYSTEM CHOICE SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 4 to the UX Design Specification document.
+
 ### 1. Present Design System Options
 
 Educate about design system approaches:
@@ -162,16 +166,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-I've documented our design system choice for {{project_name}}. This foundation will ensure consistency and speed up development.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-06-defining-experience.md

@@ -31,6 +31,10 @@ Define the core interaction that, if nailed, makes everything else follow in the
 
 ## DEFINING EXPERIENCE SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 5 to the UX Design Specification document.
+
 ### 1. Identify the Defining Experience
 
 Focus on the core interaction:
@@ -164,16 +168,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-I've defined the core experience for {{project_name}} - the interaction that will make users love this product.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-07-visual-foundation.md

@@ -31,6 +31,10 @@ Establish the visual design foundation including color themes, typography, and s
 
 ## VISUAL FOUNDATION SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 6 to the UX Design Specification document.
+
 ### 1. Brand Guidelines Assessment
 
 Check for existing brand requirements:
@@ -134,17 +138,17 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-1. Create HTML color theme visualizer at `.codemachine/artifacts/ux-color-themes.html`
-2. Append content from step 6 to the UX Design Specification document
+**Show Draft:**
+1. Generate HTML color theme visualizer at `.codemachine/artifacts/ux-color-themes.html`
+2. Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document and color theme visualizer generated.
+"Here's what I'll append to the UX Design Specification:
 
-I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-08-design-directions.md

@@ -31,6 +31,10 @@ Generate comprehensive design direction mockups showing different visual approac
 
 ## DESIGN DIRECTIONS SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 7 to the UX Design Specification document.
+
 ### 1. Generate Design Direction Variations
 
 Create diverse visual explorations:
@@ -134,17 +138,17 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-1. Create HTML showcase at `.codemachine/artifacts/ux-design-directions.html`
-2. Append content from step 6 to the document
+**Show Draft:**
+1. Generate HTML showcase at `.codemachine/artifacts/ux-design-directions.html`
+2. Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document and HTML mockups generated.
+"Here's what I'll append to the UX Design Specification:
 
-I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS:
 

prompts/templates/bmad/03-ux-designer/chained/step-09-user-journeys.md

@@ -31,13 +31,17 @@ Design detailed user journey flows for critical user interactions.
 
 ## USER JOURNEY FLOWS SEQUENCE:
 
+### 0. Save Previous Step Content
+
+**First Action:** Append the confirmed content from Step 8 to the UX Design Specification document.
+
 ### 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.
 
 **Existing User Journeys from PRD:**
-I've already loaded these user journeys from your PRD:
+Here are the user journeys from your PRD:
 [Journey narratives from PRD input documents]
 
 These journeys tell us **who** users are and **why** they take certain actions. Now we need to design **how** those journeys work in detail.
@@ -152,16 +156,16 @@ Prepare the content to append to the document:
 
 ### 7. Step Completion
 
-**Save Content:**
-Append the content from step 6 to the UX Design Specification document now.
+**Show Draft:**
+Present the content from step 6 to the user for review.
 
 **Confirmation:**
-"Content saved to document.
+"Here's what I'll append to the UX Design Specification:
 
-I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction.
+[Show the complete markdown content from step 6]
 
-- If you want to **modify or add details**, just tell me what you'd like to change
-- If you're satisfied, **press Enter in the promptbox to go to the next step**"
+- If you want to **modify or add details**, tell me what you'd like to change
+- If you're satisfied, **press Enter to confirm** - your content will be saved at the start of the next step before we continue"
 
 ## SUCCESS METRICS: