Progression System: THE CONVERGENCE PROTOCOL
Core Philosophy
Why 40 Days?
The 40-day duration is not arbitraryβit carries deep resonance across cultures and psychology:
The Lent Metaphor
- Religious Lent spans 40 days of fasting, reflection, and preparation
- The sacrifice is small (10-15 minutes daily) but consistent
- The practice builds through accumulation, not intensity
- Transformation emerges from repetition, not revelation
Habit Formation Science
- Research suggests habit formation ranges from 18-254 days (average: 66)
- 40 days represents a meaningful βhabit incubationβ period
- Long enough to feel significant; short enough to feel achievable
- Creates a natural container for commitment
The Arc of Transformation
Days 1-7: Awareness ("There are patterns")
Days 8-14: Recognition ("I see them in others")
Days 15-21: Admission ("I see them in myself")
Days 22-28: Integration ("This is how memory works")
Days 29-35: Humility ("I am not the exception")
Days 36-40: Synthesis ("The observer and observed")
The Journey as Transformation, Not Consumption
Consumption Model (What We Avoid)
- Binge-watching content
- Checking boxes to βcompleteβ the app
- Accumulating facts about biases
- External validation (badges, points)
Transformation Model (What We Embrace)
- Daily practice as secular ritual
- Internal shift in perception
- Recognition of patterns in real-time
- Changed relationship with oneβs own mind
βThe goal is not to learn about biases. The goal is to become someone who notices them.β
Daily Practice as Secular Ritual
Ritual Elements
| Element | Traditional | Convergence Protocol |
|---|---|---|
| Time | Fixed hour | User-defined βday startβ |
| Place | Sacred space | Anywhere (mobile-first) |
| Action | Prayer/meditation | Contemplation + reflection |
| Community | Congregation | Optional sharing |
| Duration | Set period | 40 days |
| Outcome | Spiritual growth | Cognitive clarity |
The Secular Sacred
- No deity, doctrine, or dogma
- Reverence for consciousness itself
- Practice as an end, not a means
- The βsacredβ is awareness itself
The 40-Day Structure
Week 1: Foundation (Days 1-7)
Theme: Awareness of Perception
The first week introduces the fundamental insight: your perception is not reality. Each day reveals a different way your brain edits, filters, and fabricates experience.
| Day | Bias | Core Insight | Daily Practice |
|---|---|---|---|
| 1 | The Blind Spot | There is a literal hole in your vision your brain fills in | Map your blind spot; notice what you βseeβ that isnβt there |
| 2 | Change Blindness | You miss obvious changes when your attention shifts | Watch the video; count the passes; miss the gorilla |
| 3 | Inattentional Blindness | What you donβt attend to, you donβt perceive | The gorilla experiment; realize attention is zero-sum |
| 4 | Confirmation Bias | You see what you expect; you ignore what contradicts | Test: Seek disconfirming evidence today |
| 5 | Anchoring | The first number you hear becomes your reference point | Notice anchors in pricing, negotiations, your own estimates |
| 6 | Framing | Identical facts feel different based on presentation | Reframe a βlossβ as βnot a gainβ; feel the shift |
| 7 | Sunk Cost | Past investment shouldnβt affect future decisions | Identify one sunk cost youβre holding onto; practice letting go |
Week 1 Completion State:
- User understands: βMy perception is constructed, not receivedβ
- Behavioral shift: Pauses before trusting first impressions
- Emotional tone: Curiosity, slight unease, wonder
Week 2: Social (Days 8-14)
Theme: The Social Matrix
Week 2 reveals how profoundly others shape our thinkingβoften without our awareness.
| Day | Bias | Core Insight | Daily Practice |
|---|---|---|---|
| 8 | Groupthink | Groups prioritize harmony over truth | Recall a time you stayed silent to keep peace |
| 9 | Bystander Effect | Responsibility diffuses in groups | Notice: When did you assume someone else would act? |
| 10 | Social Proof | We follow the herd, even off cliffs | Observe: What are you doing because βeveryone doesβ? |
| 11 | Authority Bias | Credentials override critical thinking | Question one authority todayβgently, internally |
| 12 | Halo Effect | One positive trait colors all evaluation | Notice: Who do you assume is competent because you like them? |
| 13 | Fundamental Attribution Error | We blame character; we excuse circumstances | Catch yourself attributing behavior to βwho they areβ |
| 14 | False Consensus | We overestimate how much others agree with us | Ask: What do you assume βeveryoneβ thinks? Verify. |
Week 2 Completion State:
- User understands: βI am more influenced by others than I realizeβ
- Behavioral shift: Pauses to question social defaults
- Emotional tone: Mild paranoia (healthy), social awareness
Week 3: Decision (Days 15-21)
Theme: The Choice Architecture
Week 3 exposes the hidden forces shaping every decision you make.
| Day | Bias | Core Insight | Daily Practice |
|---|---|---|---|
| 15 | Analysis Paralysis | More options β worse decisions | Simplify one decision today; limit your options |
| 16 | Decision Fatigue | Willpower depletes like a muscle | Notice when your decisions get worse as the day progresses |
| 17 | Optimism Bias | Bad things happen to others, not me | What risk are you underestimating? |
| 18 | Loss Aversion | Losses hurt ~2x more than equivalent gains | Reframe a decision from loss to gain; notice resistance |
| 19 | Endowment Effect | You overvalue what you βownβ | Try to sell something you own; feel the price inflate |
| 20 | Status Quo Bias | Default options feel safer | Identify one default youβre maintaining without reason |
| 21 | Omission Bias | Doing nothing feels less blameworthy than acting | Notice when inaction is actually a choice |
Week 3 Completion State:
- User understands: βMy decisions are shaped by invisible forcesβ
- Behavioral shift: Builds decision-making checkpoints
- Emotional tone: Empowerment through awareness
Week 4: Memory & Time (Days 22-28)
Theme: The Unreliable Narrator
Week 4 shatters the illusion of memory as faithful recording.
| Day | Bias | Core Insight | Daily Practice |
|---|---|---|---|
| 22 | Hindsight Bias | βI knew it all alongβ (you didnβt) | Catch yourself retroactively predicting the past |
| 23 | Rosy Retrospection | The past was better than it was | Compare a memory to evidence (photos, journals) |
| 24 | Telescoping Effect | Recent events feel distant; distant events feel recent | Test: When did that actually happen? |
| 25 | Misattribution | Right memory, wrong source | Notice when you canβt remember where you learned something |
| 26 | Suggestibility | Memory is editable by suggestion | Be wary of how questions frame your recall |
| 27 | Consistency Bias | You rewrite your past to match your present | Notice: βIβve always believedβ¦β (have you?) |
| 28 | Peak-End Rule | Memories are defined by peak intensity and ending | Design a better ending for todayβs experience |
Week 4 Completion State:
- User understands: βMemory is reconstruction, not playbackβ
- Behavioral shift: Holds memories more lightly
- Emotional tone: Nostalgia questioned, presence valued
Week 5: Self (Days 29-35)
Theme: The Illusion of Self
Week 5 turns the lens inwardβexamining how you deceive yourself about yourself.
| Day | Bias | Core Insight | Daily Practice |
|---|---|---|---|
| 29 | Dunning-Kruger | Incompetence breeds confidence; competence breeds doubt | Where are you most confident? (Danger zone) |
| 30 | Impostor Syndrome | Competent people feel fraudulent | Name your competence; own it |
| 31 | Self-Serving Bias | Success = me; failure = circumstances | Reverse it: What failure was yours? What success was luck? |
| 32 | Illusion of Control | We believe we influence random events | Notice superstitions; catch yourself βinfluencingβ chance |
| 33 | Better-Than-Average | 80% of people believe theyβre above average | Math check: You canβt all be above average |
| 34 | Planning Fallacy | Everything takes longer than you think | Double your estimate; see what happens |
| 35 | Affect Heuristic | Feelings decide; reasons follow | Notice: What am I afraid of? Is that driving my βanalysisβ? |
Week 5 Completion State:
- User understands: βThe self I perceive is also a constructionβ
- Behavioral shift: Holds self-assessment more lightly
- Emotional tone: Humility, self-compassion, humor
Week 6: Convergence (Days 36-40)
Theme: The Synthesis
The final week integrates all patterns into a unified understanding.
| Day | Focus | Core Insight | Daily Practice |
|---|---|---|---|
| 36 | The Pattern | Biases are not bugs; theyβre features of a prediction machine | Map how todayβs biases connect to survival |
| 37 | The System | Individual biases create emergent social phenomena | See the system; be the exception |
| 38 | The Observer | Who notices the biases? | Rest in awareness itself; the watcher has no blind spot |
| 39 | The Practice | Integration into daily life | Design your personal bias-check protocol |
| 40 | The Convergence | The revelation, the mirror, the void | Complete the journey; begin the practice |
Day 40: The Convergence
The final meditation is a synthesis experience:
- The Revelation: Review all 39 previous insights
- The Mirror: Personalized report showing your most common biases (based on reflection patterns)
- The Void: A guided meditation on awareness without content
- The Commitment: Optional pledge to continue the practice
Week 6 Completion State:
- User understands: βAwareness itself is the practiceβ
- Behavioral shift: Continuous metacognition
- Emotional tone: Integration, peace, ongoing curiosity
Unlock Mechanics
Daily Unlock
Time-Based Unlocking
DEFAULT BEHAVIOR:
- Each day unlocks at user's "day start" time (default: 6:00 AM local)
- User can customize day start in settings (range: 4:00 AM - 12:00 PM)
- Unlock is based on local device time (no server dependency for basic function)
EXAMPLE USER FLOWS:
User A (Early Riser):
- Day start: 5:00 AM
- Day 1 unlocks Monday 5:00 AM
- Day 2 unlocks Tuesday 5:00 AM
- etc.
User B (Night Owl):
- Day start: 10:00 AM
- Day 1 unlocks Monday 10:00 AM
- Can still complete Day 1 at 2:00 AM Tuesday if desired
Grace Period
- Previous day remains completable until new day starts
- No penalty for completing βlateβ within the grace window
- Visual indicator shows βcompleting yesterdayβs meditationβ
Notification System
NOTIFICATION TYPES:
1. Day Unlocked (optional)
- "Day 12 is ready: Authority Bias"
- Sent at day start time
2. Streak Reminder (optional, customizable time)
- "Your 11-day streak continues. 5 minutes to maintain it."
- Default: 8:00 PM if not completed
3. Streak at Risk (optional)
- "Your streak ends in 3 hours. Today's meditation: Authority Bias"
- Sent 3 hours before day end
4. Milestone Celebration
- "7 days! You've completed Week 1: Foundation"
- Automatic, non-dismissible for 5 seconds
Streak System
Streak Definition
STREAK = Consecutive days with COMPLETED or REFLECTED status
STREAK MAINTENANCE:
- Day N completed β Streak +1
- Day N missed β Streak reset to 0
- Day N completed after missing β Streak = 1 (new streak)
Streak Recovery (48-Hour Window)
SCENARIO: User completes Day 5, misses Day 6, realizes Day 7 morning
WITHOUT RECOVERY:
- Day 6: MISSED
- Day 7: Can complete Day 6 OR Day 7, but not both
- Streak resets to 0
WITH RECOVERY (within 48 hours):
- Day 6: Can still be completed (marked "recovered")
- Day 7: Unlocks after Day 6 completed
- Streak continues (Day 6 marked with recovery indicator)
RECOVERY INDICATOR:
- Visual: Small "βΊ" icon next to day number
- Tooltip: "Recovered within 48 hours"
- Streak counts as continuous
Streak Milestones
MILESTONE CELEBRATION
βββββββββββββββββββββββββββββββββββββββββ
Day 3 "3 days! You're building momentum"
Day 7 "Week 1 complete! Foundation laid ποΈ"
Day 14 "Week 2 complete! Social awareness π"
Day 21 "Week 3 complete! Decision clarity βοΈ"
Day 30 "Week 5 complete! Self-knowledge πͺ"
Day 40 "THE CONVERGENCE. Journey complete. π
"
VISUAL CELEBRATION:
- Full-screen animation (3 seconds)
- Shareable milestone card
- Unlock of "milestone badge" (if badges enabled)
Catch-Up Mode
Behind Schedule Flow
SCENARIO: User completes Day 8, then doesn't open app for 5 days
STATE ON RETURN:
- Current day: Day 13 (by calendar)
- Last completed: Day 8
- Days behind: 4 (Days 9, 10, 11, 12)
CATCH-UP OPTIONS:
1. Sequential Mode (default):
- Must complete Day 9 before Day 10 unlocks
- Maintains narrative integrity
- Recommended for first-time users
2. Skip to Current (not recommended):
- Jump to Day 13
- Missed days marked "skipped"
- Can return to skipped days later
ENCOURAGEMENT MESSAGING:
- "You're 4 days behind. That's 40 minutes to catch up."
- "Each day builds on the last. Take your time."
- "No penalty for catching up. The practice is what matters."
No Skipping Ahead
ENFORCEMENT:
- Day N+1 remains locked until Day N is COMPLETED or REFLECTED
- Even if calendar date is far ahead
- Prevents binge-consumption
- Maintains daily practice rhythm
EXCEPTION:
- User can reset progress and start over
- All previous data archived (not deleted)
- New journey begins at Day 1
Progress Persistence
Completion States
STATE MACHINE:
NOT_STARTED ββ[unlock]βββΊ AVAILABLE ββ[user opens]βββΊ IN_PROGRESS
β
βΌ
REFLECTED βββ[adds journal]ββ COMPLETED
β
βββ[edit]βββΊ IN_PROGRESS (re-open)
STATE DEFINITIONS:
NOT_STARTED
βββ Day is locked (future day)
βββ Day is unlocked but user hasn't opened
βββ Visual: Locked icon or "Start" button
IN_PROGRESS
βββ User has opened the day's meditation
βββ Timer tracking active (minimum 5 minutes for completion)
βββ Visual: Progress indicator, "Continue" button
COMPLETED
βββ User has met minimum time requirement
βββ Can review content
βββ Visual: Checkmark, "Review" button
REFLECTED
βββ COMPLETED + journal entry added
βββ Maximum engagement state
βββ Visual: Double checkmark, "Review & Edit" button
Progress Metrics
Core Metrics
METRIC TYPE RANGE DISPLAY
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
days_completed integer 0-40 Primary
current_streak integer 0-40 Prominent
longest_streak integer 0-40 Secondary
total_time_spent minutes 0+ Hidden (stats)
reflections_written integer 0-40 Secondary
days_reflected_on integer 0-40 Secondary
completion_percentage percent 0-100 Progress bar
Derived Metrics
ENGAGEMENT SCORE:
- Formula: (days_reflected / days_completed) * 100
- Range: 0-100
- Interpretation: % of completed days with reflection
CONSISTENCY SCORE:
- Formula: (current_streak / days_since_start) * 100
- Range: 0-100
- Interpretation: % of days completed on schedule
DEPTH SCORE:
- Formula: weighted average of time spent per day
- Range: 0-100
- Interpretation: average engagement depth
Progress Visualization
PRIMARY VIEW (Dashboard):
βββββββββββββββββββββββββββββββββββββββ
β Day 17 of 40 [ββββββββββ]β
β Decision Fatigue β
β β
β Current Streak: 16 days π₯ β
β Longest Streak: 16 days β
βββββββββββββββββββββββββββββββββββββββ
SECONDARY VIEW (Calendar):
ββββ¬βββ¬βββ¬βββ¬βββ¬βββ¬βββ
β 1β 2β 3β 4β 5β 6β 7β Week 1 β
ββ ββ ββ ββ ββ ββ ββ β
ββββΌβββΌβββΌβββΌβββΌβββΌβββ€
β 8β 9β10β11β12β13β14β Week 2 β
ββ ββ ββ ββ ββ ββ ββ β
ββββΌβββΌβββΌβββΌβββΌβββΌβββ€
β15β16β17β18β19β20β21β Week 3 β
ββ ββ ββ ββ― ββ― ββ― ββ― β (current)
ββββ΄βββ΄βββ΄βββ΄βββ΄βββ΄βββ
LEGEND:
β = Completed
ββ = Completed + Reflected
β = In Progress
β― = Available
π = Locked
βΊ = Recovered
The βLentβ Metaphor
Parallels to Religious Lent
| Aspect | Religious Lent | Convergence Protocol |
|---|---|---|
| Duration | 40 days | 40 days |
| Sacrifice | Fasting, abstinence | 10-15 minutes daily |
| Practice | Prayer, almsgiving | Meditation, reflection |
| Goal | Spiritual growth | Cognitive clarity |
| Community | Church congregation | Optional sharing |
| Culmination | Easter | The Convergence (Day 40) |
| Failure | Breaking fast | Missing a day |
| Response to failure | Confession, continue | No guilt, just continue |
Key Difference: No Guilt
RELIGIOUS LENT:
- Missing a day may carry spiritual weight
- Confession or making up may be expected
- Community awareness of "failure"
CONVERGENCE PROTOCOL:
- Missing a day is neutral information
- No penalty, no confession needed
- Private practice (unless shared)
- The only "failure" is abandoning entirely
MESSAGING:
"Missed a day? The practice continues when you do."
"Streaks are fun, but awareness is the point."
"40 days is the container, not the contract."
The Secular Sacred
WHAT MAKES IT "SACRED":
- Dedicated time and attention
- Ritual structure (daily, consistent)
- Transformation as goal
- Reverence for the practice itself
WHAT KEEPS IT SECULAR:
- No supernatural claims
- No moral judgment
- Evidence-based content
- Optional participation
THE MIDDLE PATH:
"You don't need to believe anything to practice this.
You only need to notice."
Behavioral Design
Motivators
Progress Visualization
IMPLEMENTATION:
- Calendar view with completion states
- Progress bar (x of 40 days)
- Weekly theme completion badges
- Day 40 as visible goal
PSYCHOLOGY:
- Visual progress creates sense of advancement
- Completion bias: desire to fill empty boxes
- Endowed progress effect: started = more likely to finish
Streak Maintenance
IMPLEMENTATION:
- Daily streak counter (prominent)
- Streak at risk notifications
- Recovery mechanism (48-hour window)
- Milestone celebrations
PSYCHOLOGY:
- Loss aversion: don't break the streak
- Sunk cost: invested time motivates continuation
- Social proof (if sharing): others see your streak
ETHICAL CONSIDERATIONS:
- Streaks motivate but shouldn't create anxiety
- Clear messaging: streak is tool, not identity
- Easy recovery prevents abandonment after break
Weekly Themes as Narrative Arc
IMPLEMENTATION:
- Each week has theme name and description
- Theme introduction on first day
- Theme reflection on last day
- Narrative connects individual days
PSYCHOLOGY:
- Story structure increases engagement
- Anticipation: "What's next week about?"
- Coherence: individual days form whole
- Meaning-making: the journey has purpose
Day 40 as Ultimate Goal
IMPLEMENTATION:
- Day 40 teaser: "The Convergence"
- Partial reveal of final meditation
- Milestone celebrations build toward it
- Post-completion: "Continue the practice" option
PSYCHOLOGY:
- Goal gradient effect: effort increases near goal
- Achievement unlocks satisfaction
- Completion creates positive memory of experience
Social Comparison (Optional)
IMPLEMENTATION:
- Anonymous cohort comparison (opt-in)
- "You're in the top 20% of practitioners"
- Optional sharing of milestones
- No individual comparison (no leaderboards)
PSYCHOLOGY:
- Relative performance motivates some users
- Social proof: others are doing this too
- Community feeling without competition
PRIVACY PROTECTION:
- Default: no social features
- Opt-in required for any comparison
- Aggregate data only (no individual identification)
- Easy opt-out at any time
Friction Reduction
One-Click Entry
IMPLEMENTATION:
- Primary CTA: "Today's Meditation" (largest button)
- Opens directly to current day's content
- No navigation required for core action
- Secondary options: Calendar, Stats, Settings
USER FLOW:
1. Open app
2. Tap "Today's Meditation"
3. Begin practice (5-15 seconds total)
Reminder Notifications (Optional)
IMPLEMENTATION:
- Default: disabled (respect attention)
- User enables with custom time
- Smart reminders: only if not completed
- No more than 1 reminder per day
CONFIGURATION:
- Enable/disable toggle
- Time picker (default: 8:00 PM)
- Message style: Gentle, Direct, or Minimal
- Quiet hours respect (no notifications 10 PM - 8 AM)
Quick Completion
IMPLEMENTATION:
- Minimum time: 5 minutes (enforced but low)
- Can complete in single session
- No required actions beyond time spent
- Optional reflection (not required for completion)
TIME GUIDELINES:
- Minimum: 5 minutes (counts as completed)
- Recommended: 10-15 minutes (full experience)
- Extended: 20+ minutes (deep dive available)
PROGRESSIVE DISCLOSURE:
- Core content: 5-10 minutes
- Extended content: unlocks after completion
- Deep dive: optional, always available
Mobile-Optimized
IMPLEMENTATION:
- Portrait-first design
- Readable without zoom
- One-handed operation possible
- Offline content available
- Low bandwidth mode
CONTEXTS SUPPORTED:
- Morning commute (public transit)
- Lunch break (quiet space)
- Evening wind-down (bedtime)
- Waiting rooms (any downtime)
- Walking (audio mode)
Recovery Paths
βLife Happensβ Philosophy
CORE MESSAGE:
"The practice is here when you need it.
Missing a day doesn't miss the point."
IMPLEMENTATION:
- No negative messaging about missed days
- No penalties or lost progress
- Easy re-entry after any gap
- Progress never auto-deleted
Easy Restart After Break
USER FLOW: Return after 2-week gap
1. Welcome back message (not "you failed")
"Welcome back. The practice continues."
2. Quick status overview
"You were on Day 17. Ready to continue?"
3. Options presented:
- Continue from Day 17 (recommended)
- Review previous days first
- Start fresh (archive old progress)
4. No judgment, no guilt
- Streak shows as "0 (was 16)"
- Can build new streak immediately
Review Past Meditations Anytime
IMPLEMENTATION:
- All completed days accessible
- Search by bias name
- Filter by week/theme
- Bookmark favorites
USE CASES:
- "I want to re-read the Anchoring meditation"
- "What was that bias about memory again?"
- "Show me all the social biases"
Progress Never Lost
DATA PERSISTENCE:
- Local storage: primary (device)
- Cloud backup: optional sync
- Export: JSON/CSV available
- Archive: previous journeys saved
RESET OPTIONS:
- Soft reset: start new journey, archive old
- Hard reset: delete all data (with confirmation)
- Export first: always offered before reset
SCENARIOS:
- New phone: restore from cloud
- App reinstall: restore from cloud
- Account deletion: data purged per policy
User Flows and Edge Cases
Primary User Flows
Flow 1: New User - First Day
1. Download app / Open web app
2. Onboarding (3 screens):
- What is Convergence Protocol?
- How 40 days works
- Set day start time
3. Day 1 unlocks immediately
4. Tap "Begin Day 1"
5. Experience meditation (5-15 min)
6. Completion screen:
- "Day 1 complete!"
- Optional reflection prompt
- Preview Day 2
7. Dashboard shows: Day 1 β, Streak: 1
Flow 2: Daily Practice - Regular User
1. Notification (optional): "Day 12 is ready"
2. Open app
3. Tap "Today's Meditation" (one click)
4. Experience meditation
5. Add reflection (optional)
6. Completion screen with streak update
7. Close app (30 seconds total interaction)
Flow 3: Catch-Up - Behind User
1. Open app after 3-day gap
2. Dashboard shows:
- "You're 3 days behind"
- Days 9, 10, 11 available
- Current streak: 0 (was 8)
3. Tap "Catch Up"
4. Day 9 meditation begins
5. After completion:
- "Day 9 complete. Continue to Day 10?"
- Option to stop or continue
6. Can complete all 3 in one session or spread out
Flow 4: Completion - Day 40
1. Open Day 40 meditation
2. Extended experience (20-30 min):
- Review of all 39 previous insights
- Personalized bias profile
- Guided convergence meditation
3. Final completion screen:
- Celebration animation
- "40 days. The journey is complete."
- Options:
* Continue daily practice (maintenance mode)
* Review favorite meditations
* Share achievement
* Start new journey
4. App transitions to "Alumni" mode
Edge Cases
Edge Case 1: Time Zone Change
SCENARIO: User travels across time zones
BEHAVIOR:
- Day start time follows device local time
- No disruption to streak if completed before travel
- If in-flight during day start: grace period applies
EXAMPLE:
- User in NYC (Day start: 6 AM EST)
- Flies to London (arrives 11 PM EST / 4 AM GMT)
- Day start becomes 6 AM GMT (1 AM EST)
- User can complete day's meditation any time before 6 AM GMT
Edge Case 2: Daylight Saving Time
SCENARIO: DST transition during 40 days
BEHAVIOR:
- Day start time adjusts automatically
- "Spring forward": day is 23 hours (shorter completion window)
- "Fall back": day is 25 hours (longer completion window)
- Streak protection: if missed due to DST confusion, offer recovery
MESSAGING:
"Daylight Saving Time changed your day start.
Your streak is protected if you need the recovery window."
Edge Case 3: Device Clock Manipulation
SCENARIO: User changes device clock to unlock future days
DETECTION:
- Server-side timestamp validation (if online)
- Anomaly detection: large time jumps
- Cross-reference with previous session times
RESPONSE:
- If offline: allow (trust user)
- If online: block future day unlock
- Message: "Days unlock based on your practice schedule"
- No penalty, just prevention
RATIONALE:
- App is for personal growth, not competition
- Cheating only harms the user
- Offline-first design prioritizes accessibility
Edge Case 4: Multiple Devices
SCENARIO: User has phone and tablet
SYNC BEHAVIOR:
- With cloud sync: progress syncs across devices
- Without cloud sync: each device independent
- Conflict resolution: most recent completion wins
USER FLOW:
1. Complete Day 5 on phone
2. Open app on tablet
3. If synced: shows Day 5 complete
4. If not synced: shows Day 5 available
5. User can manually sync or continue on either device
Edge Case 5: App Uninstall/Reinstall
SCENARIO: User deletes app, later reinstalls
RECOVERY:
- With cloud backup: restore all progress
- Without backup: progress lost (local only)
- Onboarding offers: "Restore from cloud?"
MESSAGING:
"Welcome back to Convergence Protocol.
We found a previous journey. Restore it?"
[Restore] [Start Fresh]
Edge Case 6: Extended Absence (30+ days)
SCENARIO: User stops at Day 20, returns 2 months later
WELCOME FLOW:
1. "Welcome back to Convergence Protocol"
2. "You were on Day 20 of 40 (Decision Fatigue)"
3. Options:
- Continue from Day 20 (recommended)
- Review Week 3 before continuing
- Start fresh (archive old progress)
4. No guilt messaging
5. Streak shows as new (previous streak archived)
ARCHIVED JOURNEYS:
- Accessible from settings
- Shows: start date, end date, days completed
- Can review but not modify
Edge Case 7: Completion Before Day 40
SCENARIO: User wants to "finish early"
POLICY:
- Days cannot be skipped
- Day 40 only unlocks after Day 39
- Rationale: the practice is in the duration
ALTERNATIVES OFFERED:
- "Preview mode": read content without completion
- "Quick mode": minimum 5 minutes per day
- "Maintenance mode": after Day 40, review any day
MESSAGING:
"The Convergence Protocol is designed as a 40-day practice.
Each day builds on the last. Take your time."
Edge Case 8: Accessibility Needs
SCENARIO: User has visual, auditory, or motor impairments
SUPPORT:
- Screen reader compatibility (WCAG 2.1 AA)
- Text-to-speech for all content
- High contrast mode
- Adjustable font sizes (12-24pt)
- Voice control support
- Reduced motion option
CONTENT ADAPTATIONS:
- Visual experiments have text descriptions
- Audio content has transcripts
- Interactive elements have keyboard navigation
- Timing requirements can be extended
Edge Case 9: Interruption During Meditation
SCENARIO: Phone call, notification, or user exits mid-session
BEHAVIOR:
- Progress saved at 30-second intervals
- On return: "Continue where you left off?"
- Timer pauses automatically
- Can resume or restart
MINIMUM TIME:
- If interrupted before 5 minutes: doesn't count as completed
- If interrupted after 5 minutes: can mark complete
- User honesty system (no verification)
Edge Case 10: Sharing Device
SCENARIO: Multiple people use same device
SOLUTIONS:
1. Multiple profiles (if implemented):
- Each user has separate progress
- Switch profile on launch
2. Single profile (default):
- Progress is device-based
- Recommendation: each user has own device
- Or: use web version with separate accounts
MESSAGING:
"Convergence Protocol tracks personal progress.
For multiple users, we recommend separate devices or accounts."
Implementation Considerations
Data Model
// Core entities
interface User {
id: string;
createdAt: Date;
settings: UserSettings;
currentJourney: Journey | null;
archivedJourneys: Journey[];
}
interface UserSettings {
dayStartTime: Time; // default: 06:00
notificationsEnabled: boolean;
reminderTime: Time | null; // default: 20:00
theme: 'light' | 'dark' | 'system';
fontSize: number; // 12-24
cloudSyncEnabled: boolean;
}
interface Journey {
id: string;
startedAt: Date;
completedAt: Date | null;
days: DayProgress[];
currentStreak: number;
longestStreak: number;
totalTimeSpent: number; // minutes
}
interface DayProgress {
dayNumber: number; // 1-40
biasId: string;
status: 'not_started' | 'in_progress' | 'completed' | 'reflected';
startedAt: Date | null;
completedAt: Date | null;
timeSpent: number; // minutes
reflection: Reflection | null;
wasRecovered: boolean; // true if completed after 48h window
}
interface Reflection {
content: string;
createdAt: Date;
updatedAt: Date;
}State Management
// Day unlock logic
function getDayStatus(
dayNumber: number,
journey: Journey,
currentTime: Date,
dayStartTime: Time
): DayStatus {
// Day 1 always available for new journey
if (dayNumber === 1 && !journey.days[0].startedAt) {
return 'available';
}
// Previous day must be completed
const previousDay = journey.days[dayNumber - 2];
if (previousDay && !['completed', 'reflected'].includes(previousDay.status)) {
return 'locked';
}
// Check if unlock time has passed
const unlockTime = calculateUnlockTime(dayNumber, journey.startedAt, dayStartTime);
if (currentTime < unlockTime) {
return 'locked';
}
// Return actual status
return journey.days[dayNumber - 1].status;
}
function calculateUnlockTime(
dayNumber: number,
journeyStart: Date,
dayStartTime: Time
): Date {
const daysSinceStart = dayNumber - 1;
const unlockDate = addDays(journeyStart, daysSinceStart);
return setTime(unlockDate, dayStartTime);
}Privacy and Security
Data Collection
MINIMAL DATA PRINCIPLE:
- Collect only what's necessary for functionality
- No third-party analytics without consent
- No advertising identifiers
- No behavioral profiling for ads
DATA COLLECTED:
- Progress data (days completed, streaks)
- Reflection content (if cloud sync enabled)
- Settings preferences
- Anonymous usage stats (opt-in)
DATA NOT COLLECTED:
- Location data
- Contact lists
- Browsing history
- Personal identifiers (beyond account)
Reflection Privacy
REFLECTION CONTENT:
- Stored locally by default
- Encrypted if cloud sync enabled
- Never analyzed for advertising
- Never shared without explicit consent
- Can be exported or deleted anytime
PRIVACY LEVELS:
1. Local only: reflections never leave device
2. Encrypted sync: reflections synced, encrypted at rest
3. Shared (future): optional sharing with community
Export and Deletion
USER RIGHTS:
- Export all data (JSON/CSV)
- Delete account and all data
- Delete individual reflections
- Withdraw from cloud sync
DELETION BEHAVIOR:
- Soft delete: 30-day recovery window
- Hard delete: permanent after 30 days
- Backups: purged within 90 days
Summary
The Convergence Protocolβs progression system is designed to:
- Create meaningful transformation through 40 days of structured practice
- Balance motivation with compassion via streaks that donβt punish
- Respect user autonomy with optional features and easy recovery
- Maintain narrative coherence through weekly themes and day-by-day unlocking
- Support diverse contexts with mobile-first, offline-capable design
- Protect user privacy with minimal data collection and strong encryption
The system treats the 40-day journey as a secular ritualβa container for transformation that is both structured and forgiving, both challenging and compassionate.
βThe goal is not to complete 40 days. The goal is to become someone who notices.β