Focus Session Manager

Focus Session Manager

Protect your health. Maximize focus. Prevent burnout.

Core Principle

ADHD brains are prone to hyperfocus (ignoring breaks, health) and time blindness (losing track of time). The solution: Automated session management that tracks time, enforces breaks, and protects health without disrupting flow state.

Key Insight: You can't manage time you can't see. Make time visible and automatic.

---

The Focus Problem

Problem 1: Hyperfocus Burnout

Issue: Code for 4 hours straight without break Result: Exhaustion, health issues, reduced quality

Problem 2: Time Blindness

Issue: "I'll work for 30 min" → Actually 3 hours Result: Missed meetings, forgotten commitments, burnout

Problem 3: Break Resistance

Issue: "Just one more thing" never stops Result: No breaks, deteriorating health, reduced productivity

Problem 4: Disrupted Flow

Issue: Harsh timer interruptions break concentration Result: Frustration, ignoring timers, no break system

---

Phase 1: Automatic Session Tracking

Always-On Time Tracking

Starts automatically when you begin coding:

[Session Started: 14:00]

⏱️ Focus Timer Running
📊 Today's focus time: 0 hours
🎯 Goal: 4 hours
🔥 Current streak: 2 days

Mode: Deep Work
Next break: 14:25 (in 25 min)

Visible Time Display

Status bar shows:

⏱️ 23:45 | 🧠 Focus Session 1/4 | 💧 Water reminder soon

Session Types (Auto-Detected)

Deep Work: Complex coding, architecture

• Duration: 45-90 minutes
• Break: 15 minutes
• Best for: New features, debugging

Quick Tasks: Bug fixes, updates

• Duration: 25 minutes
• Break: 5 minutes
• Best for: Small fixes, reviews

Learning: Reading docs, tutorials

• Duration: 30 minutes
• Break: 10 minutes
• Best for: New tech, research

---

Phase 2: ADHD-Optimized Pomodoro

Traditional Pomodoro (ADHD-Hostile)

❌ Rigid 25-min timer (might be mid-thought) ❌ Harsh interruption (breaks flow) ❌ Forced break (when you're in flow) ❌ No hyperfocus protection (ignores long sessions)

ADHD-Friendly Pomodoro

✅ Flexible timers (25/45/90 min options) ✅ Gentle reminders (dismissable but persistent) ✅ Flow-aware breaks (suggests good stopping points) ✅ Hyperfocus detection (escalating alerts)

Smart Break Timing

[25 minutes elapsed]

🟡 Break suggestion available

Good stopping point detected:

- ✅ Just committed code
- ✅ Tests passing
- ✅ Natural pause point

Take 5-minute break?
[Take Break Now] [Extend 15 min] [Remind in 5 min]

---

Phase 3: Break Management

Break Types

Micro-Break (2 minutes):

• Look away from screen (20-20-20 rule)
• Stretch in chair
• No leaving desk

Short Break (5 minutes):

• Stand up
• Walk around
• Get water
• Bathroom

Medium Break (15 minutes):

• Walk outside
• Snack
• Different room
• Social interaction

Long Break (30-60 minutes):

• Meal
• Exercise
• Complete context switch

Automatic Break Reminders

[After 25 min coding]

⏸️ Break Suggestion (5 minutes)

Your brain has been focused for 25 min.
Short break will improve next session.

Break activities:

- [ ] Stand and stretch
- [ ] Get water
- [ ] Look out window (eyes)
- [ ] Bathroom if needed

Timer: 5 minutes
Resume automatically after break.

[Start Break] [Extend Session] [Dismiss]

Break Enforcement Levels

Level 1: Gentle Reminder (25-45 min)

💭 Reminder: Break time soon
[Dismissable, comes back in 10 min]

Level 2: Strong Suggestion (45-90 min)

⚠️ You've been coding for 60 minutes
Break highly recommended
[Dismissable twice, then escalates]

Level 3: Health Alert (90+ min)

🚨 HEALTH ALERT: 90 min no break

This is affecting:
- Eye strain
- Back pain
- Mental fatigue
- Code quality

Required actions:
- [ ] Stand up NOW
- [ ] 2-minute walk
- [ ] Water

[Cannot dismiss until you move]

Level 4: Forced Break (3+ hours)

🛑 MANDATORY BREAK

You've been coding for 3 hours straight.
Context saved automatically.
Dev server paused.

Required 15-minute break.
I'll help you resume after.

[Break Started - Timer: 15:00]

---

Phase 4: Hyperfocus Protection

Hyperfocus Detection

Triggers at 90 minutes continuous work:

[90 minutes elapsed]

🔍 HYPERFOCUS DETECTED

You've been deeply focused for 90 minutes.
This is good for productivity BUT...

Health check required:

- [ ] When did you last drink water? \_\_\_\_
- [ ] When did you last move? \_\_\_\_
- [ ] Are your eyes strained? Y/N
- [ ] Do you need bathroom? Y/N

If 2+ concerns: TAKE BREAK NOW
If 0-1 concerns: Can extend 30 min

[Take Break] [Extend 30min] [Health Check]

The Hyperfocus Paradox

Good Hyperfocus: Deep work on right thing Bad Hyperfocus: Stuck optimizing CSS for 4 hours

Detecting Bad Hyperfocus

[2 hours on same file, many reverts]

💭 Gentle check-in:

I notice you've been working on button.css
for 2 hours with 12 commits and 5 reverts.

Questions:

- Is this P0 for shipping? YES/NO
- Could this be "good enough" now? YES/NO
- Are you stuck in perfectionism? YES/NO

Maybe time to:

- Commit current state
- Move to next task
- Come back later with fresh eyes

[Keep Going] [Take Break] [Switch Tasks]

---

Phase 5: Session Planning

Daily Session Plan (Auto-Generated)

# Today's Focus Sessions

Total available: 6 hours
Sessions planned: 4

Morning (9am - 12pm):

- Session 1: Build dashboard UI (45 min) 🔨
  Break: 10 min
- Session 2: Connect to API (45 min) 🔨
  Break: 10 min
- Session 3: Handle errors (30 min) ⚡
  Break: Lunch (60 min)

Afternoon (1pm - 5pm):

- Session 4: Write tests (45 min) 🧪
  Break: 10 min
- Session 5: Code review (30 min) 👀
  Break: 10 min
- Session 6: Deploy (20 min) 🚀
  Break: End of day

Total focus time: 4.5 hours
Buffer time: 1.5 hours (interruptions)

Realistic and achievable! 💪

Energy-Aware Scheduling

Morning Energy: High ⚡⚡⚡

- Schedule: Complex tasks (new features)
- Session length: 45-90 min
- Break length: 10 min

Afternoon Energy: Medium ⚡⚡

- Schedule: Medium tasks (bug fixes)
- Session length: 30-45 min
- Break length: 15 min

Evening Energy: Low ⚡

- Schedule: Easy tasks (docs, reviews)
- Session length: 25 min
- Break length: 5-10 min

---

Phase 6: Context-Aware Breaks

Before-Break Ritual (Automatic)

[Break starting in 1 minute]

Quick save (30 seconds):
✅ Auto-committing code
✅ Saving mental state
✅ Noting next step

You were: Adding email validation
Next: Test validation logic (10 min)

Break ready! Take 5 minutes.
Resume will be easy.

After-Break Ritual (Automatic)

[Break ended]

Welcome back! (Rested: 5 minutes)

Quick recap:
📍 File: src/components/form.tsx:42
💭 You were: Adding email validation
🎯 Next: Test validation logic (10 min)
⏱️ Session: 25 minutes

[Resume button opens file at exact line]

Estimated resume time: 30 seconds

---

Phase 7: Health Monitoring

The 20-20-20 Rule (Auto-Enforced)

Every 20 minutes: Look at something 20 feet away for 20 seconds

[20 minutes screen time]

👁️ Eye Break (20 seconds)

Look at something 20 feet away.
Clock will count down.

20... 19... 18... 17...

[Countdown with calming animation]

✅ Done! Eyes protected.

Hydration Reminders

[60 minutes since last water reminder]

💧 Hydration Check

When did you last drink water?

- Just now: Reset timer
- 30 min ago: Doing okay
- 1+ hour ago: Go drink NOW

ADHD brains often forget water.
Dehydration affects focus.

[I drank water] [Remind in 30min]

Movement Tracking

[90 minutes sitting]

🚶 Movement Required

You've been sitting for 90 minutes.
This affects:

- Blood flow
- Energy levels
- Back health
- Focus quality

Minimum: Stand for 2 minutes
Better: Walk for 5 minutes
Best: Go outside

[I moved] [Remind in 15min]

---

Phase 8: Transition Rituals

Starting Work Ritual

[Morning start]

☀️ Good morning! Let's start work.

Quick setup (2 minutes):

1. Review today's plan ✅
2. Set focus goal: 4 hours
3. Pick first task ✅
4. Start focus timer ✅

First session: Dashboard UI (45 min)
Next break: 9:45am

Let's do this! 💪

[Start Session]

Ending Work Ritual

[5pm - End of day]

🌙 Wrapping up for the day?

Today's stats:

- Focus time: 4.5 hours ✅
- Sessions completed: 6
- Breaks taken: 5
- Tasks completed: 7

Tomorrow setup:

- First task: Test password reset (30 min)
- Should be quick! Easy start.

Wins today:
✅ Built entire dashboard UI
✅ Connected to API
✅ Fixed 2 bugs

You crushed it today! 🎉

[End Day] [Keep Working]

Task Switch Ritual

[Switching from Task A to Task B]

🔄 Task Switch

Saving Task A context...
✅ Committed work
✅ Saved mental state

Loading Task B...
✅ Opened files
✅ Loaded context
✅ Showing next step

Switch time: 2 minutes

Ready for Task B!

---

Phase 9: Distraction Management

Focus Mode Levels

Level 1: Normal (Default)

• Notifications: On
• Chat: Available
• Interruptions: Allowed

Level 2: Focus Mode

• Notifications: Snoozed
• Chat: Away status
• Interruptions: Emergency only

Level 3: Deep Work Mode

• Notifications: Off
• Chat: Do not disturb
• Interruptions: None
• Music: Focus playlist auto-starts

Auto-Enable Focus Mode

[Deep work session starting]

Enabling Focus Mode:
✅ Notifications snoozed
✅ Chat status: Away
✅ Email closed
✅ Focus music started

Distractions minimized.
You have 45 minutes of protected time.

[Session starting...]

Distraction Recovery

[You opened Twitter mid-session]

💭 Distraction detected!

You were focused on: Building dashboard
Time lost: 5 minutes
Session time remaining: 15 minutes

Quick reset:

- [ ] Close Twitter
- [ ] Take 2-minute break
- [ ] Resume with fresh focus

Or:

- [ ] Take full break now (5 min)
- [ ] Resume with new session

No judgment! ADHD brains wander.
Let's just get back on track. 💪

---

Phase 10: Session Analytics

Daily Stats (Auto-Generated)

# Today's Focus Summary

⏱️ Total Focus Time: 4.5 hours
🎯 Goal: 4 hours (exceeded! 🎉)
📊 Sessions: 6 completed
⏸️ Breaks: 5 taken
🔥 Longest session: 90 min
💧 Water reminders: 6 (all completed)
👁️ Eye breaks: 12 (all completed)

Top productive hours:
9am-11am: 2 hours deep work ⚡
2pm-4pm: 1.5 hours ⚡

Distraction time: 30 min (acceptable)

Health score: 9/10 (excellent!)

- Took all breaks ✅
- Drank water ✅
- Eye breaks ✅
- Moved regularly ✅

Tomorrow's recommendation:
Same pattern works well for you!

Weekly Trends

# This Week's Focus Patterns

Mon: 4.5 hours (great!)
Tue: 3 hours (interrupted day)
Wed: 5 hours (best day! 🔥)
Thu: 4 hours (solid)
Fri: 2 hours (expected lower)

Weekly average: 3.7 hours/day
Trend: +15% vs last week 📈

Best times for deep work:

- 9-11am (morning energy)
- 2-4pm (post-lunch focus)

Avoid scheduling deep work:

- 11am-1pm (pre-lunch slump)
- 4-5pm (end of day fatigue)

Keep the momentum! 💪

---

Automation

Auto-Start (Session Detection)

[You opened VS Code at 9:00am]

Good morning! Starting focus session...

✅ Timer started
✅ First task loaded
✅ Break scheduled (9:45am)
✅ Focus mode enabled

Session: Build dashboard UI
Duration: 45 minutes

Let's code! 🚀

Auto-Pause (Inactivity Detection)

[No code changes for 10 min]

Session paused automatically.

Are you:

- Taking a break? (Timer paused)
- In a meeting? (Session saved)
- Distracted? (Gentle reminder)
- Done for now? (End session)

[Resume] [Take Break] [End Session]

Auto-End (5pm Default)

[5:00pm]

End of work day!

Auto-wrapping up:
✅ Session saved
✅ Context preserved
✅ Stats logged
✅ Tomorrow prepared

See you tomorrow! 🌙

---

Success Metrics

You're using this well when:

• ✅ Taking regular breaks (not skipping)
• ✅ Hyperfocus sessions < 90 min
• ✅ Health checks completed (water, eyes, movement)
• ✅ Focus time increasing (sustainable pace)
• ✅ End-of-day energy higher (not exhausted)

---

Related Skills

• context-preserver - Auto-saves state before/after breaks
• task-breakdown-specialist - Plans work for sessions
• completion-coach - Helps finish sessions strong

---

Focus hard. Break often. Protect your health. ⏱️

Focus Session Manager - Quick Start

Version: 1.0.0 Category: ADHD Support Difficulty: Beginner

What This Skill Does

Automatically manages focus sessions, breaks, and hyperfocus protection. Tracks time, enforces healthy breaks, and prevents burnout. ADHD-optimized Pomodoro with flexible timers and gentle reminders.

When to Use

Always active! Runs automatically in the background.

Protects against:

• Hyperfocus burnout (coding 4+ hours straight)
• Time blindness (losing track of time)
• Skipping breaks (health issues)
• Eye strain, dehydration, back pain

Quick Start

Zero setup - starts automatically:

[You start coding at 9:00am]

⏱️ Focus session started
Duration: 45 minutes
Next break: 9:45am
Mode: Deep Work

[Background timer running...]

That's it! Everything else is automatic.

Key Features

Auto-Tracking

• ✅ Starts when you code
• ✅ Tracks focus time
• ✅ Schedules breaks
• ✅ Pauses on inactivity

Smart Break Reminders

[After 45 min]

⏸️ Break suggestion

Good stopping point:
- Code committed ✅
- Tests passing ✅
- Natural pause ✅

Take 10-min break?

Hyperfocus Protection

[After 90 min]

🚨 HYPERFOCUS ALERT

You've been coding 90 min no break!

Required: 10-minute break
Health check: Water, movement, eyes

[Cannot dismiss]

Health Monitoring

• 💧 Water reminders (every 60 min)
• 👁️ Eye breaks (20-20-20 rule)
• 🚶 Movement alerts (every 90 min)

Session Types

Deep Work (45-90 min)

• Complex coding, new features
• Break: 15 minutes
• Auto-detected for new files

Quick Tasks (25 min)

• Bug fixes, small changes
• Break: 5 minutes
• Auto-detected for existing files

Learning (30 min)

• Reading docs, tutorials
• Break: 10 minutes
• Auto-detected for browser activity

Break Levels

Level 1: Gentle (25-45 min)

💭 Break time soon
[Dismissable]

Level 2: Strong (45-90 min)

⚠️ Break recommended
[Dismissable 2x, then escalates]

Level 3: Required (90+ min)

🚨 Health alert
[Must acknowledge health check]

Level 4: Forced (3+ hours)

🛑 Mandatory 15-min break
[Context saved, timer enforced]

Automation

Auto-Start

[VS Code opened]
✅ Session started
✅ Timer running
✅ First task loaded

Auto-Break Detection

[Natural stopping point found]
✅ Code committed
✅ Tests passing
→ Break reminder shows

Auto-Pause

[10 min inactive]
⏸️ Session paused
Context saved
Resume anytime

Auto-End

[5:00pm]
📊 Day summary
✅ Stats logged
🌙 See you tomorrow

Daily Stats

# Today's Focus Summary

⏱️ Focus time: 4.5 hours
🎯 Goal: 4 hours ✅ Exceeded!
📊 Sessions: 6 completed
⏸️ Breaks: 5 taken
💧 Water: All reminders ✅
👁️ Eyes: All breaks ✅

Health score: 9/10 Excellent!

ADHD-Optimized Features

Flexible Timers

• Not rigid 25 min
• Adapts to your task
• Flow-aware breaks
• Gentle suggestions

Dismissable Reminders

• Can extend session
• Won't break flow state
• But escalates if ignored
• Health first

Context Preservation

• Auto-saves before break
• Easy resume after
• No lost progress
• No anxiety

Visual Time

Status bar: ⏱️ 23:45 | 🧠 Session 1/4 | 💧 Water soon

Health Benefits

Before (no break system):

• 4+ hour sessions
• Eye strain
• Back pain
• Exhaustion
• Burnout

After (automated breaks):

• Regular breaks (5-15 min)
• Eye health protected
• Movement maintained
• Sustained energy
• Prevented burnout

Tips

Trust the Breaks

Breaks feel like wasted time but they:

• ✅ Increase focus quality
• ✅ Prevent mistakes
• ✅ Improve creativity
• ✅ Sustain energy
• ✅ Protect health

Math: 10-min break = 30 min better focus

Use Break Time Well

Good breaks:

• Walk outside (best)
• Stretch/move
• Get water/snack
• Look at distance (eyes)
• Social interaction

Bad breaks:

• More screen time
• Social media scrolling
• Work-related reading

Ignore the Break Guilt

ADHD brains often feel:

• "I should keep working"
• "This is momentum loss"
• "Breaks are for weak people"

Truth: Breaks make you MORE productive, not less.

Success Metrics

You're using this well when:

• ✅ Taking breaks regularly (not skipping)
• ✅ End-of-day energy higher
• ✅ Health checks completed
• ✅ No hyperfocus burnout
• ✅ Sustainable pace maintained

Common Questions

Q: Can I extend sessions past 45 min? A: Yes! System is flexible. But after 90 min, health checks required.

Q: What if I'm in flow state? A: System detects flow and suggests breaks at natural stopping points.

Q: Can I skip breaks? A: Can dismiss 2x, then system escalates to protect health.

Q: What if I forget to start timer? A: Auto-starts when you begin coding. No manual start needed.

Related Skills

• context-preserver - Auto-saves before breaks
• task-breakdown-specialist - Plans work for sessions
• completion-coach - Helps finish sessions

Version History

• 1.0.0 (2025-10-22): Initial release with full automation

License

Part of ai-dev-standards repository.