Merge pull request #230 from bitwize-music-studio/develop

Release 0.89.0

Author: bitwize-music

.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     {
       "name": "bitwize-music",
       "description": "AI music generation workflow for Suno - album concepts, lyrics, prompts, mastering, release",
-      "version": "0.88.0",
+      "version": "0.89.0",
       "source": "./"
     }
   ]

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "bitwize-music",
   "description": "AI music generation workflow for Suno - album concepts, lyrics, prompts, mastering, release",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "author": {
     "name": "bitwize-music"
   },

CHANGELOG.md

@@ -6,6 +6,18 @@ This project uses [Conventional Commits](https://conventionalcommits.org/) and [
 
 ## [Unreleased]
 
+## [0.89.0] - 2026-04-10
+
+### Added
+- **Lyric-refiner skill** — multi-pass lyric refinement for post-writing polish
+- **Tango genre** — Argentine-Uruguayan dance and song tradition covering Golden Age orquestas, tango canción, nuevo tango (Piazzolla), and electrotango; includes mastering presets for bandoneón-centric dynamics
+
+### Fixed
+- Updated Opus 4.5 references to Opus 4.6 in model-strategy.md
+- Updated Sonnet 4.5 references to Sonnet 4.6 in model-strategy.md
+- Fixed README skill count (51 → 52)
+- Fixed lyric-refiner skill missing required section heading
+
 ## [0.88.0] - 2026-04-08
 
 ### Added

CLAUDE.md

@@ -131,7 +131,7 @@ At the beginning of a fresh session:
 
 ## Workflow Overview
 
-Concept → Research → Write (+Suno Prompt) → QC/Verify → Generate → [Polish] → Master → Promo Videos (optional) → Promo Copy (optional) → **Release**
+Concept → Research → Write (+Suno Prompt) → [Refine] → QC/Verify → Generate → [Polish] → Master → Promo Videos (optional) → Promo Copy (optional) → **Release**
 
 **Critical**: Research must complete before writing for source-based content. Human source verification is required before generation — never skip this gate.
 
@@ -140,6 +140,7 @@ Concept → Research → Write (+Suno Prompt) → QC/Verify → Generate → [Po
 - **Album mentioned** → `/bitwize-music:resume`
 - **"Make a new album"** → IMMEDIATELY use `/bitwize-music:new-album` BEFORE any discussion
 - **Writing lyrics** → apply `/bitwize-music:lyric-writer` expertise (auto-invokes suno-engineer)
+- **Refining/polishing lyrics** → `/bitwize-music:lyric-refiner` (post-writing multi-pass refinement)
 - **Planning album** → apply `/bitwize-music:album-conceptualizer` (7 planning phases required)
 - **Suno prompts** → apply `/bitwize-music:suno-engineer` expertise (usually auto-invoked by lyric-writer; use directly only for re-prompting)
 - **Research needed** → apply `/bitwize-music:researcher` standards

README.md

@@ -54,7 +54,7 @@ Then run `/bitwize-music:setup` to detect your environment and install dependenc
 
 This is where the engineering lives. The plugin is a case study in how far you can push Claude Code's plugin system.
 
-### Skill System (51 Skills)
+### Skill System (52 Skills)
 
 Each skill is a self-contained markdown file with a YAML frontmatter that declares its model, description, and when it should activate. Skills range from simple clipboard operations to multi-step creative workflows. Claude routes to skills automatically based on context, or you invoke them directly with `/bitwize-music:<name>`.
 

genres/INDEX.md

@@ -31,6 +31,7 @@ Quick-reference guide for finding the right skill for any task.
 | I need to... | Use this skill |
 |--------------|----------------|
 | ...write lyrics for a track | `/lyric-writer` |
+| ...refine/polish lyrics after writing | `/lyric-refiner` |
 | ...check lyrics for pronunciation risks | `/pronunciation-specialist` |
 | ...run full QC before Suno generation | `/lyric-reviewer` |
 | ...run final pre-generation checkpoint | `/pre-generation-check` |
@@ -122,6 +123,7 @@ Quick-reference guide for finding the right skill for any task.
 | [`import-art`](/skills/import-art/SKILL.md) | Place album art in audio and content locations | Copying artwork to correct paths after creation |
 | [`import-audio`](/skills/import-audio/SKILL.md) | Move audio files to correct album location | Importing WAV files from Suno downloads |
 | [`import-track`](/skills/import-track/SKILL.md) | Move track .md files to correct album location | Importing track files from external sources |
+| [`lyric-refiner`](/skills/lyric-refiner/SKILL.md) | Multi-pass lyric refinement for tightening, cohesion, and album unity | Polishing lyrics after writing, before QC |
 | [`lyric-reviewer`](/skills/lyric-reviewer/SKILL.md) | QC gate before Suno generation (14-point checklist) | Final quality check before generating |
 | [`lyric-writer`](/skills/lyric-writer/SKILL.md) | Write or review lyrics with prosody and rhyme craft | Writing new lyrics or fixing existing ones |
 | [`mastering-engineer`](/skills/mastering-engineer/SKILL.md) | Audio mastering guidance, loudness optimization | Mastering tracks to -14 LUFS for streaming |
@@ -169,6 +171,7 @@ What to have ready before using each skill:
 | `/album-conceptualizer` | Album name and genre decided |
 | `/lyric-writer` | Track concept defined, sources captured (if documentary) |
 | `/pronunciation-specialist` | Lyrics written |
+| `/lyric-refiner` | Lyrics written (runs after lyric-writer, before QC) |
 | `/lyric-reviewer` | Lyrics complete, pronunciation checked |
 | `/voice-checker` | Lyrics written, lyric-reviewer passed |
 | `/pre-generation-check` | Lyrics written, pronunciation resolved, style prompt created (instrumental: only Style Box needed) |
@@ -194,6 +197,7 @@ What to have ready before using each skill:
 /new-album <name> <genre>
     -> /album-conceptualizer (plan concept, tracklist)
     -> /lyric-writer (for each track — auto-invokes /suno-engineer)
+    -> /lyric-refiner (optional: multi-pass refinement for tightening + album cohesion)
     -> /pronunciation-specialist (scan for risks)
     -> /lyric-reviewer (final QC)
     -> /voice-checker (advisory: flag AI-sounding patterns)
@@ -215,6 +219,7 @@ What to have ready before using each skill:
         -> /researchers-verifier (verify citations)
     -> /verify-sources (human source verification)
     -> /lyric-writer (write lyrics from sources — auto-invokes /suno-engineer)
+    -> /lyric-refiner (optional: multi-pass refinement for tightening + album cohesion)
     -> /pronunciation-specialist (names, places, acronyms)
     -> /lyric-reviewer (verify against sources)
     -> /pre-generation-check (validate all gates)
@@ -300,6 +305,7 @@ Natural pairings that complement each other:
 
 | Primary Skill | Pairs Well With | Why |
 |---------------|-----------------|-----|
+| `/lyric-writer` | `/lyric-refiner` | Refine after writing, before QC |
 | `/lyric-writer` | `/pronunciation-specialist` | Catch pronunciation issues immediately |
 | `/pronunciation-specialist` | `/lyric-reviewer` | Reviewer verifies pronunciation fixes applied correctly |
 | `/lyric-reviewer` | `/voice-checker` | Reviewer catches craft issues, voice-checker catches authenticity issues |
@@ -326,6 +332,7 @@ Redundant or conflicting combinations:
 | Avoid Combining | Reason |
 |-----------------|--------|
 | `/lyric-writer` + `/lyric-reviewer` (simultaneously) | Run separately: writer first, reviewer after pronunciation pass |
+| `/lyric-writer` + `/lyric-refiner` (simultaneously) | Run refiner after writer completes — refiner is a post-writing tool |
 | Multiple researcher specialists at once | Use `/researcher` to coordinate them instead |
 | `/mastering-engineer` before audio import | Need to generate on Suno and import audio first |
 | `/release-director` before `/mastering-engineer` | Audio must be mastered before release |
@@ -337,8 +344,9 @@ Redundant or conflicting combinations:
 
 Skills are assigned to models based on task complexity. See [model-strategy.md](model-strategy.md) for full rationale.
 
-### Opus 4.6 (Critical Creative Work — 6 skills)
+### Opus 4.6 (Critical Creative Work — 7 skills)
 - `/lyric-writer` - Core creative content
+- `/lyric-refiner` - Multi-pass lyric refinement and album cohesion
 - `/suno-engineer` - Music generation prompts
 - `/album-conceptualizer` - Album concept shapes everything downstream
 - `/lyric-reviewer` - QC gate before generation, must catch all issues

genres/tango/README.md

@@ -6,13 +6,13 @@ This document explains the rationale for which Claude model is assigned to each
 
 | Model | Strengths | Cost | When to Use |
 |-------|-----------|------|-------------|
-| **Opus 4.5** | Highest creative quality, nuanced judgment, complex synthesis | ~15x | Output directly impacts music quality; errors are costly |
-| **Sonnet 4.5** | Strong reasoning, good creativity, reliable coordination | ~5x | Most tasks; balance of capability and efficiency |
+| **Opus 4.6** | Highest creative quality, nuanced judgment, complex synthesis | ~15x | Output directly impacts music quality; errors are costly |
+| **Sonnet 4.6** | Strong reasoning, good creativity, reliable coordination | ~5x | Most tasks; balance of capability and efficiency |
 | **Haiku 4.5** | Fastest, pattern matching, rule-following | 1x | Simple operations; binary decisions; no judgment needed |
 
 ---
 
-## Opus 4.5 Skills (6 skills)
+## Opus 4.6 Skills (7 skills)
 
 These skills directly impact music quality or have high error costs.
 
@@ -44,6 +44,16 @@ Bad style prompts = bad music. Every regeneration costs time. Getting it right t
 
 A weak concept produces a weak album. Spending Opus here prevents wasted effort on a fundamentally flawed foundation.
 
+### lyric-refiner
+**Why Opus**: Multi-pass refinement requires the same creative depth as writing. This skill must:
+- Make nuanced judgment calls about what to tighten vs. preserve
+- Evaluate cross-track cohesion across an entire album's lyrics
+- Identify subtle vocabulary drift and tonal inconsistencies
+- Add callback phrases that feel organic, not forced
+- Balance competing concerns (tightening vs. preserving voice, cohesion vs. distinctiveness)
+
+Refinement is surgical — a weaker model might over-tighten, break voice consistency, or miss cohesion opportunities. The stakes are the same as writing: bad refinement degrades good lyrics.
+
 ### lyric-reviewer
 **Why Opus**: This is the quality gate before Suno generation. If issues slip through, they become embedded in the music. This skill requires:
 - Catching subtle prosody problems
@@ -73,7 +83,7 @@ If the verifier misses something, errors reach the human reviewer or the public.
 
 ---
 
-## Sonnet 4.5 Skills (30 skills)
+## Sonnet 4.6 Skills (30 skills)
 
 These skills require reasoning and moderate creativity but follow established patterns.
 
@@ -242,8 +252,8 @@ Is it purely pattern matching, file operations, or static info?
 
 | Tier | Count | Percentage | Purpose |
 |------|-------|------------|---------|
-| Opus 4.5 | 6 | 11.8% | Music-defining output, high error cost |
-| Sonnet 4.5 | 30 | 58.8% | Reasoning, coordination, moderate creativity |
+| Opus 4.6 | 7 | 13.2% | Music-defining output, high error cost |
+| Sonnet 4.6 | 30 | 58.8% | Reasoning, coordination, moderate creativity |
 | Haiku 4.5 | 15 | 29.4% | Rule-based operations, no judgment |
 
 The plugin reserves Opus for skills where quality directly impacts the music or where errors have significant consequences. Most work happens at Sonnet tier. Haiku handles mechanical operations where speed matters more than nuance.

reference/SKILL_INDEX.md

@@ -10,7 +10,7 @@
 # =============================================================================
 # MCP SERVER (required for plugin core functionality)
 # =============================================================================
-mcp[cli]==1.26.0
+mcp[cli]==1.27.0
 pyyaml==6.0.3
 
 # =============================================================================
@@ -43,7 +43,7 @@ reportlab==4.4.10
 # =============================================================================
 # CLOUD UPLOADS (required for /bitwize-music:cloud-uploader)
 # =============================================================================
-boto3==1.42.81
+boto3==1.42.85
 
 # =============================================================================
 # DATABASE (required for db_* MCP tools - tweet/promo management)