@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,498 +1,498 @@
1
- # Realistic Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Tonal
5
- **Complexity**: Medium
6
-
7
- ## Overview
8
-
9
- Realistic narrative prioritizes authenticity, naturalism, and verisimilitude, depicting life as it actually is rather than heightened or stylized versions. This style emphasizes everyday situations, natural dialogue, and believable character behavior grounded in observable reality.
10
-
11
- ## Core Concept
12
-
13
- Realistic screenwriting seeks to mirror actual human experience with minimal artifice or dramatic contrivance. The power lies in finding drama within ordinary life, trusting that authentic human behavior and genuine emotion create compelling narratives without melodrama or manipulation. Success requires keen observation of real life and commitment to truth over convention.
14
-
15
- ## Definition
16
-
17
- A realistic narrative depicts characters, situations, and dialogue that closely resemble actual human experience, avoiding melodrama, coincidence, or theatrical convention in favor of naturalistic authenticity and psychological truth.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Naturalistic Dialogue
22
-
23
- **Description**: Characters must speak as real people do, with hesitations, interruptions, incomplete thoughts, and everyday language.
24
-
25
- **Why It Matters**: Theatrical or polished dialogue breaks realistic illusion and distances audiences from authentic experience.
26
-
27
- **Implementation**:
28
- - Use contractions, slang, and colloquialisms
29
- - Include verbal tics, pauses, and interruptions
30
- - Avoid perfectly articulated speeches
31
- - Let characters talk over each other
32
-
33
- **Examples**:
34
- - ✅ **Good**: "I mean, like, I don't know... it's just... you know?"
35
- - ❌ **Bad**: "I find myself unable to articulate my precise feelings on this matter."
36
-
37
- **Film Reference**: Before Sunrise (1995) - Naturalistic conversation flows like real people talking.
38
-
39
- ---
40
-
41
- ### Requirement 2: Believable Character Behavior
42
-
43
- **Description**: Characters must act according to psychological truth and realistic motivation, not plot convenience.
44
-
45
- **Why It Matters**: Contrived behavior for plot purposes destroys realistic authenticity.
46
-
47
- **Implementation**:
48
- - Ground actions in established character psychology
49
- - Avoid convenient personality shifts
50
- - Show realistic decision-making processes
51
- - Include mistakes and poor choices
52
-
53
- **Examples**:
54
- - ✅ **Good**: Character makes imperfect decision based on limited information and emotional state
55
- - ❌ **Bad**: Character suddenly acts out of character to advance plot
56
-
57
- **Film Reference**: Manchester by the Sea (2016) - Characters behave according to psychological truth, not plot needs.
58
-
59
- ---
60
-
61
- ### Requirement 3: Everyday Situations
62
-
63
- **Description**: Focus on ordinary life situations rather than extraordinary circumstances or heightened drama.
64
-
65
- **Why It Matters**: Realism finds drama in normal life, not manufactured crises.
66
-
67
- **Implementation**:
68
- - Set scenes in familiar locations (homes, workplaces, cafes)
69
- - Focus on daily routines and common experiences
70
- - Avoid contrived coincidences or melodramatic events
71
- - Find conflict in realistic interpersonal dynamics
72
-
73
- **Examples**:
74
- - ✅ **Good**: Family dinner conversation reveals underlying tensions
75
- - ❌ **Bad**: Convenient car accident brings estranged family together
76
-
77
- **Film Reference**: Paterson (2016) - Entire film follows ordinary daily routine of bus driver.
78
-
79
- ---
80
-
81
- ### Requirement 4: Ambiguous Morality
82
-
83
- **Description**: Characters should be morally complex, not clearly good or evil, reflecting real human moral ambiguity.
84
-
85
- **Why It Matters**: Real people are complicated; clear heroes and villains feel artificial.
86
-
87
- **Implementation**:
88
- - Give protagonists flaws and poor choices
89
- - Show antagonists' humanity and motivations
90
- - Avoid moral absolutes
91
- - Present ethical dilemmas without easy answers
92
-
93
- **Examples**:
94
- - ✅ **Good**: Protagonist makes selfish choice that hurts others but is understandable
95
- - ❌ **Bad**: Pure hero fights pure villain in moral black-and-white
96
-
97
- **Film Reference**: The Florida Project (2017) - Characters are flawed but sympathetic, not heroes or villains.
98
-
99
- ---
100
-
101
- ### Requirement 5: Unresolved Endings
102
-
103
- **Description**: Conclusions should reflect life's ambiguity, avoiding neat resolutions or Hollywood endings.
104
-
105
- **Why It Matters**: Real life rarely provides complete closure or perfect resolutions.
106
-
107
- **Implementation**:
108
- - Leave some questions unanswered
109
- - Avoid tying up all loose ends
110
- - Show ongoing struggles rather than complete transformation
111
- - Embrace ambiguity and uncertainty
112
-
113
- **Examples**:
114
- - ✅ **Good**: Character makes progress but future remains uncertain
115
- - ❌ **Bad**: All problems solved, character completely transformed, perfect happy ending
116
-
117
- **Film Reference**: Lady Bird (2017) - Ending shows growth but not complete resolution.
118
-
119
- ---
120
-
121
- ### Requirement 6: Observational Detail
122
-
123
- **Description**: Include specific, authentic details that ground story in observable reality.
124
-
125
- **Why It Matters**: Specific details create verisimilitude and authentic atmosphere.
126
-
127
- **Implementation**:
128
- - Research actual locations, professions, cultures
129
- - Include mundane but authentic details
130
- - Use specific rather than generic descriptions
131
- - Show knowledge of depicted world
132
-
133
- **Examples**:
134
- - ✅ **Good**: Specific details of character's profession, neighborhood, daily routine
135
- - ❌ **Bad**: Generic, vague descriptions that could apply anywhere
136
-
137
- **Film Reference**: Moonlight (2016) - Specific details of Miami neighborhood create authentic world.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Slower, more deliberate pacing reflecting real time
146
- - Allow scenes to unfold naturally without rushing
147
- - Include mundane moments between dramatic beats
148
- - Avoid artificial acceleration for plot purposes
149
-
150
- ### Scene Length
151
-
152
- - Scenes play out in near-real time (3-5 pages)
153
- - Longer conversations without cutting away
154
- - Include setup and aftermath, not just climactic moments
155
- - Vary length based on natural scene rhythms
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish character's ordinary world and relationships (30% of runtime)
160
- - **Act II**: Develop conflicts through realistic complications (40% of runtime)
161
- - **Act III**: Resolve some issues while leaving others open (30% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Simple cuts between scenes
166
- - Minimal use of montages or time compression
167
- - Natural progression from scene to scene
168
- - Avoid flashy or stylized transitions
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Handheld or steady-cam for documentary feel
175
- - Natural lighting whenever possible
176
- - Avoid showy camera movements
177
- - Observational, unobtrusive cinematography
178
-
179
- ### Visual Motifs
180
-
181
- - Authentic locations, not sets
182
- - Natural color palettes
183
- - Everyday objects and environments
184
- - Minimal visual stylization
185
-
186
- ### Action Lines
187
-
188
- - Specific, observed details
189
- - Natural, unforced descriptions
190
- - Focus on character behavior
191
- - Avoid poetic or heightened language
192
-
193
- **Example**:
194
- ```
195
- INT. KITCHEN - MORNING
196
-
197
- Sarah makes coffee. The machine sputters. She checks her phone while waiting, scrolls through messages without responding.
198
- ```
199
-
200
- ## Dialogue Approach
201
-
202
- ### Dialogue Style
203
-
204
- - Conversational, natural speech patterns
205
- - Incomplete sentences and interruptions
206
- - Regional dialects and authentic vocabulary
207
- - Subtext through what's not said
208
-
209
- ### Subtext
210
-
211
- - Characters avoid direct emotional expression
212
- - Meaning emerges from context and behavior
213
- - Uncomfortable silences carry weight
214
- - Real people rarely say exactly what they mean
215
-
216
- ### Formatting
217
-
218
- - Standard formatting with natural rhythms
219
- - Overlapping dialogue when appropriate
220
- - Pauses and beats for realistic timing
221
- - Minimal parentheticals
222
-
223
- **Example**:
224
- ```
225
- JOHN
226
- So, uh... how've you been?
227
-
228
- MARY
229
- Fine. You?
230
-
231
- JOHN
232
- Yeah, good. Work's been--
233
-
234
- MARY
235
- That's good.
236
-
237
- Awkward silence.
238
- ```
239
-
240
- ## Technical Formatting
241
-
242
- ### Page Layout
243
-
244
- - Standard screenplay format
245
- - Natural scene flow
246
- - Minimal special formatting
247
- - Clean, uncluttered pages
248
-
249
- ### Scene Headings
250
-
251
- - Specific, real locations
252
- - Natural progression of settings
253
- - Avoid exotic or unusual locations
254
- - Familiar, everyday places
255
-
256
- ### Special Elements
257
-
258
- - Minimal use of montages
259
- - Avoid flashbacks unless organic
260
- - No flashy formatting tricks
261
- - Keep technical elements invisible
262
-
263
- ## Strengths and Limitations
264
-
265
- ### Strengths
266
-
267
- - Creates authentic emotional connection
268
- - Respects audience intelligence
269
- - Allows nuanced character exploration
270
- - Feels fresh and honest
271
- - Provides social commentary through observation
272
-
273
- ### Limitations
274
-
275
- - May feel slow or undramatic to some audiences
276
- - Limited commercial appeal
277
- - Requires exceptional writing and acting
278
- - Can be mistaken for boring if poorly executed
279
- - Difficult to sustain tension without artificial stakes
280
-
281
- ### Best Use Cases
282
-
283
- - Character-driven dramas
284
- - Social realism and working-class stories
285
- - Coming-of-age narratives
286
- - Relationship dramas
287
- - Slice-of-life stories
288
- - Independent and art-house films
289
-
290
- ## Film Examples
291
-
292
- ### Example 1: Moonlight (2016)
293
-
294
- **Director**: Barry Jenkins
295
-
296
- **Why This Style Works**: Authentic portrayal of Black queer experience in Miami through naturalistic performances and specific cultural details.
297
-
298
- **Key Stylistic Moments**:
299
- - **Three-Act Structure**: Realistic portrayal across three life stages
300
- - **Naturalistic Dialogue**: Characters speak authentically to culture and setting
301
- - **Specific Details**: Miami neighborhood details create verisimilitude
302
-
303
- **Techniques Used**:
304
- - Non-professional and professional actors blend naturally
305
- - Authentic locations and cultural specificity
306
- - Naturalistic dialogue with regional dialect
307
- - Ambiguous ending reflects ongoing journey
308
-
309
- **Structural Analysis**: Three-part structure shows realistic character development across decades without neat resolution.
310
-
311
- ---
312
-
313
- ### Example 2: The Florida Project (2017)
314
-
315
- **Director**: Sean Baker
316
-
317
- **Why This Style Works**: Child's perspective on poverty near Disney World creates authentic, non-judgmental portrait of marginalized lives.
318
-
319
- **Key Stylistic Moments**:
320
- - **Child's POV**: Realistic child behavior and dialogue
321
- - **Motel Life**: Specific details of budget motel existence
322
- - **Ambiguous Morality**: Mother is flawed but sympathetic
323
-
324
- **Techniques Used**:
325
- - Child actors improvise naturally
326
- - Real locations (actual budget motel)
327
- - Observational camera work
328
- - No melodramatic plot contrivances
329
-
330
- **Structural Analysis**: Episodic structure mirrors real childhood experience without artificial dramatic arc.
331
-
332
- ---
333
-
334
- ### Example 3: Lady Bird (2017)
335
-
336
- **Director**: Greta Gerwig
337
-
338
- **Why This Style Works**: Authentic mother-daughter relationship and coming-of-age experience through specific Sacramento details and naturalistic dialogue.
339
-
340
- **Key Stylistic Moments**:
341
- - **Mother-Daughter Fights**: Realistic family conflict
342
- - **High School Experience**: Authentic teenage behavior
343
- - **Ambiguous Ending**: Growth without complete transformation
344
-
345
- **Techniques Used**:
346
- - Naturalistic dialogue with overlapping speech
347
- - Specific cultural and geographic details
348
- - Flawed, complex characters
349
- - Unresolved emotional threads
350
-
351
- **Structural Analysis**: Coming-of-age narrative avoids clichés through commitment to psychological truth.
352
-
353
- ---
354
-
355
- ### Example 4: Manchester by the Sea (2016)
356
-
357
- **Director**: Kenneth Lonergan
358
-
359
- **Why This Style Works**: Realistic portrayal of grief and inability to heal through naturalistic performances and authentic New England setting.
360
-
361
- **Key Stylistic Moments**:
362
- - **Emotional Suppression**: Character can't express grief
363
- - **Awkward Conversations**: Realistic discomfort and avoidance
364
- - **Unresolved Ending**: No healing or closure
365
-
366
- **Techniques Used**:
367
- - Naturalistic dialogue with pauses and interruptions
368
- - Authentic Massachusetts locations and culture
369
- - Characters behave according to psychology, not plot
370
- - Ambiguous, unresolved conclusion
371
-
372
- **Structural Analysis**: Rejects conventional redemption arc in favor of psychological truth.
373
-
374
- ---
375
-
376
- ### Example 5: Before Sunrise (1995)
377
-
378
- **Director**: Richard Linklater
379
-
380
- **Why This Style Works**: Real-time conversation between two strangers creates authentic connection through naturalistic dialogue.
381
-
382
- **Key Stylistic Moments**:
383
- - **Walking and Talking**: Continuous conversation in real time
384
- - **Natural Dialogue**: Realistic speech patterns and topics
385
- - **Ambiguous Ending**: Uncertain future for relationship
386
-
387
- **Techniques Used**:
388
- - Long takes of conversation
389
- - Naturalistic dialogue improvised and refined
390
- - Real Vienna locations
391
- - Real-time narrative structure
392
-
393
- **Structural Analysis**: Minimal plot focuses entirely on authentic human connection through conversation.
394
-
395
- ---
396
-
397
- ## Integration with Other Features
398
-
399
- ### Compatible Genres
400
-
401
- - **Drama**: Natural fit for realistic approach
402
- - **Romance**: Authentic relationships benefit from realism
403
- - **Coming-of-Age**: Realistic portrayal deepens impact
404
- - **Social Commentary**: Realism serves observational critique
405
- - **Character Study**: Realism allows deep character exploration
406
-
407
- ### Compatible Themes
408
-
409
- - **Class**: Realistic approach illuminates social issues
410
- - **Identity**: Authentic exploration of self-discovery
411
- - **Family**: Realistic family dynamics ring true
412
- - **Relationships**: Naturalistic portrayal of human connection
413
- - **Coming-of-Age**: Authentic teenage experience
414
-
415
- ### Style Variations
416
-
417
- - **Social realism**: Working-class focus (The Florida Project)
418
- - **Mumblecore**: Ultra-naturalistic indie style
419
- - **Neorealism**: Italian tradition of authentic working-class stories
420
- - **Kitchen sink realism**: British tradition of domestic realism
421
-
422
- ## Common Pitfalls
423
-
424
- ### Pitfall 1: Boring Authenticity
425
-
426
- **Problem**: Realism becomes excuse for lack of dramatic structure or compelling narrative.
427
-
428
- **Solution**: Find drama within authentic situations. Realistic doesn't mean plotless.
429
-
430
- **Example**: Manchester by the Sea is realistic but maintains compelling dramatic tension.
431
-
432
- ---
433
-
434
- ### Pitfall 2: Improvised Aimlessness
435
-
436
- **Problem**: Naturalistic dialogue becomes rambling and purposeless.
437
-
438
- **Solution**: Even natural dialogue should serve character and story. Edit ruthlessly.
439
-
440
- **Example**: Before Sunrise's dialogue feels natural but every conversation reveals character.
441
-
442
- ---
443
-
444
- ### Pitfall 3: Depressing Nihilism
445
-
446
- **Problem**: Realism becomes excuse for relentlessly bleak, hopeless narratives.
447
-
448
- **Solution**: Find authentic moments of joy, humor, and connection within realistic framework.
449
-
450
- **Example**: The Florida Project finds beauty and joy in difficult circumstances.
451
-
452
- ---
453
-
454
- ### Pitfall 4: Lack of Specificity
455
-
456
- **Problem**: Generic "realistic" details that don't create authentic world.
457
-
458
- **Solution**: Research deeply and include specific cultural, geographic, and social details.
459
-
460
- **Example**: Moonlight's specific Miami neighborhood details create authentic world.
461
-
462
- ---
463
-
464
- ### Pitfall 5: Forced Naturalism
465
-
466
- **Problem**: Trying so hard to be realistic that it becomes affected and artificial.
467
-
468
- **Solution**: Let naturalism emerge organically. Don't force it.
469
-
470
- **Example**: Lady Bird's naturalism feels effortless, not forced.
471
-
472
- ---
473
-
474
- ## Best Practices
475
-
476
- 1. **Research thoroughly** - Know the world you're depicting intimately
477
- 2. **Observe real life** - Draw from actual human behavior and speech
478
- 3. **Embrace ambiguity** - Avoid neat resolutions and moral certainty
479
- 4. **Trust audiences** - Don't over-explain or manipulate
480
- 5. **Find drama in ordinary** - Authentic situations contain compelling conflict
481
- 6. **Use specific details** - Specificity creates verisimilitude
482
- 7. **Avoid melodrama** - Resist urge to heighten or exaggerate
483
- 8. **Commit fully** - Half-hearted realism feels false
484
-
485
- ## Resources
486
-
487
- - "On Film-Making" by Alexander Mackendrick - Realistic character and dialogue
488
- - "Making Movies" by Sidney Lumet - Authentic filmmaking approach
489
- - "Bicycle Thieves" (1948) - Italian neorealism masterpiece
490
- - "Before Sunrise" screenplay by Richard Linklater and Kim Krizan - Naturalistic dialogue
491
- - "Manchester by the Sea" screenplay by Kenneth Lonergan - Realistic character study
492
-
493
- ---
494
-
495
- **Depth Coverage**: 85%
496
- **Last Updated**: 2026-01-31
497
- **Version**: 1.0.0
498
-
1
+ # Realistic Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Tonal
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ Realistic narrative prioritizes authenticity, naturalism, and verisimilitude, depicting life as it actually is rather than heightened or stylized versions. This style emphasizes everyday situations, natural dialogue, and believable character behavior grounded in observable reality.
10
+
11
+ ## Core Concept
12
+
13
+ Realistic screenwriting seeks to mirror actual human experience with minimal artifice or dramatic contrivance. The power lies in finding drama within ordinary life, trusting that authentic human behavior and genuine emotion create compelling narratives without melodrama or manipulation. Success requires keen observation of real life and commitment to truth over convention.
14
+
15
+ ## Definition
16
+
17
+ A realistic narrative depicts characters, situations, and dialogue that closely resemble actual human experience, avoiding melodrama, coincidence, or theatrical convention in favor of naturalistic authenticity and psychological truth.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Naturalistic Dialogue
22
+
23
+ **Description**: Characters must speak as real people do, with hesitations, interruptions, incomplete thoughts, and everyday language.
24
+
25
+ **Why It Matters**: Theatrical or polished dialogue breaks realistic illusion and distances audiences from authentic experience.
26
+
27
+ **Implementation**:
28
+ - Use contractions, slang, and colloquialisms
29
+ - Include verbal tics, pauses, and interruptions
30
+ - Avoid perfectly articulated speeches
31
+ - Let characters talk over each other
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: "I mean, like, I don't know... it's just... you know?"
35
+ - ❌ **Bad**: "I find myself unable to articulate my precise feelings on this matter."
36
+
37
+ **Film Reference**: Before Sunrise (1995) - Naturalistic conversation flows like real people talking.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Believable Character Behavior
42
+
43
+ **Description**: Characters must act according to psychological truth and realistic motivation, not plot convenience.
44
+
45
+ **Why It Matters**: Contrived behavior for plot purposes destroys realistic authenticity.
46
+
47
+ **Implementation**:
48
+ - Ground actions in established character psychology
49
+ - Avoid convenient personality shifts
50
+ - Show realistic decision-making processes
51
+ - Include mistakes and poor choices
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Character makes imperfect decision based on limited information and emotional state
55
+ - ❌ **Bad**: Character suddenly acts out of character to advance plot
56
+
57
+ **Film Reference**: Manchester by the Sea (2016) - Characters behave according to psychological truth, not plot needs.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Everyday Situations
62
+
63
+ **Description**: Focus on ordinary life situations rather than extraordinary circumstances or heightened drama.
64
+
65
+ **Why It Matters**: Realism finds drama in normal life, not manufactured crises.
66
+
67
+ **Implementation**:
68
+ - Set scenes in familiar locations (homes, workplaces, cafes)
69
+ - Focus on daily routines and common experiences
70
+ - Avoid contrived coincidences or melodramatic events
71
+ - Find conflict in realistic interpersonal dynamics
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Family dinner conversation reveals underlying tensions
75
+ - ❌ **Bad**: Convenient car accident brings estranged family together
76
+
77
+ **Film Reference**: Paterson (2016) - Entire film follows ordinary daily routine of bus driver.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Ambiguous Morality
82
+
83
+ **Description**: Characters should be morally complex, not clearly good or evil, reflecting real human moral ambiguity.
84
+
85
+ **Why It Matters**: Real people are complicated; clear heroes and villains feel artificial.
86
+
87
+ **Implementation**:
88
+ - Give protagonists flaws and poor choices
89
+ - Show antagonists' humanity and motivations
90
+ - Avoid moral absolutes
91
+ - Present ethical dilemmas without easy answers
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Protagonist makes selfish choice that hurts others but is understandable
95
+ - ❌ **Bad**: Pure hero fights pure villain in moral black-and-white
96
+
97
+ **Film Reference**: The Florida Project (2017) - Characters are flawed but sympathetic, not heroes or villains.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Unresolved Endings
102
+
103
+ **Description**: Conclusions should reflect life's ambiguity, avoiding neat resolutions or Hollywood endings.
104
+
105
+ **Why It Matters**: Real life rarely provides complete closure or perfect resolutions.
106
+
107
+ **Implementation**:
108
+ - Leave some questions unanswered
109
+ - Avoid tying up all loose ends
110
+ - Show ongoing struggles rather than complete transformation
111
+ - Embrace ambiguity and uncertainty
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Character makes progress but future remains uncertain
115
+ - ❌ **Bad**: All problems solved, character completely transformed, perfect happy ending
116
+
117
+ **Film Reference**: Lady Bird (2017) - Ending shows growth but not complete resolution.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Observational Detail
122
+
123
+ **Description**: Include specific, authentic details that ground story in observable reality.
124
+
125
+ **Why It Matters**: Specific details create verisimilitude and authentic atmosphere.
126
+
127
+ **Implementation**:
128
+ - Research actual locations, professions, cultures
129
+ - Include mundane but authentic details
130
+ - Use specific rather than generic descriptions
131
+ - Show knowledge of depicted world
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Specific details of character's profession, neighborhood, daily routine
135
+ - ❌ **Bad**: Generic, vague descriptions that could apply anywhere
136
+
137
+ **Film Reference**: Moonlight (2016) - Specific details of Miami neighborhood create authentic world.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Slower, more deliberate pacing reflecting real time
146
+ - Allow scenes to unfold naturally without rushing
147
+ - Include mundane moments between dramatic beats
148
+ - Avoid artificial acceleration for plot purposes
149
+
150
+ ### Scene Length
151
+
152
+ - Scenes play out in near-real time (3-5 pages)
153
+ - Longer conversations without cutting away
154
+ - Include setup and aftermath, not just climactic moments
155
+ - Vary length based on natural scene rhythms
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish character's ordinary world and relationships (30% of runtime)
160
+ - **Act II**: Develop conflicts through realistic complications (40% of runtime)
161
+ - **Act III**: Resolve some issues while leaving others open (30% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Simple cuts between scenes
166
+ - Minimal use of montages or time compression
167
+ - Natural progression from scene to scene
168
+ - Avoid flashy or stylized transitions
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Handheld or steady-cam for documentary feel
175
+ - Natural lighting whenever possible
176
+ - Avoid showy camera movements
177
+ - Observational, unobtrusive cinematography
178
+
179
+ ### Visual Motifs
180
+
181
+ - Authentic locations, not sets
182
+ - Natural color palettes
183
+ - Everyday objects and environments
184
+ - Minimal visual stylization
185
+
186
+ ### Action Lines
187
+
188
+ - Specific, observed details
189
+ - Natural, unforced descriptions
190
+ - Focus on character behavior
191
+ - Avoid poetic or heightened language
192
+
193
+ **Example**:
194
+ ```
195
+ INT. KITCHEN - MORNING
196
+
197
+ Sarah makes coffee. The machine sputters. She checks her phone while waiting, scrolls through messages without responding.
198
+ ```
199
+
200
+ ## Dialogue Approach
201
+
202
+ ### Dialogue Style
203
+
204
+ - Conversational, natural speech patterns
205
+ - Incomplete sentences and interruptions
206
+ - Regional dialects and authentic vocabulary
207
+ - Subtext through what's not said
208
+
209
+ ### Subtext
210
+
211
+ - Characters avoid direct emotional expression
212
+ - Meaning emerges from context and behavior
213
+ - Uncomfortable silences carry weight
214
+ - Real people rarely say exactly what they mean
215
+
216
+ ### Formatting
217
+
218
+ - Standard formatting with natural rhythms
219
+ - Overlapping dialogue when appropriate
220
+ - Pauses and beats for realistic timing
221
+ - Minimal parentheticals
222
+
223
+ **Example**:
224
+ ```
225
+ JOHN
226
+ So, uh... how've you been?
227
+
228
+ MARY
229
+ Fine. You?
230
+
231
+ JOHN
232
+ Yeah, good. Work's been--
233
+
234
+ MARY
235
+ That's good.
236
+
237
+ Awkward silence.
238
+ ```
239
+
240
+ ## Technical Formatting
241
+
242
+ ### Page Layout
243
+
244
+ - Standard screenplay format
245
+ - Natural scene flow
246
+ - Minimal special formatting
247
+ - Clean, uncluttered pages
248
+
249
+ ### Scene Headings
250
+
251
+ - Specific, real locations
252
+ - Natural progression of settings
253
+ - Avoid exotic or unusual locations
254
+ - Familiar, everyday places
255
+
256
+ ### Special Elements
257
+
258
+ - Minimal use of montages
259
+ - Avoid flashbacks unless organic
260
+ - No flashy formatting tricks
261
+ - Keep technical elements invisible
262
+
263
+ ## Strengths and Limitations
264
+
265
+ ### Strengths
266
+
267
+ - Creates authentic emotional connection
268
+ - Respects audience intelligence
269
+ - Allows nuanced character exploration
270
+ - Feels fresh and honest
271
+ - Provides social commentary through observation
272
+
273
+ ### Limitations
274
+
275
+ - May feel slow or undramatic to some audiences
276
+ - Limited commercial appeal
277
+ - Requires exceptional writing and acting
278
+ - Can be mistaken for boring if poorly executed
279
+ - Difficult to sustain tension without artificial stakes
280
+
281
+ ### Best Use Cases
282
+
283
+ - Character-driven dramas
284
+ - Social realism and working-class stories
285
+ - Coming-of-age narratives
286
+ - Relationship dramas
287
+ - Slice-of-life stories
288
+ - Independent and art-house films
289
+
290
+ ## Film Examples
291
+
292
+ ### Example 1: Moonlight (2016)
293
+
294
+ **Director**: Barry Jenkins
295
+
296
+ **Why This Style Works**: Authentic portrayal of Black queer experience in Miami through naturalistic performances and specific cultural details.
297
+
298
+ **Key Stylistic Moments**:
299
+ - **Three-Act Structure**: Realistic portrayal across three life stages
300
+ - **Naturalistic Dialogue**: Characters speak authentically to culture and setting
301
+ - **Specific Details**: Miami neighborhood details create verisimilitude
302
+
303
+ **Techniques Used**:
304
+ - Non-professional and professional actors blend naturally
305
+ - Authentic locations and cultural specificity
306
+ - Naturalistic dialogue with regional dialect
307
+ - Ambiguous ending reflects ongoing journey
308
+
309
+ **Structural Analysis**: Three-part structure shows realistic character development across decades without neat resolution.
310
+
311
+ ---
312
+
313
+ ### Example 2: The Florida Project (2017)
314
+
315
+ **Director**: Sean Baker
316
+
317
+ **Why This Style Works**: Child's perspective on poverty near Disney World creates authentic, non-judgmental portrait of marginalized lives.
318
+
319
+ **Key Stylistic Moments**:
320
+ - **Child's POV**: Realistic child behavior and dialogue
321
+ - **Motel Life**: Specific details of budget motel existence
322
+ - **Ambiguous Morality**: Mother is flawed but sympathetic
323
+
324
+ **Techniques Used**:
325
+ - Child actors improvise naturally
326
+ - Real locations (actual budget motel)
327
+ - Observational camera work
328
+ - No melodramatic plot contrivances
329
+
330
+ **Structural Analysis**: Episodic structure mirrors real childhood experience without artificial dramatic arc.
331
+
332
+ ---
333
+
334
+ ### Example 3: Lady Bird (2017)
335
+
336
+ **Director**: Greta Gerwig
337
+
338
+ **Why This Style Works**: Authentic mother-daughter relationship and coming-of-age experience through specific Sacramento details and naturalistic dialogue.
339
+
340
+ **Key Stylistic Moments**:
341
+ - **Mother-Daughter Fights**: Realistic family conflict
342
+ - **High School Experience**: Authentic teenage behavior
343
+ - **Ambiguous Ending**: Growth without complete transformation
344
+
345
+ **Techniques Used**:
346
+ - Naturalistic dialogue with overlapping speech
347
+ - Specific cultural and geographic details
348
+ - Flawed, complex characters
349
+ - Unresolved emotional threads
350
+
351
+ **Structural Analysis**: Coming-of-age narrative avoids clichés through commitment to psychological truth.
352
+
353
+ ---
354
+
355
+ ### Example 4: Manchester by the Sea (2016)
356
+
357
+ **Director**: Kenneth Lonergan
358
+
359
+ **Why This Style Works**: Realistic portrayal of grief and inability to heal through naturalistic performances and authentic New England setting.
360
+
361
+ **Key Stylistic Moments**:
362
+ - **Emotional Suppression**: Character can't express grief
363
+ - **Awkward Conversations**: Realistic discomfort and avoidance
364
+ - **Unresolved Ending**: No healing or closure
365
+
366
+ **Techniques Used**:
367
+ - Naturalistic dialogue with pauses and interruptions
368
+ - Authentic Massachusetts locations and culture
369
+ - Characters behave according to psychology, not plot
370
+ - Ambiguous, unresolved conclusion
371
+
372
+ **Structural Analysis**: Rejects conventional redemption arc in favor of psychological truth.
373
+
374
+ ---
375
+
376
+ ### Example 5: Before Sunrise (1995)
377
+
378
+ **Director**: Richard Linklater
379
+
380
+ **Why This Style Works**: Real-time conversation between two strangers creates authentic connection through naturalistic dialogue.
381
+
382
+ **Key Stylistic Moments**:
383
+ - **Walking and Talking**: Continuous conversation in real time
384
+ - **Natural Dialogue**: Realistic speech patterns and topics
385
+ - **Ambiguous Ending**: Uncertain future for relationship
386
+
387
+ **Techniques Used**:
388
+ - Long takes of conversation
389
+ - Naturalistic dialogue improvised and refined
390
+ - Real Vienna locations
391
+ - Real-time narrative structure
392
+
393
+ **Structural Analysis**: Minimal plot focuses entirely on authentic human connection through conversation.
394
+
395
+ ---
396
+
397
+ ## Integration with Other Features
398
+
399
+ ### Compatible Genres
400
+
401
+ - **Drama**: Natural fit for realistic approach
402
+ - **Romance**: Authentic relationships benefit from realism
403
+ - **Coming-of-Age**: Realistic portrayal deepens impact
404
+ - **Social Commentary**: Realism serves observational critique
405
+ - **Character Study**: Realism allows deep character exploration
406
+
407
+ ### Compatible Themes
408
+
409
+ - **Class**: Realistic approach illuminates social issues
410
+ - **Identity**: Authentic exploration of self-discovery
411
+ - **Family**: Realistic family dynamics ring true
412
+ - **Relationships**: Naturalistic portrayal of human connection
413
+ - **Coming-of-Age**: Authentic teenage experience
414
+
415
+ ### Style Variations
416
+
417
+ - **Social realism**: Working-class focus (The Florida Project)
418
+ - **Mumblecore**: Ultra-naturalistic indie style
419
+ - **Neorealism**: Italian tradition of authentic working-class stories
420
+ - **Kitchen sink realism**: British tradition of domestic realism
421
+
422
+ ## Common Pitfalls
423
+
424
+ ### Pitfall 1: Boring Authenticity
425
+
426
+ **Problem**: Realism becomes excuse for lack of dramatic structure or compelling narrative.
427
+
428
+ **Solution**: Find drama within authentic situations. Realistic doesn't mean plotless.
429
+
430
+ **Example**: Manchester by the Sea is realistic but maintains compelling dramatic tension.
431
+
432
+ ---
433
+
434
+ ### Pitfall 2: Improvised Aimlessness
435
+
436
+ **Problem**: Naturalistic dialogue becomes rambling and purposeless.
437
+
438
+ **Solution**: Even natural dialogue should serve character and story. Edit ruthlessly.
439
+
440
+ **Example**: Before Sunrise's dialogue feels natural but every conversation reveals character.
441
+
442
+ ---
443
+
444
+ ### Pitfall 3: Depressing Nihilism
445
+
446
+ **Problem**: Realism becomes excuse for relentlessly bleak, hopeless narratives.
447
+
448
+ **Solution**: Find authentic moments of joy, humor, and connection within realistic framework.
449
+
450
+ **Example**: The Florida Project finds beauty and joy in difficult circumstances.
451
+
452
+ ---
453
+
454
+ ### Pitfall 4: Lack of Specificity
455
+
456
+ **Problem**: Generic "realistic" details that don't create authentic world.
457
+
458
+ **Solution**: Research deeply and include specific cultural, geographic, and social details.
459
+
460
+ **Example**: Moonlight's specific Miami neighborhood details create authentic world.
461
+
462
+ ---
463
+
464
+ ### Pitfall 5: Forced Naturalism
465
+
466
+ **Problem**: Trying so hard to be realistic that it becomes affected and artificial.
467
+
468
+ **Solution**: Let naturalism emerge organically. Don't force it.
469
+
470
+ **Example**: Lady Bird's naturalism feels effortless, not forced.
471
+
472
+ ---
473
+
474
+ ## Best Practices
475
+
476
+ 1. **Research thoroughly** - Know the world you're depicting intimately
477
+ 2. **Observe real life** - Draw from actual human behavior and speech
478
+ 3. **Embrace ambiguity** - Avoid neat resolutions and moral certainty
479
+ 4. **Trust audiences** - Don't over-explain or manipulate
480
+ 5. **Find drama in ordinary** - Authentic situations contain compelling conflict
481
+ 6. **Use specific details** - Specificity creates verisimilitude
482
+ 7. **Avoid melodrama** - Resist urge to heighten or exaggerate
483
+ 8. **Commit fully** - Half-hearted realism feels false
484
+
485
+ ## Resources
486
+
487
+ - "On Film-Making" by Alexander Mackendrick - Realistic character and dialogue
488
+ - "Making Movies" by Sidney Lumet - Authentic filmmaking approach
489
+ - "Bicycle Thieves" (1948) - Italian neorealism masterpiece
490
+ - "Before Sunrise" screenplay by Richard Linklater and Kim Krizan - Naturalistic dialogue
491
+ - "Manchester by the Sea" screenplay by Kenneth Lonergan - Realistic character study
492
+
493
+ ---
494
+
495
+ **Depth Coverage**: 85%
496
+ **Last Updated**: 2026-01-31
497
+ **Version**: 1.0.0
498
+