@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,409 +1,409 @@
1
- # Drama Genre
2
-
3
- **Category**: Screenplay Genre
4
- **Type**: Primary
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Drama films focus on realistic characters facing emotional conflicts, moral dilemmas, and personal struggles. The genre emphasizes character development, authentic relationships, and meaningful themes over spectacle or plot mechanics.
10
-
11
- ## Core Concept
12
-
13
- Drama screenplays are built around characters confronting difficult truths, making hard choices, and experiencing genuine emotional transformation. Success depends on creating complex, believable characters, authentic dialogue, and situations that resonate with universal human experiences.
14
-
15
- ## Core Rules
16
-
17
- ### Rule 1: Character is Plot
18
-
19
- **Description**: In drama, what happens is less important than how it affects the characters and what it reveals about them.
20
-
21
- **Why It Matters**: Drama is character-driven. External events serve internal journeys, not vice versa.
22
-
23
- **Examples**:
24
- - ✅ **Good**: A family dinner reveals long-buried resentments and forces confrontation
25
- - ❌ **Bad**: Action-packed events with no character impact or growth
26
-
27
- **Film Reference**: Manchester by the Sea (2016) - Every plot point reveals character and deepens emotional complexity.
28
-
29
- ---
30
-
31
- ### Rule 2: Establish Authentic Emotional Stakes
32
-
33
- **Description**: The audience must understand and care deeply about what the character stands to lose or gain emotionally.
34
-
35
- **Why It Matters**: Without genuine emotional investment, drama becomes melodrama or feels hollow.
36
-
37
- **Examples**:
38
- - ✅ **Good**: A parent fighting to maintain relationship with their child
39
- - ❌ **Bad**: Generic conflict with no emotional specificity
40
-
41
- **Film Reference**: Kramer vs. Kramer (1979) - Custody battle grounded in authentic parental love and growth.
42
-
43
- ---
44
-
45
- ### Rule 3: Show Internal Conflict Externally
46
-
47
- **Description**: Make internal struggles visible through behavior, choices, and dialogue rather than exposition.
48
-
49
- **Why It Matters**: Film is a visual medium. Internal conflict must manifest in observable ways.
50
-
51
- **Examples**:
52
- - ✅ **Good**: Character's addiction shown through missed appointments, broken promises, physical deterioration
53
- - ❌ **Bad**: Character tells therapist about their internal struggles in exposition-heavy scenes
54
-
55
- **Film Reference**: Requiem for a Dream (2000) - Addiction's internal grip shown through escalating external consequences.
56
-
57
- ---
58
-
59
- ### Rule 4: Create Moral Complexity
60
-
61
- **Description**: Avoid simple good vs. evil. Give characters understandable motivations even when they make wrong choices.
62
-
63
- **Why It Matters**: Moral complexity creates richer drama and more realistic characters. Real people are contradictory.
64
-
65
- **Examples**:
66
- - ✅ **Good**: Antagonist has valid grievances and relatable motivations
67
- - ❌ **Bad**: Villain is evil for evil's sake with no depth
68
-
69
- **Film Reference**: There Will Be Blood (2007) - Daniel Plainview is compelling despite being morally compromised.
70
-
71
- ---
72
-
73
- ### Rule 5: Build Through Subtext
74
-
75
- **Description**: Characters should rarely say exactly what they mean. Meaning lives beneath the surface of dialogue.
76
-
77
- **Why It Matters**: Subtext creates depth, realism, and engagement. People in real life avoid direct confrontation.
78
-
79
- **Examples**:
80
- - ✅ **Good**: Couple argues about dishes when really discussing their failing marriage
81
- - ❌ **Bad**: Characters explicitly state their feelings and motivations constantly
82
-
83
- **Film Reference**: Revolutionary Road (2008) - Suburban pleasantries mask deep dissatisfaction and rage.
84
-
85
- ---
86
-
87
- ### Rule 6: Earn Emotional Moments
88
-
89
- **Description**: Big emotional beats must be set up through careful character development and escalation.
90
-
91
- **Why It Matters**: Unearned emotion feels manipulative. Audiences resent being told how to feel.
92
-
93
- **Examples**:
94
- - ✅ **Good**: Breakdown comes after accumulation of specific, relatable pressures
95
- - ❌ **Bad**: Character cries in scene 3 before we know or care about them
96
-
97
- **Film Reference**: Moonlight (2016) - Every emotional moment earned through careful character building.
98
-
99
- ---
100
-
101
- ### Rule 7: Use Specificity Over Generality
102
-
103
- **Description**: Ground drama in specific details of time, place, culture, and character rather than generic situations.
104
-
105
- **Why It Matters**: Specificity creates authenticity and universality. Generic feels false.
106
-
107
- **Examples**:
108
- - ✅ **Good**: Working-class Boston family with specific cultural touchstones and speech patterns
109
- - ❌ **Bad**: Generic "family" with no cultural or regional identity
110
-
111
- **Film Reference**: Fences (2016) - Specific African American experience in 1950s Pittsburgh creates universal themes.
112
-
113
- ---
114
-
115
- ### Rule 8: Escalate Emotional Pressure
116
-
117
- **Description**: Each scene should increase the emotional stakes or pressure on the protagonist.
118
-
119
- **Why It Matters**: Drama needs momentum. Flat emotional energy loses audience engagement.
120
-
121
- **Examples**:
122
- - ✅ **Good**: Small lie → bigger lie → confrontation → revelation → consequences
123
- - ❌ **Bad**: Same level of conflict throughout with no escalation
124
-
125
- **Film Reference**: A Marriage Story (2019) - Divorce proceedings escalate from civil to devastating.
126
-
127
- ---
128
-
129
- ### Rule 9: Create Moments of Grace
130
-
131
- **Description**: Balance heavy drama with moments of beauty, humor, or human connection.
132
-
133
- **Why It Matters**: Relentless darkness becomes numbing. Contrast makes drama more powerful.
134
-
135
- **Examples**:
136
- - ✅ **Good**: Grieving family shares a genuine laugh remembering the deceased
137
- - ❌ **Bad**: Two hours of unrelenting misery with no light
138
-
139
- **Film Reference**: The Florida Project (2017) - Childhood wonder and play amid poverty and dysfunction.
140
-
141
- ---
142
-
143
- ### Rule 10: Resolve Emotionally, Not Just Plotwise
144
-
145
- **Description**: The ending must provide emotional resolution or meaningful change, even if plot threads remain open.
146
-
147
- **Why It Matters**: Drama is about emotional journeys. Plot resolution without emotional payoff feels empty.
148
-
149
- **Examples**:
150
- - ✅ **Good**: Character doesn't get what they wanted but achieves understanding or acceptance
151
- - ❌ **Bad**: All plot points tied up but character unchanged and unaffected
152
-
153
- **Film Reference**: Lady Bird (2017) - Plot ends with college, but emotional resolution is mother-daughter understanding.
154
-
155
- ---
156
-
157
- ## Guidelines
158
-
159
- ### Structure
160
-
161
- - **Act I**: Establish character's world, relationships, and internal conflict; inciting incident disrupts status quo (pages 1-25)
162
- - **Act II**: Character confronts conflict, makes choices that complicate situation, relationships tested, crisis point (pages 25-85)
163
- - **Act III**: Final confrontation with self or others, emotional climax, resolution or acceptance (pages 85-110)
164
-
165
- ### Pacing
166
-
167
- - Allow scenes to breathe - drama needs time for emotional beats
168
- - Build tension through character interaction, not just plot events
169
- - Use quiet moments strategically
170
- - Escalate emotional stakes gradually
171
- - Climax should be emotional peak, not necessarily action peak
172
-
173
- ### Character Archetypes
174
-
175
- - **Protagonist**: Flawed, complex, relatable, facing internal and external conflict
176
- - **Antagonist**: Often another complex character with opposing needs (not evil villain)
177
- - **Supporting**: Mirror protagonist's journey, offer contrast, or represent different choices
178
- - **Confidant**: Character protagonist can be honest with (therapist, friend, mentor)
179
-
180
- ### Tone and Atmosphere
181
-
182
- - Realistic and grounded
183
- - Emotionally authentic
184
- - Serious but not necessarily humorless
185
- - Intimate and character-focused
186
- - Subgenre-specific (family drama vs. courtroom drama vs. addiction drama)
187
-
188
- ### Visual Style
189
-
190
- - Naturalistic lighting and cinematography
191
- - Close-ups for emotional moments
192
- - Environment reflects character's internal state
193
- - Minimal stylization (unless serving theme)
194
- - Focus on faces and reactions
195
-
196
- ### Dialogue
197
-
198
- - Subtext-heavy
199
- - Character-specific voices
200
- - Realistic speech patterns (interruptions, pauses, fragments)
201
- - Avoid exposition dumps
202
- - What's NOT said is often more important than what is
203
-
204
- ## Common Pitfalls
205
-
206
- ### Pitfall 1: Melodrama
207
-
208
- **Problem**: Over-the-top emotions, contrived situations, or manipulative music cues instead of earned drama.
209
-
210
- **Solution**: Ground emotions in specific, believable circumstances. Trust the audience to feel without forcing it.
211
-
212
- **Example**: Character's quiet devastation is more powerful than theatrical breakdown.
213
-
214
- ---
215
-
216
- ### Pitfall 2: Talking Heads
217
-
218
- **Problem**: Scenes of people sitting and talking with no visual interest or subtext.
219
-
220
- **Solution**: Give characters activities, use environment, create visual metaphors, employ subtext.
221
-
222
- **Example**: Difficult conversation happens while packing boxes, cooking dinner, or walking - activity adds layers.
223
-
224
- ---
225
-
226
- ### Pitfall 3: Passive Protagonist
227
-
228
- **Problem**: Things happen TO the character rather than the character making active choices.
229
-
230
- **Solution**: Give protagonist agency. Even in difficult circumstances, they must make choices that drive the story.
231
-
232
- **Example**: Character chooses to confront their past rather than being forced into it by circumstances.
233
-
234
- ---
235
-
236
- ### Pitfall 4: Unearned Resolution
237
-
238
- **Problem**: Character suddenly changes or problem resolves without sufficient development or consequence.
239
-
240
- **Solution**: Transformation must be gradual and hard-won. Show the work of change.
241
-
242
- **Example**: Addict's recovery shown through specific struggles and setbacks, not sudden epiphany.
243
-
244
- ---
245
-
246
- ### Pitfall 5: Lack of Specificity
247
-
248
- **Problem**: Generic characters in generic situations saying generic things.
249
-
250
- **Solution**: Research, observe, and create specific details of culture, class, region, profession, era.
251
-
252
- **Example**: Don't write "a family" - write "a second-generation Korean-American family running a laundromat in 1980s Los Angeles."
253
-
254
- ---
255
-
256
- ## Film Examples
257
-
258
- ### Example 1: Manchester by the Sea (2016)
259
-
260
- **Director**: Kenneth Lonergan
261
-
262
- **Why It Works**: Devastating emotional honesty, complex protagonist, authentic grief, earned moments.
263
-
264
- **Key Scenes**:
265
- - **Flashback Revelation**: Reveals Lee's trauma through carefully structured flashbacks
266
- - **Hospital Confrontation**: Lee's inability to forgive himself shown through rejection of ex-wife's forgiveness
267
- - **Final Scene**: Emotional resolution without false hope
268
-
269
- **Techniques Used**:
270
- - Non-linear structure reveals character gradually
271
- - Subtext in every scene
272
- - Humor balances grief
273
- - Specific cultural and regional details
274
- - Quiet devastation over melodrama
275
-
276
- ---
277
-
278
- ### Example 2: Moonlight (2016)
279
-
280
- **Director**: Barry Jenkins
281
-
282
- **Why It Works**: Three-act structure showing character at different life stages, visual poetry, restrained emotion.
283
-
284
- **Key Scenes**:
285
- - **Swimming Lesson**: Tenderness and mentorship
286
- - **Diner Confrontation**: Chiron's transformation and suppressed emotion
287
- - **Final Reunion**: Vulnerability and connection
288
-
289
- **Techniques Used**:
290
- - Triptych structure (three life stages)
291
- - Visual storytelling over dialogue
292
- - Specific cultural context
293
- - Intimacy and restraint
294
- - Color and music as emotional language
295
-
296
- ---
297
-
298
- ### Example 3: A Marriage Story (2019)
299
-
300
- **Director**: Noah Baumbach
301
-
302
- **Why It Works**: Authentic portrayal of divorce, complex characters both right and wrong, escalating conflict.
303
-
304
- **Key Scenes**:
305
- - **Opening Montages**: What they love about each other (never spoken aloud)
306
- - **Argument Scene**: Escalation from civil to devastating
307
- - **Shoe-Tying**: Small gesture of lingering care
308
-
309
- **Techniques Used**:
310
- - Dual perspective (both characters sympathetic)
311
- - Escalating conflict
312
- - Specific details of marriage and divorce
313
- - Humor amid pain
314
- - Small moments carry weight
315
-
316
- ---
317
-
318
- ### Example 4: The Florida Project (2017)
319
-
320
- **Director**: Sean Baker
321
-
322
- **Why It Works**: Child's perspective on poverty, beauty in hardship, non-judgmental observation.
323
-
324
- **Key Scenes**:
325
- - **Ice Cream**: Small kindness amid struggle
326
- - **Final Confrontation**: Mother's desperation
327
- - **Ending**: Childhood imagination as escape
328
-
329
- **Techniques Used**:
330
- - Child's POV creates distance and intimacy
331
- - Vibrant colors contrast with subject matter
332
- - Non-professional actors add authenticity
333
- - Observational style
334
- - Empathy without sentimentality
335
-
336
- ---
337
-
338
- ### Example 5: There Will Be Blood (2007)
339
-
340
- **Director**: Paul Thomas Anderson
341
-
342
- **Why It Works**: Epic scope with intimate character study, moral complexity, visual storytelling.
343
-
344
- **Key Scenes**:
345
- - **Opening Sequence**: Wordless character establishment
346
- - **Milkshake Speech**: Culmination of rivalry and greed
347
- - **Final Confrontation**: Moral degradation complete
348
-
349
- **Techniques Used**:
350
- - Visual storytelling (minimal dialogue early)
351
- - Character as force of nature
352
- - Historical specificity
353
- - Moral complexity
354
- - Operatic scope with intimate focus
355
-
356
- ---
357
-
358
- ## Integration with Other Features
359
-
360
- ### Compatible Themes
361
-
362
- - **Redemption**: Character seeks to atone (The Wrestler)
363
- - **Identity**: Character discovers or accepts self (Moonlight)
364
- - **Love**: Relationships tested and transformed (Blue Valentine)
365
- - **Betrayal**: Trust broken and consequences (The Godfather Part II)
366
- - **Growth**: Character matures through hardship (Lady Bird)
367
-
368
- ### Compatible Styles
369
-
370
- - **Linear**: Traditional dramatic structure (most dramas)
371
- - **Non-Linear**: Flashbacks reveal character (Manchester by the Sea)
372
- - **Ensemble**: Multiple character perspectives (Magnolia)
373
- - **Minimalist**: Stripped-down, focused drama (45 Years)
374
-
375
- ### Hybrid Combinations
376
-
377
- - **Courtroom Drama**: Legal framework for moral questions (A Few Good Men)
378
- - **Family Drama**: Domestic conflicts (August: Osage County)
379
- - **Historical Drama**: Personal stories in historical context (12 Years a Slave)
380
- - **Addiction Drama**: Substance abuse and recovery (Requiem for a Dream)
381
- - **Coming-of-Age Drama**: Youth and maturation (Boyhood)
382
-
383
- ## Best Practices
384
-
385
- 1. **Start with character, not plot** - Know who they are before deciding what happens
386
- 2. **Create specific, not generic** - Details of culture, class, region make drama universal
387
- 3. **Show, don't tell** - Internal conflict must manifest externally
388
- 4. **Earn every emotion** - Build to big moments through careful development
389
- 5. **Use subtext constantly** - People rarely say what they mean
390
- 6. **Make characters complex** - Everyone is the hero of their own story
391
- 7. **Balance darkness with light** - Moments of grace make drama more powerful
392
- 8. **Let scenes breathe** - Drama needs time for emotional beats
393
- 9. **Escalate emotional stakes** - Each scene should increase pressure
394
- 10. **Resolve emotionally** - Plot resolution without emotional payoff is empty
395
-
396
- ## Resources
397
-
398
- - "The Art of Dramatic Writing" by Lajos Egri
399
- - "Writing Drama" by Yves Lavandier
400
- - "The Anatomy of Story" by John Truby
401
- - "Screenplay" by Syd Field
402
- - Study: Manchester by the Sea, Moonlight, A Marriage Story, The Florida Project, There Will Be Blood
403
-
404
- ---
405
-
406
- **Depth Coverage**: 85%
407
- **Last Updated**: 2026-01-31
408
- **Version**: 1.0.0
409
-
1
+ # Drama Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Drama films focus on realistic characters facing emotional conflicts, moral dilemmas, and personal struggles. The genre emphasizes character development, authentic relationships, and meaningful themes over spectacle or plot mechanics.
10
+
11
+ ## Core Concept
12
+
13
+ Drama screenplays are built around characters confronting difficult truths, making hard choices, and experiencing genuine emotional transformation. Success depends on creating complex, believable characters, authentic dialogue, and situations that resonate with universal human experiences.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Character is Plot
18
+
19
+ **Description**: In drama, what happens is less important than how it affects the characters and what it reveals about them.
20
+
21
+ **Why It Matters**: Drama is character-driven. External events serve internal journeys, not vice versa.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: A family dinner reveals long-buried resentments and forces confrontation
25
+ - ❌ **Bad**: Action-packed events with no character impact or growth
26
+
27
+ **Film Reference**: Manchester by the Sea (2016) - Every plot point reveals character and deepens emotional complexity.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Establish Authentic Emotional Stakes
32
+
33
+ **Description**: The audience must understand and care deeply about what the character stands to lose or gain emotionally.
34
+
35
+ **Why It Matters**: Without genuine emotional investment, drama becomes melodrama or feels hollow.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: A parent fighting to maintain relationship with their child
39
+ - ❌ **Bad**: Generic conflict with no emotional specificity
40
+
41
+ **Film Reference**: Kramer vs. Kramer (1979) - Custody battle grounded in authentic parental love and growth.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Show Internal Conflict Externally
46
+
47
+ **Description**: Make internal struggles visible through behavior, choices, and dialogue rather than exposition.
48
+
49
+ **Why It Matters**: Film is a visual medium. Internal conflict must manifest in observable ways.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Character's addiction shown through missed appointments, broken promises, physical deterioration
53
+ - ❌ **Bad**: Character tells therapist about their internal struggles in exposition-heavy scenes
54
+
55
+ **Film Reference**: Requiem for a Dream (2000) - Addiction's internal grip shown through escalating external consequences.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Create Moral Complexity
60
+
61
+ **Description**: Avoid simple good vs. evil. Give characters understandable motivations even when they make wrong choices.
62
+
63
+ **Why It Matters**: Moral complexity creates richer drama and more realistic characters. Real people are contradictory.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Antagonist has valid grievances and relatable motivations
67
+ - ❌ **Bad**: Villain is evil for evil's sake with no depth
68
+
69
+ **Film Reference**: There Will Be Blood (2007) - Daniel Plainview is compelling despite being morally compromised.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Build Through Subtext
74
+
75
+ **Description**: Characters should rarely say exactly what they mean. Meaning lives beneath the surface of dialogue.
76
+
77
+ **Why It Matters**: Subtext creates depth, realism, and engagement. People in real life avoid direct confrontation.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Couple argues about dishes when really discussing their failing marriage
81
+ - ❌ **Bad**: Characters explicitly state their feelings and motivations constantly
82
+
83
+ **Film Reference**: Revolutionary Road (2008) - Suburban pleasantries mask deep dissatisfaction and rage.
84
+
85
+ ---
86
+
87
+ ### Rule 6: Earn Emotional Moments
88
+
89
+ **Description**: Big emotional beats must be set up through careful character development and escalation.
90
+
91
+ **Why It Matters**: Unearned emotion feels manipulative. Audiences resent being told how to feel.
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Breakdown comes after accumulation of specific, relatable pressures
95
+ - ❌ **Bad**: Character cries in scene 3 before we know or care about them
96
+
97
+ **Film Reference**: Moonlight (2016) - Every emotional moment earned through careful character building.
98
+
99
+ ---
100
+
101
+ ### Rule 7: Use Specificity Over Generality
102
+
103
+ **Description**: Ground drama in specific details of time, place, culture, and character rather than generic situations.
104
+
105
+ **Why It Matters**: Specificity creates authenticity and universality. Generic feels false.
106
+
107
+ **Examples**:
108
+ - ✅ **Good**: Working-class Boston family with specific cultural touchstones and speech patterns
109
+ - ❌ **Bad**: Generic "family" with no cultural or regional identity
110
+
111
+ **Film Reference**: Fences (2016) - Specific African American experience in 1950s Pittsburgh creates universal themes.
112
+
113
+ ---
114
+
115
+ ### Rule 8: Escalate Emotional Pressure
116
+
117
+ **Description**: Each scene should increase the emotional stakes or pressure on the protagonist.
118
+
119
+ **Why It Matters**: Drama needs momentum. Flat emotional energy loses audience engagement.
120
+
121
+ **Examples**:
122
+ - ✅ **Good**: Small lie → bigger lie → confrontation → revelation → consequences
123
+ - ❌ **Bad**: Same level of conflict throughout with no escalation
124
+
125
+ **Film Reference**: A Marriage Story (2019) - Divorce proceedings escalate from civil to devastating.
126
+
127
+ ---
128
+
129
+ ### Rule 9: Create Moments of Grace
130
+
131
+ **Description**: Balance heavy drama with moments of beauty, humor, or human connection.
132
+
133
+ **Why It Matters**: Relentless darkness becomes numbing. Contrast makes drama more powerful.
134
+
135
+ **Examples**:
136
+ - ✅ **Good**: Grieving family shares a genuine laugh remembering the deceased
137
+ - ❌ **Bad**: Two hours of unrelenting misery with no light
138
+
139
+ **Film Reference**: The Florida Project (2017) - Childhood wonder and play amid poverty and dysfunction.
140
+
141
+ ---
142
+
143
+ ### Rule 10: Resolve Emotionally, Not Just Plotwise
144
+
145
+ **Description**: The ending must provide emotional resolution or meaningful change, even if plot threads remain open.
146
+
147
+ **Why It Matters**: Drama is about emotional journeys. Plot resolution without emotional payoff feels empty.
148
+
149
+ **Examples**:
150
+ - ✅ **Good**: Character doesn't get what they wanted but achieves understanding or acceptance
151
+ - ❌ **Bad**: All plot points tied up but character unchanged and unaffected
152
+
153
+ **Film Reference**: Lady Bird (2017) - Plot ends with college, but emotional resolution is mother-daughter understanding.
154
+
155
+ ---
156
+
157
+ ## Guidelines
158
+
159
+ ### Structure
160
+
161
+ - **Act I**: Establish character's world, relationships, and internal conflict; inciting incident disrupts status quo (pages 1-25)
162
+ - **Act II**: Character confronts conflict, makes choices that complicate situation, relationships tested, crisis point (pages 25-85)
163
+ - **Act III**: Final confrontation with self or others, emotional climax, resolution or acceptance (pages 85-110)
164
+
165
+ ### Pacing
166
+
167
+ - Allow scenes to breathe - drama needs time for emotional beats
168
+ - Build tension through character interaction, not just plot events
169
+ - Use quiet moments strategically
170
+ - Escalate emotional stakes gradually
171
+ - Climax should be emotional peak, not necessarily action peak
172
+
173
+ ### Character Archetypes
174
+
175
+ - **Protagonist**: Flawed, complex, relatable, facing internal and external conflict
176
+ - **Antagonist**: Often another complex character with opposing needs (not evil villain)
177
+ - **Supporting**: Mirror protagonist's journey, offer contrast, or represent different choices
178
+ - **Confidant**: Character protagonist can be honest with (therapist, friend, mentor)
179
+
180
+ ### Tone and Atmosphere
181
+
182
+ - Realistic and grounded
183
+ - Emotionally authentic
184
+ - Serious but not necessarily humorless
185
+ - Intimate and character-focused
186
+ - Subgenre-specific (family drama vs. courtroom drama vs. addiction drama)
187
+
188
+ ### Visual Style
189
+
190
+ - Naturalistic lighting and cinematography
191
+ - Close-ups for emotional moments
192
+ - Environment reflects character's internal state
193
+ - Minimal stylization (unless serving theme)
194
+ - Focus on faces and reactions
195
+
196
+ ### Dialogue
197
+
198
+ - Subtext-heavy
199
+ - Character-specific voices
200
+ - Realistic speech patterns (interruptions, pauses, fragments)
201
+ - Avoid exposition dumps
202
+ - What's NOT said is often more important than what is
203
+
204
+ ## Common Pitfalls
205
+
206
+ ### Pitfall 1: Melodrama
207
+
208
+ **Problem**: Over-the-top emotions, contrived situations, or manipulative music cues instead of earned drama.
209
+
210
+ **Solution**: Ground emotions in specific, believable circumstances. Trust the audience to feel without forcing it.
211
+
212
+ **Example**: Character's quiet devastation is more powerful than theatrical breakdown.
213
+
214
+ ---
215
+
216
+ ### Pitfall 2: Talking Heads
217
+
218
+ **Problem**: Scenes of people sitting and talking with no visual interest or subtext.
219
+
220
+ **Solution**: Give characters activities, use environment, create visual metaphors, employ subtext.
221
+
222
+ **Example**: Difficult conversation happens while packing boxes, cooking dinner, or walking - activity adds layers.
223
+
224
+ ---
225
+
226
+ ### Pitfall 3: Passive Protagonist
227
+
228
+ **Problem**: Things happen TO the character rather than the character making active choices.
229
+
230
+ **Solution**: Give protagonist agency. Even in difficult circumstances, they must make choices that drive the story.
231
+
232
+ **Example**: Character chooses to confront their past rather than being forced into it by circumstances.
233
+
234
+ ---
235
+
236
+ ### Pitfall 4: Unearned Resolution
237
+
238
+ **Problem**: Character suddenly changes or problem resolves without sufficient development or consequence.
239
+
240
+ **Solution**: Transformation must be gradual and hard-won. Show the work of change.
241
+
242
+ **Example**: Addict's recovery shown through specific struggles and setbacks, not sudden epiphany.
243
+
244
+ ---
245
+
246
+ ### Pitfall 5: Lack of Specificity
247
+
248
+ **Problem**: Generic characters in generic situations saying generic things.
249
+
250
+ **Solution**: Research, observe, and create specific details of culture, class, region, profession, era.
251
+
252
+ **Example**: Don't write "a family" - write "a second-generation Korean-American family running a laundromat in 1980s Los Angeles."
253
+
254
+ ---
255
+
256
+ ## Film Examples
257
+
258
+ ### Example 1: Manchester by the Sea (2016)
259
+
260
+ **Director**: Kenneth Lonergan
261
+
262
+ **Why It Works**: Devastating emotional honesty, complex protagonist, authentic grief, earned moments.
263
+
264
+ **Key Scenes**:
265
+ - **Flashback Revelation**: Reveals Lee's trauma through carefully structured flashbacks
266
+ - **Hospital Confrontation**: Lee's inability to forgive himself shown through rejection of ex-wife's forgiveness
267
+ - **Final Scene**: Emotional resolution without false hope
268
+
269
+ **Techniques Used**:
270
+ - Non-linear structure reveals character gradually
271
+ - Subtext in every scene
272
+ - Humor balances grief
273
+ - Specific cultural and regional details
274
+ - Quiet devastation over melodrama
275
+
276
+ ---
277
+
278
+ ### Example 2: Moonlight (2016)
279
+
280
+ **Director**: Barry Jenkins
281
+
282
+ **Why It Works**: Three-act structure showing character at different life stages, visual poetry, restrained emotion.
283
+
284
+ **Key Scenes**:
285
+ - **Swimming Lesson**: Tenderness and mentorship
286
+ - **Diner Confrontation**: Chiron's transformation and suppressed emotion
287
+ - **Final Reunion**: Vulnerability and connection
288
+
289
+ **Techniques Used**:
290
+ - Triptych structure (three life stages)
291
+ - Visual storytelling over dialogue
292
+ - Specific cultural context
293
+ - Intimacy and restraint
294
+ - Color and music as emotional language
295
+
296
+ ---
297
+
298
+ ### Example 3: A Marriage Story (2019)
299
+
300
+ **Director**: Noah Baumbach
301
+
302
+ **Why It Works**: Authentic portrayal of divorce, complex characters both right and wrong, escalating conflict.
303
+
304
+ **Key Scenes**:
305
+ - **Opening Montages**: What they love about each other (never spoken aloud)
306
+ - **Argument Scene**: Escalation from civil to devastating
307
+ - **Shoe-Tying**: Small gesture of lingering care
308
+
309
+ **Techniques Used**:
310
+ - Dual perspective (both characters sympathetic)
311
+ - Escalating conflict
312
+ - Specific details of marriage and divorce
313
+ - Humor amid pain
314
+ - Small moments carry weight
315
+
316
+ ---
317
+
318
+ ### Example 4: The Florida Project (2017)
319
+
320
+ **Director**: Sean Baker
321
+
322
+ **Why It Works**: Child's perspective on poverty, beauty in hardship, non-judgmental observation.
323
+
324
+ **Key Scenes**:
325
+ - **Ice Cream**: Small kindness amid struggle
326
+ - **Final Confrontation**: Mother's desperation
327
+ - **Ending**: Childhood imagination as escape
328
+
329
+ **Techniques Used**:
330
+ - Child's POV creates distance and intimacy
331
+ - Vibrant colors contrast with subject matter
332
+ - Non-professional actors add authenticity
333
+ - Observational style
334
+ - Empathy without sentimentality
335
+
336
+ ---
337
+
338
+ ### Example 5: There Will Be Blood (2007)
339
+
340
+ **Director**: Paul Thomas Anderson
341
+
342
+ **Why It Works**: Epic scope with intimate character study, moral complexity, visual storytelling.
343
+
344
+ **Key Scenes**:
345
+ - **Opening Sequence**: Wordless character establishment
346
+ - **Milkshake Speech**: Culmination of rivalry and greed
347
+ - **Final Confrontation**: Moral degradation complete
348
+
349
+ **Techniques Used**:
350
+ - Visual storytelling (minimal dialogue early)
351
+ - Character as force of nature
352
+ - Historical specificity
353
+ - Moral complexity
354
+ - Operatic scope with intimate focus
355
+
356
+ ---
357
+
358
+ ## Integration with Other Features
359
+
360
+ ### Compatible Themes
361
+
362
+ - **Redemption**: Character seeks to atone (The Wrestler)
363
+ - **Identity**: Character discovers or accepts self (Moonlight)
364
+ - **Love**: Relationships tested and transformed (Blue Valentine)
365
+ - **Betrayal**: Trust broken and consequences (The Godfather Part II)
366
+ - **Growth**: Character matures through hardship (Lady Bird)
367
+
368
+ ### Compatible Styles
369
+
370
+ - **Linear**: Traditional dramatic structure (most dramas)
371
+ - **Non-Linear**: Flashbacks reveal character (Manchester by the Sea)
372
+ - **Ensemble**: Multiple character perspectives (Magnolia)
373
+ - **Minimalist**: Stripped-down, focused drama (45 Years)
374
+
375
+ ### Hybrid Combinations
376
+
377
+ - **Courtroom Drama**: Legal framework for moral questions (A Few Good Men)
378
+ - **Family Drama**: Domestic conflicts (August: Osage County)
379
+ - **Historical Drama**: Personal stories in historical context (12 Years a Slave)
380
+ - **Addiction Drama**: Substance abuse and recovery (Requiem for a Dream)
381
+ - **Coming-of-Age Drama**: Youth and maturation (Boyhood)
382
+
383
+ ## Best Practices
384
+
385
+ 1. **Start with character, not plot** - Know who they are before deciding what happens
386
+ 2. **Create specific, not generic** - Details of culture, class, region make drama universal
387
+ 3. **Show, don't tell** - Internal conflict must manifest externally
388
+ 4. **Earn every emotion** - Build to big moments through careful development
389
+ 5. **Use subtext constantly** - People rarely say what they mean
390
+ 6. **Make characters complex** - Everyone is the hero of their own story
391
+ 7. **Balance darkness with light** - Moments of grace make drama more powerful
392
+ 8. **Let scenes breathe** - Drama needs time for emotional beats
393
+ 9. **Escalate emotional stakes** - Each scene should increase pressure
394
+ 10. **Resolve emotionally** - Plot resolution without emotional payoff is empty
395
+
396
+ ## Resources
397
+
398
+ - "The Art of Dramatic Writing" by Lajos Egri
399
+ - "Writing Drama" by Yves Lavandier
400
+ - "The Anatomy of Story" by John Truby
401
+ - "Screenplay" by Syd Field
402
+ - Study: Manchester by the Sea, Moonlight, A Marriage Story, The Florida Project, There Will Be Blood
403
+
404
+ ---
405
+
406
+ **Depth Coverage**: 85%
407
+ **Last Updated**: 2026-01-31
408
+ **Version**: 1.0.0
409
+