@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,499 +1,499 @@
1
- # Ensemble Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Structural
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Ensemble narratives follow multiple protagonists with equal or near-equal importance, weaving together separate storylines that intersect, parallel, or contrast with each other. This style emphasizes interconnection, diverse perspectives, and thematic unity across multiple character arcs.
10
-
11
- ## Core Concept
12
-
13
- Ensemble storytelling distributes narrative focus across multiple characters rather than centering on a single protagonist. The power lies in showing how individual stories illuminate each other, creating a tapestry where the whole exceeds the sum of its parts. Success requires balancing screen time, maintaining distinct character voices, and finding thematic threads that unite disparate storylines.
14
-
15
- ## Definition
16
-
17
- An ensemble narrative features three or more protagonists with substantial individual storylines that receive roughly equal narrative weight. No single character dominates the story; instead, multiple perspectives combine to explore a central theme, event, or location.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Balanced Screen Time
22
-
23
- **Description**: Distribute narrative focus relatively equally among main characters, ensuring no single character dominates.
24
-
25
- **Why It Matters**: Unbalanced ensembles feel like single-protagonist stories with supporting characters, not true ensembles.
26
-
27
- **Implementation**:
28
- - Track page count per character
29
- - Ensure each protagonist has complete arc
30
- - Rotate focus across acts
31
- - Give each character climactic moments
32
-
33
- **Examples**:
34
- - ✅ **Good**: Five characters each get 15-20 pages of focus across 90-page script
35
- - ❌ **Bad**: One character gets 50 pages, others get 10 pages each
36
-
37
- **Film Reference**: Crash (2004) - Multiple storylines receive equal weight and development.
38
-
39
- ---
40
-
41
- ### Requirement 2: Interconnected Storylines
42
-
43
- **Description**: Character storylines must intersect, influence, or thematically parallel each other.
44
-
45
- **Why It Matters**: Disconnected storylines feel like anthology, not ensemble. Connections create unity.
46
-
47
- **Implementation**:
48
- - Characters' actions affect other characters
49
- - Storylines cross at key moments
50
- - Shared events viewed from multiple perspectives
51
- - Thematic echoes across storylines
52
-
53
- **Examples**:
54
- - ✅ **Good**: Character A's decision creates problem for Character B, whose solution affects Character C
55
- - ❌ **Bad**: Three separate stories that never connect or influence each other
56
-
57
- **Film Reference**: Magnolia (1999) - Seemingly separate stories converge through shared trauma and location.
58
-
59
- ---
60
-
61
- ### Requirement 3: Distinct Character Voices
62
-
63
- **Description**: Each protagonist must have unique personality, goals, and perspective clearly distinguishable from others.
64
-
65
- **Why It Matters**: Ensemble casts with similar characters blur together and confuse audiences.
66
-
67
- **Implementation**:
68
- - Varied backgrounds and worldviews
69
- - Distinct dialogue patterns
70
- - Contrasting goals and methods
71
- - Different emotional registers
72
-
73
- **Examples**:
74
- - ✅ **Good**: Optimist, cynic, pragmatist, idealist, and rebel each approach same situation differently
75
- - ❌ **Bad**: Five characters who think, speak, and act similarly
76
-
77
- **Film Reference**: The Breakfast Club (1985) - Five distinct archetypes with clear individual voices.
78
-
79
- ---
80
-
81
- ### Requirement 4: Thematic Unity
82
-
83
- **Description**: All storylines must explore variations of a central theme or question.
84
-
85
- **Why It Matters**: Without thematic unity, ensemble feels scattered and purposeless.
86
-
87
- **Implementation**:
88
- - Identify central theme or question
89
- - Each character explores different aspect
90
- - Storylines provide contrasting answers
91
- - Convergence reveals thematic truth
92
-
93
- **Examples**:
94
- - ✅ **Good**: Five characters explore "what is family?" through different relationships
95
- - ❌ **Bad**: Random characters with unrelated themes and goals
96
-
97
- **Film Reference**: Love Actually (2003) - Multiple storylines explore different facets of love.
98
-
99
- ---
100
-
101
- ### Requirement 5: Clear Introduction Pattern
102
-
103
- **Description**: Establish efficient system for introducing multiple protagonists without confusion.
104
-
105
- **Why It Matters**: Audiences need to track many characters; clear introduction prevents early confusion.
106
-
107
- **Implementation**:
108
- - Introduce characters in distinct contexts
109
- - Use visual or verbal tags for identification
110
- - Limit initial ensemble to 3-5 main characters
111
- - Establish each character's world before crossover
112
-
113
- **Examples**:
114
- - ✅ **Good**: Introduce each character in their own scene with clear visual identity before bringing them together
115
- - ❌ **Bad**: Introducing all characters simultaneously in crowded scene
116
-
117
- **Film Reference**: Ocean's Eleven (2001) - Each team member introduced individually with distinct skill and personality.
118
-
119
- ---
120
-
121
- ### Requirement 6: Convergence or Resonance
122
-
123
- **Description**: Storylines must either physically converge or thematically resonate by the climax.
124
-
125
- **Why It Matters**: Ensemble narratives need payoff where separate threads come together or illuminate each other.
126
-
127
- **Implementation**:
128
- - Build toward shared climactic event
129
- - Create moment where all characters' choices matter
130
- - Show how individual arcs affect collective outcome
131
- - Provide thematic resolution across all storylines
132
-
133
- **Examples**:
134
- - ✅ **Good**: All characters' separate journeys lead them to same location for climactic confrontation
135
- - ❌ **Bad**: Storylines remain separate through the end with no connection
136
-
137
- **Film Reference**: The Avengers (2012) - Individual heroes converge for shared battle.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Rotate between storylines to maintain variety
146
- - Accelerate cutting between storylines as climax approaches
147
- - Balance quiet character moments with action across ensemble
148
- - Use one storyline's climax to energize another's development
149
-
150
- ### Scene Length
151
-
152
- - Shorter scenes when rapidly cutting between multiple storylines
153
- - Longer scenes when establishing character or deepening relationship
154
- - Vary scene length across storylines to create rhythm
155
- - Avoid predictable pattern of equal scene lengths
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Introduce all main characters and establish their worlds (30% of runtime)
160
- - **Act II**: Develop individual arcs while building connections (40% of runtime)
161
- - **Act III**: Converge storylines and resolve all character arcs (30% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Use thematic or visual links between storylines
166
- - Match cuts between parallel situations
167
- - Audio bridges across character transitions
168
- - Contrast cuts for dramatic effect
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Distinct visual style for each character's world
175
- - Consistent cinematography within each storyline
176
- - Visual parallels between thematically linked moments
177
- - Group compositions when characters converge
178
-
179
- ### Visual Motifs
180
-
181
- - Recurring objects or images that appear across storylines
182
- - Color coding for different character threads
183
- - Symbolic imagery that unites disparate stories
184
- - Visual callbacks between connected characters
185
-
186
- ### Action Lines
187
-
188
- - Clearly identify which character's perspective
189
- - Maintain distinct tone for each character's scenes
190
- - Note visual connections between storylines
191
- - Describe ensemble moments with spatial clarity
192
-
193
- **Example**:
194
- ```
195
- INT. COFFEE SHOP - DAY
196
-
197
- SARAH sits alone, staring at her phone.
198
-
199
- Across the room, MARCUS enters, orders coffee. He doesn't notice Sarah.
200
-
201
- Outside the window, ELENA walks past, phone to her ear.
202
- ```
203
-
204
- ## Dialogue Approach
205
-
206
- ### Dialogue Style
207
-
208
- - Each character needs distinct speech patterns
209
- - Conversations reveal character relationships
210
- - Ensemble scenes require clear speaker identification
211
- - Balance dialogue across characters in group scenes
212
-
213
- ### Subtext
214
-
215
- - Characters know different pieces of information
216
- - Dramatic irony from audience knowing all storylines
217
- - Conversations gain meaning from other storylines
218
- - Subtext emerges from what characters don't know about each other
219
-
220
- ### Formatting
221
-
222
- - Clear character names in ensemble scenes
223
- - Minimal parentheticals to avoid clutter
224
- - Use blocking to clarify who speaks to whom
225
- - Consider splitting large ensemble scenes
226
-
227
- **Example**:
228
- ```
229
- SARAH
230
- (to Marcus)
231
- Have you seen Elena?
232
-
233
- MARCUS
234
- Who?
235
-
236
- ELENA (O.S.)
237
- (on phone, outside)
238
- I'm running late.
239
- ```
240
-
241
- ## Technical Formatting
242
-
243
- ### Page Layout
244
-
245
- - Use white space to separate storyline transitions
246
- - Consider title cards for major character introductions
247
- - Maintain clear scene headings for location shifts
248
- - Balance page density across storylines
249
-
250
- ### Scene Headings
251
-
252
- - Specific locations help track multiple settings
253
- - Consider character names in headings for clarity
254
- - Use INTERCUT for parallel action
255
- - Number scenes sequentially regardless of storyline
256
-
257
- ### Special Elements
258
-
259
- - INTERCUT for simultaneous action across storylines
260
- - MONTAGE for showing multiple characters' parallel activities
261
- - SPLIT SCREEN notation if visually presenting multiple storylines
262
- - Title cards for character introductions or time shifts
263
-
264
- ## Strengths and Limitations
265
-
266
- ### Strengths
267
-
268
- - Explores themes from multiple perspectives
269
- - Creates rich, complex narrative tapestry
270
- - Allows diverse representation and viewpoints
271
- - Generates dramatic irony through information distribution
272
- - Provides variety in tone and pacing
273
-
274
- ### Limitations
275
-
276
- - Risk of overcrowding and confusion
277
- - Difficult to develop all characters fully
278
- - Some storylines may feel weaker than others
279
- - Requires longer runtime or sacrifices depth
280
- - Challenging to maintain audience investment in all threads
281
-
282
- ### Best Use Cases
283
-
284
- - Stories exploring community or social issues
285
- - Workplace or team dynamics
286
- - Interconnected urban narratives
287
- - Event-based stories (weddings, disasters, holidays)
288
- - Thematic explorations requiring multiple perspectives
289
- - Heist or mission films with specialized team members
290
-
291
- ## Film Examples
292
-
293
- ### Example 1: Pulp Fiction (1994)
294
-
295
- **Director**: Quentin Tarantino
296
-
297
- **Why This Style Works**: Multiple criminal storylines intersect and influence each other, creating thematic unity about redemption and chance.
298
-
299
- **Key Stylistic Moments**:
300
- - **Vincent and Jules**: Hitmen storyline establishes tone
301
- - **Butch**: Boxer storyline intersects with Vincent's
302
- - **Convergence**: All storylines connect through shared locations and events
303
-
304
- **Techniques Used**:
305
- - Chapter structure for each storyline
306
- - Non-linear arrangement creates connections
307
- - Shared locations (diner, apartment) link characters
308
- - Thematic exploration of redemption across all stories
309
-
310
- **Structural Analysis**: Three main storylines with supporting threads, all interconnected through location, events, and theme.
311
-
312
- ---
313
-
314
- ### Example 2: Crash (2004)
315
-
316
- **Director**: Paul Haggis
317
-
318
- **Why This Style Works**: Multiple Los Angeles residents' lives intersect over 36 hours, exploring racial tension from diverse perspectives.
319
-
320
- **Key Stylistic Moments**:
321
- - **Opening Crash**: Establishes interconnection theme
322
- - **Parallel Storylines**: Each character explores prejudice differently
323
- - **Convergence**: Characters' actions ripple across storylines
324
-
325
- **Techniques Used**:
326
- - Compressed timeframe unites disparate stories
327
- - Cause-and-effect across storylines
328
- - Thematic unity (racism, connection) across all threads
329
- - Ensemble cast with no single protagonist
330
-
331
- **Structural Analysis**: Six to eight main storylines intersecting through shared events and locations over single day.
332
-
333
- ---
334
-
335
- ### Example 3: The Breakfast Club (1985)
336
-
337
- **Director**: John Hughes
338
-
339
- **Why This Style Works**: Five distinct archetypes confined to single location allows deep character exploration and thematic unity.
340
-
341
- **Key Stylistic Moments**:
342
- - **Introduction**: Each character established through distinct entrance
343
- - **Conflict**: Characters clash based on stereotypes
344
- - **Revelation**: Each character reveals hidden depth
345
-
346
- **Techniques Used**:
347
- - Single location focuses attention on character
348
- - Real-time narrative maintains unity
349
- - Distinct archetypes ensure clear differentiation
350
- - Shared experience creates convergence
351
-
352
- **Structural Analysis**: Five equal protagonists in confined space, with individual arcs converging through shared experience.
353
-
354
- ---
355
-
356
- ### Example 4: Love Actually (2003)
357
-
358
- **Director**: Richard Curtis
359
-
360
- **Why This Style Works**: Multiple love stories explore different facets of romance, creating comprehensive thematic exploration.
361
-
362
- **Key Stylistic Moments**:
363
- - **Parallel Introductions**: Each couple introduced in separate context
364
- - **Thematic Variations**: Different types of love explored
365
- - **Christmas Convergence**: All storylines resolve around holiday
366
-
367
- **Techniques Used**:
368
- - Thematic unity across disparate storylines
369
- - Minimal physical intersection between characters
370
- - Parallel structure with similar beats
371
- - Emotional resonance rather than plot convergence
372
-
373
- **Structural Analysis**: Eight to ten storylines with minimal intersection, united by theme and timeframe rather than plot.
374
-
375
- ---
376
-
377
- ### Example 5: The Avengers (2012)
378
-
379
- **Director**: Joss Whedon
380
-
381
- **Why This Style Works**: Established individual heroes converge for shared mission, balancing distinct personalities with team dynamics.
382
-
383
- **Key Stylistic Moments**:
384
- - **Individual Introductions**: Each hero shown in their element
385
- - **Conflict**: Personalities clash before uniting
386
- - **Convergence**: Team assembles for climactic battle
387
-
388
- **Techniques Used**:
389
- - Pre-established characters allow faster introduction
390
- - Distinct powers and personalities ensure differentiation
391
- - Shared goal unites disparate storylines
392
- - Balanced screen time across ensemble
393
-
394
- **Structural Analysis**: Six main characters with individual arcs converging into single team narrative.
395
-
396
- ---
397
-
398
- ## Integration with Other Features
399
-
400
- ### Compatible Genres
401
-
402
- - **Drama**: Multiple perspectives deepen thematic exploration
403
- - **Comedy**: Ensemble allows varied comedic styles
404
- - **Crime**: Heist teams or interconnected criminal stories
405
- - **Romance**: Multiple relationship dynamics
406
- - **Action**: Team-based missions with specialized members
407
-
408
- ### Compatible Themes
409
-
410
- - **Community**: Ensemble naturally explores collective experience
411
- - **Interconnection**: Multiple storylines show how lives intersect
412
- - **Perspective**: Different viewpoints on same events or issues
413
- - **Diversity**: Ensemble allows representation of varied experiences
414
- - **Collaboration**: Team dynamics and collective achievement
415
-
416
- ### Style Variations
417
-
418
- - **Convergent ensemble**: Separate storylines physically meet (Crash)
419
- - **Parallel ensemble**: Storylines remain separate but thematically linked (Love Actually)
420
- - **Team ensemble**: Group with shared goal (Ocean's Eleven)
421
- - **Location ensemble**: Characters united by place (Grand Hotel)
422
-
423
- ## Common Pitfalls
424
-
425
- ### Pitfall 1: Overcrowding
426
-
427
- **Problem**: Too many characters dilutes focus and prevents adequate development.
428
-
429
- **Solution**: Limit main ensemble to 3-6 characters. Others can be supporting roles.
430
-
431
- **Example**: The Breakfast Club succeeds with five characters; more would prevent the depth achieved.
432
-
433
- ---
434
-
435
- ### Pitfall 2: Unbalanced Screen Time
436
-
437
- **Problem**: One or two characters dominate, making others feel like supporting roles.
438
-
439
- **Solution**: Track page count per character and ensure relative balance. Cut weaker storylines.
440
-
441
- **Example**: Ensure no character gets less than 15% or more than 30% of focus in true ensemble.
442
-
443
- ---
444
-
445
- ### Pitfall 3: Weak Connections
446
-
447
- **Problem**: Storylines feel disconnected, like anthology rather than ensemble.
448
-
449
- **Solution**: Create clear thematic links, shared events, or direct character interactions.
450
-
451
- **Example**: Crash ensures every storyline directly affects at least one other storyline.
452
-
453
- ---
454
-
455
- ### Pitfall 4: Indistinct Characters
456
-
457
- **Problem**: Characters blur together due to similar voices or goals.
458
-
459
- **Solution**: Give each character distinct background, speech pattern, and approach to central theme.
460
-
461
- **Example**: The Breakfast Club's five archetypes (brain, athlete, basket case, princess, criminal) ensure clear differentiation.
462
-
463
- ---
464
-
465
- ### Pitfall 5: Lack of Convergence
466
-
467
- **Problem**: Storylines never come together or illuminate each other.
468
-
469
- **Solution**: Build toward moment where all storylines converge or thematically resonate.
470
-
471
- **Example**: The Avengers builds toward climactic battle where all heroes must work together.
472
-
473
- ---
474
-
475
- ## Best Practices
476
-
477
- 1. **Limit ensemble size** - 3-6 main characters is ideal; more risks confusion
478
- 2. **Create distinct voices** - Each character should be identifiable by dialogue alone
479
- 3. **Establish thematic unity** - All storylines should explore variations of central theme
480
- 4. **Track screen time** - Ensure relative balance across main characters
481
- 5. **Build connections** - Storylines should intersect or influence each other
482
- 6. **Use efficient introductions** - Establish characters quickly and distinctly
483
- 7. **Plan convergence** - Know how storylines will come together or resonate
484
- 8. **Maintain individual arcs** - Each character needs complete journey
485
-
486
- ## Resources
487
-
488
- - "The Anatomy of Story" by John Truby - Multi-protagonist narratives
489
- - "Save the Cat!" by Blake Snyder - Ensemble structure beats
490
- - "Screenplay" by Syd Field - Multiple protagonist structure
491
- - "Pulp Fiction" screenplay by Quentin Tarantino - Master class in ensemble
492
- - "The Breakfast Club" screenplay by John Hughes - Confined ensemble dynamics
493
-
494
- ---
495
-
496
- **Depth Coverage**: 85%
497
- **Last Updated**: 2026-01-31
498
- **Version**: 1.0.0
499
-
1
+ # Ensemble Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Structural
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Ensemble narratives follow multiple protagonists with equal or near-equal importance, weaving together separate storylines that intersect, parallel, or contrast with each other. This style emphasizes interconnection, diverse perspectives, and thematic unity across multiple character arcs.
10
+
11
+ ## Core Concept
12
+
13
+ Ensemble storytelling distributes narrative focus across multiple characters rather than centering on a single protagonist. The power lies in showing how individual stories illuminate each other, creating a tapestry where the whole exceeds the sum of its parts. Success requires balancing screen time, maintaining distinct character voices, and finding thematic threads that unite disparate storylines.
14
+
15
+ ## Definition
16
+
17
+ An ensemble narrative features three or more protagonists with substantial individual storylines that receive roughly equal narrative weight. No single character dominates the story; instead, multiple perspectives combine to explore a central theme, event, or location.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Balanced Screen Time
22
+
23
+ **Description**: Distribute narrative focus relatively equally among main characters, ensuring no single character dominates.
24
+
25
+ **Why It Matters**: Unbalanced ensembles feel like single-protagonist stories with supporting characters, not true ensembles.
26
+
27
+ **Implementation**:
28
+ - Track page count per character
29
+ - Ensure each protagonist has complete arc
30
+ - Rotate focus across acts
31
+ - Give each character climactic moments
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Five characters each get 15-20 pages of focus across 90-page script
35
+ - ❌ **Bad**: One character gets 50 pages, others get 10 pages each
36
+
37
+ **Film Reference**: Crash (2004) - Multiple storylines receive equal weight and development.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Interconnected Storylines
42
+
43
+ **Description**: Character storylines must intersect, influence, or thematically parallel each other.
44
+
45
+ **Why It Matters**: Disconnected storylines feel like anthology, not ensemble. Connections create unity.
46
+
47
+ **Implementation**:
48
+ - Characters' actions affect other characters
49
+ - Storylines cross at key moments
50
+ - Shared events viewed from multiple perspectives
51
+ - Thematic echoes across storylines
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Character A's decision creates problem for Character B, whose solution affects Character C
55
+ - ❌ **Bad**: Three separate stories that never connect or influence each other
56
+
57
+ **Film Reference**: Magnolia (1999) - Seemingly separate stories converge through shared trauma and location.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Distinct Character Voices
62
+
63
+ **Description**: Each protagonist must have unique personality, goals, and perspective clearly distinguishable from others.
64
+
65
+ **Why It Matters**: Ensemble casts with similar characters blur together and confuse audiences.
66
+
67
+ **Implementation**:
68
+ - Varied backgrounds and worldviews
69
+ - Distinct dialogue patterns
70
+ - Contrasting goals and methods
71
+ - Different emotional registers
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Optimist, cynic, pragmatist, idealist, and rebel each approach same situation differently
75
+ - ❌ **Bad**: Five characters who think, speak, and act similarly
76
+
77
+ **Film Reference**: The Breakfast Club (1985) - Five distinct archetypes with clear individual voices.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Thematic Unity
82
+
83
+ **Description**: All storylines must explore variations of a central theme or question.
84
+
85
+ **Why It Matters**: Without thematic unity, ensemble feels scattered and purposeless.
86
+
87
+ **Implementation**:
88
+ - Identify central theme or question
89
+ - Each character explores different aspect
90
+ - Storylines provide contrasting answers
91
+ - Convergence reveals thematic truth
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Five characters explore "what is family?" through different relationships
95
+ - ❌ **Bad**: Random characters with unrelated themes and goals
96
+
97
+ **Film Reference**: Love Actually (2003) - Multiple storylines explore different facets of love.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Clear Introduction Pattern
102
+
103
+ **Description**: Establish efficient system for introducing multiple protagonists without confusion.
104
+
105
+ **Why It Matters**: Audiences need to track many characters; clear introduction prevents early confusion.
106
+
107
+ **Implementation**:
108
+ - Introduce characters in distinct contexts
109
+ - Use visual or verbal tags for identification
110
+ - Limit initial ensemble to 3-5 main characters
111
+ - Establish each character's world before crossover
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Introduce each character in their own scene with clear visual identity before bringing them together
115
+ - ❌ **Bad**: Introducing all characters simultaneously in crowded scene
116
+
117
+ **Film Reference**: Ocean's Eleven (2001) - Each team member introduced individually with distinct skill and personality.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Convergence or Resonance
122
+
123
+ **Description**: Storylines must either physically converge or thematically resonate by the climax.
124
+
125
+ **Why It Matters**: Ensemble narratives need payoff where separate threads come together or illuminate each other.
126
+
127
+ **Implementation**:
128
+ - Build toward shared climactic event
129
+ - Create moment where all characters' choices matter
130
+ - Show how individual arcs affect collective outcome
131
+ - Provide thematic resolution across all storylines
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: All characters' separate journeys lead them to same location for climactic confrontation
135
+ - ❌ **Bad**: Storylines remain separate through the end with no connection
136
+
137
+ **Film Reference**: The Avengers (2012) - Individual heroes converge for shared battle.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Rotate between storylines to maintain variety
146
+ - Accelerate cutting between storylines as climax approaches
147
+ - Balance quiet character moments with action across ensemble
148
+ - Use one storyline's climax to energize another's development
149
+
150
+ ### Scene Length
151
+
152
+ - Shorter scenes when rapidly cutting between multiple storylines
153
+ - Longer scenes when establishing character or deepening relationship
154
+ - Vary scene length across storylines to create rhythm
155
+ - Avoid predictable pattern of equal scene lengths
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Introduce all main characters and establish their worlds (30% of runtime)
160
+ - **Act II**: Develop individual arcs while building connections (40% of runtime)
161
+ - **Act III**: Converge storylines and resolve all character arcs (30% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Use thematic or visual links between storylines
166
+ - Match cuts between parallel situations
167
+ - Audio bridges across character transitions
168
+ - Contrast cuts for dramatic effect
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Distinct visual style for each character's world
175
+ - Consistent cinematography within each storyline
176
+ - Visual parallels between thematically linked moments
177
+ - Group compositions when characters converge
178
+
179
+ ### Visual Motifs
180
+
181
+ - Recurring objects or images that appear across storylines
182
+ - Color coding for different character threads
183
+ - Symbolic imagery that unites disparate stories
184
+ - Visual callbacks between connected characters
185
+
186
+ ### Action Lines
187
+
188
+ - Clearly identify which character's perspective
189
+ - Maintain distinct tone for each character's scenes
190
+ - Note visual connections between storylines
191
+ - Describe ensemble moments with spatial clarity
192
+
193
+ **Example**:
194
+ ```
195
+ INT. COFFEE SHOP - DAY
196
+
197
+ SARAH sits alone, staring at her phone.
198
+
199
+ Across the room, MARCUS enters, orders coffee. He doesn't notice Sarah.
200
+
201
+ Outside the window, ELENA walks past, phone to her ear.
202
+ ```
203
+
204
+ ## Dialogue Approach
205
+
206
+ ### Dialogue Style
207
+
208
+ - Each character needs distinct speech patterns
209
+ - Conversations reveal character relationships
210
+ - Ensemble scenes require clear speaker identification
211
+ - Balance dialogue across characters in group scenes
212
+
213
+ ### Subtext
214
+
215
+ - Characters know different pieces of information
216
+ - Dramatic irony from audience knowing all storylines
217
+ - Conversations gain meaning from other storylines
218
+ - Subtext emerges from what characters don't know about each other
219
+
220
+ ### Formatting
221
+
222
+ - Clear character names in ensemble scenes
223
+ - Minimal parentheticals to avoid clutter
224
+ - Use blocking to clarify who speaks to whom
225
+ - Consider splitting large ensemble scenes
226
+
227
+ **Example**:
228
+ ```
229
+ SARAH
230
+ (to Marcus)
231
+ Have you seen Elena?
232
+
233
+ MARCUS
234
+ Who?
235
+
236
+ ELENA (O.S.)
237
+ (on phone, outside)
238
+ I'm running late.
239
+ ```
240
+
241
+ ## Technical Formatting
242
+
243
+ ### Page Layout
244
+
245
+ - Use white space to separate storyline transitions
246
+ - Consider title cards for major character introductions
247
+ - Maintain clear scene headings for location shifts
248
+ - Balance page density across storylines
249
+
250
+ ### Scene Headings
251
+
252
+ - Specific locations help track multiple settings
253
+ - Consider character names in headings for clarity
254
+ - Use INTERCUT for parallel action
255
+ - Number scenes sequentially regardless of storyline
256
+
257
+ ### Special Elements
258
+
259
+ - INTERCUT for simultaneous action across storylines
260
+ - MONTAGE for showing multiple characters' parallel activities
261
+ - SPLIT SCREEN notation if visually presenting multiple storylines
262
+ - Title cards for character introductions or time shifts
263
+
264
+ ## Strengths and Limitations
265
+
266
+ ### Strengths
267
+
268
+ - Explores themes from multiple perspectives
269
+ - Creates rich, complex narrative tapestry
270
+ - Allows diverse representation and viewpoints
271
+ - Generates dramatic irony through information distribution
272
+ - Provides variety in tone and pacing
273
+
274
+ ### Limitations
275
+
276
+ - Risk of overcrowding and confusion
277
+ - Difficult to develop all characters fully
278
+ - Some storylines may feel weaker than others
279
+ - Requires longer runtime or sacrifices depth
280
+ - Challenging to maintain audience investment in all threads
281
+
282
+ ### Best Use Cases
283
+
284
+ - Stories exploring community or social issues
285
+ - Workplace or team dynamics
286
+ - Interconnected urban narratives
287
+ - Event-based stories (weddings, disasters, holidays)
288
+ - Thematic explorations requiring multiple perspectives
289
+ - Heist or mission films with specialized team members
290
+
291
+ ## Film Examples
292
+
293
+ ### Example 1: Pulp Fiction (1994)
294
+
295
+ **Director**: Quentin Tarantino
296
+
297
+ **Why This Style Works**: Multiple criminal storylines intersect and influence each other, creating thematic unity about redemption and chance.
298
+
299
+ **Key Stylistic Moments**:
300
+ - **Vincent and Jules**: Hitmen storyline establishes tone
301
+ - **Butch**: Boxer storyline intersects with Vincent's
302
+ - **Convergence**: All storylines connect through shared locations and events
303
+
304
+ **Techniques Used**:
305
+ - Chapter structure for each storyline
306
+ - Non-linear arrangement creates connections
307
+ - Shared locations (diner, apartment) link characters
308
+ - Thematic exploration of redemption across all stories
309
+
310
+ **Structural Analysis**: Three main storylines with supporting threads, all interconnected through location, events, and theme.
311
+
312
+ ---
313
+
314
+ ### Example 2: Crash (2004)
315
+
316
+ **Director**: Paul Haggis
317
+
318
+ **Why This Style Works**: Multiple Los Angeles residents' lives intersect over 36 hours, exploring racial tension from diverse perspectives.
319
+
320
+ **Key Stylistic Moments**:
321
+ - **Opening Crash**: Establishes interconnection theme
322
+ - **Parallel Storylines**: Each character explores prejudice differently
323
+ - **Convergence**: Characters' actions ripple across storylines
324
+
325
+ **Techniques Used**:
326
+ - Compressed timeframe unites disparate stories
327
+ - Cause-and-effect across storylines
328
+ - Thematic unity (racism, connection) across all threads
329
+ - Ensemble cast with no single protagonist
330
+
331
+ **Structural Analysis**: Six to eight main storylines intersecting through shared events and locations over single day.
332
+
333
+ ---
334
+
335
+ ### Example 3: The Breakfast Club (1985)
336
+
337
+ **Director**: John Hughes
338
+
339
+ **Why This Style Works**: Five distinct archetypes confined to single location allows deep character exploration and thematic unity.
340
+
341
+ **Key Stylistic Moments**:
342
+ - **Introduction**: Each character established through distinct entrance
343
+ - **Conflict**: Characters clash based on stereotypes
344
+ - **Revelation**: Each character reveals hidden depth
345
+
346
+ **Techniques Used**:
347
+ - Single location focuses attention on character
348
+ - Real-time narrative maintains unity
349
+ - Distinct archetypes ensure clear differentiation
350
+ - Shared experience creates convergence
351
+
352
+ **Structural Analysis**: Five equal protagonists in confined space, with individual arcs converging through shared experience.
353
+
354
+ ---
355
+
356
+ ### Example 4: Love Actually (2003)
357
+
358
+ **Director**: Richard Curtis
359
+
360
+ **Why This Style Works**: Multiple love stories explore different facets of romance, creating comprehensive thematic exploration.
361
+
362
+ **Key Stylistic Moments**:
363
+ - **Parallel Introductions**: Each couple introduced in separate context
364
+ - **Thematic Variations**: Different types of love explored
365
+ - **Christmas Convergence**: All storylines resolve around holiday
366
+
367
+ **Techniques Used**:
368
+ - Thematic unity across disparate storylines
369
+ - Minimal physical intersection between characters
370
+ - Parallel structure with similar beats
371
+ - Emotional resonance rather than plot convergence
372
+
373
+ **Structural Analysis**: Eight to ten storylines with minimal intersection, united by theme and timeframe rather than plot.
374
+
375
+ ---
376
+
377
+ ### Example 5: The Avengers (2012)
378
+
379
+ **Director**: Joss Whedon
380
+
381
+ **Why This Style Works**: Established individual heroes converge for shared mission, balancing distinct personalities with team dynamics.
382
+
383
+ **Key Stylistic Moments**:
384
+ - **Individual Introductions**: Each hero shown in their element
385
+ - **Conflict**: Personalities clash before uniting
386
+ - **Convergence**: Team assembles for climactic battle
387
+
388
+ **Techniques Used**:
389
+ - Pre-established characters allow faster introduction
390
+ - Distinct powers and personalities ensure differentiation
391
+ - Shared goal unites disparate storylines
392
+ - Balanced screen time across ensemble
393
+
394
+ **Structural Analysis**: Six main characters with individual arcs converging into single team narrative.
395
+
396
+ ---
397
+
398
+ ## Integration with Other Features
399
+
400
+ ### Compatible Genres
401
+
402
+ - **Drama**: Multiple perspectives deepen thematic exploration
403
+ - **Comedy**: Ensemble allows varied comedic styles
404
+ - **Crime**: Heist teams or interconnected criminal stories
405
+ - **Romance**: Multiple relationship dynamics
406
+ - **Action**: Team-based missions with specialized members
407
+
408
+ ### Compatible Themes
409
+
410
+ - **Community**: Ensemble naturally explores collective experience
411
+ - **Interconnection**: Multiple storylines show how lives intersect
412
+ - **Perspective**: Different viewpoints on same events or issues
413
+ - **Diversity**: Ensemble allows representation of varied experiences
414
+ - **Collaboration**: Team dynamics and collective achievement
415
+
416
+ ### Style Variations
417
+
418
+ - **Convergent ensemble**: Separate storylines physically meet (Crash)
419
+ - **Parallel ensemble**: Storylines remain separate but thematically linked (Love Actually)
420
+ - **Team ensemble**: Group with shared goal (Ocean's Eleven)
421
+ - **Location ensemble**: Characters united by place (Grand Hotel)
422
+
423
+ ## Common Pitfalls
424
+
425
+ ### Pitfall 1: Overcrowding
426
+
427
+ **Problem**: Too many characters dilutes focus and prevents adequate development.
428
+
429
+ **Solution**: Limit main ensemble to 3-6 characters. Others can be supporting roles.
430
+
431
+ **Example**: The Breakfast Club succeeds with five characters; more would prevent the depth achieved.
432
+
433
+ ---
434
+
435
+ ### Pitfall 2: Unbalanced Screen Time
436
+
437
+ **Problem**: One or two characters dominate, making others feel like supporting roles.
438
+
439
+ **Solution**: Track page count per character and ensure relative balance. Cut weaker storylines.
440
+
441
+ **Example**: Ensure no character gets less than 15% or more than 30% of focus in true ensemble.
442
+
443
+ ---
444
+
445
+ ### Pitfall 3: Weak Connections
446
+
447
+ **Problem**: Storylines feel disconnected, like anthology rather than ensemble.
448
+
449
+ **Solution**: Create clear thematic links, shared events, or direct character interactions.
450
+
451
+ **Example**: Crash ensures every storyline directly affects at least one other storyline.
452
+
453
+ ---
454
+
455
+ ### Pitfall 4: Indistinct Characters
456
+
457
+ **Problem**: Characters blur together due to similar voices or goals.
458
+
459
+ **Solution**: Give each character distinct background, speech pattern, and approach to central theme.
460
+
461
+ **Example**: The Breakfast Club's five archetypes (brain, athlete, basket case, princess, criminal) ensure clear differentiation.
462
+
463
+ ---
464
+
465
+ ### Pitfall 5: Lack of Convergence
466
+
467
+ **Problem**: Storylines never come together or illuminate each other.
468
+
469
+ **Solution**: Build toward moment where all storylines converge or thematically resonate.
470
+
471
+ **Example**: The Avengers builds toward climactic battle where all heroes must work together.
472
+
473
+ ---
474
+
475
+ ## Best Practices
476
+
477
+ 1. **Limit ensemble size** - 3-6 main characters is ideal; more risks confusion
478
+ 2. **Create distinct voices** - Each character should be identifiable by dialogue alone
479
+ 3. **Establish thematic unity** - All storylines should explore variations of central theme
480
+ 4. **Track screen time** - Ensure relative balance across main characters
481
+ 5. **Build connections** - Storylines should intersect or influence each other
482
+ 6. **Use efficient introductions** - Establish characters quickly and distinctly
483
+ 7. **Plan convergence** - Know how storylines will come together or resonate
484
+ 8. **Maintain individual arcs** - Each character needs complete journey
485
+
486
+ ## Resources
487
+
488
+ - "The Anatomy of Story" by John Truby - Multi-protagonist narratives
489
+ - "Save the Cat!" by Blake Snyder - Ensemble structure beats
490
+ - "Screenplay" by Syd Field - Multiple protagonist structure
491
+ - "Pulp Fiction" screenplay by Quentin Tarantino - Master class in ensemble
492
+ - "The Breakfast Club" screenplay by John Hughes - Confined ensemble dynamics
493
+
494
+ ---
495
+
496
+ **Depth Coverage**: 85%
497
+ **Last Updated**: 2026-01-31
498
+ **Version**: 1.0.0
499
+