Chapter 20 · Tools
The Debug Room
When a generation fails, do not rewrite the whole prompt. Diagnose the starved axis, change one lever, run again. The failure table below covers 90% of bad outputs.
| Symptom | Starved axis / cause | The fix |
|---|---|---|
| Flat, midday-phone-photo look | LIGHT | Name direction, time and temperature: "low-angle golden backlight" or "single 2900K practical, underexposed one stop" |
| Clinical, AI-sharp, sterile | ATMOSPHERE | Add one haze layer: atmospheric haze, bloom on highlights, diffused air |
| Subject looks pasted on the background | DEPTH | State foreground / midground / background explicitly and set an aperture |
| Garish, oversaturated, cheap | GRADE | Name the palette, lift the blacks, desaturate, compress mids |
| Plastic skin, fake glow | TEXTURE | "True skin texture, organic grain, soft not plastic" plus the negatives block |
| Character's face drifts between shots | Identity pipeline skipped | Return to the Character Lab: face lock first, style strength down, identity strength max |
| Characters swap sides or wardrobe mid-shot | Missing Cross-Frame Rules / bad reference order | Lock screen sides and depth explicitly; verify the numbered reference order matches inline tags |
| Video ends on a mess | No Last Frame block | Define the exact closing composition; models drift toward their ending |
| Prompt is long but the output is generic | Density rule broken | Cut to 280 to 400 words; move the word budget to light; delete adjectives that name no cause |
| Luxury piece feels cold; documentary feels fake | Wrong mode | Re-run the mode decision; suspended rules exist for a reason |
| Two looks fighting in one frame | Profile blending | Aesthetic profiles are closed systems; pick one and remove the other's vocabulary entirely |
| Cannot tell which change helped | Multiple dials moved at once | Vary one slot at a time; keep a change log per generation |
| Conversation feels spatially confusing; gazes don't connect | 180-degree rule broken | Add the Cross-Frame Rules enforcement block; lock screen sides and gaze directions per character |
| Clips feel like five different films stitched together | Continuity engines skipped | Run the continuity checklist: vault assets, frame chaining, one light line, one lens register, single grade |
| Emotion jumps between cuts (calm to sobbing) | No emotion timeline | Write the scene's emotion arc; each shot inherits the last register and moves it one step |
The director's loopGenerate → judge against the DNA pillars of the chosen look → name the single weakest axis → adjust only that axis → regenerate. Four passes of this loop beat forty prompts of guessing.