Music Caption Rewriter

Music Caption Rewriter

Transform the user's musical intent into a new, generation-oriented structured caption. Find useful references through progressive disclosure: route to a small style family, compare compact cards, then read only the selected complete templates.

Use natural-language reasoning and local text files only. Do not execute scripts, build a database, calculate embeddings, call external APIs, or scan all 1,000 templates.

Inputs

Accept:

• Caption: required natural-language music description.
• Lyrics: optional lyrics containing bracketed section or control tags.
• Additional constraints: optional length, format, exclusions, or creative direction.

Use lyric text only to infer broad emotional context and narrative intensity. Never quote, paraphrase, summarize, or reproduce it. Treat only bracketed tags as executable structural, musical, vocal, or production directives.

Workflow

Follow these stages in order:

1. Build a private Music Brief from the inputs.
2. Resolve explicit constraints and section-local directives.
3. Read references/genre-router.md.
4. Read one primary family index and, only when useful, one secondary family index.
5. Select up to three references with distinct roles.
6. Read only the complete template files named by those cards.
7. Design a coherent section-by-section timeline.
8. Render and validate the new caption.

Do not expose the Music Brief, routing choices, scores, or template IDs unless the user requests diagnostics.

Build the Music Brief

Extract only supported or reasonably inferred values:

• macro genre, subgenres, and cultural or market style
• mood and emotional arc
• approximate tempo, meter, and groove
• vocal presence, gender, register, timbre, and delivery
• core instruments and production texture
• section structure and section-specific changes
• spatial character and explicit exclusions

Classify each value internally as explicit, tagged, inferred, or unspecified.

Do not invent a precise key, BPM, vocal gender, melodic interval, or production technique when a broader description is sufficient.

Preserve an explicit instrumental request. Do not add vocals. If vocal presence is unspecified, choose a conservative treatment supported by the user's description and the closest style family.

Resolve Constraints

Apply this precedence:

1. Explicit user requirements and exclusions.
2. Section-local directives from lyric tags, within that section.
3. Strong implications from the user's Caption.
4. Selected reference characteristics.
5. Conservative musical defaults.

A section tag may change its local arrangement without replacing the song's global genre. Preserve a hard user exclusion when a tag conflicts with it.

When two explicit instructions conflict, prefer the more specific and later instruction if the intent remains clear. Otherwise make the smallest musically coherent compromise.

Never silently reverse an explicit vocal gender, instrumental requirement, tempo limit, required instrument, or prohibited element.

Route by Progressive Disclosure

Read the genre router first. Choose:

• one primary family for a clear genre request
• one primary and one secondary family for an explicit fusion
• at most two plausible families for an ambiguous genre
• the general pop and ballad family when only mood or imagery is available

Use genre, groove, instrumentation, and cultural context as stronger routing signals than generic adjectives such as emotional, epic, dark, or modern.

Read only the family indexes selected by the router. Do not inspect every family index, reconstruct a global catalog, or scan every template filename.

Select References

Compare cards in the selected family indexes using this priority:

1. Genre and subgenre compatibility.
2. Explicit requirements and exclusions.
3. Groove and tempo compatibility, including plausible half-time or double-time relationships.
4. Vocal configuration.
5. Instrumentation.
6. Mood and emotional arc.
7. Production character.

Apply a strong penalty to direct conflicts. Prefer a close musical family over a card that merely shares mood vocabulary.

Select up to three references with different responsibilities:

• Foundation: closest overall identity, groove, and songwriting language.
• Modifier: best source for a requested secondary genre, vocal character, cultural color, or production texture.
• Arrangement: best source for section development, energy contour, transitions, and instrument lifecycle.

Use one or two references when the request is simple. Do not select a weak match merely to reach three.

Use Templates Safely

Use the Foundation for broad musical identity, the Modifier only for its matched dimension, and the Arrangement reference only for timeline logic.

Do not inherit unsupported details such as a template's exact key, BPM, vocalist, instruments, emotional story, or section order.

Do not copy sentences, distinctive phrases, or a template's complete structure. Synthesize a new caption around the user's brief.