A learning session¶
A session is one focused conversation with the AI through the seven-step learning cycle. Sessions are short — 15-45 minutes is typical. The Dashboard's "Start session" button creates a new one; the app picks the learning method (your dominant from the assessment) and the cycle's starting step (usually 1 = Input).
The seven steps¶
| # | Step | What happens |
|---|---|---|
| 1 | Input | The AI presents new material in the active method's style |
| 2 | Attempt | You apply what you just learned — the AI poses a task |
| 3 | Error | A mistake shows up; the AI marks it precisely |
| 4 | Feedback | The AI explains the correction in depth |
| 5 | Adapt | You adjust your approach; the AI may re-frame |
| 6 | Repeat | A fresh task that exercises the same concept |
| 7 | Integrate | The AI connects today's material to broader context |
The cycle is a framework, not a conveyor belt. Steps can repeat, skip forward, or even step backward when your last turn shows confusion. The AI judges per round-trip and the app's progress bar updates accordingly.
How the AI guides you¶
Every message you send triggers two AI calls in sequence:
- The learning reply — the AI answers in the active method's style, at the current cycle step. The system prompt is composed from a 42-cell matrix (6 methods × 7 steps), so a deductive Input feels very different from a contextual Repeat.
- The step evaluator — a second AI call reads the
exchange and decides whether you're ready to advance. It
emits a verdict:
advance,confidence,reason,suggested_step. The app applies the suggestion only if the confidence is high enough (default threshold 0.6).
The verdict is shown discreetly above the chat as a "Step moved from X to Y because…" notification when it actually applies.
Cycle-progress indicator¶
Across the top of the Session page sits a 7-circle progress strip. The current step is filled in your project's accent color; passed steps are filled more faintly; future steps are empty. When the evaluator moves you forward (or backward!), the strip animates to make the transition visible.
On mobile (≤768px) the strip becomes a single horizontal row of small circles to save vertical space.
Method-switch recommendations¶
Sometimes the active method just doesn't land. After three sessions where your "understanding" rating doesn't grow and your "stress" rating stays high, the app surfaces a MethodSwitchBanner: "Want to try [other method] for the next session?". Accept and the next session starts with the new method active.
The recommendation reads your profile and prefers your second-strongest method that you haven't used recently. You can dismiss the banner; it'll come back if the stagnation pattern continues.
(In Local mode the switch-recommendation heuristic is still being ported — the banner currently returns "no recommendation" in that mode.)
Rating + ending a session¶
The Session page has an "End session" button. Before the session closes you fill a short rating: understanding, stress, and method-fit on a 1-5 scale. These ratings drive the Dashboard's trend lines AND the method-switch heuristic.
The ratings turn into a ProgressCommit row — the Git-style
snapshot of one session. See
Progress and the
Tracking concept.