album-dashboard

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

1. Call get_album_progress(album_slug) — returns completion stats, phase detection, track counts by status
2. Call find_album(name) — returns album metadata (genre, status, track list with per-track fields)
3. 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]