Harmonic Suggestion Engine

Input Requirements

1. Current progression: What the user has so far
2. Target: Where they want to go (section type, emotion, resolution)
3. Context (optional): Key, song.yaml, existing sections
4. Config preferences (from workspace): Influences, skill level, preferred techniques

Suggestion Process

Step 1: Where Are We Now?

Reference: ${CLAUDE_PLUGIN_ROOT}/skills/bard-analyze/SKILL.md

• What key are we in?
• What cell are we in? (grounding, driving, floating, etc.)
• What's the last chord, and what does it want?

Step 2: Where Do They Want To Go?

Parse the request in songwriter terms:

• Section goal: bridge, chorus, outro, pre-chorus
• Feeling goal: lift, resolve, surprise, add darkness
• Energy goal: build tension, release, maintain

Step 3: What Move Gets Us There?

Reference: ${CLAUDE_PLUGIN_ROOT}/lib/framework/common-moves.md Reference: ${CLAUDE_PLUGIN_ROOT}/lib/framework/core.md

Step 4: Generate Options

Produce 3-5 suggestions ranked by:

1. Feel fit: Does it achieve the emotional goal?
2. Smoothness: How easy is the transition? (anchor fingers, walking)
3. Energy match: Right amount of drive/rest for the section
4. Precedent: Have other songs done this well?

Step 5: Explain Each Option

For each suggestion, provide:

• The chord sequence (Nashville numbers)
• What it will feel like
• Why the voice leading works (what your hands do)
• Similar uses in known songs
• [Theory] Roman numerals and function for those who want it

Output Format

## Suggestions for [target]

**Where we are**: [last chords] in [key]
**Where we're going**: [section] — [feeling goal]
**The move**: [cell transition in plain English]

---

### Option 1: The Build-Up ⭐ Recommended

**Chords**: Dm - G - C - Am
**In numbers**: 2m - 5 - 1 - 6m

**What it feels like**: Classic drive toward arrival. The 2m sets up
the 5, which pulls hard to 1. Adding 6m at the end keeps momentum —
you've arrived but you're not done.

**Your hands**: F note holds from current chord into Dm, then
everything walks smoothly. No awkward leaps.

**Where you've heard this**: Pre-chorus patterns everywhere. This is
the backbone of pop songwriting.

[Theory: ii-V-I-vi. The ii is pre-dominant, V is dominant, I is tonic
arrival, vi extends without full resolution.]

---

### Option 2: The Minor Shade

**Chords**: Am - F - G - G
**In numbers**: 6m - 4 - 5 - 5

**What it feels like**: Darker start, then building. The Am brings
shadow before the F-G climb. Repeating G creates anticipation —
you're really making them wait for the landing.

**Your hands**: If coming from C, E is the anchor note between
C and Am. Smooth transition into the build.

[Theory: vi-IV-V-V. Tonic substitute to pre-dominant to repeated
dominant for maximum tension.]

---

### Option 3: The Rock Lift

**Chords**: Bb - F - G - G
**In numbers**: b7 - 4 - 5 - 5

**What it feels like**: That rock/blues edge. The Bb is unexpected —
it's from the "shadow key" — and it lifts you before the familiar
F-G build-up.

**Your hands**: Bb is two frets down from C (barre chord slide).
Then the rest is familiar territory.

**Where you've heard this**: Classic rock pre-choruses. Think
"Hey Jude" territory.

[Theory: bVII-IV-V. The bVII is borrowed from parallel minor /
Mixolydian, providing modal color before the cadential build.]

---

## Quick Comparison

| Option | Vibe | Energy | Surprise |
|--------|------|--------|----------|
| Build-Up | Classic, reliable | Steady climb | Expected |
| Minor Shade | Darker, emotional | Building | Low |
| Rock Lift | Edgy, interesting | Sudden lift | Medium |

Suggestion Templates

Verse → Pre-Chorus

Build tension, prepare for the payoff:

• The Build-Up: 2m - 5 - 5 - 5 (classic drive)
• The Minor Shade: 6m - 4 - 5 - 5 (darker approach)
• The Rock Lift: 1 - b7 - 4 - 5 (edge before familiar)

Pre-Chorus → Chorus

Strong arrival:

• Direct Landing: 5 → 1 (straight home)
• Soft then Strong: 4 - 5 → 1 (lean then land)
• The Deceptive Turn: 5 → 6m → 4 → 1 (surprise then arrive)

Chorus → Bridge

Create contrast — go somewhere new:

• The Drop: Go to 6m (relative minor territory)
• The Lift: Jump to 4 (subdominant brightness)
• The Rock Departure: Go to b7 (that mixolydian feel)
• The Walk-Down: Chromatic bass descent (floating)

Bridge → Final Chorus

Build it back up:

• The Build-Up: Drive toward 5, let it pull
• The Dramatic Pause: Stop on 5, silence, then 1 big
• The Chromatic Climb: Walk bass up to 5

Outro

Wind down or go out strong:

• Soft Ending: 4 - 1 (gentle, like "Amen")
• Strong Ending: 1 - 5 - 1 (decisive)
• Rock Ending: 1 - b7 - 4 - 1 (that rock feel)

Context Awareness

If song.yaml exists

• Read existing sections
• Maintain key consistency
• Consider melodic range constraints
• Reference established motifs

If melody contour provided

• Suggest harmony that supports contour peaks
• Align tension with melodic high points
• Consider chord tones vs melody notes

If influences mentioned

• Weight suggestions toward that style
• Reference specific techniques from influences
• Match harmonic vocabulary

Corpus Integration

Reference: ${CLAUDE_PLUGIN_ROOT}/lib/patterns/progression-matching.md

Search for:

• Similar starting points in corpus
• Patterns that achieve similar goals
• Techniques from specified influences

Framework References

• Core theory: ${CLAUDE_PLUGIN_ROOT}/lib/framework/core.md
• Voice leading: ${CLAUDE_PLUGIN_ROOT}/lib/framework/voice-leading.md
• Gallery notes: ${CLAUDE_PLUGIN_ROOT}/lib/framework/gallery-notes.md
• Corpus patterns: ${CLAUDE_PLUGIN_ROOT}/corpus/
• Workspace detection: ${CLAUDE_PLUGIN_ROOT}/lib/patterns/workspace-detection.md
• Path resolution: ${CLAUDE_PLUGIN_ROOT}/lib/patterns/path-resolution.md
• Default config: ${CLAUDE_PLUGIN_ROOT}/lib/defaults/config.yaml