feat: add /resume skill for album discovery and status reporting

Created dedicated /bitwize-music:resume skill to replace manual album
finding workflow. This skill provides a single command to find an album,
assess its current state, and report detailed status with next steps.

Features:
- Takes album name as argument: /bitwize-music:resume shell-no
- Reads config to get content_root and artist name
- Uses Glob to search all genre folders for album READMEs
- Case-insensitive matching with name variation handling
- Reads album README and all track files
- Determines current workflow phase (Planning, Writing, Generating, etc.)
- Reports detailed status: location, progress, what's done, next steps
- Lists available albums if target not found
- Suggests /bitwize-music:new-album if album doesn't exist

CLAUDE.md changes:
- Added CRITICAL section recommending /bitwize-music:resume as primary approach
- Updated "Resuming Work on an Album" to prioritize the skill
- Added resume skill to skills table (top position)
- Session Start tip now mentions resume skill

Benefits:
- Single command replaces complex manual Glob/Read workflow
- Consistent status reporting format
- Automatic phase detection
- User-friendly error handling (lists alternatives)
- Reduces cognitive load on Claude for album discovery

Character count: 36,878 (within target range)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: bitwize-music

CHANGELOG.md

@@ -7,8 +7,22 @@ This project uses [Conventional Commits](https://conventionalcommits.org/) and [
 ## [Unreleased]
 
 ### Added
+- `/bitwize-music:resume` skill - Dedicated skill for resuming work on albums
+  - Takes album name as argument
+  - Reads config to get paths
+  - Uses Glob to find album across all genre folders
+  - Reads album README and track files to assess status
+  - Determines current workflow phase (Planning, Writing, Generating, Mastering, etc.)
+  - Reports detailed status: location, progress, what's done, next steps
+  - Lists available albums if target album not found
+  - Handles case-insensitive matching and album name variations
+  - Usage: `/bitwize-music:resume shell-no`
 
 ### Changed
+- CLAUDE.md "Finding Albums" section now recommends `/bitwize-music:resume` skill as the primary approach
+- "Resuming Work on an Album" section updated to prioritize the resume skill
+- Skills table: Added `/bitwize-music:resume` at the top
+- Session Start tip now mentions `/bitwize-music:resume <album-name>` instead of tutorial resume
 
 ### Fixed
 

CLAUDE.md

@@ -4,6 +4,51 @@
 
 This is an AI music generation workflow using Suno. The repository contains skills, templates, and tools for creating artist profiles, album concepts, and track-by-track prompts/lyrics.
 
+---
+
+## ⚠️ CRITICAL: Finding Albums When User Mentions Them
+
+**WHENEVER the user mentions an album name** (e.g., "let's work on shell-no", "continue with X", "I want to work on Y"):
+
+**BEST APPROACH - Use the resume skill:**
+```
+/bitwize-music:resume shell-no
+```
+This automatically handles all the steps below and provides a detailed status report.
+
+**OR - Manual approach if skill unavailable:**
+
+**DO THIS FIRST - MANDATORY STEPS:**
+
+1. **Read config file**: `~/.bitwize-music/config.yaml`
+   - Get `paths.content_root`
+   - Get `artist.name`
+
+2. **Use Glob to find album**:
+   ```
+   Pattern: {content_root}/artists/{artist}/albums/*/*/README.md
+   ```
+   This searches ALL genre folders for album READMEs.
+
+3. **Filter results** for album name (case-insensitive match in file path)
+
+4. **Read the album README** to get current status
+
+5. **Report to user**: Found album at [path], status is [X], here's what's next...
+
+**COMMON MISTAKE - DO NOT DO THIS:**
+- ❌ Don't search from current working directory
+- ❌ Don't use complex glob patterns like `**/*[Aa]lbum*/**`
+- ❌ Don't assume the path - always read config first
+- ❌ Don't use `ls` or `find` commands
+
+**CORRECT APPROACH:**
+- ✅ Read `~/.bitwize-music/config.yaml` FIRST
+- ✅ Use simple glob: `{content_root}/artists/{artist}/albums/*/*/README.md`
+- ✅ Let Glob tool handle the searching
+
+---
+
 ## Configuration
 
 Configuration lives at `~/.bitwize-music/config.yaml` (outside the plugin directory).
@@ -201,37 +246,41 @@ At the beginning of a fresh session:
 
 **Present status summary** to user, ask what to work on.
 
-**Tip**: Users can also run `/bitwize-music:tutorial resume` for an interactive guide to their in-progress work.
+**Tip**: Users can run `/bitwize-music:resume <album-name>` to resume work on a specific album with a detailed status report.
 
 ## Resuming Work on an Album
 
 **Trigger**: User says "let's work on [album]" or "continue with [album]" or mentions an album name
 
-**Required steps (do these EVERY time):**
+**RECOMMENDED: Use `/bitwize-music:resume` skill**
 
-1. **Read config** - Get `content_root` and `artist.name` from `~/.bitwize-music/config.yaml`
-2. **Find the album** - Use Glob to search for album README:
-   ```
-   Pattern: {content_root}/artists/{artist}/albums/*/*/README.md
-   Then grep results for album name (case-insensitive)
-   ```
-3. **Read album README** - Get full path, read it to understand:
-   - Album status, track count, concept
-   - Which phase of workflow (planning, writing, generating, mastering, release)
-4. **Read track files** - Glob for `tracks/*.md`, read to check:
-   - Track statuses (Not Started, In Progress, Generated, Final)
-   - What needs to be done next
-5. **Report current state** - Tell user:
-   - Album location (full path)
-   - Current status and phase
-   - What's completed, what's next
-   - Specific next actions
+Invoke the resume skill with the album name:
+```
+/bitwize-music:resume shell-no
+```
+
+The skill automatically:
+- Reads config to get paths
+- Finds the album using Glob
+- Checks album and track statuses
+- Determines current workflow phase
+- Reports detailed status and next steps
+
+See `/skills/resume/SKILL.md` for full documentation.
+
+**If skill not available - Manual steps:**
+
+1. Read config: `~/.bitwize-music/config.yaml`
+2. Glob for album: `{content_root}/artists/{artist}/albums/*/*/README.md`
+3. Filter results for album name (case-insensitive)
+4. Read album README and track files
+5. Report status and next actions
 
 **Common mistakes to avoid:**
-- ❌ Don't assume the album path - always search for it
-- ❌ Don't guess the genre folder - use Glob to find it
-- ❌ Don't rely on memory - read config and files fresh every time
-- ✅ Always use Glob + Read to locate albums by name
+- ❌ Don't assume paths - always read config first
+- ❌ Don't search from current directory - use config paths
+- ❌ Don't use complex globs - keep it simple
+- ✅ Use `/bitwize-music:resume` skill whenever possible
 
 ## Mid-Session Workflow Updates
 
@@ -326,6 +375,7 @@ Specialized skills are available as slash commands. Type `/` to see the menu.
 
 | Skill | When to Use |
 |-------|-------------|
+| `/bitwize-music:resume` | Find an album and resume work where you left off - shows status and next steps |
 | `/bitwize-music:tutorial` | Interactive guided album creation, session resume, getting started |
 | `/bitwize-music:album-ideas` | Track and manage album ideas - brainstorming, planning, status tracking |
 | `/bitwize-music:lyric-writer` | Writing/reviewing lyrics, fixing prosody issues |

skills/resume/SKILL.md

@@ -0,0 +1,239 @@
+# Resume Album Work
+
+**Purpose**: Find an album and resume work where you left off.
+
+**Usage**:
+```
+/bitwize-music:resume <album-name>
+/bitwize-music:resume shell-no
+/bitwize-music:resume "shell no"
+```
+
+**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 Configuration
+
+Read `~/.bitwize-music/config.yaml` to get:
+- `paths.content_root` - Where album files live
+- `artist.name` - Artist name for path construction
+
+If config missing, tell user to run `/bitwize-music:configure` first.
+
+### Step 2: Find the Album
+
+Use Glob to search for album README files:
+
+```
+Pattern: {content_root}/artists/{artist}/albums/*/*/README.md
+```
+
+This searches all genre folders for album READMEs.
+
+**Filter the results**:
+- Look for album name in the file path (case-insensitive)
+- Match variations: "shell-no", "shell_no", "shell no" should all match
+
+**If no matches found**:
+- Tell user: "Album '[name]' not found"
+- List available albums (all READMEs found)
+- 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: Read Album Status
+
+Once album is located, read the README to determine:
+- **Album status**: Concept, In Progress, Complete, Released
+- **Track count**: How many tracks total
+- **Tracklist**: Track titles and order
+
+### Step 4: Check Track Status
+
+Glob for track files in the album's tracks directory:
+
+```
+Pattern: {album_path}/tracks/*.md
+```
+
+Read each track file to check:
+- **Status field**: Not Started, Sources Pending, Verified, In Progress, Generated, Final
+- **Suno Link**: Present or missing
+- **Lyrics**: Complete or incomplete
+
+Count tracks by status:
+- Not Started: X tracks
+- In Progress: Y tracks
+- Generated: Z tracks
+- Final: N tracks
+
+### Step 5: Determine Current Phase
+
+Based on album and track statuses, identify the workflow phase:
+
+| Album Status | Track Statuses | Current Phase |
+|--------------|----------------|---------------|
+| Concept | Most "Not Started" | Planning - Need to fill in album README and create tracks |
+| In Progress | Mixed, some "Not Started" | Writing - Need to complete lyrics |
+| In Progress | Some "Sources Pending" | Verification - Need human verification of sources |
+| In Progress | All have lyrics | Ready to Generate - Run Ready to Generate checkpoint |
+| In Progress | Some "Generated" | Generating - Continue generating on Suno |
+| Complete | All "Final" | Mastering - Ready to master audio |
+| Released | All "Final" | Released - Album is live |
+
+### Step 6: 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 7: 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 shell-no
+
+📁 Album: Shell No
+   Location: ~/bitwize-music/artists/bitwize/albums/electronic/shell-no/
+   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 shell-no
+
+📁 Album: Shell No
+   Location: ~/bitwize-music/artists/bitwize/albums/electronic/shell-no/
+   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:
+- shell-no (electronic) - In Progress
+- linux-legends (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.