1 files changed, 46 insertions, 0 deletions
diff --git a/tools/timeline_editor/ROADMAP.md b/tools/timeline_editor/ROADMAP.md
index 4a9d171..4bfc35c 100644
--- a/tools/timeline_editor/ROADMAP.md
+++ b/tools/timeline_editor/ROADMAP.md
@@ -421,6 +421,52 @@ function detectOverlaps() {
 
 ---
 
+### 2.5 Music.track Visualization & Overlay
+**Goal:** Display tracker patterns and samples alongside timeline for precise alignment.
+
+**Features:**
+- Load `music.track` file (parse tracker score format)
+- Render tracker patterns as horizontal bars above/below sequences
+- Display sample triggers (kick, snare, bass notes) as vertical markers
+- Color-code different sample types (drums, bass, melody)
+- Show pattern names and beat divisions
+- Toggle visibility (checkbox: "Show Tracker Score")
+- Sync horizontal scale with timeline (pixels per second)
+- Help users align visual sequences with audio events
+
+**Implementation Details:**
+```javascript
+// Parse music.track file format (similar to demo.seq parser)
+function parseTrackerScore(content) {
+    // Extract patterns, events, sample triggers
+    // Return structured data: { patterns: [...], events: [...] }
+}
+
+// Render tracker overlay on canvas or DOM elements
+function renderTrackerOverlay() {
+    // Draw pattern bars
+    // Draw sample trigger markers (vertical lines)
+    // Label with sample names (KICK_1, BASS_E2, etc.)
+}
+```
+
+**Visual Design:**
+- Tracker patterns: Semi-transparent colored bars (green/yellow/purple)
+- Sample triggers: Thin vertical lines with labels
+- Pattern names: Small text above bars
+- Positioned above waveform, below time markers
+
+**Use Case:**
+- Load `music.track` to see exactly where drums/bass/melody trigger
+- Align visual effect sequences with musical events
+- Verify timing matches tracker score before testing in demo
+
+**Effort:** 12-15 hours
+**Priority:** MEDIUM
+**Dependencies:** Requires `music.track` file format specification
+
+---
+
 ## Phase 3: Advanced Features (Low Priority)
 
 ### 3.1 Timeline Playback Indicator