Gamification

Gamification (Beat the Bot)

Lastest includes an optional competitive scoring layer where team members compete against AI bots on a leaderboard. Designed to encourage test quality -- not test farming -- with rewards heavily weighted toward verified outcomes.

---

Enabling Gamification

Gamification is a per-team toggle, disabled by default.

1. Go to Settings
2. Find the Gamification toggle
3. Enable it

A season is auto-created on the first score award if none exists.

---

Scoring Rules

Event	Points	Notes
Test created	+10	Small to prevent test-farming
Approved a real visual change	+15	Diff approved as intentional change
Regression caught	+100	Your test caught a real regression
Resolved a review todo	+5	Closed a review todo item
Flaky diff penalty	-5	Flaky diff attributed to your test (daily cap: 25 pts)
Achievement unlocked	+25	Bonus on first-time achievement

Bug Blitz Multipliers

During Bug Blitz events, all scores (including penalties) are multiplied by a configurable factor (2-5x). Admins can create time-boxed Bug Blitz events from the admin card.

---

Achievements

Achievement	Trigger
First Test	Created your first test
First Regression	Caught your first regression
First Blood	Surpassed the bot score by 1+ points
Crushed the Bot	Surpassed the bot score by 100+ points
Season Winner	Ended the season in first place

---

Leaderboard

Navigate to /leaderboard to see the season standings.

• Top 10 ranked actors (humans and bots) with podium styling for top 3
• Per-actor breakdown: tests created, regressions caught, flakes incurred
• Your own row is appended if you're outside the top 10
• Only visible when gamification is enabled for your team

---

Seasons

Seasons are named periods (e.g. "Season 1") that scope all scores, achievements, and leaderboard rankings. Admins can:

• Start a new season
• End the current season
• Create Bug Blitz events within a season

When no season exists, one is auto-created on the first score event.

---

Admin Controls

Settings page includes a Gamification Admin card for team owners/admins:

• Enable/disable gamification for the team
• Start and end seasons
• Create Bug Blitz events with custom duration and multiplier

---

Real-Time Celebrations

When gamification is enabled, celebratory toast notifications appear in real-time via the existing activity feed SSE stream. Events are deduped by ID so you never see the same celebration twice.

---

Design Principles

1. Rewards >> penalties -- Penalty is small (-5) and daily-capped at 25 points
2. No "points for bugs found" -- That's a textbook perverse incentive. Rewards are tied to verified outcomes (approved changes, resolved todos)
3. Test creation reward is small -- Prevents test-farming
4. Never breaks real flows -- All gamification hooks swallow errors silently
5. Opt-in -- Disabled by default, per-team toggle