@mytechtoday/augment-extensions 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/README.md +6 -6
  2. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -0
  3. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -0
  4. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -0
  5. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -0
  6. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -0
  7. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -0
  8. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -0
  9. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -0
  10. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -0
  11. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -0
  12. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -0
  13. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -0
  14. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -0
  15. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -0
  16. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -0
  17. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -0
  18. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -0
  19. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -0
  20. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -0
  21. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -0
  22. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -0
  23. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -0
  24. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -0
  25. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -0
  26. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -0
  27. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -0
  28. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/README.md +136 -0
  29. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/SCHEMA-VALIDATION-REPORT.md +216 -0
  30. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/brand-kit-example.yaml +292 -0
  31. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/campaign-brief-example.yaml +389 -0
  32. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/content-calendar-example.yaml +643 -0
  33. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/email-newsletter-example.md +376 -0
  34. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/landing-page-example.md +934 -0
  35. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/ppc-ad-copy-example.md +301 -0
  36. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/seo-blog-post-example.md +347 -0
  37. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/social-media-campaign-example.md +606 -0
  38. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/module.json +50 -0
  39. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/affiliate-influencer-marketing.md +593 -0
  40. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/asset-management.md +418 -0
  41. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/brand-consistency.md +210 -0
  42. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/content-marketing.md +337 -0
  43. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/conversion-optimization.md +455 -0
  44. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/direct-sales.md +499 -0
  45. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/email-marketing.md +439 -0
  46. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/legal-compliance.md +227 -0
  47. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/ppc-advertising.md +569 -0
  48. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/seo-optimization.md +470 -0
  49. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/social-media-marketing.md +414 -0
  50. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/universal-marketing.md +177 -0
  51. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/asset-inventory.schema.json +247 -0
  52. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/brand-kit.schema.json +326 -0
  53. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/campaign-brief.schema.json +342 -0
  54. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/color-palette.schema.json +223 -0
  55. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/content-template.schema.json +383 -0
  56. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -0
  57. package/augment-extensions/workflows/beads-integration/README.md +143 -0
  58. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -0
  59. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -0
  60. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -0
  61. package/augment-extensions/workflows/beads-integration/module.json +75 -0
  62. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -0
  63. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -0
  64. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -0
  65. package/augment-extensions/writing-standards/screenplay/README.md +135 -6
  66. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -0
  67. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -0
  68. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -0
  69. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -0
  70. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -0
  71. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -0
  72. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -0
  73. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -0
  74. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -0
  75. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -0
  76. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -0
  77. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -0
  78. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -0
  79. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -0
  80. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -0
  81. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -0
  82. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -0
  83. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -0
  84. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -0
  85. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -0
  86. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -0
  87. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -0
  88. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -0
  89. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -0
  90. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -0
  91. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -0
  92. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -0
  93. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -0
  94. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -0
  95. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -0
  96. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -0
  97. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -0
  98. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -0
  99. package/augment-extensions/writing-standards/screenplay/module.json +1 -1
  100. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -0
  101. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -0
  102. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -0
  103. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -0
  104. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -0
  105. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -0
  106. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -0
  107. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -0
  108. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -0
  109. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -0
  110. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -0
  111. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -0
  112. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -0
  113. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -0
  114. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -0
  115. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -0
  116. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -0
  117. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -0
  118. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -0
  119. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -0
  120. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -0
  121. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -0
  122. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -0
  123. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -0
  124. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -0
  125. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -0
  126. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -0
  127. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -0
  128. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -0
  129. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -0
  130. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -0
  131. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -0
  132. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -0
  133. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -0
  134. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -0
  135. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -0
  136. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -0
  137. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -0
  138. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -0
  139. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -0
  140. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -0
  141. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -0
  142. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -0
  143. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -0
  144. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -0
  145. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -0
  146. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -0
  147. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -0
  148. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -0
  149. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -0
  150. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -0
  151. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -0
  152. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -0
  153. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -0
  154. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -0
  155. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -0
  156. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -0
  157. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -0
  158. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -0
  159. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -0
  160. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -0
  161. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -0
  162. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -0
  163. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -0
  164. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -0
  165. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -0
  166. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -0
  167. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -0
  168. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -0
  169. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -0
  170. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -0
  171. package/cli/dist/cli.js +26 -1
  172. package/cli/dist/cli.js.map +1 -1
  173. package/cli/dist/commands/show.d.ts +19 -0
  174. package/cli/dist/commands/show.d.ts.map +1 -1
  175. package/cli/dist/commands/show.js +495 -10
  176. package/cli/dist/commands/show.js.map +1 -1
  177. package/cli/dist/types/gui.d.ts +62 -0
  178. package/cli/dist/types/gui.d.ts.map +1 -0
  179. package/cli/dist/types/gui.js +30 -0
  180. package/cli/dist/types/gui.js.map +1 -0
  181. package/cli/dist/utils/gui-helpers.d.ts +23 -0
  182. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  183. package/cli/dist/utils/gui-helpers.js +159 -0
  184. package/cli/dist/utils/gui-helpers.js.map +1 -0
  185. package/cli/dist/utils/module-system.d.ts +80 -1
  186. package/cli/dist/utils/module-system.d.ts.map +1 -1
  187. package/cli/dist/utils/module-system.js +388 -16
  188. package/cli/dist/utils/module-system.js.map +1 -1
  189. package/modules.md +44 -2
  190. package/package.json +6 -4
@@ -0,0 +1,643 @@
1
+ # Common Thematic Mistakes and How to Fix Them
2
+
3
+ **Purpose**: Before-and-after examples showing common thematic errors and their solutions.
4
+
5
+ ---
6
+
7
+ ## Mistake 1: On-the-Nose Dialogue (Stating Theme Explicitly)
8
+
9
+ ### ❌ Bad Example
10
+
11
+ ```
12
+ INT. OFFICE - DAY
13
+
14
+ JOHN
15
+ You know what this story is about, Sarah?
16
+ It's about how ambition corrupts people.
17
+ How the pursuit of power makes us lose
18
+ sight of what really matters. That's the
19
+ theme of my life.
20
+
21
+ SARAH
22
+ Yes, John. That's exactly what the theme is.
23
+ ```
24
+
25
+ **Why It Fails**:
26
+ - Characters explicitly state the theme
27
+ - No subtlety or subtext
28
+ - Feels like a lecture, not a story
29
+ - Audience isn't allowed to discover meaning
30
+
31
+ ### ✅ Good Example
32
+
33
+ ```
34
+ INT. OFFICE - NIGHT
35
+
36
+ John sits alone in his corner office. Awards on the wall.
37
+ Photos of his family, faces he barely recognizes now.
38
+
39
+ His phone rings. His daughter. He silences it.
40
+
41
+ Returns to his work.
42
+
43
+ The phone stops ringing.
44
+ ```
45
+
46
+ **Why It Works**:
47
+ - Theme shown through action and imagery
48
+ - Subtext: Success achieved, family lost
49
+ - Audience infers the theme
50
+ - Visual storytelling (awards vs. family photos)
51
+ - Character's choice demonstrates theme
52
+
53
+ ---
54
+
55
+ ## Mistake 2: Theme Without Conflict
56
+
57
+ ### ❌ Bad Example
58
+
59
+ **Theme**: Friendship
60
+
61
+ ```
62
+ INT. COFFEE SHOP - DAY
63
+
64
+ Best friends LISA and EMMA laugh together.
65
+
66
+ LISA
67
+ I'm so glad we're friends!
68
+
69
+ EMMA
70
+ Me too! Friends forever!
71
+
72
+ They hug. Everything is perfect.
73
+ ```
74
+
75
+ **Why It Fails**:
76
+ - No conflict testing the friendship
77
+ - Theme is stated, not explored
78
+ - No dramatic tension
79
+ - Nothing at stake
80
+
81
+ ### ✅ Good Example
82
+
83
+ **Theme**: Friendship
84
+
85
+ ```
86
+ INT. COFFEE SHOP - DAY
87
+
88
+ Lisa and Emma sit in tense silence.
89
+
90
+ LISA
91
+ You slept with him.
92
+
93
+ EMMA
94
+ I didn't know you still had feelings—
95
+
96
+ LISA
97
+ We talked about him two days ago!
98
+
99
+ EMMA
100
+ You said you were over him!
101
+
102
+ LISA
103
+ And you believed that made it okay?
104
+
105
+ Silence. Years of friendship hanging in the balance.
106
+
107
+ EMMA
108
+ I'm sorry.
109
+
110
+ LISA
111
+ Sorry doesn't fix this.
112
+
113
+ Emma stands to leave.
114
+
115
+ EMMA
116
+ So that's it? Ten years of friendship,
117
+ gone?
118
+
119
+ Lisa doesn't answer. Emma waits.
120
+
121
+ Finally, Lisa looks up.
122
+
123
+ LISA
124
+ I don't know. I need time.
125
+
126
+ EMMA
127
+ How much time?
128
+
129
+ LISA
130
+ I don't know that either.
131
+
132
+ Emma nods. Leaves. Lisa sits alone.
133
+ ```
134
+
135
+ **Why It Works**:
136
+ - Friendship tested by betrayal
137
+ - Real conflict with stakes
138
+ - No easy resolution
139
+ - Theme explored through difficulty
140
+ - Ambiguous ending (realistic)
141
+
142
+ ---
143
+
144
+ ## Mistake 3: One-Dimensional Antagonist
145
+
146
+ ### ❌ Bad Example
147
+
148
+ **Theme**: Justice
149
+
150
+ ```
151
+ INT. COURTROOM - DAY
152
+
153
+ The CORRUPT JUDGE sneers at the defendant.
154
+
155
+ CORRUPT JUDGE
156
+ I don't care about justice! I only
157
+ care about money and power! Guilty!
158
+
159
+ (laughs evilly)
160
+ ```
161
+
162
+ **Why It Fails**:
163
+ - Antagonist is cartoonishly evil
164
+ - No complexity or justification
165
+ - Theme becomes simplistic (good vs. evil)
166
+ - No moral nuance
167
+
168
+ ### ✅ Good Example
169
+
170
+ **Theme**: Justice
171
+
172
+ ```
173
+ INT. JUDGE'S CHAMBERS - DAY
174
+
175
+ JUDGE MORRISON reviews the case. The PROSECUTOR waits.
176
+
177
+ PROSECUTOR
178
+ The evidence is circumstantial.
179
+
180
+ JUDGE MORRISON
181
+ But the defendant has priors. Pattern
182
+ of behavior.
183
+
184
+ PROSECUTOR
185
+ Still. Reasonable doubt exists.
186
+
187
+ JUDGE MORRISON
188
+ And if we let him walk, and he kills
189
+ again? How do we live with that?
190
+
191
+ PROSECUTOR
192
+ How do we live with convicting an
193
+ innocent man?
194
+
195
+ Morrison looks at the case file. Genuinely torn.
196
+
197
+ JUDGE MORRISON
198
+ The law says innocent until proven guilty.
199
+ But my gut says he did it.
200
+
201
+ PROSECUTOR
202
+ Your gut isn't evidence.
203
+
204
+ JUDGE MORRISON
205
+ No. But it's kept people safe for
206
+ thirty years.
207
+
208
+ He makes his decision. We see the weight of it.
209
+ ```
210
+
211
+ **Why It Works**:
212
+ - Judge has understandable motivation (protecting people)
213
+ - Genuine moral dilemma (safety vs. justice)
214
+ - Not evil, just prioritizing differently
215
+ - Theme becomes complex (competing values)
216
+ - Audience can see both sides
217
+
218
+ ---
219
+
220
+ ## Mistake 4: Theme Added as Afterthought
221
+
222
+ ### ❌ Bad Example
223
+
224
+ **Original Story**: Action thriller about stopping a terrorist
225
+
226
+ **Theme "Added"**: At the end, hero says:
227
+ ```
228
+ HERO
229
+ I learned that violence only creates
230
+ more violence. Peace is the answer.
231
+ ```
232
+
233
+ **Why It Fails**:
234
+ - Theme not integrated into story
235
+ - Contradicts the action (hero used violence throughout)
236
+ - Feels tacked on
237
+ - No thematic development
238
+
239
+ ### ✅ Good Example
240
+
241
+ **Integrated Story**: Action thriller where theme is woven throughout
242
+
243
+ **Act I**: Hero believes violence solves problems
244
+ ```
245
+ INT. BRIEFING ROOM - DAY
246
+
247
+ HERO
248
+ We go in hard. Eliminate the threat.
249
+
250
+ MENTOR
251
+ And create ten more terrorists from
252
+ their families?
253
+
254
+ HERO
255
+ That's tomorrow's problem.
256
+ ```
257
+
258
+ **Act II**: Hero sees consequences of violence
259
+ ```
260
+ EXT. VILLAGE - DAY
261
+
262
+ The hero walks through rubble. A CHILD stares at him
263
+ with hatred. The child's father was killed in the raid.
264
+
265
+ The hero sees himself creating the next generation of enemies.
266
+ ```
267
+
268
+ **Act III**: Hero chooses different path
269
+ ```
270
+ INT. TERRORIST HIDEOUT - DAY
271
+
272
+ Hero has the terrorist leader at gunpoint.
273
+
274
+ TERRORIST
275
+ Do it. Make me a martyr. Prove we're right
276
+ about you.
277
+
278
+ The hero lowers his gun.
279
+
280
+ HERO
281
+ No. You're going to trial. The world
282
+ will see you're not a freedom fighter.
283
+ You're a murderer.
284
+
285
+ TERRORIST
286
+ They'll never convict me.
287
+
288
+ HERO
289
+ Maybe not. But I won't create more of you.
290
+ ```
291
+
292
+ **Why It Works**:
293
+ - Theme integrated from beginning
294
+ - Character arc reflects theme
295
+ - Actions demonstrate thematic evolution
296
+ - Resolution earned through journey
297
+ - Theme shown through choices, not speeches
298
+
299
+ ---
300
+
301
+ ## Mistake 5: No Visual Representation
302
+
303
+ ### ❌ Bad Example
304
+
305
+ **Theme**: Isolation
306
+
307
+ ```
308
+ INT. APARTMENT - DAY
309
+
310
+ MARK
311
+ I feel so isolated. So alone. Nobody
312
+ understands me. I'm completely cut off
313
+ from human connection.
314
+
315
+ His roommate nods sympathetically.
316
+ ```
317
+
318
+ **Why It Fails**:
319
+ - Theme only in dialogue
320
+ - Visuals contradict theme (roommate present)
321
+ - No visual storytelling
322
+ - Telling, not showing
323
+
324
+ ### ✅ Good Example
325
+
326
+ **Theme**: Isolation
327
+
328
+ ```
329
+ INT. MARK'S APARTMENT - DAY
330
+
331
+ Mark sits alone. The apartment is silent.
332
+
333
+ Through the window: Families in the park. Couples walking.
334
+ Children playing. Life happening outside.
335
+
336
+ Mark watches. Separated by glass.
337
+
338
+ His phone sits on the table. No notifications.
339
+
340
+ He picks it up. Scrolls through contacts. Hundreds of names.
341
+
342
+ Puts it down without calling anyone.
343
+
344
+ Returns to watching the world through the window.
345
+ ```
346
+
347
+ **Why It Works**:
348
+ - Visual isolation (alone in frame)
349
+ - Window as barrier (physical separation)
350
+ - Contrast (life outside, emptiness inside)
351
+ - Phone with contacts but no connection
352
+ - No dialogue needed
353
+ - Theme shown visually
354
+
355
+ ---
356
+
357
+ ## Mistake 6: Preaching Instead of Exploring
358
+
359
+ ### ❌ Bad Example
360
+
361
+ **Theme**: Environment
362
+
363
+ ```
364
+ INT. CONFERENCE ROOM - DAY
365
+
366
+ SCIENTIST
367
+ Climate change is real! We must act now!
368
+ Anyone who denies it is wrong! There's
369
+ only one solution: renewable energy!
370
+
371
+ Everyone nods in agreement.
372
+ ```
373
+
374
+ **Why It Fails**:
375
+ - One-sided presentation
376
+ - No complexity or nuance
377
+ - Feels like propaganda
378
+ - No dramatic conflict
379
+ - Audience told what to think
380
+
381
+ ### ✅ Good Example
382
+
383
+ **Theme**: Environment
384
+
385
+ ```
386
+ INT. TOWN HALL - NIGHT
387
+
388
+ The SCIENTIST presents climate data. The FACTORY OWNER
389
+ stands to respond.
390
+
391
+ FACTORY OWNER
392
+ You want me to shut down the factory.
393
+ Put 500 people out of work.
394
+
395
+ SCIENTIST
396
+ I want you to transition to clean energy.
397
+
398
+ FACTORY OWNER
399
+ With what money? You think I'm rich?
400
+ I'm barely breaking even.
401
+
402
+ SCIENTIST
403
+ And in ten years, when the river's toxic?
404
+
405
+ FACTORY OWNER
406
+ In ten years, these families will have
407
+ starved. I'm trying to feed people today.
408
+
409
+ The scientist has no answer. The problem is harder than
410
+ she thought.
411
+
412
+ SCIENTIST
413
+ There has to be a way to do both.
414
+
415
+ FACTORY OWNER
416
+ Then help me find it. Don't just tell
417
+ me I'm destroying the planet.
418
+
419
+ The scientist sits. Realizes she needs to listen, not lecture.
420
+ ```
421
+
422
+ **Why It Works**:
423
+ - Multiple perspectives presented
424
+ - Both sides have valid points
425
+ - Complexity acknowledged
426
+ - No easy answers
427
+ - Characters must work together
428
+ - Theme explored, not preached
429
+ - Audience thinks, not told
430
+
431
+ ---
432
+
433
+ ## Mistake 7: Theme Without Stakes
434
+
435
+ ### ❌ Bad Example
436
+
437
+ **Theme**: Ambition
438
+
439
+ ```
440
+ INT. OFFICE - DAY
441
+
442
+ JANE
443
+ I want the promotion.
444
+
445
+ BOSS
446
+ Okay, you got it.
447
+
448
+ JANE
449
+ Great!
450
+
451
+ Everyone's happy.
452
+ ```
453
+
454
+ **Why It Fails**:
455
+ - No cost to ambition
456
+ - No conflict or sacrifice
457
+ - Nothing at stake
458
+ - Theme not explored
459
+
460
+ ### ✅ Good Example
461
+
462
+ **Theme**: Ambition
463
+
464
+ ```
465
+ INT. HOSPITAL ROOM - DAY
466
+
467
+ Jane's mother lies in bed, dying. Jane's phone rings.
468
+ The promotion interview.
469
+
470
+ MOTHER
471
+ Go. It's important.
472
+
473
+ JANE
474
+ You're important.
475
+
476
+ MOTHER
477
+ I'll still be here.
478
+
479
+ Jane looks at her mother. At her phone.
480
+
481
+ JANE
482
+ What if you're not?
483
+
484
+ MOTHER
485
+ Then you'll regret missing your chance.
486
+
487
+ Jane answers the phone.
488
+
489
+ JANE
490
+ (into phone)
491
+ I need to reschedule.
492
+
493
+ She hangs up. Sits with her mother.
494
+
495
+ Her phone rings again. The boss.
496
+
497
+ JANE
498
+ (to mother)
499
+ They're giving it to someone else.
500
+
501
+ MOTHER
502
+ I'm sorry.
503
+
504
+ JANE
505
+ (taking her mother's hand)
506
+ I'm not.
507
+
508
+ But we see in her eyes: Part of her is.
509
+ ```
510
+
511
+ **Why It Works**:
512
+ - Real stakes (career vs. family)
513
+ - Difficult choice
514
+ - Sacrifice required
515
+ - Ambiguity (right choice, but still costs)
516
+ - Theme explored through conflict
517
+
518
+ ---
519
+
520
+ ## Mistake 8: Inconsistent Thematic Development
521
+
522
+ ### ❌ Bad Example
523
+
524
+ **Theme**: Redemption
525
+
526
+ **Act I**: Character is selfish and cruel
527
+ **Act II**: Character is selfish and cruel
528
+ **Act III**: Character suddenly becomes selfless and kind (no development shown)
529
+
530
+ ```
531
+ INT. CHURCH - DAY
532
+
533
+ VILLAIN
534
+ I've changed! I'm good now!
535
+
536
+ Everyone forgives him instantly.
537
+ ```
538
+
539
+ **Why It Fails**:
540
+ - No gradual transformation
541
+ - Change not earned
542
+ - No struggle or setback
543
+ - Audience doesn't believe it
544
+
545
+ ### ✅ Good Example
546
+
547
+ **Theme**: Redemption
548
+
549
+ **Act I**: Character is selfish
550
+ ```
551
+ Derek steals from his employer. Feels no guilt.
552
+ ```
553
+
554
+ **Act II**: Character faces consequences, begins to change
555
+ ```
556
+ Derek's theft is discovered. He's fired. His family
557
+ disowns him.
558
+
559
+ He hits rock bottom. Homeless. Alone.
560
+
561
+ A STRANGER helps him. Gives him food. Doesn't ask for
562
+ anything.
563
+
564
+ DEREK
565
+ Why help me?
566
+
567
+ STRANGER
568
+ Someone helped me once. Passing it on.
569
+
570
+ Derek is moved. First crack in his selfishness.
571
+ ```
572
+
573
+ **Act II (continued)**: Character struggles, relapses
574
+ ```
575
+ Derek gets a new job. Sees opportunity to steal again.
576
+
577
+ He reaches for the money.
578
+
579
+ Stops.
580
+
581
+ Remembers the stranger.
582
+
583
+ Pulls his hand back.
584
+
585
+ Later: Derek sees the stranger being mugged. Derek
586
+ intervenes. Gets beaten up saving the stranger.
587
+
588
+ STRANGER
589
+ Why'd you do that?
590
+
591
+ DEREK
592
+ Passing it on.
593
+ ```
594
+
595
+ **Act III**: Character completes transformation through sacrifice
596
+ ```
597
+ Derek's old employer offers him his job back. But Derek
598
+ must testify against his former partner in the theft.
599
+
600
+ DEREK
601
+ He's my friend.
602
+
603
+ EMPLOYER
604
+ He let you take the fall.
605
+
606
+ Derek struggles. Then makes the call.
607
+
608
+ DEREK
609
+ (into phone)
610
+ I'll testify.
611
+
612
+ He's chosen the right path. It costs him his friendship.
613
+ But he's finally redeemed.
614
+ ```
615
+
616
+ **Why It Works**:
617
+ - Gradual transformation
618
+ - Setbacks and struggles
619
+ - Each step earned
620
+ - Sacrifice required
621
+ - Believable character arc
622
+
623
+ ---
624
+
625
+ ## Summary: Thematic Checklist
626
+
627
+ Before finalizing your screenplay, check:
628
+
629
+ - [ ] Theme shown through action, not dialogue
630
+ - [ ] Conflict tests the theme
631
+ - [ ] Antagonist has complex relationship to theme
632
+ - [ ] Theme integrated from beginning, not added at end
633
+ - [ ] Visual elements support theme
634
+ - [ ] Multiple perspectives explored, not one-sided
635
+ - [ ] Real stakes and consequences
636
+ - [ ] Consistent thematic development across acts
637
+ - [ ] Subtext in dialogue
638
+ - [ ] Earned resolution
639
+
640
+ ---
641
+
642
+ **Next Steps**: Review your screenplay against this checklist. Revise scenes that fall into these common mistakes.
643
+