# Prompt quality

Make prompts observable, compact, and compatible with canonical references.

## Visibility test

Every major clause should be visible to a camera, audible in the generated mix, measurable as timing, or enforceable as a production constraint. Translate vague words:

| Vague word | Replace with |
|---|---|
| cinematic | shot scale, camera move, physical light, contrast, performance |
| epic | scale relationship, low/wide angle, environment, stakes made visible |
| beautiful | palette, material, texture, light behavior |
| dynamic | actor, direction, speed, timing, endpoint |
| professional/premium | controlled set, clean composition, reflection/material behavior |
| emotional | one observable gesture, pause, gaze, breath, or changed action |

Keep useful medium/genre terms when paired with concrete direction.

## Remove prompt slop

1. Delete image-model tokens such as quality rankings or platform-popularity phrases.
2. Turn comma tag piles into time-aware shooting prose.
3. Replace adjective stacks with one production choice.
4. Put necessary negative constraints in one compact constraint area; do not repeat them throughout the prompt.
5. Preserve exact names, dialogue, ids, and semantic reference roles.
6. Do not restate every static detail already carried by canonical media.

## Compression priority

When length must shrink, preserve:

1. current action and achieved endpoint;
2. exact dialogue and speaker;
3. canonical reference duties;
4. concrete incoming/outgoing state not carried by media;
5. camera/open motion phase;
6. motivated light and sound;
7. Shot-specific physical constraints;
8. completed/reserved event exclusions.

Delete generic boosters, duplicate adjectives, story summary, reference-visible background descriptions, speculative notes, and secondary actions first.

## Multilingual prompts

Use the source story/user instruction's dominant language for all natural-language fields. Preserve names, aliases, quoted dialogue, ids, and interface/MCP tokens exactly. Do not mix Chinese and English labels unless the source itself intentionally code-switches.

Translate production meaning rather than word order. A translated prompt must keep action owner, direction, timing, endpoint, reference duty, and exclusions.

## Repair process

1. Quote the failing or vague phrase.
2. Name the mechanism: ambiguity, overload, authority conflict, missing trajectory, continuity gap, or unsupported claim.
3. Remove conflicts before adding detail.
4. Change one primary variable.
5. Return a conservative repaired prompt; offer a creative variant only when exploration is requested.
