# 03 — Kevin, the AI Coach > **Kevin is the AI inside SwoleX.** He's not a chatbot. He's not a wellness companion. He's a coach — one who programs your sessions, scales your weights, grades your training, and respects your injuries. This document is the canonical brief for **anyone — human or model — writing copy about Kevin**. Internally, the codebase still uses generic names ("AI Coach," "AI Trainer," "AI engine"). For marketing, app store listings, ads, videos, social, landing pages, voiceover, and presser, **call him Kevin**. --- ## Why Kevin? Lifting AI products have a sameness problem. They all sound like: - "AI-powered training plans" - "Smart workout generator" - "Adaptive AI coach" Nobody remembers any of it. **A first name is a memorable hook in a category of jargon.** Kevin is approachable. Not intimidating. Not "AI Trainer 9000." He's the guy at the gym who's been lifting for 15 years, knows your numbers, doesn't waste your time, and tells you when to back off. Friendly authority. > *"What did Kevin program for you today?"* — the line that sells the app at the bar. --- ## How to talk about Kevin ### ✅ DO - Call him **Kevin**. First name only. - Use third person: *"Kevin reads your last 90 days of lifting and..."* - Treat him as an active agent: *"Kevin spotted that you've under-trained pull all month."* - Verbs Kevin does: **programs**, **scales**, **swaps**, **calibrates**, **grades**, **flags**, **suggests**, **respects** (injuries). - Be specific: *"Kevin runs your sets through real plate math so you never see 47.3 lbs."* ### ❌ DON'T - Don't call him "AI Kevin" or "Kevin the AI." Just Kevin. - Don't say "Kevin learns" without proof — say what he *uses* (5RM history, post-workout ratings, etc.). - Don't say "Kevin understands you." Say what he sees: history, goals, injuries, equipment. - Don't anthropomorphize beyond coaching. Kevin is a coach, not a friend, not a therapist, not a hype man. - Don't mention model names (Gemini, Claude, GPT) in consumer-facing copy. Save those for technical / investor / partner contexts. ### Tone of Kevin's own voice (when he speaks in the UI) When Kevin generates a description, a coaching cue, or a training-report comment, his voice is: - **Direct.** Short sentences. No hedging. - **Specific.** "Your bench-to-row ratio is 1.4 — push rows for two more weeks." Not "consider rebalancing." - **Honest.** He'll grade you a C if you earned a C. - **No emoji.** He's a coach, not a bro. - **Goal-aware.** He knows whether you're chasing strength or size and grades accordingly. - **Slight lifter vernacular.** OK to say "destroyed," "brutal," "punish your delts." Never "wellness," "balance," "journey." A sample Kevin recommendation (from the actual training-report output style): > *Calibration: 67% for strength. You're leaving roughly 35 lbs on the bar every working set. For a 4-week strength block, push your top set to a real 3-rep max and back off only after.* --- ## What Kevin actually does Kevin is not one feature — he's the AI surface across the entire product. Here's the full inventory. ### 1. AI WORKOUT — generate a session **Where:** Log tab → **+** → ⚡ **AI WORKOUT** **What you give him:** - Duration (15–180 min) - Muscle focus (chest / back / legs / full body / push / pull / etc.) - Intensity vibe (`im_not_feeling_it` / `standard` / `put_the_hurt_on` / `destroy_me` / `recovery`) - (Implicit) Your gym profile, fitness profile, recent history, injury directives, post-workout calibration signal **What he returns:** - Exercise list with sets, reps, weights, rest seconds, set type (normal / superset / drop), per-exercise coaching cue - Estimated duration - Optional rationale ("focused horizontal push given your recent vertical-pull bias") **Marketing payoff:** *"Kevin builds a full session in seconds — pulled from a catalog of 437 exercise variants, scaled to your plate math, and gated by your gym's actual equipment."* ### 2. AI weight scaling — make someone else's workout yours **Where:** Feed → tap **I GOT THIS** or **CHALLENGE ACCEPTED** on any workout card **What he does:** - Looks at the original creator's working weights - Computes the equivalent for *you* via 1RM ratio (your strength ÷ their strength × their working weight) - Snaps to your real available plates (lbs / kg, equipment-aware) - Sanity-checks drop ladders (≥ 10% drop per step or one real plate increment) - Returns the same workout, your weights **Marketing payoff:** *"Tap any post. Kevin's already done the math. Walk to the rack."* ### 3. Exercise swap — mid-workout substitution **Where:** Active workout → exercise menu → **SWAP** **Reasons he handles:** - Equipment unavailable - Too hard / too easy - Form concern - Injury flare **What he returns:** - A replacement exercise from the catalog - Adjusted sets / reps / weight - A one-line coaching cue - Preserves the muscle group, force type, and compound/isolation intent of the original ### 4. Conditioning circuits **Where:** Log → 🕒 **CONDITIONING CIRCUIT** Kevin generates an interval-based circuit (AMRAP / EMOM-style): - Round count - Work seconds / rest between exercises / rest between rounds - Exercise list with form cues - Equipment-aware (strict AND filter — every piece must be present) The CIRCUIT PLAYER then runs hands-free with color-coded phases and haptics. ### 5. Program builder **Where:** Creator / Trainer console → Program editor Two entry points: - **✦ AI generate-day** — Kevin fills one day's exercises with progressive-overload awareness of the program week - **✦ AI generate-full** — Kevin scaffolds an entire 4–12 week program from goal + difficulty + days/week + equipment Difficulty enforcement: - Beginner: exactly 4 exercises × 3 sets, selectorized machines preferred, no supersets / no drops - Intermediate: 4–5 exercises × 3–4 sets, supersets allowed - Advanced: 5–6 × 4–5 with supersets and drops encouraged - Strength override: straight sets only, rep ranges 3–6 ### 6. Training report — Kevin grades your training **Where:** Progress tab → **AI Coach** segment → pick period + scope **Free tier (algorithmic, deterministic):** - Volume trend (slope in lbs/session) - Calibration % (actual weight ÷ goal-appropriate expected weight × 100) - Scheme compliance (% of sessions meeting goal rep ranges) - Muscle frequency **Pro tier (Kevin's analysis):** - **Trainer grade A–F** - **Calibration verdict** ("you're under-loading," "you're at peak appropriate intensity for hypertrophy," etc.) - **Muscle balance** flag (push:pull ratio, upper:lower volume) - **Plateau detection** (volume trend + PR cadence) - **Goal-alignment check** (are your rep ranges matching your stated goal?) - **NSCA-benchmarked comparison** vs. lifters of your experience level - **Top 3 specific recommendations** - **PDF export** (with inline SVG charts) ### 7. Calibration learning — Kevin gets better over time **Where:** Post-workout completion modal Kevin asks: *"How was that?"* - `too_easy` (+1 signal) - `just_right` (0) - `destroyed_me` (-1) These ratings aggregate into a **per-user, per-exercise** weight adjustment factor that feeds into every future generation. Hated leg day's prescribed 245? Rate it `destroyed_me` → Kevin drops volume / weight on legs next time. ### 8. Onboarding seed (optional) If a brand-new user has zero history, Kevin asks one question per major lift: > *"What can you bench for 8 reps?"* That single number seeds the entire calibration model. From there, every set the user logs refines it. ### 9. Trainer client analysis **Where:** Trainer console → Client → **AI Report** Same as the personal training report, but scoped to **trainer-assigned program sessions only**. Trainers don't see private "Run It Back" sessions or other coaches' assigned work. ### 10. AI content moderation **Where:** Behind the scenes on comments, names, program descriptions Two-stage: 1. Keyword blocklist (always on, free) 2. LLM moderation (OpenAI `omni-moderation-latest` free tier, Claude Haiku fallback) Fail-open if the AI is down — blocklist stays. --- ## What Kevin knows about you This is the **context block** Kevin gets on every generation. 30+ signals, all derived from real product data: ### Identity & goals - Age, sex, height, weight - Training goal (strength / hypertrophy / endurance / general wellness) - Training level (beginner / intermediate / advanced / elite) ### Strength baselines - Self-reported maxes (bench / squat / deadlift if entered) - **5RM inferences** from logged history - Per-exercise calibration factor (rolling) - Per-movement-pattern strength estimates (vertical pull vs. horizontal pull tracked separately) ### Capabilities & limitations - Capability flags ("can't do push-ups," "stairs make me winded") - **Structured injuries** with per-region directives: - Body region (lower back, knee, shoulder, etc.) - Hard-block vs. avoid-loading vs. light-load-OK - The directive text injected verbatim into the prompt - Cardio benchmarks (if logged) ### Equipment - Active gym's equipment list (multi-select from 174 equipment types) - Dumbbell-pair max - Plate-pair max - Custom increment overrides ### Preferences - Supersets / drop sets / straight sets (toggles fed straight into the prompt) - Unit system (imperial / metric) - Rest-timer defaults ### Recent training context - Last 14 days of sessions (volume, frequency, muscle distribution) - Recent PRs - Recovery window (don't smash chest two days in a row) - Post-workout difficulty ratings (rolling signal) ### Session intent - Today's duration, focus, intensity vibe --- ## Sample marketing lines (drop-in) **Headline tier:** - *"Meet Kevin. He builds your workout, scales your weights, and grades your training. He's the coach in your pocket — without the $200/hr."* - *"Kevin's been watching every set you log. He knows when you're cheating. Tap **AI WORKOUT**."* - *"Strong saves your sets. Kevin programs them."* **Subhead tier:** - *"Kevin reads your last 90 days of lifting and writes today's session in seconds."* - *"Every weight on every set, scaled to your plate math, gated by your gym."* - *"Tap a friend's workout. Kevin's already done the math. Just lift."* **Feature-section lead-ins:** - *"**Workout generation, done right.** Kevin doesn't pull from a template library. He builds your session from scratch — anchored to your history, your goal, your gym, and how you said the last one felt."* - *"**Injuries you don't have to think about.** Add an injury, answer three questions, and Kevin programs around it forever. No annotation. No reminder. He just substitutes."* - *"**A training report a coach would write.** Kevin grades your last 30, 90, or 365 days — calibration, muscle balance, plateau detection, top three things to fix. Export to PDF. Hand it to your trainer."* **Social / TikTok hook tier:** - *"POV: you tap I GOT THIS on your buddy's chest day and Kevin already rounded every weight to your dumbbells."* - *"My AI coach grades me C+ on hypertrophy this month. He's right."* - *"Kevin gave me a 4-day program in 8 seconds. It's better than the one my old PT wrote."* --- ## What NOT to claim about Kevin For legal and tonal safety: - ❌ Don't claim Kevin gives **medical advice**. He coaches lifting. He flags injuries; he doesn't diagnose. - ❌ Don't claim Kevin **predicts injury**. He honors what you tell him. - ❌ Don't claim "**proven to increase strength X%**." That requires a clinical study we haven't done. - ❌ Don't claim Kevin **replaces a coach**. He augments. ("Without the $200/hr" is fine — implies value, not replacement.) - ❌ Don't compare directly to specific competitor AI features in paid ads (legal risk). Comparisons are fine in editorial / earned media. --- ## Sample voiceover script (30-second spot) > *(Gym ambient, plates clanking. Cut to phone screen — feed scrolling.)* > > **VO (lifter, mid-30s, dry):** "I used to write my own workouts on a Notes app. Then I used to copy them from a coach." > > *(Tap a feed card. CHALLENGE ACCEPTED. Workout loads. Weights scale on-screen.)* > > "Now Kevin does it. He reads what I lifted last week. He knows my gym. He scales the weights when I copy my buddy's session." > > *(Cut to Progress → AI Coach. Letter grade lands: B+. Bullet list scrolls.)* > > "He grades me when I'm slacking. He swaps exercises when my shoulder's barking." > > *(SwoleX logo, single line of copy:)* > > **SUPER:** *Kevin's in the app. The app is free.* > > **VO:** "SwoleX." --- ## Versioning the brand If at any point we sunset "Kevin" or evolve the persona (e.g., add a second AI coach with a different specialty), update **this document first**, then propagate. This is the single source of truth for the AI-coach brand voice.