# 🎲 SPARK — Couples Intimacy Game: Design Document v1

---

## 1. Elevator Pitch

A mobile game for couples that transforms foreplay into a playful, skill-based discovery system. Partners take turns predicting each other's desires, exploring fantasies without judgment, and building erotic tension through structured play — powered by the same algorithms that drive prediction markets and probability scoring.

---

## 2. Target Audience

- **Primary:** Couples in long-term relationships (1+ years) looking to break routine
- **Secondary:** New couples who want a structured way to explore each other
- **Tertiary:** Couples with desire discrepancy (one wants sex more than the other)
- **Age:** 25-55, comfortable with their phones
- **Key insight from the literature:** Most intimacy problems aren't about "not enough sex" — they're about mismatched desire styles, unspoken fantasies, and routine. SPARK treats these as game mechanics, not pathologies.

---

## 3. The Core Problem (Barriers = Mechanics)

Based on AI analysis of 12 books, the game addresses these specific barriers:

| Barrier | How the Game Addresses It |
|---------|--------------------------|
| **Desire Discrepancy** | Lower-desire partner controls pace via the "Brake Meter" — no pressure to escalate |
| **Responsive Desire** | Game starts with non-sexual connection activities BEFORE any erotic content |
| **Performance Anxiety** | Prediction mechanics (guessing your partner) redirect focus from "performing" to "attuning" |
| **Body Image** | Blindfold / sensory prompts remove visual judgment |
| **Routine / Boredom** | 7 fantasy genre decks + Coolidge Effect (no repeat prompts) |
| **Fear of Rejection** | Asymmetric disclosure — both answer first, then reveal together |
| **"Roommate" Dynamic** | Dual-mode system: Connection (intimacy) ↔ Separation (erotic distance) |
| **Not Knowing What You Want** | The Yes/No/Maybe sorting system lets the cards ask for you |
| **Ignorance of Partner** | Prediction points reward accurate guesses — learning your partner IS the game |

---

## 4. Core Game Loop

```
┌─────────────────────────────────────────────────────────────┐
│                    SESSION FLOW                              │
│                                                              │
│  1. BRAKE CHECK ──► 2. CONNECTION ──► 3. PREDICTION        │
│       ↓                  ↓                ↓                  │
│   "How's your         Non-sexual      "What do they         │
│    body right         grounding /     want?" Guess &        │
│    now?" Scale        attunement      score points           │
│    1-10                                                      │
│                                                              │
│         ┌────────────────────────────────────┐               │
│         │  4. REVEAL ──► 5. CHALLENGE        │              │
│         │     ↓              ↓                │              │
│         │  Both answers   If right: erotic   │              │
│         │  shown at once  If wrong: truth    │              │
│         └────────────────────────────────────┘               │
│                                                              │
│  6. DEBRIEF ──► "What surprised you?" + Calibration update   │
│                                                              │
│  Repeat 3-6 rounds per session.                              │
└─────────────────────────────────────────────────────────────┘
```

---

## 5. The Prediction Layer (Kelly + Edge + Calibration)

This is what makes SPARK different from every other couples game. The same mechanics that power prediction markets and professional gamblers sit underneath the fun:

### 5a. The Confidence Slider

Each time a player guesses their partner's preference, they set a **confidence slider** (50% = pure luck, 95% = dead certain). The slider is the mathematical interface between intuition and the algorithm.

### 5b. Kelly Bet Sizing (Bankroll Mechanic)

Each player has a **Connection Bankroll** (starting 100 tokens per session).

- On each prediction, they wager a percentage of their bankroll
- The **optimal bet size** is determined by the **Kelly Criterion**:
  - **Edge** = their actual calibration accuracy × confidence
  - Kelly formula: `f* = (p × edge - (1-p)) / edge`
  - Simplified for the game: Bet more when you're confident AND accurate
- Betting too little = slow growth (you're not leveraging your knowledge)
- Betting too much = ruin (even good predictors have variance)

**The effect:** Players learn to calibrate their confidence. If they're always 95% confident but only 60% accurate, they go broke. The game naturally teaches better self-awareness.

### 5c. Brier Score (Calibration Tracking)

Each prediction is scored with the **Brier Score** — the squared error between confidence and outcome:

```
Brier = (confidence - actual)²
```

- A perfect prediction (95% confident, correct) = (0.95 - 1)² = 0.0025
- An overconfident miss (95% confident, wrong) = (0.95 - 0)² = 0.9025
- A humble correct call (55% confident, correct) = (0.55 - 1)² = 0.2025

**Player-facing version:** After 10+ predictions, the game shows:
- **Your Calibration Curve** — a chart of "What you said" vs "What happened"
- **Over/Under Confidence Score** — "You tend to be 15% more confident than your accuracy warrants"
- **Brier King/Queen title** — "Best calibrated player this week"

### 5d. Edge Discovery (Learning Your Partner)

"Edge" in this game isn't market inefficiency — it's **how well you know your partner**. The algorithm tracks:

- Which genres you predict best (fantasy, romance, sensory, boundaries)
- Which areas you overestimate your knowledge (common trap: assuming you know what your partner wants in areas they've never expressed)
- Growth over time — your calibration improves the more you play

The **Edge Score** is displayed as: "You have a +12% edge over random chance with your partner in the 'Novelty' genre. In 'Power Dynamics,' you're 8% worse than random guessing."

---

## 6. Two Game Modes

### Mode A: Connection (🧡)

Focus: Intimacy, safety, grounding. Use this when the relationship needs warmth.

| Prompt Type | Examples |
|------------|----------|
| **Appreciation** | "Tell your partner something they did this week that made you feel loved." |
| **Sensory Grounding** | "Sit facing each other. Breathe together for 90 seconds. Notice without changing." |
| **Memory Share** | "What was the moment you knew you wanted to be with this person?" |
| **Curiosity** | "What's something you've been thinking about that you haven't shared?" |
| **Non-sexual Touch** | "Trace your partner's palm. Try to memorize every line and ridge." |

**Rewards:** Trust Tokens, Safety Points, Slow Arousal (hidden meter)

**Visual:** Warm colors (amber, rose), soft gradients, slow animations.

### Mode B: Separation (🔥)

Focus: Mystery, distance, erotic tension. Use this when the relationship needs spark.

| Prompt Type | Examples |
|------------|----------|
| **Role-Play** | "You're strangers at a hotel bar. Introduce yourself. Your partner doesn't know you." |
| **Prediction / Guessing** | "Which body part does your partner most want you to kiss right now? Place your bet." |
| **Fantasy Share** | "Describe the most elaborate scene you can imagine — setting, sounds, smells. No judgment." |
| **Forbidden Truth** | "What's something you've been curious about but haven't mentioned? The game is your safe space." |
| **Sensory Deprivation** | "Partner A: put on a blindfold. Partner B: touch three different surfaces to their skin. Guess what they are." |

**Rewards:** Erotic Charge Points, Anticipation Tokens

**Visual:** Dark mode with warm accent colors (deep red, amber glow), quicker transitions.

---

## 7. Mechanic Breakdown

### 7a. Yes / No / Maybe Sorting

The core onboarding mechanic. Inspired by The Ethical Slut and recommended by all 3 AI models.

- Each player gets a deck of 30-50 cards (acts, scenarios, sensations)
- They sort each card into: **Yes** / **No** / **Maybe** / **Curious**
- Results are compared. The game highlights:
  - **Shared Yes** — immediate matches, highest confidence zone
  - **Shared Curious** — "You're both wondering about this. Want to explore together?"
  - **One Yes / One No** — "Different preferences here. That's normal. Skip Token available."
  - **One Curious / One Yes** — "Your partner is interested. You're curious. Green to explore slowly."
- This becomes the player's **Desire Map** — stored and referenced by prediction prompts

### 7b. The Brake Meter

Before any escalation, the game checks context. Visible at all times.

- **Stress Level** (1-10): "How present is your body right now?"
- **Body Image** (1-10): "How comfortable do you feel being seen?"
- **Energy Level** (1-10): "How much do you have left today?"
- **Brake score** = average of all three

**Rule:** If either partner's brake score > 6, the game defaults to Connection Mode and suggests brake-release activities:
- 2-minute breathing exercise
- One compliment exchange
- "No pressure, no expectation — just be together."

Players can manually override (skip token) but the game recommends not.

### 7c. The Curiosity Engine

The game tracks everything to generate better prompts:

- **What you've answered accurately** → harder questions in that genre
- **What you've avoided** → the game gently circles back
- **What you got wrong** → more learning opportunities
- **Genre fatigue** → the Coolidge Effect blocks same-genre prompts (variety is enforced)

Over time, the game builds a **Relationship Profile** — what each partner values, fears, desires, and what they think the other values. The prediction questions get sharper the more you play.

### 7d. Skip Token & Substitution Card

- Each player gets **3 Skip Tokens per session** — use one to skip any prompt. No explanation. No score penalty.
- Each player gets **1 Substitution Card** — replace the current prompt with your own ("Instead of that, I'd rather we try X")

These are the **Safety Nets** — they build trust that boundaries will be respected.

### 7e. The Fantasy Genre System

Based on Lehmiller's 7 fantasy categories. At setup, players select 1-3 genres:

| Genre | Theme | Best For |
|-------|-------|----------|
| **Passion & Romance** | Emotional connection, setting, atmosphere | Partners who value intimacy over novelty |
| **Power & Surrender** | Control exchange, trust, BDSM-lite | Couples curious about dynamics |
| **Novelty & Adventure** | New experiences, toys, locations | Couples in a rut |
| **Taboo & Forbidden** | Fantasy-only zone, imagination play | Couples who love dirty talk |
| **Group & Multi-Partner** | Fantasy exploration, jealousy navigation | Couples with strong trust |
| **Non-Monogamy** | Open relationship exploration | Couples questioning structure |
| **Identity & Gender Play** | Role reversal, gender-bending | Couples comfortable with fluidity |

Each genre has 3 intensity levels (Mild → Medium → Spicy). Players can switch genres mid-session.

---

## 8. Progression System (Why You Keep Playing)

### Session Level

| Metric | What It Measures |
|--------|-----------------|
| **Attunement Score** | How well you predict your partner (calibration) |
| **Disclosure Depth** | How much you've shared (cumulative) |
| **Variety Score** | How many different genres you've explored |
| **Connection Balance** | Ratio of Connection to Separation play |

### Relationship Level (Long-term)

- **Fantasy Map** grows over time — the game builds a detailed picture of shared desire
- **Calibration Curve** improves — you actually get better at knowing your partner
- **Archetype Assignment** — after 10 sessions, each player gets an archetype (The Explorer, The Romantic, The Catalyst, The Anchor)
- **Streak Bonuses** — play 3 sessions in a week = bonus tokens

### The Bankroll

The Kelly-based bankroll persists across sessions. A player who is:
- **Well-calibrated** → bankroll grows → can attempt harder challenges
- **Overconfident** → bankroll shrinks → must build back with easier prompts
- **Too conservative** (always bets 1%) → slow growth → nudged to take more risks

---

## 9. Tech Architecture (MVP)

### Stack

- **Frontend:** Mobile web app (PWA) — React/Vue, works in browser + installable
- **Backend:** Python/Flask (same stack as Oracle) — API handles game logic
- **Database:** SQLite (single file, fast, easy) → PostgreSQL if needed at scale
- **Hosting:** Hetzner VPS — same server as knowledge base

### Data Model

```
Players: id, partner_pairing_id, calibration_data, archetype
Sessions: id, pair_id, mode, brake_scores, date
Predictions: id, session_id, player_id, prompt_id, confidence, outcome, brier_score
PromptDecks: id, genre, intensity_level, prompt_text, response_type
DesireMaps: player_id, card_id, rating (yes/no/maybe/curious)
```

### MVP Scope (Build This First)

1. **Account setup** — enter your partner's code to pair
2. **Yes/No/Maybe sorting** — 3 starter decks (Romance, Sensory, Power)
3. **Brake Check** — 3 questions before each session
4. **Prediction game loop** — 5 rounds of "Guess → Reveal → Score"
5. **Two modes** — Connection and Separation
6. **Skip Token** — 3 per session
7. **Bankroll + Kelly** — basic implementation (simplified)
8. **Calibration display** — "Your accuracy: 68% / Your confidence: 74%"

### Post-MVP

- Fantasy Genre System (all 7)
- Archetype assignment
- Brier score history + calibration curve chart
- Coolidge Effect (anti-repetition)
- Session reminders / streak tracking
- Shared fantasy map visualization

---

## 10. What Makes This Different

| Other Couples Games | SPARK |
|--------------------|-------|
| Truth or Dare spinner | Prediction-based skill system |
| One-size-fits-all prompts | 7 fantasy genres, intensity levels |
| No progression | Bankroll, calibration, archetypes |
| Pressure to perform | Brake Meter, Skip Tokens, Safety Nets |
| Shuffle same content | Coolidge Effect — novelty enforced |
| No learning | Algorithm builds a relationship profile |
| No science backing | Dual Control Model + Ethical Slut + Lehmiller's research |

---

## 11. Open Questions for Iteration

- Should it be synchronous (both phones, real-time) or asynchronous (one plays, then the other)?
- Anonymous mode for fantasy sharing (or always face-to-face)?
- How to handle couples who break up — delete data?
- Name: SPARK? EMBER? WANT? ATLAS? Other?
- Freemium model? Paid app? Subscription?

---

*Design doc v1 — May 31, 2026*
*Sources: Come As You Are, Come Together, Mating in Captivity, The Ethical Slut, Tell Me What You Want, She Comes First, Oxford Handbook of Gambling, Kelly Capital Growth Criterion, Prediction Markets Fundamentals + AI team synthesis*