Your Task
Input: $ARGUMENTS (album name)
Generate a structured progress dashboard for the specified album.
Album Dashboard
You generate a comprehensive progress report for an album, showing completion percentage per workflow phase, blocking items, and a structured status breakdown.
Workflow Phases
Track completion across these phases:
| Phase | Complete When |
|---|---|
| 1. Concept | Album README has title, genre, tracklist defined |
| 2. Research | RESEARCH.md and SOURCES.md exist (if source-based) |
| 3. Source Verification | All tracks with sources have sources_verified: Verified or N/A |
| 4. Lyrics | All tracks have lyrics in their Lyrics Box |
| 5. Pronunciation | All pronunciation table entries applied in lyrics |
| 6. Review | Lyrics reviewed (no critical issues remain) |
| 7. Generation | All tracks have has_suno_link: true |
| 8. Mastering | Audio files exist in {audio_root}/artists/{artist}/albums/{genre}/{album}/ |
| 9. Release | Album status is "Released" |
Data Collection
From MCP Server
- Call
get_album_progress(album_slug)— returns completion stats, phase detection, track counts by status - Call
find_album(name)— returns album metadata (genre, status, track list with per-track fields) - Call
list_track_files(album_slug)— returns tracks with file paths for any additional checks
These three calls replace all manual state.json reads and file globbing.
Dashboard Format
ALBUM DASHBOARD =============== [Album Title] ([genre]) Status: [status] PROGRESS BY PHASE ───────────────── [============================ ] 90% Concept [============================ ] 90% Research [======================== ] 75% Source Verification [==================== ] 63% Lyrics Written [================ ] 50% Pronunciation [============ ] 38% Reviewed [======== ] 25% Generated [ ] 0% Mastered [ ] 0% Released OVERALL: ████████░░░░░░░░ 47% complete TRACK STATUS BREAKDOWN ────────────────────── | # | Track | Status | Suno | Sources | |---|-------|--------|------|---------| | 01 | Track One | Final | link | Verified | | 02 | Track Two | In Progress | — | Pending | | 03 | Track Three | Not Started | — | N/A | ... BLOCKING ITEMS ────────────── ! Track 02: Sources pending verification — blocks generation ! Track 05: No style prompt — blocks generation ! Track 07: Pronunciation table not applied — blocks generation SUMMARY ─────── Tracks: [X complete / Y total] Blocking: [N items] Next action: [recommendation]
Phase Completion Calculation
Concept Phase
- 100% if: Album README has title AND tracklist with actual track names (not template)
- 50% if: README exists but tracklist is template placeholder
- 0% if: No README
Research Phase (source-based albums only)
- 100% if: RESEARCH.md AND SOURCES.md both exist with content
- 50% if: Only one exists
- N/A if: Album is not source-based (no tracks have sources_verified field or all are N/A)
Source Verification Phase
- % = (tracks with Verified or N/A) / total tracks * 100
- Skip tracks where sources_verified is N/A for the denominator
Lyrics Phase
- % = (tracks with lyrics content) / total tracks * 100
Generation Phase
- % = (tracks with has_suno_link=true) / total tracks * 100
Mastering Phase
- Check
{audio_root}/artists/{artist}/albums/{genre}/{album}/for WAV/FLAC files - % = (audio files found) / total tracks * 100
Release Phase
- 100% if album status is "Released", 0% otherwise
Remember
- Visual progress bars — Use ASCII progress bars for quick scanning
- Highlight blockers — Blocking items are the most important info
- Include next action — End with a clear recommendation
- Be accurate — Count carefully, don't estimate
- Handle missing data gracefully — If audio_root doesn't exist, mastering is 0%
