@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,459 +1,459 @@
1
- # Fate Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- The fate theme explores destiny versus free will, examining whether our lives are predetermined or shaped by our choices, and whether we can escape or must accept our destiny.
10
-
11
- ## Core Concept
12
-
13
- Fate in storytelling represents the tension between predetermined destiny and personal agency. It explores prophecy, inevitability, the illusion of choice, and the question of whether we control our lives or are controlled by forces beyond our understanding.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of fate explores whether our lives are predetermined or shaped by choice, examining whether destiny can be escaped or must be accepted, and what role free will plays in our outcomes.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Establish the Prophecy or Destiny
22
-
23
- **Description**: Fate stories require a clear prophecy, prediction, or sense of inevitable destiny that the character must confront.
24
-
25
- **Why It Matters**: Fate without a specific destiny is just randomness. The prophecy creates dramatic tension.
26
-
27
- **Application**:
28
- - **Act I**: Introduce the prophecy, prediction, or sense of destiny
29
- - **Act II**: Show the character trying to escape or fulfill the destiny
30
- - **Act III**: Reveal whether the prophecy was fulfilled, subverted, or self-fulfilling
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *Oedipus Rex*, the prophecy that Oedipus will kill his father and marry his mother drives the entire story
34
- - ❌ **Bad**: Vague sense of destiny without specific prophecy or prediction
35
-
36
- ---
37
-
38
- ### Rule 2: Create the Illusion of Choice
39
-
40
- **Description**: Characters should believe they have free will and make choices, even if those choices lead to the fated outcome.
41
-
42
- **Why It Matters**: This explores whether our choices matter or if we're puppets of destiny.
43
-
44
- **Application**:
45
- - **Act I**: Show the character making choices they believe are free
46
- - **Act II**: Reveal how choices may be leading to fated outcome
47
- - **Act III**: Answer whether choices mattered or destiny was inevitable
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *Minority Report*, John's attempts to avoid the predicted murder lead him toward it
51
- - ❌ **Bad**: The character is passive, making no choices
52
-
53
- ---
54
-
55
- ### Rule 3: Explore Self-Fulfilling Prophecy
56
-
57
- **Description**: Often, attempts to avoid fate are what cause it. The character's choices to escape destiny bring it about.
58
-
59
- **Why It Matters**: This creates tragic irony and explores how fear of fate can create fate.
60
-
61
- **Application**:
62
- - **Act I**: Establish the prophecy and the character's fear of it
63
- - **Act II**: Show attempts to avoid fate that ironically lead toward it
64
- - **Act III**: Reveal how the character's choices fulfilled the prophecy
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *Oedipus Rex*, Oedipus's attempts to avoid killing his father lead him to do exactly that
68
- - ❌ **Bad**: Fate happens independently of the character's choices
69
-
70
- ---
71
-
72
- ### Rule 4: Question Whether Fate Can Be Changed
73
-
74
- **Description**: The story should explore whether destiny is fixed or if free will can alter outcomes.
75
-
76
- **Why It Matters**: This is the central philosophical question of fate themes.
77
-
78
- **Application**:
79
- - **Act I**: Establish the seemingly inevitable destiny
80
- - **Act II**: Show attempts to change fate
81
- - **Act III**: Answer whether fate was changed, fulfilled, or reinterpreted
82
-
83
- **Examples**:
84
- - ✅ **Good**: In *The Matrix*, Neo must decide if he's The One or if he can choose his own path
85
- - ❌ **Bad**: The story doesn't explore whether fate can be changed
86
-
87
- ---
88
-
89
- ### Rule 5: Show the Cost of Fighting or Accepting Fate
90
-
91
- **Description**: Whether the character fights or accepts their destiny, there must be consequences and costs.
92
-
93
- **Why It Matters**: The choice about fate must be meaningful with real stakes.
94
-
95
- **Application**:
96
- - **Act I**: Establish what fighting or accepting fate will cost
97
- - **Act II**: Show the character paying the price of their choice
98
- - **Act III**: Demonstrate the full consequences
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *Arrival*, Louise accepts her fated future despite knowing the pain it will bring
102
- - ❌ **Bad**: Fighting or accepting fate has no consequences
103
-
104
- ---
105
-
106
- ### Rule 6: Differentiate Fate from Consequence
107
-
108
- **Description**: True fate is predetermined, while consequence is the result of choices. Explore whether outcomes are fated or earned.
109
-
110
- **Why It Matters**: This distinction creates moral complexity about responsibility.
111
-
112
- **Application**:
113
- - **Act I**: Establish whether outcomes seem fated or earned
114
- - **Act II**: Blur the line between fate and consequence
115
- - **Act III**: Reveal whether outcomes were destiny or the result of choices
116
-
117
- **Examples**:
118
- - ✅ **Good**: In *No Country for Old Men*, Moss's fate seems both inevitable and the result of his choices
119
- - ❌ **Bad**: Everything is either pure fate or pure choice with no ambiguity
120
-
121
- ---
122
-
123
- ## Integration Guidelines
124
-
125
- ### Act I: Setup
126
-
127
- **Thematic Introduction**:
128
- - Introduce prophecy, prediction, or sense of predetermined destiny
129
- - Establish the character's initial relationship with fate
130
- - Show what the character believes about free will vs. destiny
131
- - Plant seeds of the fated outcome
132
-
133
- **Character Connection**:
134
- - Demonstrate the character's desire for control over their life
135
- - Show their awareness (or ignorance) of their destiny
136
- - Establish what they're trying to achieve or avoid
137
- - Reveal their beliefs about choice and destiny
138
-
139
- **Visual/Symbolic Introduction**:
140
- - Use visual motifs representing fate (clocks, paths, prophecies)
141
- - Establish symbolic objects connected to destiny
142
- - Create visual language for inevitability vs. choice
143
-
144
- ### Act II: Development
145
-
146
- **Thematic Exploration**:
147
- - Show the character attempting to control or escape their fate
148
- - Demonstrate how their choices lead toward the fated outcome
149
- - Create situations where fate and free will seem to conflict
150
- - Show the character questioning whether they have any control
151
-
152
- **Subtext Techniques**:
153
- - Use dialogue about destiny, choice, and control
154
- - Show patterns and repetitions suggesting inevitability
155
- - Create visual callbacks to earlier moments
156
- - Use other characters as agents of fate or advocates for choice
157
-
158
- **Thematic Complications**:
159
- - Attempts to avoid fate seem to cause it
160
- - Choices feel predetermined in retrospect
161
- - The character questions whether they're truly choosing
162
- - Prophecies or predictions create self-fulfilling outcomes
163
-
164
- ### Act III: Resolution
165
-
166
- **Thematic Payoff**:
167
- - Present the fated moment or outcome
168
- - Reveal whether the character had choice or was predetermined
169
- - Answer whether fate can be changed or only fulfilled
170
- - Demonstrate the relationship between choice and destiny
171
-
172
- **Avoiding Preachiness**:
173
- - Let the story structure demonstrate fate vs. choice
174
- - Avoid characters explicitly stating the theme
175
- - Show ambiguity—leave room for interpretation
176
- - Allow for complexity in the relationship between fate and free will
177
-
178
- ## Character Connection
179
-
180
- ### Protagonist
181
-
182
- **Thematic Relationship**: The protagonist's journey explores whether they control their destiny or are controlled by it.
183
-
184
- **Arc Integration**: The character arc should reflect the struggle between accepting fate and asserting free will.
185
-
186
- **Key Moments**:
187
- - **Thematic Introduction**: The moment they learn of their fate or feel destiny's pull
188
- - **Thematic Challenge**: The moment they try to change or escape their fate
189
- - **Thematic Resolution**: The moment they fulfill or defy their destiny
190
-
191
- ### Antagonist
192
-
193
- **Thematic Opposition**: The antagonist may represent fate itself, or forces trying to ensure the fated outcome occurs.
194
-
195
- **Thematic Function**: The antagonist tests whether the protagonist can escape or must accept their destiny.
196
-
197
- ### Supporting Characters
198
-
199
- **Thematic Mirrors**: Supporting characters represent different relationships with fate:
200
- - The character who accepts their destiny peacefully
201
- - The character who fights fate and suffers for it
202
- - The oracle or prophet who knows what's coming
203
- - The skeptic who denies fate's existence
204
-
205
- **Thematic Perspectives**: Different characters embody different beliefs about fate—whether it exists, whether it can be changed, whether fighting it matters.
206
-
207
- ## Subtext Techniques
208
-
209
- ### Dialogue
210
-
211
- - Characters discuss destiny, choice, and control without being explicit
212
- - Use metaphors of paths, threads, wheels
213
- - Create conversations about whether events were meant to be
214
- - Include moments where characters question their agency
215
-
216
- ### Visual Storytelling
217
-
218
- - **Visual motifs**: Clocks, paths, circles, threads, prophecies
219
- - **Color palette**: Often darker tones suggesting inevitability
220
- - **Symbolic imagery**: Objects representing destiny or choice
221
- - **Repetition**: Visual patterns suggesting fate's inevitability
222
-
223
- ### Action and Behavior
224
-
225
- - Show characters making choices that lead to fated outcomes
226
- - Demonstrate attempts to escape fate that cause it
227
- - Create moments where coincidence seems too perfect
228
- - Show the character recognizing patterns
229
-
230
- ## Film Examples
231
-
232
- ### Example 1: Oedipus Rex (Various Adaptations)
233
-
234
- **Director**: Various
235
-
236
- **Thematic Exploration**: The classic fate story—exploring whether prophecy can be avoided or whether attempts to escape fate cause it.
237
-
238
- **Key Thematic Moments**:
239
- - **The prophecy**: Oedipus will kill his father and marry his mother
240
- - **Fleeing Corinth**: Attempting to escape fate
241
- - **Killing at the crossroads**: Unknowingly fulfilling prophecy
242
- - **Solving the Sphinx**: Gaining power through intelligence
243
- - **The revelation**: Discovering he fulfilled the prophecy exactly
244
-
245
- **Thematic Resolution**: Fate cannot be escaped. Attempts to avoid destiny cause it. Free will is an illusion.
246
-
247
- **Techniques Used**:
248
- - Dramatic irony (audience knows what character doesn't)
249
- - Tragic structure emphasizing inevitability
250
- - Investigation revealing predetermined past
251
- - Recognition scene showing fate's completion
252
- - Blindness as metaphor for not seeing destiny
253
-
254
- ---
255
-
256
- ### Example 2: Arrival (2016)
257
-
258
- **Director**: Denis Villeneuve
259
-
260
- **Thematic Exploration**: Explores whether knowing the future changes it, examining the relationship between free will and predetermined outcomes.
261
-
262
- **Key Thematic Moments**:
263
- - **Learning the language**: Gaining ability to see time non-linearly
264
- - **Seeing her daughter's life**: Knowing the future, including tragedy
265
- - **The choice**: Deciding to have her daughter despite knowing she'll die
266
- - **Preventing war**: Using future knowledge to change the present
267
- - **Accepting fate**: Choosing the path despite knowing the pain
268
-
269
- **Thematic Resolution**: Knowing fate doesn't eliminate choice. We can choose our destiny even knowing the outcome.
270
-
271
- **Techniques Used**:
272
- - Non-linear narrative structure
273
- - Flashforwards revealed as memories of future
274
- - Circular time structure
275
- - Visual language emphasizing circles and loops
276
- - Ambiguous relationship between knowledge and choice
277
-
278
- ---
279
-
280
- ### Example 3: Minority Report (2002)
281
-
282
- **Director**: Steven Spielberg
283
-
284
- **Thematic Exploration**: Explores whether the future is fixed or changeable, examining free will in a world of perfect prediction.
285
-
286
- **Key Thematic Moments**:
287
- - **PreCrime system**: Future murders predicted and prevented
288
- - **John's prediction**: Seeing himself commit murder
289
- - **Attempting to avoid fate**: Trying to change the predicted future
290
- - **The setup**: Discovering the prediction was manipulated
291
- - **The choice**: Moment where he can fulfill or defy the prediction
292
-
293
- **Thematic Resolution**: The future can be changed. Predictions create possibilities, not certainties. Free will exists.
294
-
295
- **Techniques Used**:
296
- - Sci-fi premise making fate literal
297
- - Visual prediction sequences
298
- - Chase structure (running from fate)
299
- - Twist revealing manipulation
300
- - Choice at climax proving free will
301
-
302
- ---
303
-
304
- ### Example 4: Slumdog Millionaire (2008)
305
-
306
- **Director**: Danny Boyle
307
-
308
- **Thematic Exploration**: Explores whether life is random or destined, examining how past experiences prepare us for future moments.
309
-
310
- **Key Thematic Moments**:
311
- - **Game show questions**: Each perfectly matching Jamal's life experiences
312
- - **Flashback structure**: Showing how he knows each answer
313
- - **"It is written"**: Destiny vs. coincidence
314
- - **Reuniting with Latika**: Fated love across obstacles
315
- - **Final question**: Ultimate test of destiny
316
-
317
- **Thematic Resolution**: Life's experiences prepare us for our destiny. What seems like coincidence may be fate.
318
-
319
- **Techniques Used**:
320
- - Parallel structure (game show and life story)
321
- - Each question triggering flashback
322
- - Visual motifs (trains, paths)
323
- - Romantic destiny subplot
324
- - Triumphant ending suggesting fate rewards the worthy
325
-
326
- ---
327
-
328
- ### Example 5: The Matrix (1999)
329
-
330
- **Director**: The Wachowskis
331
-
332
- **Thematic Exploration**: Explores the illusion of choice in a predetermined system, examining whether prophecy creates destiny or reveals it.
333
-
334
- **Key Thematic Moments**:
335
- - **The prophecy**: Neo is "The One" who will save humanity
336
- - **Choice vs. destiny**: Oracle's discussion of choice
337
- - **Morpheus' faith**: Belief in Neo's destiny
338
- - **Neo's doubt**: Questioning whether he's really The One
339
- - **Trinity's love**: Fulfilling prophecy through choice
340
- - **Resurrection**: Becoming The One by choosing to believe
341
-
342
- **Thematic Resolution**: Destiny and choice are intertwined. We become our fate by choosing it.
343
-
344
- **Techniques Used**:
345
- - Chosen One narrative
346
- - Oracle as fate's representative
347
- - Visual symbolism (red pill/blue pill as choice)
348
- - Death and resurrection proving destiny
349
- - Ambiguity about whether choice or fate prevails
350
-
351
- ---
352
-
353
- ## Integration with Other Features
354
-
355
- ### Compatible Genres
356
-
357
- - **Tragedy**: Classic fate narratives
358
- - **Science Fiction**: Time travel and prediction
359
- - **Fantasy**: Prophecies and chosen ones
360
- - **Drama**: Personal destiny and choice
361
- - **Thriller**: Racing against predicted outcomes
362
- - **Romance**: Fated love stories
363
-
364
- ### Compatible Themes (Multi-Theme Stories)
365
-
366
- - **Choice**: The tension between fate and free will
367
- - **Identity**: Discovering one's destined role
368
- - **Sacrifice**: Accepting fate's demands
369
- - **Rebellion**: Fighting against destiny
370
- - **Acceptance**: Making peace with fate
371
- - **Time**: The relationship between past, present, and future
372
-
373
- ### Compatible Styles
374
-
375
- - **Non-Linear**: Showing fate's inevitability through structure
376
- - **Circular**: Emphasizing cyclical nature of fate
377
- - **Tragic**: Classical fate narratives
378
- - **Epic**: Large-scale destinies
379
-
380
- ## Common Pitfalls
381
-
382
- ### Pitfall 1: Removing All Agency
383
-
384
- **Problem**: Characters have no choices, making the story feel predetermined and unengaging.
385
-
386
- **Solution**: Show characters making meaningful choices even within fate's framework.
387
-
388
- **Example**: Let characters choose how they fulfill their destiny, not just whether.
389
-
390
- ---
391
-
392
- ### Pitfall 2: Fate as Deus Ex Machina
393
-
394
- **Problem**: Fate used as convenient plot device to resolve problems.
395
-
396
- **Solution**: Make fate integral to theme and character arc, not just plot convenience.
397
-
398
- **Example**: Fate should create dramatic tension, not eliminate it.
399
-
400
- ---
401
-
402
- ### Pitfall 3: Unclear Rules
403
-
404
- **Problem**: Inconsistent about whether fate can be changed or not.
405
-
406
- **Solution**: Establish clear rules about how fate works in your story.
407
-
408
- **Example**: Decide whether fate is fixed or changeable and stick to it.
409
-
410
- ---
411
-
412
- ### Pitfall 4: Passive Protagonist
413
-
414
- **Problem**: Character accepts fate without struggle or question.
415
-
416
- **Solution**: Show the character actively engaging with their destiny.
417
-
418
- **Example**: Let them fight, question, or struggle with fate before acceptance.
419
-
420
- ---
421
-
422
- ### Pitfall 5: No Thematic Payoff
423
-
424
- **Problem**: Story doesn't answer whether fate or free will prevails.
425
-
426
- **Solution**: Take a position on the fate vs. free will question.
427
-
428
- **Example**: Demonstrate through the ending whether choice or destiny wins.
429
-
430
- ---
431
-
432
- ## Best Practices
433
-
434
- 1. **Establish clear rules** - Define how fate works in your story
435
- 2. **Create dramatic irony** - Let audience see fate the character doesn't
436
- 3. **Show the struggle** - Characters should engage with their destiny
437
- 4. **Use structure** - Let narrative structure reflect fate's inevitability
438
- 5. **Maintain agency** - Characters should make meaningful choices
439
- 6. **Create ambiguity** - Leave room for interpretation
440
- 7. **Use visual motifs** - Clocks, paths, circles representing fate
441
- 8. **Connect to character arc** - Fate should drive transformation
442
- 9. **Avoid preachiness** - Let structure demonstrate theme
443
- 10. **Answer the question** - Take a position on fate vs. free will
444
-
445
- ## Resources
446
-
447
- - *Oedipus Rex* by Sophocles - Classic fate tragedy
448
- - *The Hero with a Thousand Faces* by Joseph Campbell - Destiny in mythic journey
449
- - *Story* by Robert McKee - Fate and inevitability in narrative
450
- - *The Anatomy of Story* by John Truby - Destiny and character arc
451
- - *Poetics* by Aristotle - Fate in tragic structure
452
-
453
- ---
454
-
455
- **Depth Coverage**: 85%
456
- **Last Updated**: 2026-01-31
457
- **Version**: 1.0.0
458
-
459
-
1
+ # Fate Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ The fate theme explores destiny versus free will, examining whether our lives are predetermined or shaped by our choices, and whether we can escape or must accept our destiny.
10
+
11
+ ## Core Concept
12
+
13
+ Fate in storytelling represents the tension between predetermined destiny and personal agency. It explores prophecy, inevitability, the illusion of choice, and the question of whether we control our lives or are controlled by forces beyond our understanding.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of fate explores whether our lives are predetermined or shaped by choice, examining whether destiny can be escaped or must be accepted, and what role free will plays in our outcomes.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Establish the Prophecy or Destiny
22
+
23
+ **Description**: Fate stories require a clear prophecy, prediction, or sense of inevitable destiny that the character must confront.
24
+
25
+ **Why It Matters**: Fate without a specific destiny is just randomness. The prophecy creates dramatic tension.
26
+
27
+ **Application**:
28
+ - **Act I**: Introduce the prophecy, prediction, or sense of destiny
29
+ - **Act II**: Show the character trying to escape or fulfill the destiny
30
+ - **Act III**: Reveal whether the prophecy was fulfilled, subverted, or self-fulfilling
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *Oedipus Rex*, the prophecy that Oedipus will kill his father and marry his mother drives the entire story
34
+ - ❌ **Bad**: Vague sense of destiny without specific prophecy or prediction
35
+
36
+ ---
37
+
38
+ ### Rule 2: Create the Illusion of Choice
39
+
40
+ **Description**: Characters should believe they have free will and make choices, even if those choices lead to the fated outcome.
41
+
42
+ **Why It Matters**: This explores whether our choices matter or if we're puppets of destiny.
43
+
44
+ **Application**:
45
+ - **Act I**: Show the character making choices they believe are free
46
+ - **Act II**: Reveal how choices may be leading to fated outcome
47
+ - **Act III**: Answer whether choices mattered or destiny was inevitable
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *Minority Report*, John's attempts to avoid the predicted murder lead him toward it
51
+ - ❌ **Bad**: The character is passive, making no choices
52
+
53
+ ---
54
+
55
+ ### Rule 3: Explore Self-Fulfilling Prophecy
56
+
57
+ **Description**: Often, attempts to avoid fate are what cause it. The character's choices to escape destiny bring it about.
58
+
59
+ **Why It Matters**: This creates tragic irony and explores how fear of fate can create fate.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish the prophecy and the character's fear of it
63
+ - **Act II**: Show attempts to avoid fate that ironically lead toward it
64
+ - **Act III**: Reveal how the character's choices fulfilled the prophecy
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *Oedipus Rex*, Oedipus's attempts to avoid killing his father lead him to do exactly that
68
+ - ❌ **Bad**: Fate happens independently of the character's choices
69
+
70
+ ---
71
+
72
+ ### Rule 4: Question Whether Fate Can Be Changed
73
+
74
+ **Description**: The story should explore whether destiny is fixed or if free will can alter outcomes.
75
+
76
+ **Why It Matters**: This is the central philosophical question of fate themes.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish the seemingly inevitable destiny
80
+ - **Act II**: Show attempts to change fate
81
+ - **Act III**: Answer whether fate was changed, fulfilled, or reinterpreted
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *The Matrix*, Neo must decide if he's The One or if he can choose his own path
85
+ - ❌ **Bad**: The story doesn't explore whether fate can be changed
86
+
87
+ ---
88
+
89
+ ### Rule 5: Show the Cost of Fighting or Accepting Fate
90
+
91
+ **Description**: Whether the character fights or accepts their destiny, there must be consequences and costs.
92
+
93
+ **Why It Matters**: The choice about fate must be meaningful with real stakes.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish what fighting or accepting fate will cost
97
+ - **Act II**: Show the character paying the price of their choice
98
+ - **Act III**: Demonstrate the full consequences
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *Arrival*, Louise accepts her fated future despite knowing the pain it will bring
102
+ - ❌ **Bad**: Fighting or accepting fate has no consequences
103
+
104
+ ---
105
+
106
+ ### Rule 6: Differentiate Fate from Consequence
107
+
108
+ **Description**: True fate is predetermined, while consequence is the result of choices. Explore whether outcomes are fated or earned.
109
+
110
+ **Why It Matters**: This distinction creates moral complexity about responsibility.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish whether outcomes seem fated or earned
114
+ - **Act II**: Blur the line between fate and consequence
115
+ - **Act III**: Reveal whether outcomes were destiny or the result of choices
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *No Country for Old Men*, Moss's fate seems both inevitable and the result of his choices
119
+ - ❌ **Bad**: Everything is either pure fate or pure choice with no ambiguity
120
+
121
+ ---
122
+
123
+ ## Integration Guidelines
124
+
125
+ ### Act I: Setup
126
+
127
+ **Thematic Introduction**:
128
+ - Introduce prophecy, prediction, or sense of predetermined destiny
129
+ - Establish the character's initial relationship with fate
130
+ - Show what the character believes about free will vs. destiny
131
+ - Plant seeds of the fated outcome
132
+
133
+ **Character Connection**:
134
+ - Demonstrate the character's desire for control over their life
135
+ - Show their awareness (or ignorance) of their destiny
136
+ - Establish what they're trying to achieve or avoid
137
+ - Reveal their beliefs about choice and destiny
138
+
139
+ **Visual/Symbolic Introduction**:
140
+ - Use visual motifs representing fate (clocks, paths, prophecies)
141
+ - Establish symbolic objects connected to destiny
142
+ - Create visual language for inevitability vs. choice
143
+
144
+ ### Act II: Development
145
+
146
+ **Thematic Exploration**:
147
+ - Show the character attempting to control or escape their fate
148
+ - Demonstrate how their choices lead toward the fated outcome
149
+ - Create situations where fate and free will seem to conflict
150
+ - Show the character questioning whether they have any control
151
+
152
+ **Subtext Techniques**:
153
+ - Use dialogue about destiny, choice, and control
154
+ - Show patterns and repetitions suggesting inevitability
155
+ - Create visual callbacks to earlier moments
156
+ - Use other characters as agents of fate or advocates for choice
157
+
158
+ **Thematic Complications**:
159
+ - Attempts to avoid fate seem to cause it
160
+ - Choices feel predetermined in retrospect
161
+ - The character questions whether they're truly choosing
162
+ - Prophecies or predictions create self-fulfilling outcomes
163
+
164
+ ### Act III: Resolution
165
+
166
+ **Thematic Payoff**:
167
+ - Present the fated moment or outcome
168
+ - Reveal whether the character had choice or was predetermined
169
+ - Answer whether fate can be changed or only fulfilled
170
+ - Demonstrate the relationship between choice and destiny
171
+
172
+ **Avoiding Preachiness**:
173
+ - Let the story structure demonstrate fate vs. choice
174
+ - Avoid characters explicitly stating the theme
175
+ - Show ambiguity—leave room for interpretation
176
+ - Allow for complexity in the relationship between fate and free will
177
+
178
+ ## Character Connection
179
+
180
+ ### Protagonist
181
+
182
+ **Thematic Relationship**: The protagonist's journey explores whether they control their destiny or are controlled by it.
183
+
184
+ **Arc Integration**: The character arc should reflect the struggle between accepting fate and asserting free will.
185
+
186
+ **Key Moments**:
187
+ - **Thematic Introduction**: The moment they learn of their fate or feel destiny's pull
188
+ - **Thematic Challenge**: The moment they try to change or escape their fate
189
+ - **Thematic Resolution**: The moment they fulfill or defy their destiny
190
+
191
+ ### Antagonist
192
+
193
+ **Thematic Opposition**: The antagonist may represent fate itself, or forces trying to ensure the fated outcome occurs.
194
+
195
+ **Thematic Function**: The antagonist tests whether the protagonist can escape or must accept their destiny.
196
+
197
+ ### Supporting Characters
198
+
199
+ **Thematic Mirrors**: Supporting characters represent different relationships with fate:
200
+ - The character who accepts their destiny peacefully
201
+ - The character who fights fate and suffers for it
202
+ - The oracle or prophet who knows what's coming
203
+ - The skeptic who denies fate's existence
204
+
205
+ **Thematic Perspectives**: Different characters embody different beliefs about fate—whether it exists, whether it can be changed, whether fighting it matters.
206
+
207
+ ## Subtext Techniques
208
+
209
+ ### Dialogue
210
+
211
+ - Characters discuss destiny, choice, and control without being explicit
212
+ - Use metaphors of paths, threads, wheels
213
+ - Create conversations about whether events were meant to be
214
+ - Include moments where characters question their agency
215
+
216
+ ### Visual Storytelling
217
+
218
+ - **Visual motifs**: Clocks, paths, circles, threads, prophecies
219
+ - **Color palette**: Often darker tones suggesting inevitability
220
+ - **Symbolic imagery**: Objects representing destiny or choice
221
+ - **Repetition**: Visual patterns suggesting fate's inevitability
222
+
223
+ ### Action and Behavior
224
+
225
+ - Show characters making choices that lead to fated outcomes
226
+ - Demonstrate attempts to escape fate that cause it
227
+ - Create moments where coincidence seems too perfect
228
+ - Show the character recognizing patterns
229
+
230
+ ## Film Examples
231
+
232
+ ### Example 1: Oedipus Rex (Various Adaptations)
233
+
234
+ **Director**: Various
235
+
236
+ **Thematic Exploration**: The classic fate story—exploring whether prophecy can be avoided or whether attempts to escape fate cause it.
237
+
238
+ **Key Thematic Moments**:
239
+ - **The prophecy**: Oedipus will kill his father and marry his mother
240
+ - **Fleeing Corinth**: Attempting to escape fate
241
+ - **Killing at the crossroads**: Unknowingly fulfilling prophecy
242
+ - **Solving the Sphinx**: Gaining power through intelligence
243
+ - **The revelation**: Discovering he fulfilled the prophecy exactly
244
+
245
+ **Thematic Resolution**: Fate cannot be escaped. Attempts to avoid destiny cause it. Free will is an illusion.
246
+
247
+ **Techniques Used**:
248
+ - Dramatic irony (audience knows what character doesn't)
249
+ - Tragic structure emphasizing inevitability
250
+ - Investigation revealing predetermined past
251
+ - Recognition scene showing fate's completion
252
+ - Blindness as metaphor for not seeing destiny
253
+
254
+ ---
255
+
256
+ ### Example 2: Arrival (2016)
257
+
258
+ **Director**: Denis Villeneuve
259
+
260
+ **Thematic Exploration**: Explores whether knowing the future changes it, examining the relationship between free will and predetermined outcomes.
261
+
262
+ **Key Thematic Moments**:
263
+ - **Learning the language**: Gaining ability to see time non-linearly
264
+ - **Seeing her daughter's life**: Knowing the future, including tragedy
265
+ - **The choice**: Deciding to have her daughter despite knowing she'll die
266
+ - **Preventing war**: Using future knowledge to change the present
267
+ - **Accepting fate**: Choosing the path despite knowing the pain
268
+
269
+ **Thematic Resolution**: Knowing fate doesn't eliminate choice. We can choose our destiny even knowing the outcome.
270
+
271
+ **Techniques Used**:
272
+ - Non-linear narrative structure
273
+ - Flashforwards revealed as memories of future
274
+ - Circular time structure
275
+ - Visual language emphasizing circles and loops
276
+ - Ambiguous relationship between knowledge and choice
277
+
278
+ ---
279
+
280
+ ### Example 3: Minority Report (2002)
281
+
282
+ **Director**: Steven Spielberg
283
+
284
+ **Thematic Exploration**: Explores whether the future is fixed or changeable, examining free will in a world of perfect prediction.
285
+
286
+ **Key Thematic Moments**:
287
+ - **PreCrime system**: Future murders predicted and prevented
288
+ - **John's prediction**: Seeing himself commit murder
289
+ - **Attempting to avoid fate**: Trying to change the predicted future
290
+ - **The setup**: Discovering the prediction was manipulated
291
+ - **The choice**: Moment where he can fulfill or defy the prediction
292
+
293
+ **Thematic Resolution**: The future can be changed. Predictions create possibilities, not certainties. Free will exists.
294
+
295
+ **Techniques Used**:
296
+ - Sci-fi premise making fate literal
297
+ - Visual prediction sequences
298
+ - Chase structure (running from fate)
299
+ - Twist revealing manipulation
300
+ - Choice at climax proving free will
301
+
302
+ ---
303
+
304
+ ### Example 4: Slumdog Millionaire (2008)
305
+
306
+ **Director**: Danny Boyle
307
+
308
+ **Thematic Exploration**: Explores whether life is random or destined, examining how past experiences prepare us for future moments.
309
+
310
+ **Key Thematic Moments**:
311
+ - **Game show questions**: Each perfectly matching Jamal's life experiences
312
+ - **Flashback structure**: Showing how he knows each answer
313
+ - **"It is written"**: Destiny vs. coincidence
314
+ - **Reuniting with Latika**: Fated love across obstacles
315
+ - **Final question**: Ultimate test of destiny
316
+
317
+ **Thematic Resolution**: Life's experiences prepare us for our destiny. What seems like coincidence may be fate.
318
+
319
+ **Techniques Used**:
320
+ - Parallel structure (game show and life story)
321
+ - Each question triggering flashback
322
+ - Visual motifs (trains, paths)
323
+ - Romantic destiny subplot
324
+ - Triumphant ending suggesting fate rewards the worthy
325
+
326
+ ---
327
+
328
+ ### Example 5: The Matrix (1999)
329
+
330
+ **Director**: The Wachowskis
331
+
332
+ **Thematic Exploration**: Explores the illusion of choice in a predetermined system, examining whether prophecy creates destiny or reveals it.
333
+
334
+ **Key Thematic Moments**:
335
+ - **The prophecy**: Neo is "The One" who will save humanity
336
+ - **Choice vs. destiny**: Oracle's discussion of choice
337
+ - **Morpheus' faith**: Belief in Neo's destiny
338
+ - **Neo's doubt**: Questioning whether he's really The One
339
+ - **Trinity's love**: Fulfilling prophecy through choice
340
+ - **Resurrection**: Becoming The One by choosing to believe
341
+
342
+ **Thematic Resolution**: Destiny and choice are intertwined. We become our fate by choosing it.
343
+
344
+ **Techniques Used**:
345
+ - Chosen One narrative
346
+ - Oracle as fate's representative
347
+ - Visual symbolism (red pill/blue pill as choice)
348
+ - Death and resurrection proving destiny
349
+ - Ambiguity about whether choice or fate prevails
350
+
351
+ ---
352
+
353
+ ## Integration with Other Features
354
+
355
+ ### Compatible Genres
356
+
357
+ - **Tragedy**: Classic fate narratives
358
+ - **Science Fiction**: Time travel and prediction
359
+ - **Fantasy**: Prophecies and chosen ones
360
+ - **Drama**: Personal destiny and choice
361
+ - **Thriller**: Racing against predicted outcomes
362
+ - **Romance**: Fated love stories
363
+
364
+ ### Compatible Themes (Multi-Theme Stories)
365
+
366
+ - **Choice**: The tension between fate and free will
367
+ - **Identity**: Discovering one's destined role
368
+ - **Sacrifice**: Accepting fate's demands
369
+ - **Rebellion**: Fighting against destiny
370
+ - **Acceptance**: Making peace with fate
371
+ - **Time**: The relationship between past, present, and future
372
+
373
+ ### Compatible Styles
374
+
375
+ - **Non-Linear**: Showing fate's inevitability through structure
376
+ - **Circular**: Emphasizing cyclical nature of fate
377
+ - **Tragic**: Classical fate narratives
378
+ - **Epic**: Large-scale destinies
379
+
380
+ ## Common Pitfalls
381
+
382
+ ### Pitfall 1: Removing All Agency
383
+
384
+ **Problem**: Characters have no choices, making the story feel predetermined and unengaging.
385
+
386
+ **Solution**: Show characters making meaningful choices even within fate's framework.
387
+
388
+ **Example**: Let characters choose how they fulfill their destiny, not just whether.
389
+
390
+ ---
391
+
392
+ ### Pitfall 2: Fate as Deus Ex Machina
393
+
394
+ **Problem**: Fate used as convenient plot device to resolve problems.
395
+
396
+ **Solution**: Make fate integral to theme and character arc, not just plot convenience.
397
+
398
+ **Example**: Fate should create dramatic tension, not eliminate it.
399
+
400
+ ---
401
+
402
+ ### Pitfall 3: Unclear Rules
403
+
404
+ **Problem**: Inconsistent about whether fate can be changed or not.
405
+
406
+ **Solution**: Establish clear rules about how fate works in your story.
407
+
408
+ **Example**: Decide whether fate is fixed or changeable and stick to it.
409
+
410
+ ---
411
+
412
+ ### Pitfall 4: Passive Protagonist
413
+
414
+ **Problem**: Character accepts fate without struggle or question.
415
+
416
+ **Solution**: Show the character actively engaging with their destiny.
417
+
418
+ **Example**: Let them fight, question, or struggle with fate before acceptance.
419
+
420
+ ---
421
+
422
+ ### Pitfall 5: No Thematic Payoff
423
+
424
+ **Problem**: Story doesn't answer whether fate or free will prevails.
425
+
426
+ **Solution**: Take a position on the fate vs. free will question.
427
+
428
+ **Example**: Demonstrate through the ending whether choice or destiny wins.
429
+
430
+ ---
431
+
432
+ ## Best Practices
433
+
434
+ 1. **Establish clear rules** - Define how fate works in your story
435
+ 2. **Create dramatic irony** - Let audience see fate the character doesn't
436
+ 3. **Show the struggle** - Characters should engage with their destiny
437
+ 4. **Use structure** - Let narrative structure reflect fate's inevitability
438
+ 5. **Maintain agency** - Characters should make meaningful choices
439
+ 6. **Create ambiguity** - Leave room for interpretation
440
+ 7. **Use visual motifs** - Clocks, paths, circles representing fate
441
+ 8. **Connect to character arc** - Fate should drive transformation
442
+ 9. **Avoid preachiness** - Let structure demonstrate theme
443
+ 10. **Answer the question** - Take a position on fate vs. free will
444
+
445
+ ## Resources
446
+
447
+ - *Oedipus Rex* by Sophocles - Classic fate tragedy
448
+ - *The Hero with a Thousand Faces* by Joseph Campbell - Destiny in mythic journey
449
+ - *Story* by Robert McKee - Fate and inevitability in narrative
450
+ - *The Anatomy of Story* by John Truby - Destiny and character arc
451
+ - *Poetics* by Aristotle - Fate in tragic structure
452
+
453
+ ---
454
+
455
+ **Depth Coverage**: 85%
456
+ **Last Updated**: 2026-01-31
457
+ **Version**: 1.0.0
458
+
459
+