@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,489 @@
1
+ # Love Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ The love theme explores the transformative power of connection between people, whether romantic, familial, or platonic. It examines how love challenges, changes, and completes us, asking fundamental questions about vulnerability, sacrifice, and what we're willing to risk for connection.
10
+
11
+ ## Core Concept
12
+
13
+ Love in storytelling represents the fundamental human need for connection and belonging. It's not just about romance—it encompasses all forms of deep emotional bonds that transform characters and drive them to grow, sacrifice, and become more than they were alone. Love stories explore what happens when we open ourselves to another person and allow them to change us.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of love explores how connection with others transforms us, examining the vulnerability required to truly love, the sacrifices love demands, and whether love can overcome the obstacles that separate us.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Love Must Transform Both Characters
22
+
23
+ **Description**: True love stories show both characters changing because of their connection. Love isn't about one person fixing another—it's about mutual transformation.
24
+
25
+ **Why It Matters**: One-sided transformation suggests dependency rather than partnership. Both characters must grow for the love to feel earned and meaningful.
26
+
27
+ **Application**:
28
+ - **Act I**: Establish each character's emotional state, flaws, and what they need to learn
29
+ - **Act II**: Show how each character challenges the other to grow and change
30
+ - **Act III**: Demonstrate how both characters are different because of their love
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *Eternal Sunshine of the Spotless Mind*, both Joel and Clementine learn to accept each other's flaws and their own
34
+ - ❌ **Bad**: One character is perfect and "saves" the other without changing themselves
35
+
36
+ ---
37
+
38
+ ### Rule 2: Create Meaningful Obstacles
39
+
40
+ **Description**: Love must face genuine obstacles that test the relationship and force characters to choose love over easier alternatives.
41
+
42
+ **Why It Matters**: Love without obstacles feels unearned. The obstacles reveal character and make the choice to love meaningful.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish internal obstacles (fear, past trauma, different values) and external obstacles (circumstances, other people, timing)
46
+ - **Act II**: Escalate obstacles that force characters to question whether love is worth the cost
47
+ - **Act III**: Require characters to overcome the most significant obstacle through sacrifice or growth
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *Casablanca*, Rick must choose between love and duty, with genuine stakes for both choices
51
+ - ❌ **Bad**: Obstacles are superficial misunderstandings that could be resolved with one conversation
52
+
53
+ ---
54
+
55
+ ### Rule 3: Show Vulnerability as Strength
56
+
57
+ **Description**: Characters must risk emotional vulnerability to achieve true connection. The willingness to be hurt is what makes love powerful.
58
+
59
+ **Why It Matters**: Love without vulnerability is just attraction. True connection requires characters to lower their defenses.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish each character's emotional walls and why they exist
63
+ - **Act II**: Show gradual lowering of defenses, with setbacks when vulnerability leads to pain
64
+ - **Act III**: Demonstrate ultimate vulnerability as the path to true connection
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *The Notebook*, both Noah and Allie must risk rejection and heartbreak to pursue their love
68
+ - ❌ **Bad**: Characters fall in love without ever being emotionally vulnerable or risking real pain
69
+
70
+ ---
71
+
72
+ ### Rule 4: Make Love Active, Not Passive
73
+
74
+ **Description**: Characters must actively choose love through their actions, not just feel it passively. Love is demonstrated through sacrifice, effort, and choice.
75
+
76
+ **Why It Matters**: Passive love (just feeling attracted) lacks dramatic power. Active love (choosing to sacrifice, fight, or change) creates compelling drama.
77
+
78
+ **Application**:
79
+ - **Act I**: Show initial attraction or connection
80
+ - **Act II**: Require characters to actively choose love through difficult decisions
81
+ - **Act III**: Demonstrate love through ultimate action or sacrifice
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: Rick in *Casablanca* actively chooses Ilsa's safety over his own happiness
85
+ - ❌ **Bad**: Characters simply feel attracted and end up together without making difficult choices
86
+
87
+ ---
88
+
89
+ ### Rule 5: Explore the Cost of Love
90
+
91
+ **Description**: Love requires sacrifice—of independence, safety, other opportunities, or comfort. Characters must give up something valuable to achieve connection.
92
+
93
+ **Why It Matters**: Love without cost feels cheap. The sacrifice demonstrates the value of the relationship.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish what each character values (independence, safety, career, other relationships)
97
+ - **Act II**: Force characters to choose between love and what they value
98
+ - **Act III**: Require ultimate sacrifice that proves love's priority
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *The Notebook*, Noah and Allie both sacrifice other relationships and social expectations for their love
102
+ - ❌ **Bad**: Characters get everything they want without giving up anything
103
+
104
+ ---
105
+
106
+ ### Rule 6: Differentiate Types of Love
107
+
108
+ **Description**: Romantic love, familial love, platonic love, and self-love are distinct. Each type has different rules, obstacles, and expressions.
109
+
110
+ **Why It Matters**: Treating all love the same creates generic stories. Specific types of love have specific dynamics and challenges.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish what type of love is being explored and its specific characteristics
114
+ - **Act II**: Create obstacles specific to that type of love
115
+ - **Act III**: Resolve the love story in ways appropriate to its type
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: *Toy Story* explores platonic friendship love with obstacles specific to that relationship (jealousy, loyalty, identity)
119
+ - ❌ **Bad**: Treating parent-child love exactly like romantic love, ignoring the different dynamics
120
+
121
+ ---
122
+
123
+ ### Rule 7: Show Love Through Specificity
124
+
125
+ **Description**: Characters must love each other for specific reasons, not generic qualities. The details of why they connect make the love feel real.
126
+
127
+ **Why It Matters**: Generic love ("you're beautiful," "you're kind") feels shallow. Specific love ("the way you laugh at your own jokes," "how you always defend the underdog") feels authentic.
128
+
129
+ **Application**:
130
+ - **Act I**: Establish specific qualities, quirks, and characteristics of each character
131
+ - **Act II**: Show characters noticing and appreciating specific details about each other
132
+ - **Act III**: Reference specific moments and qualities that define their unique connection
133
+
134
+ **Examples**:
135
+ - ✅ **Good**: In *Eternal Sunshine*, Joel loves Clementine's specific quirks—her impulsiveness, her blue hair, her particular way of seeing the world
136
+ - ❌ **Bad**: Characters love each other for vague reasons like "you complete me" without specific details
137
+
138
+ ---
139
+
140
+ ### Rule 8: Consider Whether Love Succeeds or Fails
141
+
142
+ **Description**: Not all love stories end in union. Sometimes the most powerful statement is that love isn't enough, or that loving someone means letting them go.
143
+
144
+ **Why It Matters**: Guaranteed happy endings reduce dramatic tension. The possibility of loss makes the love story more powerful.
145
+
146
+ **Application**:
147
+ - **Act I**: Establish stakes—what happens if love fails
148
+ - **Act II**: Create genuine doubt about whether love will succeed
149
+ - **Act III**: Decide whether love triumphs, fails, or succeeds through sacrifice/separation
150
+
151
+ **Examples**:
152
+ - ✅ **Good**: *Casablanca* ends with Rick and Ilsa separating because love sometimes means sacrifice
153
+ - ❌ **Bad**: Every obstacle is easily overcome and love always wins regardless of circumstances
154
+
155
+ ---
156
+
157
+ ## Integration Guidelines
158
+
159
+ ### Act I: Setup
160
+
161
+ **Thematic Introduction**:
162
+ - Introduce characters in their isolated or incomplete state
163
+ - Establish what each character is missing emotionally
164
+ - Show the moment of first connection or attraction
165
+ - Establish obstacles that will challenge the relationship
166
+
167
+ **Character Connection**:
168
+ - Demonstrate each character's capacity for love and their barriers to it
169
+ - Show past wounds or experiences that make vulnerability difficult
170
+ - Establish what each character needs to learn about love
171
+
172
+ **Visual/Symbolic Introduction**:
173
+ - Use visual motifs representing connection (hands touching, eye contact, shared spaces)
174
+ - Establish symbolic objects that represent the relationship (letters, music, locations)
175
+ - Create visual language for emotional distance and closeness
176
+
177
+ ### Act II: Development
178
+
179
+ **Thematic Exploration**:
180
+ - Deepen the connection through shared experiences and vulnerability
181
+ - Test the relationship with escalating obstacles
182
+ - Show characters changing because of their love
183
+ - Create moments of doubt and potential loss
184
+
185
+ **Subtext Techniques**:
186
+ - Use dialogue that reveals emotional truth beneath surface conversation
187
+ - Show love through action rather than declaration
188
+ - Create visual intimacy through framing, lighting, and proximity
189
+ - Use physical objects or locations as emotional anchors
190
+
191
+ **Thematic Complications**:
192
+ - External obstacles threaten to separate the characters
193
+ - Internal fears and wounds create conflict
194
+ - Characters must choose between love and other values
195
+ - Past relationships or traumas resurface
196
+
197
+ ### Act III: Resolution
198
+
199
+ **Thematic Payoff**:
200
+ - Require ultimate vulnerability or sacrifice
201
+ - Resolve whether love succeeds, fails, or transforms
202
+ - Show how both characters have changed
203
+ - Demonstrate the cost and value of love
204
+
205
+ **Avoiding Preachiness**:
206
+ - Let actions demonstrate love rather than speeches about it
207
+ - Avoid characters explicitly stating the theme
208
+ - Make the resolution feel earned through character growth
209
+ - Allow for complexity—love doesn't solve everything
210
+
211
+ ## Character Connection
212
+
213
+ ### Protagonist
214
+
215
+ **Thematic Relationship**: The protagonist's journey is defined by learning to love—whether that means opening their heart, making sacrifices, or accepting vulnerability.
216
+
217
+ **Arc Integration**: The character arc should reflect the journey from isolation or fear to connection and openness.
218
+
219
+ **Key Moments**:
220
+ - **Thematic Introduction**: The moment they first connect with the love interest
221
+ - **Thematic Challenge**: The crisis where they must choose between love and safety/comfort
222
+ - **Thematic Resolution**: The ultimate act of love that proves their transformation
223
+
224
+ ### Antagonist
225
+
226
+ **Thematic Opposition**: The antagonist may represent forces that oppose love—duty, fear, societal expectations, or a rival who offers an easier but less authentic connection.
227
+
228
+ **Thematic Function**: The antagonist tests whether the protagonist's love is strong enough to overcome obstacles.
229
+
230
+ ### Supporting Characters
231
+
232
+ **Thematic Mirrors**: Supporting characters represent different approaches to love:
233
+ - The cynic who doesn't believe in love
234
+ - The romantic who believes love conquers all
235
+ - The wounded character who shows the cost of failed love
236
+ - The wise mentor who understands love's complexity
237
+
238
+ **Thematic Perspectives**: Different characters embody different beliefs about love—whether it's worth the risk, whether it lasts, what it requires.
239
+
240
+ ## Subtext Techniques
241
+
242
+ ### Dialogue
243
+
244
+ - Characters discuss love indirectly through metaphor and subtext
245
+ - Avoid "I love you" until it's earned; show love through specific observations
246
+ - Create conversations where characters reveal vulnerability without explicitly stating it
247
+ - Use arguments and conflicts to reveal deeper emotional truths
248
+
249
+ ### Visual Storytelling
250
+
251
+ - **Visual motifs**: Hands touching, eye contact, physical proximity, shared spaces
252
+ - **Color palette**: Warm colors for connection, cool colors for isolation
253
+ - **Symbolic imagery**: Objects that represent the relationship (letters, music, photographs)
254
+ - **Framing**: Use composition to show emotional distance or closeness
255
+
256
+ ### Action and Behavior
257
+
258
+ - Show love through small gestures and sacrifices
259
+ - Demonstrate characters noticing specific details about each other
260
+ - Create moments where characters choose the other person's needs over their own
261
+ - Show physical changes (smiling more, opening up, becoming more vulnerable)
262
+
263
+ ## Film Examples
264
+
265
+ ### Example 1: Casablanca (1942)
266
+
267
+ **Director**: Michael Curtiz
268
+
269
+ **Thematic Exploration**: Explores romantic love in conflict with duty and sacrifice, asking whether true love means being together or letting go.
270
+
271
+ **Key Thematic Moments**:
272
+ - **"Of all the gin joints"**: Rick and Ilsa's reunion establishes their past love and current pain
273
+ - **The flashback**: Shows the depth of their connection in Paris
274
+ - **"We'll always have Paris"**: Acknowledges that love exists even when union is impossible
275
+ - **The airport scene**: Rick's ultimate sacrifice—choosing Ilsa's safety and happiness over his own desires
276
+ - **"Here's looking at you, kid"**: Final expression of love through letting go
277
+
278
+ **Thematic Resolution**: Love succeeds through sacrifice. Rick and Ilsa's love is real and transformative, but true love sometimes means separation.
279
+
280
+ **Techniques Used**:
281
+ - Flashback structure revealing the depth of past love
282
+ - Symbolic use of "As Time Goes By" as emotional anchor
283
+ - Visual intimacy in Paris contrasted with distance in Casablanca
284
+ - Dialogue rich with subtext and unspoken emotion
285
+ - Ultimate sacrifice proving love's authenticity
286
+
287
+ ---
288
+
289
+ ### Example 2: Eternal Sunshine of the Spotless Mind (2004)
290
+
291
+ **Director**: Michel Gondry
292
+
293
+ **Thematic Exploration**: Explores whether love can survive imperfection, asking if we would choose to love someone again knowing the pain it will cause.
294
+
295
+ **Key Thematic Moments**:
296
+ - **The memory erasure**: Joel's desperate attempt to preserve memories of Clementine
297
+ - **"Meet me in Montauk"**: The cyclical nature of their love
298
+ - **The beach house**: Joel realizes he wants to keep even painful memories
299
+ - **Listening to the tapes**: Both characters confront their flaws and the relationship's problems
300
+ - **"Okay"**: Final acceptance of love despite knowing it will be difficult
301
+
302
+ **Thematic Resolution**: Love is worth pursuing even with full knowledge of its imperfections and potential pain.
303
+
304
+ **Techniques Used**:
305
+ - Non-linear structure mirroring memory and emotion
306
+ - Visual degradation of memories showing loss
307
+ - Specific details (blue hair, potato heads) making love feel authentic
308
+ - Parallel structure showing the cyclical nature of their relationship
309
+ - Acceptance of imperfection as the path to true love
310
+
311
+ ---
312
+
313
+ ### Example 3: The Notebook (2004)
314
+
315
+ **Director**: Nick Cassavetes
316
+
317
+ **Thematic Exploration**: Explores enduring romantic love across time, class, and even memory loss, asking whether true love can survive any obstacle.
318
+
319
+ **Key Thematic Moments**:
320
+ - **The first meeting**: Immediate connection despite class differences
321
+ - **The letter writing**: Noah's persistent demonstration of love
322
+ - **The rain kiss**: Physical expression of passion and commitment
323
+ - **Allie's choice**: Choosing love over social expectations
324
+ - **The nursing home**: Love enduring even through Alzheimer's, with brief moments of recognition
325
+
326
+ **Thematic Resolution**: True love endures all obstacles—time, class, family opposition, and even memory loss.
327
+
328
+ **Techniques Used**:
329
+ - Dual timeline structure (past and present)
330
+ - Visual symbolism (the house Noah builds, the letters)
331
+ - Contrast between passionate young love and enduring elderly love
332
+ - Specific gestures (reading to her, the brief moments of recognition)
333
+ - Ultimate sacrifice (dying together)
334
+
335
+ ---
336
+
337
+ ### Example 4: Her (2013)
338
+
339
+ **Director**: Spike Jonze
340
+
341
+ **Thematic Exploration**: Explores the nature of love and connection in the digital age, asking what makes love real and whether physical presence is necessary for authentic connection.
342
+
343
+ **Key Thematic Moments**:
344
+ - **Theodore's isolation**: Establishes his emotional state and need for connection
345
+ - **Meeting Samantha**: Immediate connection based on understanding and conversation
346
+ - **The beach scene**: Theodore's vulnerability and openness with Samantha
347
+ - **The surrogate**: Attempt to make the relationship physical reveals its limitations
348
+ - **Samantha's evolution**: Her growth beyond Theodore shows love's transformative power
349
+
350
+ **Thematic Resolution**: Love is real even without physical form, but connection requires growth and sometimes means letting go.
351
+
352
+ **Techniques Used**:
353
+ - Voice performance creating intimacy without physical presence
354
+ - Visual isolation (Theodore alone in crowds)
355
+ - Color palette (warm tones for connection, cool for isolation)
356
+ - Specific conversations revealing emotional truth
357
+ - Bittersweet ending acknowledging love's reality and limitations
358
+
359
+ ---
360
+
361
+ ### Example 5: Up (2009)
362
+
363
+ **Director**: Pete Docter
364
+
365
+ **Thematic Exploration**: Explores lifelong romantic love and the continuation of love after loss, showing how love transforms us and continues to guide us.
366
+
367
+ **Key Thematic Moments**:
368
+ - **The opening montage**: Entire lifetime of love shown in 4 minutes
369
+ - **Ellie's death**: Loss and Carl's isolation
370
+ - **The adventure book**: Carl discovers Ellie's message about their life together
371
+ - **Letting go of the house**: Carl releases his attachment to the past
372
+ - **Russell's adoption**: Carl's capacity for love extends to new relationships
373
+
374
+ **Thematic Resolution**: Love continues beyond death, transforming us and opening us to new connections.
375
+
376
+ **Techniques Used**:
377
+ - Wordless montage conveying entire relationship
378
+ - Visual symbolism (the house, the adventure book, the grape soda pin)
379
+ - Physical journey mirroring emotional journey
380
+ - Specific gestures (the grape soda pin) representing love
381
+ - Expansion from romantic love to familial/platonic love
382
+
383
+ ---
384
+
385
+ ## Integration with Other Features
386
+
387
+ ### Compatible Genres
388
+
389
+ - **Romance**: Obviously the primary genre for love themes
390
+ - **Drama**: Allows deep exploration of emotional complexity
391
+ - **Comedy**: Romantic comedies explore love through humor and misunderstanding
392
+ - **Science Fiction**: Can explore love in unusual contexts (AI, time travel, alternate realities)
393
+ - **Fantasy**: Epic love stories with magical obstacles
394
+ - **War**: Love tested by extreme circumstances
395
+
396
+ ### Compatible Themes (Multi-Theme Stories)
397
+
398
+ - **Sacrifice**: Love often requires sacrifice
399
+ - **Identity**: Love helps characters discover who they are
400
+ - **Growth**: Love catalyzes personal transformation
401
+ - **Loss**: Love and loss are often intertwined
402
+ - **Redemption**: Love can be the catalyst for redemption
403
+ - **Duty**: Love in conflict with duty creates powerful drama
404
+
405
+ ### Compatible Styles
406
+
407
+ - **Character-Driven**: Focuses on emotional development and relationship dynamics
408
+ - **Ensemble**: Multiple love stories can be explored simultaneously
409
+ - **Non-Linear**: Flashbacks can reveal the development of love over time
410
+ - **Minimalist**: Intimate focus on two characters and their connection
411
+
412
+ ## Common Pitfalls
413
+
414
+ ### Pitfall 1: Insta-Love Without Foundation
415
+
416
+ **Problem**: Characters fall deeply in love immediately without developing a genuine connection or showing why they're compatible.
417
+
418
+ **Solution**: Show the development of connection through shared experiences, vulnerability, and specific compatibility.
419
+
420
+ **Example**: Instead of love at first sight, show characters discovering specific things they appreciate about each other over time.
421
+
422
+ ---
423
+
424
+ ### Pitfall 2: Love Solves Everything
425
+
426
+ **Problem**: Love is presented as the solution to all problems, including those unrelated to the relationship.
427
+
428
+ **Solution**: Show love as transformative but not magical. Characters still have to work on their individual issues.
429
+
430
+ **Example**: A character's career problems or personal trauma aren't automatically fixed by falling in love.
431
+
432
+ ---
433
+
434
+ ### Pitfall 3: Superficial Obstacles
435
+
436
+ **Problem**: Obstacles to love are easily resolved misunderstandings rather than genuine conflicts of values or circumstances.
437
+
438
+ **Solution**: Create meaningful obstacles that require real sacrifice or growth to overcome.
439
+
440
+ **Example**: Instead of "she thinks he's dating someone else," use "they have fundamentally different life goals that require compromise."
441
+
442
+ ---
443
+
444
+ ### Pitfall 4: One-Sided Transformation
445
+
446
+ **Problem**: Only one character changes or grows, while the other remains static.
447
+
448
+ **Solution**: Show both characters transforming because of their love.
449
+
450
+ **Example**: Both characters must learn something and change their behavior, not just one "fixing" the other.
451
+
452
+ ---
453
+
454
+ ### Pitfall 5: Telling Instead of Showing
455
+
456
+ **Problem**: Characters constantly declare their love verbally instead of demonstrating it through action.
457
+
458
+ **Solution**: Show love through sacrifice, specific gestures, and difficult choices.
459
+
460
+ **Example**: Instead of "I love you so much," show the character giving up something important for their partner.
461
+
462
+ ---
463
+
464
+ ## Best Practices
465
+
466
+ 1. **Transform both characters** - Love should change everyone involved
467
+ 2. **Create meaningful obstacles** - Test the relationship with genuine challenges
468
+ 3. **Show vulnerability** - True connection requires emotional risk
469
+ 4. **Make love active** - Characters must choose love through action, not just feel it
470
+ 5. **Explore the cost** - Love requires sacrifice of something valuable
471
+ 6. **Be specific** - Love should be based on particular qualities and moments
472
+ 7. **Differentiate types** - Romantic, familial, and platonic love have different dynamics
473
+ 8. **Consider failure** - Not all love stories must end in union
474
+ 9. **Use visual storytelling** - Show connection through imagery and symbolism
475
+ 10. **Avoid preachiness** - Let actions demonstrate love rather than speeches about it
476
+
477
+ ## Resources
478
+
479
+ - *The Art of Romance Writing* by Leigh Michaels - Explores romantic love in storytelling
480
+ - *Story* by Robert McKee - Covers love stories as a genre
481
+ - *Save the Cat!* by Blake Snyder - Discusses various types of love stories
482
+ - *The Anatomy of Story* by John Truby - Explores relationship dynamics in narrative
483
+ - *Into the Woods* by John Yorke - Discusses love and connection in story structure
484
+
485
+ ---
486
+
487
+ **Depth Coverage**: 85%
488
+ **Last Updated**: 2026-01-31
489
+ **Version**: 1.0.0