Add user customization options (custom instructions & pronunciation) - #2
Merged
Conversation
Add optional config fields for user-specific customizations:
**Custom Instructions (paths.custom_instructions):**
- Load user's custom Claude workflow instructions at session start
- Defaults to {content_root}/CUSTOM_CLAUDE.md if not set
- Supplements (doesn't override) base CLAUDE.md
- Prevents plugin update conflicts for user preferences
**Custom Pronunciation Guide (paths.custom_pronunciation):**
- Load user's custom phonetic spellings at session start
- Defaults to {content_root}/CUSTOM_PRONUNCIATION.md if not set
- Merges with base pronunciation guide, custom takes precedence
- Prevents conflicts when plugin updates base guide
- pronunciation-specialist adds discoveries to custom guide
**Changes:**
- config/config.example.yaml: Add both fields with defaults
- config/README.md: Document both features with examples
- skills/configure/SKILL.md: Add setup prompts for both fields
- CLAUDE.md: Update session start to load custom files
Both features are optional and fail silently if files don't exist.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Update pronunciation-specialist skill to load and merge both base and custom pronunciation guides: **Changes:** - Add "Pronunciation Guides" section explaining base vs custom - Load base guide from /reference/suno/pronunciation-guide.md - Load custom guide from config (paths.custom_pronunciation) - Merge guides with custom entries taking precedence - Update "Adding Custom Pronunciations" to write to custom guide only - Never edit base guide (plugin updates will overwrite) **Behavior:** - If custom guide doesn't exist, continue with base guide only - Custom guide location read from config at invocation - Artist names, character names, album terms go to custom guide Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add explicit mandatory behavior for homograph detection and auto-fix: **New Section: "Homograph Detection & Auto-Fix (MANDATORY)"** - DO NOT ask user which pronunciation option - DO NOT offer to change lyric to avoid the word - Determine correct pronunciation from context - Apply phonetic spelling automatically - Add anti-pattern warning about offering choices - Include reference table of 8 common homographs with fixes **Changes:** - Update "Pronunciation Check" to link to mandatory auto-fix section - Add item 6 to "Remember" section about auto-fix behavior - Strengthen language: "AUTO-FIX REQUIRED" instead of "clarification" **Impact:** Prevents skill from asking "Option A or B?" for homographs. Always applies phonetic spelling based on context detection. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
3 tasks
This was referenced Apr 17, 2026
bitwize-music
added a commit
that referenced
this pull request
Apr 21, 2026
Fixes bugs #1, #2, #4 from the 2026-04-21 polish_and_master_album halt: - Auto-recovery path resamples to ctx.targets["output_sample_rate"] before writing + post-SRC limit_peaks guard (was writing at source rate, leaving 48 kHz files in a 96 kHz album). - fix_dynamic iterates up to 3 passes (-12/2.5 → -10/3.5 → -8/5.0) and emits converged: bool so callers know when material can't hit target LUFS at the current ceiling. - _stage_verification splits halt-eligible from unrecoverable cases; writes VERIFICATION_WARNINGS.md sidecar and status=warn on auto-recovery exhaustion instead of halting the pipeline. Docstring enumerates warn-fallback triggers and halt conditions. Plans B + C (per-track ADM ceiling + dark-track exclusion, post-master spectral regression guard) are follow-ups. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add three user customization features to prevent plugin update conflicts:
1. Custom Instructions Support
paths.custom_instructions{content_root}/CUSTOM_CLAUDE.md2. Custom Pronunciation Guide Support
paths.custom_pronunciation{content_root}/CUSTOM_PRONUNCIATION.md3. Mandatory Homograph Auto-Fix
Benefits
For users:
For plugin maintainers:
Changes
Config Files
config/config.example.yaml- Add custom_instructions and custom_pronunciation fieldsconfig/README.md- Document both features with setup examplesSkills
skills/configure/SKILL.md- Add setup prompts for both fieldsskills/pronunciation-specialist/SKILL.md- Load and merge dual guidesskills/lyric-reviewer/SKILL.md- Mandatory homograph auto-fix behaviorWorkflow
CLAUDE.md- Update session start to load custom files, document dual guide systemTesting
Migration
None required. Both features are:
Users can start using custom files whenever they want.
Closes: N/A (feature enhancement)