@mytechtoday/augment-extensions 0.5.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (523) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +113 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +15 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +576 -23
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/config-system.d.ts +111 -0
  476. package/cli/dist/utils/config-system.d.ts.map +1 -0
  477. package/cli/dist/utils/config-system.js +239 -0
  478. package/cli/dist/utils/config-system.js.map +1 -0
  479. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  480. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  481. package/cli/dist/utils/extractCommandHelp.js +250 -0
  482. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  483. package/cli/dist/utils/hook-system.d.ts +84 -0
  484. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  485. package/cli/dist/utils/hook-system.js +151 -0
  486. package/cli/dist/utils/hook-system.js.map +1 -0
  487. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  488. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  489. package/cli/dist/utils/inspection-cache.js +166 -0
  490. package/cli/dist/utils/inspection-cache.js.map +1 -0
  491. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  492. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  493. package/cli/dist/utils/inspection-handlers.js +171 -0
  494. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  495. package/cli/dist/utils/install-rules.js +55 -55
  496. package/cli/dist/utils/mcp-integration.js +44 -44
  497. package/cli/dist/utils/module-system.d.ts +1 -0
  498. package/cli/dist/utils/module-system.d.ts.map +1 -1
  499. package/cli/dist/utils/module-system.js +8 -3
  500. package/cli/dist/utils/module-system.js.map +1 -1
  501. package/cli/dist/utils/plugin-system.d.ts +133 -0
  502. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  503. package/cli/dist/utils/plugin-system.js +210 -0
  504. package/cli/dist/utils/plugin-system.js.map +1 -0
  505. package/cli/dist/utils/progress.d.ts +67 -0
  506. package/cli/dist/utils/progress.d.ts.map +1 -0
  507. package/cli/dist/utils/progress.js +146 -0
  508. package/cli/dist/utils/progress.js.map +1 -0
  509. package/cli/dist/utils/rule-install-hooks.js +8 -8
  510. package/cli/dist/utils/stream-reader.d.ts +34 -0
  511. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  512. package/cli/dist/utils/stream-reader.js +147 -0
  513. package/cli/dist/utils/stream-reader.js.map +1 -0
  514. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  515. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  516. package/cli/dist/utils/vscode-editor.js +171 -0
  517. package/cli/dist/utils/vscode-editor.js.map +1 -0
  518. package/cli/dist/utils/vscode-links.d.ts +49 -0
  519. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  520. package/cli/dist/utils/vscode-links.js +167 -0
  521. package/cli/dist/utils/vscode-links.js.map +1 -0
  522. package/modules.md +667 -630
  523. package/package.json +85 -85
@@ -1,501 +1,501 @@
1
- # Non-Linear Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Structural
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Non-linear narrative presents story events out of chronological order, using flashbacks, flash-forwards, parallel timelines, or fragmented sequences. This approach emphasizes thematic connections, mystery, and complex character revelation over straightforward temporal progression.
10
-
11
- ## Core Concept
12
-
13
- Non-linear narratives challenge audiences to actively construct the story's chronology, creating engagement through puzzle-solving and delayed revelation. The power lies in controlling what information is revealed when, allowing thematic resonance between different time periods and creating dramatic irony through temporal juxtaposition.
14
-
15
- ## Definition
16
-
17
- A non-linear narrative deliberately disrupts chronological order to serve thematic, emotional, or structural purposes. Time jumps, parallel timelines, or reverse chronology replace traditional beginning-middle-end progression.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Clear Temporal Markers
22
-
23
- **Description**: Each scene must clearly indicate its place in the timeline through visual cues, titles, or contextual information.
24
-
25
- **Why It Matters**: Audiences need anchors to construct chronology mentally. Confusion kills engagement.
26
-
27
- **Implementation**:
28
- - Use title cards with dates/times
29
- - Visual markers (character age, technology, seasons)
30
- - Dialogue references to establish when
31
- - Consistent color grading per timeline
32
-
33
- **Examples**:
34
- - ✅ **Good**: "PARIS - 1942" title card, black-and-white cinematography
35
- - ❌ **Bad**: Jumping between time periods with no visual or textual indicators
36
-
37
- **Film Reference**: The Godfather Part II (1974) - Sepia-toned past vs. color present, clear title cards.
38
-
39
- ---
40
-
41
- ### Requirement 2: Thematic Justification
42
-
43
- **Description**: Non-linear structure must serve the story's themes, not exist for stylistic flash.
44
-
45
- **Why It Matters**: Arbitrary time-jumping frustrates audiences. Structure should illuminate meaning.
46
-
47
- **Implementation**:
48
- - Juxtapose scenes that comment on each other
49
- - Use temporal structure to reveal character psychology
50
- - Create dramatic irony through timeline placement
51
- - Ensure non-linear approach enhances understanding
52
-
53
- **Examples**:
54
- - ✅ **Good**: Showing character's traumatic past alongside present breakdown
55
- - ❌ **Bad**: Random time jumps that could be rearranged without changing meaning
56
-
57
- **Film Reference**: Eternal Sunshine of the Spotless Mind (2004) - Reverse chronology mirrors memory erasure process.
58
-
59
- ---
60
-
61
- ### Requirement 3: Audience Orientation Points
62
-
63
- **Description**: Provide regular touchstones that help audiences track multiple timelines.
64
-
65
- **Why It Matters**: Viewers need reference points to avoid complete disorientation.
66
-
67
- **Implementation**:
68
- - Return to one "present" timeline regularly
69
- - Use recurring visual motifs per timeline
70
- - Establish clear "before" and "after" markers
71
- - Create pattern in timeline shifts
72
-
73
- **Examples**:
74
- - ✅ **Good**: Returning to interrogation room between flashbacks
75
- - ❌ **Bad**: Constantly shifting timelines with no anchor point
76
-
77
- **Film Reference**: The Usual Suspects (1995) - Interrogation room as present-tense anchor.
78
-
79
- ---
80
-
81
- ### Requirement 4: Purposeful Revelation
82
-
83
- **Description**: Control information release to create specific emotional or intellectual effects.
84
-
85
- **Why It Matters**: Non-linear structure's power is in what's revealed when.
86
-
87
- **Implementation**:
88
- - Withhold key information until maximum impact
89
- - Create dramatic irony through timeline placement
90
- - Build mystery through strategic gaps
91
- - Ensure each timeline shift reveals something new
92
-
93
- **Examples**:
94
- - ✅ **Good**: Revealing character's death early, then showing how it happened
95
- - ❌ **Bad**: Showing events out of order with no revelation payoff
96
-
97
- **Film Reference**: Memento (2000) - Reverse chronology creates mystery about protagonist's reliability.
98
-
99
- ---
100
-
101
- ### Requirement 5: Convergence Point
102
-
103
- **Description**: Multiple timelines must converge or illuminate each other by the climax.
104
-
105
- **Why It Matters**: Fragmented narratives need payoff where pieces come together.
106
-
107
- **Implementation**:
108
- - Build toward moment where timelines meet
109
- - Create revelation when past/present connect
110
- - Ensure all timeline threads resolve
111
- - Make convergence emotionally satisfying
112
-
113
- **Examples**:
114
- - ✅ **Good**: Past and present timelines collide in climactic revelation
115
- - ❌ **Bad**: Timelines remain separate with no connection or payoff
116
-
117
- **Film Reference**: Arrival (2016) - Future visions converge with present to reveal true nature of time.
118
-
119
- ---
120
-
121
- ### Requirement 6: Consistent Internal Logic
122
-
123
- **Description**: Establish and maintain rules for how time shifts work within your narrative.
124
-
125
- **Why It Matters**: Even non-linear narratives need internal consistency.
126
-
127
- **Implementation**:
128
- - Define what triggers time shifts
129
- - Maintain consistent transition style
130
- - Follow established temporal rules
131
- - Avoid arbitrary changes to structure
132
-
133
- **Examples**:
134
- - ✅ **Good**: Every time character touches object, flashback to its origin
135
- - ❌ **Bad**: Sometimes flashbacks are memories, sometimes dreams, sometimes unclear
136
-
137
- **Film Reference**: Dunkirk (2017) - Three timelines with different durations (week/day/hour) maintained consistently.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Vary scene length across timelines to create rhythm
146
- - Use time shifts to control pacing and tension
147
- - Accelerate cuts between timelines as climax approaches
148
- - Balance exposition-heavy past with action-heavy present
149
-
150
- ### Scene Length
151
-
152
- - Shorter scenes when rapidly cutting between timelines
153
- - Longer scenes when establishing new time period
154
- - Vary length to prevent predictable pattern
155
- - Use scene duration to signal importance
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish multiple timelines and their relationships (30% of runtime)
160
- - **Act II**: Develop each timeline while building toward convergence (40% of runtime)
161
- - **Act III**: Converge timelines and resolve all threads (30% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Use match cuts between timelines
166
- - Audio bridges across time periods
167
- - Visual motifs that link different eras
168
- - Abrupt cuts for jarring effect
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Distinct camera styles for different timelines
175
- - Match compositions across time periods for thematic links
176
- - Use camera movement to signal time shifts
177
- - Maintain visual coherence within each timeline
178
-
179
- ### Visual Motifs
180
-
181
- - Color grading to distinguish timelines
182
- - Recurring objects that appear in multiple periods
183
- - Visual parallels between different time periods
184
- - Symbolic imagery that transcends time
185
-
186
- ### Action Lines
187
-
188
- - Clearly indicate time period in scene headings
189
- - Use present tense within each timeline
190
- - Note visual distinctions between timelines
191
- - Describe transitions between time periods
192
-
193
- **Example**:
194
- ```
195
- INT. APARTMENT - NIGHT (2020)
196
-
197
- Sarah stares at the photograph.
198
-
199
- MATCH CUT TO:
200
-
201
- INT. SAME APARTMENT - NIGHT (2010)
202
-
203
- Younger Sarah takes the same photograph.
204
- ```
205
-
206
- ## Dialogue Approach
207
-
208
- ### Dialogue Style
209
-
210
- - Characters speak naturally within their timeline
211
- - Avoid over-explaining temporal relationships
212
- - Use dialogue to establish time period subtly
213
- - Create echoes and parallels across timelines
214
-
215
- ### Subtext
216
-
217
- - Dramatic irony from audience knowing multiple timelines
218
- - Characters unaware of future/past events
219
- - Dialogue gains meaning from temporal context
220
- - Subtext emerges from timeline juxtaposition
221
-
222
- ### Formatting
223
-
224
- - Standard formatting within each timeline
225
- - Clear scene headings indicate time period
226
- - Minimal exposition about time shifts
227
- - Let structure speak for itself
228
-
229
- **Example**:
230
- ```
231
- YOUNG JOHN
232
- I'll never leave you.
233
-
234
- CUT TO:
235
-
236
- INT. AIRPORT - DAY (PRESENT)
237
-
238
- OLDER JOHN
239
- (to phone)
240
- I'm not coming back.
241
- ```
242
-
243
- ## Technical Formatting
244
-
245
- ### Page Layout
246
-
247
- - Use title cards for major time shifts
248
- - Consider different fonts/formatting per timeline
249
- - Maintain standard margins and spacing
250
- - Clear visual separation between timelines
251
-
252
- ### Scene Headings
253
-
254
- - Include time period in parentheses: INT. HOUSE - DAY (1985)
255
- - Use consistent format for each timeline
256
- - Number scenes chronologically as written, not story order
257
- - Consider color-coding in drafts
258
-
259
- ### Special Elements
260
-
261
- - FLASHBACK/FLASH-FORWARD when appropriate
262
- - INTERCUT for parallel timelines
263
- - MONTAGE for rapid time progression
264
- - TITLE CARD for major temporal shifts
265
-
266
- ## Strengths and Limitations
267
-
268
- ### Strengths
269
-
270
- - Creates mystery and suspense through controlled revelation
271
- - Allows thematic juxtaposition of different time periods
272
- - Engages audiences actively in constructing narrative
273
- - Reveals character through temporal contrast
274
- - Enables complex exploration of memory and perception
275
-
276
- ### Limitations
277
-
278
- - Risk of confusing or alienating audiences
279
- - Requires more exposition to establish timelines
280
- - Can feel gimmicky if not thematically justified
281
- - Difficult to maintain emotional continuity
282
- - May sacrifice character development for structure
283
-
284
- ### Best Use Cases
285
-
286
- - Mystery/thriller narratives with revelatory structure
287
- - Character studies exploring past trauma's present impact
288
- - Stories about memory, time, or perception
289
- - Complex relationship dramas showing evolution
290
- - Narratives where chronology itself is thematic
291
-
292
- ## Film Examples
293
-
294
- ### Example 1: Pulp Fiction (1994)
295
-
296
- **Director**: Quentin Tarantino
297
-
298
- **Why This Style Works**: Non-linear structure creates thematic connections between seemingly unrelated stories and allows dead characters to reappear, emphasizing randomness and fate.
299
-
300
- **Key Stylistic Moments**:
301
- - **Opening**: Diner robbery bookends film despite occurring mid-chronology
302
- - **Vincent's Death**: Shown before his final scenes, creating dramatic irony
303
- - **Gold Watch Story**: Past and present interweave to build character depth
304
-
305
- **Techniques Used**:
306
- - Chapter structure with non-chronological arrangement
307
- - Thematic rather than temporal connections
308
- - Circular narrative returning to opening
309
- - Character reappearances after death
310
-
311
- **Structural Analysis**: Three main stories rearranged to create thematic resonance, with chronology serving character and theme over plot.
312
-
313
- ---
314
-
315
- ### Example 2: Memento (2000)
316
-
317
- **Director**: Christopher Nolan
318
-
319
- **Why This Style Works**: Reverse chronology mirrors protagonist's condition, forcing audience to experience his confusion and unreliable memory.
320
-
321
- **Key Stylistic Moments**:
322
- - **Color/Black-and-white**: Two timelines moving in opposite directions
323
- - **Reverse Scenes**: Each color scene moves backward in time
324
- - **Convergence**: Timelines meet at climactic revelation
325
-
326
- **Techniques Used**:
327
- - Reverse chronological color sequences
328
- - Forward chronological black-and-white sequences
329
- - Visual distinction between timelines
330
- - Puzzle-box structure
331
-
332
- **Structural Analysis**: Innovative dual-timeline structure where one moves forward, one backward, meeting in the middle for maximum revelation.
333
-
334
- ---
335
-
336
- ### Example 3: Arrival (2016)
337
-
338
- **Director**: Denis Villeneuve
339
-
340
- **Why This Style Works**: Non-linear perception of time becomes the story's central theme, with "flashbacks" revealed as flash-forwards.
341
-
342
- **Key Stylistic Moments**:
343
- - **Opening Montage**: Assumed past revealed as future
344
- - **Language Learning**: Present timeline drives narrative
345
- - **Revelation**: Past/future distinction collapses
346
-
347
- **Techniques Used**:
348
- - Deliberate misdirection about timeline
349
- - Thematic integration of non-linear time
350
- - Visual consistency across all timelines
351
- - Emotional payoff from temporal revelation
352
-
353
- **Structural Analysis**: Linear present-tense narrative interwoven with what appears to be past but is actually future, creating profound thematic statement.
354
-
355
- ---
356
-
357
- ### Example 4: The Godfather Part II (1974)
358
-
359
- **Director**: Francis Ford Coppola
360
-
361
- **Why This Style Works**: Parallel timelines of father and son create thematic contrast between rise and fall, immigration and corruption.
362
-
363
- **Key Stylistic Moments**:
364
- - **Visual Distinction**: Sepia past vs. color present
365
- - **Thematic Parallels**: Vito's rise mirrors Michael's moral descent
366
- - **Convergence**: Both timelines end with family isolation
367
-
368
- **Techniques Used**:
369
- - Clear visual distinction between timelines
370
- - Thematic rather than plot connections
371
- - Parallel character arcs across generations
372
- - Intercutting for maximum contrast
373
-
374
- **Structural Analysis**: Two complete narratives intercut to illuminate each other thematically, with neither timeline subordinate to the other.
375
-
376
- ---
377
-
378
- ### Example 5: Dunkirk (2017)
379
-
380
- **Director**: Christopher Nolan
381
-
382
- **Why This Style Works**: Three timelines of different durations (week/day/hour) converge at single moment, creating tension through temporal compression.
383
-
384
- **Key Stylistic Moments**:
385
- - **The Mole**: Week-long timeline establishes stakes
386
- - **The Sea**: Day-long timeline shows civilian rescue
387
- - **The Air**: Hour-long timeline provides action climax
388
- - **Convergence**: All three meet at beach evacuation
389
-
390
- **Techniques Used**:
391
- - Three distinct timelines with different durations
392
- - Intercutting accelerates as timelines converge
393
- - Minimal dialogue emphasizes visual storytelling
394
- - Ticking clock in each timeline
395
-
396
- **Structural Analysis**: Complex temporal structure where different-length timelines run simultaneously and converge, requiring careful audience orientation.
397
-
398
- ---
399
-
400
- ## Integration with Other Features
401
-
402
- ### Compatible Genres
403
-
404
- - **Mystery**: Non-linear revelation creates suspense
405
- - **Thriller**: Temporal manipulation builds tension
406
- - **Drama**: Past/present contrast deepens character
407
- - **Sci-Fi**: Time travel or perception naturally non-linear
408
- - **Crime**: Investigation structure supports flashbacks
409
-
410
- ### Compatible Themes
411
-
412
- - **Memory**: Non-linear structure mirrors how memory works
413
- - **Trauma**: Past intrudes on present naturally
414
- - **Identity**: Character revealed through temporal layers
415
- - **Fate vs. Free Will**: Knowing future creates dramatic irony
416
- - **Truth**: Multiple perspectives across time reveal complexity
417
-
418
- ### Style Variations
419
-
420
- - **Reverse chronology**: Story told backward (Memento)
421
- - **Parallel timelines**: Multiple periods intercut (The Godfather Part II)
422
- - **Framing device**: Present wraps around past (The Usual Suspects)
423
- - **Puzzle structure**: Fragments assembled (Pulp Fiction)
424
-
425
- ## Common Pitfalls
426
-
427
- ### Pitfall 1: Confusion Over Cleverness
428
-
429
- **Problem**: Non-linear structure becomes so complex that audiences lose track of basic plot.
430
-
431
- **Solution**: Provide clear temporal markers and regular orientation points. Test screenplay with readers unfamiliar with the story.
432
-
433
- **Example**: Use consistent visual cues (color grading, title cards, character age) to distinguish timelines clearly.
434
-
435
- ---
436
-
437
- ### Pitfall 2: Gimmick Without Purpose
438
-
439
- **Problem**: Non-linear structure used for style points rather than thematic necessity.
440
-
441
- **Solution**: Ask if story would lose meaning if told chronologically. If not, reconsider structure.
442
-
443
- **Example**: Memento's reverse chronology is essential to experiencing protagonist's condition; removing it would destroy the film's purpose.
444
-
445
- ---
446
-
447
- ### Pitfall 3: Exposition Overload
448
-
449
- **Problem**: Spending too much time explaining temporal relationships through dialogue.
450
-
451
- **Solution**: Trust visual storytelling and audience intelligence. Show, don't tell, temporal connections.
452
-
453
- **Example**: Use match cuts, visual parallels, and contextual clues rather than characters explaining "this was ten years ago."
454
-
455
- ---
456
-
457
- ### Pitfall 4: Unresolved Timelines
458
-
459
- **Problem**: Introducing timeline threads that never connect or resolve.
460
-
461
- **Solution**: Ensure every timeline serves the whole and converges or illuminates by the end.
462
-
463
- **Example**: Every timeline in Dunkirk converges at the beach evacuation, providing satisfying resolution to all threads.
464
-
465
- ---
466
-
467
- ### Pitfall 5: Sacrificing Character for Structure
468
-
469
- **Problem**: Focusing so much on temporal puzzle that character development suffers.
470
-
471
- **Solution**: Use non-linear structure to deepen character, not replace character work.
472
-
473
- **Example**: Arrival uses non-linear time to explore protagonist's emotional journey, not just as intellectual puzzle.
474
-
475
- ---
476
-
477
- ## Best Practices
478
-
479
- 1. **Establish temporal rules early** - Help audiences understand how time shifts work
480
- 2. **Use visual distinction** - Color, aspect ratio, or cinematography to mark timelines
481
- 3. **Create thematic connections** - Juxtapose scenes that comment on each other
482
- 4. **Provide orientation points** - Regular returns to anchor timeline
483
- 5. **Build toward convergence** - All timelines should illuminate or meet
484
- 6. **Test for clarity** - Ensure audiences can construct chronology
485
- 7. **Justify the structure** - Non-linear approach should be thematically essential
486
- 8. **Trust your audience** - Don't over-explain temporal relationships
487
-
488
- ## Resources
489
-
490
- - "Screenplay: The Foundations of Screenwriting" by Syd Field - Non-linear structure chapter
491
- - "The Anatomy of Story" by John Truby - Complex narrative structures
492
- - "Invisible Ink" by Brian McDonald - Thematic justification for structure
493
- - "Memento" screenplay by Christopher Nolan - Master class in reverse chronology
494
- - "Pulp Fiction" screenplay by Quentin Tarantino - Non-linear chapter structure
495
-
496
- ---
497
-
498
- **Depth Coverage**: 85%
499
- **Last Updated**: 2026-01-31
500
- **Version**: 1.0.0
501
-
1
+ # Non-Linear Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Structural
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Non-linear narrative presents story events out of chronological order, using flashbacks, flash-forwards, parallel timelines, or fragmented sequences. This approach emphasizes thematic connections, mystery, and complex character revelation over straightforward temporal progression.
10
+
11
+ ## Core Concept
12
+
13
+ Non-linear narratives challenge audiences to actively construct the story's chronology, creating engagement through puzzle-solving and delayed revelation. The power lies in controlling what information is revealed when, allowing thematic resonance between different time periods and creating dramatic irony through temporal juxtaposition.
14
+
15
+ ## Definition
16
+
17
+ A non-linear narrative deliberately disrupts chronological order to serve thematic, emotional, or structural purposes. Time jumps, parallel timelines, or reverse chronology replace traditional beginning-middle-end progression.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Clear Temporal Markers
22
+
23
+ **Description**: Each scene must clearly indicate its place in the timeline through visual cues, titles, or contextual information.
24
+
25
+ **Why It Matters**: Audiences need anchors to construct chronology mentally. Confusion kills engagement.
26
+
27
+ **Implementation**:
28
+ - Use title cards with dates/times
29
+ - Visual markers (character age, technology, seasons)
30
+ - Dialogue references to establish when
31
+ - Consistent color grading per timeline
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: "PARIS - 1942" title card, black-and-white cinematography
35
+ - ❌ **Bad**: Jumping between time periods with no visual or textual indicators
36
+
37
+ **Film Reference**: The Godfather Part II (1974) - Sepia-toned past vs. color present, clear title cards.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Thematic Justification
42
+
43
+ **Description**: Non-linear structure must serve the story's themes, not exist for stylistic flash.
44
+
45
+ **Why It Matters**: Arbitrary time-jumping frustrates audiences. Structure should illuminate meaning.
46
+
47
+ **Implementation**:
48
+ - Juxtapose scenes that comment on each other
49
+ - Use temporal structure to reveal character psychology
50
+ - Create dramatic irony through timeline placement
51
+ - Ensure non-linear approach enhances understanding
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Showing character's traumatic past alongside present breakdown
55
+ - ❌ **Bad**: Random time jumps that could be rearranged without changing meaning
56
+
57
+ **Film Reference**: Eternal Sunshine of the Spotless Mind (2004) - Reverse chronology mirrors memory erasure process.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Audience Orientation Points
62
+
63
+ **Description**: Provide regular touchstones that help audiences track multiple timelines.
64
+
65
+ **Why It Matters**: Viewers need reference points to avoid complete disorientation.
66
+
67
+ **Implementation**:
68
+ - Return to one "present" timeline regularly
69
+ - Use recurring visual motifs per timeline
70
+ - Establish clear "before" and "after" markers
71
+ - Create pattern in timeline shifts
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Returning to interrogation room between flashbacks
75
+ - ❌ **Bad**: Constantly shifting timelines with no anchor point
76
+
77
+ **Film Reference**: The Usual Suspects (1995) - Interrogation room as present-tense anchor.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Purposeful Revelation
82
+
83
+ **Description**: Control information release to create specific emotional or intellectual effects.
84
+
85
+ **Why It Matters**: Non-linear structure's power is in what's revealed when.
86
+
87
+ **Implementation**:
88
+ - Withhold key information until maximum impact
89
+ - Create dramatic irony through timeline placement
90
+ - Build mystery through strategic gaps
91
+ - Ensure each timeline shift reveals something new
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Revealing character's death early, then showing how it happened
95
+ - ❌ **Bad**: Showing events out of order with no revelation payoff
96
+
97
+ **Film Reference**: Memento (2000) - Reverse chronology creates mystery about protagonist's reliability.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Convergence Point
102
+
103
+ **Description**: Multiple timelines must converge or illuminate each other by the climax.
104
+
105
+ **Why It Matters**: Fragmented narratives need payoff where pieces come together.
106
+
107
+ **Implementation**:
108
+ - Build toward moment where timelines meet
109
+ - Create revelation when past/present connect
110
+ - Ensure all timeline threads resolve
111
+ - Make convergence emotionally satisfying
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Past and present timelines collide in climactic revelation
115
+ - ❌ **Bad**: Timelines remain separate with no connection or payoff
116
+
117
+ **Film Reference**: Arrival (2016) - Future visions converge with present to reveal true nature of time.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Consistent Internal Logic
122
+
123
+ **Description**: Establish and maintain rules for how time shifts work within your narrative.
124
+
125
+ **Why It Matters**: Even non-linear narratives need internal consistency.
126
+
127
+ **Implementation**:
128
+ - Define what triggers time shifts
129
+ - Maintain consistent transition style
130
+ - Follow established temporal rules
131
+ - Avoid arbitrary changes to structure
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Every time character touches object, flashback to its origin
135
+ - ❌ **Bad**: Sometimes flashbacks are memories, sometimes dreams, sometimes unclear
136
+
137
+ **Film Reference**: Dunkirk (2017) - Three timelines with different durations (week/day/hour) maintained consistently.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Vary scene length across timelines to create rhythm
146
+ - Use time shifts to control pacing and tension
147
+ - Accelerate cuts between timelines as climax approaches
148
+ - Balance exposition-heavy past with action-heavy present
149
+
150
+ ### Scene Length
151
+
152
+ - Shorter scenes when rapidly cutting between timelines
153
+ - Longer scenes when establishing new time period
154
+ - Vary length to prevent predictable pattern
155
+ - Use scene duration to signal importance
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish multiple timelines and their relationships (30% of runtime)
160
+ - **Act II**: Develop each timeline while building toward convergence (40% of runtime)
161
+ - **Act III**: Converge timelines and resolve all threads (30% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Use match cuts between timelines
166
+ - Audio bridges across time periods
167
+ - Visual motifs that link different eras
168
+ - Abrupt cuts for jarring effect
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Distinct camera styles for different timelines
175
+ - Match compositions across time periods for thematic links
176
+ - Use camera movement to signal time shifts
177
+ - Maintain visual coherence within each timeline
178
+
179
+ ### Visual Motifs
180
+
181
+ - Color grading to distinguish timelines
182
+ - Recurring objects that appear in multiple periods
183
+ - Visual parallels between different time periods
184
+ - Symbolic imagery that transcends time
185
+
186
+ ### Action Lines
187
+
188
+ - Clearly indicate time period in scene headings
189
+ - Use present tense within each timeline
190
+ - Note visual distinctions between timelines
191
+ - Describe transitions between time periods
192
+
193
+ **Example**:
194
+ ```
195
+ INT. APARTMENT - NIGHT (2020)
196
+
197
+ Sarah stares at the photograph.
198
+
199
+ MATCH CUT TO:
200
+
201
+ INT. SAME APARTMENT - NIGHT (2010)
202
+
203
+ Younger Sarah takes the same photograph.
204
+ ```
205
+
206
+ ## Dialogue Approach
207
+
208
+ ### Dialogue Style
209
+
210
+ - Characters speak naturally within their timeline
211
+ - Avoid over-explaining temporal relationships
212
+ - Use dialogue to establish time period subtly
213
+ - Create echoes and parallels across timelines
214
+
215
+ ### Subtext
216
+
217
+ - Dramatic irony from audience knowing multiple timelines
218
+ - Characters unaware of future/past events
219
+ - Dialogue gains meaning from temporal context
220
+ - Subtext emerges from timeline juxtaposition
221
+
222
+ ### Formatting
223
+
224
+ - Standard formatting within each timeline
225
+ - Clear scene headings indicate time period
226
+ - Minimal exposition about time shifts
227
+ - Let structure speak for itself
228
+
229
+ **Example**:
230
+ ```
231
+ YOUNG JOHN
232
+ I'll never leave you.
233
+
234
+ CUT TO:
235
+
236
+ INT. AIRPORT - DAY (PRESENT)
237
+
238
+ OLDER JOHN
239
+ (to phone)
240
+ I'm not coming back.
241
+ ```
242
+
243
+ ## Technical Formatting
244
+
245
+ ### Page Layout
246
+
247
+ - Use title cards for major time shifts
248
+ - Consider different fonts/formatting per timeline
249
+ - Maintain standard margins and spacing
250
+ - Clear visual separation between timelines
251
+
252
+ ### Scene Headings
253
+
254
+ - Include time period in parentheses: INT. HOUSE - DAY (1985)
255
+ - Use consistent format for each timeline
256
+ - Number scenes chronologically as written, not story order
257
+ - Consider color-coding in drafts
258
+
259
+ ### Special Elements
260
+
261
+ - FLASHBACK/FLASH-FORWARD when appropriate
262
+ - INTERCUT for parallel timelines
263
+ - MONTAGE for rapid time progression
264
+ - TITLE CARD for major temporal shifts
265
+
266
+ ## Strengths and Limitations
267
+
268
+ ### Strengths
269
+
270
+ - Creates mystery and suspense through controlled revelation
271
+ - Allows thematic juxtaposition of different time periods
272
+ - Engages audiences actively in constructing narrative
273
+ - Reveals character through temporal contrast
274
+ - Enables complex exploration of memory and perception
275
+
276
+ ### Limitations
277
+
278
+ - Risk of confusing or alienating audiences
279
+ - Requires more exposition to establish timelines
280
+ - Can feel gimmicky if not thematically justified
281
+ - Difficult to maintain emotional continuity
282
+ - May sacrifice character development for structure
283
+
284
+ ### Best Use Cases
285
+
286
+ - Mystery/thriller narratives with revelatory structure
287
+ - Character studies exploring past trauma's present impact
288
+ - Stories about memory, time, or perception
289
+ - Complex relationship dramas showing evolution
290
+ - Narratives where chronology itself is thematic
291
+
292
+ ## Film Examples
293
+
294
+ ### Example 1: Pulp Fiction (1994)
295
+
296
+ **Director**: Quentin Tarantino
297
+
298
+ **Why This Style Works**: Non-linear structure creates thematic connections between seemingly unrelated stories and allows dead characters to reappear, emphasizing randomness and fate.
299
+
300
+ **Key Stylistic Moments**:
301
+ - **Opening**: Diner robbery bookends film despite occurring mid-chronology
302
+ - **Vincent's Death**: Shown before his final scenes, creating dramatic irony
303
+ - **Gold Watch Story**: Past and present interweave to build character depth
304
+
305
+ **Techniques Used**:
306
+ - Chapter structure with non-chronological arrangement
307
+ - Thematic rather than temporal connections
308
+ - Circular narrative returning to opening
309
+ - Character reappearances after death
310
+
311
+ **Structural Analysis**: Three main stories rearranged to create thematic resonance, with chronology serving character and theme over plot.
312
+
313
+ ---
314
+
315
+ ### Example 2: Memento (2000)
316
+
317
+ **Director**: Christopher Nolan
318
+
319
+ **Why This Style Works**: Reverse chronology mirrors protagonist's condition, forcing audience to experience his confusion and unreliable memory.
320
+
321
+ **Key Stylistic Moments**:
322
+ - **Color/Black-and-white**: Two timelines moving in opposite directions
323
+ - **Reverse Scenes**: Each color scene moves backward in time
324
+ - **Convergence**: Timelines meet at climactic revelation
325
+
326
+ **Techniques Used**:
327
+ - Reverse chronological color sequences
328
+ - Forward chronological black-and-white sequences
329
+ - Visual distinction between timelines
330
+ - Puzzle-box structure
331
+
332
+ **Structural Analysis**: Innovative dual-timeline structure where one moves forward, one backward, meeting in the middle for maximum revelation.
333
+
334
+ ---
335
+
336
+ ### Example 3: Arrival (2016)
337
+
338
+ **Director**: Denis Villeneuve
339
+
340
+ **Why This Style Works**: Non-linear perception of time becomes the story's central theme, with "flashbacks" revealed as flash-forwards.
341
+
342
+ **Key Stylistic Moments**:
343
+ - **Opening Montage**: Assumed past revealed as future
344
+ - **Language Learning**: Present timeline drives narrative
345
+ - **Revelation**: Past/future distinction collapses
346
+
347
+ **Techniques Used**:
348
+ - Deliberate misdirection about timeline
349
+ - Thematic integration of non-linear time
350
+ - Visual consistency across all timelines
351
+ - Emotional payoff from temporal revelation
352
+
353
+ **Structural Analysis**: Linear present-tense narrative interwoven with what appears to be past but is actually future, creating profound thematic statement.
354
+
355
+ ---
356
+
357
+ ### Example 4: The Godfather Part II (1974)
358
+
359
+ **Director**: Francis Ford Coppola
360
+
361
+ **Why This Style Works**: Parallel timelines of father and son create thematic contrast between rise and fall, immigration and corruption.
362
+
363
+ **Key Stylistic Moments**:
364
+ - **Visual Distinction**: Sepia past vs. color present
365
+ - **Thematic Parallels**: Vito's rise mirrors Michael's moral descent
366
+ - **Convergence**: Both timelines end with family isolation
367
+
368
+ **Techniques Used**:
369
+ - Clear visual distinction between timelines
370
+ - Thematic rather than plot connections
371
+ - Parallel character arcs across generations
372
+ - Intercutting for maximum contrast
373
+
374
+ **Structural Analysis**: Two complete narratives intercut to illuminate each other thematically, with neither timeline subordinate to the other.
375
+
376
+ ---
377
+
378
+ ### Example 5: Dunkirk (2017)
379
+
380
+ **Director**: Christopher Nolan
381
+
382
+ **Why This Style Works**: Three timelines of different durations (week/day/hour) converge at single moment, creating tension through temporal compression.
383
+
384
+ **Key Stylistic Moments**:
385
+ - **The Mole**: Week-long timeline establishes stakes
386
+ - **The Sea**: Day-long timeline shows civilian rescue
387
+ - **The Air**: Hour-long timeline provides action climax
388
+ - **Convergence**: All three meet at beach evacuation
389
+
390
+ **Techniques Used**:
391
+ - Three distinct timelines with different durations
392
+ - Intercutting accelerates as timelines converge
393
+ - Minimal dialogue emphasizes visual storytelling
394
+ - Ticking clock in each timeline
395
+
396
+ **Structural Analysis**: Complex temporal structure where different-length timelines run simultaneously and converge, requiring careful audience orientation.
397
+
398
+ ---
399
+
400
+ ## Integration with Other Features
401
+
402
+ ### Compatible Genres
403
+
404
+ - **Mystery**: Non-linear revelation creates suspense
405
+ - **Thriller**: Temporal manipulation builds tension
406
+ - **Drama**: Past/present contrast deepens character
407
+ - **Sci-Fi**: Time travel or perception naturally non-linear
408
+ - **Crime**: Investigation structure supports flashbacks
409
+
410
+ ### Compatible Themes
411
+
412
+ - **Memory**: Non-linear structure mirrors how memory works
413
+ - **Trauma**: Past intrudes on present naturally
414
+ - **Identity**: Character revealed through temporal layers
415
+ - **Fate vs. Free Will**: Knowing future creates dramatic irony
416
+ - **Truth**: Multiple perspectives across time reveal complexity
417
+
418
+ ### Style Variations
419
+
420
+ - **Reverse chronology**: Story told backward (Memento)
421
+ - **Parallel timelines**: Multiple periods intercut (The Godfather Part II)
422
+ - **Framing device**: Present wraps around past (The Usual Suspects)
423
+ - **Puzzle structure**: Fragments assembled (Pulp Fiction)
424
+
425
+ ## Common Pitfalls
426
+
427
+ ### Pitfall 1: Confusion Over Cleverness
428
+
429
+ **Problem**: Non-linear structure becomes so complex that audiences lose track of basic plot.
430
+
431
+ **Solution**: Provide clear temporal markers and regular orientation points. Test screenplay with readers unfamiliar with the story.
432
+
433
+ **Example**: Use consistent visual cues (color grading, title cards, character age) to distinguish timelines clearly.
434
+
435
+ ---
436
+
437
+ ### Pitfall 2: Gimmick Without Purpose
438
+
439
+ **Problem**: Non-linear structure used for style points rather than thematic necessity.
440
+
441
+ **Solution**: Ask if story would lose meaning if told chronologically. If not, reconsider structure.
442
+
443
+ **Example**: Memento's reverse chronology is essential to experiencing protagonist's condition; removing it would destroy the film's purpose.
444
+
445
+ ---
446
+
447
+ ### Pitfall 3: Exposition Overload
448
+
449
+ **Problem**: Spending too much time explaining temporal relationships through dialogue.
450
+
451
+ **Solution**: Trust visual storytelling and audience intelligence. Show, don't tell, temporal connections.
452
+
453
+ **Example**: Use match cuts, visual parallels, and contextual clues rather than characters explaining "this was ten years ago."
454
+
455
+ ---
456
+
457
+ ### Pitfall 4: Unresolved Timelines
458
+
459
+ **Problem**: Introducing timeline threads that never connect or resolve.
460
+
461
+ **Solution**: Ensure every timeline serves the whole and converges or illuminates by the end.
462
+
463
+ **Example**: Every timeline in Dunkirk converges at the beach evacuation, providing satisfying resolution to all threads.
464
+
465
+ ---
466
+
467
+ ### Pitfall 5: Sacrificing Character for Structure
468
+
469
+ **Problem**: Focusing so much on temporal puzzle that character development suffers.
470
+
471
+ **Solution**: Use non-linear structure to deepen character, not replace character work.
472
+
473
+ **Example**: Arrival uses non-linear time to explore protagonist's emotional journey, not just as intellectual puzzle.
474
+
475
+ ---
476
+
477
+ ## Best Practices
478
+
479
+ 1. **Establish temporal rules early** - Help audiences understand how time shifts work
480
+ 2. **Use visual distinction** - Color, aspect ratio, or cinematography to mark timelines
481
+ 3. **Create thematic connections** - Juxtapose scenes that comment on each other
482
+ 4. **Provide orientation points** - Regular returns to anchor timeline
483
+ 5. **Build toward convergence** - All timelines should illuminate or meet
484
+ 6. **Test for clarity** - Ensure audiences can construct chronology
485
+ 7. **Justify the structure** - Non-linear approach should be thematically essential
486
+ 8. **Trust your audience** - Don't over-explain temporal relationships
487
+
488
+ ## Resources
489
+
490
+ - "Screenplay: The Foundations of Screenwriting" by Syd Field - Non-linear structure chapter
491
+ - "The Anatomy of Story" by John Truby - Complex narrative structures
492
+ - "Invisible Ink" by Brian McDonald - Thematic justification for structure
493
+ - "Memento" screenplay by Christopher Nolan - Master class in reverse chronology
494
+ - "Pulp Fiction" screenplay by Quentin Tarantino - Non-linear chapter structure
495
+
496
+ ---
497
+
498
+ **Depth Coverage**: 85%
499
+ **Last Updated**: 2026-01-31
500
+ **Version**: 1.0.0
501
+