@mytechtoday/augment-extensions 0.7.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (483) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +109 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +11 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +120 -0
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  476. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  477. package/cli/dist/utils/extractCommandHelp.js +250 -0
  478. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  479. package/cli/dist/utils/install-rules.js +55 -55
  480. package/cli/dist/utils/mcp-integration.js +44 -44
  481. package/cli/dist/utils/rule-install-hooks.js +8 -8
  482. package/modules.md +667 -630
  483. package/package.json +85 -85
@@ -1,490 +1,490 @@
1
- # Linear Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Structural
5
- **Complexity**: Low
6
-
7
- ## Overview
8
-
9
- Linear narrative follows a chronological sequence of events from beginning to end, presenting story events in the order they occur. This traditional storytelling approach emphasizes clear cause-and-effect relationships and straightforward temporal progression.
10
-
11
- ## Core Concept
12
-
13
- Linear narratives build momentum through chronological progression, allowing audiences to experience events as they unfold naturally. This style prioritizes clarity, accessibility, and emotional investment through uninterrupted character journeys. The power of linear storytelling lies in its ability to create sustained tension and inevitable consequences.
14
-
15
- ## Definition
16
-
17
- A linear narrative presents story events in chronological order without flashbacks, flash-forwards, or time jumps. The story moves forward continuously from inciting incident through rising action to climax and resolution.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Chronological Progression
22
-
23
- **Description**: Events must occur in strict temporal order, with each scene following the previous scene in time.
24
-
25
- **Why It Matters**: Chronological order creates clear causality and allows audiences to track character development naturally.
26
-
27
- **Implementation**:
28
- - Number scenes sequentially in time
29
- - Avoid flashbacks or time jumps
30
- - Use continuous time markers (DAY 1, DAY 2, etc.)
31
- - Maintain consistent temporal flow
32
-
33
- **Examples**:
34
- - ✅ **Good**: Scene 1 (Monday morning) → Scene 2 (Monday afternoon) → Scene 3 (Monday evening)
35
- - ❌ **Bad**: Scene 1 (Monday) → Scene 2 (Friday) → Scene 3 (Tuesday)
36
-
37
- **Film Reference**: The Shawshank Redemption (1994) - Follows Andy's prison journey chronologically from arrival to escape.
38
-
39
- ---
40
-
41
- ### Requirement 2: Clear Cause-and-Effect Chain
42
-
43
- **Description**: Each scene must be a direct consequence of previous events and cause subsequent events.
44
-
45
- **Why It Matters**: Causal chains create narrative logic and prevent arbitrary plot developments.
46
-
47
- **Implementation**:
48
- - Every major event stems from a prior action
49
- - Character decisions have immediate consequences
50
- - Plot points build on established information
51
- - Avoid coincidences or deus ex machina
52
-
53
- **Examples**:
54
- - ✅ **Good**: Hero insults villain (Scene 5) → Villain retaliates (Scene 6) → Hero must flee (Scene 7)
55
- - ❌ **Bad**: Random events happen without connection to previous scenes
56
-
57
- **Film Reference**: The Fugitive (1993) - Every action Dr. Kimble takes directly leads to the next plot development.
58
-
59
- ---
60
-
61
- ### Requirement 3: Continuous Character Arc
62
-
63
- **Description**: Character development must progress steadily without temporal gaps that skip growth moments.
64
-
65
- **Why It Matters**: Audiences need to witness transformation, not just see before-and-after states.
66
-
67
- **Implementation**:
68
- - Show incremental character changes
69
- - Include scenes that demonstrate growth
70
- - Avoid time jumps that skip character development
71
- - Track emotional progression scene-by-scene
72
-
73
- **Examples**:
74
- - ✅ **Good**: Coward → Faces small fear → Gains confidence → Faces bigger fear → Becomes brave
75
- - ❌ **Bad**: Coward in Scene 10 → Suddenly brave in Scene 11 with no explanation
76
-
77
- **Film Reference**: Rocky (1976) - Rocky's transformation from nobody to contender shown through continuous training montages.
78
-
79
- ---
80
-
81
- ### Requirement 4: Uninterrupted Timeline
82
-
83
- **Description**: The story timeline must flow without breaks, jumps, or temporal disruptions.
84
-
85
- **Why It Matters**: Temporal continuity maintains immersion and prevents audience confusion.
86
-
87
- **Implementation**:
88
- - Account for all time between scenes
89
- - Use transitions that maintain temporal flow
90
- - Avoid "THREE YEARS LATER" or similar jumps
91
- - Keep story within a contained timeframe
92
-
93
- **Examples**:
94
- - ✅ **Good**: Story spans 48 continuous hours with all time accounted for
95
- - ❌ **Bad**: Story jumps from Tuesday to Friday with no explanation
96
-
97
- **Film Reference**: Before Sunrise (1995) - Entire story takes place over one continuous night.
98
-
99
- ---
100
-
101
- ### Requirement 5: Forward Momentum
102
-
103
- **Description**: Every scene must push the story forward in time and plot development.
104
-
105
- **Why It Matters**: Linear narratives depend on constant forward motion to maintain engagement.
106
-
107
- **Implementation**:
108
- - No scenes that revisit past events
109
- - Each scene advances plot or character
110
- - Maintain rising tension throughout
111
- - Build toward inevitable climax
112
-
113
- **Examples**:
114
- - ✅ **Good**: Each scene introduces new obstacles or revelations
115
- - ❌ **Bad**: Scenes that repeat information or stall progress
116
-
117
- **Film Reference**: Speed (1994) - Relentless forward momentum with no backward glances.
118
-
119
- ---
120
-
121
- ### Requirement 6: Single Timeline Focus
122
-
123
- **Description**: Maintain focus on one primary timeline without parallel storylines in different time periods.
124
-
125
- **Why It Matters**: Multiple timelines violate linear structure and create temporal complexity.
126
-
127
- **Implementation**:
128
- - Follow one protagonist's journey
129
- - Keep all characters in the same timeframe
130
- - Avoid cutting between past and present
131
- - Maintain singular temporal perspective
132
-
133
- **Examples**:
134
- - ✅ **Good**: All characters exist in the same present moment
135
- - ❌ **Bad**: Cutting between 1940s and 2020s storylines
136
-
137
- **Film Reference**: Gravity (2013) - Single continuous timeline following one character's survival.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Steady, building momentum from beginning to end
146
- - Consistent scene length creates reliable rhythm
147
- - Tension escalates gradually without sudden jumps
148
- - Climax feels earned through accumulated progression
149
-
150
- ### Scene Length
151
-
152
- - Maintain relatively consistent scene lengths (2-4 pages)
153
- - Shorter scenes as tension builds toward climax
154
- - Avoid jarring shifts in scene duration
155
- - Balance dialogue scenes with action scenes
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish normal world, introduce conflict (25% of runtime)
160
- - **Act II**: Escalate complications chronologically (50% of runtime)
161
- - **Act III**: Resolve conflict through climax and denouement (25% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Use simple cuts or dissolves
166
- - Avoid flashy transitions that disrupt flow
167
- - Maintain temporal continuity across cuts
168
- - Use "LATER" or "CONTINUOUS" sparingly
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Smooth, continuous camera movements
175
- - Avoid jarring cuts or experimental techniques
176
- - Follow characters through space naturally
177
- - Use establishing shots to maintain spatial clarity
178
-
179
- ### Visual Motifs
180
-
181
- - Recurring visual elements that evolve over time
182
- - Show passage of time through environmental changes
183
- - Use visual callbacks to earlier scenes
184
- - Maintain consistent visual tone throughout
185
-
186
- ### Action Lines
187
-
188
- - Clear, present-tense descriptions
189
- - Focus on what's happening now
190
- - Avoid references to past or future events
191
- - Maintain objective observer perspective
192
-
193
- **Example**:
194
- ```
195
- Sarah enters the diner. She scans the room, spots Tom at the corner booth. She walks over, slides into the seat across from him.
196
- ```
197
-
198
- ## Dialogue Approach
199
-
200
- ### Dialogue Style
201
-
202
- - Natural, conversational flow
203
- - Characters reference recent events, not distant past
204
- - Exposition delivered through present circumstances
205
- - Subtext builds on established relationships
206
-
207
- ### Subtext
208
-
209
- - Subtext emerges from accumulated history
210
- - Characters don't need to explain backstory
211
- - Tension builds from recent conflicts
212
- - Emotional weight comes from witnessed events
213
-
214
- ### Formatting
215
-
216
- - Standard dialogue formatting
217
- - Minimal parentheticals
218
- - Let dialogue flow naturally
219
- - Avoid expository speeches
220
-
221
- **Example**:
222
- ```
223
- TOM
224
- You said you'd be here at noon.
225
-
226
- SARAH
227
- I got held up. The meeting ran long.
228
-
229
- TOM
230
- (looking away)
231
- They always do.
232
- ```
233
-
234
- ## Technical Formatting
235
-
236
- ### Page Layout
237
-
238
- - Standard screenplay format
239
- - Consistent margins and spacing
240
- - Clear scene headings
241
- - Balanced white space
242
-
243
- ### Scene Headings
244
-
245
- - Sequential scene numbers
246
- - Clear INT./EXT. and DAY/NIGHT markers
247
- - Specific locations
248
- - Chronological progression evident
249
-
250
- ### Special Elements
251
-
252
- - Minimal use of MONTAGE or INTERCUT
253
- - Avoid FLASHBACK entirely
254
- - Use CONTINUOUS sparingly
255
- - Keep formatting simple and clear
256
-
257
- ## Strengths and Limitations
258
-
259
- ### Strengths
260
-
261
- - Maximum clarity and accessibility for audiences
262
- - Strong emotional investment through continuous character journey
263
- - Clear cause-and-effect creates satisfying narrative logic
264
- - Easy to follow for all audience demographics
265
- - Builds tension naturally through accumulation
266
-
267
- ### Limitations
268
-
269
- - Cannot explore complex temporal relationships
270
- - Limited ability to reveal backstory organically
271
- - May feel predictable or conventional
272
- - Restricts narrative experimentation
273
- - Difficult to create mystery through withheld information
274
-
275
- ### Best Use Cases
276
-
277
- - Character-driven dramas requiring emotional investment
278
- - Thrillers that build suspense through escalation
279
- - Coming-of-age stories tracking transformation
280
- - Survival narratives with ticking clocks
281
- - Sports films following training and competition
282
- - Quest narratives with clear objectives
283
-
284
- ## Film Examples
285
-
286
- ### Example 1: 12 Angry Men (1957)
287
-
288
- **Director**: Sidney Lumet
289
-
290
- **Why This Style Works**: The real-time, single-location linear narrative creates claustrophobic tension and allows character development through continuous interaction.
291
-
292
- **Key Stylistic Moments**:
293
- - **Opening**: Jury enters deliberation room, establishing all characters and conflict
294
- - **Progression**: Each vote reveals character shifts based on accumulated arguments
295
- - **Climax**: Final holdout changes vote after witnessing complete logical progression
296
-
297
- **Techniques Used**:
298
- - Real-time narrative (90 minutes of film = 90 minutes of story)
299
- - Single location maintains focus
300
- - Chronological revelation of evidence
301
- - Character arcs visible through continuous presence
302
-
303
- **Structural Analysis**: Perfect three-act structure within continuous timeline, with each act marked by vote counts and shifting alliances.
304
-
305
- ---
306
-
307
- ### Example 2: Mad Max: Fury Road (2015)
308
-
309
- **Director**: George Miller
310
-
311
- **Why This Style Works**: Linear chase structure creates relentless momentum, with each action sequence building on the previous one.
312
-
313
- **Key Stylistic Moments**:
314
- - **Opening**: Immediate action establishes stakes and characters
315
- - **Midpoint**: Turn-around point literally reverses direction but maintains chronology
316
- - **Climax**: Return journey escalates everything from outbound journey
317
-
318
- **Techniques Used**:
319
- - Continuous chase narrative
320
- - Escalating action sequences
321
- - Character development through action
322
- - Clear spatial geography throughout
323
-
324
- **Structural Analysis**: Simple out-and-back structure maintains perfect linearity while creating satisfying symmetry.
325
-
326
- ---
327
-
328
- ### Example 3: The Social Network (2010)
329
-
330
- **Director**: David Fincher
331
-
332
- **Why This Style Works**: Despite deposition framing device, the main narrative follows Facebook's creation chronologically, showing cause-and-effect of each decision.
333
-
334
- **Key Stylistic Moments**:
335
- - **Act I**: Breakup leads to FaceMash leads to Facebook idea
336
- - **Act II**: Each expansion creates new conflicts and partnerships
337
- - **Act III**: Success brings lawsuits and isolation
338
-
339
- **Techniques Used**:
340
- - Chronological business development
341
- - Clear consequences for each action
342
- - Parallel relationship deterioration
343
- - Continuous character transformation
344
-
345
- **Structural Analysis**: Linear rise-to-success narrative with clear milestones marking progression.
346
-
347
- ---
348
-
349
- ### Example 4: Whiplash (2014)
350
-
351
- **Director**: Damien Chazelle
352
-
353
- **Why This Style Works**: Linear progression through school year allows audience to experience Andrew's transformation and escalating conflict with Fletcher.
354
-
355
- **Key Stylistic Moments**:
356
- - **Opening**: First encounter establishes dynamic
357
- - **Midpoint**: Car accident shows desperation
358
- - **Climax**: Final performance resolves all accumulated tension
359
-
360
- **Techniques Used**:
361
- - Chronological school year structure
362
- - Escalating practice sessions
363
- - Continuous relationship evolution
364
- - Clear cause-and-effect of obsession
365
-
366
- **Structural Analysis**: Academic year provides natural linear framework for character descent and redemption.
367
-
368
- ---
369
-
370
- ### Example 5: Jaws (1975)
371
-
372
- **Director**: Steven Spielberg
373
-
374
- **Why This Style Works**: Linear summer timeline creates escalating danger as tourist season approaches, with each attack raising stakes.
375
-
376
- **Key Stylistic Moments**:
377
- - **Act I**: First attack establishes threat
378
- - **Act II**: Each subsequent attack increases pressure
379
- - **Act III**: Final confrontation resolves accumulated tension
380
-
381
- **Techniques Used**:
382
- - Chronological attack sequence
383
- - Escalating danger and stakes
384
- - Clear deadline (July 4th)
385
- - Continuous character conflicts
386
-
387
- **Structural Analysis**: Perfect linear thriller structure with clear ticking clock and escalating consequences.
388
-
389
- ---
390
-
391
- ## Integration with Other Features
392
-
393
- ### Compatible Genres
394
-
395
- - **Thriller**: Linear progression builds suspense naturally
396
- - **Drama**: Continuous character arcs create emotional investment
397
- - **Action**: Escalating sequences benefit from chronological structure
398
- - **Horror**: Building dread works well with linear progression
399
- - **Sports**: Training and competition follow natural linear path
400
-
401
- ### Compatible Themes
402
-
403
- - **Redemption**: Transformation visible through continuous journey
404
- - **Coming-of-Age**: Growth tracked through chronological experiences
405
- - **Survival**: Escalating challenges build naturally
406
- - **Justice**: Investigation and revelation follow logical progression
407
- - **Ambition**: Rise or fall shown through accumulated choices
408
-
409
- ### Style Variations
410
-
411
- - **Real-time linear**: Story time equals screen time (12 Angry Men)
412
- - **Compressed linear**: Days or weeks shown continuously (Rocky)
413
- - **Extended linear**: Months or years with all time accounted for (Boyhood)
414
-
415
- ## Common Pitfalls
416
-
417
- ### Pitfall 1: Boring Predictability
418
-
419
- **Problem**: Linear structure becomes too predictable, with audiences anticipating every beat.
420
-
421
- **Solution**: Subvert expectations within linear framework. Surprise comes from character choices, not temporal tricks.
422
-
423
- **Example**: In The Shawshank Redemption, Andy's escape is surprising despite linear structure because information was withheld through perspective, not time manipulation.
424
-
425
- ---
426
-
427
- ### Pitfall 2: Exposition Dumps
428
-
429
- **Problem**: Without flashbacks, writers resort to dialogue-heavy backstory exposition.
430
-
431
- **Solution**: Reveal backstory through present action, documents, or brief character references. Trust audiences to infer history.
432
-
433
- **Example**: Show character's military training through how they handle current crisis, not through "remember when we were in the army" dialogue.
434
-
435
- ---
436
-
437
- ### Pitfall 3: Sagging Middle
438
-
439
- **Problem**: Linear narratives can lose momentum in Act II without temporal jumps to skip slow periods.
440
-
441
- **Solution**: Ensure every scene advances plot or character. Cut scenes that don't contribute to forward momentum.
442
-
443
- **Example**: In Speed, every scene maintains tension through continuous ticking clock and escalating complications.
444
-
445
- ---
446
-
447
- ### Pitfall 4: Lack of Mystery
448
-
449
- **Problem**: Chronological revelation makes it hard to create mystery or withhold information.
450
-
451
- **Solution**: Use limited perspective, unreliable narration, or strategic information gaps within linear framework.
452
-
453
- **Example**: The Sixth Sense maintains mystery through limited perspective while following linear timeline.
454
-
455
- ---
456
-
457
- ### Pitfall 5: Rushed Character Development
458
-
459
- **Problem**: Trying to show complete transformation within limited linear timeframe.
460
-
461
- **Solution**: Focus on specific aspect of character growth, or extend timeline to accommodate realistic development.
462
-
463
- **Example**: Whiplash focuses specifically on obsession and ambition over one school year, not complete life transformation.
464
-
465
- ---
466
-
467
- ## Best Practices
468
-
469
- 1. **Establish clear timeline markers** - Help audiences track progression through time references
470
- 2. **Build tension through accumulation** - Each scene should add weight to the narrative
471
- 3. **Maintain cause-and-effect logic** - Every event should stem from previous events
472
- 4. **Show character growth incrementally** - Avoid sudden transformations
473
- 5. **Use deadlines or ticking clocks** - Create urgency within linear structure
474
- 6. **Keep momentum constant** - Every scene must push forward
475
- 7. **Trust audience intelligence** - Don't over-explain temporal relationships
476
- 8. **Embrace simplicity** - Linear structure's power is its clarity
477
-
478
- ## Resources
479
-
480
- - "Story" by Robert McKee - Chapter on Classical Design
481
- - "Save the Cat!" by Blake Snyder - Beat sheet for linear structure
482
- - "The Anatomy of Story" by John Truby - 22-step linear story structure
483
- - "Into the Woods" by John Yorke - Five-act linear structure analysis
484
-
485
- ---
486
-
487
- **Depth Coverage**: 85%
488
- **Last Updated**: 2026-01-31
489
- **Version**: 1.0.0
490
-
1
+ # Linear Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Structural
5
+ **Complexity**: Low
6
+
7
+ ## Overview
8
+
9
+ Linear narrative follows a chronological sequence of events from beginning to end, presenting story events in the order they occur. This traditional storytelling approach emphasizes clear cause-and-effect relationships and straightforward temporal progression.
10
+
11
+ ## Core Concept
12
+
13
+ Linear narratives build momentum through chronological progression, allowing audiences to experience events as they unfold naturally. This style prioritizes clarity, accessibility, and emotional investment through uninterrupted character journeys. The power of linear storytelling lies in its ability to create sustained tension and inevitable consequences.
14
+
15
+ ## Definition
16
+
17
+ A linear narrative presents story events in chronological order without flashbacks, flash-forwards, or time jumps. The story moves forward continuously from inciting incident through rising action to climax and resolution.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Chronological Progression
22
+
23
+ **Description**: Events must occur in strict temporal order, with each scene following the previous scene in time.
24
+
25
+ **Why It Matters**: Chronological order creates clear causality and allows audiences to track character development naturally.
26
+
27
+ **Implementation**:
28
+ - Number scenes sequentially in time
29
+ - Avoid flashbacks or time jumps
30
+ - Use continuous time markers (DAY 1, DAY 2, etc.)
31
+ - Maintain consistent temporal flow
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Scene 1 (Monday morning) → Scene 2 (Monday afternoon) → Scene 3 (Monday evening)
35
+ - ❌ **Bad**: Scene 1 (Monday) → Scene 2 (Friday) → Scene 3 (Tuesday)
36
+
37
+ **Film Reference**: The Shawshank Redemption (1994) - Follows Andy's prison journey chronologically from arrival to escape.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Clear Cause-and-Effect Chain
42
+
43
+ **Description**: Each scene must be a direct consequence of previous events and cause subsequent events.
44
+
45
+ **Why It Matters**: Causal chains create narrative logic and prevent arbitrary plot developments.
46
+
47
+ **Implementation**:
48
+ - Every major event stems from a prior action
49
+ - Character decisions have immediate consequences
50
+ - Plot points build on established information
51
+ - Avoid coincidences or deus ex machina
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Hero insults villain (Scene 5) → Villain retaliates (Scene 6) → Hero must flee (Scene 7)
55
+ - ❌ **Bad**: Random events happen without connection to previous scenes
56
+
57
+ **Film Reference**: The Fugitive (1993) - Every action Dr. Kimble takes directly leads to the next plot development.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Continuous Character Arc
62
+
63
+ **Description**: Character development must progress steadily without temporal gaps that skip growth moments.
64
+
65
+ **Why It Matters**: Audiences need to witness transformation, not just see before-and-after states.
66
+
67
+ **Implementation**:
68
+ - Show incremental character changes
69
+ - Include scenes that demonstrate growth
70
+ - Avoid time jumps that skip character development
71
+ - Track emotional progression scene-by-scene
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Coward → Faces small fear → Gains confidence → Faces bigger fear → Becomes brave
75
+ - ❌ **Bad**: Coward in Scene 10 → Suddenly brave in Scene 11 with no explanation
76
+
77
+ **Film Reference**: Rocky (1976) - Rocky's transformation from nobody to contender shown through continuous training montages.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Uninterrupted Timeline
82
+
83
+ **Description**: The story timeline must flow without breaks, jumps, or temporal disruptions.
84
+
85
+ **Why It Matters**: Temporal continuity maintains immersion and prevents audience confusion.
86
+
87
+ **Implementation**:
88
+ - Account for all time between scenes
89
+ - Use transitions that maintain temporal flow
90
+ - Avoid "THREE YEARS LATER" or similar jumps
91
+ - Keep story within a contained timeframe
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Story spans 48 continuous hours with all time accounted for
95
+ - ❌ **Bad**: Story jumps from Tuesday to Friday with no explanation
96
+
97
+ **Film Reference**: Before Sunrise (1995) - Entire story takes place over one continuous night.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Forward Momentum
102
+
103
+ **Description**: Every scene must push the story forward in time and plot development.
104
+
105
+ **Why It Matters**: Linear narratives depend on constant forward motion to maintain engagement.
106
+
107
+ **Implementation**:
108
+ - No scenes that revisit past events
109
+ - Each scene advances plot or character
110
+ - Maintain rising tension throughout
111
+ - Build toward inevitable climax
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Each scene introduces new obstacles or revelations
115
+ - ❌ **Bad**: Scenes that repeat information or stall progress
116
+
117
+ **Film Reference**: Speed (1994) - Relentless forward momentum with no backward glances.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Single Timeline Focus
122
+
123
+ **Description**: Maintain focus on one primary timeline without parallel storylines in different time periods.
124
+
125
+ **Why It Matters**: Multiple timelines violate linear structure and create temporal complexity.
126
+
127
+ **Implementation**:
128
+ - Follow one protagonist's journey
129
+ - Keep all characters in the same timeframe
130
+ - Avoid cutting between past and present
131
+ - Maintain singular temporal perspective
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: All characters exist in the same present moment
135
+ - ❌ **Bad**: Cutting between 1940s and 2020s storylines
136
+
137
+ **Film Reference**: Gravity (2013) - Single continuous timeline following one character's survival.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Steady, building momentum from beginning to end
146
+ - Consistent scene length creates reliable rhythm
147
+ - Tension escalates gradually without sudden jumps
148
+ - Climax feels earned through accumulated progression
149
+
150
+ ### Scene Length
151
+
152
+ - Maintain relatively consistent scene lengths (2-4 pages)
153
+ - Shorter scenes as tension builds toward climax
154
+ - Avoid jarring shifts in scene duration
155
+ - Balance dialogue scenes with action scenes
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish normal world, introduce conflict (25% of runtime)
160
+ - **Act II**: Escalate complications chronologically (50% of runtime)
161
+ - **Act III**: Resolve conflict through climax and denouement (25% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Use simple cuts or dissolves
166
+ - Avoid flashy transitions that disrupt flow
167
+ - Maintain temporal continuity across cuts
168
+ - Use "LATER" or "CONTINUOUS" sparingly
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Smooth, continuous camera movements
175
+ - Avoid jarring cuts or experimental techniques
176
+ - Follow characters through space naturally
177
+ - Use establishing shots to maintain spatial clarity
178
+
179
+ ### Visual Motifs
180
+
181
+ - Recurring visual elements that evolve over time
182
+ - Show passage of time through environmental changes
183
+ - Use visual callbacks to earlier scenes
184
+ - Maintain consistent visual tone throughout
185
+
186
+ ### Action Lines
187
+
188
+ - Clear, present-tense descriptions
189
+ - Focus on what's happening now
190
+ - Avoid references to past or future events
191
+ - Maintain objective observer perspective
192
+
193
+ **Example**:
194
+ ```
195
+ Sarah enters the diner. She scans the room, spots Tom at the corner booth. She walks over, slides into the seat across from him.
196
+ ```
197
+
198
+ ## Dialogue Approach
199
+
200
+ ### Dialogue Style
201
+
202
+ - Natural, conversational flow
203
+ - Characters reference recent events, not distant past
204
+ - Exposition delivered through present circumstances
205
+ - Subtext builds on established relationships
206
+
207
+ ### Subtext
208
+
209
+ - Subtext emerges from accumulated history
210
+ - Characters don't need to explain backstory
211
+ - Tension builds from recent conflicts
212
+ - Emotional weight comes from witnessed events
213
+
214
+ ### Formatting
215
+
216
+ - Standard dialogue formatting
217
+ - Minimal parentheticals
218
+ - Let dialogue flow naturally
219
+ - Avoid expository speeches
220
+
221
+ **Example**:
222
+ ```
223
+ TOM
224
+ You said you'd be here at noon.
225
+
226
+ SARAH
227
+ I got held up. The meeting ran long.
228
+
229
+ TOM
230
+ (looking away)
231
+ They always do.
232
+ ```
233
+
234
+ ## Technical Formatting
235
+
236
+ ### Page Layout
237
+
238
+ - Standard screenplay format
239
+ - Consistent margins and spacing
240
+ - Clear scene headings
241
+ - Balanced white space
242
+
243
+ ### Scene Headings
244
+
245
+ - Sequential scene numbers
246
+ - Clear INT./EXT. and DAY/NIGHT markers
247
+ - Specific locations
248
+ - Chronological progression evident
249
+
250
+ ### Special Elements
251
+
252
+ - Minimal use of MONTAGE or INTERCUT
253
+ - Avoid FLASHBACK entirely
254
+ - Use CONTINUOUS sparingly
255
+ - Keep formatting simple and clear
256
+
257
+ ## Strengths and Limitations
258
+
259
+ ### Strengths
260
+
261
+ - Maximum clarity and accessibility for audiences
262
+ - Strong emotional investment through continuous character journey
263
+ - Clear cause-and-effect creates satisfying narrative logic
264
+ - Easy to follow for all audience demographics
265
+ - Builds tension naturally through accumulation
266
+
267
+ ### Limitations
268
+
269
+ - Cannot explore complex temporal relationships
270
+ - Limited ability to reveal backstory organically
271
+ - May feel predictable or conventional
272
+ - Restricts narrative experimentation
273
+ - Difficult to create mystery through withheld information
274
+
275
+ ### Best Use Cases
276
+
277
+ - Character-driven dramas requiring emotional investment
278
+ - Thrillers that build suspense through escalation
279
+ - Coming-of-age stories tracking transformation
280
+ - Survival narratives with ticking clocks
281
+ - Sports films following training and competition
282
+ - Quest narratives with clear objectives
283
+
284
+ ## Film Examples
285
+
286
+ ### Example 1: 12 Angry Men (1957)
287
+
288
+ **Director**: Sidney Lumet
289
+
290
+ **Why This Style Works**: The real-time, single-location linear narrative creates claustrophobic tension and allows character development through continuous interaction.
291
+
292
+ **Key Stylistic Moments**:
293
+ - **Opening**: Jury enters deliberation room, establishing all characters and conflict
294
+ - **Progression**: Each vote reveals character shifts based on accumulated arguments
295
+ - **Climax**: Final holdout changes vote after witnessing complete logical progression
296
+
297
+ **Techniques Used**:
298
+ - Real-time narrative (90 minutes of film = 90 minutes of story)
299
+ - Single location maintains focus
300
+ - Chronological revelation of evidence
301
+ - Character arcs visible through continuous presence
302
+
303
+ **Structural Analysis**: Perfect three-act structure within continuous timeline, with each act marked by vote counts and shifting alliances.
304
+
305
+ ---
306
+
307
+ ### Example 2: Mad Max: Fury Road (2015)
308
+
309
+ **Director**: George Miller
310
+
311
+ **Why This Style Works**: Linear chase structure creates relentless momentum, with each action sequence building on the previous one.
312
+
313
+ **Key Stylistic Moments**:
314
+ - **Opening**: Immediate action establishes stakes and characters
315
+ - **Midpoint**: Turn-around point literally reverses direction but maintains chronology
316
+ - **Climax**: Return journey escalates everything from outbound journey
317
+
318
+ **Techniques Used**:
319
+ - Continuous chase narrative
320
+ - Escalating action sequences
321
+ - Character development through action
322
+ - Clear spatial geography throughout
323
+
324
+ **Structural Analysis**: Simple out-and-back structure maintains perfect linearity while creating satisfying symmetry.
325
+
326
+ ---
327
+
328
+ ### Example 3: The Social Network (2010)
329
+
330
+ **Director**: David Fincher
331
+
332
+ **Why This Style Works**: Despite deposition framing device, the main narrative follows Facebook's creation chronologically, showing cause-and-effect of each decision.
333
+
334
+ **Key Stylistic Moments**:
335
+ - **Act I**: Breakup leads to FaceMash leads to Facebook idea
336
+ - **Act II**: Each expansion creates new conflicts and partnerships
337
+ - **Act III**: Success brings lawsuits and isolation
338
+
339
+ **Techniques Used**:
340
+ - Chronological business development
341
+ - Clear consequences for each action
342
+ - Parallel relationship deterioration
343
+ - Continuous character transformation
344
+
345
+ **Structural Analysis**: Linear rise-to-success narrative with clear milestones marking progression.
346
+
347
+ ---
348
+
349
+ ### Example 4: Whiplash (2014)
350
+
351
+ **Director**: Damien Chazelle
352
+
353
+ **Why This Style Works**: Linear progression through school year allows audience to experience Andrew's transformation and escalating conflict with Fletcher.
354
+
355
+ **Key Stylistic Moments**:
356
+ - **Opening**: First encounter establishes dynamic
357
+ - **Midpoint**: Car accident shows desperation
358
+ - **Climax**: Final performance resolves all accumulated tension
359
+
360
+ **Techniques Used**:
361
+ - Chronological school year structure
362
+ - Escalating practice sessions
363
+ - Continuous relationship evolution
364
+ - Clear cause-and-effect of obsession
365
+
366
+ **Structural Analysis**: Academic year provides natural linear framework for character descent and redemption.
367
+
368
+ ---
369
+
370
+ ### Example 5: Jaws (1975)
371
+
372
+ **Director**: Steven Spielberg
373
+
374
+ **Why This Style Works**: Linear summer timeline creates escalating danger as tourist season approaches, with each attack raising stakes.
375
+
376
+ **Key Stylistic Moments**:
377
+ - **Act I**: First attack establishes threat
378
+ - **Act II**: Each subsequent attack increases pressure
379
+ - **Act III**: Final confrontation resolves accumulated tension
380
+
381
+ **Techniques Used**:
382
+ - Chronological attack sequence
383
+ - Escalating danger and stakes
384
+ - Clear deadline (July 4th)
385
+ - Continuous character conflicts
386
+
387
+ **Structural Analysis**: Perfect linear thriller structure with clear ticking clock and escalating consequences.
388
+
389
+ ---
390
+
391
+ ## Integration with Other Features
392
+
393
+ ### Compatible Genres
394
+
395
+ - **Thriller**: Linear progression builds suspense naturally
396
+ - **Drama**: Continuous character arcs create emotional investment
397
+ - **Action**: Escalating sequences benefit from chronological structure
398
+ - **Horror**: Building dread works well with linear progression
399
+ - **Sports**: Training and competition follow natural linear path
400
+
401
+ ### Compatible Themes
402
+
403
+ - **Redemption**: Transformation visible through continuous journey
404
+ - **Coming-of-Age**: Growth tracked through chronological experiences
405
+ - **Survival**: Escalating challenges build naturally
406
+ - **Justice**: Investigation and revelation follow logical progression
407
+ - **Ambition**: Rise or fall shown through accumulated choices
408
+
409
+ ### Style Variations
410
+
411
+ - **Real-time linear**: Story time equals screen time (12 Angry Men)
412
+ - **Compressed linear**: Days or weeks shown continuously (Rocky)
413
+ - **Extended linear**: Months or years with all time accounted for (Boyhood)
414
+
415
+ ## Common Pitfalls
416
+
417
+ ### Pitfall 1: Boring Predictability
418
+
419
+ **Problem**: Linear structure becomes too predictable, with audiences anticipating every beat.
420
+
421
+ **Solution**: Subvert expectations within linear framework. Surprise comes from character choices, not temporal tricks.
422
+
423
+ **Example**: In The Shawshank Redemption, Andy's escape is surprising despite linear structure because information was withheld through perspective, not time manipulation.
424
+
425
+ ---
426
+
427
+ ### Pitfall 2: Exposition Dumps
428
+
429
+ **Problem**: Without flashbacks, writers resort to dialogue-heavy backstory exposition.
430
+
431
+ **Solution**: Reveal backstory through present action, documents, or brief character references. Trust audiences to infer history.
432
+
433
+ **Example**: Show character's military training through how they handle current crisis, not through "remember when we were in the army" dialogue.
434
+
435
+ ---
436
+
437
+ ### Pitfall 3: Sagging Middle
438
+
439
+ **Problem**: Linear narratives can lose momentum in Act II without temporal jumps to skip slow periods.
440
+
441
+ **Solution**: Ensure every scene advances plot or character. Cut scenes that don't contribute to forward momentum.
442
+
443
+ **Example**: In Speed, every scene maintains tension through continuous ticking clock and escalating complications.
444
+
445
+ ---
446
+
447
+ ### Pitfall 4: Lack of Mystery
448
+
449
+ **Problem**: Chronological revelation makes it hard to create mystery or withhold information.
450
+
451
+ **Solution**: Use limited perspective, unreliable narration, or strategic information gaps within linear framework.
452
+
453
+ **Example**: The Sixth Sense maintains mystery through limited perspective while following linear timeline.
454
+
455
+ ---
456
+
457
+ ### Pitfall 5: Rushed Character Development
458
+
459
+ **Problem**: Trying to show complete transformation within limited linear timeframe.
460
+
461
+ **Solution**: Focus on specific aspect of character growth, or extend timeline to accommodate realistic development.
462
+
463
+ **Example**: Whiplash focuses specifically on obsession and ambition over one school year, not complete life transformation.
464
+
465
+ ---
466
+
467
+ ## Best Practices
468
+
469
+ 1. **Establish clear timeline markers** - Help audiences track progression through time references
470
+ 2. **Build tension through accumulation** - Each scene should add weight to the narrative
471
+ 3. **Maintain cause-and-effect logic** - Every event should stem from previous events
472
+ 4. **Show character growth incrementally** - Avoid sudden transformations
473
+ 5. **Use deadlines or ticking clocks** - Create urgency within linear structure
474
+ 6. **Keep momentum constant** - Every scene must push forward
475
+ 7. **Trust audience intelligence** - Don't over-explain temporal relationships
476
+ 8. **Embrace simplicity** - Linear structure's power is its clarity
477
+
478
+ ## Resources
479
+
480
+ - "Story" by Robert McKee - Chapter on Classical Design
481
+ - "Save the Cat!" by Blake Snyder - Beat sheet for linear structure
482
+ - "The Anatomy of Story" by John Truby - 22-step linear story structure
483
+ - "Into the Woods" by John Yorke - Five-act linear structure analysis
484
+
485
+ ---
486
+
487
+ **Depth Coverage**: 85%
488
+ **Last Updated**: 2026-01-31
489
+ **Version**: 1.0.0
490
+