A trimmed transcript from a fictional learner, Alex, three weeks into a music-theory course. Music theory rather than programming, deliberately — the engine is subject-agnostic and this is the easiest way to show it.
[...] marks where a real session had more back-and-forth.
This happened once, on day one, before any lesson existed.
Tutor This tells me where to start, so expect a few you can't answer — that's the point, not a problem.
In the key of C major, you play C–E–G. Someone lowers the E to E♭. What changed about the chord, in your own words?
Alex it sounds sadder? no idea what it's called
Tutor "Sadder" is the right observation, and it's the one that matters — you heard the change before you could name it. It's called minor, and the only thing that moved was the middle note.
Let me go one step down to find your floor. Play C, then E. How many white keys did you skip between them?
Alex D. so one
Tutor Good — that's solid. I have what I need: you hear differences reliably and you can navigate the keyboard, but the vocabulary isn't attached yet. That's a good place to start from, and it's faster than starting from nothing.
[...]
Unit 2, lesson 3. Today's objective: explain why a dominant seventh chord resolves to the tonic. Alex has just been shown that G7 contains G–B–D–F.
Tutor Two of those four notes are in an unstable relationship — they're the reason the chord refuses to sit still.
Before I say which: play B and F together. Then play C and E. Which pair sounds like it wants to go somewhere?
Alex the B and F one. its kind of ugly
Tutor That's the whole mechanism, and you found it by ear. That interval is a tritone — three whole steps.
Now the question the lesson is actually about: B wants to move somewhere, and F wants to move somewhere. Where does each one go?
Alex idk man just tell me
Tutor I'm not going to, and it's worth thirty seconds to say why once: the version of this you work out yourself is the version you'll still have next month. The one I hand you evaporates.
Smaller question. Play B, then C. How far apart are they?
Alex theyre right next to each other
Tutor Right — a half step, the smallest move there is. That closeness is the pull. So: B is one half step below C. If B is going to move, and it's that close to C, which way is it going?
Alex up to C
Tutor Yes. Now F. Look at the notes around it — E is a half step below, G is a whole step above. Given what you just learned about closeness, which way does F go?
Alex down to E i guess
Tutor That's it, and "I guess" is underselling it — you used the rule you'd just derived, on a new note, unprompted.
So B goes up to C, F goes down to E. Play those two: C and E. What chord are you looking at the bottom of?
Alex C major?? ohh so the ugly interval squeezes into the nice chord
Tutor "Squeezes" is exactly right, and it's a better word than the textbook's. The tritone collapses inward — one voice up a half step, one down a half step — and lands on the two notes that define C major. That is why G7 goes to C. It isn't convention. It's two notes with nowhere else to be.
Four questions, new material, at the level of the objective. First:
Tutor Before we start: out of these four, how many do you think you'll get right?
Alex 3
Tutor Noted. Question 1 of 4: D7 is D–F♯–A–C. Which two notes form the tritone?
Alex D and A
Result: 2 of 4. The gate requires 3 of 4. It fails.
Tutor 2 out of 4, so we don't move on today — and you predicted 3, which is close enough that your read on yourself is working.
The two you missed were both "find the tritone in a key that isn't C". The G7 reasoning is intact; it's the transfer that isn't. So the explanation I gave you was too tied to one key, and that's a fixable thing about my explanation, not about you.
Forget note names for a second. Here's the same chord as distances only:
scale degree: 1 3 5 ♭7
G7: G → B → D → F
half steps: 4 3 3
D7: D → F♯ → A → C
half steps: 4 3 3
Tutor Every dominant seventh has that same shape: 4, then 3, then 3. The tritone is always between the second note and the fourth one — the 3rd and the ♭7 — whatever the letters happen to be.
So in D7, counting only positions: which two?
Alex F# and C
Tutor Yes. Same question, new chord, and I'm not giving you the spelling: A7 is A–C♯–E–G. Tritone?
Alex C# and G
Tutor Correct, twice, on chords you hadn't seen. That's the re-check passed for that objective — but the gate covers the whole lesson, so we'll finish the other two objectives next session before anything gets marked
learned.
Tutor Last thing, and don't scroll up. Here's a chord someone wrote down as a dominant seventh:
E7 = E – G – B – D
Something's wrong with it. What, and how do you know?
Alex the G should be G#? because it has to be 4 half steps from E and G is only 3
Tutor Both parts right, including the reason. E to G is 3 half steps, which makes it minor — and the 4-3-3 shape is what makes a dominant seventh a dominant seventh.
Next session: the two objectives we didn't reach, then why this same collapse works in minor keys. By the end of it you'll be able to look at a chord you've never seen and say where it's going to go.
Then, without being asked, the tutor writes:
| File | What went into it |
|---|---|
state.json |
Evidence for every attempt; u2-l3-o1 stays learning; position does not advance — the gate failed; position.next_session records the two unfinished objectives |
cards.json |
Two new cards, due tomorrow |
notebook.md |
Alex's own explanation, corrected |
mistakes.md |
The transfer failure and its diagnosed cause |
syllabus.md |
Lesson 2.3 left unticked |
profile.json |
XP, streak, and a note: lead with interval distances, not letter names |
Music Theory — Harmony Unit 2/6 · Lesson 3
Mastery ████░░░░░░░░░░░ 2 mastered · 4 learned · 3 learning · 23 new
Quizzes U1 85% Midterm: pending (after U3)
Reviews 6 due today · next batch Thu · 1 card retired
Weak tritone transfer outside C major (1 open misconception)
Streak 4 days · 310 XP · level 2
Calibration: your predictions run about 8 points under your scores.
March 10: couldn't say what changed when E became E♭.
Today: derived voice-leading from half-step distance, on a chord you'd never seen.
Next: 6 cards are due — a review session is the highest-value 10 minutes
available. Or continue the lesson if you'd rather push on.
Everything lives under ~/.claude/tutor/. Plain files; open them, edit them, back them up.
profile.json
{
"schema_version": 1,
"name": "Alex",
"language": "en",
"created": "2026-03-10",
"xp": 310,
"level": 2,
"streak": { "days": 4, "last_study_date": "2026-03-31" },
"preferences": {
"session_minutes": 30,
"tone": "warm",
"examples_from": ["film scores", "pop songs"],
"notes": "2026-03-31: Letter-name explanations don't transfer across keys — lead with interval distances (4-3-3), then attach letters. Hears differences reliably before he can name them; use the ear as the entry point every time."
}
}state.json (excerpt)
{
"schema_version": 1,
"course": "music-theory-harmony",
"title": "Music Theory — Harmony",
"goal": "Understand what's happening harmonically in the film scores I love",
"horizon": "open-ended",
"created": "2026-03-10",
"sources": [
"Open Music Theory (2nd ed.), Chapters 1-4 — used for unit ordering"
],
"position": {
"unit": 2,
"lesson": 3,
"next_session": "Gate failed 2/4 — do NOT advance. Objectives o2 and o3 were never reached; teach those first. The 4-3-3 interval-distance framing worked where letter names failed; keep using it. Re-check o1 once more on a chord in a flat key before promoting."
},
"objectives": [
{
"id": "u2-l3-o1",
"text": "Explain why a dominant seventh resolves to the tonic, using the tritone's voice leading",
"bloom": "understand",
"status": "learning",
"evidence": [
{ "date": "2026-03-31", "kind": "guided-derivation", "result": "ok", "note": "derived both resolutions himself after the hint ladder" },
{ "date": "2026-03-31", "kind": "mastery-check", "result": "wrong", "note": "tritone in D7 — transfer failure, not a concept failure" },
{ "date": "2026-03-31", "kind": "parallel-recheck", "result": "ok" },
{ "date": "2026-03-31", "kind": "parallel-recheck", "result": "ok", "note": "A7, unseen chord" }
],
"last_seen": "2026-03-31"
}
],
"assessments": [
{
"date": "2026-03-31",
"kind": "mastery-check",
"scope": "u2-l3",
"score": 0.5,
"predicted": 0.75,
"items": 4,
"weak_objectives": ["u2-l3-o1"],
"note": "Both misses were the same failure — finding the tritone outside C major. Not two errors; one gap counted twice."
}
],
"misconceptions": [
{
"id": "m2",
"text": "Treats the tritone as a fixed pair of letter names rather than a fixed pair of scale degrees",
"detected": "2026-03-31",
"status": "open",
"resolved_on": null
}
]
}cards.json (excerpt)
{
"schema_version": 1,
"cards": [
{
"id": "c19",
"objective_id": "u2-l3-o1",
"prompt": "B♭7 is B♭–D–F–A♭. Which two notes form the tritone, and where does each one want to move?",
"answer": "D and A♭ — the 3rd and the ♭7. D pulls up a half step to E♭, A♭ pulls down a half step to G. They collapse onto E♭ and G, the two notes that define E♭ major.",
"type": "apply-to-new-case",
"interval_days": 1,
"ease": 2.5,
"due": "2026-04-01",
"lapses": 0,
"retired": false,
"note": "Built against misconception m2 — deliberately a flat key, so letter-name pattern matching cannot work.",
"history": []
}
]
}notebook.md — written by Alex from memory, corrected by the tutor
## 2026-03-31 — u2-l3 (why V7 goes to I)
A dominant seventh has two notes in it that sound ugly together — a **tritone**,
three whole steps apart. They're the 3rd and the ♭7 of the chord.
Neither one can stay put. One is a half step below where it wants to go, so it
goes up; the other is a half step above, so it goes down. They squeeze inward
and land on the 3rd and the root of the next chord.
That's why G7 → C. Not a rule someone invented — two notes with nowhere else to be.
> **Tutor's correction:** they land on the tonic's root and 3rd (C and E).
> "The two notes that define the chord" is right, but say which ones.
**Shape to remember:** every dominant seventh is 4-3-3 half steps.
The tritone is always between note 2 and note 4, in any key.