@mytechtoday/augment-extensions 0.7.0 → 1.2.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 (483) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +109 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +11 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +120 -0
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  476. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  477. package/cli/dist/utils/extractCommandHelp.js +250 -0
  478. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  479. package/cli/dist/utils/install-rules.js +55 -55
  480. package/cli/dist/utils/mcp-integration.js +44 -44
  481. package/cli/dist/utils/rule-install-hooks.js +8 -8
  482. package/modules.md +667 -630
  483. package/package.json +85 -85
@@ -1,489 +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
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