name: resume
description: Find an album and resume work where you left off
argument-hint:
model: claude-sonnet-4-5-20250929
allowed-tools:
- Read
- Glob
- Bash

Resume Album Work

Purpose: Find an album and resume work where you left off.

Usage:

/bitwize-music:resume <album-name>
/bitwize-music:resume my-album
/bitwize-music:resume "demo album"

When to use: When user wants to continue working on an existing album.

Instructions

When this skill is invoked with an album name:

Step 1: Read State Cache

Read ~/.bitwize-music/cache/state.json to get album and track data.

If state.json is missing or corrupted:
- Run: python3 {plugin_root}/tools/state/indexer.py rebuild
- Then read the newly created state.json

If state.json exists: Use it directly (much faster than scanning files).

Step 2: Find the Album

Search state.albums keys for the album name:
- Case-insensitive match
- Match variations: "shell-no", "shell_no", "shell no" should all match the same slug

If no matches found:
- Tell user: "Album '[name]' not found"
- List available albums from state.albums (slug, genre, status)
- Suggest: "Did you mean one of these?" or "Use /bitwize-music:new-album to create it"

If multiple matches found:
- List all matches with full paths
- Ask user which one they want

Step 3: Extract Album and Track Data

From the matched album entry in state.albums, extract:
- Album status: from album.status
- Track count: from album.track_count
- Tracks completed: from album.tracks_completed
- Track details: from album.tracks — each track has status, has_suno_link, sources_verified

Count tracks by status from album.tracks:
- Not Started: X tracks
- In Progress: Y tracks
- Generated: Z tracks
- Final: N tracks

Step 4: Staleness Check (Optional)

Spot-check one track file's mtime against track.mtime in state. If stale:
- Run python3 {plugin_root}/tools/state/indexer.py update
- Re-read state.json

Step 5: Update Session Context

After finding the album, update session context using the CLI command:

python3 {plugin_root}/tools/state/indexer.py session --album <album-slug> --phase <phase>

Optional flags:
- --track <track-slug> — set last track worked on
- --add-action "description" — append a pending action
- --clear — clear session data before applying new values

Step 6: Determine Current Phase

Based on album and track statuses, identify the workflow phase:

Step 7: Report to User

Present a clear status report:

📁 Album: [Album Title]
   Location: {content_root}/artists/{artist}/albums/{genre}/{album}/
   Status: [Album Status]

📊 Progress:
   - Tracks: [X completed / Y total]
   - Not Started: X
   - In Progress: Y
   - Generated: Z
   - Final: N

📍 Current Phase: [Phase Name]

✅ What's Done:
   - [List completed items]

⏭️ Next Steps:
   1. [Specific action 1]
   2. [Specific action 2]
   3. [Specific action 3]

Ready to continue? Tell me what you'd like to work on.

Step 8: Offer Specific Next Actions

Based on the phase, suggest concrete next steps:

Planning Phase:
- "Let's fill in the album concept and tracklist"
- "Run the 7 Planning Phases to finalize details"

Writing Phase:
- "Which track should we write next?"
- "Track X needs lyrics - shall we work on that?"

Verification Phase:
- "Tracks X, Y, Z need source verification"
- "Please review and verify sources before we proceed"

Ready to Generate Phase:
- "All lyrics complete! Ready to generate on Suno?"
- "Shall I run the Ready to Generate checkpoint?"

Generating Phase:
- "Tracks X, Y need generation on Suno"
- "Have you generated any new tracks? Let me know URLs to log"

Mastering Phase:
- "All tracks generated! Ready to master?"
- "Do you have WAV files downloaded from Suno?"

Examples

Example 1: Album in Writing Phase

/bitwize-music:resume my-album

📁 Album: My Album
   Location: ~/bitwize-music/artists/bitwize/albums/rock/my-album/
   Status: In Progress

📊 Progress:
   - Tracks: 3 completed / 8 total
   - Not Started: 3
   - In Progress: 2
   - Final: 3

📍 Current Phase: Writing Lyrics

✅ What's Done:
   - Tracks 1-3 have final lyrics
   - Album concept and tracklist defined

⏭️ Next Steps:
   1. Complete lyrics for Track 4 (in progress)
   2. Complete lyrics for Track 5 (in progress)
   3. Write lyrics for Tracks 6-8

Ready to continue? Tell me which track you'd like to work on.

Example 2: Album Ready for Generation

/bitwize-music:resume demo-album

📁 Album: Demo Album
   Location: ~/bitwize-music/artists/bitwize/albums/electronic/demo-album/
   Status: In Progress

📊 Progress:
   - Tracks: 8 / 8 total (all lyrics complete)
   - Final: 8

📍 Current Phase: Ready to Generate

✅ What's Done:
   - All 8 tracks have complete lyrics
   - All lyrics phonetically reviewed
   - Suno Style and Lyrics boxes filled

⏭️ Next Steps:
   1. Run Ready to Generate checkpoint (I'll verify everything)
   2. Start generating on Suno
   3. Log generation attempts

Shall I run the Ready to Generate checkpoint now?

Example 3: Album Not Found

/bitwize-music:resume my-album

❌ Album 'my-album' not found.

Available albums:
- demo-album (electronic) - In Progress
- example-tracks (hip-hop) - Complete

Did you mean one of these? Or use /bitwize-music:new-album to create a new album.

Implementation Notes

• Always read config first - Never assume paths
• Use Glob tool - Don't use bash find/ls
• Case-insensitive matching - "Shell-No" should match "shell-no"
• Handle missing albums gracefully - List what exists, don't error
• Be specific about next steps - Don't just say "continue working", say exactly what to do
• Include full paths - User needs to know where files are located
• Use emojis sparingly - Only for section headers in the report

Model

Use Sonnet 4.5 - This is a coordination/reporting task, not creative work.