Add Kalei documentation
- App blueprint - Brand guidelines and metaphor - Complete design specification - Mirror feature documentation - Spectrum phase 2 plan Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
commit
43489eb53c
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,403 @@
|
|||
# Kalei — Brand Metaphor & Experience Design
|
||||
|
||||
## The Core Metaphor
|
||||
|
||||
A kaleidoscope takes broken, random fragments of glass and reveals them as beautiful, symmetrical patterns. It never changes the pieces — it changes the **angle**. Turn it once, and chaos becomes art. Turn it again, and the same fragments form something entirely new.
|
||||
|
||||
**Kalei does the same thing with your thoughts.**
|
||||
|
||||
Your situation hasn't changed. Your circumstances are the same fragments they were a moment ago. But Kalei shifts the angle — and suddenly you see the pattern, the meaning, the opportunity that was always there.
|
||||
|
||||
This isn't toxic positivity. A kaleidoscope doesn't pretend the glass isn't broken. It proves that broken things can still be beautiful.
|
||||
|
||||
---
|
||||
|
||||
## Brand Vocabulary
|
||||
|
||||
Every app builds an unconscious vocabulary through the words it uses in buttons, headers, notifications, and empty states. Kalei's vocabulary should reinforce the metaphor without being heavy-handed.
|
||||
|
||||
### Primary Terms (Use Frequently)
|
||||
|
||||
| Instead of... | Kalei says... | Why |
|
||||
|----------------------|----------------------|--------------------------------------------------------|
|
||||
| Reframe | **Turn** | You "turn" a kaleidoscope to see a new pattern |
|
||||
| Negative thought | **Fragment** | Broken glass — raw material, not a flaw |
|
||||
| Reframed perspective | **Pattern** | The beautiful arrangement revealed by a new angle |
|
||||
| Journal entry | **Reflection** | Light + mirrors = what a kaleidoscope runs on |
|
||||
| Daily session | **Turn of the day** | Each day you take a fresh turn |
|
||||
| Progress/history | **Gallery** | A collection of the patterns you've created |
|
||||
| Insight | **Facet** | One face of a multifaceted view |
|
||||
| Saved reframe | **Keepsake** | A pattern worth holding onto |
|
||||
|
||||
### Secondary Terms (Use Sparingly for Flavor)
|
||||
|
||||
- **Shift** — a small adjustment in perspective
|
||||
- **Prism** — the tool that splits one beam into many colors
|
||||
- **Mosaic** — the bigger picture built from many small pieces
|
||||
- **Spectrum** — the full range of ways to see something
|
||||
- **Illuminate** — to light up what was hidden
|
||||
- **Refract** — to bend light in a new direction
|
||||
|
||||
### Words to Avoid
|
||||
|
||||
- "Fix" — implies the user is broken
|
||||
- "Heal" — too clinical, positions app as therapy
|
||||
- "Transform" — too dramatic, overpromises
|
||||
- "Manifest" — save for the Manifestation Engine context only
|
||||
- "Positive vibes" — trivializes the process
|
||||
- "Journey" — overused in wellness apps
|
||||
|
||||
---
|
||||
|
||||
## Feature Naming
|
||||
|
||||
### The Reframer → **The Kaleidoscope** (or just **Turn**)
|
||||
|
||||
The flagship feature. User inputs a negative thought (a fragment), and Kalei reveals multiple reframed perspectives (patterns).
|
||||
|
||||
- **CTA button:** "Turn" (verb — active, simple, one word)
|
||||
- **Input prompt:** "Drop in a fragment" or "What's on your mind?"
|
||||
- **Loading state:** A subtle kaleidoscope rotation animation
|
||||
- **Results header:** "Here's what the same pieces look like from a new angle"
|
||||
- **Individual reframes:** Displayed as "Pattern 1," "Pattern 2," "Pattern 3" — each a different arrangement of the same facts
|
||||
- **Save action:** "Keep this pattern"
|
||||
|
||||
### Manifestation Engine → **The Lens**
|
||||
|
||||
The goal-setting and manifestation feature. If the Kaleidoscope shows you new patterns in what already exists, the Lens focuses your vision on what you're building toward.
|
||||
|
||||
- **Section header:** "Your Lens"
|
||||
- **Goal creation:** "Set your focus"
|
||||
- **Daily affirmation:** "Today's focus"
|
||||
- **Vision board:** "The View" — what you see when you look through the lens
|
||||
- **Progress check-in:** "Sharpen your focus"
|
||||
- **Milestone reached:** "Crystal clear"
|
||||
|
||||
### Combined Narrative
|
||||
|
||||
> The Kaleidoscope helps you see beauty in what's already there.
|
||||
> The Lens helps you focus on what's ahead.
|
||||
> Together, they're Kalei — a new way to see your life.
|
||||
|
||||
---
|
||||
|
||||
## Onboarding Flow
|
||||
|
||||
The onboarding should teach the metaphor through experience, not explanation.
|
||||
|
||||
### Screen 1 — The Fragment
|
||||
|
||||
Visual: A single shard of colored glass on a dark background. Simple. Stark.
|
||||
|
||||
> **"This is a thought."**
|
||||
> *On its own, it can feel sharp. Random. Hard to make sense of.*
|
||||
|
||||
### Screen 2 — The Turn
|
||||
|
||||
Visual: The shard multiplies and rotates into a kaleidoscope pattern. Animated transition.
|
||||
|
||||
> **"But change the angle..."**
|
||||
> *...and the same piece becomes part of something beautiful.*
|
||||
|
||||
### Screen 3 — The Reveal
|
||||
|
||||
Visual: A full, stunning kaleidoscope pattern fills the screen. Color blooms.
|
||||
|
||||
> **"Kalei doesn't change your reality."**
|
||||
> *It changes how you see it.*
|
||||
|
||||
### Screen 4 — First Turn (Interactive)
|
||||
|
||||
> **"Let's try your first Turn."**
|
||||
> *Type something that's been weighing on you.*
|
||||
|
||||
The user types a real negative thought. Kalei processes it and returns 2–3 reframed perspectives. The user experiences the core value proposition within 60 seconds of opening the app.
|
||||
|
||||
### Screen 5 — Welcome
|
||||
|
||||
> **"Welcome to Kalei."**
|
||||
> *Every day is a new turn.*
|
||||
|
||||
---
|
||||
|
||||
## Visual Design Language
|
||||
|
||||
### The Kaleidoscope Aesthetic
|
||||
|
||||
The visual identity should evoke the feeling of looking through a kaleidoscope without being literal or childish.
|
||||
|
||||
**Color Palette:**
|
||||
- **Primary:** Deep jewel tones — amethyst purple, sapphire blue, emerald green
|
||||
- **Secondary:** Warm golds and soft amber (the light passing through glass)
|
||||
- **Background:** Near-black or deep navy (the dark tube of a kaleidoscope — the fragments shine against darkness)
|
||||
- **Accent:** Prismatic gradients for highlights and CTAs (light refracting)
|
||||
|
||||
**Why dark backgrounds:** A kaleidoscope works by reflecting light against darkness. The dark UI makes the colorful elements pop — and also positions Kalei as premium, not bubbly.
|
||||
|
||||
**Avoid:** Pastel wellness aesthetic. No sage green, no cream, no watercolor blobs. Kalei is jewel-toned, rich, and confident.
|
||||
|
||||
**Typography:**
|
||||
- Clean, modern sans-serif for body text (clarity, legibility)
|
||||
- One geometric or slightly decorative font for headlines (faceted, angular — like cut glass)
|
||||
|
||||
**Iconography:**
|
||||
- Geometric and faceted — hexagons, triangles, crystalline shapes
|
||||
- Avoid circles and soft curves (that's every other wellness app)
|
||||
- Subtle symmetry in icon design (mirrors the symmetry of kaleidoscope patterns)
|
||||
|
||||
### Signature Animation: The Turn
|
||||
|
||||
The core micro-interaction of the app. When a user submits a thought for reframing:
|
||||
|
||||
1. **Input phase:** Fragment icon — a single angular shard
|
||||
2. **Processing phase:** The shard begins to rotate and multiply (kaleidoscope turning). Subtle, smooth, 1.5–2 seconds
|
||||
3. **Reveal phase:** Fragments settle into a symmetric pattern. The reframed perspectives appear beneath or within the pattern
|
||||
|
||||
This animation should become iconic — the "Kalei Turn" — recognizable in screenshots, marketing, and social media.
|
||||
|
||||
### Pattern Generation
|
||||
|
||||
Each reframing session could generate a unique, procedurally-created kaleidoscope pattern based on the input. These patterns become:
|
||||
|
||||
- **Visual identity for saved reframes** — each keepsake has its own pattern
|
||||
- **Gallery items** — your collection of patterns grows over time
|
||||
- **Shareable cards** — "My pattern for today" with the reframe text overlaid
|
||||
- **Profile decoration** — your most-used patterns become part of your visual identity
|
||||
|
||||
This is a powerful retention mechanic: **users build a gallery of beautiful, personal, unique patterns.** Each one tied to a moment where they chose to see things differently.
|
||||
|
||||
---
|
||||
|
||||
## Navigation & Information Architecture
|
||||
|
||||
### Tab Bar (4 tabs)
|
||||
|
||||
| Icon | Label | Function |
|
||||
|------|-------|----------|
|
||||
| ◇ (geometric shard) | **Turn** | The Kaleidoscope — reframe a thought |
|
||||
| ◎ (lens/circle) | **Lens** | The Manifestation Engine — goals & focus |
|
||||
| ▦ (grid of patterns) | **Gallery** | History of all your Turns and patterns |
|
||||
| ● (profile) | **You** | Settings, stats, subscription, profile |
|
||||
|
||||
### Turn Tab (Home)
|
||||
|
||||
- Hero area: "What's the fragment?" — text input
|
||||
- Below: "Turn of the day" — a featured prompt or previous pattern
|
||||
- Below: "Recent patterns" — quick access to last 3 Turns
|
||||
- Floating action: Quick Turn button (always accessible)
|
||||
|
||||
### Lens Tab
|
||||
|
||||
- Current focus (active goal) displayed prominently
|
||||
- Today's affirmation
|
||||
- Vision board / The View
|
||||
- Progress tracker with "sharpening" visual metaphor
|
||||
|
||||
### Gallery Tab
|
||||
|
||||
- Grid view of kaleidoscope patterns, each linked to a saved reframe
|
||||
- Filterable by date, mood tag, or theme
|
||||
- Tap to expand: see the original fragment, the patterns revealed, and any notes
|
||||
- Option to reshare or re-Turn (reframe the same thought again for fresh perspectives)
|
||||
|
||||
### You Tab
|
||||
|
||||
- Streak counter: "X-day turning streak"
|
||||
- Stats: Total turns, patterns saved, most common themes
|
||||
- Settings, subscription management
|
||||
- "Your spectrum" — a visual breakdown of the emotional themes you've explored
|
||||
|
||||
---
|
||||
|
||||
## Notification & Engagement Copy
|
||||
|
||||
### Daily Prompt (Push Notification)
|
||||
|
||||
Rotate through styles:
|
||||
|
||||
- "Ready for today's Turn? 🔮"
|
||||
- "Same pieces, new angle. What fragment are you carrying today?"
|
||||
- "Your Gallery is growing. Add today's pattern."
|
||||
- "The glass hasn't changed. But the view can. Take a Turn."
|
||||
|
||||
### Streak Maintenance
|
||||
|
||||
- Day 3: "Three days of turning fragments into patterns. Keep going."
|
||||
- Day 7: "A week of new angles. Your Gallery is filling up."
|
||||
- Day 30: "30 days. 30 Turns. You're seeing things most people never will."
|
||||
- Streak broken: "The kaleidoscope is still here when you're ready. No pressure."
|
||||
|
||||
### Milestone Celebrations
|
||||
|
||||
- First Turn: "Your first pattern. This is where it starts."
|
||||
- 10th Turn: "10 fragments turned into 10 beautiful patterns."
|
||||
- 50th Turn: "You've looked at 50 hard things and found something worth keeping in every one."
|
||||
- 100th Turn: "100 Turns. You don't just see the bright side — you see every side."
|
||||
|
||||
### Empty States
|
||||
|
||||
- Gallery (no saves yet): "Your Gallery is waiting. The next pattern you save will appear here."
|
||||
- Lens (no goal set): "What are you focusing on? Set your first Lens."
|
||||
- Turn history (new user): "Every kaleidoscope starts with a single turn."
|
||||
|
||||
---
|
||||
|
||||
## Subscription & Monetization Naming
|
||||
|
||||
### Free Tier → **Kalei**
|
||||
|
||||
- 3 Turns per day
|
||||
- Basic pattern generation
|
||||
- Gallery (last 30 days)
|
||||
|
||||
### Premium Tier → **Kalei Prism**
|
||||
|
||||
- Unlimited Turns
|
||||
- Full Gallery (all history)
|
||||
- The Lens (Manifestation Engine)
|
||||
- Advanced reframe styles (Stoic, Compassionate, Pragmatic, Growth)
|
||||
- Custom pattern themes
|
||||
- Export & share patterns
|
||||
|
||||
**Why "Prism":** A prism takes a single beam of light and splits it into its full spectrum. Kalei Prism gives you the full spectrum of features.
|
||||
|
||||
**CTA for upgrade:** "See the full spectrum" or "Unlock your Prism"
|
||||
|
||||
### Pricing Display
|
||||
|
||||
> **Kalei Prism — $7.99/month**
|
||||
> *Unlimited Turns. Full Gallery. The Lens. Your complete spectrum.*
|
||||
|
||||
---
|
||||
|
||||
## Social & Sharing Mechanics
|
||||
|
||||
### Pattern Cards
|
||||
|
||||
When a user saves a reframe, they can generate a **Pattern Card** — a shareable image featuring:
|
||||
|
||||
- Their unique kaleidoscope pattern (procedurally generated)
|
||||
- The reframed thought (the pattern, not the fragment — we never share the negative thought)
|
||||
- Subtle Kalei branding
|
||||
|
||||
These are designed to be **Instagram Story and iMessage native** — correct aspect ratios, visually striking against both light and dark backgrounds.
|
||||
|
||||
### "Turn It" Sharing
|
||||
|
||||
A user can share a prompt with a friend: "Turn this fragment" — challenging someone else to reframe a thought. This introduces new users to the app through a natural, non-spammy mechanic.
|
||||
|
||||
### Community Gallery (Future, v2+)
|
||||
|
||||
An opt-in public gallery where users can share their best patterns anonymously. Browse how other people turned their fragments into patterns. Upvote the most powerful reframes. This builds community without requiring social profiles or exposing personal information.
|
||||
|
||||
---
|
||||
|
||||
## Marketing & Brand Voice
|
||||
|
||||
### Tagline Options
|
||||
|
||||
1. **"Same pieces. New angle."** — the core proposition in five words
|
||||
2. **"Turn how you see it."** — active, empowering, references the mechanic
|
||||
3. **"Find the pattern."** — mysterious, inviting, implies hidden beauty
|
||||
4. **"A new way to see."** — simple, universal
|
||||
|
||||
**Recommended primary tagline:** *Same pieces. New angle.*
|
||||
|
||||
### Brand Voice Guidelines
|
||||
|
||||
**Kalei speaks like:** A wise friend who sees beauty in hard things — not a therapist, not a guru, not a cheerleader. Calm. Grounded. A little poetic. Never preachy.
|
||||
|
||||
**Tone:** Warm but not soft. Confident but not aggressive. Poetic but not flowery.
|
||||
|
||||
**Examples:**
|
||||
|
||||
| Situation | ❌ Wrong tone | ✅ Kalei tone |
|
||||
|-----------|-------------|-------------|
|
||||
| User inputs a negative thought | "Let's turn that frown upside down!" | "Let's see what this looks like from another angle." |
|
||||
| User completes a reframe | "Amazing job! You're so strong!" | "There it is. A pattern worth keeping." |
|
||||
| User hasn't opened app in a week | "We miss you! Come back!" | "Still here. Ready when you are." |
|
||||
| Explaining the app | "AI-powered cognitive reframing tool" | "A kaleidoscope for your mind." |
|
||||
|
||||
### App Store Description (Draft)
|
||||
|
||||
> **Kalei — A kaleidoscope for your mind.**
|
||||
>
|
||||
> A kaleidoscope doesn't change the glass. It changes the angle. Suddenly, broken fragments become a beautiful pattern.
|
||||
>
|
||||
> Kalei does the same thing with your thoughts.
|
||||
>
|
||||
> Type what's weighing on you. Kalei reveals new perspectives — not toxic positivity, but genuine, research-backed ways to see the same situation differently. Every reframe is grounded in cognitive behavioral science and built to help you think clearer, not just feel better.
|
||||
>
|
||||
> **The Kaleidoscope** — Turn any negative thought into multiple new perspectives. Same facts. Different angle. Beautiful patterns.
|
||||
>
|
||||
> **The Lens** — Set your focus. Define what you're building toward. Daily affirmations, vision tracking, and goal clarity powered by AI.
|
||||
>
|
||||
> **Your Gallery** — Every Turn creates a unique pattern. Save your favorites. Watch your collection grow. See how far you've come.
|
||||
>
|
||||
> Same pieces. New angle. That's Kalei.
|
||||
|
||||
### Elevator Pitch
|
||||
|
||||
> "Kalei is a kaleidoscope for your mind. You give it a negative thought — a broken fragment — and it shows you the beautiful patterns hidden inside. It's AI-powered cognitive reframing that helps you see the same situation from new angles. Not toxic positivity. Real perspective shifts, grounded in science. Same pieces, new angle."
|
||||
|
||||
---
|
||||
|
||||
## Technical Implementation Notes
|
||||
|
||||
### Procedural Pattern Generation
|
||||
|
||||
Each reframing session should generate a unique kaleidoscope pattern. Implementation approach:
|
||||
|
||||
- Use the **input text as a seed** — same thought always generates the same base pattern (creates personal connection)
|
||||
- Apply **reframe variant as a rotation** — Pattern 1, Pattern 2, Pattern 3 are visual rotations of the base
|
||||
- Render using **Canvas/WebGL** in React Native (or pre-rendered SVG for performance)
|
||||
- Patterns should be **deterministic** — reopening a saved reframe shows the same pattern
|
||||
- Export patterns as **PNG at 1080×1920** for Instagram Stories and **1080×1080** for feed posts
|
||||
|
||||
### Animation Specs
|
||||
|
||||
- **Turn animation:** 1.5s ease-in-out rotation, fragments multiplying from 1→6→full symmetry
|
||||
- **Loading shimmer:** Prismatic color shift across a geometric skeleton screen
|
||||
- **Tab transitions:** Subtle faceted wipe (diagonal geometric transition, not standard iOS slide)
|
||||
- **Pattern reveal:** Fragments drift into position with slight parallax depth (0.3s stagger per fragment)
|
||||
|
||||
### Reframe Prompt Engineering
|
||||
|
||||
The Claude API prompts for reframing should be structured to match the metaphor:
|
||||
|
||||
```
|
||||
System prompt context:
|
||||
"You are the engine behind Kalei, a kaleidoscope for the mind.
|
||||
The user gives you a fragment — a negative thought or situation.
|
||||
Your job is to reveal the patterns — multiple genuine, grounded
|
||||
perspectives on the same situation. You never change the facts.
|
||||
You change the angle.
|
||||
|
||||
You are not a therapist. You are not toxic positivity.
|
||||
You are a kaleidoscope: you show what was already there,
|
||||
arranged in a way the user hadn't seen before."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Summary: The Metaphor at Every Layer
|
||||
|
||||
| Layer | How the metaphor shows up |
|
||||
|-------|---------------------------|
|
||||
| **Name** | Kalei — short for kaleidoscope |
|
||||
| **Tagline** | Same pieces. New angle. |
|
||||
| **Core mechanic** | "Turn" a fragment into patterns |
|
||||
| **Visual design** | Jewel tones, geometric shapes, dark backgrounds, prismatic gradients |
|
||||
| **Animations** | Kaleidoscope rotation on every reframe |
|
||||
| **Vocabulary** | Fragments, patterns, turns, facets, gallery, keepsakes |
|
||||
| **Feature names** | The Kaleidoscope, The Lens, The Gallery |
|
||||
| **Subscription** | Kalei Prism — "See the full spectrum" |
|
||||
| **Sharing** | Pattern Cards — unique generative art tied to each reframe |
|
||||
| **Notifications** | Poetic, grounded, always referencing angles and patterns |
|
||||
| **Brand voice** | Calm, wise, finds beauty in hard things |
|
||||
| **Onboarding** | User experiences a real Turn within 60 seconds |
|
||||
| **Retention** | Gallery of personal patterns grows over time — collectible, visual, meaningful |
|
||||
|
||||
---
|
||||
|
||||
*The glass hasn't changed. But you have.*
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,354 @@
|
|||
# The Mirror — Kalei's Notebook Feature
|
||||
|
||||
## The Concept
|
||||
|
||||
The Kaleidoscope (Turn) is structured: one fragment in, patterns out. It works when you **know** what's bothering you.
|
||||
|
||||
But most of the time, people don't. They're carrying a vague heaviness — a bad day, an argument replaying in their head, a worry they can't articulate. They don't need a tool yet. They need a space to **think out loud** first.
|
||||
|
||||
**The Mirror** is that space.
|
||||
|
||||
It's a freeform notebook with a chat-like interface where you write whatever's on your mind — stream of consciousness, venting, processing. As you write, Kalei's AI reads along quietly and does two things:
|
||||
|
||||
1. **Highlights fragments** — gently underlines or marks phrases that carry negative cognitive patterns (catastrophizing, black-and-white thinking, personalization, fortune-telling, etc.)
|
||||
2. **Offers to Turn them** — tapping a highlighted fragment opens a mini-reframe inline, without leaving the flow of writing
|
||||
|
||||
You're not journaling into a void. You're writing into a mirror that reflects back what you can't see yourself.
|
||||
|
||||
---
|
||||
|
||||
## Why "The Mirror"
|
||||
|
||||
A kaleidoscope is built from mirrors. The mirrors are what create the symmetry — what take a random fragment and reveal the pattern. Without the mirrors, it's just broken glass.
|
||||
|
||||
The Mirror feature is the reflective surface of Kalei. The Kaleidoscope (Turn) is the active tool. The Mirror is the quiet awareness that makes the tool work.
|
||||
|
||||
**Metaphor alignment:**
|
||||
- You write freely → you're pouring fragments onto the table
|
||||
- Kalei highlights patterns → the mirror reflects back what you couldn't see
|
||||
- You tap to reframe → you choose which fragments to Turn
|
||||
- The session becomes a Reflection → saved to your Gallery with its own pattern
|
||||
|
||||
---
|
||||
|
||||
## How It Works — User Flow
|
||||
|
||||
### Entry Point
|
||||
|
||||
The Mirror lives as the **fifth element** in the app's navigation, or as a secondary action within the Turn tab. Two options:
|
||||
|
||||
**Option A — Dedicated tab (recommended):**
|
||||
|
||||
| Icon | Label | Function |
|
||||
|------|-------|----------|
|
||||
| ◇ | **Turn** | Quick structured reframe |
|
||||
| ✦ | **Mirror** | Freeform notebook with AI awareness |
|
||||
| ◎ | **Lens** | Manifestation Engine |
|
||||
| ▦ | **Gallery** | History of patterns and reflections |
|
||||
| ● | **You** | Profile and settings |
|
||||
|
||||
**Option B — Nested under Turn:**
|
||||
Turn tab has two modes: "Quick Turn" (current structured input) and "Open Mirror" (freeform). Toggle at top.
|
||||
|
||||
**Recommendation:** Option A. The Mirror is different enough in intent and behavior that it deserves its own space. Users will develop separate habits — quick Turns for specific thoughts, Mirror sessions for processing.
|
||||
|
||||
### The Writing Experience
|
||||
|
||||
**Visual:** Chat-style interface. The user's messages appear as bubbles or blocks on one side. Clean, minimal, dark background consistent with Kalei's aesthetic. No AI responses appear unprompted — the AI is **listening**, not talking.
|
||||
|
||||
**Prompt on empty state:**
|
||||
> "Start writing. Say whatever's on your mind. I'll listen."
|
||||
> *Kalei will gently highlight patterns it notices. You decide what to do with them.*
|
||||
|
||||
**User writes freely.** They can send multiple messages in sequence, like texting a friend or writing in a stream. No character limits. No structure required. Just write.
|
||||
|
||||
### The Highlighting — "Fragment Detection"
|
||||
|
||||
As the user writes (or after each message is sent), Kalei's AI analyzes the text for **cognitive distortion patterns** — the same patterns that cognitive behavioral therapy identifies as drivers of negative thinking:
|
||||
|
||||
| Distortion | Example | What Kalei detects |
|
||||
|---|---|---|
|
||||
| Catastrophizing | "This is going to ruin everything" | Absolutist prediction language |
|
||||
| Black-and-white thinking | "I always fail at this" | Always/never, all-or-nothing |
|
||||
| Mind reading | "They probably think I'm an idiot" | Assuming others' thoughts |
|
||||
| Fortune telling | "This will never get better" | Predicting negative outcomes |
|
||||
| Personalization | "It's all my fault" | Taking undue responsibility |
|
||||
| Discounting positives | "That win was just luck" | Minimizing good things |
|
||||
| Emotional reasoning | "I feel like a failure so I must be one" | Feelings presented as facts |
|
||||
| Should statements | "I should be further along by now" | Rigid self-imposed rules |
|
||||
| Labeling | "I'm such a loser" | Identity-level negative labels |
|
||||
| Overgeneralization | "Nothing ever works out for me" | One event → universal pattern |
|
||||
|
||||
**How highlighting appears:**
|
||||
|
||||
- Detected phrases get a **subtle underline or soft glow** in a warm amber/gold color — the color of light catching a fragment
|
||||
- The highlight is gentle, not aggressive. It shouldn't feel like a red pen correcting homework. It should feel like sunlight falling on a piece of glass — drawing attention naturally
|
||||
- A small **◇ icon** (fragment symbol) appears at the end of the highlighted phrase, indicating this fragment can be Turned
|
||||
- Highlights appear **after the user finishes a message** (not while typing — that would be intrusive and anxiety-inducing)
|
||||
|
||||
**Critical UX principle:** The highlighting must feel like **noticing**, not **judging**. The AI is a mirror, not a critic. The user should feel seen, not corrected.
|
||||
|
||||
### Tapping a Fragment — Inline Reframing
|
||||
|
||||
When the user taps a highlighted fragment:
|
||||
|
||||
1. A **mini-card slides up** from below (half-sheet modal, not full screen — user can still see their writing above)
|
||||
2. The card shows:
|
||||
- The original fragment, quoted
|
||||
- The cognitive pattern name in plain language (e.g., "This sounds like catastrophizing — predicting the worst outcome")
|
||||
- **1–2 reframed alternatives** — shorter and lighter than a full Turn, designed for quick insight
|
||||
- A "Full Turn" button if they want to take this fragment into the Kaleidoscope for deeper exploration
|
||||
- A "Dismiss" option — user can say "I see it, moving on" without reframing
|
||||
|
||||
**Example interaction:**
|
||||
|
||||
> **User writes:** "Had a terrible meeting today. My manager barely acknowledged my presentation. She probably thinks I'm not cut out for this role. I should just start looking for another job."
|
||||
|
||||
> **Kalei highlights:** "She probably thinks I'm not cut out for this role"
|
||||
|
||||
> **User taps the highlight. Card appears:**
|
||||
|
||||
> **◇ Fragment detected**
|
||||
> *"She probably thinks I'm not cut out for this role"*
|
||||
>
|
||||
> This looks like **mind reading** — assuming someone else's thoughts without evidence.
|
||||
>
|
||||
> **A different angle:**
|
||||
> There are many reasons a manager might seem distracted that have nothing to do with your performance. What you observed was her behavior. What she thinks is something you don't have access to yet — but you could ask.
|
||||
>
|
||||
> **[Full Turn ◇]** · **[Dismiss]**
|
||||
|
||||
### The AI's Role — Passive, Not Conversational
|
||||
|
||||
**This is critical.** The Mirror is NOT a chatbot. The AI does not:
|
||||
- Respond to every message
|
||||
- Ask follow-up questions unprompted
|
||||
- Inject unsolicited advice
|
||||
- Break the user's flow with interjections
|
||||
|
||||
The AI **only** does three things:
|
||||
1. Highlights fragments (passively, after each message)
|
||||
2. Provides reframes when the user taps a highlight (on demand)
|
||||
3. Generates a session summary when the user ends the session (see below)
|
||||
|
||||
**Why not make it a chatbot?** Because the whole point is that the user is thinking out loud. Inserting AI responses between every message turns it into a conversation with a bot, which changes the psychology entirely. The user stops introspecting and starts performing. The Mirror should feel like writing in a journal that occasionally catches the light — not like talking to a therapist.
|
||||
|
||||
**Exception — The Nudge:** If the user has written 5+ messages with zero taps on any highlights and significant negative patterns are accumulating, Kalei can offer ONE gentle nudge at the end of the stream:
|
||||
|
||||
> "I noticed a few fragments in what you wrote. Want to look at them together?"
|
||||
> **[Show me]** · **[Not now]**
|
||||
|
||||
This is the only time the AI initiates. Once per session maximum.
|
||||
|
||||
---
|
||||
|
||||
## Session Wrap-Up — The Reflection
|
||||
|
||||
When the user signals they're done writing (closes the Mirror, presses a "Done" button, or after a period of inactivity), Kalei generates a **Reflection** — a brief session summary.
|
||||
|
||||
**The Reflection includes:**
|
||||
|
||||
1. **The Mosaic** — a high-level summary of what the user wrote about (themes, not specifics)
|
||||
> "Today's Mirror covered: work frustration, self-doubt about career, and a conflict with your manager."
|
||||
|
||||
2. **Fragments Found** — count of cognitive patterns detected
|
||||
> "4 fragments noticed. You explored 2 of them."
|
||||
|
||||
3. **Patterns Revealed** — the reframes the user chose to engage with
|
||||
> "You looked at mind reading and catastrophizing from new angles."
|
||||
|
||||
4. **A Generated Pattern** — a unique kaleidoscope visual for this session, saved to the Gallery alongside their Turn patterns. Mirror sessions get their own visual style — perhaps slightly different geometry (softer, more organic) to distinguish them from structured Turns
|
||||
|
||||
5. **An optional one-line insight** — the AI's single most important observation from the session
|
||||
> "You were hardest on yourself about things you haven't confirmed are true."
|
||||
|
||||
**The Reflection is saved to the Gallery** as a distinct type: a Mirror Reflection. Users can revisit their sessions, re-read what they wrote, see which fragments they explored, and track how their patterns evolve over time.
|
||||
|
||||
---
|
||||
|
||||
## Where the Mirror Fits in the User's Journey
|
||||
|
||||
The three core features now form a **progression**:
|
||||
|
||||
```
|
||||
THE MIRROR THE KALEIDOSCOPE THE LENS
|
||||
(Awareness) → (Perspective) → (Direction)
|
||||
|
||||
"What am I "How else can I "What am I
|
||||
feeling?" see this?" building toward?"
|
||||
|
||||
Freeform Structured Goal-focused
|
||||
writing reframing manifestation
|
||||
|
||||
Fragments Fragments → Patterns Patterns → Focus
|
||||
detected revealed applied
|
||||
```
|
||||
|
||||
**The natural user flow:**
|
||||
|
||||
1. **Mirror** — User dumps their raw thoughts. AI highlights the fragments they can't see themselves
|
||||
2. **Turn** — User takes the most charged fragment and gives it a full Turn in the Kaleidoscope, getting deep, multi-angle reframes
|
||||
3. **Lens** — The insights from reframing inform the user's goals. What they thought was a setback becomes fuel for what they're building toward
|
||||
|
||||
Not every session follows this sequence. Some days you just need a quick Turn. Some days you just need to write in the Mirror. Some days you go straight to the Lens. But when a user does flow through all three, that's the **Kalei experience** at its deepest.
|
||||
|
||||
---
|
||||
|
||||
## Engagement & Retention Mechanics
|
||||
|
||||
### Mirror Streaks
|
||||
|
||||
Track separately from Turn streaks:
|
||||
- "You've written in the Mirror 5 days in a row"
|
||||
- Mirror sessions tend to be longer and more personal → higher engagement signal
|
||||
|
||||
### Fragment Tracking Over Time
|
||||
|
||||
The Gallery can show **fragment patterns over time**:
|
||||
- "This month, your most common fragment type was **should statements**"
|
||||
- "You've reduced catastrophizing by 40% compared to last month"
|
||||
- A visual "spectrum" chart showing which cognitive distortions appear most frequently
|
||||
|
||||
This turns the Mirror from a journal into a **self-awareness engine**. Users can literally see their thinking patterns change over time.
|
||||
|
||||
### Mirror Prompts
|
||||
|
||||
For days when the user opens the Mirror but doesn't know what to write:
|
||||
- "What happened today that you're still thinking about?"
|
||||
- "What would you say to a friend if they were feeling what you're feeling?"
|
||||
- "What's one thing you're avoiding thinking about?"
|
||||
- "Describe your mood in a sentence. Then ask yourself why."
|
||||
|
||||
These are optional, dismissible, and only shown on empty-state.
|
||||
|
||||
---
|
||||
|
||||
## Monetization Placement
|
||||
|
||||
| Feature | Free (Kalei) | Premium (Kalei Prism) |
|
||||
|---|---|---|
|
||||
| Mirror access | 2 sessions/week | Unlimited |
|
||||
| Fragment highlighting | Basic (3 distortion types) | Full spectrum (all 10 types) |
|
||||
| Inline reframes | 1 per session | Unlimited |
|
||||
| Session Reflections | Summary only | Full Reflection with insight |
|
||||
| Fragment tracking over time | ✗ | ✓ |
|
||||
| Export Mirror sessions | ✗ | ✓ |
|
||||
|
||||
The free tier gives enough Mirror access to experience the value. The paywall hits at the point where the user wants **depth and consistency** — which is exactly when they're most likely to convert.
|
||||
|
||||
---
|
||||
|
||||
## Technical Implementation Notes
|
||||
|
||||
### AI Processing Pipeline
|
||||
|
||||
Each message the user sends in the Mirror triggers a lightweight AI analysis:
|
||||
|
||||
```
|
||||
User message → Claude API call → Returns:
|
||||
{
|
||||
"fragments": [
|
||||
{
|
||||
"text": "She probably thinks I'm not cut out for this role",
|
||||
"start_index": 89,
|
||||
"end_index": 143,
|
||||
"distortion_type": "mind_reading",
|
||||
"distortion_label": "Mind reading",
|
||||
"distortion_description": "Assuming someone else's thoughts without evidence",
|
||||
"confidence": 0.87
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**Confidence threshold:** Only highlight fragments with confidence > 0.75 to avoid false positives. A false positive (highlighting something that isn't actually distorted thinking) would erode trust quickly.
|
||||
|
||||
**Latency:** Analysis should complete within 1–2 seconds after message sent. Highlights appear with a subtle fade-in animation — fragments "catching the light."
|
||||
|
||||
### Reframe Generation (On Tap)
|
||||
|
||||
When user taps a highlighted fragment, a second API call generates the inline reframe:
|
||||
|
||||
```
|
||||
Input: fragment text + surrounding context + distortion type
|
||||
Output: {
|
||||
"distortion_explanation": "Plain language explanation",
|
||||
"reframe": "1-2 sentence alternative perspective",
|
||||
"full_turn_prompt": "Pre-filled prompt for Kaleidoscope if user wants deeper exploration"
|
||||
}
|
||||
```
|
||||
|
||||
### Data Storage
|
||||
|
||||
Mirror sessions stored in Supabase:
|
||||
|
||||
```sql
|
||||
-- Mirror sessions table
|
||||
CREATE TABLE mirror_sessions (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
user_id UUID REFERENCES users(id),
|
||||
started_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
ended_at TIMESTAMPTZ,
|
||||
reflection_summary TEXT,
|
||||
reflection_insight TEXT,
|
||||
pattern_seed TEXT, -- for generating the visual pattern
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Mirror messages table
|
||||
CREATE TABLE mirror_messages (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
session_id UUID REFERENCES mirror_sessions(id),
|
||||
content TEXT NOT NULL,
|
||||
sequence_order INTEGER,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Detected fragments within messages
|
||||
CREATE TABLE mirror_fragments (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
message_id UUID REFERENCES mirror_messages(id),
|
||||
fragment_text TEXT NOT NULL,
|
||||
start_index INTEGER,
|
||||
end_index INTEGER,
|
||||
distortion_type VARCHAR(50),
|
||||
confidence FLOAT,
|
||||
was_tapped BOOLEAN DEFAULT FALSE,
|
||||
was_reframed BOOLEAN DEFAULT FALSE,
|
||||
reframe_text TEXT,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
### Privacy & Sensitivity
|
||||
|
||||
Mirror content is the most personal data in the app. Requirements:
|
||||
|
||||
- **End-to-end encryption** for all Mirror content at rest
|
||||
- **No Mirror content used for model training** — explicit policy
|
||||
- **Local-first option** (future): Allow users to keep Mirror data on-device only
|
||||
- **Easy deletion**: User can delete any session or all Mirror data
|
||||
- **Content safety**: If AI detects crisis language (self-harm, suicidal ideation), surface crisis resources immediately — not as a highlight/reframe, but as a dedicated intervention with hotline numbers and a warm handoff message
|
||||
|
||||
---
|
||||
|
||||
## Updated App Structure
|
||||
|
||||
With the Mirror, Kalei now has three pillars that map to a complete mental model:
|
||||
|
||||
| Pillar | Feature | Metaphor | User need | Interaction style |
|
||||
|--------|---------|----------|-----------|-------------------|
|
||||
| **Awareness** | The Mirror | Reflective surface that shows you your fragments | "I need to process" | Freeform writing, passive AI |
|
||||
| **Perspective** | The Kaleidoscope | The turn that reveals patterns in fragments | "I need to see this differently" | Structured input → output |
|
||||
| **Direction** | The Lens | Focused vision toward what you're building | "I need to move forward" | Goal setting, affirmations, tracking |
|
||||
|
||||
**Together:** You become aware of your patterns (Mirror), you learn to see them differently (Kaleidoscope), and you channel that clarity into what you're building (Lens).
|
||||
|
||||
**Tagline still holds:** *Same pieces. New angle.*
|
||||
|
||||
**Elevator pitch (updated):**
|
||||
> "Kalei is a kaleidoscope for your mind. Write freely in the Mirror and Kalei gently highlights the negative thinking patterns you can't see yourself. Take any thought into the Kaleidoscope and see it from entirely new angles. Then focus your clarity through the Lens toward the goals that matter to you. Same pieces. New angle. That's Kalei."
|
||||
|
||||
---
|
||||
|
||||
*The mirror doesn't tell you what to see. It shows you what's already there.*
|
||||
|
|
@ -0,0 +1,405 @@
|
|||
# The Spectrum — Kalei Phase 2
|
||||
|
||||
## Emotional Intelligence, Not Mood Tracking
|
||||
|
||||
Every wellness app asks you to rate your mood on a scale. Tap a smiley face. Drag a slider. It's self-reported, inaccurate, and most people stop doing it after two weeks because it feels like homework.
|
||||
|
||||
Kalei doesn't need to ask how you feel. **It already knows.**
|
||||
|
||||
By Phase 2, users have weeks or months of Mirror sessions, Turns, and Lens activity. Every word they've written, every fragment detected, every pattern revealed, every reframe they saved or dismissed — it's all data. Rich, personal, longitudinal emotional data that the user generated naturally while using features they already love.
|
||||
|
||||
The Spectrum turns that data into **self-knowledge**.
|
||||
|
||||
---
|
||||
|
||||
## Why "The Spectrum"
|
||||
|
||||
Light enters a prism and exits as a spectrum — the full range of colors that were always present but invisible to the naked eye. The Spectrum takes the raw light of your daily Kalei usage and separates it into its component colors so you can see what's really going on inside.
|
||||
|
||||
It also completes the optical metaphor system:
|
||||
|
||||
| Feature | Optical element | What it does |
|
||||
|---------|----------------|--------------|
|
||||
| The Mirror | Mirror | Reflects your thoughts back to you |
|
||||
| The Kaleidoscope | Kaleidoscope | Rearranges fragments into patterns |
|
||||
| The Lens | Lens | Focuses your vision on what's ahead |
|
||||
| The Spectrum | Prism | Reveals the full range of what you're feeling |
|
||||
|
||||
---
|
||||
|
||||
## What The Spectrum Shows
|
||||
|
||||
### 1. The Emotional Landscape
|
||||
|
||||
A visual representation of your emotional state over time — not from self-reporting, but from **AI analysis of your Mirror sessions, Turns, and Lens check-ins.**
|
||||
|
||||
**How it works:**
|
||||
|
||||
Every Mirror message and Turn input is analyzed for emotional signatures across multiple dimensions:
|
||||
|
||||
- **Valence:** Positive ↔ Negative
|
||||
- **Arousal:** Calm ↔ Activated
|
||||
- **Certainty:** Confident ↔ Uncertain
|
||||
- **Agency:** In control ↔ Helpless
|
||||
- **Social orientation:** Connected ↔ Isolated
|
||||
- **Temporal focus:** Past-dwelling ↔ Present ↔ Future-focused
|
||||
|
||||
These dimensions are plotted over time as a **flowing gradient visualization** — not a line chart, but a river of color that shifts and blends. Warm colors for activated states, cool for calm, dark for negative, bright for positive. The result looks like light passing through a prism: your emotional spectrum, laid out across days and weeks.
|
||||
|
||||
**The user sees:**
|
||||
- The overall color/tone of their week at a glance
|
||||
- Shifts and transitions (Tuesday was dark and activated → Wednesday calmed down after a Turn)
|
||||
- Long-term trends (past month trending brighter, or a slow slide they hadn't noticed)
|
||||
|
||||
**What they don't see:** Numbers, scores, or ratings. The Spectrum is visual and intuitive, not clinical. You look at it and *feel* whether things are moving in the right direction.
|
||||
|
||||
### 2. Fragment Patterns — "Your Glass"
|
||||
|
||||
A breakdown of which cognitive distortion types appear most frequently in the user's writing.
|
||||
|
||||
**Visualization:** A faceted gem or crystal with different faces representing different distortion types. The larger the face, the more frequently that pattern appears. The gem evolves over time as patterns shift.
|
||||
|
||||
**Insights delivered in plain language:**
|
||||
|
||||
> "This month, **should statements** made up 34% of your fragments — up from 22% last month. You're putting more pressure on yourself than usual."
|
||||
|
||||
> "**Mind reading** dropped significantly since you started Turning those fragments. You assumed others' thoughts 8 times in January, only twice in February."
|
||||
|
||||
> "Your top 3 fragment types this month: catastrophizing, discounting positives, and black-and-white thinking."
|
||||
|
||||
**Why this matters:** Most people have 2-3 dominant cognitive distortions they don't know about. Seeing them named and tracked over time is genuinely transformative — it's the kind of insight you'd normally get after months of therapy.
|
||||
|
||||
### 3. Turn Impact — "Before & After"
|
||||
|
||||
Tracks the measurable effect of reframing on subsequent emotional state.
|
||||
|
||||
**How it works:**
|
||||
|
||||
The AI compares the emotional tone of Mirror sessions **before and after** a Turn:
|
||||
- User writes in Mirror (frustrated, catastrophizing)
|
||||
- User takes a fragment to the Kaleidoscope
|
||||
- User writes in Mirror again later that day or the next day
|
||||
- The Spectrum measures the shift
|
||||
|
||||
**What the user sees:**
|
||||
|
||||
> "After Turning a fragment, your next Mirror session is 62% more likely to show increased agency and reduced catastrophizing."
|
||||
|
||||
> "Your most impactful Turn this month was on Feb 3 — the shift in your writing afterward was significant."
|
||||
|
||||
> "Turns on work-related fragments have the strongest positive effect for you. Relationship fragments take 2-3 Turns before the shift shows up."
|
||||
|
||||
This is the **evidence engine** for Kalei's core thesis: that changing the angle actually changes how you feel. Users can see the proof in their own data.
|
||||
|
||||
### 4. Rhythm Detection — "Your Cycles"
|
||||
|
||||
Identifies recurring emotional patterns tied to time.
|
||||
|
||||
**Weekly rhythms:**
|
||||
> "Your Mirror sessions on Mondays contain 3x more should statements than any other day."
|
||||
> "Fridays tend to be your most positive writing days."
|
||||
|
||||
**Monthly rhythms:**
|
||||
> "The last week of each month shows elevated anxiety patterns — possibly tied to deadlines or financial cycles."
|
||||
|
||||
**Event correlation (Lens integration):**
|
||||
> "When you check in with your Lens goals in the morning, your afternoon Mirror sessions show 40% fewer negative fragments."
|
||||
|
||||
**Contextual patterns:**
|
||||
> "After writing about [work] topics, catastrophizing spikes. After writing about [relationships], personalization is more common."
|
||||
|
||||
The user starts to see their emotional life as a **landscape with terrain** rather than random weather. Some hills are always there. Some valleys are seasonal. That awareness alone is a superpower.
|
||||
|
||||
### 5. Growth Trajectory — "The Long View"
|
||||
|
||||
The headline metric: **how is this person's relationship with their own thinking changing over time?**
|
||||
|
||||
**Tracked indicators:**
|
||||
- Fragment density: How many distortions per 100 words in Mirror sessions (trending down = growth)
|
||||
- Self-correction rate: How often the user identifies their own fragments before Kalei highlights them (measured by editing/deleting mid-message)
|
||||
- Reframe adoption: How often saved patterns from Turns echo in subsequent Mirror writing (user naturally using new perspectives)
|
||||
- Distortion diversity: Whether the user is getting stuck on one pattern or successfully addressing multiple types
|
||||
- Turn-to-insight ratio: How many Turns result in a saved keepsake vs. dismissed patterns
|
||||
|
||||
**Visualization:** A single, evolving kaleidoscope pattern that represents your overall growth. The more you use Kalei, the more complex, colorful, and beautiful the pattern becomes. At month 1, it might be simple and muted. At month 6, it's intricate and vivid.
|
||||
|
||||
This becomes the **centerpiece of the Spectrum dashboard** — your personal growth, visualized as a living kaleidoscope pattern.
|
||||
|
||||
**Milestone moments:**
|
||||
|
||||
> "Your fragment density has dropped 30% since you started. You're catching your own patterns now."
|
||||
|
||||
> "This week, you naturally reframed a catastrophizing thought in your Mirror session without needing a Turn. That's new."
|
||||
|
||||
> "You've explored all 10 fragment types. You're seeing the full spectrum."
|
||||
|
||||
---
|
||||
|
||||
## The Spectrum Dashboard — Layout
|
||||
|
||||
### Top Section: The River
|
||||
Your emotional landscape as a flowing color gradient. Swipe horizontally to scroll through time. Tap any point to see the Mirror session or Turn from that day.
|
||||
|
||||
### Middle Section: Your Glass
|
||||
The faceted gem visualization showing fragment type distribution. Toggle between "This week," "This month," "All time." Tap any facet for the distortion deep-dive.
|
||||
|
||||
### Bottom Section: Insights Feed
|
||||
A scrollable feed of AI-generated insights, refreshed weekly. Each insight is a card with:
|
||||
- A one-line observation
|
||||
- Supporting data (subtle, not overwhelming)
|
||||
- An action suggestion when relevant
|
||||
|
||||
### Floating Element: Your Pattern
|
||||
Your evolving kaleidoscope pattern, accessible from the top corner. Tap to expand full-screen. Shareable as a "growth snapshot."
|
||||
|
||||
---
|
||||
|
||||
## When Insights Are Delivered
|
||||
|
||||
The Spectrum doesn't bombard users with data. Insights surface at natural moments:
|
||||
|
||||
### Weekly Reflection (Push Notification)
|
||||
Every Sunday evening (or user-configured day):
|
||||
> "Your Spectrum updated. See what this week's light revealed. 🔮"
|
||||
|
||||
Opens to a **Weekly Spectrum Summary:**
|
||||
- Dominant emotional color this week
|
||||
- Top fragment type
|
||||
- Most impactful Turn
|
||||
- One insight
|
||||
- The week's addition to your evolving pattern
|
||||
|
||||
### Monthly Deep Dive
|
||||
First of each month:
|
||||
> "January's Spectrum is ready. See how your light shifted."
|
||||
|
||||
A richer summary with month-over-month comparisons, rhythm detection insights, and growth trajectory updates.
|
||||
|
||||
### In-Context Nudges
|
||||
Subtle, non-intrusive insights surfaced within other features:
|
||||
- In the Mirror: "You've used the phrase 'I should' 4 times this session. That's a pattern worth noticing."
|
||||
- After a Turn: "This is the 3rd time you've Turned a work-related fragment this week. The Spectrum can show you more about this pattern."
|
||||
- In the Lens: "Your Lens focus on [career growth] aligns with the fragments you've been processing. You're working on the right things."
|
||||
|
||||
---
|
||||
|
||||
## Monetization
|
||||
|
||||
The Spectrum is a **Kalei Prism exclusive feature**. It's the single strongest reason to upgrade in Phase 2.
|
||||
|
||||
**Free tier gets:**
|
||||
- A simplified weekly emotional summary (1 insight, no visualizations)
|
||||
- Fragment type counts (basic numbers only)
|
||||
- A teaser of what the full Spectrum shows: "Upgrade to see your full Spectrum"
|
||||
|
||||
**Prism tier gets:**
|
||||
- Full Spectrum dashboard with all 5 sections
|
||||
- Weekly and monthly deep dives
|
||||
- Growth trajectory and evolving pattern
|
||||
- Rhythm detection
|
||||
- Turn impact analysis
|
||||
- Export and sharing of Spectrum snapshots
|
||||
|
||||
**Upgrade CTA:**
|
||||
> "You've written 47 Mirror sessions and completed 23 Turns. There's a story in that data. See your full Spectrum."
|
||||
|
||||
This is a natural paywall because the Spectrum **requires usage history to be valuable.** By the time a user has enough data for the Spectrum to be meaningful, they've already experienced Kalei's value through the free tier and are primed to convert.
|
||||
|
||||
---
|
||||
|
||||
## Privacy Architecture
|
||||
|
||||
The Spectrum analyzes deeply personal data. Trust is non-negotiable.
|
||||
|
||||
### Principles
|
||||
|
||||
1. **All analysis happens on aggregated patterns, never exposed raw content.** The Spectrum shows "your catastrophizing increased this week" — it never shows "you wrote 'my life is falling apart' on Tuesday"
|
||||
2. **No Spectrum data leaves the user's account.** Not for model training, not for anonymized research, not for anything
|
||||
3. **Users control the window.** They can exclude any Mirror session or Turn from Spectrum analysis. They can set the Spectrum to only analyze the last 30/60/90 days
|
||||
4. **Full deletion.** "Reset my Spectrum" erases all analyzed data and starts fresh
|
||||
5. **Transparency.** A "How this works" section explains exactly what the AI analyzes and what it doesn't
|
||||
|
||||
### Data Processing
|
||||
|
||||
Spectrum analysis runs as a **background job**, not in real-time:
|
||||
- After each Mirror session ends, emotional dimensions are computed and stored as numerical vectors — not raw text
|
||||
- Fragment types are already captured during Mirror sessions
|
||||
- Weekly aggregation job runs to compute trends, rhythms, and insights
|
||||
- The Spectrum dashboard reads from aggregated data only
|
||||
|
||||
```sql
|
||||
-- Emotional analysis per Mirror session
|
||||
CREATE TABLE spectrum_session_analysis (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
user_id UUID REFERENCES users(id),
|
||||
session_id UUID REFERENCES mirror_sessions(id),
|
||||
session_date DATE NOT NULL,
|
||||
valence FLOAT, -- -1 (negative) to 1 (positive)
|
||||
arousal FLOAT, -- -1 (calm) to 1 (activated)
|
||||
certainty FLOAT, -- -1 (uncertain) to 1 (confident)
|
||||
agency FLOAT, -- -1 (helpless) to 1 (in control)
|
||||
social_orientation FLOAT, -- -1 (isolated) to 1 (connected)
|
||||
temporal_focus FLOAT, -- -1 (past) to 0 (present) to 1 (future)
|
||||
fragment_count INTEGER,
|
||||
word_count INTEGER,
|
||||
dominant_distortion VARCHAR(50),
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Emotional analysis per Turn
|
||||
CREATE TABLE spectrum_turn_analysis (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
user_id UUID REFERENCES users(id),
|
||||
turn_id UUID REFERENCES turns(id),
|
||||
turn_date DATE NOT NULL,
|
||||
pre_valence FLOAT, -- emotional state of input
|
||||
post_valence FLOAT, -- emotional state after reframe engagement
|
||||
distortion_type VARCHAR(50),
|
||||
reframe_saved BOOLEAN,
|
||||
topic_cluster VARCHAR(100),
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Weekly aggregated insights
|
||||
CREATE TABLE spectrum_weekly (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
user_id UUID REFERENCES users(id),
|
||||
week_start DATE NOT NULL,
|
||||
avg_valence FLOAT,
|
||||
avg_arousal FLOAT,
|
||||
avg_agency FLOAT,
|
||||
total_fragments INTEGER,
|
||||
total_turns INTEGER,
|
||||
total_mirror_sessions INTEGER,
|
||||
dominant_distortion VARCHAR(50),
|
||||
distortion_distribution JSONB, -- {"catastrophizing": 5, "mind_reading": 3, ...}
|
||||
fragment_density FLOAT, -- fragments per 100 words
|
||||
turn_impact_score FLOAT, -- measured shift after turns
|
||||
insight_text TEXT, -- AI-generated weekly insight
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
UNIQUE(user_id, week_start)
|
||||
);
|
||||
|
||||
-- Monthly deep dive
|
||||
CREATE TABLE spectrum_monthly (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
user_id UUID REFERENCES users(id),
|
||||
month_start DATE NOT NULL,
|
||||
growth_score FLOAT, -- composite improvement metric
|
||||
rhythm_insights JSONB, -- detected patterns tied to time
|
||||
month_over_month_delta JSONB, -- comparison with previous month
|
||||
top_fragment_types JSONB, -- ranked list
|
||||
most_impactful_turn UUID, -- references turn with biggest shift
|
||||
pattern_complexity_score FLOAT, -- drives evolving visual pattern
|
||||
narrative_summary TEXT, -- AI-generated monthly narrative
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
UNIQUE(user_id, month_start)
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Notification Copy — Spectrum Voice
|
||||
|
||||
The Spectrum speaks with slightly more authority than other Kalei features — it has data behind it. But still warm, still poetic.
|
||||
|
||||
### Weekly
|
||||
|
||||
- "Your Spectrum shifted this week. Come see the colors."
|
||||
- "7 days of fragments and patterns. Here's what the light reveals."
|
||||
- "This week had a rhythm. The Spectrum caught it."
|
||||
|
||||
### Monthly
|
||||
|
||||
- "A month of Turns. Your Spectrum has a story to tell."
|
||||
- "January's light, separated into its colors. Your monthly Spectrum is ready."
|
||||
|
||||
### Milestone Insights
|
||||
|
||||
- "First month of Spectrum data. Your baseline is set — now watch it evolve."
|
||||
- "Your fragment density dropped below 5 per 100 words for the first time. You're catching yourself."
|
||||
- "3 consecutive weeks of increasing agency in your writing. Something shifted."
|
||||
- "You haven't catastrophized in 12 days. That's your longest streak."
|
||||
|
||||
### Growth Pattern Evolution
|
||||
|
||||
- "Your pattern grew a new layer this month. Tap to see it."
|
||||
- "Remember your first pattern? Compare it to today's. Look how far you've come."
|
||||
|
||||
---
|
||||
|
||||
## The Spectrum as Retention Engine
|
||||
|
||||
The Spectrum solves the biggest problem in wellness apps: **the drop-off after the initial novelty fades.**
|
||||
|
||||
**Week 1-2:** Users are engaged with the Mirror and Kaleidoscope. Everything is new.
|
||||
|
||||
**Week 3-4:** Novelty fades. This is where most wellness apps lose people.
|
||||
|
||||
**With the Spectrum (Phase 2 timing — launched when early users hit this exact window):**
|
||||
|
||||
- "Your first Spectrum is ready" re-engages users with a new reason to open the app
|
||||
- The evolving pattern creates **collection psychology** — users want to see it grow
|
||||
- Weekly insights create a **recurring appointment** with the app
|
||||
- Growth trajectory shows **concrete progress** — "this is working" evidence
|
||||
- Fragment tracking creates **self-competition** — users try to beat their own patterns
|
||||
- Monthly deep dives become **anticipated events** — not notifications to dismiss
|
||||
|
||||
The Spectrum turns Kalei from a tool you use when you feel bad into a **dashboard you check because you're curious about yourself.** That's the difference between reactive usage (declining) and proactive usage (compounding).
|
||||
|
||||
---
|
||||
|
||||
## Phase 2 Launch Sequence
|
||||
|
||||
### Pre-Launch (2 weeks before)
|
||||
|
||||
Notification to existing users:
|
||||
> "You've completed [X] Turns and [Y] Mirror sessions. Something new is coming that turns all of that into self-knowledge. Stay tuned."
|
||||
|
||||
### Launch Day
|
||||
|
||||
> "The Spectrum is here. Every Turn you've taken, every fragment you've noticed — it all means something. See your full emotional landscape for the first time."
|
||||
|
||||
Open to a dramatic reveal of their personal Spectrum for the first time — the river visualization populating with their historical data, the gem forming its facets, the evolving pattern appearing.
|
||||
|
||||
This should be a **wow moment.** The user's own emotional history, visualized beautifully for the first time. Data they generated without thinking about it, now reflecting back as genuine self-knowledge.
|
||||
|
||||
### Post-Launch (ongoing)
|
||||
|
||||
Weekly and monthly cadence takes over. The Spectrum becomes a background engine that surfaces insights at the right moments and gives users a reason to maintain their Mirror and Turn habits.
|
||||
|
||||
---
|
||||
|
||||
## Updated Feature Map — Full Kalei Ecosystem
|
||||
|
||||
```
|
||||
PHASE 1 PHASE 2
|
||||
───────────────────────────────── ──────────────────────
|
||||
|
||||
THE MIRROR (Awareness) ──→ feeds data to ──→ THE SPECTRUM
|
||||
Write freely (Intelligence)
|
||||
AI highlights fragments See your patterns
|
||||
Inline reframes Track growth
|
||||
Discover rhythms
|
||||
THE KALEIDOSCOPE (Perspective) ──→ feeds data to ──→ Measure impact
|
||||
Structured reframing Evolving visual
|
||||
Fragment → Patterns
|
||||
Save keepsakes
|
||||
|
||||
THE LENS (Direction) ──→ informed by ──→
|
||||
Goal setting
|
||||
Daily affirmations
|
||||
Vision tracking
|
||||
|
||||
◇ ◇
|
||||
Kalei Free Kalei Prism
|
||||
3 Turns/day Unlimited everything
|
||||
2 Mirror/week + Full Spectrum
|
||||
Basic Lens + Weekly/monthly insights
|
||||
+ Growth trajectory
|
||||
+ Fragment analytics
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*White light looks simple. The Spectrum shows you everything it's made of.*
|
||||
Loading…
Reference in New Issue