lyric-refiner

Your Task

Input: $ARGUMENTS

Parse Arguments

1. Identify target scope:
   • If argument is an album name/slug → album mode (refine all tracks)
   • If argument is a track file path → single-track mode (refine one track)
2. Parse pass count: Look for --passes N (default: 3, minimum: 1, maximum: 5)
   • If --passes > 5, warn: "Diminishing returns beyond 5 passes — capping at 5."

Instrumental Guard

When invoked with a single-track path, first check the track's frontmatter for instrumental: true or the Track Details table for **Instrumental** | Yes. If the track is instrumental:

• STOP and report: "This is an instrumental track — no lyrics to refine. Use /bitwize-music:suno-engineer for Style Box work."
• Do NOT attempt to refine instrumental tracks.