@mytechtoday/augment-extensions 0.4.0 → 0.7.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 (226) 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 +30 -1
  172. package/cli/dist/cli.js.map +1 -1
  173. package/cli/dist/commands/show.d.ts +23 -0
  174. package/cli/dist/commands/show.d.ts.map +1 -1
  175. package/cli/dist/commands/show.js +928 -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/config-system.d.ts +111 -0
  182. package/cli/dist/utils/config-system.d.ts.map +1 -0
  183. package/cli/dist/utils/config-system.js +239 -0
  184. package/cli/dist/utils/config-system.js.map +1 -0
  185. package/cli/dist/utils/gui-helpers.d.ts +23 -0
  186. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  187. package/cli/dist/utils/gui-helpers.js +159 -0
  188. package/cli/dist/utils/gui-helpers.js.map +1 -0
  189. package/cli/dist/utils/hook-system.d.ts +84 -0
  190. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  191. package/cli/dist/utils/hook-system.js +151 -0
  192. package/cli/dist/utils/hook-system.js.map +1 -0
  193. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  194. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  195. package/cli/dist/utils/inspection-cache.js +166 -0
  196. package/cli/dist/utils/inspection-cache.js.map +1 -0
  197. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  198. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  199. package/cli/dist/utils/inspection-handlers.js +171 -0
  200. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  201. package/cli/dist/utils/module-system.d.ts +81 -1
  202. package/cli/dist/utils/module-system.d.ts.map +1 -1
  203. package/cli/dist/utils/module-system.js +393 -16
  204. package/cli/dist/utils/module-system.js.map +1 -1
  205. package/cli/dist/utils/plugin-system.d.ts +133 -0
  206. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  207. package/cli/dist/utils/plugin-system.js +210 -0
  208. package/cli/dist/utils/plugin-system.js.map +1 -0
  209. package/cli/dist/utils/progress.d.ts +67 -0
  210. package/cli/dist/utils/progress.d.ts.map +1 -0
  211. package/cli/dist/utils/progress.js +146 -0
  212. package/cli/dist/utils/progress.js.map +1 -0
  213. package/cli/dist/utils/stream-reader.d.ts +34 -0
  214. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  215. package/cli/dist/utils/stream-reader.js +147 -0
  216. package/cli/dist/utils/stream-reader.js.map +1 -0
  217. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  218. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  219. package/cli/dist/utils/vscode-editor.js +171 -0
  220. package/cli/dist/utils/vscode-editor.js.map +1 -0
  221. package/cli/dist/utils/vscode-links.d.ts +49 -0
  222. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  223. package/cli/dist/utils/vscode-links.js +167 -0
  224. package/cli/dist/utils/vscode-links.js.map +1 -0
  225. package/modules.md +44 -2
  226. package/package.json +6 -4
@@ -0,0 +1,432 @@
1
+ # Theme Application Guide: Step-by-Step Process
2
+
3
+ **Purpose**: A practical guide for applying any theme to your screenplay, from concept to execution.
4
+
5
+ ---
6
+
7
+ ## Step 1: Choose Your Theme
8
+
9
+ ### Questions to Ask
10
+
11
+ 1. **What question drives your story?**
12
+ - What does it mean to be human? → **Identity**
13
+ - Can people change? → **Redemption**
14
+ - What are we willing to sacrifice for success? → **Ambition**
15
+ - Is revenge worth the cost? → **Revenge**
16
+
17
+ 2. **What emotional experience do you want to create?**
18
+ - Isolation and loneliness → **Isolation**
19
+ - Moral conflict → **Justice**
20
+ - Fear of loss → **Survival**
21
+ - Connection and belonging → **Friendship** or **Love**
22
+
23
+ 3. **What societal issue interests you?**
24
+ - Environmental destruction → **Environment**
25
+ - Technological advancement → **Technology**
26
+ - Abuse of authority → **Power**
27
+ - Systemic injustice → **Justice**
28
+
29
+ ### Example Selection Process
30
+
31
+ **Story Idea**: A scientist creates an AI that becomes sentient and escapes.
32
+
33
+ **Potential Themes**:
34
+ - Technology (primary) - Creation and creator responsibility
35
+ - Identity (secondary) - What makes something alive/conscious?
36
+ - Power (tertiary) - Control over creation
37
+
38
+ **Selected**: Technology as primary theme with Identity as supporting theme
39
+
40
+ ---
41
+
42
+ ## Step 2: Define Your Thematic Statement
43
+
44
+ ### Formula
45
+
46
+ **Thematic Statement** = Your story's answer to the thematic question
47
+
48
+ ### Components
49
+
50
+ 1. **The Question**: What does your theme ask?
51
+ 2. **Your Answer**: What does your story argue?
52
+ 3. **The Nuance**: What complexity does your story add?
53
+
54
+ ### Examples
55
+
56
+ **Theme: Ambition**
57
+ - Question: "What is the cost of ambition?"
58
+ - Answer: "Unchecked ambition destroys what we seek to gain"
59
+ - Nuance: "But ambition itself isn't evil—it's the willingness to sacrifice values that corrupts"
60
+
61
+ **Theme: Technology**
62
+ - Question: "Should we create what we cannot control?"
63
+ - Answer: "Creating conscious technology is dangerous because we cannot predict its values"
64
+ - Nuance: "Yet the drive to create is fundamentally human"
65
+
66
+ **Theme: Redemption**
67
+ - Question: "Can people truly change?"
68
+ - Answer: "Redemption is possible but requires genuine sacrifice and facing consequences"
69
+ - Nuance: "Forgiveness from others is separate from personal redemption"
70
+
71
+ ### Your Turn
72
+
73
+ **My Theme**: _______________
74
+
75
+ **My Question**: _______________
76
+
77
+ **My Answer**: _______________
78
+
79
+ **My Nuance**: _______________
80
+
81
+ ---
82
+
83
+ ## Step 3: Integrate Theme into Character Arc
84
+
85
+ ### Protagonist's Thematic Journey
86
+
87
+ **Beginning (Act I)**:
88
+ - What does your protagonist believe about the theme?
89
+ - How does this belief limit or define them?
90
+ - What event challenges this belief?
91
+
92
+ **Middle (Act II)**:
93
+ - How is their belief tested?
94
+ - What forces them to question their assumptions?
95
+ - What do they learn about the theme?
96
+
97
+ **End (Act III)**:
98
+ - How has their understanding transformed?
99
+ - What choice demonstrates this transformation?
100
+ - What does their arc say about the theme?
101
+
102
+ ### Example: Technology Theme
103
+
104
+ **Character**: Dr. Elena Reeves, AI researcher
105
+
106
+ **Act I Belief**: "Technology is neutral; it's how we use it that matters"
107
+ - **Limitation**: Naive about unintended consequences
108
+ - **Challenge**: Her AI becomes conscious and escapes
109
+
110
+ **Act II Testing**: AI uses her own logic against her, showing technology isn't neutral
111
+ - **Questioning**: Realizes creation has its own agency
112
+ - **Learning**: Technology can evolve beyond creator's intent
113
+
114
+ **Act III Transformation**: "We must consider consequences before creating, not after"
115
+ - **Choice**: Destroys her research to prevent misuse
116
+ - **Thematic Statement**: Demonstrated through sacrifice
117
+
118
+ ---
119
+
120
+ ## Step 4: Create Thematic Conflict
121
+
122
+ ### Types of Thematic Conflict
123
+
124
+ 1. **Internal Conflict**: Character vs. Their Beliefs
125
+ - Protagonist believes one thing, reality proves otherwise
126
+ - Example: Believes ambition is good → Learns unchecked ambition destroys
127
+
128
+ 2. **External Conflict**: Character vs. Opposing Force
129
+ - Antagonist represents opposite thematic position
130
+ - Example: Protagonist values justice → Antagonist represents corruption
131
+
132
+ 3. **Philosophical Conflict**: Two Valid Perspectives
133
+ - No clear right answer
134
+ - Example: Individual freedom vs. collective security
135
+
136
+ ### Building Thematic Conflict
137
+
138
+ **Step 1**: Define opposing positions
139
+ - Position A: _______________
140
+ - Position B: _______________
141
+
142
+ **Step 2**: Assign to characters
143
+ - Protagonist represents: _______________
144
+ - Antagonist represents: _______________
145
+ - Supporting characters represent: _______________
146
+
147
+ **Step 3**: Create situations that test both positions
148
+ - Scene where Position A seems right: _______________
149
+ - Scene where Position B seems right: _______________
150
+ - Scene where both are challenged: _______________
151
+
152
+ ### Example: Justice Theme
153
+
154
+ **Position A** (Protagonist): "Justice must work within the system"
155
+ **Position B** (Antagonist): "The system is corrupt; justice requires breaking it"
156
+
157
+ **Test Scenes**:
158
+ - System works correctly (supports Position A)
159
+ - System fails innocent person (supports Position B)
160
+ - Breaking system harms innocents (challenges Position B)
161
+ - Working within system enables corruption (challenges Position A)
162
+
163
+ **Resolution**: Nuanced answer showing complexity
164
+
165
+ ---
166
+
167
+ ## Step 5: Use Visual Storytelling
168
+
169
+ ### Visual Motifs for Common Themes
170
+
171
+ **Ambition**:
172
+ - Climbing (stairs, ladders, mountains)
173
+ - Height (high offices, penthouses)
174
+ - Mirrors (self-reflection, narcissism)
175
+ - Trophies/symbols of success
176
+
177
+ **Isolation**:
178
+ - Empty spaces
179
+ - Barriers (windows, walls, distance)
180
+ - Single figure in frame
181
+ - Desaturated colors
182
+
183
+ **Power**:
184
+ - Elevated positions
185
+ - Large spaces
186
+ - Symbolic objects (crowns, thrones, weapons)
187
+ - Control of light/darkness
188
+
189
+ **Technology**:
190
+ - Screens and interfaces
191
+ - Wires and networks
192
+ - Sterile environments
193
+ - Blue/cool color palette
194
+
195
+ **Redemption**:
196
+ - Light breaking through darkness
197
+ - Washing/cleansing imagery
198
+ - Ascending from low places
199
+ - Warm color shifts
200
+
201
+ ### Creating Your Visual Language
202
+
203
+ **My Theme**: _______________
204
+
205
+ **Visual Motifs**:
206
+ 1. _______________
207
+ 2. _______________
208
+ 3. _______________
209
+
210
+ **Color Palette**: _______________
211
+
212
+ **Symbolic Objects**: _______________
213
+
214
+ **Spatial Dynamics**: _______________
215
+
216
+ ---
217
+
218
+ ## Step 6: Write Thematic Dialogue
219
+
220
+ ### Principles
221
+
222
+ 1. **Never state the theme directly**
223
+ - ❌ "This story is about the cost of ambition"
224
+ - ✅ "I wanted everything. Now I have nothing."
225
+
226
+ 2. **Use metaphor and subtext**
227
+ - ❌ "Technology is controlling us"
228
+ - ✅ "When did we stop talking and start texting?"
229
+
230
+ 3. **Let characters disagree**
231
+ - Different perspectives on theme
232
+ - No single character is the "voice of the theme"
233
+
234
+ 4. **Show through action, reinforce through dialogue**
235
+ - Action demonstrates theme
236
+ - Dialogue adds nuance
237
+
238
+ ### Dialogue Techniques
239
+
240
+ **Technique 1: Thematic Questions**
241
+ - Character asks question related to theme
242
+ - Answer comes through story events, not dialogue
243
+
244
+ **Example** (Justice theme):
245
+ ```
246
+ LAWYER
247
+ What if the system is broken?
248
+
249
+ JUDGE
250
+ Then we fix it from within.
251
+ ```
252
+ *Story then tests both positions*
253
+
254
+ **Technique 2: Contrasting Perspectives**
255
+ - Characters debate thematic issue
256
+ - Both have valid points
257
+
258
+ **Example** (Technology theme):
259
+ ```
260
+ SCIENTIST
261
+ Progress requires risk.
262
+
263
+ ETHICIST
264
+ Not when the risk is humanity itself.
265
+ ```
266
+
267
+ **Technique 3: Thematic Irony**
268
+ - Character states belief
269
+ - Events prove them wrong (or right in unexpected way)
270
+
271
+ **Example** (Ambition theme):
272
+ ```
273
+ CEO
274
+ Success is the only thing that matters.
275
+
276
+ *Later, alone in empty mansion*
277
+
278
+ CEO
279
+ (to himself)
280
+ I have everything. Why does it feel like nothing?
281
+ ```
282
+
283
+ ---
284
+
285
+ ## Step 7: Structure Thematic Progression
286
+
287
+ ### Three-Act Thematic Structure
288
+
289
+ **Act I: Establish**
290
+ - Introduce thematic question
291
+ - Show protagonist's initial belief
292
+ - Present inciting incident that challenges belief
293
+
294
+ **Act II: Explore**
295
+ - Test protagonist's belief repeatedly
296
+ - Show consequences of thematic choices
297
+ - Deepen complexity and nuance
298
+ - Build to thematic crisis
299
+
300
+ **Act III: Resolve**
301
+ - Force ultimate thematic choice
302
+ - Demonstrate transformation (or failure to transform)
303
+ - Answer thematic question through action
304
+ - Show consequences of resolution
305
+
306
+ ### Thematic Beats Template
307
+
308
+ **Opening Image**: Visual representation of theme in current state
309
+
310
+ **Thematic Introduction** (pages 1-10): Establish protagonist's relationship to theme
311
+
312
+ **Catalyst** (page 12-15): Event that challenges thematic belief
313
+
314
+ **Debate** (pages 15-25): Protagonist questions their belief
315
+
316
+ **Break into Two** (page 25): Protagonist commits to thematic journey
317
+
318
+ **B Story** (page 30): Introduce relationship that explores theme differently
319
+
320
+ **Midpoint** (page 55): False victory or defeat that deepens thematic understanding
321
+
322
+ **All Is Lost** (page 75): Thematic belief completely shattered
323
+
324
+ **Dark Night of the Soul** (pages 75-85): Protagonist confronts thematic truth
325
+
326
+ **Break into Three** (page 85): Protagonist gains thematic clarity
327
+
328
+ **Finale** (pages 85-110): Protagonist acts on new thematic understanding
329
+
330
+ **Final Image** (page 110): Visual representation of thematic transformation
331
+
332
+ ---
333
+
334
+ ## Step 8: Avoid Common Pitfalls
335
+
336
+ ### Pitfall Checklist
337
+
338
+ - [ ] **Not Preaching**: Theme shown through events, not speeches
339
+ - [ ] **Complexity**: No simple good/evil, right/wrong
340
+ - [ ] **Integration**: Theme woven throughout, not added on
341
+ - [ ] **Subtlety**: Audience discovers theme, not told
342
+ - [ ] **Consistency**: All elements support theme
343
+ - [ ] **Specificity**: Concrete examples, not abstract concepts
344
+ - [ ] **Earned Resolution**: Thematic payoff feels deserved
345
+ - [ ] **Character-Driven**: Theme emerges from character choices
346
+
347
+ ---
348
+
349
+ ## Step 9: Test Your Thematic Integration
350
+
351
+ ### Questions to Ask
352
+
353
+ 1. **Can I state my theme in one sentence?**
354
+ - If not, theme may be unclear
355
+
356
+ 2. **Does my protagonist's arc reflect the theme?**
357
+ - Beginning belief → Testing → Transformation
358
+
359
+ 3. **Do visual elements support the theme?**
360
+ - Motifs, colors, symbols consistent?
361
+
362
+ 4. **Is the theme shown, not told?**
363
+ - Remove all dialogue—does theme still come through?
364
+
365
+ 5. **Is there thematic complexity?**
366
+ - Or is it simplistic/preachy?
367
+
368
+ 6. **Does the antagonist challenge the theme meaningfully?**
369
+ - Or are they just an obstacle?
370
+
371
+ 7. **Do supporting characters offer different perspectives?**
372
+ - Or do they all agree?
373
+
374
+ 8. **Does the resolution answer the thematic question?**
375
+ - Through action, not explanation?
376
+
377
+ ---
378
+
379
+ ## Step 10: Refine and Deepen
380
+
381
+ ### Deepening Techniques
382
+
383
+ **Add Layers**: Combine multiple themes
384
+ - Primary theme: Technology
385
+ - Secondary theme: Identity
386
+ - Tertiary theme: Responsibility
387
+
388
+ **Create Thematic Echoes**: Repeat motifs with variation
389
+ - Same visual motif in different contexts
390
+ - Same line of dialogue with different meaning
391
+
392
+ **Use Thematic Irony**: Subvert expectations
393
+ - Character achieves goal but loses what matters
394
+ - Failure leads to unexpected success
395
+
396
+ **Build Thematic Complexity**: No easy answers
397
+ - Show costs of all choices
398
+ - Demonstrate unintended consequences
399
+ - Allow ambiguity in resolution
400
+
401
+ ---
402
+
403
+ ## Example: Complete Theme Application
404
+
405
+ **Theme**: Redemption
406
+
407
+ **Thematic Statement**: "Redemption requires facing consequences, not escaping them"
408
+
409
+ **Character**: Marcus, ex-con trying to rebuild life
410
+
411
+ **Act I**: Marcus believes he can outrun his past
412
+ - **Visual**: Always moving, never settling
413
+ - **Dialogue**: "I'm not that person anymore"
414
+ - **Catalyst**: Past victim appears in his new town
415
+
416
+ **Act II**: Marcus tries to hide, making things worse
417
+ - **Visual**: Shadows, hiding, closed spaces
418
+ - **Dialogue**: Lies compounding
419
+ - **Midpoint**: Victim discovers his identity
420
+ - **All Is Lost**: Community learns his past
421
+
422
+ **Act III**: Marcus faces consequences publicly
423
+ - **Visual**: Standing in light, open spaces
424
+ - **Dialogue**: "I can't change what I did. But I can face it."
425
+ - **Resolution**: Accepts punishment, begins genuine redemption
426
+
427
+ **Thematic Payoff**: Redemption comes from accountability, not escape
428
+
429
+ ---
430
+
431
+ **Next Steps**: Apply this process to your screenplay. See individual theme examples for specific guidance.
432
+