MVP Healthcare - Gamified Health Risk Assessment Chatbot Specification

Executive Summary

Transform MVP Healthcare's 20-minute phone-based Health & Wellness Assessment into an engaging, chapter-based chatbot experience that increases completion rates, reduces operational costs, and enables early intervention through real-time risk identification.

1. Survey Structure & Logic

Question Bank & Organization

Total Questions: 51 questions organized into 5 thematic chapters

Chapter 1: "Your Health Foundation" (Questions 1-9)

Objective: Establish baseline health status and immediate risk factors

1. Overall Health Rating (Q1)
   • Type: 5-point scale
   • Options: Excellent, Very good, Good, Fair, Poor
   • Points: Excellent=5, Very good=4, Good=3, Fair=2, Poor=1
   • Required: Yes
2. Hospital Stays (12 months) (Q2)
   • Type: Multiple choice
   • Options: Never, 1 time, 2-3 times, 4+ times
   • Points: Never=5, 1 time=4, 2-3 times=2, 4+ times=1
   • Required: Yes
3. Doctor Visits (12 months) (Q3)
   • Type: Multiple choice
   • Options: Never, 1 time, 2-3 times, 4-6 times, 7+ times
   • Points: Never=3, 1 time=5, 2-3 times=4, 4-6 times=3, 7+ times=2
   • Required: Yes
4. Diabetes Status (Q4)
   • Type: Yes/No
   • Points: Yes=1, No=5
   • Required: Yes
   • TRIGGER: Yes = Immediate diabetes care coordination flag
5. Coronary Artery Disease (Q5)
   • Type: Yes/No
   • Points: Yes=1, No=5
   • Required: Yes
   • TRIGGER: Yes = Cardiology referral consideration
6. Chest Pain/Angina (Q6)
   • Type: Yes/No
   • Points: Yes=1, No=5
   • Required: Yes
   • TRIGGER: Yes = Urgent cardiology consultation
7. Heart Attack History (Q7)
   • Type: Yes/No
   • Points: Yes=1, No=5
   • Required: Yes
   • TRIGGER: Yes = Cardiac rehabilitation program
8. Other Heart Conditions (Q8)
   • Type: Yes/No
   • Points: Yes=2, No=5
   • Required: Yes
9. Social Support (Q9)
   • Type: Yes/No
   • Question: "Is there a friend, relative or neighbor who would take care of you for a few days, if necessary?"
   • Points: Yes=5, No=2
   • Required: Yes

Chapter 2: "Movement & Energy" (Questions 10-18)

Objective: Assess physical activity and functional capacity

10. Cardiovascular Exercise Frequency (Q10)
    • Type: 5-point scale
    • Options: Don't exercise regularly, <1 day/week, 1-2 days/week, 3-4 days/week, 5+ days/week
    • Points: Don't exercise=1, <1 day=2, 1-2 days=3, 3-4 days=4, 5+ days=5
    • Required: Yes
11. Strength Training Frequency (Q11)
    • Type: 5-point scale
    • Options: Don't exercise regularly, <1 day/week, 1-2 days/week, 3-4 days/week, 5+ days/week
    • Points: Don't exercise=1, <1 day=2, 1-2 days=3, 3-4 days=4, 5+ days=5
    • Required: Yes
12. Mobility: Stooping/Kneeling (Q12)
    • Type: 5-point scale
    • Options: Unable to do, A lot of difficulty, Some difficulty, A little difficulty, No difficulty
    • Points: Unable=1, A lot=2, Some=3, A little=4, No difficulty=5
    • Required: Yes
13. Strength: Lifting 10 pounds (Q13)
    • Type: 5-point scale
    • Options: Unable to do, A lot of difficulty, Some difficulty, A little difficulty, No difficulty
    • Points: Unable=1, A lot=2, Some=3, A little=4, No difficulty=5
    • Required: Yes
14. Reach: Arms Above Shoulder (Q14)
    • Type: 5-point scale
    • Options: Unable to do, A lot of difficulty, Some difficulty, A little difficulty, No difficulty
    • Points: Unable=1, A lot=2, Some=3, A little=4, No difficulty=5
    • Required: Yes
15. Fine Motor: Writing/Grasping (Q15)
    • Type: 5-point scale
    • Options: Unable to do, A lot of difficulty, Some difficulty, A little difficulty, No difficulty
    • Points: Unable=1, A lot=2, Some=3, A little=4, No difficulty=5
    • Required: Yes
16. Heavy Housework (Q16)
    • Type: 5-point scale
    • Options: Unable to do, A lot of difficulty, Some difficulty, A little difficulty, No difficulty
    • Points: Unable=1, A lot=2, Some=3, A little=4, No difficulty=5
    • Required: Yes
17. Pain Interference (30 days) (Q17)
    • Type: 5-point scale
    • Options: Not at all, A little bit, Somewhat, Quite a bit, Very much
    • Points: Not at all=5, A little=4, Somewhat=3, Quite a bit=2, Very much=1
    • Required: Yes
18. Pain Level (7 days) (Q18)
    • Type: 11-point scale (0-10)
    • Options: 0 (No pain) through 10 (Worst imaginable pain)
    • Points: 0=5, 1-3=4, 4-6=3, 7-8=2, 9-10=1
    • Required: Yes
    • TRIGGER: 7+ = Pain management referral

Chapter 3: "Prevention & Wellness" (Questions 19-26)

Objective: Assess preventive care engagement and lifestyle factors

19. Aspirin Discussion with Doctor (Q19)
    • Type: Yes/No
    • Points: Yes=5, No=3
    • Required: Yes
20. Daily Aspirin Use (Q20)
    • Type: Yes/No
    • Points: Conditional based on Q19 and risk factors
    • Required: Yes
21. Gender (Q21)
    • Type: Single choice
    • Options: Male, Female
    • Required: Yes
    • BRANCHING: Male → Skip to Q24, Female → Continue to Q22
22. Mammogram (2 years) (Q22 - Female only)
    • Type: Yes/No
    • Points: Yes=5, No=2
    • Required: Yes (if female)
    • TRIGGER: No = Mammogram screening reminder
23. Pap Smear (Q23 - Female only)
    • Type: Multiple choice
    • Options: Within 1 year, Within 3 years, 4+ years ago
    • Points: Within 1 year=5, Within 3 years=4, 4+ years=2
    • Required: Yes (if female)
    • TRIGGER: 4+ years = Cervical screening reminder
24. Colon Cancer Screening (Q24)
    • Type: Yes/No
    • Points: Yes=5, No=2
    • Required: Yes
    • TRIGGER: No = Colonoscopy discussion
25. Fruits & Vegetables (7 days) (Q25)
    • Type: 5-point scale
    • Options: Don't know, 0 days, 1-2 days, 3-4 days, 5-7 days
    • Points: Don't know=3, 0 days=1, 1-2 days=2, 3-4 days=3, 5-7 days=5
    • Required: Yes
26. Alcohol Consumption (Q26)
    • Type: 5-point scale
    • Options: None, 1 drink, 2 drinks, 3 drinks, 4+ drinks
    • Points: None=5, 1 drink=5, 2 drinks=4, 3 drinks=3, 4+ drinks=1
    • Required: Yes
    • TRIGGER: 4+ drinks = Alcohol counseling consideration

Chapter 4: "Mind & Mood" (Questions 27-41)

Objective: Assess mental health, stress, and social connections

27. Seatbelt Use (Q27)
    • Type: 4-point scale
    • Options: Never, Sometimes, Usually, Always
    • Points: Never=1, Sometimes=2, Usually=3, Always=5
    • Required: Yes
28. Tobacco Use (Q28)
    • Type: Multiple choice
    • Options: Every day, Some days, Not at all, Don't know
    • Points: Every day=1, Some days=2, Not at all=5, Don't know=3
    • Required: Yes
    • BRANCHING: Not at all/Don't know → Skip to Q31
    • TRIGGER: Every day/Some days = Smoking cessation program
29. Quit Smoking Interest (Q29 - If smoker)
    • Type: Yes/No
    • Points: Yes=4, No=2
    • Required: Yes (if smoker)
30. Doctor Discussion: Quit Smoking (Q30 - If smoker)
    • Type: Yes/No
    • Points: Yes=4, No=2
    • Required: Yes (if smoker)
31. Work Limitations: Physical (Q31)
    • Type: 5-point scale
    • Options: Not at all, A little, Some, Most, All of the time
    • Points: Not at all=5, A little=4, Some=3, Most=2, All=1
    • Required: Yes
32. Activity Limitations: Physical (Q32)
    • Type: 5-point scale
    • Options: Not at all, A little, Some, Most, All of the time
    • Points: Not at all=5, A little=4, Some=3, Most=2, All=1
    • Required: Yes
33. Activity Limitations: Mental (Q33)
    • Type: 5-point scale
    • Options: Not at all, A little, Some, Most, All of the time
    • Points: Not at all=5, A little=4, Some=3, Most=2, All=1
    • Required: Yes
    • TRIGGER: Most/All of the time = Mental health referral
34. Work Quality: Mental (Q34)
    • Type: 5-point scale
    • Options: Not at all, A little, Some, Most, All of the time
    • Points: Not at all=5, A little=4, Some=3, Most=2, All=1
    • Required: Yes
35. Interest/Pleasure (2 weeks) (Q35)
    • Type: 4-point scale
    • Options: Not at all, Several days, More than half, Nearly everyday
    • Points: Not at all=5, Several days=4, More than half=2, Nearly everyday=1
    • Required: Yes
    • TRIGGER: More than half/Nearly everyday = Depression screening
36. Depression/Hopelessness (2 weeks) (Q36)
    • Type: 4-point scale
    • Options: Not at all, Several days, More than half, Nearly everyday
    • Points: Not at all=5, Several days=4, More than half=2, Nearly everyday=1
    • Required: Yes
    • TRIGGER: More than half/Nearly everyday = Depression screening
37. Stress Level (1 month) (Q37)
    • Type: 5-point scale
    • Options: Never, Almost never, Sometimes, Fairly often, Very often
    • Points: Never=5, Almost never=4, Sometimes=3, Fairly often=2, Very often=1
    • Required: Yes
38. Confidence in Problem-Solving (Q38)
    • Type: 5-point scale
    • Options: Never, Almost never, Sometimes, Fairly often, Very often
    • Points: Never=1, Almost never=2, Sometimes=3, Fairly often=4, Very often=5
    • Required: Yes
39. Anger at Uncontrollable Events (Q39)
    • Type: 5-point scale
    • Options: Never, Almost never, Sometimes, Fairly often, Very often
    • Points: Never=5, Almost never=4, Sometimes=3, Fairly often=2, Very often=1
    • Required: Yes
40. Social Ties Strength (Q40)
    • Type: 4-point scale
    • Options: Very strong, About average, Weaker than average, Not sure
    • Points: Very strong=5, About average=3, Weaker=2, Not sure=2
    • Required: Yes
41. Social Isolation (2 weeks) (Q41)
    • Type: 4-point scale
    • Options: Not at all, Several days, More than half, Nearly everyday
    • Points: Not at all=5, Several days=4, More than half=2, Nearly everyday=1
    • Required: Yes
    • TRIGGER: More than half/Nearly everyday = Social support referral

Chapter 5: "Daily Living & Background" (Questions 42-51)

Objective: Assess functional independence and demographic factors

42. Activities of Daily Living (Q42)
    • Type: Matrix (3-point scale for each activity)
    • Activities: Bathing, Dressing, Eating, Walking, Climbing stairs, Getting in/out of bed, Grooming, Brushing teeth, Using toilet, Using telephone, Driving, Grocery shopping, Preparing meals, Housework, Laundry, Managing medications, Money management
    • Options: Can do without help=3, Need some help=2, Cannot do without help=1
    • Required: Yes
    • TRIGGER: Multiple "Cannot do" responses = Home care assessment
43. Vision Problems (Q43)
    • Type: Yes/No
    • Points: Yes=2, No=5
    • Required: Yes
44. Hearing Problems (Q44)
    • Type: Yes/No
    • Points: Yes=2, No=5
    • Required: Yes
45. Home Safety Features (Q45)
    • Type: Multiple Yes/No
    • Items: Grab bars, Security system, Smoke detectors, Carbon monoxide detectors
    • Points: Each Yes=1, Each No=0
    • Required: Yes
46. Medical Conditions (Q46)
    • Type: Multiple selection
    • Options: 24 conditions including allergies, arthritis, asthma, COPD, chronic pain, heart conditions, etc.
    • Points: Each condition = specific risk weighting
    • Required: Yes
    • TRIGGER: Multiple conditions = Care coordination
47. Flu Vaccination (Q47)
    • Type: Yes/No
    • Points: Yes=5, No=2
    • Required: Yes
    • TRIGGER: No = Vaccination reminder
48. Education Level (Q48)
    • Type: 6-point scale
    • Options: 8th grade or less through More than 4-year degree
    • Points: Used for health literacy considerations
    • Required: Yes
49. Birth Year (Q49)
    • Type: Numeric input
    • Required: Yes
    • CALCULATION: Age-based risk adjustments
50. Weight (Q50)
    • Type: Numeric input (pounds)
    • Required: Yes
51. Height (Q51)
    • Type: Two numeric inputs (feet and inches)
    • Required: Yes
    • CALCULATION: BMI calculation and risk stratification

Branching Logic Rules

Primary Skip Logic:

• Q21 Male → Skip Q22-Q23, go to Q24
• Q28 "Not at all" or "Don't know" → Skip Q29-Q30, go to Q31

Conditional Question Display:

• Questions 22-23 only appear for female respondents
• Questions 29-30 only appear for tobacco users

Risk Scoring Algorithm

Total Score Calculation:

• Sum all point values from completed questions
• Apply weighted multipliers by category:
  • Health Foundation: 2.0x weight
  • Movement & Energy: 1.5x weight
  • Prevention & Wellness: 1.2x weight
  • Mind & Mood: 1.8x weight
  • Daily Living: 1.0x weight

Risk Stratification:

• High Risk: Total score ≤ 180 points
• Medium Risk: Total score 181-240 points
• Low Risk: Total score ≥ 241 points

Special Risk Flags (Immediate Intervention Triggers):

• Any cardiovascular condition = High Risk
• Pain level 7+ = High Risk
• Depression indicators = High Risk
• Multiple ADL limitations = High Risk
• Multiple chronic conditions = Medium/High Risk

2. Conversational Experience Design

Question Grouping & Flow

Chapter Progression Strategy:

1. Start with engaging, non-threatening questions (overall health perception)
2. Progress to functional assessments (movement, daily activities)
3. Address sensitive topics (mental health) in supportive context
4. End with demographic/administrative questions

Natural Transition Phrases:

Chapter 1 Introduction: "Great! Let's start by understanding your current health picture. I'll ask you a few questions about your recent healthcare experiences and any heart-related concerns."

Chapter 1 → Chapter 2 Transition: "Thanks for sharing that foundation! Now let's explore how you're moving and feeling physically. These questions help us understand your activity level and any physical challenges."

Chapter 2 → Chapter 3 Transition: "Excellent progress! Next, let's talk about staying healthy and preventing problems before they start. These questions are about screenings and healthy habits."

Chapter 3 → Chapter 4 Transition: "You're doing great! Now let's focus on your mental wellness and stress management. Your emotional health is just as important as your physical health."

Chapter 4 → Chapter 5 Transition: "Almost done! These final questions help us understand your daily life and any support you might benefit from."

Chapter Completion Celebration: "🎉 Chapter [X] Complete! You're [X]% of the way through your health assessment."

Conversation Personality

Tone Guidelines:

• Professional yet warm: Clinical accuracy with empathetic delivery
• Encouraging: Celebrate progress and normalize health challenges
• Non-judgmental: Frame all responses as valuable health information
• Supportive: Acknowledge difficulty of sensitive topics

Sample Conversation Starters:

Overall Health Question: "To start, how would you describe your overall health these days? There's no right or wrong answer - I just want to understand how you're feeling."

Sensitive Health Topics: "The next few questions are about heart health. Many people have heart-related concerns, and understanding yours helps us provide better care."

Mental Health Introduction: "Now I'd like to ask about your emotional wellbeing. These questions help us understand stress and mood - areas where we can often provide great support."

Error Handling Language:

Clarification Prompts:

• "I want to make sure I understand correctly. When you say [response], do you mean...?"
• "Could you help me clarify that? Are you thinking of...?"
• "That's a great question! Let me explain what I mean by..."

Validation Messages:

• "Thank you for sharing that - it's helpful information."
• "I appreciate your honesty about this."
• "That's completely understandable."

User Guidance

Complex Question Explanations:

Physical Activity Questions: "When I ask about cardiovascular exercise, I'm looking for activities that make your heart beat faster and cause you to sweat lightly, but you can still hold a conversation. This could be brisk walking, swimming, dancing, or using exercise equipment."

Pain Scale Explanation: "For pain rating, think of 0 as no pain at all, and 10 as the worst pain you can imagine. Most people use 1-3 for mild discomfort, 4-6 for moderate pain that interferes with some activities, and 7-10 for severe pain."

Activities of Daily Living: "These questions ask about everyday tasks. 'Without help' means you can do it completely on your own, 'some help' means you need assistance or equipment, and 'cannot do' means someone else must do it for you."

Answer Clarification Prompts:

• "If you're unsure about the timeframe, your best estimate is perfectly fine."
• "Choose the answer that best describes your typical or average experience."
• "If your situation has changed recently, think about the past month."

3. Gamification & Engagement Strategy

Progress System

Visual Progress Elements:

• Chapter Progress Bar: Shows completion within current chapter (e.g., "Question 3 of 9")
• Overall Progress Bar: Shows total assessment completion (e.g., "28% Complete")
• Chapter Map: Visual representation of 5 chapters with completion status
• Milestone Markers: Special animations at 20%, 40%, 60%, 80% completion

Progress Messaging:

• 0-20%: "Great start! You're building your health profile."
• 21-40%: "Making excellent progress! Keep going."
• 41-60%: "You're halfway there! Your responses are really helpful."
• 61-80%: "Almost done! Just a few more areas to cover."
• 81-100%: "Final stretch! You're doing amazing."

Achievement Mechanics

Point System:

• Base Points: 10 points per question completed
• Bonus Points:
  • Complete full chapter: +50 points
  • Answer without skipping: +5 points
  • Complete in single session: +100 points
  • Honest difficult answers: +25 points (for sensitive topics)

Achievement Badges:

• "Health Explorer" - Complete Chapter 1 (Your Health Foundation)
• "Movement Master" - Complete Chapter 2 (Movement & Energy)
• "Wellness Warrior" - Complete Chapter 3 (Prevention & Wellness)
• "Mindfulness Champion" - Complete Chapter 4 (Mind & Mood)
• "Life Organizer" - Complete Chapter 5 (Daily Living & Background)
• "Assessment Hero" - Complete entire assessment
• "Honesty Badge" - Answer all mental health questions
• "Prevention Pro" - Report up-to-date on all screenings

Unlock Conditions:

• Progressive Unlock: Each chapter unlocks after previous completion
• Choice Unlock: After Chapter 1, users can choose next chapter order
• Bonus Content: Unlock health tips and resources with each badge

Motivational Elements

Encouraging Messages During Survey:

• After difficult questions: "Thank you for sharing something personal. This helps us care for you better."
• Mid-chapter motivation: "You're providing valuable information that helps us support your health goals."
• Before sensitive sections: "The next few questions help us understand areas where we might be able to help."

Survey Fatigue Handling:

• Break Suggestions: "You can pause anytime and return later. Your progress is automatically saved."
• Time Estimates: "This chapter typically takes 3-5 minutes to complete."
• Value Reminders: "Each answer helps us personalize your healthcare experience."

Incentive Messaging:

• Immediate Value: "Based on your answers, here are three health tips personalized for you..."
• Care Connection: "Your responses help us connect you with the right healthcare resources."
• Progress Celebration: "Every question completed brings you closer to better health support!"

4. User Experience Requirements

Completion Expectations

Target Completion Time:

• Total Assessment: 12-15 minutes (reduced from 20-minute phone version)
• Per Chapter: 2-4 minutes average
• Chapter 1: 3-4 minutes (foundation setting)
• Chapter 2: 4-5 minutes (most detailed functional assessment)
• Chapter 3: 2-3 minutes (straightforward preventive care)
• Chapter 4: 3-4 minutes (requires thoughtful responses)
• Chapter 5: 2-3 minutes (mostly demographic)

Expected Break Points:

• After Chapter 1: Natural pause after establishing health foundation
• After Chapter 3: Midpoint break before emotional health topics
• Before Chapter 5: Optional pause before demographic questions

Save/Resume Functionality:

• Auto-save: Every question response automatically saved
• Session Recovery: Return to exact question where user left off
• Progress Persistence: Maintain progress bars and achievement status
• Time Limit: Save progress for up to 30 days
• Cross-Device: Access from any device with same login

Accessibility & Usability

Reading Level Requirements:

• Target: 8th grade reading level or below
• Sentence Structure: Simple, direct sentences under 20 words
• Medical Terms: Explained in plain language with examples
• Cultural Sensitivity: Inclusive language avoiding assumptions

Visual Design Preferences:

• Color Scheme: MVP Healthcare brand colors (professional blues/greens)
• Typography: Large, clear fonts (minimum 16px on mobile)
• Contrast: WCAG AA compliance for accessibility
• Icons: Clear, universally understood symbols for progress and achievements

Mobile vs. Desktop Experience:

• Mobile-First: Optimized for smartphone completion
• Touch-Friendly: Large tap targets (minimum 44px)
• Thumb Navigation: Important buttons within easy thumb reach
• Screen Adaptation: Responsive design for all screen sizes
• Offline Capability: Function without internet connection, sync when reconnected

5. Data & Results Management

Data Collection

Specific Data Points to Capture:

• Response Data: All question answers with timestamps
• Behavioral Data: Time spent per question, chapter completion rates, break patterns
• Engagement Metrics: Click patterns, scroll behavior, help text usage
• Technical Data: Device type, browser, completion environment
• Session Data: Start/stop times, number of sessions to complete

Data Validation Requirements:

• Range Checking: Numeric inputs within realistic bounds (age 18-120, weight 50-500 lbs)
• Format Validation: Proper height format (feet/inches), year format
• Completeness: Required question enforcement with clear error messages
• Consistency: Cross-question validation (BMI calculation, age-appropriate screenings)

Privacy/Security for Demo:

• No PHI Storage: Demo uses realistic but fictional data
• Local Storage: Data stays in browser session for demo purposes
• Clear Disclaimers: "Demo purposes only" messaging throughout
• Reset Capability: Easy data clearing between demo sessions

Results Presentation

Risk Score Display:

Your Health Risk Level: [MEDIUM RISK]

Overall Score: 215 out of 300 points

Risk Factors Identified:
- Physical Activity: Could use improvement
- Preventive Care: On track
- Mental Wellness: Excellent
- Daily Function: Good

Recommendation Types:

• Immediate Actions: "Consider scheduling a mammogram"
• Lifestyle Suggestions: "Adding 30 minutes of walking 3x/week could improve your score"
• Care Coordination: "Our care team will follow up about your diabetes management"
• Resource Connections: "You may benefit from our stress management program"

Charts/Visualizations:

• Risk Radar Chart: 5-point visualization showing strength in each chapter area
• Progress Timeline: Show improvement opportunities over time
• Comparison Charts: "Your score compared to others in your age group"
• Goal Setting Visual: Interactive elements to set health improvement goals

Follow-up Action Suggestions:

• High Risk: "A care coordinator will contact you within 2 business days"
• Medium Risk: "Consider these health resources and check back in 3 months"
• Low Risk: "Keep up the great work! Annual reassessment recommended"

Integration Requirements

Demo Ecosystem Fit:

• Seamless Integration: Works within existing MVP demo environment
• Brand Consistency: Matches MVP Healthcare visual identity
• Data Flow: Connects to other demo features (care coordination, member portal)

Data Export Formats:

• PDF Report: Comprehensive results summary for printing/sharing
• JSON Export: Technical data for integration testing
• CSV Format: Spreadsheet-compatible for analysis
• HL7 FHIR: Healthcare standard format for real system integration

Connection Points:

• Member Portal: Assessment results appear in member dashboard
• Care Team Dashboard: Risk flags appear in provider workflow
• Communication System: Automated follow-up messaging based on results

6. Success Metrics & Outcomes

Completion Criteria

Successful Completion Definition:

• Minimum Questions: Complete at least 45 of 51 questions (88% completion rate)
• Core Chapters: Must complete Chapters 1, 2, and 4 (foundation, physical, mental health)
• Quality Indicators: No more than 10% "don't know" responses
• Time Bounds: Complete within 30-day window from start

Quality Response Indicators:

• Consistency: Responses align across related questions
• Engagement: Time spent per question indicates thoughtful consideration
• Completion Pattern: Progressive completion rather than random skipping

Demo Effectiveness Metrics

User Engagement Indicators:

• Completion Rate: % of users who finish entire assessment
• Chapter Progression: % who complete each chapter
• Session Length: Average time spent per session
• Return Rate: % who return to complete after breaking
• Help Usage: How often users access explanation text

Behavioral Metrics to Track:

• Time per Question: Identify questions causing difficulty
• Break Patterns: Where users typically pause
• Error Rates: Questions requiring clarification or re-answering
• Device Usage: Mobile vs. desktop completion rates

Business Value Demonstrations:

• Cost Reduction: "Reduces phone assessment costs by 75%"
• Efficiency Gains: "Frees up 15 hours of staff time per day"
• Completion Improvement: "35% higher completion rate than phone surveys"
• Risk Identification: "Identifies high-risk members 48 hours faster"

User Experience Success Indicators

Engagement Quality:

• Positive Sentiment: Post-assessment satisfaction ratings
• Perceived Value: "This assessment was helpful for my health"
• Ease of Use: "This was easy to complete"
• Preference: "I prefer this to phone surveys"

Clinical Value Indicators:

• Risk Detection: % of high-risk members identified
• Intervention Triggers: Number of automatic care referrals generated
• Action Follow-through: % of members who act on recommendations
• Health Outcomes: Early indicators of health improvement

7. Content & Copy

Survey Content

Welcome Message: "Hi there! I'm Gia, your personal health assistant. I'm here to help you complete your health assessment - it's like getting to know each other so I can better support your wellness journey!

This assessment has been redesigned to be much easier than the old phone surveys. We've organized everything into 5 short chapters that you can complete at your own pace.

Ready to get started? This should take about 12-15 minutes total, and you can pause anytime."

Chapter Introductions:

Chapter 1: "Your Health Foundation" "Let's start with the basics! I'd like to understand your current health status and any medical history that's important for your care."

Chapter 2: "Movement & Energy" "Now let's talk about how you move through your day. These questions help us understand your activity level and any physical challenges you might be experiencing."

Chapter 3: "Prevention & Wellness" "Great progress! Let's focus on staying healthy and catching problems early. These questions are about screenings and healthy lifestyle choices."

Chapter 4: "Mind & Mood" "Your mental health is just as important as your physical health. These questions help us understand stress, mood, and emotional wellbeing."

Chapter 5: "Daily Living & Background" "Almost done! These final questions help us understand your daily life and what support might be most helpful for you."

Question Help Text Examples:

For Pain Scale Question: "💡 Pain Scale Help: Think of 0 as no pain at all, and 10 as the worst pain imaginable. Most people use 1-3 for mild discomfort, 4-6 for moderate pain, and 7-10 for severe pain that interferes with daily activities."

For Exercise Questions: "💡 Exercise Help: Cardiovascular exercise includes activities that make your heart beat faster and cause light sweating, but you can still talk. Examples: brisk walking, swimming, dancing, bike riding, or using gym equipment."

For Functional Assessment: "💡 Daily Activities Help: Choose the option that best describes your typical ability. 'Without help' means completely independent, 'some help' means you need assistance or special equipment, 'cannot do' means someone else must do it for you."

Interface Copy

Progress Messages:

• Starting: "Let's begin your health journey! 🌟"
• 25% Complete: "Great start! You're building a complete health picture. 📊"
• 50% Complete: "Halfway there! Your responses are really helpful. 💪"
• 75% Complete: "Almost done! Just one more chapter to go. 🎯"
• 100% Complete: "Congratulations! Your health assessment is complete! 🎉"

Encouragement Messages:

• After sensitive questions: "Thank you for sharing that personal information. It helps us provide better care. 💙"
• During difficult sections: "These questions can be challenging. Take your time - every answer helps. 🤗"
• Chapter completion: "Chapter complete! You're doing great - keep going! ⭐"

Error Messages:

• Required field: "This question helps us understand your health better. Could you please select an answer?"
• Invalid input: "Please check that entry - it looks like there might be a typo."
• Session timeout: "Your session has been saved. Click 'Continue' to pick up where you left off."

Guidance Text:

• Break reminders: "Need a break? Your progress is automatically saved. You can continue anytime!"
• Help availability: "Tap the '?' icon next to any question for more explanation."
• Navigation: "Use the 'Previous' button if you want to change an earlier answer."

Results Presentation Language

Risk Level Communications:

Low Risk Results: "🟢 Excellent Health Profile!

Your assessment shows you're doing great with your health management! Your responses indicate low risk across all major health areas.

Your Strengths:

• Strong physical activity habits
• Up-to-date with preventive care
• Good mental wellness practices
• Excellent daily functioning

Keep It Up:

• Continue your current healthy habits
• Maintain regular checkups
• Consider annual reassessment

A member of our wellness team may reach out with additional resources to help you maintain your excellent health."

Medium Risk Results: "🟡 Good Health with Opportunities

Your assessment shows you're managing your health well overall, with some areas where we can help you improve.

Areas of Strength:

• [Personalized based on responses]

Opportunities for Improvement:

• [Specific areas with lower scores]

Recommended Next Steps:

• [Tailored recommendations]
• Consider connecting with our care coordination team
• We'll follow up in 3-6 months to see how you're doing

A care coordinator will reach out within one week to discuss support options."

High Risk Results: "🔴 Health Needs Our Attention

Your assessment indicates several areas where our care team can provide immediate support and resources.

Immediate Priorities:

• [Specific high-risk factors identified]

We're Here to Help:

• A care coordinator will contact you within 2 business days
• You'll receive personalized care recommendations
• We'll connect you with appropriate specialists or programs
• Follow-up assessments will track your progress

Remember: Having risk factors doesn't mean anything is wrong - it means we can work together to keep you healthy and prevent problems before they start.

Expect a call from our care team by [specific date]. If you have urgent health concerns, please contact your doctor or call our 24/7 nurse line."

Personalized Recommendations

Physical Activity Recommendations:

• Low Activity: "Consider starting with 10-minute walks after meals. Our wellness coaches can help you build a comfortable routine."
• Moderate Activity: "You're doing well! Adding strength training 2x/week could boost your overall fitness."
• High Activity: "Excellent activity level! Focus on injury prevention and recovery strategies."

Preventive Care Recommendations:

• Missing Screenings: "You're due for [specific screening]. Our care team can help schedule this and explain what to expect."
• Up-to-Date: "Great job staying current with preventive care! We'll remind you when your next screenings are due."

Mental Health Support:

• Stress Indicators: "Your responses suggest you might benefit from stress management resources. Our behavioral health team offers excellent support."
• Depression Screening: "Some of your responses indicate we should check in about your mood. This is very common and we have great resources to help."
• Strong Mental Health: "Your mental wellness responses look excellent! Keep up those healthy coping strategies."

Additional Context

Current Pain Points Addressed:

• Phone Survey Length: "Reduced from 20 minutes to 12-15 minutes"
• Scheduling Difficulty: "Complete anytime, anywhere, at your own pace"
• Question Clarity: "Plain language explanations for every question"
• Engagement: "Gamified experience with progress tracking and achievements"
• Follow-up Gaps: "Immediate risk identification and care coordination triggers"

Target User Demographics:

• Age Range: 18-85+ years
• Technology Comfort: Low to high (designed for smartphone users but accessible to all)
• Health Literacy: 8th grade reading level accommodation
• Chronic Conditions: 60% of users have at least one chronic condition
• Cultural Diversity: Inclusive language and examples

Competitive Benchmarks:

• Healthcare Survey Completion: Industry average 45-60%
• Target Completion Rate: 75-85%
• User Satisfaction: Target Net Promoter Score >50
• Time Efficiency: 40% reduction from current phone process

Timeline Expectations:

• Phase 1 Development: 3-4 weeks (basic conversational flow)
• Phase 2 Enhancement: 2-3 weeks (gamification and visual polish)
• Phase 3 Integration: 1-2 weeks (demo ecosystem connection)
• Testing & Refinement: 1-2 weeks
• Total Timeline: 8-12 weeks for complete demo

Implementation Priority

Development Phases:

Phase 1: Core Functionality (Weeks 1-4)

• Basic chatbot conversation flow
• All 51 questions with proper branching logic
• Simple progress tracking
• Risk scoring algorithm
• Basic results presentation

Phase 2: Gamification (Weeks 5-7)

• Chapter-based organization
• Achievement system
• Enhanced progress visualization
• Motivational messaging
• Save/resume functionality

Phase 3: Polish & Integration (Weeks 8-10)

• Visual design enhancement
• Mobile optimization
• Demo ecosystem integration
• Performance optimization
• User testing and refinement

Phase 4: Demo Preparation (Weeks 11-12)

• Content finalization
• Demo scenario creation
• Training materials
• Launch preparation

This specification provides Lovable with everything needed to create a comprehensive, engaging, and clinically valuable Health Risk Assessment chatbot that transforms MVP Healthcare's member onboarding experience while achieving their goals of early intervention, cost reduction, and improved member satisfaction.