skills/ai-film-pipeline-master/references/phase-01-story-generation/symptoms-theme.md

# Theme complaints

Part of the symptom router. Open this file when the complaint is about theme. Each complaint below is followed by the cards that repair it, best first; `LOOKUP.md` says which file holds each card.

---

### "It doesn't add up to anything"

1. Write the controlling idea: a value and the cause that delivers it
   `theme.controlling_idea` · `theme.subject_mistaken_for_theme`
2. Then audit every scene against it — advances, tests, contradicts, or nothing
   `theme.thematic_audit` · `theme.thematic_value`
3. Protect the scenes that contradict. A story that never contradicts its own claim is propaganda
   `theme.thematic_audit`

### "The story is doing three things and none of them land"

**Separate the two questions before doing anything, because they are constantly blurred.** A controlling idea is what the work **argues** — a value plus a cause, provable against the plot and checkable scene by scene. An effect is what the work **does to the reader**: the state they are left holding when they look up, which no scene can be audited against because it lives in the reading rather than in the story. A piece can prove its controlling idea perfectly and leave the reader holding nothing.

1. If what is missing is the argument, that is the complaint above
   `theme.controlling_idea` · `theme.thematic_audit`
2. If what is missing is accumulation, name the effect in one word before you draft — dread, complicity, relief, shame, wonder — write the word at the top of the page, and test every element against it
   `struct.unity_of_effect`
3. Anything that pushes neither toward the word nor away from it is the thing to cut, and in a first draft it is usually the second-best idea in the piece
   `expo.deletion_test`
4. Run the two passes separately. The audit asks *does this scene advance the claim*; the effect pass asks *does this sentence deepen the state*
5. Test the effect on a reader an hour later, by asking what state they were in rather than what happened. Mood is what the reading feels like while it happens; the effect is the residue
6. And where it actually lands
   `end.held_final_beat`
7. Three limits. The doctrine's own length clause disqualifies anything too long to be read at one sitting, so applying it to a novel produces a thin book with the variety starved out of it. It under-rates the piece that changes register on purpose, which is a second instrument rather than a failure of unity. And it is not uniformity of tone — a piece with no contrast has flattened under the doctrine rather than achieved it
8. The upstream brand version is a third thing again, written to brief agencies rather than to be felt
   `theme.organising_idea`
9. If you genuinely have two arguments rather than one argument and one effect, demote one
   `theme.competing_themes`

### "It's preachy"

1. Check whether you have a theme or a moral — the difference is descriptive versus prescriptive
   `theme.descriptive_not_prescriptive` · `theme.explained_theme`
2. The real cause is almost never the dialogue: it is the missing opponent
   `theme.anti_theme` · `theme.rigged_argument`
3. Apply the claim to your own protagonist at cost
   `theme.test_on_protagonist` · `theme.applied_only_to_others`
4. Start from a question you cannot answer
   `theme.start_from_a_question` · `theme.decided_before_story`
5. The whole-work form of the same defect is a trial with no defence. Mark every scene *advances*, *tests*, *contradicts* or *nothing*; a work with no scene marked *contradicts* is this, whatever its politics and whatever you intended
   `theme.propaganda` · `theme.thematic_audit`

### "The ending satisfies only half the work"

1. You are running two arguments
   `theme.competing_themes`
2. Choose the one the ending actually proves and demote the other

### "The symbolism is heavy-handed"

1. An object with no practical use announces the writer
   `theme.symbol_without_function` · `theme.object_carrier`
2. A motif returns in a scene doing other business, never in a scene that exists for it
   `theme.thematic_motif`

### "I need the theme carried without saying it"

`theme.stated_rejected` · `theme.argument_scene` · `theme.moral_test` · `theme.theme_in_structure` · `theme.through_the_ensemble` · `theme.theme_and_genre` · `theme.title_as_statement` · `theme.theme_in_nonfiction`

Four carriers do most of the work, and each of them argues without a line of thematic dialogue. **Structural irony:** give the character exactly what they wanted, on the story's own terms, and let the audience price it — `theme.irony_as_argument` · `scene.granted_wish`. **The arc as verdict:** each arc delivers a different ruling on the same truth, so read the arc off the claim rather than choosing it — `theme.arc_carries_claim`. **A counter-example:** someone close to the protagonist who faces the same question and answers it the other way, with their outcome shown — `theme.counter_example_character` · `arc.mirror_character`. **The pattern of the unsaid:** three scenes burying different facts for the same underlying reason state a theme nobody has spoken — `sub.theme_rides`.

### "The comedy is funny and it isn't about anything"

1. In comedy the argument is carried by the premise — the one wrong rule the world runs on — not by any character's position. Write it as a rule, not a setting: *in this office, the person who does the least is the hardest to fire*
   `theme.comic_premise_argument`
2. Nobody in the world may notice the rule is absurd. The moment one character says so, the comedy becomes commentary
   `comedy.airtight_wrong_logic`
3. Know how long the rule can keep arguing before it runs out
   `comedy.premise_shelf_life`

### "The satire is landing and costing nobody anything"

1. The named failure. The diagnostic is brutal: name the person in your audience who is implicated by the piece. If there isn't one, you have written a rally
   `theme.satire_that_flatters`
2. Write two sentences before a line of it — *the target is X*, and *the claim is that X does Y because Z*. If the second will not come, you have mockery. The strongest claims are mechanical rather than moral, because a mechanism can be dramatised
   `theme.satire_claim` · `comedy.satire_target`
3. Then check the direction: gentle mockery of something genuinely harmful reads as complicity, and fury at something merely silly reads as self-importance
   `comedy.punch_direction`

### "My horror film doesn't mean anything"

1. Design the threat outward from the fear, in that order — name the fear, then the method, then the appearance last. A creature designed from a picture has its meaning retrofitted, and the retrofit is always visible
   `theme.monster_meaning`
2. The rules carry the claim, not the look: what it wants, what it will not do, what stops it, and what escaping costs
   `anta.monster_rules`
3. Never explain the correspondence. An explained monster is a stated theme with fangs
   `theme.explained_theme` · `anta.overexplained_monster`
4. And decide what the survival means, which is where the claim is actually paid
   `end.horror_coda` · `emo.horror_aftermath`

### "The claim would be a lecture if I said it straight"

1. Let a literal threat carry the real subject — the pod that replaces you, the house that will not let you leave. The audience processes an argument as plot and defends the reading as their own
   `sub.genre_vehicle`
2. Write the surface story as if the second system were irrelevant, finish it, and only then check the mapping. Keep the correspondence loose: rhyme with the second system rather than transcribing it
   `theme.allegory_build`
3. No character ever names the referent
   `sub.subtext_announced`
4. The durability test is that a good vehicle survives a change of reading
   `theme.theme_and_genre`

### "The allegory is a puzzle with one answer"

1. The named failure: one click of recognition and then nothing, and every element that does not map reads as an error rather than as life
   `theme.keyed_allegory`
2. The repair is deliberate slack — two or three significant elements with no counterpart, one character mapping to two real people, and a surface story worth watching by someone who has never heard of the referents
   `theme.allegory_build`

### "My kids' story has a moral bolted on the end"

1. The named failure, and the diagnostic is one move: delete the last page. If nothing is lost, the moral was stapled on; if the story now has no ending, it was structural
   `theme.tacked_on_moral`
2. Either build the claim into the situation from page one, stated in behaviour a child can copy rather than in an abstraction
   `theme.preschool_claim`
3. Or let the character visibly realise it and act on it while nobody says what was realised — the child completes the sentence, which is how these stories teach at all. Give the realisation a physical beat to land on
   `theme.realisation_not_lesson`
4. The one form where a stated moral is correct is the form that promised one, and there the moral must be *smaller* than the story
   `theme.fable_contract`

### "The client wants a film about their values"

1. Ask what the company did about this cause in a year when it was not advertising. A donation figure is thin; an internal policy with a date is a real claim. Run that in the intake meeting, not in the edit
   `theme.purpose_washing`
2. Upstream of any campaign, find the one sentence every piece of their output argues — big enough to last five years, simple enough to repeat without the deck, different enough that a competitor could not sign it, and true enough that their own behaviour already supports it
   `theme.organising_idea` · `voice.brand_voice_intake`
3. Then write the claim the film makes about the *viewer's* life beside the claim it makes about the product. The leaked one is the part they remember and resent
   `theme.implicit_ad_claim`

### "The documentary makes its case and I don't believe it"

1. Build in the strongest material that undercuts the claim, and place it *before* the conclusion so the conclusion is reached through it rather than around it. Twenty seconds in the last act is decoration
   `theme.contradicting_material`
2. If no scene in the work contradicts it, that is the structural definition of the failure — and the audience's own verdict is useless as a diagnostic, because they call it propaganda when they dislike the claim and craft when they share it
   `theme.propaganda` · `theme.thematic_audit`
3. Let two sources disagree and show the work of deciding between them
   `info.contradictory_sources`
4. But manufactured balance is the opposite error, and it misinforms while appearing scrupulous
   `theme.from_outside`

### "The adaptation keeps everything and means nothing"

1. What is being adapted is the source's claim, not its plot. State it in one sentence, then ask of every element whether it proves it — a subplot that proves the claim survives a subplot the readers loved
   `theme.adaptation_claim`
2. Interiority does not transfer. Budget a behavioural substitute for every internal proof before you start, not in the third draft
   `pov.screen_no_interiority`
3. The commonest conversion is the failure itself: the interior line spoken aloud, which closes the gap and turns a feeling into a fact. Invent a physical action the novel never contained and give the interiority to that
   `sub.interiority_spoken` · `sub.object_as_confession`
4. If the source's argument has dated, or you disagree with it, shift it openly — both claims on the same page, the change carried by structure rather than by new dialogue, and the source's argument kept alive and strong inside the work
   `theme.adaptation_shift` · `theme.anti_theme`
5. And remember half the audience has the book
   `info.adaptation_double_audience`

### "The claim won't survive subtitling"

1. List the five moments that prove the claim. Any whose proof is a specific *phrase* is at risk — rebuild it around an action or an object, and leave the phrase as a bonus for the source-language audience
   `theme.translation_survival`
2. For a value word with no equivalent, choose once and apply it consistently: borrow it and teach it by use, compensate with a scene that demonstrates it, paraphrase, or substitute — and substitution is the one that hands the audience a nearby foreign value and quietly misreads the work
   `theme.untranslatable_value` · `dial.untranslated_line`
3. Comedy carries the highest risk, because the claim often lives inside the joke's grammar
   `comedy.translation_resistance`
4. The prose-rhythm side of the same problem
   `rhythm.write_for_translator` · `dial.subtitle_constraint`

---