task-manager/plan.md

ADHS/ADS-Friendly Task Manager Enhancement Plan

Ziel: Diese Anwendung zu einem führenden ADHS/ADS-freundlichen Task Manager machen, der die einzigartigen Herausforderungen neurodivergenter Menschen adressiert.

---

Inhaltsverzeichnis

1. Executive Summary
2. Verständnis von ADHS/ADS
3. Analyse bestehender Features
4. Feature-Roadmap
5. Detaillierte Implementierungspläne
6. Technische Architektur
7. UX/UI Design-Richtlinien
8. Prioritäten und Phasen
9. Quellen und Referenzen

---

Executive Summary

Menschen mit ADHS (Aufmerksamkeitsdefizit-Hyperaktivitätsstörung) und ADS (Aufmerksamkeitsdefizit-Störung) stehen vor einzigartigen Herausforderungen bei der Aufgabenverwaltung. Diese umfassen:

• Zeitblindheit: Schwierigkeiten bei der Wahrnehmung von Zeitabläufen
• Exekutive Dysfunktion: Probleme beim Planen, Priorisieren und Starten von Aufgaben
• Dopamin-Defizit: Geringere Motivation für Aufgaben ohne sofortige Belohnung
• Hyperfokus: Unkontrolliertes Vertiefen in interessante Aufgaben unter Vernachlässigung anderer Pflichten
• Task-Paralyse: Lähmung durch Überforderung oder zu viele Optionen
• Working-Memory-Defizite: Schwierigkeiten, Informationen im Kurzzeitgedächtnis zu halten

Diese Analyse zeigt, dass der bestehende Task-Manager bereits ein solides Fundament mit Gamification, Timer, AI-Integration und Routinen bietet. Mit gezielten Erweiterungen kann er zu einem Best-in-Class ADHS-Tool entwickelt werden.

---

Verständnis von ADHS/ADS

Kernherausforderungen

1. Zeitblindheit (Time Blindness)

"ADHD is fundamentally a disorder of time management" — Dr. Russell Barkley

Menschen mit ADHS haben oft eine verzerrte Zeitwahrnehmung:

• Schwierigkeiten, die Dauer von Aufgaben einzuschätzen
• "Jetzt" ist der einzige wahrgenommene Zeitpunkt
• Schwierigkeiten bei der Planung zukünftiger Aktivitäten

Lösung: Visuelle Timer, Zeitblöcke, Echtzeit-Feedback

2. Exekutive Dysfunktion & Task-Paralyse

"Task paralysis often occurs involuntarily—unlike procrastination, which is usually a choice."

Betroffene erleben:

• Überwältigung bei großen oder komplexen Aufgaben
• Entscheidungslähmung bei zu vielen Optionen (Hick's Law)
• Schwierigkeiten beim Starten von Aufgaben

Lösung: Task-Breakdown, 5-Minuten-Regel, klare Priorisierung, reduzierte Optionen

3. Dopamin & Motivation

"Studies suggest people with ADHD have lower levels of dopamine, making it challenging to stay motivated for tasks without immediate rewards."

Das ADHS-Gehirn:

• Hat geringere Dopamin-Produktion und -Rezeptoren
• Braucht externe Motivation und Belohnungen
• Reagiert stark auf sofortiges Feedback

Lösung: Gamification, Mikro-Belohnungen, Progress-Visualisierung, Streaks

4. Hyperfokus-Management

"Hyperfocus is a double-edged sword—it can unlock deep creativity but also lead to burnout and neglected responsibilities."

Risiken bei unkontrolliertem Hyperfokus:

• Überspringen von Mahlzeiten und Pausen
• Vernachlässigung anderer Aufgaben
• Burnout und Erschöpfung

Lösung: Break-Reminders, Zeitlimits, sanfte Unterbrechungen

5. Kognitive Überlastung

"Excess visual clutter can lead to cognitive overload."

ADHS-Gehirne sind besonders anfällig für:

• Visuelle Ablenkungen
• Zu viele Optionen gleichzeitig
• Komplexe Interfaces

Lösung: Clean UI, Progressive Disclosure, Focus Mode

---

Analyse bestehender Features

Stärken des aktuellen Systems

Feature	ADHS-Relevanz	Status
Gamification (XP/Level)	⭐⭐⭐⭐⭐ Dopamin-Boost	✅ Vorhanden
Streak-Tracking	⭐⭐⭐⭐⭐ Konsistenz-Motivation	✅ Vorhanden
Pomodoro Timer	⭐⭐⭐⭐⭐ Zeitstruktur	✅ Vorhanden
Focus Mode	⭐⭐⭐⭐ Ablenkungsreduktion	✅ Vorhanden
Morning/Evening Routines	⭐⭐⭐⭐ Struktur	✅ Vorhanden
AI Task Assistant	⭐⭐⭐⭐ Task-Breakdown möglich	✅ Vorhanden
Achievements	⭐⭐⭐⭐ Positive Verstärkung	✅ Vorhanden
Time Tracking	⭐⭐⭐⭐ Zeitbewusstsein	✅ Vorhanden
Notifications	⭐⭐⭐ Erinnerungen	✅ Vorhanden
Dark Mode	⭐⭐⭐ Reduzierte Stimulation	✅ Vorhanden
Subtasks	⭐⭐⭐ Task-Breakdown	✅ Vorhanden
Recurring Tasks	⭐⭐⭐ Routine-Aufbau	✅ Vorhanden
Energy Level	⭐⭐⭐ Selbstwahrnehmung	✅ Vorhanden
Estimated Duration	⭐⭐⭐ Zeitplanung	✅ Vorhanden
German Language	⭐⭐⭐ Lokalisierung	✅ Vorhanden

Verbesserungspotenzial

Feature	ADHS-Relevanz	Status
Visueller Timer	⭐⭐⭐⭐⭐ Time Blindness	❌ Fehlt
AI Task-Breakdown	⭐⭐⭐⭐⭐ Executive Function	🔄 Erweiterbar
ADHS-Modus	⭐⭐⭐⭐⭐ Ganzheitliche Lösung	❌ Fehlt
Break Reminders	⭐⭐⭐⭐⭐ Hyperfokus-Schutz	❌ Fehlt
Dopamin-Menu	⭐⭐⭐⭐⭐ Sofortige Belohnungen	❌ Fehlt
Body Doubling	⭐⭐⭐⭐ Accountability	❌ Fehlt
Task Starter	⭐⭐⭐⭐ 5-Minuten-Regel	❌ Fehlt
Prioritätsfilter	⭐⭐⭐⭐ Fokus-Hilfe	🔄 Erweiterbar
Positive Affirmationen	⭐⭐⭐⭐ Selbstwert	❌ Fehlt
Visuelle Zeitleiste	⭐⭐⭐⭐ Tagesübersicht	🔄 Erweiterbar
Smart Single-Task View	⭐⭐⭐⭐ Reduzierte Überforderung	❌ Fehlt
Ambient Sounds	⭐⭐⭐ Fokus-Unterstützung	🔄 Vorhanden (erweitern)

---

Feature-Roadmap

Phase 1: Kern-ADHS-Features (Priorität: Hoch)

1. ADHS-Modus (Global Toggle)
2. Visueller Timer mit Zeitanzeige
3. AI-gestützter Task-Breakdown
4. Break-Reminder-System
5. "Quick Win" Dopamin-Menu
6. Single-Task Focus View

Phase 2: Erweiterte Unterstützung (Priorität: Mittel)

7. Body Doubling Integration
8. 5-Minuten Task Starter
9. Positive Affirmationen & Encouragement
10. Verbesserte Gamification
11. Hyperfokus-Schutz
12. Energy-Based Scheduling

Phase 3: Personalisierung & Feintuning (Priorität: Normal)

13. Personalisierte ADHS-Profile
14. Detaillierte Analytics für ADHS
15. Community & Social Features
16. Erweiterte AI-Coaching
17. Accessibility-Verbesserungen

---

Detaillierte Implementierungspläne

1. ADHS-Modus (Global Toggle)

Konzept: Ein zentraler Schalter, der die gesamte App für ADHS-Bedürfnisse optimiert.

Änderungen bei Aktivierung:

• Reduzierte UI-Komplexität
• Größere Buttons und Targets
• Weniger Animationen
• Automatische Break-Reminders
• Single-Task-Fokus als Standard
• Vereinfachte Navigation
• Positive Messaging statt Guilt-Triggers

Betroffene Dateien:

/shared/schema.ts
  - users Tabelle: Feld `adhdMode: boolean` hinzufügen
  - users Tabelle: Feld `adhdSettings: jsonb` für granulare Einstellungen

/client/src/components/AppSidebar.tsx
  - ADHS-Modus Toggle im Sidebar-Header
  - Visuelles Indikator wenn aktiv

/client/src/pages/settings.tsx
  - Neue Sektion "ADHS-Einstellungen"
  - Granulare Konfiguration:
    - Reduzierte Animationen
    - Größere Touch-Targets
    - Break-Reminder Intervall
    - Single-Task-Modus Standard
    - Positive Messaging Level

/client/src/App.tsx
  - ADHS-Context Provider
  - CSS-Klasse auf Root für globale Styles

/client/src/index.css
  - ADHS-spezifische CSS-Variablen
  - .adhd-mode Klasse mit angepassten Styles

Neue Komponenten:

/client/src/components/adhd/
  ├── ADHDModeProvider.tsx      # Context für ADHS-Einstellungen
  ├── ADHDModeToggle.tsx        # Toggle-Button
  ├── ADHDSettingsPanel.tsx     # Einstellungs-Panel
  └── useADHDMode.ts            # Custom Hook

API-Änderungen:

PATCH /api/user/adhd-settings
  - Body: { adhdMode: boolean, settings: ADHDSettings }

---

2. Visueller Timer

Konzept: Ein großer, visuell ansprechender Timer, der die verbleibende Zeit als schrumpfenden Kreis oder Balken zeigt.

Features:

• Kreisförmiger Timer (wie Time Timer)
• Farbverlauf von Grün → Gelb → Rot
• Optionale Töne bei Meilensteinen (25%, 50%, 75%)
• Integration mit Pomodoro
• Vollbild-Option
• Ambient Sounds während Timer läuft

Betroffene Dateien:

/client/src/components/PomodoroOverlay.tsx
  - Erweitern um visuellen Timer-Ring
  - Farbverlauf-Animation
  - Milestone-Sounds

/client/src/components/FocusMode.tsx
  - Visuellen Timer einbinden
  - Optionale Vollbild-Ansicht

Neue Komponenten:

/client/src/components/adhd/
  ├── VisualTimer.tsx           # Haupt-Timer-Komponente
  ├── TimerRing.tsx             # SVG-basierter Ring
  ├── TimerProgress.tsx         # Fortschrittsanzeige
  └── TimerSounds.tsx           # Sound-Management

Technische Details:

// VisualTimer.tsx - Kern-Struktur
interface VisualTimerProps {
  duration: number;          // Sekunden
  onComplete: () => void;
  onMilestone?: (percent: number) => void;
  colorScheme?: 'default' | 'calm' | 'energetic';
  showNumbers?: boolean;
  size?: 'small' | 'medium' | 'large' | 'fullscreen';
}

// SVG-basierter Ring mit CSS-Animation
// stroke-dasharray und stroke-dashoffset für Animation
// requestAnimationFrame für smooth Updates

CSS-Variablen:

--timer-start-color: hsl(142, 76%, 36%);   /* Grün */
--timer-mid-color: hsl(45, 93%, 47%);       /* Gelb */
--timer-end-color: hsl(0, 84%, 60%);        /* Rot */
--timer-bg-color: hsl(0, 0%, 90%);

---

3. AI-gestützter Task-Breakdown

Konzept: Automatische Zerlegung überwältigender Aufgaben in kleine, machbare Schritte.

Features:

• "Diese Aufgabe ist zu groß" Button
• AI analysiert und schlägt Unteraufgaben vor
• Zeitschätzungen pro Unteraufgabe
• "Nächster Schritt" Highlight
• Integration mit bestehendem Subtask-System

Betroffene Dateien:

/server/ai.ts
  - Neuer System-Prompt für Task-Breakdown
  - Tool-Definition für Subtask-Erstellung

/server/routes.ts
  - Neuer Endpoint: POST /api/ai/breakdown-task

/client/src/components/TaskCard.tsx
  - "Aufgabe aufteilen" Button
  - Visuelles Indikator für "broken down" Tasks

/client/src/components/TaskDetailsModal.tsx
  - AI-Breakdown Panel
  - Subtask-Vorschau und Bestätigung

Neue Komponenten:

/client/src/components/adhd/
  ├── TaskBreakdownButton.tsx    # Trigger für AI-Breakdown
  ├── TaskBreakdownModal.tsx     # Modal mit Vorschlägen
  ├── BreakdownPreview.tsx       # Vorschau der Unteraufgaben
  └── QuickSubtask.tsx           # Schnelle Subtask-Erstellung

AI-Prompt Template:

Du bist ein ADHS-Coach. Der Nutzer hat eine überwältigende Aufgabe:

Aufgabe: "{taskTitle}"
Beschreibung: "{taskDescription}"
Geschätzte Dauer: {estimatedDuration} Minuten

Zerlege diese Aufgabe in 3-7 kleine, konkrete Schritte.
Jeder Schritt sollte:
- In 5-15 Minuten erledigt werden können
- Eine klare, aktionsorientierte Beschreibung haben
- Einen konkreten Endpunkt haben

Format:
1. [Schritt] - [Geschätzte Zeit in Minuten]
2. ...

API-Response:

interface BreakdownResponse {
  subtasks: {
    title: string;
    estimatedMinutes: number;
    order: number;
  }[];
  totalEstimatedMinutes: number;
  encouragement: string;  // Positive Nachricht
}

---

4. Break-Reminder-System

Konzept: Sanfte, aber effektive Erinnerungen für Pausen, um Hyperfokus zu unterbrechen.

Features:

• Konfigurierbares Intervall (Standard: 45 Minuten)
• Sanfte visuelle Überlagerung (kein abruptes Popup)
• Vorschläge für Pause (Dehnen, Wasser, Snack)
• "Noch 5 Minuten" Option
• Automatische Pause-Protokollierung
• Integration mit Pomodoro

Betroffene Dateien:

/shared/schema.ts
  - users: breakReminderInterval, breakReminderEnabled

/client/src/hooks/
  - Neuer Hook: useBreakReminder.ts

/client/src/components/FocusMode.tsx
  - Break-Reminder Integration

/client/src/App.tsx
  - Global Break-Reminder Provider

Neue Komponenten:

/client/src/components/adhd/
  ├── BreakReminderProvider.tsx  # Context und Timer-Logik
  ├── BreakReminderOverlay.tsx   # Sanfte Überlagerung
  ├── BreakSuggestions.tsx       # Pausen-Vorschläge
  └── BreakHistory.tsx           # Pausen-Protokoll

Break-Suggestions Array:

const breakSuggestions = [
  { id: 'stretch', icon: '🧘', de: 'Kurz dehnen', duration: 2 },
  { id: 'water', icon: '💧', de: 'Wasser trinken', duration: 1 },
  { id: 'walk', icon: '🚶', de: 'Kurzer Spaziergang', duration: 5 },
  { id: 'eyes', icon: '👀', de: '20-20-20 Augenübung', duration: 1 },
  { id: 'snack', icon: '🍎', de: 'Gesunder Snack', duration: 3 },
  { id: 'breathe', icon: '🌬️', de: 'Tiefes Atmen', duration: 2 },
];

Overlay-Design:

- Nicht modal (kein blockierendes Overlay)
- Sanfte Animation von der Seite
- Countdown bevor es verschwindet
- Dismiss durch Klick irgendwo
- "Snooze 5 Min" Button
- Farbverlauf-Hintergrund (beruhigend)

---

5. "Quick Win" Dopamin-Menu

Konzept: Eine Liste schneller, einfacher Aufgaben für sofortige Erfolgserlebnisse.

Features:

• Filtert Aufgaben < 10 Minuten
• Sortiert nach "Schnell erledigt" Score
• Sofortiger XP-Boost sichtbar
• Celebration bei Erledigung
• "Keine Lust auf nichts?" Modus

Betroffene Dateien:

/client/src/components/AppSidebar.tsx
  - "Quick Win" Button/Link

/client/src/pages/
  - Neue Seite: QuickWinsPage.tsx

/server/routes.ts
  - Neuer Endpoint: GET /api/tasks/quick-wins

Neue Komponenten:

/client/src/components/adhd/
  ├── QuickWinButton.tsx         # Sidebar-Button mit Sparkle
  ├── QuickWinList.tsx           # Liste der Quick Wins
  ├── QuickWinCard.tsx           # Einzelne Quick Win Karte
  └── CelebrationOverlay.tsx     # Erfolgs-Animation

Quick Win Score Berechnung:

function calculateQuickWinScore(task: Task): number {
  let score = 100;

  // Kürzere Aufgaben = höherer Score
  if (task.estimatedDuration) {
    score += (15 - task.estimatedDuration) * 5;
  }

  // Niedrigere Priorität = schneller erledigt
  if (task.priority === 'low') score += 20;

  // Heute fällig = Bonus
  if (isToday(task.dueDate)) score += 30;

  // Bereits gestartet = Bonus
  if (task.status === 'inProgress') score += 40;

  // Hat Subtasks erledigt = Bonus
  // ...

  return score;
}

UI-Design:

- Karten-Layout mit großen Touch-Targets
- Sichtbare XP-Belohnung vor Erledigung
- Confetti bei Erledigung
- Streak-Counter für Quick Wins
- "Nächster Quick Win" Vorschlag

---

6. Single-Task Focus View

Konzept: Eine Ansicht, die nur EINE Aufgabe zeigt, um Überforderung zu vermeiden.

Features:

• Zeigt nur die aktuell fokussierte Aufgabe
• Große, klare Typografie
• Timer-Integration
• "Nächste Aufgabe" Button
• Kein Scrollen, keine Liste
• Optional: Ambient Background

Betroffene Dateien:

/client/src/components/FocusMode.tsx
  - Erweitern um Single-Task-View

/client/src/App.tsx
  - Route für Single-Task-View

Neue Komponenten:

/client/src/components/adhd/
  ├── SingleTaskView.tsx         # Haupt-Komponente
  ├── SingleTaskCard.tsx         # Große Task-Karte
  ├── TaskNavigator.tsx          # Prev/Next Navigation
  └── AmbientBackground.tsx      # Optional: Animierter Hintergrund

Layout:

┌─────────────────────────────────────────┐
│                                         │
│           [Visueller Timer]             │
│                                         │
│  ┌───────────────────────────────────┐  │
│  │                                   │  │
│  │         AUFGABE TITEL             │  │
│  │         (große Schrift)           │  │
│  │                                   │  │
│  │    Beschreibung hier...           │  │
│  │                                   │  │
│  │    [✓ Erledigt]  [→ Überspringen] │  │
│  │                                   │  │
│  └───────────────────────────────────┘  │
│                                         │
│     ○ ● ○ ○ ○  (Task-Indikator)        │
│                                         │
└─────────────────────────────────────────┘

---

7. Body Doubling Integration

Konzept: Virtuelle Arbeitspartner für Accountability.

Features:

• "Work With Me" Sessions
• Timer-synchronisierte Sessions
• Anonyme oder Named Sessions
• Session-Typen (Focus, Brainstorm, Admin)
• Integration mit externen Services (Focusmate API)

Betroffene Dateien:

/shared/schema.ts
  - Neue Tabellen: bodydoublingSessions, sessionParticipants

/server/routes.ts
  - CRUD für Sessions
  - WebSocket für Echtzeit-Updates

/client/src/pages/
  - Neue Seite: BodyDoublingPage.tsx

Neue Komponenten:

/client/src/components/adhd/
  ├── BodyDoublingLobby.tsx      # Session-Übersicht
  ├── SessionCard.tsx            # Einzelne Session
  ├── ActiveSession.tsx          # Laufende Session
  ├── SessionTimer.tsx           # Geteilter Timer
  └── ParticipantList.tsx        # Teilnehmer

Optionale externe Integration:

// Integration mit Focusmate oder ähnlichen Services
interface ExternalBodyDouble {
  provider: 'focusmate' | 'flow-club' | 'custom';
  apiKey: string;
  syncEnabled: boolean;
}

---

8. 5-Minuten Task Starter

Konzept: Die "5-Minuten-Regel" als Feature - nur 5 Minuten an einer Aufgabe arbeiten.

Features:

• "Nur 5 Minuten" Button bei jeder Aufgabe
• Automatischer 5-Minuten Timer
• Nach 5 Minuten: "Weitermachen?" oder "Pause"
• Keine Verpflichtung weiterzumachen
• XP auch für 5 Minuten

Betroffene Dateien:

/client/src/components/TaskCard.tsx
  - "5 Min starten" Button

/client/src/components/TaskDetailsModal.tsx
  - Integration des 5-Min Starters

Neue Komponenten:

/client/src/components/adhd/
  ├── FiveMinuteStarter.tsx      # Start-Button
  ├── FiveMinuteTimer.tsx        # 5-Min Timer
  └── FiveMinuteComplete.tsx     # End-Dialog

Flow:

1. User klickt "5 Min starten"
2. Timer startet, Task wird "inProgress"
3. Visueller 5-Min Countdown
4. Nach 5 Min: Sanfter Gong
5. Dialog: "Super! Weitermachen?"
   - [Ja, weiter] → Timer läuft weiter
   - [Pause machen] → Task bleibt inProgress
   - [Fertig!] → Task wird "done"
6. XP wird gutgeschrieben (minimum 10 XP)

---

9. Positive Affirmationen & Encouragement

Konzept: Ersetzen von Guilt-Triggern durch positive, ermutigende Nachrichten.

Features:

• Positive Nachrichten bei Task-Completion
• Ermutigungen bei langen Pausen
• Keine "Du hast X Tage nicht..." Nachrichten
• Personalisierbare Affirmationen
• Integration mit Notifications

Betroffene Dateien:

/client/src/i18n/locales/de.json
  - Neue Sektion: "encouragements"

/client/src/i18n/locales/en.json
  - Neue Sektion: "encouragements"

/client/src/hooks/use-notifications.ts
  - Positive Messaging Integration

/client/src/components/TaskCard.tsx
  - Ermutigungen bei Completion

Neue Komponenten:

/client/src/components/adhd/
  ├── EncouragementToast.tsx     # Positive Toast-Nachricht
  ├── DailyAffirmation.tsx       # Tägliche Affirmation
  └── ProgressCelebration.tsx    # Feier bei Meilensteinen

Encouragement-Beispiele (Deutsch):

const encouragements = {
  taskComplete: [
    "Großartig! Jeder Schritt zählt. 🌟",
    "Du machst das super! Weiter so!",
    "Ein Task weniger - du rockst das!",
    "Siehst du? Du kannst das! 💪",
  ],
  returning: [
    "Schön, dass du wieder da bist!",
    "Jeder Neustart ist ein Gewinn.",
    "Willkommen zurück! Lass uns loslegen.",
  ],
  struggling: [
    "Es ist okay, kleine Schritte zu machen.",
    "Du musst nicht alles auf einmal schaffen.",
    "Atme tief durch. Du schaffst das.",
  ],
  streakBroken: [
    "Streaks sind nur Zahlen. Du bist mehr als das.",
    "Morgen ist ein neuer Tag!",
    "Jeder Tag ist eine neue Chance.",
  ],
};

---

10. Verbesserte Gamification

Konzept: Erweiterung des bestehenden XP-Systems für ADHS-Bedürfnisse.

Neue Features:

• Mikro-XP für kleine Aktionen (Task öffnen: 1 XP, Timer starten: 2 XP)
• Tägliche Herausforderungen (nicht bestrafend)
• "Power-Ups" für schwierige Tage
• Visuelle XP-Animation bei jeder Aktion
• "Boss-Fights" für große Projekte

Betroffene Dateien:

/shared/schema.ts
  - Erweiterte xpEvents Typen
  - dailyChallenges Tabelle

/server/gamification.ts
  - Mikro-XP Logik
  - Daily Challenge Generator

/client/src/components/GamificationBar.tsx
  - Erweiterte Animationen
  - Mikro-XP Popups

Neue XP-Events:

const microXpEvents = {
  OPEN_TASK: 1,
  START_TIMER: 2,
  ADD_NOTE: 3,
  COMPLETE_SUBTASK: 15,
  USE_AI_BREAKDOWN: 5,
  TAKE_BREAK: 10,
  RETURN_AFTER_BREAK: 5,
  FIVE_MINUTE_START: 10,
  COMPLETE_QUICK_WIN: 30,
};

---

11. Hyperfokus-Schutz

Konzept: Aktiver Schutz vor den negativen Auswirkungen von Hyperfokus.

Features:

• Zeitlimit pro Task (konfigurierbar)
• Automatische Warnungen bei Überschreitung
• "Andere Tasks warten" Reminder
• Meal-Time Reminders
• Bewegungs-Reminders

Betroffene Dateien:

/shared/schema.ts
  - users: hyperfocusProtection settings

/client/src/hooks/useTimer.ts
  - Hyperfokus-Tracking Integration

Neue Komponenten:

/client/src/components/adhd/
  ├── HyperfocusGuard.tsx        # Monitoring-Komponente
  ├── HyperfocusWarning.tsx      # Warnungs-Overlay
  └── HyperfocusSettings.tsx     # Einstellungen

---

12. Energy-Based Scheduling

Konzept: Aufgaben basierend auf dem Energielevel des Users planen.

Features:

• Tägliche Energie-Check-ins
• Task-Empfehlungen basierend auf Energie
• "Niedrige Energie" Aufgaben-Pool
• Automatische Neupriorisierung
• Integration mit bestehenden Energy Levels

Betroffene Dateien:

/shared/schema.ts
  - energyLogs Tabelle für Check-ins

/server/routes.ts
  - Energy-based Task Suggestions Endpoint

/client/src/components/
  - EnergyCheckIn.tsx bei Login/Morgen

Neue Komponenten:

/client/src/components/adhd/
  ├── EnergyCheckIn.tsx          # Energie-Abfrage
  ├── EnergyBasedSuggestions.tsx # Task-Vorschläge
  └── EnergyHistory.tsx          # Energie-Verlauf

Energy-Task Matching:

interface EnergyTaskMatch {
  energyLevel: 'low' | 'medium' | 'high';
  recommendedTaskTypes: string[];
  avoidTaskTypes: string[];
}

const energyMatching: EnergyTaskMatch[] = [
  {
    energyLevel: 'low',
    recommendedTaskTypes: ['admin', 'organizing', 'review'],
    avoidTaskTypes: ['creative', 'complex', 'social'],
  },
  {
    energyLevel: 'medium',
    recommendedTaskTypes: ['routine', 'communication', 'planning'],
    avoidTaskTypes: ['complex', 'high-stakes'],
  },
  {
    energyLevel: 'high',
    recommendedTaskTypes: ['creative', 'complex', 'challenging'],
    avoidTaskTypes: [],
  },
];

---

Technische Architektur

Neue Datenbankfelder

-- users Tabelle Erweiterungen
ALTER TABLE users ADD COLUMN adhd_mode BOOLEAN DEFAULT false;
ALTER TABLE users ADD COLUMN adhd_settings JSONB DEFAULT '{}';
ALTER TABLE users ADD COLUMN break_reminder_interval INTEGER DEFAULT 45;
ALTER TABLE users ADD COLUMN break_reminder_enabled BOOLEAN DEFAULT true;
ALTER TABLE users ADD COLUMN hyperfocus_protection JSONB DEFAULT '{}';

-- Neue Tabellen
CREATE TABLE energy_logs (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  energy_level VARCHAR(10) NOT NULL,
  logged_at TIMESTAMP DEFAULT NOW(),
  notes TEXT
);

CREATE TABLE body_doubling_sessions (
  id SERIAL PRIMARY KEY,
  host_id INTEGER REFERENCES users(id),
  title VARCHAR(255),
  session_type VARCHAR(50),
  starts_at TIMESTAMP,
  duration_minutes INTEGER,
  max_participants INTEGER DEFAULT 5,
  is_public BOOLEAN DEFAULT true,
  created_at TIMESTAMP DEFAULT NOW()
);

CREATE TABLE session_participants (
  session_id INTEGER REFERENCES body_doubling_sessions(id),
  user_id INTEGER REFERENCES users(id),
  joined_at TIMESTAMP DEFAULT NOW(),
  PRIMARY KEY (session_id, user_id)
);

CREATE TABLE daily_challenges (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  challenge_type VARCHAR(50),
  target INTEGER,
  progress INTEGER DEFAULT 0,
  xp_reward INTEGER,
  date DATE,
  completed_at TIMESTAMP
);

Neue API Endpoints

ADHD Mode:
  PATCH /api/user/adhd-settings

Break Reminders:
  GET  /api/user/break-stats
  POST /api/user/log-break

Quick Wins:
  GET  /api/tasks/quick-wins

Task Breakdown:
  POST /api/ai/breakdown-task

Body Doubling:
  GET  /api/sessions
  POST /api/sessions
  POST /api/sessions/:id/join
  POST /api/sessions/:id/leave

Energy:
  POST /api/energy/log
  GET  /api/energy/history
  GET  /api/tasks/energy-based

Daily Challenges:
  GET  /api/challenges/today
  POST /api/challenges/:id/progress

Neue React Context Provider

// ADHDModeContext
interface ADHDModeContextType {
  isEnabled: boolean;
  settings: ADHDSettings;
  toggle: () => void;
  updateSettings: (settings: Partial<ADHDSettings>) => void;
}

// BreakReminderContext
interface BreakReminderContextType {
  isActive: boolean;
  minutesSinceBreak: number;
  logBreak: () => void;
  snooze: (minutes: number) => void;
}

Ordnerstruktur für ADHD-Features

/client/src/components/adhd/
  ├── index.ts                   # Exports
  ├── providers/
  │   ├── ADHDModeProvider.tsx
  │   └── BreakReminderProvider.tsx
  ├── timer/
  │   ├── VisualTimer.tsx
  │   ├── TimerRing.tsx
  │   └── FiveMinuteStarter.tsx
  ├── focus/
  │   ├── SingleTaskView.tsx
  │   ├── HyperfocusGuard.tsx
  │   └── QuickWinList.tsx
  ├── ai/
  │   ├── TaskBreakdownModal.tsx
  │   └── BreakdownPreview.tsx
  ├── social/
  │   ├── BodyDoublingLobby.tsx
  │   └── SessionCard.tsx
  ├── feedback/
  │   ├── EncouragementToast.tsx
  │   ├── CelebrationOverlay.tsx
  │   └── ProgressCelebration.tsx
  └── settings/
      ├── ADHDSettingsPanel.tsx
      └── EnergyCheckIn.tsx

---

UX/UI Design-Richtlinien

Allgemeine Prinzipien für ADHS-freundliches Design

1. Reduzierte kognitive Last

   • Maximal 3-5 Optionen pro Ansicht
   • Progressive Disclosure für komplexe Features
   • Klare visuelle Hierarchie

2. Große Touch-Targets

   • Minimum 44x44px für alle interaktiven Elemente
   • Großzügiger Abstand zwischen Buttons

3. Visuelles Feedback

   • Sofortiges Feedback bei jeder Aktion
   • Animationen für Statusänderungen
   • Farbkodierung für Prioritäten

4. Beruhigende Ästhetik

   • Weniger gesättigte Farben im ADHS-Modus
   • Reduzierte Animationen Option
   • Mehr Whitespace

5. Positive Sprache

   • Keine Schuldzuweisungen
   • Ermutigende Formulierungen
   • Feier von Fortschritten

Farbschema für ADHS-Modus

:root.adhd-mode {
  /* Beruhigtere Primärfarben */
  --primary: 220 80% 55%;
  --primary-foreground: 0 0% 100%;

  /* Weniger intensive Akzentfarben */
  --accent: 190 60% 50%;

  /* Wärmerer Hintergrund */
  --background: 40 10% 97%;

  /* Größere Radii für weichere Erscheinung */
  --radius: 12px;

  /* Reduzierte Schatten */
  --shadow: 0 2px 8px rgba(0,0,0,0.05);
}

Typografie-Anpassungen

.adhd-mode {
  /* Größere Basisschrift */
  font-size: 17px;

  /* Mehr Zeilenabstand */
  line-height: 1.7;

  /* Task-Titel noch größer */
  .task-title {
    font-size: 1.3rem;
    font-weight: 600;
  }
}

Animation-Richtlinien

.adhd-mode {
  /* Längere, sanftere Übergänge */
  --transition-duration: 300ms;
  --transition-timing: ease-out;

  /* Reduzierte Bewegung Option */
  &.reduced-motion {
    * {
      animation: none !important;
      transition: none !important;
    }
  }
}

---

Prioritäten und Phasen

Phase 1: Fundament (Wochen 1-4)

Feature	Aufwand	Impact	Priorität
ADHS-Modus Toggle	Mittel	Hoch	🔴 Kritisch
Visueller Timer	Mittel	Hoch	🔴 Kritisch
Break Reminders	Niedrig	Hoch	🔴 Kritisch
AI Task-Breakdown	Mittel	Hoch	🔴 Kritisch
Positive Messaging	Niedrig	Mittel	🟡 Wichtig

Deliverables Phase 1:

• Funktionierender ADHS-Modus
• Visueller Timer in Focus Mode
• Automatische Break-Reminders
• AI-gestütztes Task-Breakdown
• Deutsche Lokalisierung aller neuen Features

Phase 2: Erweiterung (Wochen 5-8)

Feature	Aufwand	Impact	Priorität
Quick Win Menu	Mittel	Hoch	🟡 Wichtig
Single-Task View	Mittel	Hoch	🟡 Wichtig
5-Minuten Starter	Niedrig	Mittel	🟡 Wichtig
Erweiterte Gamification	Mittel	Mittel	🟡 Wichtig
Energy Check-ins	Niedrig	Mittel	🟢 Nice-to-have

Deliverables Phase 2:

• Quick Wins Seite
• Single-Task Focus View
• 5-Minuten Regel Integration
• Mikro-XP System
• Energy-based Suggestions

Phase 3: Social & Personalisierung (Wochen 9-12)

Feature	Aufwand	Impact	Priorität
Body Doubling	Hoch	Mittel	🟢 Nice-to-have
Hyperfokus-Schutz	Mittel	Mittel	🟢 Nice-to-have
ADHS-Profile	Mittel	Mittel	🟢 Nice-to-have
Detaillierte Analytics	Mittel	Niedrig	🟢 Nice-to-have
Community Features	Hoch	Niedrig	🟢 Nice-to-have

Deliverables Phase 3:

• Body Doubling Sessions
• Hyperfokus-Warnungen
• Personalisierte ADHS-Profile
• ADHS-spezifische Analytics
• Optional: Community Features

---

Quellen und Referenzen

ADHS Task Management & Apps

• Fluidwave: 12 Best Task Management Apps for ADHD
• Tiimo: Visual Planner for ADHD
• Zapier: 5 To-Do List Apps That Work With ADHD
• Lunatask: Best ADHD Planner
• FocusLane: Die ADHS App
• ZDF: Produktivität mit ADHS/ADS

Zeitblindheit & Visuelle Timer

• Time Timer: Visual Timer for ADHD
• Simply Psychology: ADHD & Time Blindness
• Visual Timer Tools for ADHD
• Fhynix: Best ADHD Time Management Tools

Task-Paralyse & Executive Function

• ADD.org: ADHD Paralysis - 8 Ways to Overcome It
• Tiimo: ADHD Paralysis - How to Get Unstuck
• Choosing Therapy: 10 Tips for ADHD Paralysis
• NeuroSpark Health: Task Paralysis in Adults

Body Doubling & Hyperfokus

• Medical News Today: Body Doubling for ADHD
• Cleveland Clinic: How Body Doubling Helps
• Flow Club: Body Doubling
• AuDHD Psychiatry: Breaking the Hyperfocus Cycle

UI/UX Design für ADHS

• Intuit Design Hub: ADHD and Design
• AufaitUX: Neurodiversity in UX
• Din Studio: UI/UX for ADHD
• UXPA: Designing for ADHD in UX

Gamification & Dopamin

• Imaginovation: Gamification in ADHD Apps
• Moore Momentum: The ADHD Reward System
• ADHD Centre: Gamification for Focus
• MagicTask: Gamified Task Management for ADHD

---

Nächste Schritte

1. Review dieses Plans mit Stakeholdern
2. Priorisierung der Features basierend auf User-Feedback
3. Technisches Design für Phase 1 Features
4. Prototyping der ADHS-Mode UI
5. User Testing mit ADHS-Betroffenen
6. Iterative Entwicklung beginnend mit Phase 1

---

Dokument erstellt: Januar 2026 Letzte Aktualisierung: Januar 2026 Version: 1.0