npx agentspec-cli install ef4ac14a-7364-4258-b9d9-bcf45b84254b --file-type cursor-rules→ .cursor/rules/
---
description: UX/UI principles and gamification best practices for engaging user experience
---
# QualityLeap - UX & Gamification Principles
## Core UX Philosophy
### Design Principles
1. **Instant Gratification**: Show immediate feedback for all actions
2. **Progress Visibility**: Always show how close users are to next goal
3. **Celebrate Wins**: Make achievements feel special with animations
4. **Reduce Friction**: Minimize clicks to see progress or claim rewards
5. **Autonomy**: Give users choices (quest selection, reward preferences)
6. **Social Connection**: Enable team celebrations and peer recognition
7. **Fairness**: Make rules transparent, never feel rigged
8. **Accessibility**: Ensure platform works for all users
### Avoid Anti-Patterns
- ❌ **Don't** create dark patterns that manipulate users
- ❌ **Don't** make progression feel like a grind
- ❌ **Don't** punish users (only reward positive behaviors)
- ❌ **Don't** create pay-to-win scenarios
- ❌ **Don't** make social comparison the only motivator
- ❌ **Don't** use misleading progress indicators
## Notification Design
### Notification Types
#### 1. XP Earned Notification
```
🌟 +100 XP
High Customer Satisfaction!
[Progress bar showing XP to next level]
250 XP to Level 16
```
**Best Practices**:
- Show immediately after action (< 500ms)
- Use celebratory animation (sparkle, bounce)
- Auto-dismiss after 5 seconds
- Allow manual dismissal
- Stack multiple notifications gracefully
#### 2. Level Up Notification
```
🎉 LEVEL UP! 🎉
You've reached Level 16!
Rewards:
• 50 Quality Coins
• New badge available: "Expert Agent"
[Continue Button]
```
**Best Practices**:
- Full-screen celebration modal
- Confetti or particle effects
- Clear reward summary
- Sound effect (with mute option)
- Don't auto-dismiss (requires user action)
#### 3. Badge Unlocked Notification
```
🏆 Badge Unlocked!
FCR Star - Bronze
You achieved 90%+ First Call Resolution rate!
[View Badge] [Continue]
```
**Best Practices**:
- Show badge image prominently
- Explain what was achieved
- Link to badge showcase
- Option to share (social feed)
#### 4. Streak Reminder
```
🔥 Don't break your streak!
You're on a 7-day performance streak!
Complete at least one quest today to keep it going.
[View Quests]
```
**Best Practices**:
- Send at optimal time (mid-day)
- Not too aggressive (once per day max)
- Show current streak count
- Clear call-to-action
- Easy to snooze/dismiss
### Notification Preferences
- Allow users to control notification types
- Quiet hours setting
- Frequency limits
- Channel preferences (in-app, email, push)
## Progress Visualization
### XP Bar Design
```
Level 15 ━━━━━━━●━━━━━━━━━━━ Level 16
1,250 / 2,000 XP (62%)
```
**Elements**:
- Current level clearly shown
- Progress bar with smooth animations
- Numerical progress (current/total)
- Percentage (optional)
- Next level indicator
- Color gradient (low to high)
### Badge Progress Cards
```
┌──────────────────────────┐
│ 🏃 5-Day Streak │
│ ━━━━━●━━━━━ 3/5 days │
│ Keep going! 2 more days │
└──────────────────────────┘
```
**Best Practices**:
- Show near-completion badges prominently
- Progress bars for progressive achievements
- Encouraging micro-copy
- Visual distinction (earned vs in-progress vs locked)
### Quest Progress
```
Daily Quest: Handle 5 Billing Cases
━━━━━━━━━━━━━━━━━━━●━━ 4/5 completed
Reward: 100 XP + 25 Quality Coins
```
**Best Practices**:
- Real-time progress updates
- Clear completion criteria
- Reward preview
- Time remaining (for time-bound quests)
## Leaderboard Design
### Team Leaderboard
```
🏆 Weekly Team Leaderboard - Total XP
Rank Team Name Score Trend
───────────────────────────────────────
1 🥇 Alpha Squad 12,450 ↑ 2
2 🥈 Beta Team 11,980 ↓ 1
3 🥉 Gamma Force 11,750 ↑ 1
4 ⭐ Your Team 10,200 ↑ 3 ← YOU
5 Delta Warriors 9,875 ↓ 2
```
**Best Practices**:
- Highlight user's position prominently
- Show rank change indicators (↑↓)
- Use medals/icons for top 3
- Show relative position (+/- 5 ranks)
- Filter options (time range, metric)
- "Your Rank" quick jump button
### Avoid Negative Effects
- Don't shame bottom performers
- Segment leaderboards by experience level
- Emphasize team over individual
- Show personal bests alongside rankings
## Reward Catalog Design
### Reward Card
```
┌─────────────────────────┐
│ [Image of reward] │
│ Trendyol Gift Card │
│ ₺100 │
│ │
│ 💰 500 Quality Coins │
│ ✓ In Stock │
│ [Redeem Now] │
└─────────────────────────┘
```
**Elements**:
- High-quality images
- Clear pricing
- Stock availability
- Category badges
- Redemption button
- Wishlist/favorite option
### Redemption Flow
1. **Browse**: Filterable catalog (category, price)
2. **Preview**: Detailed view with terms
3. **Confirm**: Show cost, verify balance
4. **Process**: Loading state with progress
5. **Success**: Confirmation with next steps
6. **Track**: Redemption status page
### Price Display
- Always show user's current balance
- Indicate if affordable (green) or not (gray)
- Show "X more coins needed" for expensive items
- Suggest earning opportunities
## Social Features
### Activity Feed
```
┌────────────────────────────────────┐
│ 🏆 Sarah Chen earned "AHT Master" │
│ 2 minutes ago │
│ [👏 12] [Comment] │
├────────────────────────────────────┤
│ ⬆️ Alex Kim reached Level 20! │
│ 1 hour ago │
│ [🎉 24] [Comment] │
├────────────────────────────────────┤
│ 💬 Mike sent kudos to Jessica │
│ "Great teamwork on complex case"│
│ 3 hours ago │
│ [❤️ 8] │
└────────────────────────────────────┘
```
**Best Practices**:
- Mix of activity types
- Chronological with timestamps
- Easy reactions (one-click)
- Privacy controls (opt-out option)
- Filter by team or friends
- Real-time updates (WebSocket)
### Peer Recognition
```
Send Kudos to a Teammate
To: [Select teammate ▼]
Message: [Text area]
Category:
○ Helpful ○ Empathy ○ Teamwork
○ Innovation ○ Quality
[Send Kudos - 1 point remaining this week]
```
**Best Practices**:
- Limited weekly allocation (prevents spam)
- Pre-defined categories
- Optional message
- Recipient gets notification + XP bonus
- Public or private option
## Profile Page
### Personal Profile Layout
```
┌──────────────────────────────────┐
│ [Avatar] Sarah Chen │
│ Level 23 - Expert Agent│
│ Team Alpha Squad │
├──────────────────────────────────┤
│ Stats │
│ Total XP: 15,430 │
│ Badges: 18/50 │
│ Quality Coins: 850 │
│ Rank: #12 in team │
├──────────────────────────────────┤
│ Pinned Badges │
│ [🏆] [⭐] [🔥] │
├──────────────────────────────────┤
│ Recent Activity │
│ • Earned FCR Star (Gold) │
│ • Completed 7-day streak │
│ • Reached Level 23 │
└──────────────────────────────────┘
```
**Features**:
- Customizable avatar/banner
- Key stats at-a-glance
- Badge showcase (pinning feature)
- Recent achievements timeline
- Privacy toggles
- Edit profile option
## Onboarding Experience
### First-Time User Flow
1. **Welcome**: Brief intro to platform value
2. **Avatar Setup**: Personalize appearance
3. **Tutorial**: Interactive walkthrough of key features
4. **First Quest**: Guided completion of simple quest
5. **First Reward**: Immediate small win (50 XP, easy badge)
6. **Team Introduction**: Meet your team on leaderboard
7. **Goal Setting**: Choose focus areas
### Progressive Disclosure
- Don't overwhelm with all features at once
- Unlock features as user progresses
- Contextual tooltips for new features
- "What's New" announcements for updates
## Color Psychology
### Color Scheme
- **Primary (Blue)**: Trust, stability, professionalism
- **Success (Green)**: Achievement, growth, positive feedback
- **Warning (Yellow/Orange)**: Attention, streak warnings
- **Celebration (Gold/Purple)**: Special achievements, rare badges
- **Neutral (Gray)**: Background, inactive states
### Visual Hierarchy
- **High emphasis**: XP bar, level, active quests
- **Medium emphasis**: Badges, leaderboard, social feed
- **Low emphasis**: Settings, terms, footer
## Animation Guidelines
### Timing
- **Micro-interactions**: 200-300ms (hover, button press)
- **Progress updates**: 500ms (XP bar fill)
- **Page transitions**: 300-400ms
- **Celebrations**: 1-2s (level up, badge unlock)
### Animation Types
- **Entrance**: Fade in, slide up
- **Exit**: Fade out, slide down
- **Attention**: Pulse, bounce (sparingly)
- **Progress**: Smooth fills, count-ups
- **Celebration**: Confetti, particle effects
### Performance
- Use CSS transforms (hardware accelerated)
- Reduce motion for accessibility
- Limit simultaneous animations
- Lazy load heavy animations
## Mobile-First Considerations
### Touch Targets
- Minimum 44x44px touch targets
- Adequate spacing between interactive elements
- Swipe gestures for navigation
- Pull-to-refresh on feeds
### Mobile Optimizations
- Bottom navigation for key features
- Simplified layouts on small screens
- Collapsible sections
- Native-like interactions
- Offline state handling
## Accessibility
### WCAG 2.1 AA Compliance
- Color contrast ratios ≥ 4.5:1
- Keyboard navigation support
- Screen reader compatibility
- Alt text for all images
- Focus indicators
- Skip navigation links
### Inclusive Design
- Support for reduced motion
- Text resize up to 200%
- Clear error messages
- Multiple ways to complete tasks
- Adjustable notification preferences
## Gamification Ethics
### Responsible Design
- **Transparency**: Clear rules and criteria
- **Fairness**: Equal opportunity to succeed
- **Wellness**: Don't encourage overwork
- **Privacy**: Opt-in for social features
- **Autonomy**: Users control their experience
- **Meaning**: Tie game elements to real value
### Red Flags to Avoid
- Manipulative scarcity tactics
- Endless grinding mechanics
- Exploitative social pressure
- Hidden costs or requirements
- Addictive patterns that harm wellbeing
- Metrics that encourage bad customer service
## Performance Feedback
### Constructive Approach
- Focus on **growth** over **judgment**
- Show **progress** not just absolute position
- Highlight **strengths** alongside areas for improvement
- Provide **actionable insights** (e.g., "75% of top performers complete 3+ quests daily")
- Use **benchmarks** not comparisons (beat your personal best)
### Manager Dashboard Considerations
- Aggregate data to protect individual privacy
- Flag issues discreetly (no public shaming)
- Provide coaching resources
- Celebrate team wins collectively
animate
Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. Use when the user mentions adding animation, transitions, micro-interactions, motion design, hover effects, or making the UI feel more alive.
by AgentHub Crawler
onboard
Designs and improves onboarding flows, empty states, and first-run experiences to help users reach value quickly. Use when the user mentions onboarding, first-time users, empty states, activation, getting started, or new user flows.
by AgentHub Crawler
critique
Evaluate design from a UX perspective, assessing visual hierarchy, information architecture, emotional resonance, cognitive load, and overall quality with quantitative scoring, persona-based testing, automated anti-pattern detection, and actionable feedback. Use when the user asks to review, critique, evaluate, or give feedback on a design or component.
Sign in to leave a comment.
by AgentHub Crawler