@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,497 +1,497 @@
1
- # Epic Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Structural/Tonal
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Epic narrative encompasses grand-scale storytelling with sweeping scope, multiple locations, extended timeframes, and large casts. This style emphasizes historical significance, cultural impact, and monumental events that shape societies or civilizations.
10
-
11
- ## Core Concept
12
-
13
- Epic screenwriting operates on a grand canvas, telling stories that span years or decades, cross continents, and involve dozens of characters. The power lies in showing how individual lives intersect with historical forces, creating narratives where personal stakes mirror larger societal transformations. Success requires balancing intimate character moments with spectacular scope.
14
-
15
- ## Definition
16
-
17
- An epic narrative features large-scale storytelling spanning extended time periods (years/decades), multiple locations, substantial cast sizes, and events of historical or cultural significance. The story's scope extends beyond individual characters to encompass broader social, political, or historical forces.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Extended Timeframe
22
-
23
- **Description**: Story must span significant time period (minimum several years, often decades) to show transformation and historical change.
24
-
25
- **Why It Matters**: Epic scope requires time to show how events and characters evolve across history.
26
-
27
- **Implementation**:
28
- - Use title cards to mark time passage
29
- - Show characters aging across decades
30
- - Track historical events over extended period
31
- - Include multiple time periods or eras
32
-
33
- **Examples**:
34
- - ✅ **Good**: Story spans 1939-1945, showing WWII's complete arc
35
- - ❌ **Bad**: Story takes place over single week
36
-
37
- **Film Reference**: Lawrence of Arabia (1962) - Spans several years of WWI in Middle East.
38
-
39
- ---
40
-
41
- ### Requirement 2: Geographic Scope
42
-
43
- **Description**: Narrative must encompass multiple significant locations, often across countries or continents.
44
-
45
- **Why It Matters**: Epic scale requires physical breadth to match temporal scope.
46
-
47
- **Implementation**:
48
- - Set scenes in diverse, distinct locations
49
- - Show travel and journey across geography
50
- - Use locations that reflect historical/cultural significance
51
- - Include establishing shots showing scope
52
-
53
- **Examples**:
54
- - ✅ **Good**: Story moves from New York to Paris to Cairo to Tokyo
55
- - ❌ **Bad**: Entire story set in single town
56
-
57
- **Film Reference**: The Lord of the Rings trilogy (2001-2003) - Journey across Middle-earth's diverse landscapes.
58
-
59
- ---
60
-
61
- ### Requirement 3: Large Cast of Characters
62
-
63
- **Description**: Epic requires substantial ensemble with multiple storylines and character perspectives.
64
-
65
- **Why It Matters**: Grand scope needs multiple viewpoints to show breadth of impact.
66
-
67
- **Implementation**:
68
- - Include 10+ named characters with distinct roles
69
- - Balance main characters with supporting ensemble
70
- - Show how events affect different social classes/groups
71
- - Track multiple character arcs across timeframe
72
-
73
- **Examples**:
74
- - ✅ **Good**: Story follows soldiers, generals, politicians, and civilians
75
- - ❌ **Bad**: Single protagonist with minimal supporting cast
76
-
77
- **Film Reference**: Gone with the Wind (1939) - Large cast showing Civil War's impact on different social strata.
78
-
79
- ---
80
-
81
- ### Requirement 4: Historical or Cultural Significance
82
-
83
- **Description**: Events depicted must have broader importance beyond individual characters' lives.
84
-
85
- **Why It Matters**: Epic narratives connect personal stories to larger historical forces.
86
-
87
- **Implementation**:
88
- - Ground story in real historical events or equivalent fictional events
89
- - Show how individual choices affect larger outcomes
90
- - Include moments of historical importance
91
- - Demonstrate cultural or societal transformation
92
-
93
- **Examples**:
94
- - ✅ **Good**: Character's actions influence outcome of war or revolution
95
- - ❌ **Bad**: Personal drama with no broader significance
96
-
97
- **Film Reference**: Schindler's List (1993) - Individual's actions during Holocaust have historical significance.
98
-
99
- ---
100
-
101
- ### Requirement 5: Spectacular Set Pieces
102
-
103
- **Description**: Include large-scale action sequences, battles, or events that showcase epic scope.
104
-
105
- **Why It Matters**: Visual spectacle reinforces narrative grandeur and justifies epic scale.
106
-
107
- **Implementation**:
108
- - Design sequences involving hundreds of extras
109
- - Include battles, natural disasters, or mass events
110
- - Use practical and visual effects for scale
111
- - Balance spectacle with character moments
112
-
113
- **Examples**:
114
- - ✅ **Good**: Massive battle sequence with thousands of soldiers
115
- - ❌ **Bad**: Small-scale action limited to handful of characters
116
-
117
- **Film Reference**: Braveheart (1995) - Large-scale medieval battle sequences.
118
-
119
- ---
120
-
121
- ### Requirement 6: Thematic Grandeur
122
-
123
- **Description**: Themes must address universal human experiences or fundamental questions about civilization, morality, or existence.
124
-
125
- **Why It Matters**: Epic scope requires themes worthy of the scale.
126
-
127
- **Implementation**:
128
- - Explore themes like freedom, sacrifice, destiny, legacy
129
- - Address questions about human nature or society
130
- - Show how themes play out across different characters and time periods
131
- - Create thematic resonance between personal and historical
132
-
133
- **Examples**:
134
- - ✅ **Good**: Story explores nature of power and corruption across generations
135
- - ❌ **Bad**: Small personal conflict without broader thematic significance
136
-
137
- **Film Reference**: The Godfather Part II (1974) - Explores power, family, and American Dream across generations.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Slower, more deliberate pacing to accommodate scope
146
- - Balance intimate character scenes with spectacular set pieces
147
- - Use time jumps to cover extended timeframe
148
- - Build toward climactic historical moment
149
-
150
- ### Scene Length
151
-
152
- - Longer scenes to establish locations and relationships
153
- - Vary between intimate moments (2-3 pages) and epic sequences (10-15 pages)
154
- - Allow time for emotional beats amid spectacle
155
- - Use montages to compress time passage
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish world, characters, and historical context (25-30% of runtime)
160
- - **Act II**: Develop multiple storylines across time and space (45-50% of runtime)
161
- - **Act III**: Converge storylines for climactic historical moment (20-25% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Use title cards for time and location shifts
166
- - Dissolves for passage of time
167
- - Match cuts across locations
168
- - Montages for historical progression
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Sweeping crane shots and aerial photography
175
- - Wide establishing shots showing scope
176
- - Intimate close-ups for character moments
177
- - Epic compositions with deep staging
178
-
179
- ### Visual Motifs
180
-
181
- - Recurring symbols across time periods
182
- - Visual parallels between different eras
183
- - Color palettes reflecting historical periods
184
- - Iconic imagery representing themes
185
-
186
- ### Action Lines
187
-
188
- - Describe epic scope clearly
189
- - Balance spectacle with character focus
190
- - Use specific historical details
191
- - Convey scale through description
192
-
193
- **Example**:
194
- ```
195
- EXT. BATTLEFIELD - DAY (1863)
196
-
197
- Ten thousand Union soldiers advance across the field.
198
-
199
- Cannon fire erupts. Men fall.
200
-
201
- CLOSE ON: CAPTAIN JAMES, 25, leads his company forward through smoke and chaos.
202
- ```
203
-
204
- ## Dialogue Approach
205
-
206
- ### Dialogue Style
207
-
208
- - Formal, elevated language appropriate to period
209
- - Speeches and declarations for historical moments
210
- - Balance between naturalism and grandeur
211
- - Dialect and period-appropriate vocabulary
212
-
213
- ### Subtext
214
-
215
- - Personal conversations carry historical weight
216
- - Individual choices reflect larger themes
217
- - Dramatic irony from historical knowledge
218
- - Subtext about power, destiny, legacy
219
-
220
- ### Formatting
221
-
222
- - Standard formatting with period-appropriate language
223
- - Longer speeches for important declarations
224
- - Group scenes with multiple speakers
225
- - Formal address and titles
226
-
227
- **Example**:
228
- ```
229
- GENERAL WASHINGTON
230
- Gentlemen, we stand at the precipice of history. What we do this day will echo through the ages.
231
-
232
- COLONEL ADAMS
233
- And if we fail, sir?
234
-
235
- WASHINGTON
236
- Then we fail together, and our cause dies with us.
237
- ```
238
-
239
- ## Technical Formatting
240
-
241
- ### Page Layout
242
-
243
- - Standard format but expect longer page count (150-200+ pages)
244
- - Use title cards for time/location shifts
245
- - White space for epic moments
246
- - Clear scene headings for multiple locations
247
-
248
- ### Scene Headings
249
-
250
- - Include specific locations and dates
251
- - Use historical place names
252
- - Mark time period clearly
253
- - Number scenes sequentially
254
-
255
- ### Special Elements
256
-
257
- - MONTAGE for time passage
258
- - TITLE CARD for historical context
259
- - INTERCUT for parallel storylines
260
- - SUPER for dates and locations
261
-
262
- ## Strengths and Limitations
263
-
264
- ### Strengths
265
-
266
- - Creates immersive historical experience
267
- - Allows exploration of grand themes
268
- - Provides spectacular visual opportunities
269
- - Engages audiences with scope and scale
270
- - Memorable, iconic storytelling
271
-
272
- ### Limitations
273
-
274
- - Requires massive budget and resources
275
- - Difficult to maintain character intimacy
276
- - Risk of overwhelming audiences
277
- - Long runtime requirements
278
- - Complex production logistics
279
-
280
- ### Best Use Cases
281
-
282
- - Historical events of significance
283
- - War and conflict narratives
284
- - Rise and fall of empires or leaders
285
- - Generational family sagas
286
- - Cultural transformation stories
287
- - Fantasy world-building epics
288
-
289
- ## Film Examples
290
-
291
- ### Example 1: Lawrence of Arabia (1962)
292
-
293
- **Director**: David Lean
294
-
295
- **Why This Style Works**: Combines intimate character study with sweeping desert vistas and historical significance of Arab Revolt.
296
-
297
- **Key Stylistic Moments**:
298
- - **Desert Crossing**: Visual spectacle establishes epic scale
299
- - **Aqaba Attack**: Large-scale battle with historical importance
300
- - **Character Transformation**: Personal journey mirrors historical change
301
-
302
- **Techniques Used**:
303
- - Extended runtime (227 minutes) allows scope
304
- - Multiple locations across Middle East
305
- - Large cast representing different factions
306
- - Spectacular cinematography emphasizing scale
307
-
308
- **Structural Analysis**: Three-hour-plus runtime spans two years, multiple countries, and transformation of both protagonist and region.
309
-
310
- ---
311
-
312
- ### Example 2: The Lord of the Rings: The Return of the King (2003)
313
-
314
- **Director**: Peter Jackson
315
-
316
- **Why This Style Works**: Fantasy epic achieves scope through world-building, multiple storylines, and spectacular battles.
317
-
318
- **Key Stylistic Moments**:
319
- - **Pelennor Fields Battle**: Massive battle sequence with thousands
320
- - **Multiple Storylines**: Parallel narratives across Middle-earth
321
- - **Climactic Convergence**: All storylines unite for final confrontation
322
-
323
- **Techniques Used**:
324
- - Trilogy structure allows extended storytelling
325
- - Diverse locations create geographic scope
326
- - Large ensemble cast with distinct arcs
327
- - Practical and digital effects for scale
328
-
329
- **Structural Analysis**: Final film in trilogy brings together years of storytelling across multiple continents and dozens of characters.
330
-
331
- ---
332
-
333
- ### Example 3: Gone with the Wind (1939)
334
-
335
- **Director**: Victor Fleming
336
-
337
- **Why This Style Works**: Personal love story set against Civil War and Reconstruction provides intimate stakes within epic scope.
338
-
339
- **Key Stylistic Moments**:
340
- - **Atlanta Burning**: Spectacular set piece showing war's destruction
341
- - **Time Passage**: Story spans 12 years showing societal transformation
342
- - **Multiple Locations**: Tara, Atlanta, and other Southern locations
343
-
344
- **Techniques Used**:
345
- - Extended runtime (238 minutes) covers decade-plus
346
- - Large cast showing different social classes
347
- - Historical events frame personal drama
348
- - Spectacular production design and cinematography
349
-
350
- **Structural Analysis**: Decade-spanning narrative shows how Civil War transforms South and protagonist.
351
-
352
- ---
353
-
354
- ### Example 4: Schindler's List (1993)
355
-
356
- **Director**: Steven Spielberg
357
-
358
- **Why This Style Works**: Individual's actions during Holocaust achieve epic significance through historical context and moral weight.
359
-
360
- **Key Stylistic Moments**:
361
- - **Ghetto Liquidation**: Large-scale sequence showing horror
362
- - **Factory Scenes**: Intimate moments within epic tragedy
363
- - **List Compilation**: Personal actions with historical significance
364
-
365
- **Techniques Used**:
366
- - Black-and-white cinematography creates historical distance
367
- - Multiple locations across Poland
368
- - Large ensemble of victims and perpetrators
369
- - Spans several years of WWII
370
-
371
- **Structural Analysis**: Personal transformation story achieves epic status through historical significance and moral grandeur.
372
-
373
- ---
374
-
375
- ### Example 5: Braveheart (1995)
376
-
377
- **Director**: Mel Gibson
378
-
379
- **Why This Style Works**: Scottish rebellion provides epic battles and historical significance while maintaining focus on protagonist's personal journey.
380
-
381
- **Key Stylistic Moments**:
382
- - **Stirling Battle**: Massive medieval battle sequence
383
- - **Execution Scene**: Personal sacrifice with historical resonance
384
- - **Multiple Locations**: Scotland, England, and battlefield locations
385
-
386
- **Techniques Used**:
387
- - Large-scale battle choreography
388
- - Extended timeframe showing rebellion's progression
389
- - Ensemble cast representing different factions
390
- - Spectacular Scottish landscapes
391
-
392
- **Structural Analysis**: Years-long rebellion provides epic scope while maintaining clear protagonist focus.
393
-
394
- ---
395
-
396
- ## Integration with Other Features
397
-
398
- ### Compatible Genres
399
-
400
- - **Historical Drama**: Natural fit for epic scope
401
- - **War**: Battles and conflicts suit epic scale
402
- - **Fantasy**: World-building benefits from epic treatment
403
- - **Adventure**: Journeys across geography work well
404
- - **Biography**: Important historical figures warrant epic approach
405
-
406
- ### Compatible Themes
407
-
408
- - **Destiny**: Epic scope allows exploration of fate
409
- - **Legacy**: Extended timeframe shows lasting impact
410
- - **Sacrifice**: Grand scale emphasizes heroic sacrifice
411
- - **Power**: Rise and fall of empires and leaders
412
- - **Freedom**: Struggles for liberation suit epic treatment
413
-
414
- ### Style Variations
415
-
416
- - **Historical epic**: Real events and figures (Lawrence of Arabia)
417
- - **Fantasy epic**: Invented worlds and mythology (Lord of the Rings)
418
- - **Biographical epic**: Important historical figures (Gandhi)
419
- - **War epic**: Military conflicts (Saving Private Ryan)
420
-
421
- ## Common Pitfalls
422
-
423
- ### Pitfall 1: Losing Character in Spectacle
424
-
425
- **Problem**: Focus on scale overwhelms character development and emotional connection.
426
-
427
- **Solution**: Balance epic set pieces with intimate character moments. Ensure spectacle serves character.
428
-
429
- **Example**: Lawrence of Arabia balances desert vistas with close character studies.
430
-
431
- ---
432
-
433
- ### Pitfall 2: Confusing Complexity
434
-
435
- **Problem**: Too many characters, locations, and timelines create confusion rather than grandeur.
436
-
437
- **Solution**: Maintain clear through-line and limit main characters. Use visual/temporal markers clearly.
438
-
439
- **Example**: Lord of the Rings tracks multiple storylines but maintains clarity through distinct visual identities.
440
-
441
- ---
442
-
443
- ### Pitfall 3: Bloated Runtime
444
-
445
- **Problem**: Epic scope becomes excuse for excessive length without narrative justification.
446
-
447
- **Solution**: Ensure every scene serves story. Epic doesn't mean indulgent.
448
-
449
- **Example**: Even 3+ hour epics like Lawrence of Arabia maintain narrative momentum throughout.
450
-
451
- ---
452
-
453
- ### Pitfall 4: Shallow Spectacle
454
-
455
- **Problem**: Visual grandeur without thematic depth or emotional stakes.
456
-
457
- **Solution**: Ground spectacle in character emotion and thematic significance.
458
-
459
- **Example**: Schindler's List's large-scale sequences serve emotional and thematic purposes, not just spectacle.
460
-
461
- ---
462
-
463
- ### Pitfall 5: Historical Inaccuracy
464
-
465
- **Problem**: Epic historical narratives that distort or misrepresent actual events.
466
-
467
- **Solution**: Research thoroughly and acknowledge creative liberties. Respect historical truth.
468
-
469
- **Example**: While Braveheart takes liberties, it captures emotional truth of Scottish independence struggle.
470
-
471
- ---
472
-
473
- ## Best Practices
474
-
475
- 1. **Balance scope with intimacy** - Epic scale needs human emotional core
476
- 2. **Use time wisely** - Extended runtime must serve story, not pad length
477
- 3. **Establish clear geography** - Help audiences track multiple locations
478
- 4. **Develop ensemble carefully** - Give each major character distinct arc
479
- 5. **Ground spectacle in character** - Big moments should affect characters emotionally
480
- 6. **Research historical context** - Authenticity enhances epic storytelling
481
- 7. **Plan production carefully** - Epic scope requires meticulous planning
482
- 8. **Find thematic unity** - Grand scope needs worthy themes
483
-
484
- ## Resources
485
-
486
- - "The Hero with a Thousand Faces" by Joseph Campbell - Epic storytelling structure
487
- - "The Writer's Journey" by Christopher Vogler - Epic hero's journey
488
- - "Lawrence of Arabia" screenplay by Robert Bolt - Master class in epic writing
489
- - "The Lord of the Rings" screenplays by Fran Walsh, Philippa Boyens, Peter Jackson - Fantasy epic adaptation
490
- - "Saving Private Ryan" screenplay by Robert Rodat - War epic structure
491
-
492
- ---
493
-
494
- **Depth Coverage**: 85%
495
- **Last Updated**: 2026-01-31
496
- **Version**: 1.0.0
497
-
1
+ # Epic Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Structural/Tonal
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Epic narrative encompasses grand-scale storytelling with sweeping scope, multiple locations, extended timeframes, and large casts. This style emphasizes historical significance, cultural impact, and monumental events that shape societies or civilizations.
10
+
11
+ ## Core Concept
12
+
13
+ Epic screenwriting operates on a grand canvas, telling stories that span years or decades, cross continents, and involve dozens of characters. The power lies in showing how individual lives intersect with historical forces, creating narratives where personal stakes mirror larger societal transformations. Success requires balancing intimate character moments with spectacular scope.
14
+
15
+ ## Definition
16
+
17
+ An epic narrative features large-scale storytelling spanning extended time periods (years/decades), multiple locations, substantial cast sizes, and events of historical or cultural significance. The story's scope extends beyond individual characters to encompass broader social, political, or historical forces.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Extended Timeframe
22
+
23
+ **Description**: Story must span significant time period (minimum several years, often decades) to show transformation and historical change.
24
+
25
+ **Why It Matters**: Epic scope requires time to show how events and characters evolve across history.
26
+
27
+ **Implementation**:
28
+ - Use title cards to mark time passage
29
+ - Show characters aging across decades
30
+ - Track historical events over extended period
31
+ - Include multiple time periods or eras
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Story spans 1939-1945, showing WWII's complete arc
35
+ - ❌ **Bad**: Story takes place over single week
36
+
37
+ **Film Reference**: Lawrence of Arabia (1962) - Spans several years of WWI in Middle East.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Geographic Scope
42
+
43
+ **Description**: Narrative must encompass multiple significant locations, often across countries or continents.
44
+
45
+ **Why It Matters**: Epic scale requires physical breadth to match temporal scope.
46
+
47
+ **Implementation**:
48
+ - Set scenes in diverse, distinct locations
49
+ - Show travel and journey across geography
50
+ - Use locations that reflect historical/cultural significance
51
+ - Include establishing shots showing scope
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Story moves from New York to Paris to Cairo to Tokyo
55
+ - ❌ **Bad**: Entire story set in single town
56
+
57
+ **Film Reference**: The Lord of the Rings trilogy (2001-2003) - Journey across Middle-earth's diverse landscapes.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Large Cast of Characters
62
+
63
+ **Description**: Epic requires substantial ensemble with multiple storylines and character perspectives.
64
+
65
+ **Why It Matters**: Grand scope needs multiple viewpoints to show breadth of impact.
66
+
67
+ **Implementation**:
68
+ - Include 10+ named characters with distinct roles
69
+ - Balance main characters with supporting ensemble
70
+ - Show how events affect different social classes/groups
71
+ - Track multiple character arcs across timeframe
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Story follows soldiers, generals, politicians, and civilians
75
+ - ❌ **Bad**: Single protagonist with minimal supporting cast
76
+
77
+ **Film Reference**: Gone with the Wind (1939) - Large cast showing Civil War's impact on different social strata.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Historical or Cultural Significance
82
+
83
+ **Description**: Events depicted must have broader importance beyond individual characters' lives.
84
+
85
+ **Why It Matters**: Epic narratives connect personal stories to larger historical forces.
86
+
87
+ **Implementation**:
88
+ - Ground story in real historical events or equivalent fictional events
89
+ - Show how individual choices affect larger outcomes
90
+ - Include moments of historical importance
91
+ - Demonstrate cultural or societal transformation
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Character's actions influence outcome of war or revolution
95
+ - ❌ **Bad**: Personal drama with no broader significance
96
+
97
+ **Film Reference**: Schindler's List (1993) - Individual's actions during Holocaust have historical significance.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Spectacular Set Pieces
102
+
103
+ **Description**: Include large-scale action sequences, battles, or events that showcase epic scope.
104
+
105
+ **Why It Matters**: Visual spectacle reinforces narrative grandeur and justifies epic scale.
106
+
107
+ **Implementation**:
108
+ - Design sequences involving hundreds of extras
109
+ - Include battles, natural disasters, or mass events
110
+ - Use practical and visual effects for scale
111
+ - Balance spectacle with character moments
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Massive battle sequence with thousands of soldiers
115
+ - ❌ **Bad**: Small-scale action limited to handful of characters
116
+
117
+ **Film Reference**: Braveheart (1995) - Large-scale medieval battle sequences.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Thematic Grandeur
122
+
123
+ **Description**: Themes must address universal human experiences or fundamental questions about civilization, morality, or existence.
124
+
125
+ **Why It Matters**: Epic scope requires themes worthy of the scale.
126
+
127
+ **Implementation**:
128
+ - Explore themes like freedom, sacrifice, destiny, legacy
129
+ - Address questions about human nature or society
130
+ - Show how themes play out across different characters and time periods
131
+ - Create thematic resonance between personal and historical
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Story explores nature of power and corruption across generations
135
+ - ❌ **Bad**: Small personal conflict without broader thematic significance
136
+
137
+ **Film Reference**: The Godfather Part II (1974) - Explores power, family, and American Dream across generations.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Slower, more deliberate pacing to accommodate scope
146
+ - Balance intimate character scenes with spectacular set pieces
147
+ - Use time jumps to cover extended timeframe
148
+ - Build toward climactic historical moment
149
+
150
+ ### Scene Length
151
+
152
+ - Longer scenes to establish locations and relationships
153
+ - Vary between intimate moments (2-3 pages) and epic sequences (10-15 pages)
154
+ - Allow time for emotional beats amid spectacle
155
+ - Use montages to compress time passage
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish world, characters, and historical context (25-30% of runtime)
160
+ - **Act II**: Develop multiple storylines across time and space (45-50% of runtime)
161
+ - **Act III**: Converge storylines for climactic historical moment (20-25% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Use title cards for time and location shifts
166
+ - Dissolves for passage of time
167
+ - Match cuts across locations
168
+ - Montages for historical progression
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Sweeping crane shots and aerial photography
175
+ - Wide establishing shots showing scope
176
+ - Intimate close-ups for character moments
177
+ - Epic compositions with deep staging
178
+
179
+ ### Visual Motifs
180
+
181
+ - Recurring symbols across time periods
182
+ - Visual parallels between different eras
183
+ - Color palettes reflecting historical periods
184
+ - Iconic imagery representing themes
185
+
186
+ ### Action Lines
187
+
188
+ - Describe epic scope clearly
189
+ - Balance spectacle with character focus
190
+ - Use specific historical details
191
+ - Convey scale through description
192
+
193
+ **Example**:
194
+ ```
195
+ EXT. BATTLEFIELD - DAY (1863)
196
+
197
+ Ten thousand Union soldiers advance across the field.
198
+
199
+ Cannon fire erupts. Men fall.
200
+
201
+ CLOSE ON: CAPTAIN JAMES, 25, leads his company forward through smoke and chaos.
202
+ ```
203
+
204
+ ## Dialogue Approach
205
+
206
+ ### Dialogue Style
207
+
208
+ - Formal, elevated language appropriate to period
209
+ - Speeches and declarations for historical moments
210
+ - Balance between naturalism and grandeur
211
+ - Dialect and period-appropriate vocabulary
212
+
213
+ ### Subtext
214
+
215
+ - Personal conversations carry historical weight
216
+ - Individual choices reflect larger themes
217
+ - Dramatic irony from historical knowledge
218
+ - Subtext about power, destiny, legacy
219
+
220
+ ### Formatting
221
+
222
+ - Standard formatting with period-appropriate language
223
+ - Longer speeches for important declarations
224
+ - Group scenes with multiple speakers
225
+ - Formal address and titles
226
+
227
+ **Example**:
228
+ ```
229
+ GENERAL WASHINGTON
230
+ Gentlemen, we stand at the precipice of history. What we do this day will echo through the ages.
231
+
232
+ COLONEL ADAMS
233
+ And if we fail, sir?
234
+
235
+ WASHINGTON
236
+ Then we fail together, and our cause dies with us.
237
+ ```
238
+
239
+ ## Technical Formatting
240
+
241
+ ### Page Layout
242
+
243
+ - Standard format but expect longer page count (150-200+ pages)
244
+ - Use title cards for time/location shifts
245
+ - White space for epic moments
246
+ - Clear scene headings for multiple locations
247
+
248
+ ### Scene Headings
249
+
250
+ - Include specific locations and dates
251
+ - Use historical place names
252
+ - Mark time period clearly
253
+ - Number scenes sequentially
254
+
255
+ ### Special Elements
256
+
257
+ - MONTAGE for time passage
258
+ - TITLE CARD for historical context
259
+ - INTERCUT for parallel storylines
260
+ - SUPER for dates and locations
261
+
262
+ ## Strengths and Limitations
263
+
264
+ ### Strengths
265
+
266
+ - Creates immersive historical experience
267
+ - Allows exploration of grand themes
268
+ - Provides spectacular visual opportunities
269
+ - Engages audiences with scope and scale
270
+ - Memorable, iconic storytelling
271
+
272
+ ### Limitations
273
+
274
+ - Requires massive budget and resources
275
+ - Difficult to maintain character intimacy
276
+ - Risk of overwhelming audiences
277
+ - Long runtime requirements
278
+ - Complex production logistics
279
+
280
+ ### Best Use Cases
281
+
282
+ - Historical events of significance
283
+ - War and conflict narratives
284
+ - Rise and fall of empires or leaders
285
+ - Generational family sagas
286
+ - Cultural transformation stories
287
+ - Fantasy world-building epics
288
+
289
+ ## Film Examples
290
+
291
+ ### Example 1: Lawrence of Arabia (1962)
292
+
293
+ **Director**: David Lean
294
+
295
+ **Why This Style Works**: Combines intimate character study with sweeping desert vistas and historical significance of Arab Revolt.
296
+
297
+ **Key Stylistic Moments**:
298
+ - **Desert Crossing**: Visual spectacle establishes epic scale
299
+ - **Aqaba Attack**: Large-scale battle with historical importance
300
+ - **Character Transformation**: Personal journey mirrors historical change
301
+
302
+ **Techniques Used**:
303
+ - Extended runtime (227 minutes) allows scope
304
+ - Multiple locations across Middle East
305
+ - Large cast representing different factions
306
+ - Spectacular cinematography emphasizing scale
307
+
308
+ **Structural Analysis**: Three-hour-plus runtime spans two years, multiple countries, and transformation of both protagonist and region.
309
+
310
+ ---
311
+
312
+ ### Example 2: The Lord of the Rings: The Return of the King (2003)
313
+
314
+ **Director**: Peter Jackson
315
+
316
+ **Why This Style Works**: Fantasy epic achieves scope through world-building, multiple storylines, and spectacular battles.
317
+
318
+ **Key Stylistic Moments**:
319
+ - **Pelennor Fields Battle**: Massive battle sequence with thousands
320
+ - **Multiple Storylines**: Parallel narratives across Middle-earth
321
+ - **Climactic Convergence**: All storylines unite for final confrontation
322
+
323
+ **Techniques Used**:
324
+ - Trilogy structure allows extended storytelling
325
+ - Diverse locations create geographic scope
326
+ - Large ensemble cast with distinct arcs
327
+ - Practical and digital effects for scale
328
+
329
+ **Structural Analysis**: Final film in trilogy brings together years of storytelling across multiple continents and dozens of characters.
330
+
331
+ ---
332
+
333
+ ### Example 3: Gone with the Wind (1939)
334
+
335
+ **Director**: Victor Fleming
336
+
337
+ **Why This Style Works**: Personal love story set against Civil War and Reconstruction provides intimate stakes within epic scope.
338
+
339
+ **Key Stylistic Moments**:
340
+ - **Atlanta Burning**: Spectacular set piece showing war's destruction
341
+ - **Time Passage**: Story spans 12 years showing societal transformation
342
+ - **Multiple Locations**: Tara, Atlanta, and other Southern locations
343
+
344
+ **Techniques Used**:
345
+ - Extended runtime (238 minutes) covers decade-plus
346
+ - Large cast showing different social classes
347
+ - Historical events frame personal drama
348
+ - Spectacular production design and cinematography
349
+
350
+ **Structural Analysis**: Decade-spanning narrative shows how Civil War transforms South and protagonist.
351
+
352
+ ---
353
+
354
+ ### Example 4: Schindler's List (1993)
355
+
356
+ **Director**: Steven Spielberg
357
+
358
+ **Why This Style Works**: Individual's actions during Holocaust achieve epic significance through historical context and moral weight.
359
+
360
+ **Key Stylistic Moments**:
361
+ - **Ghetto Liquidation**: Large-scale sequence showing horror
362
+ - **Factory Scenes**: Intimate moments within epic tragedy
363
+ - **List Compilation**: Personal actions with historical significance
364
+
365
+ **Techniques Used**:
366
+ - Black-and-white cinematography creates historical distance
367
+ - Multiple locations across Poland
368
+ - Large ensemble of victims and perpetrators
369
+ - Spans several years of WWII
370
+
371
+ **Structural Analysis**: Personal transformation story achieves epic status through historical significance and moral grandeur.
372
+
373
+ ---
374
+
375
+ ### Example 5: Braveheart (1995)
376
+
377
+ **Director**: Mel Gibson
378
+
379
+ **Why This Style Works**: Scottish rebellion provides epic battles and historical significance while maintaining focus on protagonist's personal journey.
380
+
381
+ **Key Stylistic Moments**:
382
+ - **Stirling Battle**: Massive medieval battle sequence
383
+ - **Execution Scene**: Personal sacrifice with historical resonance
384
+ - **Multiple Locations**: Scotland, England, and battlefield locations
385
+
386
+ **Techniques Used**:
387
+ - Large-scale battle choreography
388
+ - Extended timeframe showing rebellion's progression
389
+ - Ensemble cast representing different factions
390
+ - Spectacular Scottish landscapes
391
+
392
+ **Structural Analysis**: Years-long rebellion provides epic scope while maintaining clear protagonist focus.
393
+
394
+ ---
395
+
396
+ ## Integration with Other Features
397
+
398
+ ### Compatible Genres
399
+
400
+ - **Historical Drama**: Natural fit for epic scope
401
+ - **War**: Battles and conflicts suit epic scale
402
+ - **Fantasy**: World-building benefits from epic treatment
403
+ - **Adventure**: Journeys across geography work well
404
+ - **Biography**: Important historical figures warrant epic approach
405
+
406
+ ### Compatible Themes
407
+
408
+ - **Destiny**: Epic scope allows exploration of fate
409
+ - **Legacy**: Extended timeframe shows lasting impact
410
+ - **Sacrifice**: Grand scale emphasizes heroic sacrifice
411
+ - **Power**: Rise and fall of empires and leaders
412
+ - **Freedom**: Struggles for liberation suit epic treatment
413
+
414
+ ### Style Variations
415
+
416
+ - **Historical epic**: Real events and figures (Lawrence of Arabia)
417
+ - **Fantasy epic**: Invented worlds and mythology (Lord of the Rings)
418
+ - **Biographical epic**: Important historical figures (Gandhi)
419
+ - **War epic**: Military conflicts (Saving Private Ryan)
420
+
421
+ ## Common Pitfalls
422
+
423
+ ### Pitfall 1: Losing Character in Spectacle
424
+
425
+ **Problem**: Focus on scale overwhelms character development and emotional connection.
426
+
427
+ **Solution**: Balance epic set pieces with intimate character moments. Ensure spectacle serves character.
428
+
429
+ **Example**: Lawrence of Arabia balances desert vistas with close character studies.
430
+
431
+ ---
432
+
433
+ ### Pitfall 2: Confusing Complexity
434
+
435
+ **Problem**: Too many characters, locations, and timelines create confusion rather than grandeur.
436
+
437
+ **Solution**: Maintain clear through-line and limit main characters. Use visual/temporal markers clearly.
438
+
439
+ **Example**: Lord of the Rings tracks multiple storylines but maintains clarity through distinct visual identities.
440
+
441
+ ---
442
+
443
+ ### Pitfall 3: Bloated Runtime
444
+
445
+ **Problem**: Epic scope becomes excuse for excessive length without narrative justification.
446
+
447
+ **Solution**: Ensure every scene serves story. Epic doesn't mean indulgent.
448
+
449
+ **Example**: Even 3+ hour epics like Lawrence of Arabia maintain narrative momentum throughout.
450
+
451
+ ---
452
+
453
+ ### Pitfall 4: Shallow Spectacle
454
+
455
+ **Problem**: Visual grandeur without thematic depth or emotional stakes.
456
+
457
+ **Solution**: Ground spectacle in character emotion and thematic significance.
458
+
459
+ **Example**: Schindler's List's large-scale sequences serve emotional and thematic purposes, not just spectacle.
460
+
461
+ ---
462
+
463
+ ### Pitfall 5: Historical Inaccuracy
464
+
465
+ **Problem**: Epic historical narratives that distort or misrepresent actual events.
466
+
467
+ **Solution**: Research thoroughly and acknowledge creative liberties. Respect historical truth.
468
+
469
+ **Example**: While Braveheart takes liberties, it captures emotional truth of Scottish independence struggle.
470
+
471
+ ---
472
+
473
+ ## Best Practices
474
+
475
+ 1. **Balance scope with intimacy** - Epic scale needs human emotional core
476
+ 2. **Use time wisely** - Extended runtime must serve story, not pad length
477
+ 3. **Establish clear geography** - Help audiences track multiple locations
478
+ 4. **Develop ensemble carefully** - Give each major character distinct arc
479
+ 5. **Ground spectacle in character** - Big moments should affect characters emotionally
480
+ 6. **Research historical context** - Authenticity enhances epic storytelling
481
+ 7. **Plan production carefully** - Epic scope requires meticulous planning
482
+ 8. **Find thematic unity** - Grand scope needs worthy themes
483
+
484
+ ## Resources
485
+
486
+ - "The Hero with a Thousand Faces" by Joseph Campbell - Epic storytelling structure
487
+ - "The Writer's Journey" by Christopher Vogler - Epic hero's journey
488
+ - "Lawrence of Arabia" screenplay by Robert Bolt - Master class in epic writing
489
+ - "The Lord of the Rings" screenplays by Fran Walsh, Philippa Boyens, Peter Jackson - Fantasy epic adaptation
490
+ - "Saving Private Ryan" screenplay by Robert Rodat - War epic structure
491
+
492
+ ---
493
+
494
+ **Depth Coverage**: 85%
495
+ **Last Updated**: 2026-01-31
496
+ **Version**: 1.0.0
497
+