itsAalaa7 / adhd-study-coach

# 🧠 ADHD Study Coach
**An AI study coach for people with ADHD. Works for any subject, in ChatGPT, Gemini, Claude and more.**
> It quizzes you on old stuff, teaches new stuff in tiny pieces, and makes you explain it back. You never have to remember to ask for review.
---
## ⚡ Start here (no tech skills needed)
**1. Copy the coach.** Go to the **website** and press the big **Copy** button. (No button? Open this page, press `Ctrl+A` then `Ctrl+C`; Mac: `Cmd+A`, `Cmd+C`.)
**2. Paste it into a new chat** in the AI you already use (ChatGPT, Gemini, Claude, Copilot, anything) and press send.
**3. Type `new`,** then tell it what you want to learn. Example: `let's study photosynthesis`.
That's it. It asks 3 quick questions the first time, then you're studying.
### 💾 Coming back the next day
Chats forget. So at the end of each session the coach gives you a small block of text called a **Progress Card**.
- **Save it** anywhere (Notes app, a document, email to yourself).
- **Paste it** at the start of your next chat, after the coach.
That's how it knows what to quiz you on.
> Want it set up permanently? See setup for each app: ChatGPT, Gemini, Claude, OpenCode, Command Code, OpenRouter.
---
## 🛠️ For Claude Code users
Progress saves **automatically**, so no Progress Card is needed.
 [code] 
Then say `let's study X`, `quiz me`, `I'm done for today`, or `how am I doing lately`.
**Claude app (claude.ai / Desktop) skill:** download `adhd-study-coach-skill.zip`, then Settings → Capabilities → Skills → Upload skill.
---
## 🎯 The big idea (read this one)
Two facts, one plan:
| Fact | Source |
|---|---|
| **What works** for learning is already well known: test yourself, and space it out. | Strong general-population science |
| **What's hard for ADHD brains** is *keeping on doing it*: starting, tracking time, waiting for payoff, feeling shame. | ADHD research |
**So this plugin doesn't invent a new "ADHD study method."**
It takes the proven method and **removes the ADHD-specific barriers** to doing it.
---
## 🔁 What happens in a session
The agent picks the mode itself. You don't choose.
| # | Mode | When | What it does |
|---|---|---|---|
| 0 | **Onboarding** | First time only | 3 questions, then straight into studying |
| 1 | **Warm-up** | Something is due for review | Quizzes you on old topics *before* new ones |
| 2 | **Teach** | You want something new | Small chunks, one question at a time |
| 3 | **Reflect** | You say "I'm done" | Interviews you, saves a note (+ optional Anki cards) |
| 4 | **Check-in** | Every ~5 sessions | Finds your patterns, tells you what to adopt / drop / do next |
---
## 🔬 The science, one feature at a time
Every rule in the agent has a reason. Here's the short version.
**Full citations and honest strength ratings → `RESEARCH.md`.**
### ✅ Strong evidence — the core
| Feature | The science | What you'll notice |
|---|---|---|
| **Quizzes, not re-reading** | *Retrieval practice.* Testing yourself beats re-studying (Roediger & Karpicke 2006;