@mytechtoday/augment-extensions 0.7.0 → 1.2.1

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,509 +1,509 @@
1
- # Flashback-Heavy Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Structural/Temporal
5
- **Complexity**: Medium-High
6
-
7
- ## Overview
8
-
9
- Flashback-heavy narrative uses extensive flashbacks as primary structural device, moving fluidly between past and present to reveal character, backstory, and thematic connections. This style creates layered temporal storytelling where past and present illuminate each other.
10
-
11
- ## Core Concept
12
-
13
- Flashback-driven screenwriting treats time as malleable, using the past to deepen understanding of the present. The power lies in strategic revelation—showing the right past moment at the right present moment to create maximum impact. Success requires clear temporal navigation, purposeful flashback placement, and ensuring past scenes earn their screen time.
14
-
15
- ## Definition
16
-
17
- A flashback-heavy narrative uses extensive flashbacks as a primary structural element, moving between past and present to reveal character development, backstory, and thematic connections that deepen the present-day narrative.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Clear Temporal Markers
22
-
23
- **Description**: Audience must always know when they are in time.
24
-
25
- **Why It Matters**: Confusion about timeline destroys narrative clarity.
26
-
27
- **Implementation**:
28
- - Use visual cues (color, aspect ratio, film stock)
29
- - Clear FLASHBACK notation in script
30
- - Consistent temporal markers
31
- - Smooth transitions
32
-
33
- **Examples**:
34
- - ✅ **Good**: Distinct visual style for each time period
35
- - ❌ **Bad**: Unclear when scenes take place
36
-
37
- **Film Reference**: The Godfather Part II (1974) - Sepia-toned past vs. color present.
38
-
39
- ---
40
-
41
- ### Requirement 2: Purposeful Placement
42
-
43
- **Description**: Each flashback must serve clear narrative purpose at that specific moment.
44
-
45
- **Why It Matters**: Random flashbacks disrupt flow without adding value.
46
-
47
- **Implementation**:
48
- - Flashbacks triggered by present events
49
- - Reveal information at optimal moment
50
- - Create thematic resonance
51
- - Advance understanding
52
-
53
- **Examples**:
54
- - ✅ **Good**: Present crisis triggers relevant past memory
55
- - ❌ **Bad**: Random flashback with no connection to present
56
-
57
- **Film Reference**: Eternal Sunshine of the Spotless Mind (2004) - Flashbacks reveal relationship as it's erased.
58
-
59
- ---
60
-
61
- ### Requirement 3: Dual Narrative Momentum
62
-
63
- **Description**: Both past and present timelines must have their own dramatic momentum.
64
-
65
- **Why It Matters**: Flashbacks can't just be exposition; they need their own stakes.
66
-
67
- **Implementation**:
68
- - Past timeline has its own arc
69
- - Present timeline maintains momentum
70
- - Both timelines build tension
71
- - Parallel dramatic development
72
-
73
- **Examples**:
74
- - ✅ **Good**: Past and present both have rising action
75
- - ❌ **Bad**: Flashbacks are static exposition dumps
76
-
77
- **Film Reference**: The Godfather Part II (1974) - Vito's rise parallels Michael's fall.
78
-
79
- ---
80
-
81
- ### Requirement 4: Thematic Connection
82
-
83
- **Description**: Past and present must connect thematically, not just plot-wise.
84
-
85
- **Why It Matters**: Flashbacks should deepen meaning, not just provide information.
86
-
87
- **Implementation**:
88
- - Create thematic parallels
89
- - Show how past shapes present
90
- - Reveal character patterns
91
- - Illuminate themes
92
-
93
- **Examples**:
94
- - ✅ **Good**: Past trauma explains present behavior thematically
95
- - ❌ **Bad**: Flashback only provides plot information
96
-
97
- **Film Reference**: Arrival (2016) - "Flashbacks" recontextualize entire narrative thematically.
98
-
99
- ---
100
-
101
- ### Requirement 5: Strategic Revelation
102
-
103
- **Description**: Control what information is revealed when for maximum impact.
104
-
105
- **Why It Matters**: Flashback structure enables strategic information control.
106
-
107
- **Implementation**:
108
- - Withhold key information
109
- - Reveal at optimal dramatic moment
110
- - Create recontextualization
111
- - Build to revelations
112
-
113
- **Examples**:
114
- - ✅ **Good**: Flashback reveals crucial information that reframes everything
115
- - ❌ **Bad**: All information revealed chronologically
116
-
117
- **Film Reference**: The Usual Suspects (1995) - Flashbacks build to revelation.
118
-
119
- ---
120
-
121
- ### Requirement 6: Smooth Integration
122
-
123
- **Description**: Flashbacks must integrate smoothly into narrative flow.
124
-
125
- **Why It Matters**: Jarring flashbacks disrupt audience engagement.
126
-
127
- **Implementation**:
128
- - Motivated transitions
129
- - Visual or thematic bridges
130
- - Natural flow between timelines
131
- - Seamless integration
132
-
133
- **Examples**:
134
- - ✅ **Good**: Object in present triggers memory of same object in past
135
- - ❌ **Bad**: Abrupt, unmotivated jumps to past
136
-
137
- **Film Reference**: Slumdog Millionaire (2008) - Quiz questions trigger relevant flashbacks.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Balance between past and present
146
- - Vary flashback length and frequency
147
- - Build momentum in both timelines
148
- - Create rhythm through temporal shifts
149
-
150
- ### Scene Length
151
-
152
- - Flashbacks can be brief or extended
153
- - Vary length for pacing
154
- - Longer flashbacks need their own structure
155
- - Brief flashbacks for quick revelation
156
-
157
- ### Act Structure
158
-
159
- - Both timelines may have act structure
160
- - Or flashbacks punctuate present-day acts
161
- - Timelines may converge
162
- - Flexible structure
163
-
164
- ### Transitions
165
-
166
- - Motivated transitions (visual, thematic, audio)
167
- - Match cuts between timelines
168
- - Dissolves for memory
169
- - Smooth temporal navigation
170
-
171
- ## Visual Storytelling
172
-
173
- ### Camera Work
174
-
175
- - Distinct visual style for each timeline
176
- - Consistent cinematography per period
177
- - Visual cues for temporal shifts
178
- - Smooth transitions
179
-
180
- ### Visual Motifs
181
-
182
- - Recurring objects across timelines
183
- - Visual parallels between past/present
184
- - Symbolic connections
185
- - Thematic imagery
186
-
187
- ### Action Lines
188
-
189
- - Clear FLASHBACK notation
190
- - Describe temporal transitions
191
- - Visual cues noted
192
- - Smooth flow
193
-
194
- **Example**:
195
- ```
196
- INT. APARTMENT - NIGHT - PRESENT
197
-
198
- Sarah holds the locket, opens it.
199
-
200
- INSERT - PHOTOGRAPH in locket. Young couple, happy.
201
-
202
- FLASHBACK TO:
203
-
204
- EXT. PARK - DAY - 1995
205
-
206
- YOUNG SARAH (20s) and JAMES (20s) laugh together. He gives her the locket.
207
- ```
208
-
209
- ## Dialogue Approach
210
-
211
- ### Dialogue Style
212
-
213
- - Dialogue can trigger flashbacks
214
- - Past dialogue may echo in present
215
- - Verbal parallels between timelines
216
- - Natural speech in each period
217
-
218
- ### Subtext
219
-
220
- - Past reveals subtext of present
221
- - Present recontextualizes past
222
- - Layered meaning across timelines
223
- - Thematic connections
224
-
225
- ### Formatting
226
-
227
- - Standard dialogue formatting
228
- - Clear temporal markers
229
- - FLASHBACK notation
230
- - Smooth transitions
231
-
232
- **Example**:
233
- ```
234
- PRESENT:
235
-
236
- SARAH
237
- I can't do this anymore.
238
-
239
- FLASHBACK - 1995:
240
-
241
- YOUNG SARAH
242
- I'll never leave you.
243
-
244
- BACK TO PRESENT:
245
-
246
- Sarah's face shows the weight of broken promises.
247
- ```
248
-
249
- ## Technical Formatting
250
-
251
- ### Page Layout
252
-
253
- - Clear FLASHBACK TO: notation
254
- - BACK TO PRESENT or END FLASHBACK
255
- - Temporal markers in scene headings
256
- - Standard formatting
257
-
258
- ### Scene Headings
259
-
260
- - Include time period in heading
261
- - INT. HOUSE - NIGHT - 1995
262
- - Or INT. HOUSE - NIGHT - FLASHBACK
263
- - Consistent temporal notation
264
-
265
- ### Special Elements
266
-
267
- - FLASHBACK TO:
268
- - END FLASHBACK or BACK TO PRESENT
269
- - INTERCUT for parallel timelines
270
- - MONTAGE for multiple flashbacks
271
-
272
- ## Strengths and Limitations
273
-
274
- ### Strengths
275
-
276
- - Strategic information revelation
277
- - Deepens character understanding
278
- - Creates thematic resonance
279
- - Enables complex storytelling
280
- - Emotional impact through contrast
281
- - Mystery and revelation
282
-
283
- ### Limitations
284
-
285
- - Can disrupt present narrative momentum
286
- - Risk of confusion
287
- - May feel manipulative
288
- - Requires careful structure
289
- - Can become gimmicky
290
- - Passive storytelling risk
291
-
292
- ### Best Use Cases
293
-
294
- - Character studies
295
- - Mystery and revelation narratives
296
- - Trauma and memory stories
297
- - Parallel timeline narratives
298
- - Biographical films
299
- - Psychological dramas
300
-
301
- ## Film Examples
302
-
303
- ### Example 1: The Godfather Part II (1974)
304
-
305
- **Director**: Francis Ford Coppola
306
-
307
- **Why This Style Works**: Parallel timelines of Vito's rise and Michael's fall create thematic masterpiece.
308
-
309
- **Key Stylistic Moments**:
310
- - **Visual Distinction**: Sepia past vs. color present
311
- - **Thematic Parallels**: Father's rise mirrors son's moral fall
312
- - **Dual Narratives**: Both timelines have complete arcs
313
-
314
- **Techniques Used**:
315
- - Parallel timeline structure
316
- - Visual distinction between eras
317
- - Thematic counterpoint
318
- - Dual narrative momentum
319
-
320
- **Structural Analysis**: Past and present illuminate each other thematically, not just plot-wise.
321
-
322
- ---
323
-
324
- ### Example 2: Eternal Sunshine of the Spotless Mind (2004)
325
-
326
- **Director**: Michel Gondry
327
-
328
- **Why This Style Works**: Reverse-chronological flashbacks as memories are erased create unique structure.
329
-
330
- **Key Stylistic Moments**:
331
- - **Degrading Memories**: Flashbacks literally fall apart
332
- - **Reverse Chronology**: Moving backward through relationship
333
- - **Present Framing**: Memory erasure procedure in present
334
-
335
- **Techniques Used**:
336
- - Reverse-chronological flashbacks
337
- - Visual degradation of memories
338
- - Surreal memory sequences
339
- - Strategic revelation
340
-
341
- **Structural Analysis**: Flashback structure mirrors memory erasure process.
342
-
343
- ---
344
-
345
- ### Example 3: Slumdog Millionaire (2008)
346
-
347
- **Director**: Danny Boyle
348
-
349
- **Why This Style Works**: Quiz show questions trigger relevant flashbacks, creating motivated structure.
350
-
351
- **Key Stylistic Moments**:
352
- - **Question-Triggered**: Each question prompts specific flashback
353
- - **Three Timelines**: Childhood, adolescence, present
354
- - **Building Revelation**: Flashbacks reveal how he knows answers
355
-
356
- **Techniques Used**:
357
- - Motivated flashback triggers
358
- - Multiple past timelines
359
- - Strategic information revelation
360
- - Thematic connections
361
-
362
- **Structural Analysis**: Present-day quiz show provides framework for exploring entire life.
363
-
364
- ---
365
-
366
- ### Example 4: Arrival (2016)
367
-
368
- **Director**: Denis Villeneuve
369
-
370
- **Why This Style Works**: "Flashbacks" revealed to be flash-forwards creates profound recontextualization.
371
-
372
- **Key Stylistic Moments**:
373
- - **Assumed Flashbacks**: Audience assumes past memories
374
- - **Revelation**: "Memories" are actually future
375
- - **Thematic Integration**: Non-linear time perception
376
-
377
- **Techniques Used**:
378
- - Misleading temporal markers
379
- - Strategic revelation
380
- - Thematic flashback structure
381
- - Recontextualization
382
-
383
- **Structural Analysis**: Flashback structure itself becomes thematic exploration of time.
384
-
385
- ---
386
-
387
- ### Example 5: The Usual Suspects (1995)
388
-
389
- **Director**: Bryan Singer
390
-
391
- **Why This Style Works**: Flashbacks build mystery, then final revelation recontextualizes everything.
392
-
393
- **Key Stylistic Moments**:
394
- - **Interrogation Frame**: Present-day questioning triggers flashbacks
395
- - **Unreliable Flashbacks**: Past scenes may be fabricated
396
- - **Final Revelation**: Recontextualizes all flashbacks
397
-
398
- **Techniques Used**:
399
- - Framing device for flashbacks
400
- - Unreliable narrator
401
- - Strategic revelation
402
- - Recontextualization
403
-
404
- **Structural Analysis**: Flashback structure enables unreliable narrative and twist.
405
-
406
- ---
407
-
408
- ## Integration with Other Features
409
-
410
- ### Compatible Genres
411
-
412
- - **Drama**: Character depth through past
413
- - **Mystery**: Strategic revelation
414
- - **Thriller**: Building suspense through past
415
- - **Romance**: Relationship history
416
- - **Crime**: Revealing criminal past
417
-
418
- ### Compatible Themes
419
-
420
- - **Memory**: Natural fit for flashback structure
421
- - **Trauma**: Past wounds affecting present
422
- - **Identity**: How past shapes self
423
- - **Time**: Exploration of temporal themes
424
- - **Regret**: Past mistakes haunting present
425
-
426
- ### Style Variations
427
-
428
- - **Parallel timelines**: Equal weight to past/present (Godfather II)
429
- - **Framed flashbacks**: Present triggers past (Slumdog Millionaire)
430
- - **Reverse chronology**: Moving backward (Eternal Sunshine)
431
- - **Unreliable flashbacks**: Questionable past (The Usual Suspects)
432
-
433
- ## Common Pitfalls
434
-
435
- ### Pitfall 1: Disrupting Present Momentum
436
-
437
- **Problem**: Flashbacks interrupt present narrative flow at wrong moments.
438
-
439
- **Solution**: Place flashbacks at natural pauses or motivated moments in present.
440
-
441
- **Example**: Slumdog Millionaire uses quiz questions as natural flashback triggers.
442
-
443
- ---
444
-
445
- ### Pitfall 2: Exposition Dumps
446
-
447
- **Problem**: Flashbacks become lazy way to deliver backstory.
448
-
449
- **Solution**: Flashbacks must have their own dramatic momentum, not just provide information.
450
-
451
- **Example**: Godfather II's past timeline has complete dramatic arc.
452
-
453
- ---
454
-
455
- ### Pitfall 3: Temporal Confusion
456
-
457
- **Problem**: Audience can't tell when scenes take place.
458
-
459
- **Solution**: Use clear visual markers and consistent temporal notation.
460
-
461
- **Example**: Godfather II uses distinct visual styles for each era.
462
-
463
- ---
464
-
465
- ### Pitfall 4: Unmotivated Flashbacks
466
-
467
- **Problem**: Flashbacks appear randomly without clear trigger or purpose.
468
-
469
- **Solution**: Ensure each flashback is motivated by present events or character psychology.
470
-
471
- **Example**: Eternal Sunshine's flashbacks motivated by memory erasure process.
472
-
473
- ---
474
-
475
- ### Pitfall 5: Revealing Too Much Too Soon
476
-
477
- **Problem**: Flashbacks give away information before optimal dramatic moment.
478
-
479
- **Solution**: Control revelation strategically for maximum impact.
480
-
481
- **Example**: The Usual Suspects withholds key information until final revelation.
482
-
483
- ---
484
-
485
- ## Best Practices
486
-
487
- 1. **Clear temporal markers** - Audience must always know when they are
488
- 2. **Motivated transitions** - Flashbacks triggered by present events
489
- 3. **Dual momentum** - Both timelines need dramatic stakes
490
- 4. **Strategic revelation** - Control what's revealed when
491
- 5. **Thematic connection** - Past and present illuminate each other
492
- 6. **Visual distinction** - Different eras have different looks
493
- 7. **Smooth integration** - Seamless flow between timelines
494
- 8. **Earn screen time** - Flashbacks must justify their presence
495
-
496
- ## Resources
497
-
498
- - "Flashbacks in Film: Memory & History" by Maureen Turim - Comprehensive study
499
- - "The Godfather Part II" screenplay by Francis Ford Coppola and Mario Puzo - Parallel timelines
500
- - "Eternal Sunshine of the Spotless Mind" screenplay by Charlie Kaufman - Innovative flashback structure
501
- - "Slumdog Millionaire" screenplay by Simon Beaufoy - Motivated flashbacks
502
- - "Arrival" screenplay by Eric Heisserer - Recontextualizing flashbacks
503
-
504
- ---
505
-
506
- **Depth Coverage**: 85%
507
- **Last Updated**: 2026-01-31
508
- **Version**: 1.0.0
509
-
1
+ # Flashback-Heavy Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Structural/Temporal
5
+ **Complexity**: Medium-High
6
+
7
+ ## Overview
8
+
9
+ Flashback-heavy narrative uses extensive flashbacks as primary structural device, moving fluidly between past and present to reveal character, backstory, and thematic connections. This style creates layered temporal storytelling where past and present illuminate each other.
10
+
11
+ ## Core Concept
12
+
13
+ Flashback-driven screenwriting treats time as malleable, using the past to deepen understanding of the present. The power lies in strategic revelation—showing the right past moment at the right present moment to create maximum impact. Success requires clear temporal navigation, purposeful flashback placement, and ensuring past scenes earn their screen time.
14
+
15
+ ## Definition
16
+
17
+ A flashback-heavy narrative uses extensive flashbacks as a primary structural element, moving between past and present to reveal character development, backstory, and thematic connections that deepen the present-day narrative.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Clear Temporal Markers
22
+
23
+ **Description**: Audience must always know when they are in time.
24
+
25
+ **Why It Matters**: Confusion about timeline destroys narrative clarity.
26
+
27
+ **Implementation**:
28
+ - Use visual cues (color, aspect ratio, film stock)
29
+ - Clear FLASHBACK notation in script
30
+ - Consistent temporal markers
31
+ - Smooth transitions
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Distinct visual style for each time period
35
+ - ❌ **Bad**: Unclear when scenes take place
36
+
37
+ **Film Reference**: The Godfather Part II (1974) - Sepia-toned past vs. color present.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Purposeful Placement
42
+
43
+ **Description**: Each flashback must serve clear narrative purpose at that specific moment.
44
+
45
+ **Why It Matters**: Random flashbacks disrupt flow without adding value.
46
+
47
+ **Implementation**:
48
+ - Flashbacks triggered by present events
49
+ - Reveal information at optimal moment
50
+ - Create thematic resonance
51
+ - Advance understanding
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Present crisis triggers relevant past memory
55
+ - ❌ **Bad**: Random flashback with no connection to present
56
+
57
+ **Film Reference**: Eternal Sunshine of the Spotless Mind (2004) - Flashbacks reveal relationship as it's erased.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Dual Narrative Momentum
62
+
63
+ **Description**: Both past and present timelines must have their own dramatic momentum.
64
+
65
+ **Why It Matters**: Flashbacks can't just be exposition; they need their own stakes.
66
+
67
+ **Implementation**:
68
+ - Past timeline has its own arc
69
+ - Present timeline maintains momentum
70
+ - Both timelines build tension
71
+ - Parallel dramatic development
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Past and present both have rising action
75
+ - ❌ **Bad**: Flashbacks are static exposition dumps
76
+
77
+ **Film Reference**: The Godfather Part II (1974) - Vito's rise parallels Michael's fall.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Thematic Connection
82
+
83
+ **Description**: Past and present must connect thematically, not just plot-wise.
84
+
85
+ **Why It Matters**: Flashbacks should deepen meaning, not just provide information.
86
+
87
+ **Implementation**:
88
+ - Create thematic parallels
89
+ - Show how past shapes present
90
+ - Reveal character patterns
91
+ - Illuminate themes
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Past trauma explains present behavior thematically
95
+ - ❌ **Bad**: Flashback only provides plot information
96
+
97
+ **Film Reference**: Arrival (2016) - "Flashbacks" recontextualize entire narrative thematically.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Strategic Revelation
102
+
103
+ **Description**: Control what information is revealed when for maximum impact.
104
+
105
+ **Why It Matters**: Flashback structure enables strategic information control.
106
+
107
+ **Implementation**:
108
+ - Withhold key information
109
+ - Reveal at optimal dramatic moment
110
+ - Create recontextualization
111
+ - Build to revelations
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Flashback reveals crucial information that reframes everything
115
+ - ❌ **Bad**: All information revealed chronologically
116
+
117
+ **Film Reference**: The Usual Suspects (1995) - Flashbacks build to revelation.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Smooth Integration
122
+
123
+ **Description**: Flashbacks must integrate smoothly into narrative flow.
124
+
125
+ **Why It Matters**: Jarring flashbacks disrupt audience engagement.
126
+
127
+ **Implementation**:
128
+ - Motivated transitions
129
+ - Visual or thematic bridges
130
+ - Natural flow between timelines
131
+ - Seamless integration
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Object in present triggers memory of same object in past
135
+ - ❌ **Bad**: Abrupt, unmotivated jumps to past
136
+
137
+ **Film Reference**: Slumdog Millionaire (2008) - Quiz questions trigger relevant flashbacks.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Balance between past and present
146
+ - Vary flashback length and frequency
147
+ - Build momentum in both timelines
148
+ - Create rhythm through temporal shifts
149
+
150
+ ### Scene Length
151
+
152
+ - Flashbacks can be brief or extended
153
+ - Vary length for pacing
154
+ - Longer flashbacks need their own structure
155
+ - Brief flashbacks for quick revelation
156
+
157
+ ### Act Structure
158
+
159
+ - Both timelines may have act structure
160
+ - Or flashbacks punctuate present-day acts
161
+ - Timelines may converge
162
+ - Flexible structure
163
+
164
+ ### Transitions
165
+
166
+ - Motivated transitions (visual, thematic, audio)
167
+ - Match cuts between timelines
168
+ - Dissolves for memory
169
+ - Smooth temporal navigation
170
+
171
+ ## Visual Storytelling
172
+
173
+ ### Camera Work
174
+
175
+ - Distinct visual style for each timeline
176
+ - Consistent cinematography per period
177
+ - Visual cues for temporal shifts
178
+ - Smooth transitions
179
+
180
+ ### Visual Motifs
181
+
182
+ - Recurring objects across timelines
183
+ - Visual parallels between past/present
184
+ - Symbolic connections
185
+ - Thematic imagery
186
+
187
+ ### Action Lines
188
+
189
+ - Clear FLASHBACK notation
190
+ - Describe temporal transitions
191
+ - Visual cues noted
192
+ - Smooth flow
193
+
194
+ **Example**:
195
+ ```
196
+ INT. APARTMENT - NIGHT - PRESENT
197
+
198
+ Sarah holds the locket, opens it.
199
+
200
+ INSERT - PHOTOGRAPH in locket. Young couple, happy.
201
+
202
+ FLASHBACK TO:
203
+
204
+ EXT. PARK - DAY - 1995
205
+
206
+ YOUNG SARAH (20s) and JAMES (20s) laugh together. He gives her the locket.
207
+ ```
208
+
209
+ ## Dialogue Approach
210
+
211
+ ### Dialogue Style
212
+
213
+ - Dialogue can trigger flashbacks
214
+ - Past dialogue may echo in present
215
+ - Verbal parallels between timelines
216
+ - Natural speech in each period
217
+
218
+ ### Subtext
219
+
220
+ - Past reveals subtext of present
221
+ - Present recontextualizes past
222
+ - Layered meaning across timelines
223
+ - Thematic connections
224
+
225
+ ### Formatting
226
+
227
+ - Standard dialogue formatting
228
+ - Clear temporal markers
229
+ - FLASHBACK notation
230
+ - Smooth transitions
231
+
232
+ **Example**:
233
+ ```
234
+ PRESENT:
235
+
236
+ SARAH
237
+ I can't do this anymore.
238
+
239
+ FLASHBACK - 1995:
240
+
241
+ YOUNG SARAH
242
+ I'll never leave you.
243
+
244
+ BACK TO PRESENT:
245
+
246
+ Sarah's face shows the weight of broken promises.
247
+ ```
248
+
249
+ ## Technical Formatting
250
+
251
+ ### Page Layout
252
+
253
+ - Clear FLASHBACK TO: notation
254
+ - BACK TO PRESENT or END FLASHBACK
255
+ - Temporal markers in scene headings
256
+ - Standard formatting
257
+
258
+ ### Scene Headings
259
+
260
+ - Include time period in heading
261
+ - INT. HOUSE - NIGHT - 1995
262
+ - Or INT. HOUSE - NIGHT - FLASHBACK
263
+ - Consistent temporal notation
264
+
265
+ ### Special Elements
266
+
267
+ - FLASHBACK TO:
268
+ - END FLASHBACK or BACK TO PRESENT
269
+ - INTERCUT for parallel timelines
270
+ - MONTAGE for multiple flashbacks
271
+
272
+ ## Strengths and Limitations
273
+
274
+ ### Strengths
275
+
276
+ - Strategic information revelation
277
+ - Deepens character understanding
278
+ - Creates thematic resonance
279
+ - Enables complex storytelling
280
+ - Emotional impact through contrast
281
+ - Mystery and revelation
282
+
283
+ ### Limitations
284
+
285
+ - Can disrupt present narrative momentum
286
+ - Risk of confusion
287
+ - May feel manipulative
288
+ - Requires careful structure
289
+ - Can become gimmicky
290
+ - Passive storytelling risk
291
+
292
+ ### Best Use Cases
293
+
294
+ - Character studies
295
+ - Mystery and revelation narratives
296
+ - Trauma and memory stories
297
+ - Parallel timeline narratives
298
+ - Biographical films
299
+ - Psychological dramas
300
+
301
+ ## Film Examples
302
+
303
+ ### Example 1: The Godfather Part II (1974)
304
+
305
+ **Director**: Francis Ford Coppola
306
+
307
+ **Why This Style Works**: Parallel timelines of Vito's rise and Michael's fall create thematic masterpiece.
308
+
309
+ **Key Stylistic Moments**:
310
+ - **Visual Distinction**: Sepia past vs. color present
311
+ - **Thematic Parallels**: Father's rise mirrors son's moral fall
312
+ - **Dual Narratives**: Both timelines have complete arcs
313
+
314
+ **Techniques Used**:
315
+ - Parallel timeline structure
316
+ - Visual distinction between eras
317
+ - Thematic counterpoint
318
+ - Dual narrative momentum
319
+
320
+ **Structural Analysis**: Past and present illuminate each other thematically, not just plot-wise.
321
+
322
+ ---
323
+
324
+ ### Example 2: Eternal Sunshine of the Spotless Mind (2004)
325
+
326
+ **Director**: Michel Gondry
327
+
328
+ **Why This Style Works**: Reverse-chronological flashbacks as memories are erased create unique structure.
329
+
330
+ **Key Stylistic Moments**:
331
+ - **Degrading Memories**: Flashbacks literally fall apart
332
+ - **Reverse Chronology**: Moving backward through relationship
333
+ - **Present Framing**: Memory erasure procedure in present
334
+
335
+ **Techniques Used**:
336
+ - Reverse-chronological flashbacks
337
+ - Visual degradation of memories
338
+ - Surreal memory sequences
339
+ - Strategic revelation
340
+
341
+ **Structural Analysis**: Flashback structure mirrors memory erasure process.
342
+
343
+ ---
344
+
345
+ ### Example 3: Slumdog Millionaire (2008)
346
+
347
+ **Director**: Danny Boyle
348
+
349
+ **Why This Style Works**: Quiz show questions trigger relevant flashbacks, creating motivated structure.
350
+
351
+ **Key Stylistic Moments**:
352
+ - **Question-Triggered**: Each question prompts specific flashback
353
+ - **Three Timelines**: Childhood, adolescence, present
354
+ - **Building Revelation**: Flashbacks reveal how he knows answers
355
+
356
+ **Techniques Used**:
357
+ - Motivated flashback triggers
358
+ - Multiple past timelines
359
+ - Strategic information revelation
360
+ - Thematic connections
361
+
362
+ **Structural Analysis**: Present-day quiz show provides framework for exploring entire life.
363
+
364
+ ---
365
+
366
+ ### Example 4: Arrival (2016)
367
+
368
+ **Director**: Denis Villeneuve
369
+
370
+ **Why This Style Works**: "Flashbacks" revealed to be flash-forwards creates profound recontextualization.
371
+
372
+ **Key Stylistic Moments**:
373
+ - **Assumed Flashbacks**: Audience assumes past memories
374
+ - **Revelation**: "Memories" are actually future
375
+ - **Thematic Integration**: Non-linear time perception
376
+
377
+ **Techniques Used**:
378
+ - Misleading temporal markers
379
+ - Strategic revelation
380
+ - Thematic flashback structure
381
+ - Recontextualization
382
+
383
+ **Structural Analysis**: Flashback structure itself becomes thematic exploration of time.
384
+
385
+ ---
386
+
387
+ ### Example 5: The Usual Suspects (1995)
388
+
389
+ **Director**: Bryan Singer
390
+
391
+ **Why This Style Works**: Flashbacks build mystery, then final revelation recontextualizes everything.
392
+
393
+ **Key Stylistic Moments**:
394
+ - **Interrogation Frame**: Present-day questioning triggers flashbacks
395
+ - **Unreliable Flashbacks**: Past scenes may be fabricated
396
+ - **Final Revelation**: Recontextualizes all flashbacks
397
+
398
+ **Techniques Used**:
399
+ - Framing device for flashbacks
400
+ - Unreliable narrator
401
+ - Strategic revelation
402
+ - Recontextualization
403
+
404
+ **Structural Analysis**: Flashback structure enables unreliable narrative and twist.
405
+
406
+ ---
407
+
408
+ ## Integration with Other Features
409
+
410
+ ### Compatible Genres
411
+
412
+ - **Drama**: Character depth through past
413
+ - **Mystery**: Strategic revelation
414
+ - **Thriller**: Building suspense through past
415
+ - **Romance**: Relationship history
416
+ - **Crime**: Revealing criminal past
417
+
418
+ ### Compatible Themes
419
+
420
+ - **Memory**: Natural fit for flashback structure
421
+ - **Trauma**: Past wounds affecting present
422
+ - **Identity**: How past shapes self
423
+ - **Time**: Exploration of temporal themes
424
+ - **Regret**: Past mistakes haunting present
425
+
426
+ ### Style Variations
427
+
428
+ - **Parallel timelines**: Equal weight to past/present (Godfather II)
429
+ - **Framed flashbacks**: Present triggers past (Slumdog Millionaire)
430
+ - **Reverse chronology**: Moving backward (Eternal Sunshine)
431
+ - **Unreliable flashbacks**: Questionable past (The Usual Suspects)
432
+
433
+ ## Common Pitfalls
434
+
435
+ ### Pitfall 1: Disrupting Present Momentum
436
+
437
+ **Problem**: Flashbacks interrupt present narrative flow at wrong moments.
438
+
439
+ **Solution**: Place flashbacks at natural pauses or motivated moments in present.
440
+
441
+ **Example**: Slumdog Millionaire uses quiz questions as natural flashback triggers.
442
+
443
+ ---
444
+
445
+ ### Pitfall 2: Exposition Dumps
446
+
447
+ **Problem**: Flashbacks become lazy way to deliver backstory.
448
+
449
+ **Solution**: Flashbacks must have their own dramatic momentum, not just provide information.
450
+
451
+ **Example**: Godfather II's past timeline has complete dramatic arc.
452
+
453
+ ---
454
+
455
+ ### Pitfall 3: Temporal Confusion
456
+
457
+ **Problem**: Audience can't tell when scenes take place.
458
+
459
+ **Solution**: Use clear visual markers and consistent temporal notation.
460
+
461
+ **Example**: Godfather II uses distinct visual styles for each era.
462
+
463
+ ---
464
+
465
+ ### Pitfall 4: Unmotivated Flashbacks
466
+
467
+ **Problem**: Flashbacks appear randomly without clear trigger or purpose.
468
+
469
+ **Solution**: Ensure each flashback is motivated by present events or character psychology.
470
+
471
+ **Example**: Eternal Sunshine's flashbacks motivated by memory erasure process.
472
+
473
+ ---
474
+
475
+ ### Pitfall 5: Revealing Too Much Too Soon
476
+
477
+ **Problem**: Flashbacks give away information before optimal dramatic moment.
478
+
479
+ **Solution**: Control revelation strategically for maximum impact.
480
+
481
+ **Example**: The Usual Suspects withholds key information until final revelation.
482
+
483
+ ---
484
+
485
+ ## Best Practices
486
+
487
+ 1. **Clear temporal markers** - Audience must always know when they are
488
+ 2. **Motivated transitions** - Flashbacks triggered by present events
489
+ 3. **Dual momentum** - Both timelines need dramatic stakes
490
+ 4. **Strategic revelation** - Control what's revealed when
491
+ 5. **Thematic connection** - Past and present illuminate each other
492
+ 6. **Visual distinction** - Different eras have different looks
493
+ 7. **Smooth integration** - Seamless flow between timelines
494
+ 8. **Earn screen time** - Flashbacks must justify their presence
495
+
496
+ ## Resources
497
+
498
+ - "Flashbacks in Film: Memory & History" by Maureen Turim - Comprehensive study
499
+ - "The Godfather Part II" screenplay by Francis Ford Coppola and Mario Puzo - Parallel timelines
500
+ - "Eternal Sunshine of the Spotless Mind" screenplay by Charlie Kaufman - Innovative flashback structure
501
+ - "Slumdog Millionaire" screenplay by Simon Beaufoy - Motivated flashbacks
502
+ - "Arrival" screenplay by Eric Heisserer - Recontextualizing flashbacks
503
+
504
+ ---
505
+
506
+ **Depth Coverage**: 85%
507
+ **Last Updated**: 2026-01-31
508
+ **Version**: 1.0.0
509
+