@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,508 +1,508 @@
1
- # Surreal Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Tonal/Structural
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Surreal narrative embraces dream logic, abstract imagery, unconventional causality, and reality-bending sequences to explore subconscious themes and psychological states. This style prioritizes emotional and symbolic truth over literal realism.
10
-
11
- ## Core Concept
12
-
13
- Surrealist screenwriting operates on dream logic rather than rational causality, using bizarre juxtapositions, impossible events, and symbolic imagery to access deeper psychological and emotional truths. The power lies in bypassing rational mind to speak directly to the subconscious. Success requires commitment to internal dream logic and trust in symbolic communication.
14
-
15
- ## Definition
16
-
17
- A surreal narrative employs dream logic, impossible events, abstract imagery, and unconventional causality to create meaning through symbolic and psychological truth rather than literal reality.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Dream Logic
22
-
23
- **Description**: Events follow emotional/symbolic logic rather than rational causality.
24
-
25
- **Why It Matters**: Surrealism operates on subconscious rules, not realistic cause-and-effect.
26
-
27
- **Implementation**:
28
- - Events connected by emotion/symbol, not logic
29
- - Impossible occurrences treated as normal
30
- - Transitions follow dream associations
31
- - Internal consistency within dream rules
32
-
33
- **Examples**:
34
- - ✅ **Good**: Character walks through door into completely different location/time
35
- - ❌ **Bad**: Realistic cause-and-effect with logical explanations
36
-
37
- **Film Reference**: Mulholland Drive (2001) - Dream logic governs narrative structure.
38
-
39
- ---
40
-
41
- ### Requirement 2: Reality Distortion
42
-
43
- **Description**: Physical reality bends, breaks, or transforms in impossible ways.
44
-
45
- **Why It Matters**: Surrealism requires breaking realistic constraints to access symbolic truth.
46
-
47
- **Implementation**:
48
- - Objects behave impossibly
49
- - Spaces transform illogically
50
- - Time becomes fluid or circular
51
- - Physics optional
52
-
53
- **Examples**:
54
- - ✅ **Good**: Room grows larger as character walks through it
55
- - ❌ **Bad**: Everything follows realistic physical laws
56
-
57
- **Film Reference**: Being John Malkovich (1999) - Portal into another person's consciousness.
58
-
59
- ---
60
-
61
- ### Requirement 3: Symbolic Imagery
62
-
63
- **Description**: Images carry symbolic weight beyond literal meaning, often bizarre or disturbing.
64
-
65
- **Why It Matters**: Surrealism communicates through symbols and metaphors.
66
-
67
- **Implementation**:
68
- - Use striking, memorable images
69
- - Create symbolic rather than literal meaning
70
- - Embrace disturbing or beautiful imagery
71
- - Layer multiple interpretations
72
-
73
- **Examples**:
74
- - ✅ **Good**: Character vomits flowers representing suppressed creativity
75
- - ❌ **Bad**: All imagery serves only literal plot function
76
-
77
- **Film Reference**: Pan's Labyrinth (2006) - Fantastical creatures as psychological symbols.
78
-
79
- ---
80
-
81
- ### Requirement 4: Ambiguous Reality
82
-
83
- **Description**: Blur lines between reality, dream, hallucination, and fantasy.
84
-
85
- **Why It Matters**: Surrealism questions nature of reality itself.
86
-
87
- **Implementation**:
88
- - Don't clearly mark what's real vs. imagined
89
- - Treat all events with equal reality
90
- - Avoid explanations or rationalizations
91
- - Embrace ambiguity
92
-
93
- **Examples**:
94
- - ✅ **Good**: Impossible events presented without explanation
95
- - ❌ **Bad**: "It was all a dream" revelation that explains everything
96
-
97
- **Film Reference**: Eraserhead (1977) - Reality status perpetually ambiguous.
98
-
99
- ---
100
-
101
- ### Requirement 5: Psychological Manifestation
102
-
103
- **Description**: Internal psychological states manifest as external surreal events.
104
-
105
- **Why It Matters**: Surrealism externalizes the internal, making psychology visible.
106
-
107
- **Implementation**:
108
- - Character's fears/desires become real
109
- - Emotions manifest as physical phenomena
110
- - Subconscious thoughts appear as events
111
- - Psychology drives surreal occurrences
112
-
113
- **Examples**:
114
- - ✅ **Good**: Character's anxiety causes walls to close in literally
115
- - ❌ **Bad**: Psychology only expressed through dialogue
116
-
117
- **Film Reference**: Black Swan (2010) - Psychological breakdown manifests as surreal transformation.
118
-
119
- ---
120
-
121
- ### Requirement 6: Unconventional Narrative
122
-
123
- **Description**: Story structure defies conventional beginning-middle-end progression.
124
-
125
- **Why It Matters**: Surrealism requires breaking narrative conventions.
126
-
127
- **Implementation**:
128
- - Circular or spiral structure
129
- - Multiple contradictory realities
130
- - Fragmented or non-linear progression
131
- - Ambiguous or open endings
132
-
133
- **Examples**:
134
- - ✅ **Good**: Film ends where it began, creating loop
135
- - ❌ **Bad**: Conventional three-act structure with clear resolution
136
-
137
- **Film Reference**: Inland Empire (2006) - Labyrinthine structure defies conventional narrative.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Unpredictable pacing reflecting dream states
146
- - Sudden shifts between slow and frenetic
147
- - Disorienting temporal flow
148
- - Rhythm serves psychological state
149
-
150
- ### Scene Length
151
-
152
- - Highly varied and unpredictable
153
- - Some scenes linger uncomfortably long
154
- - Others flash by in moments
155
- - Length serves emotional/symbolic purpose
156
-
157
- ### Act Structure
158
-
159
- - May abandon traditional acts entirely
160
- - Or use acts that loop/repeat/contradict
161
- - Structure serves surreal logic
162
- - Conventional progression optional
163
-
164
- ### Transitions
165
-
166
- - Impossible transitions (walk through door to different world)
167
- - Match cuts on symbolic elements
168
- - Abrupt, disorienting shifts
169
- - Dream-like dissolves and morphs
170
-
171
- ## Visual Storytelling
172
-
173
- ### Camera Work
174
-
175
- - Unconventional angles and movements
176
- - Distorted perspectives
177
- - Impossible camera positions
178
- - Disorienting cinematography
179
-
180
- ### Visual Motifs
181
-
182
- - Recurring surreal images
183
- - Symbolic objects and creatures
184
- - Disturbing or beautiful imagery
185
- - Visual impossibilities
186
-
187
- ### Action Lines
188
-
189
- - Describe impossible events matter-of-factly
190
- - Embrace bizarre imagery
191
- - Don't explain or rationalize
192
- - Trust surreal vision
193
-
194
- **Example**:
195
- ```
196
- INT. HALLWAY - NIGHT
197
-
198
- The hallway stretches infinitely. Sarah walks but never gets closer to the door at the end.
199
-
200
- The walls begin to breathe.
201
-
202
- A CHILD appears, walking backward. The child is Sarah at age seven.
203
-
204
- CHILD-SARAH
205
- You're late.
206
-
207
- SARAH
208
- For what?
209
-
210
- The child dissolves into butterflies.
211
- ```
212
-
213
- ## Dialogue Approach
214
-
215
- ### Dialogue Style
216
-
217
- - Can be realistic or absurdist
218
- - Non-sequiturs and dream logic
219
- - Symbolic rather than literal
220
- - Cryptic or prophetic
221
-
222
- ### Subtext
223
-
224
- - Dialogue may mean opposite of what's said
225
- - Symbolic communication
226
- - Dream associations
227
- - Multiple interpretations
228
-
229
- ### Formatting
230
-
231
- - Standard formatting for bizarre content
232
- - Let strangeness speak for itself
233
- - Minimal explanation
234
- - Embrace ambiguity
235
-
236
- **Example**:
237
- ```
238
- MAN IN RED SUIT
239
- The fish are drowning.
240
-
241
- SARAH
242
- I don't understand.
243
-
244
- MAN IN RED SUIT
245
- You will. You already have.
246
-
247
- He hands her a key made of ice. It doesn't melt.
248
- ```
249
-
250
- ## Technical Formatting
251
-
252
- ### Page Layout
253
-
254
- - Standard format for surreal content
255
- - Clear scene headings despite impossible locations
256
- - Describe impossibilities clearly
257
- - Trust reader's imagination
258
-
259
- ### Scene Headings
260
-
261
- - Can be impossible locations
262
- - Ambiguous time markers
263
- - Dreamlike place names
264
- - Reality status unclear
265
-
266
- ### Special Elements
267
-
268
- - DREAM SEQUENCE (though may not mark as such)
269
- - HALLUCINATION (or not distinguish)
270
- - FANTASY (or treat as real)
271
- - Minimal technical notation
272
-
273
- ## Strengths and Limitations
274
-
275
- ### Strengths
276
-
277
- - Accesses deep psychological truths
278
- - Creates unforgettable imagery
279
- - Explores themes impossible in realism
280
- - Unique artistic vision
281
- - Bypasses rational defenses
282
-
283
- ### Limitations
284
-
285
- - Can alienate mainstream audiences
286
- - Risk of incoherence
287
- - Difficult to sustain feature length
288
- - May feel pretentious
289
- - Requires sophisticated interpretation
290
-
291
- ### Best Use Cases
292
-
293
- - Psychological horror and thriller
294
- - Exploration of mental states
295
- - Subconscious themes
296
- - Artistic/experimental cinema
297
- - Fantasy with psychological depth
298
- - Trauma and memory narratives
299
-
300
- ## Film Examples
301
-
302
- ### Example 1: Mulholland Drive (2001)
303
-
304
- **Director**: David Lynch
305
-
306
- **Why This Style Works**: Dream logic and reality distortion create psychological mystery that operates on subconscious level.
307
-
308
- **Key Stylistic Moments**:
309
- - **Club Silencio**: Lip-syncing performance reveals reality's artifice
310
- - **Identity Shifts**: Characters become different people
311
- - **Circular Structure**: Ending loops to beginning
312
-
313
- **Techniques Used**:
314
- - Dream logic governs narrative
315
- - Reality status perpetually ambiguous
316
- - Symbolic imagery (blue box, key)
317
- - Multiple contradictory realities
318
-
319
- **Structural Analysis**: First two-thirds appear realistic, final third reveals dream logic governing entire film.
320
-
321
- ---
322
-
323
- ### Example 2: Being John Malkovich (1999)
324
-
325
- **Director**: Spike Jonze
326
-
327
- **Why This Style Works**: Impossible premise (portal into actor's mind) treated as mundane reality creates surreal comedy.
328
-
329
- **Key Stylistic Moments**:
330
- - **7½ Floor**: Physically impossible office space
331
- - **Portal**: Impossible doorway into consciousness
332
- - **Malkovich Malkovich**: Surreal recursive sequence
333
-
334
- **Techniques Used**:
335
- - Impossible events treated casually
336
- - Surreal premise with realistic execution
337
- - Psychological manifestation (desire to be someone else)
338
- - Reality distortion as comedy
339
-
340
- **Structural Analysis**: Surreal premise explored with logical consistency within its own impossible rules.
341
-
342
- ---
343
-
344
- ### Example 3: Pan's Labyrinth (2006)
345
-
346
- **Director**: Guillermo del Toro
347
-
348
- **Why This Style Works**: Fantasy sequences may be real or psychological escape, creating ambiguous surreal narrative.
349
-
350
- **Key Stylistic Moments**:
351
- - **Pale Man**: Disturbing creature as symbolic threat
352
- - **Faun**: Ambiguous guide/tempter
353
- - **Mandrake Root**: Magic or metaphor?
354
-
355
- **Techniques Used**:
356
- - Ambiguous reality status
357
- - Symbolic creatures represent psychological states
358
- - Surreal fantasy intercut with brutal realism
359
- - Open to multiple interpretations
360
-
361
- **Structural Analysis**: Parallel realities (fantasy/reality) may be one reality or psychological manifestation.
362
-
363
- ---
364
-
365
- ### Example 4: Eraserhead (1977)
366
-
367
- **Director**: David Lynch
368
-
369
- **Why This Style Works**: Pure surreal nightmare logic creates visceral psychological horror.
370
-
371
- **Key Stylistic Moments**:
372
- - **Baby**: Grotesque creature representing fatherhood anxiety
373
- - **Radiator Woman**: Symbolic escape fantasy
374
- - **Industrial Soundscape**: Reality as nightmare
375
-
376
- **Techniques Used**:
377
- - Consistent nightmare logic
378
- - Symbolic rather than literal narrative
379
- - Disturbing imagery throughout
380
- - Ambiguous reality status
381
-
382
- **Structural Analysis**: Abandons conventional narrative for sustained surreal nightmare.
383
-
384
- ---
385
-
386
- ### Example 5: Black Swan (2010)
387
-
388
- **Director**: Darren Aronofsky
389
-
390
- **Why This Style Works**: Psychological breakdown manifests as surreal transformation, blurring reality and hallucination.
391
-
392
- **Key Stylistic Moments**:
393
- - **Mirror Attacks**: Doppelganger as psychological manifestation
394
- - **Physical Transformation**: Body horror as metaphor
395
- - **Ambiguous Events**: What's real vs. imagined unclear
396
-
397
- **Techniques Used**:
398
- - Psychological state manifests physically
399
- - Reality increasingly distorted
400
- - Ambiguous hallucinations
401
- - Surreal horror from internal state
402
-
403
- **Structural Analysis**: Realistic beginning gradually becomes surreal as protagonist's psychology fractures.
404
-
405
- ---
406
-
407
- ## Integration with Other Features
408
-
409
- ### Compatible Genres
410
-
411
- - **Horror**: Surrealism creates psychological terror
412
- - **Thriller**: Reality distortion builds suspense
413
- - **Fantasy**: Surreal approach deepens fantasy
414
- - **Drama**: Psychological drama benefits from surreal expression
415
- - **Comedy**: Surreal humor (Being John Malkovich)
416
-
417
- ### Compatible Themes
418
-
419
- - **Identity**: Surrealism explores fractured self
420
- - **Reality**: Questions nature of reality itself
421
- - **Psychology**: Externalizes internal states
422
- - **Dreams**: Natural fit for dream exploration
423
- - **Trauma**: Surreal expression of psychological damage
424
-
425
- ### Style Variations
426
-
427
- - **Surreal horror**: Nightmare logic (Eraserhead)
428
- - **Surreal comedy**: Absurdist humor (Being John Malkovich)
429
- - **Magical realism**: Subtle surrealism in realistic world
430
- - **Psychological surrealism**: Mental states manifest (Black Swan)
431
-
432
- ## Common Pitfalls
433
-
434
- ### Pitfall 1: Incoherent Randomness
435
-
436
- **Problem**: Random weird events without internal logic or meaning.
437
-
438
- **Solution**: Establish dream logic rules and follow them. Surreal doesn't mean arbitrary.
439
-
440
- **Example**: Mulholland Drive has consistent dream logic despite surface incoherence.
441
-
442
- ---
443
-
444
- ### Pitfall 2: Explaining the Surreal
445
-
446
- **Problem**: Rationalizing or explaining surreal elements, destroying their power.
447
-
448
- **Solution**: Trust ambiguity. Don't explain. Let surrealism speak for itself.
449
-
450
- **Example**: Pan's Labyrinth never confirms whether fantasy is real or imagined.
451
-
452
- ---
453
-
454
- ### Pitfall 3: Surreal for Surreal's Sake
455
-
456
- **Problem**: Weird imagery without serving themes or psychology.
457
-
458
- **Solution**: Ensure surreal elements express genuine psychological or thematic truth.
459
-
460
- **Example**: Black Swan's surreal elements directly express protagonist's psychological state.
461
-
462
- ---
463
-
464
- ### Pitfall 4: Losing All Grounding
465
-
466
- **Problem**: So surreal that audiences have no anchor point or emotional connection.
467
-
468
- **Solution**: Provide some realistic elements or emotional truth to ground surrealism.
469
-
470
- **Example**: Being John Malkovich grounds impossible premise in realistic character emotions.
471
-
472
- ---
473
-
474
- ### Pitfall 5: Pretentious Obscurity
475
-
476
- **Problem**: Surrealism becomes excuse for incomprehensible self-indulgence.
477
-
478
- **Solution**: Surrealism should communicate, not obscure. Serve story and theme.
479
-
480
- **Example**: Even Lynch's most surreal films communicate emotional and psychological truths.
481
-
482
- ---
483
-
484
- ## Best Practices
485
-
486
- 1. **Establish internal logic** - Even dream logic needs consistency
487
- 2. **Ground in psychology** - Surreal elements should express internal states
488
- 3. **Trust ambiguity** - Don't explain everything
489
- 4. **Commit fully** - Half-hearted surrealism feels false
490
- 5. **Serve themes** - Surrealism should illuminate meaning
491
- 6. **Create memorable images** - Surreal imagery should be unforgettable
492
- 7. **Balance with reality** - Some grounding helps audiences connect
493
- 8. **Study dreams** - Understand how dreams actually work
494
-
495
- ## Resources
496
-
497
- - "Surrealism and Cinema" by Michael Richardson - Theory of surreal film
498
- - "Lynch on Lynch" by Chris Rodley - David Lynch on surreal filmmaking
499
- - "The Interpretation of Dreams" by Sigmund Freud - Understanding dream logic
500
- - "Mulholland Drive" screenplay by David Lynch - Master class in surrealism
501
- - "Being John Malkovich" screenplay by Charlie Kaufman - Surreal comedy
502
-
503
- ---
504
-
505
- **Depth Coverage**: 85%
506
- **Last Updated**: 2026-01-31
507
- **Version**: 1.0.0
508
-
1
+ # Surreal Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Tonal/Structural
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Surreal narrative embraces dream logic, abstract imagery, unconventional causality, and reality-bending sequences to explore subconscious themes and psychological states. This style prioritizes emotional and symbolic truth over literal realism.
10
+
11
+ ## Core Concept
12
+
13
+ Surrealist screenwriting operates on dream logic rather than rational causality, using bizarre juxtapositions, impossible events, and symbolic imagery to access deeper psychological and emotional truths. The power lies in bypassing rational mind to speak directly to the subconscious. Success requires commitment to internal dream logic and trust in symbolic communication.
14
+
15
+ ## Definition
16
+
17
+ A surreal narrative employs dream logic, impossible events, abstract imagery, and unconventional causality to create meaning through symbolic and psychological truth rather than literal reality.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Dream Logic
22
+
23
+ **Description**: Events follow emotional/symbolic logic rather than rational causality.
24
+
25
+ **Why It Matters**: Surrealism operates on subconscious rules, not realistic cause-and-effect.
26
+
27
+ **Implementation**:
28
+ - Events connected by emotion/symbol, not logic
29
+ - Impossible occurrences treated as normal
30
+ - Transitions follow dream associations
31
+ - Internal consistency within dream rules
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Character walks through door into completely different location/time
35
+ - ❌ **Bad**: Realistic cause-and-effect with logical explanations
36
+
37
+ **Film Reference**: Mulholland Drive (2001) - Dream logic governs narrative structure.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Reality Distortion
42
+
43
+ **Description**: Physical reality bends, breaks, or transforms in impossible ways.
44
+
45
+ **Why It Matters**: Surrealism requires breaking realistic constraints to access symbolic truth.
46
+
47
+ **Implementation**:
48
+ - Objects behave impossibly
49
+ - Spaces transform illogically
50
+ - Time becomes fluid or circular
51
+ - Physics optional
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Room grows larger as character walks through it
55
+ - ❌ **Bad**: Everything follows realistic physical laws
56
+
57
+ **Film Reference**: Being John Malkovich (1999) - Portal into another person's consciousness.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Symbolic Imagery
62
+
63
+ **Description**: Images carry symbolic weight beyond literal meaning, often bizarre or disturbing.
64
+
65
+ **Why It Matters**: Surrealism communicates through symbols and metaphors.
66
+
67
+ **Implementation**:
68
+ - Use striking, memorable images
69
+ - Create symbolic rather than literal meaning
70
+ - Embrace disturbing or beautiful imagery
71
+ - Layer multiple interpretations
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Character vomits flowers representing suppressed creativity
75
+ - ❌ **Bad**: All imagery serves only literal plot function
76
+
77
+ **Film Reference**: Pan's Labyrinth (2006) - Fantastical creatures as psychological symbols.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Ambiguous Reality
82
+
83
+ **Description**: Blur lines between reality, dream, hallucination, and fantasy.
84
+
85
+ **Why It Matters**: Surrealism questions nature of reality itself.
86
+
87
+ **Implementation**:
88
+ - Don't clearly mark what's real vs. imagined
89
+ - Treat all events with equal reality
90
+ - Avoid explanations or rationalizations
91
+ - Embrace ambiguity
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Impossible events presented without explanation
95
+ - ❌ **Bad**: "It was all a dream" revelation that explains everything
96
+
97
+ **Film Reference**: Eraserhead (1977) - Reality status perpetually ambiguous.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Psychological Manifestation
102
+
103
+ **Description**: Internal psychological states manifest as external surreal events.
104
+
105
+ **Why It Matters**: Surrealism externalizes the internal, making psychology visible.
106
+
107
+ **Implementation**:
108
+ - Character's fears/desires become real
109
+ - Emotions manifest as physical phenomena
110
+ - Subconscious thoughts appear as events
111
+ - Psychology drives surreal occurrences
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Character's anxiety causes walls to close in literally
115
+ - ❌ **Bad**: Psychology only expressed through dialogue
116
+
117
+ **Film Reference**: Black Swan (2010) - Psychological breakdown manifests as surreal transformation.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Unconventional Narrative
122
+
123
+ **Description**: Story structure defies conventional beginning-middle-end progression.
124
+
125
+ **Why It Matters**: Surrealism requires breaking narrative conventions.
126
+
127
+ **Implementation**:
128
+ - Circular or spiral structure
129
+ - Multiple contradictory realities
130
+ - Fragmented or non-linear progression
131
+ - Ambiguous or open endings
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Film ends where it began, creating loop
135
+ - ❌ **Bad**: Conventional three-act structure with clear resolution
136
+
137
+ **Film Reference**: Inland Empire (2006) - Labyrinthine structure defies conventional narrative.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Unpredictable pacing reflecting dream states
146
+ - Sudden shifts between slow and frenetic
147
+ - Disorienting temporal flow
148
+ - Rhythm serves psychological state
149
+
150
+ ### Scene Length
151
+
152
+ - Highly varied and unpredictable
153
+ - Some scenes linger uncomfortably long
154
+ - Others flash by in moments
155
+ - Length serves emotional/symbolic purpose
156
+
157
+ ### Act Structure
158
+
159
+ - May abandon traditional acts entirely
160
+ - Or use acts that loop/repeat/contradict
161
+ - Structure serves surreal logic
162
+ - Conventional progression optional
163
+
164
+ ### Transitions
165
+
166
+ - Impossible transitions (walk through door to different world)
167
+ - Match cuts on symbolic elements
168
+ - Abrupt, disorienting shifts
169
+ - Dream-like dissolves and morphs
170
+
171
+ ## Visual Storytelling
172
+
173
+ ### Camera Work
174
+
175
+ - Unconventional angles and movements
176
+ - Distorted perspectives
177
+ - Impossible camera positions
178
+ - Disorienting cinematography
179
+
180
+ ### Visual Motifs
181
+
182
+ - Recurring surreal images
183
+ - Symbolic objects and creatures
184
+ - Disturbing or beautiful imagery
185
+ - Visual impossibilities
186
+
187
+ ### Action Lines
188
+
189
+ - Describe impossible events matter-of-factly
190
+ - Embrace bizarre imagery
191
+ - Don't explain or rationalize
192
+ - Trust surreal vision
193
+
194
+ **Example**:
195
+ ```
196
+ INT. HALLWAY - NIGHT
197
+
198
+ The hallway stretches infinitely. Sarah walks but never gets closer to the door at the end.
199
+
200
+ The walls begin to breathe.
201
+
202
+ A CHILD appears, walking backward. The child is Sarah at age seven.
203
+
204
+ CHILD-SARAH
205
+ You're late.
206
+
207
+ SARAH
208
+ For what?
209
+
210
+ The child dissolves into butterflies.
211
+ ```
212
+
213
+ ## Dialogue Approach
214
+
215
+ ### Dialogue Style
216
+
217
+ - Can be realistic or absurdist
218
+ - Non-sequiturs and dream logic
219
+ - Symbolic rather than literal
220
+ - Cryptic or prophetic
221
+
222
+ ### Subtext
223
+
224
+ - Dialogue may mean opposite of what's said
225
+ - Symbolic communication
226
+ - Dream associations
227
+ - Multiple interpretations
228
+
229
+ ### Formatting
230
+
231
+ - Standard formatting for bizarre content
232
+ - Let strangeness speak for itself
233
+ - Minimal explanation
234
+ - Embrace ambiguity
235
+
236
+ **Example**:
237
+ ```
238
+ MAN IN RED SUIT
239
+ The fish are drowning.
240
+
241
+ SARAH
242
+ I don't understand.
243
+
244
+ MAN IN RED SUIT
245
+ You will. You already have.
246
+
247
+ He hands her a key made of ice. It doesn't melt.
248
+ ```
249
+
250
+ ## Technical Formatting
251
+
252
+ ### Page Layout
253
+
254
+ - Standard format for surreal content
255
+ - Clear scene headings despite impossible locations
256
+ - Describe impossibilities clearly
257
+ - Trust reader's imagination
258
+
259
+ ### Scene Headings
260
+
261
+ - Can be impossible locations
262
+ - Ambiguous time markers
263
+ - Dreamlike place names
264
+ - Reality status unclear
265
+
266
+ ### Special Elements
267
+
268
+ - DREAM SEQUENCE (though may not mark as such)
269
+ - HALLUCINATION (or not distinguish)
270
+ - FANTASY (or treat as real)
271
+ - Minimal technical notation
272
+
273
+ ## Strengths and Limitations
274
+
275
+ ### Strengths
276
+
277
+ - Accesses deep psychological truths
278
+ - Creates unforgettable imagery
279
+ - Explores themes impossible in realism
280
+ - Unique artistic vision
281
+ - Bypasses rational defenses
282
+
283
+ ### Limitations
284
+
285
+ - Can alienate mainstream audiences
286
+ - Risk of incoherence
287
+ - Difficult to sustain feature length
288
+ - May feel pretentious
289
+ - Requires sophisticated interpretation
290
+
291
+ ### Best Use Cases
292
+
293
+ - Psychological horror and thriller
294
+ - Exploration of mental states
295
+ - Subconscious themes
296
+ - Artistic/experimental cinema
297
+ - Fantasy with psychological depth
298
+ - Trauma and memory narratives
299
+
300
+ ## Film Examples
301
+
302
+ ### Example 1: Mulholland Drive (2001)
303
+
304
+ **Director**: David Lynch
305
+
306
+ **Why This Style Works**: Dream logic and reality distortion create psychological mystery that operates on subconscious level.
307
+
308
+ **Key Stylistic Moments**:
309
+ - **Club Silencio**: Lip-syncing performance reveals reality's artifice
310
+ - **Identity Shifts**: Characters become different people
311
+ - **Circular Structure**: Ending loops to beginning
312
+
313
+ **Techniques Used**:
314
+ - Dream logic governs narrative
315
+ - Reality status perpetually ambiguous
316
+ - Symbolic imagery (blue box, key)
317
+ - Multiple contradictory realities
318
+
319
+ **Structural Analysis**: First two-thirds appear realistic, final third reveals dream logic governing entire film.
320
+
321
+ ---
322
+
323
+ ### Example 2: Being John Malkovich (1999)
324
+
325
+ **Director**: Spike Jonze
326
+
327
+ **Why This Style Works**: Impossible premise (portal into actor's mind) treated as mundane reality creates surreal comedy.
328
+
329
+ **Key Stylistic Moments**:
330
+ - **7½ Floor**: Physically impossible office space
331
+ - **Portal**: Impossible doorway into consciousness
332
+ - **Malkovich Malkovich**: Surreal recursive sequence
333
+
334
+ **Techniques Used**:
335
+ - Impossible events treated casually
336
+ - Surreal premise with realistic execution
337
+ - Psychological manifestation (desire to be someone else)
338
+ - Reality distortion as comedy
339
+
340
+ **Structural Analysis**: Surreal premise explored with logical consistency within its own impossible rules.
341
+
342
+ ---
343
+
344
+ ### Example 3: Pan's Labyrinth (2006)
345
+
346
+ **Director**: Guillermo del Toro
347
+
348
+ **Why This Style Works**: Fantasy sequences may be real or psychological escape, creating ambiguous surreal narrative.
349
+
350
+ **Key Stylistic Moments**:
351
+ - **Pale Man**: Disturbing creature as symbolic threat
352
+ - **Faun**: Ambiguous guide/tempter
353
+ - **Mandrake Root**: Magic or metaphor?
354
+
355
+ **Techniques Used**:
356
+ - Ambiguous reality status
357
+ - Symbolic creatures represent psychological states
358
+ - Surreal fantasy intercut with brutal realism
359
+ - Open to multiple interpretations
360
+
361
+ **Structural Analysis**: Parallel realities (fantasy/reality) may be one reality or psychological manifestation.
362
+
363
+ ---
364
+
365
+ ### Example 4: Eraserhead (1977)
366
+
367
+ **Director**: David Lynch
368
+
369
+ **Why This Style Works**: Pure surreal nightmare logic creates visceral psychological horror.
370
+
371
+ **Key Stylistic Moments**:
372
+ - **Baby**: Grotesque creature representing fatherhood anxiety
373
+ - **Radiator Woman**: Symbolic escape fantasy
374
+ - **Industrial Soundscape**: Reality as nightmare
375
+
376
+ **Techniques Used**:
377
+ - Consistent nightmare logic
378
+ - Symbolic rather than literal narrative
379
+ - Disturbing imagery throughout
380
+ - Ambiguous reality status
381
+
382
+ **Structural Analysis**: Abandons conventional narrative for sustained surreal nightmare.
383
+
384
+ ---
385
+
386
+ ### Example 5: Black Swan (2010)
387
+
388
+ **Director**: Darren Aronofsky
389
+
390
+ **Why This Style Works**: Psychological breakdown manifests as surreal transformation, blurring reality and hallucination.
391
+
392
+ **Key Stylistic Moments**:
393
+ - **Mirror Attacks**: Doppelganger as psychological manifestation
394
+ - **Physical Transformation**: Body horror as metaphor
395
+ - **Ambiguous Events**: What's real vs. imagined unclear
396
+
397
+ **Techniques Used**:
398
+ - Psychological state manifests physically
399
+ - Reality increasingly distorted
400
+ - Ambiguous hallucinations
401
+ - Surreal horror from internal state
402
+
403
+ **Structural Analysis**: Realistic beginning gradually becomes surreal as protagonist's psychology fractures.
404
+
405
+ ---
406
+
407
+ ## Integration with Other Features
408
+
409
+ ### Compatible Genres
410
+
411
+ - **Horror**: Surrealism creates psychological terror
412
+ - **Thriller**: Reality distortion builds suspense
413
+ - **Fantasy**: Surreal approach deepens fantasy
414
+ - **Drama**: Psychological drama benefits from surreal expression
415
+ - **Comedy**: Surreal humor (Being John Malkovich)
416
+
417
+ ### Compatible Themes
418
+
419
+ - **Identity**: Surrealism explores fractured self
420
+ - **Reality**: Questions nature of reality itself
421
+ - **Psychology**: Externalizes internal states
422
+ - **Dreams**: Natural fit for dream exploration
423
+ - **Trauma**: Surreal expression of psychological damage
424
+
425
+ ### Style Variations
426
+
427
+ - **Surreal horror**: Nightmare logic (Eraserhead)
428
+ - **Surreal comedy**: Absurdist humor (Being John Malkovich)
429
+ - **Magical realism**: Subtle surrealism in realistic world
430
+ - **Psychological surrealism**: Mental states manifest (Black Swan)
431
+
432
+ ## Common Pitfalls
433
+
434
+ ### Pitfall 1: Incoherent Randomness
435
+
436
+ **Problem**: Random weird events without internal logic or meaning.
437
+
438
+ **Solution**: Establish dream logic rules and follow them. Surreal doesn't mean arbitrary.
439
+
440
+ **Example**: Mulholland Drive has consistent dream logic despite surface incoherence.
441
+
442
+ ---
443
+
444
+ ### Pitfall 2: Explaining the Surreal
445
+
446
+ **Problem**: Rationalizing or explaining surreal elements, destroying their power.
447
+
448
+ **Solution**: Trust ambiguity. Don't explain. Let surrealism speak for itself.
449
+
450
+ **Example**: Pan's Labyrinth never confirms whether fantasy is real or imagined.
451
+
452
+ ---
453
+
454
+ ### Pitfall 3: Surreal for Surreal's Sake
455
+
456
+ **Problem**: Weird imagery without serving themes or psychology.
457
+
458
+ **Solution**: Ensure surreal elements express genuine psychological or thematic truth.
459
+
460
+ **Example**: Black Swan's surreal elements directly express protagonist's psychological state.
461
+
462
+ ---
463
+
464
+ ### Pitfall 4: Losing All Grounding
465
+
466
+ **Problem**: So surreal that audiences have no anchor point or emotional connection.
467
+
468
+ **Solution**: Provide some realistic elements or emotional truth to ground surrealism.
469
+
470
+ **Example**: Being John Malkovich grounds impossible premise in realistic character emotions.
471
+
472
+ ---
473
+
474
+ ### Pitfall 5: Pretentious Obscurity
475
+
476
+ **Problem**: Surrealism becomes excuse for incomprehensible self-indulgence.
477
+
478
+ **Solution**: Surrealism should communicate, not obscure. Serve story and theme.
479
+
480
+ **Example**: Even Lynch's most surreal films communicate emotional and psychological truths.
481
+
482
+ ---
483
+
484
+ ## Best Practices
485
+
486
+ 1. **Establish internal logic** - Even dream logic needs consistency
487
+ 2. **Ground in psychology** - Surreal elements should express internal states
488
+ 3. **Trust ambiguity** - Don't explain everything
489
+ 4. **Commit fully** - Half-hearted surrealism feels false
490
+ 5. **Serve themes** - Surrealism should illuminate meaning
491
+ 6. **Create memorable images** - Surreal imagery should be unforgettable
492
+ 7. **Balance with reality** - Some grounding helps audiences connect
493
+ 8. **Study dreams** - Understand how dreams actually work
494
+
495
+ ## Resources
496
+
497
+ - "Surrealism and Cinema" by Michael Richardson - Theory of surreal film
498
+ - "Lynch on Lynch" by Chris Rodley - David Lynch on surreal filmmaking
499
+ - "The Interpretation of Dreams" by Sigmund Freud - Understanding dream logic
500
+ - "Mulholland Drive" screenplay by David Lynch - Master class in surrealism
501
+ - "Being John Malkovich" screenplay by Charlie Kaufman - Surreal comedy
502
+
503
+ ---
504
+
505
+ **Depth Coverage**: 85%
506
+ **Last Updated**: 2026-01-31
507
+ **Version**: 1.0.0
508
+