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