@mcptoolshop/ai_jam_session 0.1.0

package/songs/builtin/bennie-and-the-jets.json

@@ -0,0 +1,92 @@
+{
+  "id": "bennie-and-the-jets",
+  "title": "Bennie and the Jets",
+  "genre": "rock",
+  "composer": "Elton John & Bernie Taupin",
+  "difficulty": "intermediate",
+  "key": "G major",
+  "tempo": 112,
+  "timeSignature": "4/4",
+  "durationSeconds": 17,
+  "tags": [
+    "elton-john",
+    "glam-rock",
+    "staccato",
+    "syncopated",
+    "funky"
+  ],
+  "source": "Claude arrangement — simplified interpretation",
+  "musicalLanguage": {
+    "description": "Elton John's glam-rock masterpiece features a punchy, syncopated piano style with staccato chords and rhythmic accents. The song's piano part is percussive and funky, quite different from his ballad style. This arrangement captures the signature choppy chord hits and the driving energy.",
+    "structure": "Verse-Chorus riff (8 bars) — G-Am-C-G with syncopated staccato chords",
+    "keyMoments": [
+      "Bars 1-2: The punchy G major opening — staccato chords define the glam-rock texture",
+      "Bars 3-4: Am to C — the chord changes create rhythmic interest through anticipation",
+      "Bars 7-8: The signature descending bass line into the cadence"
+    ],
+    "teachingGoals": [
+      "Staccato chord technique — short, punchy attacks",
+      "Syncopated rhythms — accenting off-beats",
+      "Percussive piano playing style"
+    ],
+    "styleTips": [
+      "Play chords short and punchy — staccato is essential to the glam-rock feel",
+      "Accent the off-beats — the groove comes from syncopation",
+      "Think of the piano as a rhythm instrument here, not a melodic one"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "G4 B4 D5:q R:e G4 B4 D5:e R:q G4 B4 D5:q",
+      "leftHand": "G2:q R:e G2:e R:q G2:q",
+      "teachingNote": "G major staccato chords — the iconic punchy feel. Play them short and snappy.",
+      "dynamics": "f"
+    },
+    {
+      "number": 2,
+      "rightHand": "G4 B4 D5:e R:e G4 B4 D5:q R:q G4 B4 D5:q",
+      "leftHand": "G2:e R:e G2:q R:q G3:q",
+      "teachingNote": "Same chord, different rhythm — the syncopation shifts. Feel the groove, do not just read it."
+    },
+    {
+      "number": 3,
+      "rightHand": "A4 C5 E5:q R:e A4 C5 E5:e R:q A4 C5 E5:q",
+      "leftHand": "A2:q R:e A2:e R:q A2:q",
+      "teachingNote": "A minor — same rhythmic pattern transposed. The chord change adds harmonic interest."
+    },
+    {
+      "number": 4,
+      "rightHand": "C5 E5 G5:q R:e C5 E5 G5:e R:q C5 E5 G5:q",
+      "leftHand": "C3:q R:e C3:e R:q C3:q",
+      "teachingNote": "C major — the biggest, brightest chord. Play it with authority."
+    },
+    {
+      "number": 5,
+      "rightHand": "G4 B4 D5:q R:e G4 B4 D5:e G4 B4 D5:q R:q",
+      "leftHand": "G2:q R:e G2:e G2:q R:q",
+      "teachingNote": "G major returns — you know this shape. Lean into the syncopation.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 6,
+      "rightHand": "F#4 A4 D5:q R:e F#4 A4 D5:e R:q F#4 A4 D5:q",
+      "leftHand": "D2:q R:e D2:e R:q D2:q",
+      "teachingNote": "D major — the V chord. F# gives it the bright major quality."
+    },
+    {
+      "number": 7,
+      "rightHand": "E4 G4 C5:q R:e E4 G4 C5:e R:q E4 G4 C5:q",
+      "leftHand": "C3:q B2:q A2:q G2:q",
+      "teachingNote": "C major with descending bass — the signature bass line walks down chromatically.",
+      "dynamics": "f"
+    },
+    {
+      "number": 8,
+      "rightHand": "G4 B4 D5:h R:h",
+      "leftHand": "D2:q G2:q G2:h",
+      "teachingNote": "G major — one final stab and silence. The rest is as important as the notes.",
+      "dynamics": "ff"
+    }
+  ]
+}

package/songs/builtin/besame-mucho.json

@@ -0,0 +1,93 @@
+{
+  "id": "besame-mucho",
+  "title": "Besame Mucho",
+  "genre": "latin",
+  "composer": "Consuelo Velazquez",
+  "difficulty": "intermediate",
+  "key": "D minor",
+  "tempo": 108,
+  "timeSignature": "4/4",
+  "durationSeconds": 18,
+  "tags": [
+    "bolero",
+    "romantic",
+    "mexican",
+    "standard",
+    "minor-key"
+  ],
+  "source": "Claude arrangement — simplified interpretation",
+  "musicalLanguage": {
+    "description": "One of the most performed Latin songs ever written, this bolero by Consuelo Velazquez is built on passionate D minor harmony with dramatic leaps in the melody. The arrangement captures the song's yearning quality through expressive chord voicings and a melody that reaches upward with romantic urgency. The bolero rhythm in the left hand provides a gentle, swaying pulse.",
+    "structure": "A section: Dm-Gm-A7-Dm (4 bars), B section: chromatic intensification (4 bars)",
+    "keyMoments": [
+      "Bar 1: Dm — the melody's opening leap from D to A sets the passionate tone.",
+      "Bar 3: A7 — the dominant with its sharp leading tone C#. Maximum tension.",
+      "Bars 5-6: The bridge lifts to Bb major — a moment of warmth in the minor landscape."
+    ],
+    "teachingGoals": [
+      "Bolero rhythm pattern in the left hand",
+      "Expressive melodic leaps — reaching with intention",
+      "Minor key romantic expression with chromatic harmony"
+    ],
+    "styleTips": [
+      "Play with passion but control — bolero is smoldering, not explosive",
+      "Melody should sing and sustain — use pedal for legato",
+      "Left hand bolero pattern: bass note, then chord, gently rocking"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "D4:q A4:q A4:q G4:q",
+      "leftHand": "D3:q A3 D4:q D3:q A3 D4:q",
+      "dynamics": "mp",
+      "teachingNote": "Dm — the leap from D to A is the soul of the melody. Make it yearning."
+    },
+    {
+      "number": 2,
+      "rightHand": "F4:q G4:q A4:h",
+      "leftHand": "G3:q Bb3 D4:q G3:q Bb3 D4:q",
+      "teachingNote": "Gm — melody climbs stepwise. The bolero rhythm keeps swaying."
+    },
+    {
+      "number": 3,
+      "rightHand": "G4:q F4:q E4:q D4:q",
+      "leftHand": "A2:q C#3 E3:q A2:q C#3 E3:q",
+      "dynamics": "mf",
+      "teachingNote": "A7 — dominant tension. C# in the left hand pulls toward D."
+    },
+    {
+      "number": 4,
+      "rightHand": "D4:h R:q D4:q",
+      "leftHand": "D3:q A3 D4:q D3:h",
+      "teachingNote": "Dm — resolution. The rest lets the phrase breathe before the next section."
+    },
+    {
+      "number": 5,
+      "rightHand": "D4:q F4:q Bb4:q A4:q",
+      "leftHand": "Bb2:q D3:q F3:q Bb3:q",
+      "dynamics": "mf",
+      "teachingNote": "Bb major — warm contrast to the minor. Melody stretches to Bb4."
+    },
+    {
+      "number": 6,
+      "rightHand": "A4:q G4:q F4:q E4:q",
+      "leftHand": "C3:q E3:q G3:q Bb3:q",
+      "dynamics": "f",
+      "teachingNote": "C7 — descending melody with rising intensity. Dramatic contrast."
+    },
+    {
+      "number": 7,
+      "rightHand": "F4:q E4:q D4:q C#4:q",
+      "leftHand": "A2:q C#3:q E3:q G3:q",
+      "teachingNote": "A7 — chromatic descent in the melody. C# is the final pull toward home."
+    },
+    {
+      "number": 8,
+      "rightHand": "D4:w",
+      "leftHand": "D3:q A3 D4:q D3:h",
+      "dynamics": "p",
+      "teachingNote": "Dm — whole note resolution. Let it ring with all the longing."
+    }
+  ]
+}

package/songs/builtin/black-orpheus.json

@@ -0,0 +1,92 @@
+{
+  "id": "black-orpheus",
+  "title": "Black Orpheus (Manha de Carnaval)",
+  "genre": "latin",
+  "composer": "Luiz Bonfa / Antonio Maria",
+  "difficulty": "intermediate",
+  "key": "A minor",
+  "tempo": 120,
+  "timeSignature": "4/4",
+  "durationSeconds": 16,
+  "tags": [
+    "bossa-nova",
+    "film",
+    "brazilian",
+    "minor-key",
+    "romantic"
+  ],
+  "source": "Claude arrangement — simplified interpretation",
+  "musicalLanguage": {
+    "description": "From the 1959 film Black Orpheus, this haunting bossa nova in A minor is one of the most beloved Brazilian compositions. The melody has a wistful, singing quality that moves through the natural and harmonic minor scales. The chord progression features the classic ii-V-i jazz pattern applied to bossa nova, creating a sophisticated but deeply emotional piece.",
+    "structure": "A section: Am-Bm7b5-E7-Am descent (4 bars), B section: Dm7-G7-Cmaj7 relative major excursion (4 bars)",
+    "keyMoments": [
+      "Bar 1: Am — the opening melody rises like a morning in Rio.",
+      "Bars 3-4: E7 to Am — the ii-V-i resolution in minor. The G# gives it bite.",
+      "Bars 5-6: Dm7 to G7 to Cmaj7 — briefly touching the relative major. A ray of sunlight."
+    ],
+    "teachingGoals": [
+      "Minor key bossa nova feel — different from major bossa",
+      "ii-V-i chord progression in minor keys",
+      "Navigating between relative minor and major"
+    ],
+    "styleTips": [
+      "More melancholy than Girl from Ipanema — keep the minor color present",
+      "The melody should float but with a hint of sadness",
+      "Bossa rhythm stays gentle even when the harmony gets dark"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "E4:q A4:q B4:q C5:q",
+      "leftHand": "A2:q E3 A3 C4:q A2:q E3 A3 C4:q",
+      "dynamics": "mp",
+      "teachingNote": "Am — ascending melody. Morning light through a window."
+    },
+    {
+      "number": 2,
+      "rightHand": "B4:q A4:q G#4:q A4:q",
+      "leftHand": "B2:q D3 F3 A3:q B2:q D3 F3 A3:q",
+      "teachingNote": "Bm7b5 — the ii chord in minor. G# hints at the coming E7."
+    },
+    {
+      "number": 3,
+      "rightHand": "G#4:q A4:q B4:q G#4:q",
+      "leftHand": "E2:q G#3 B3 D4:q E2:q G#3 B3 D4:q",
+      "dynamics": "mf",
+      "teachingNote": "E7 — dominant tension. G# is the leading tone pulling to A."
+    },
+    {
+      "number": 4,
+      "rightHand": "A4:h E4:h",
+      "leftHand": "A2:q E3 A3 C4:q A2:h",
+      "teachingNote": "Am — resolution. Let the half notes breathe."
+    },
+    {
+      "number": 5,
+      "rightHand": "D4:q F4:q A4:q G4:q",
+      "leftHand": "D3:q F3 A3 C4:q D3:q F3 A3 C4:q",
+      "dynamics": "mf",
+      "teachingNote": "Dm7 — stepping toward the relative major. Warmth enters."
+    },
+    {
+      "number": 6,
+      "rightHand": "G4:q F4:q E4:q D4:q",
+      "leftHand": "G2:q B3 D4 F4:q C2:q E3 G3 B3:q",
+      "teachingNote": "G7 to Cmaj7 — the major resolution. A brief moment of sunlight."
+    },
+    {
+      "number": 7,
+      "rightHand": "C4:q D4:q E4:q F4:q",
+      "leftHand": "F2:q A3 C4 E4:q B2:q D3 F3 A3:q",
+      "teachingNote": "Fmaj7 to Bm7b5 — heading back to minor. The shadow returns."
+    },
+    {
+      "number": 8,
+      "rightHand": "E4:q D4:q C4:q A3:q",
+      "leftHand": "E2:q G#3 B3 D4:q A2:h",
+      "dynamics": "p",
+      "teachingNote": "E7 to Am — final resolution. The melody descends to rest."
+    }
+  ]
+}

package/songs/builtin/blue-bossa.json

@@ -0,0 +1,94 @@
+{
+  "id": "blue-bossa",
+  "title": "Blue Bossa",
+  "genre": "jazz",
+  "composer": "Kenny Dorham",
+  "difficulty": "intermediate",
+  "key": "C minor",
+  "tempo": 140,
+  "timeSignature": "4/4",
+  "durationSeconds": 14,
+  "tags": [
+    "bossa-nova",
+    "latin-jazz",
+    "minor-key",
+    "ii-V-i",
+    "real-book",
+    "kenny-dorham"
+  ],
+  "source": "Claude arrangement — simplified interpretation",
+  "musicalLanguage": {
+    "description": "A Latin jazz classic that blends bossa nova rhythm with jazz harmony. The tune sits primarily in C minor with a brief detour to Db major, creating a beautiful key-center shift. The bossa groove in the left hand should be steady and understated — think Rio, not New York.",
+    "structure": "16-bar form (this excerpt: first 8 bars in C minor)",
+    "keyMoments": [
+      "Bar 1-2: Cm7 establishes the minor mood with bossa rhythm",
+      "Bar 3-4: Fm7 — the iv chord adds depth to the minor tonality",
+      "Bar 5-6: Dm7b5 to G7 — the classic minor ii-V, pulling toward resolution",
+      "Bar 7-8: Cm7 — home. The ii-V resolves beautifully."
+    ],
+    "teachingGoals": [
+      "Bossa nova left-hand pattern — root on 1, chord on the 'and' of 2",
+      "Minor ii-V-i progression: Dm7b5 - G7 - Cm7",
+      "Smooth voice leading between closely related chords"
+    ],
+    "styleTips": [
+      "Bossa nova is gentle — no heavy accents, let the rhythm flow",
+      "Left hand should be legato and quiet, creating a cushion",
+      "Right hand melody is lyrical and singing — think of a vocalist"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "G4:q Eb5:h C5:q",
+      "leftHand": "C3:q R:e Eb3 G3:e R:q Bb3:q",
+      "teachingNote": "Cm7 with bossa pattern. The melody leaps up to Eb5 then steps down.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 2,
+      "rightHand": "D5:q Eb5:q C5:h",
+      "leftHand": "C3:q R:e Eb3 G3:e R:q Bb3:q",
+      "teachingNote": "Still on Cm7. The melody is simple and vocal — singable."
+    },
+    {
+      "number": 3,
+      "rightHand": "C5:q Ab4:h F4:q",
+      "leftHand": "F3:q R:e Ab3 C4:e R:q Eb4:q",
+      "teachingNote": "Fm7 — the iv chord. Left hand shifts the bossa pattern up to F."
+    },
+    {
+      "number": 4,
+      "rightHand": "G4:q Ab4:q F4:h",
+      "leftHand": "F3:q R:e Ab3 C4:e R:q Eb4:q",
+      "teachingNote": "Second bar of Fm7. Melody gently ornaments around the chord tones."
+    },
+    {
+      "number": 5,
+      "rightHand": "F4:q Ab4:q G4:h",
+      "leftHand": "D3:q R:e Ab3 C4:e R:h",
+      "teachingNote": "Dm7b5 — the ii chord of the minor ii-V. The Ab in left hand is the b5.",
+      "dynamics": "mp"
+    },
+    {
+      "number": 6,
+      "rightHand": "B4:q D5:q C5:h",
+      "leftHand": "G2:q R:e B2 F3:e R:h",
+      "teachingNote": "G7 — the V chord. B natural is the major 3rd that creates the pull to Cm.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 7,
+      "rightHand": "C5:q Eb5:q D5:q C5:q",
+      "leftHand": "C3:q R:e Eb3 G3:e R:q Bb3:q",
+      "teachingNote": "Cm7 — resolution! The ii-V-i is complete. The melody celebrates the arrival."
+    },
+    {
+      "number": 8,
+      "rightHand": "G4:h R:h",
+      "leftHand": "C3:q R:e Eb3 G3:e R:h",
+      "teachingNote": "Cm7 continues. The rest in the melody creates space before the next section.",
+      "dynamics": "p"
+    }
+  ]
+}

package/songs/builtin/blues-in-g.json

@@ -0,0 +1,92 @@
+{
+  "id": "blues-in-g",
+  "title": "Blues in G",
+  "genre": "blues",
+  "composer": "Traditional",
+  "difficulty": "beginner",
+  "key": "G major",
+  "tempo": 100,
+  "timeSignature": "4/4",
+  "durationSeconds": 19,
+  "tags": [
+    "12-bar",
+    "traditional",
+    "beginner-friendly",
+    "foundation",
+    "shuffle",
+    "practice"
+  ],
+  "source": "Claude arrangement",
+  "musicalLanguage": {
+    "description": "A straightforward 12-bar blues in G with a shuffle feel. This is the essential blues template that every pianist should know. Three dominant 7th chords (G7, C7, D7) and a simple melody built on the G blues scale. Master this and you can jam with anyone.",
+    "structure": "Standard 12-bar blues: I(4)-IV(2)-I(2)-V-IV-I-V. This excerpt: 8 bars",
+    "keyMoments": [
+      "Bar 1-4: G7 — four bars of the tonic. Settle into the shuffle groove.",
+      "Bar 5-6: C7 — the IV chord arrives. Same melodic idea, new key center.",
+      "Bar 7-8: G7 — back to the tonic, preparing for the turnaround"
+    ],
+    "teachingGoals": [
+      "12-bar blues form — the most important structure in popular music",
+      "Shuffle rhythm with dominant 7th chords",
+      "G blues scale: G Bb C Db D F G"
+    ],
+    "styleTips": [
+      "Shuffle feel — long-short eighth notes, like a lazy triplet",
+      "Keep the left hand steady as a metronome — it is the foundation",
+      "Right hand can be loose and bluesy — bend into the blue notes"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "G4:q Bb4:q B4:q D5:q",
+      "leftHand": "G2:q D3:q G3:q D3:q",
+      "teachingNote": "G7 — blues scale melody: G-Bb-B-D. The Bb sliding to B is the essential blues sound.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 2,
+      "rightHand": "F5:q D5:q B4:q G4:q",
+      "leftHand": "G2:q D3:q G3:q D3:q",
+      "teachingNote": "G7 — melody comes back down. F is the b7 of G7. Keep it simple and groovy."
+    },
+    {
+      "number": 3,
+      "rightHand": "G4:q Bb4:q D5:q F5:q",
+      "leftHand": "G2:q D3:q G3:q D3:q",
+      "teachingNote": "G7 — climbing back up. These are all chord tones of G7 (with the blue Bb)."
+    },
+    {
+      "number": 4,
+      "rightHand": "D5:h B4:h",
+      "leftHand": "G2:q D3:q B2:q G2:q",
+      "teachingNote": "G7 — resting on half notes. Simplify before the chord change."
+    },
+    {
+      "number": 5,
+      "rightHand": "C5:q Eb5:q E5:q G5:q",
+      "leftHand": "C3:q G3:q C4:q G3:q",
+      "teachingNote": "C7 — the IV chord! Same blues scale shape transposed. Eb slides to E.",
+      "dynamics": "f"
+    },
+    {
+      "number": 6,
+      "rightHand": "Bb4:q G4:q E4:q C4:q",
+      "leftHand": "C3:q G3:q C4:q G3:q",
+      "teachingNote": "C7 continues. Melody descends through the C7 chord tones."
+    },
+    {
+      "number": 7,
+      "rightHand": "G4:q Bb4:q B4:q D5:q",
+      "leftHand": "G2:q D3:q G3:q D3:q",
+      "teachingNote": "G7 — back to the tonic. The familiar opening riff returns. Feels like home.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 8,
+      "rightHand": "D5:q B4:q G4:h",
+      "leftHand": "G2:q D3:q G3:h",
+      "teachingNote": "G7 — settling down. Half note at the end creates space for the turnaround."
+    }
+  ]
+}

package/songs/builtin/bohemian-rhapsody-intro.json

@@ -0,0 +1,94 @@
+{
+  "id": "bohemian-rhapsody-intro",
+  "title": "Bohemian Rhapsody (Intro)",
+  "genre": "pop",
+  "composer": "Freddie Mercury",
+  "difficulty": "advanced",
+  "key": "Bb major",
+  "tempo": 72,
+  "timeSignature": "4/4",
+  "durationSeconds": 27,
+  "tags": [
+    "queen",
+    "dramatic",
+    "advanced",
+    "chromatic",
+    "iconic-intro"
+  ],
+  "source": "Claude arrangement — simplified interpretation",
+  "musicalLanguage": {
+    "description": "The dramatic piano introduction to one of rock's greatest compositions. The opening features rich chordal harmonies with chromatic voice leading, building from a quiet Bb6 chord to the powerful vocal entry. This arrangement captures the harmonic density and dramatic arc of the original.",
+    "structure": "Intro (8 bars) — Bb6-C7-F7-Bb with chromatic passing chords and dramatic build",
+    "keyMoments": [
+      "Bars 1-2: The a cappella-style opening — Bb6 chord with rich voicing",
+      "Bars 3-4: Chromatic movement downward — the harmonic tension builds",
+      "Bars 7-8: The dramatic climax before the verse begins — full chordal texture"
+    ],
+    "teachingGoals": [
+      "Complex chord voicings with extensions (6ths, 7ths)",
+      "Chromatic voice leading between chords",
+      "Dynamic build from pp to f across a phrase"
+    ],
+    "styleTips": [
+      "Start extremely quietly and build gradually — the drama is in the crescendo",
+      "Voice each chord carefully — every note should ring clearly",
+      "The rubato (flexible timing) is essential — this is theatrical, not metronomic"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "D4:q F4:q Bb4:q G4:q",
+      "leftHand": "Bb2:h Bb2:h",
+      "teachingNote": "Bb major — the quiet opening. Place each note with intention. This is theater.",
+      "dynamics": "pp"
+    },
+    {
+      "number": 2,
+      "rightHand": "F4:q A4:q C5:q A4:q",
+      "leftHand": "F2:h F3:h",
+      "teachingNote": "F major — the harmony opens up. Still very quiet. Building anticipation."
+    },
+    {
+      "number": 3,
+      "rightHand": "Bb4:q A4:q G4:q F4:q",
+      "leftHand": "Eb3:h D3:h",
+      "teachingNote": "Eb to Dm — chromatic bass descent. The melody falls with the harmony.",
+      "dynamics": "p"
+    },
+    {
+      "number": 4,
+      "rightHand": "G4:q A4:q Bb4:h",
+      "leftHand": "C3:h F2:h",
+      "teachingNote": "C7 to F — the melody rises against descending bass. Dramatic countermotion.",
+      "dynamics": "mp"
+    },
+    {
+      "number": 5,
+      "rightHand": "D5 F4:q C5 Eb4:q Bb4 D4:q A4 C4:q",
+      "leftHand": "Bb2:q A2:q G2:q F2:q",
+      "teachingNote": "Parallel sixths descending — both hands move down together. Rich, full texture.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 6,
+      "rightHand": "G4 Bb4:q A4 C5:q Bb4 D5:h",
+      "leftHand": "Eb2:q F2:q Bb2:h",
+      "teachingNote": "Ascending sixths to the climax — building dramatic intensity."
+    },
+    {
+      "number": 7,
+      "rightHand": "D5 Bb4 F4:q C5 A4 F4:q Bb4 G4 D4:q A4 F4 C4:q",
+      "leftHand": "Bb2:q F2:q G2:q F2:q",
+      "teachingNote": "Full triads in the right hand — the dramatic peak. Give each chord weight.",
+      "dynamics": "f"
+    },
+    {
+      "number": 8,
+      "rightHand": "Bb4 F4 D4:h F4 D4 Bb3:h",
+      "leftHand": "Bb2:h Bb2:h",
+      "teachingNote": "Bb major resolves — two rich chords settle the drama. Pause before the verse would begin.",
+      "dynamics": "mf"
+    }
+  ]
+}

package/songs/builtin/boogie-woogie-basics.json

@@ -0,0 +1,93 @@
+{
+  "id": "boogie-woogie-basics",
+  "title": "Boogie Woogie Basics",
+  "genre": "blues",
+  "composer": "Traditional",
+  "difficulty": "beginner",
+  "key": "C major",
+  "tempo": 120,
+  "timeSignature": "4/4",
+  "durationSeconds": 16,
+  "tags": [
+    "boogie-woogie",
+    "left-hand-study",
+    "pattern",
+    "foundation",
+    "shuffle",
+    "beginner-friendly"
+  ],
+  "source": "Claude arrangement",
+  "musicalLanguage": {
+    "description": "A left-hand pattern study for the most infectious rhythm in blues piano — the boogie-woogie bass. The repeating eighth-note pattern in the left hand creates a rolling, train-like momentum. Once your left hand has this on autopilot, you can add any blues melody on top.",
+    "structure": "8-bar boogie pattern study: I(4)-IV(2)-I(2)",
+    "keyMoments": [
+      "Bar 1-2: The C boogie pattern — eight notes rolling like a freight train",
+      "Bar 3-4: Pattern continues — left hand should start feeling automatic",
+      "Bar 5-6: F boogie pattern — same shape transposed to the IV chord",
+      "Bar 7-8: Back to C — the pattern comes home"
+    ],
+    "teachingGoals": [
+      "Boogie-woogie left hand pattern — the foundation of blues piano",
+      "Left hand independence — keeping the pattern steady while right hand plays",
+      "Transposing the same pattern to different root notes (C, F)"
+    ],
+    "styleTips": [
+      "Practice the left hand ALONE first until it is automatic",
+      "Keep the eighth notes even and steady — this is the engine",
+      "Right hand starts very simple — just chord tones on the beat"
+    ]
+  },
+  "measures": [
+    {
+      "number": 1,
+      "rightHand": "C4 E4 G4:h R:h",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — right hand plays a simple triad. Left hand plays the classic boogie pattern: C-E-G-A-C-A-G-E.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 2,
+      "rightHand": "E4:q G4:q Bb4:q G4:q",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — right hand adds the b7 (Bb). Left hand keeps the exact same pattern."
+    },
+    {
+      "number": 3,
+      "rightHand": "G4:q E4:q C4:q E4:q",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — simple back-and-forth melody. Focus on keeping the left hand steady."
+    },
+    {
+      "number": 4,
+      "rightHand": "G4:q Bb4:q G4:q E4:q",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — adding some blues flavor with Bb. Four bars of C done. Get ready to shift!"
+    },
+    {
+      "number": 5,
+      "rightHand": "F4 A4 C5:h R:h",
+      "leftHand": "F2:e A2:e C3:e D3:e F3:e D3:e C3:e A2:e",
+      "teachingNote": "F7 — SAME left hand shape, starting on F! F-A-C-D-F-D-C-A. Right hand shifts to F triad.",
+      "dynamics": "f"
+    },
+    {
+      "number": 6,
+      "rightHand": "A4:q C5:q Eb5:q C5:q",
+      "leftHand": "F2:e A2:e C3:e D3:e F3:e D3:e C3:e A2:e",
+      "teachingNote": "F7 — Eb is the b7 of F. Left hand pattern stays perfectly steady."
+    },
+    {
+      "number": 7,
+      "rightHand": "C4 E4 G4:h Bb4:h",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — back to the tonic. The left hand pattern returns to C. Feels like home.",
+      "dynamics": "mf"
+    },
+    {
+      "number": 8,
+      "rightHand": "G4:q E4:q C4:h",
+      "leftHand": "C2:e E2:e G2:e A2:e C3:e A2:e G2:e E2:e",
+      "teachingNote": "C7 — resolve down to C4. The boogie cycle is complete. Loop it!"
+    }
+  ]
+}