@mytechtoday/augment-extensions 0.7.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (483) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +109 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +11 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +120 -0
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  476. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  477. package/cli/dist/utils/extractCommandHelp.js +250 -0
  478. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  479. package/cli/dist/utils/install-rules.js +55 -55
  480. package/cli/dist/utils/mcp-integration.js +44 -44
  481. package/cli/dist/utils/rule-install-hooks.js +8 -8
  482. package/modules.md +667 -630
  483. package/package.json +85 -85
@@ -1,499 +1,499 @@
1
- # Poetic Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Tonal
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Poetic narrative emphasizes lyrical language, visual metaphor, symbolic imagery, and rhythmic structure to create emotionally resonant, aesthetically beautiful storytelling. This style prioritizes mood, atmosphere, and sensory experience over conventional plot mechanics.
10
-
11
- ## Core Concept
12
-
13
- Poetic screenwriting treats film as visual poetry, using imagery, symbolism, and rhythm to evoke emotion and meaning beyond literal narrative. The power lies in creating transcendent moments where form and content merge, where images and sounds create meaning that dialogue cannot express. Success requires visual imagination, literary sensibility, and trust in cinema's capacity for non-verbal communication.
14
-
15
- ## Definition
16
-
17
- A poetic narrative uses lyrical language, visual metaphor, symbolic imagery, and rhythmic pacing to create meaning through aesthetic beauty and emotional resonance rather than conventional dramatic structure.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Lyrical Action Lines
22
-
23
- **Description**: Action descriptions should be written with poetic language, rhythm, and imagery.
24
-
25
- **Why It Matters**: Poetic style must extend to the screenplay's prose, not just the finished film.
26
-
27
- **Implementation**:
28
- - Use metaphor and simile in descriptions
29
- - Create rhythm through sentence structure
30
- - Employ sensory details and imagery
31
- - Write with literary beauty
32
-
33
- **Examples**:
34
- - ✅ **Good**: "Rain falls like tears from a grieving sky. She walks through it, becoming one with the sorrow."
35
- - ❌ **Bad**: "It's raining. She walks down the street."
36
-
37
- **Film Reference**: The Tree of Life (2011) - Screenplay uses poetic language throughout.
38
-
39
- ---
40
-
41
- ### Requirement 2: Visual Metaphor
42
-
43
- **Description**: Use images and visual sequences to convey meaning metaphorically rather than literally.
44
-
45
- **Why It Matters**: Poetic cinema communicates through symbol and metaphor, not just plot.
46
-
47
- **Implementation**:
48
- - Create visual symbols that represent themes
49
- - Use nature imagery metaphorically
50
- - Juxtapose images for meaning
51
- - Trust visual storytelling over exposition
52
-
53
- **Examples**:
54
- - ✅ **Good**: Dying tree represents character's fading hope
55
- - ❌ **Bad**: Character explains their feelings through dialogue
56
-
57
- **Film Reference**: The Fountain (2006) - Tree of life as central visual metaphor.
58
-
59
- ---
60
-
61
- ### Requirement 3: Rhythmic Structure
62
-
63
- **Description**: Create rhythm through scene length, pacing, and repetition of visual motifs.
64
-
65
- **Why It Matters**: Poetry depends on rhythm; poetic film should have musical structure.
66
-
67
- **Implementation**:
68
- - Vary scene length for rhythmic effect
69
- - Repeat visual motifs like refrains
70
- - Create patterns and variations
71
- - Use montage for rhythmic sequences
72
-
73
- **Examples**:
74
- - ✅ **Good**: Series of dawn scenes showing passage of time with variations
75
- - ❌ **Bad**: Random scene lengths with no rhythmic pattern
76
-
77
- **Film Reference**: Koyaanisqatsi (1982) - Pure visual rhythm without dialogue.
78
-
79
- ---
80
-
81
- ### Requirement 4: Symbolic Imagery
82
-
83
- **Description**: Objects, colors, and images should carry symbolic weight beyond literal meaning.
84
-
85
- **Why It Matters**: Poetic narrative operates on symbolic level, creating layers of meaning.
86
-
87
- **Implementation**:
88
- - Assign symbolic meaning to recurring objects
89
- - Use color symbolically
90
- - Create visual leitmotifs
91
- - Layer multiple meanings in single image
92
-
93
- **Examples**:
94
- - ✅ **Good**: Red balloon represents lost innocence, appearing throughout film
95
- - ❌ **Bad**: Objects used only for literal plot purposes
96
-
97
- **Film Reference**: Hero (2002) - Colors represent different emotional/philosophical states.
98
-
99
- ---
100
-
101
- ### Requirement 5: Minimal Dialogue
102
-
103
- **Description**: Reduce dialogue to essential moments, letting images and sounds carry narrative.
104
-
105
- **Why It Matters**: Poetic cinema prioritizes visual and aural poetry over verbal.
106
-
107
- **Implementation**:
108
- - Use dialogue sparingly and purposefully
109
- - Make dialogue itself poetic when used
110
- - Rely on visual storytelling
111
- - Embrace silence and ambient sound
112
-
113
- **Examples**:
114
- - ✅ **Good**: Character's emotional state shown through imagery, not explained
115
- - ❌ **Bad**: Characters explain themes and emotions through dialogue
116
-
117
- **Film Reference**: The Revenant (2015) - Minimal dialogue, maximum visual poetry.
118
-
119
- ---
120
-
121
- ### Requirement 6: Transcendent Moments
122
-
123
- **Description**: Include sequences that transcend literal narrative to create pure aesthetic/emotional experience.
124
-
125
- **Why It Matters**: Poetic cinema aims for moments of beauty and transcendence.
126
-
127
- **Implementation**:
128
- - Create sequences focused on beauty over plot
129
- - Allow time for contemplation
130
- - Use music and imagery for emotional impact
131
- - Trust audiences to experience rather than understand
132
-
133
- **Examples**:
134
- - ✅ **Good**: Extended sequence of natural beauty that evokes emotion
135
- - ❌ **Bad**: Every scene serves only plot function
136
-
137
- **Film Reference**: Baraka (1992) - Entire film is transcendent visual poetry.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Slow, contemplative pacing allowing absorption
146
- - Rhythmic variation like musical composition
147
- - Extended sequences for aesthetic experience
148
- - Breathing room between dramatic moments
149
-
150
- ### Scene Length
151
-
152
- - Highly varied for rhythmic effect
153
- - Some very short (single image)
154
- - Some extended (5-10 minutes)
155
- - Length serves aesthetic purpose
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish visual language and symbolic vocabulary (30% of runtime)
160
- - **Act II**: Develop themes through visual variations (40% of runtime)
161
- - **Act III**: Bring visual/thematic elements to resolution (30% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Dissolves and fades for dreamlike quality
166
- - Match cuts on visual metaphors
167
- - Rhythmic cutting for montages
168
- - Poetic juxtapositions
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Beautiful, composed cinematography
175
- - Slow, graceful camera movements
176
- - Emphasis on natural beauty
177
- - Painterly compositions
178
-
179
- ### Visual Motifs
180
-
181
- - Recurring symbols and images
182
- - Nature imagery (water, fire, earth, air)
183
- - Light and shadow symbolism
184
- - Color as emotional/thematic indicator
185
-
186
- ### Action Lines
187
-
188
- - Lyrical, poetic prose
189
- - Metaphorical descriptions
190
- - Sensory details
191
- - Literary beauty
192
-
193
- **Example**:
194
- ```
195
- EXT. FIELD - GOLDEN HOUR
196
-
197
- Wheat sways like an ocean of gold. She moves through it, a ship on a sea of grain. The setting sun paints her in amber light.
198
-
199
- She stops. Closes her eyes. Becomes still as the earth itself.
200
- ```
201
-
202
- ## Dialogue Approach
203
-
204
- ### Dialogue Style
205
-
206
- - Sparse and purposeful
207
- - Poetic when used
208
- - Metaphorical rather than literal
209
- - Musical quality to speech
210
-
211
- ### Subtext
212
-
213
- - Everything important is visual/symbolic
214
- - Dialogue hints rather than states
215
- - Silence carries meaning
216
- - Subtext is primary text
217
-
218
- ### Formatting
219
-
220
- - Minimal dialogue blocks
221
- - Poetic line breaks when appropriate
222
- - Long silences between lines
223
- - Dialogue as rare punctuation
224
-
225
- **Example**:
226
- ```
227
- She looks at the horizon.
228
-
229
- WOMAN
230
- The light is dying.
231
-
232
- MAN
233
- It always does.
234
-
235
- WOMAN
236
- And always returns.
237
-
238
- Silence. They watch the sunset together.
239
- ```
240
-
241
- ## Technical Formatting
242
-
243
- ### Page Layout
244
-
245
- - Abundant white space
246
- - Poetic action line formatting
247
- - Minimal dialogue
248
- - Visual beauty on page
249
-
250
- ### Scene Headings
251
-
252
- - Evocative locations
253
- - Time of day for light quality
254
- - Poetic place names
255
- - Emphasis on natural settings
256
-
257
- ### Special Elements
258
-
259
- - MONTAGE for visual poetry sequences
260
- - INTERCUT for symbolic parallels
261
- - Minimal technical notation
262
- - Let poetry speak
263
-
264
- ## Strengths and Limitations
265
-
266
- ### Strengths
267
-
268
- - Creates profound emotional impact
269
- - Aesthetically beautiful and memorable
270
- - Operates on multiple levels of meaning
271
- - Transcends language barriers
272
- - Unique artistic vision
273
-
274
- ### Limitations
275
-
276
- - Limited commercial appeal
277
- - Can feel pretentious or inaccessible
278
- - Requires patient, art-house audience
279
- - Difficult to sustain feature length
280
- - May sacrifice narrative clarity
281
-
282
- ### Best Use Cases
283
-
284
- - Art-house and festival films
285
- - Spiritual or philosophical themes
286
- - Nature and environmental stories
287
- - Meditations on life, death, time
288
- - Experimental and avant-garde cinema
289
- - Visual tone poems
290
-
291
- ## Film Examples
292
-
293
- ### Example 1: The Tree of Life (2011)
294
-
295
- **Director**: Terrence Malick
296
-
297
- **Why This Style Works**: Poetic meditation on existence, family, and cosmos through lyrical imagery and minimal dialogue.
298
-
299
- **Key Stylistic Moments**:
300
- - **Creation Sequence**: Visual poetry depicting universe's birth
301
- - **Childhood Memories**: Impressionistic fragments rather than linear narrative
302
- - **Whispered Voiceover**: Poetic questions to God
303
-
304
- **Techniques Used**:
305
- - Lyrical voiceover as poetry
306
- - Natural light cinematography
307
- - Symbolic imagery (tree, water, light)
308
- - Non-linear, associative structure
309
-
310
- **Structural Analysis**: Abandons conventional narrative for poetic meditation on life's meaning.
311
-
312
- ---
313
-
314
- ### Example 2: Hero (2002)
315
-
316
- **Director**: Zhang Yimou
317
-
318
- **Why This Style Works**: Uses color as poetic language, with each sequence in different color representing different emotional/philosophical truth.
319
-
320
- **Key Stylistic Moments**:
321
- - **Red Sequence**: Passion and violence
322
- - **Blue Sequence**: Sadness and truth
323
- - **White Sequence**: Purity and revelation
324
-
325
- **Techniques Used**:
326
- - Color as symbolic language
327
- - Choreographed action as dance/poetry
328
- - Visual metaphor over literal truth
329
- - Painterly compositions
330
-
331
- **Structural Analysis**: Multiple retellings in different colors create poetic exploration of truth and perspective.
332
-
333
- ---
334
-
335
- ### Example 3: The Fountain (2006)
336
-
337
- **Director**: Darren Aronofsky
338
-
339
- **Why This Style Works**: Three timelines connected through visual poetry and symbolic imagery exploring love, death, and immortality.
340
-
341
- **Key Stylistic Moments**:
342
- - **Tree of Life**: Central visual metaphor across all timelines
343
- - **Space Sequences**: Pure visual poetry
344
- - **Parallel Imagery**: Same symbols across different eras
345
-
346
- **Techniques Used**:
347
- - Recurring visual motifs
348
- - Symbolic rather than literal storytelling
349
- - Minimal dialogue in key sequences
350
- - Transcendent imagery
351
-
352
- **Structural Analysis**: Three stories unified through poetic visual language rather than plot logic.
353
-
354
- ---
355
-
356
- ### Example 4: Baraka (1992)
357
-
358
- **Director**: Ron Fricke
359
-
360
- **Why This Style Works**: Dialogue-free visual poem about humanity and nature, pure cinema as poetry.
361
-
362
- **Key Stylistic Moments**:
363
- - **Time-lapse sequences**: Nature's rhythms as poetry
364
- - **Cultural rituals**: Human diversity as visual symphony
365
- - **Environmental destruction**: Poetic warning
366
-
367
- **Techniques Used**:
368
- - No dialogue or narration
369
- - Musical structure through editing
370
- - Symbolic juxtapositions
371
- - Transcendent cinematography
372
-
373
- **Structural Analysis**: Abandons narrative entirely for pure visual and musical poetry.
374
-
375
- ---
376
-
377
- ### Example 5: Days of Heaven (1978)
378
-
379
- **Director**: Terrence Malick
380
-
381
- **Why This Style Works**: Simple story elevated through poetic cinematography, sparse dialogue, and lyrical voiceover.
382
-
383
- **Key Stylistic Moments**:
384
- - **Golden Hour Photography**: Every frame painterly
385
- - **Locust Plague**: Biblical imagery as poetry
386
- - **Child's Voiceover**: Poetic narration
387
-
388
- **Techniques Used**:
389
- - Natural light cinematography
390
- - Minimal dialogue
391
- - Poetic voiceover
392
- - Visual metaphor
393
-
394
- **Structural Analysis**: Simple love triangle becomes poetic meditation on paradise lost.
395
-
396
- ---
397
-
398
- ## Integration with Other Features
399
-
400
- ### Compatible Genres
401
-
402
- - **Drama**: Poetic approach deepens emotional impact
403
- - **Fantasy**: Mythic stories suit poetic treatment
404
- - **Romance**: Love stories benefit from poetic beauty
405
- - **Spiritual**: Natural fit for transcendent themes
406
- - **Documentary**: Poetic docs create emotional truth
407
-
408
- ### Compatible Themes
409
-
410
- - **Nature**: Poetic style celebrates natural beauty
411
- - **Spirituality**: Transcendent themes suit poetic approach
412
- - **Love**: Romance elevated through poetry
413
- - **Death**: Poetic treatment finds beauty in mortality
414
- - **Time**: Poetic structure explores temporal themes
415
-
416
- ### Style Variations
417
-
418
- - **Lyrical realism**: Poetic approach to realistic stories (Days of Heaven)
419
- - **Pure visual poetry**: No dialogue (Baraka, Koyaanisqatsi)
420
- - **Symbolic narrative**: Story told through symbols (The Fountain)
421
- - **Impressionistic**: Fragmented, memory-like (The Tree of Life)
422
-
423
- ## Common Pitfalls
424
-
425
- ### Pitfall 1: Pretentious Emptiness
426
-
427
- **Problem**: Beautiful images without substance or meaning beneath surface.
428
-
429
- **Solution**: Ensure poetic approach serves genuine themes and emotions, not just aesthetics.
430
-
431
- **Example**: The Tree of Life's beauty serves profound philosophical questions.
432
-
433
- ---
434
-
435
- ### Pitfall 2: Incomprehensible Obscurity
436
-
437
- **Problem**: So abstract that audiences can't find any meaning or connection.
438
-
439
- **Solution**: Ground poetry in recognizable human emotion. Provide some narrative anchor.
440
-
441
- **Example**: Hero uses poetic color symbolism but maintains comprehensible story.
442
-
443
- ---
444
-
445
- ### Pitfall 3: Overwritten Prose
446
-
447
- **Problem**: Trying too hard to be poetic in action lines, becoming purple prose.
448
-
449
- **Solution**: Let simplicity and precision create poetry. Avoid flowery excess.
450
-
451
- **Example**: Malick's screenplays use simple, precise language that becomes poetic through selection.
452
-
453
- ---
454
-
455
- ### Pitfall 4: Boring Slowness
456
-
457
- **Problem**: Confusing slow pacing with poetic depth, creating tedium.
458
-
459
- **Solution**: Slow pacing must serve aesthetic purpose. Every moment should resonate.
460
-
461
- **Example**: Baraka's slow pacing creates contemplative space, not boredom.
462
-
463
- ---
464
-
465
- ### Pitfall 5: Sacrificing All Narrative
466
-
467
- **Problem**: Abandoning story entirely in pursuit of pure aesthetics.
468
-
469
- **Solution**: Even poetic films benefit from some narrative structure. Find balance.
470
-
471
- **Example**: Days of Heaven maintains simple story while achieving poetic beauty.
472
-
473
- ---
474
-
475
- ## Best Practices
476
-
477
- 1. **Ground poetry in emotion** - Beautiful images should evoke genuine feeling
478
- 2. **Use symbols consistently** - Establish visual vocabulary and maintain it
479
- 3. **Trust visual storytelling** - Let images speak louder than words
480
- 4. **Create rhythm** - Structure film like musical composition
481
- 5. **Embrace simplicity** - Poetic doesn't mean complicated
482
- 6. **Serve themes** - Poetry should illuminate meaning, not obscure it
483
- 7. **Study visual arts** - Learn from painting, photography, poetry
484
- 8. **Be patient** - Allow moments to breathe and resonate
485
-
486
- ## Resources
487
-
488
- - "Sculpting in Time" by Andrei Tarkovsky - Poetic cinema philosophy
489
- - "The Poetics of Cinema" by Raúl Ruiz - Theory of cinematic poetry
490
- - "The Tree of Life" screenplay by Terrence Malick - Poetic screenwriting
491
- - "In the Blink of an Eye" by Walter Murch - Rhythm and editing
492
- - Poetry collections - Study literary poetry to inform visual poetry
493
-
494
- ---
495
-
496
- **Depth Coverage**: 85%
497
- **Last Updated**: 2026-01-31
498
- **Version**: 1.0.0
499
-
1
+ # Poetic Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Tonal
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Poetic narrative emphasizes lyrical language, visual metaphor, symbolic imagery, and rhythmic structure to create emotionally resonant, aesthetically beautiful storytelling. This style prioritizes mood, atmosphere, and sensory experience over conventional plot mechanics.
10
+
11
+ ## Core Concept
12
+
13
+ Poetic screenwriting treats film as visual poetry, using imagery, symbolism, and rhythm to evoke emotion and meaning beyond literal narrative. The power lies in creating transcendent moments where form and content merge, where images and sounds create meaning that dialogue cannot express. Success requires visual imagination, literary sensibility, and trust in cinema's capacity for non-verbal communication.
14
+
15
+ ## Definition
16
+
17
+ A poetic narrative uses lyrical language, visual metaphor, symbolic imagery, and rhythmic pacing to create meaning through aesthetic beauty and emotional resonance rather than conventional dramatic structure.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Lyrical Action Lines
22
+
23
+ **Description**: Action descriptions should be written with poetic language, rhythm, and imagery.
24
+
25
+ **Why It Matters**: Poetic style must extend to the screenplay's prose, not just the finished film.
26
+
27
+ **Implementation**:
28
+ - Use metaphor and simile in descriptions
29
+ - Create rhythm through sentence structure
30
+ - Employ sensory details and imagery
31
+ - Write with literary beauty
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: "Rain falls like tears from a grieving sky. She walks through it, becoming one with the sorrow."
35
+ - ❌ **Bad**: "It's raining. She walks down the street."
36
+
37
+ **Film Reference**: The Tree of Life (2011) - Screenplay uses poetic language throughout.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Visual Metaphor
42
+
43
+ **Description**: Use images and visual sequences to convey meaning metaphorically rather than literally.
44
+
45
+ **Why It Matters**: Poetic cinema communicates through symbol and metaphor, not just plot.
46
+
47
+ **Implementation**:
48
+ - Create visual symbols that represent themes
49
+ - Use nature imagery metaphorically
50
+ - Juxtapose images for meaning
51
+ - Trust visual storytelling over exposition
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Dying tree represents character's fading hope
55
+ - ❌ **Bad**: Character explains their feelings through dialogue
56
+
57
+ **Film Reference**: The Fountain (2006) - Tree of life as central visual metaphor.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Rhythmic Structure
62
+
63
+ **Description**: Create rhythm through scene length, pacing, and repetition of visual motifs.
64
+
65
+ **Why It Matters**: Poetry depends on rhythm; poetic film should have musical structure.
66
+
67
+ **Implementation**:
68
+ - Vary scene length for rhythmic effect
69
+ - Repeat visual motifs like refrains
70
+ - Create patterns and variations
71
+ - Use montage for rhythmic sequences
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Series of dawn scenes showing passage of time with variations
75
+ - ❌ **Bad**: Random scene lengths with no rhythmic pattern
76
+
77
+ **Film Reference**: Koyaanisqatsi (1982) - Pure visual rhythm without dialogue.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Symbolic Imagery
82
+
83
+ **Description**: Objects, colors, and images should carry symbolic weight beyond literal meaning.
84
+
85
+ **Why It Matters**: Poetic narrative operates on symbolic level, creating layers of meaning.
86
+
87
+ **Implementation**:
88
+ - Assign symbolic meaning to recurring objects
89
+ - Use color symbolically
90
+ - Create visual leitmotifs
91
+ - Layer multiple meanings in single image
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Red balloon represents lost innocence, appearing throughout film
95
+ - ❌ **Bad**: Objects used only for literal plot purposes
96
+
97
+ **Film Reference**: Hero (2002) - Colors represent different emotional/philosophical states.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Minimal Dialogue
102
+
103
+ **Description**: Reduce dialogue to essential moments, letting images and sounds carry narrative.
104
+
105
+ **Why It Matters**: Poetic cinema prioritizes visual and aural poetry over verbal.
106
+
107
+ **Implementation**:
108
+ - Use dialogue sparingly and purposefully
109
+ - Make dialogue itself poetic when used
110
+ - Rely on visual storytelling
111
+ - Embrace silence and ambient sound
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Character's emotional state shown through imagery, not explained
115
+ - ❌ **Bad**: Characters explain themes and emotions through dialogue
116
+
117
+ **Film Reference**: The Revenant (2015) - Minimal dialogue, maximum visual poetry.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Transcendent Moments
122
+
123
+ **Description**: Include sequences that transcend literal narrative to create pure aesthetic/emotional experience.
124
+
125
+ **Why It Matters**: Poetic cinema aims for moments of beauty and transcendence.
126
+
127
+ **Implementation**:
128
+ - Create sequences focused on beauty over plot
129
+ - Allow time for contemplation
130
+ - Use music and imagery for emotional impact
131
+ - Trust audiences to experience rather than understand
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Extended sequence of natural beauty that evokes emotion
135
+ - ❌ **Bad**: Every scene serves only plot function
136
+
137
+ **Film Reference**: Baraka (1992) - Entire film is transcendent visual poetry.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Slow, contemplative pacing allowing absorption
146
+ - Rhythmic variation like musical composition
147
+ - Extended sequences for aesthetic experience
148
+ - Breathing room between dramatic moments
149
+
150
+ ### Scene Length
151
+
152
+ - Highly varied for rhythmic effect
153
+ - Some very short (single image)
154
+ - Some extended (5-10 minutes)
155
+ - Length serves aesthetic purpose
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish visual language and symbolic vocabulary (30% of runtime)
160
+ - **Act II**: Develop themes through visual variations (40% of runtime)
161
+ - **Act III**: Bring visual/thematic elements to resolution (30% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Dissolves and fades for dreamlike quality
166
+ - Match cuts on visual metaphors
167
+ - Rhythmic cutting for montages
168
+ - Poetic juxtapositions
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Beautiful, composed cinematography
175
+ - Slow, graceful camera movements
176
+ - Emphasis on natural beauty
177
+ - Painterly compositions
178
+
179
+ ### Visual Motifs
180
+
181
+ - Recurring symbols and images
182
+ - Nature imagery (water, fire, earth, air)
183
+ - Light and shadow symbolism
184
+ - Color as emotional/thematic indicator
185
+
186
+ ### Action Lines
187
+
188
+ - Lyrical, poetic prose
189
+ - Metaphorical descriptions
190
+ - Sensory details
191
+ - Literary beauty
192
+
193
+ **Example**:
194
+ ```
195
+ EXT. FIELD - GOLDEN HOUR
196
+
197
+ Wheat sways like an ocean of gold. She moves through it, a ship on a sea of grain. The setting sun paints her in amber light.
198
+
199
+ She stops. Closes her eyes. Becomes still as the earth itself.
200
+ ```
201
+
202
+ ## Dialogue Approach
203
+
204
+ ### Dialogue Style
205
+
206
+ - Sparse and purposeful
207
+ - Poetic when used
208
+ - Metaphorical rather than literal
209
+ - Musical quality to speech
210
+
211
+ ### Subtext
212
+
213
+ - Everything important is visual/symbolic
214
+ - Dialogue hints rather than states
215
+ - Silence carries meaning
216
+ - Subtext is primary text
217
+
218
+ ### Formatting
219
+
220
+ - Minimal dialogue blocks
221
+ - Poetic line breaks when appropriate
222
+ - Long silences between lines
223
+ - Dialogue as rare punctuation
224
+
225
+ **Example**:
226
+ ```
227
+ She looks at the horizon.
228
+
229
+ WOMAN
230
+ The light is dying.
231
+
232
+ MAN
233
+ It always does.
234
+
235
+ WOMAN
236
+ And always returns.
237
+
238
+ Silence. They watch the sunset together.
239
+ ```
240
+
241
+ ## Technical Formatting
242
+
243
+ ### Page Layout
244
+
245
+ - Abundant white space
246
+ - Poetic action line formatting
247
+ - Minimal dialogue
248
+ - Visual beauty on page
249
+
250
+ ### Scene Headings
251
+
252
+ - Evocative locations
253
+ - Time of day for light quality
254
+ - Poetic place names
255
+ - Emphasis on natural settings
256
+
257
+ ### Special Elements
258
+
259
+ - MONTAGE for visual poetry sequences
260
+ - INTERCUT for symbolic parallels
261
+ - Minimal technical notation
262
+ - Let poetry speak
263
+
264
+ ## Strengths and Limitations
265
+
266
+ ### Strengths
267
+
268
+ - Creates profound emotional impact
269
+ - Aesthetically beautiful and memorable
270
+ - Operates on multiple levels of meaning
271
+ - Transcends language barriers
272
+ - Unique artistic vision
273
+
274
+ ### Limitations
275
+
276
+ - Limited commercial appeal
277
+ - Can feel pretentious or inaccessible
278
+ - Requires patient, art-house audience
279
+ - Difficult to sustain feature length
280
+ - May sacrifice narrative clarity
281
+
282
+ ### Best Use Cases
283
+
284
+ - Art-house and festival films
285
+ - Spiritual or philosophical themes
286
+ - Nature and environmental stories
287
+ - Meditations on life, death, time
288
+ - Experimental and avant-garde cinema
289
+ - Visual tone poems
290
+
291
+ ## Film Examples
292
+
293
+ ### Example 1: The Tree of Life (2011)
294
+
295
+ **Director**: Terrence Malick
296
+
297
+ **Why This Style Works**: Poetic meditation on existence, family, and cosmos through lyrical imagery and minimal dialogue.
298
+
299
+ **Key Stylistic Moments**:
300
+ - **Creation Sequence**: Visual poetry depicting universe's birth
301
+ - **Childhood Memories**: Impressionistic fragments rather than linear narrative
302
+ - **Whispered Voiceover**: Poetic questions to God
303
+
304
+ **Techniques Used**:
305
+ - Lyrical voiceover as poetry
306
+ - Natural light cinematography
307
+ - Symbolic imagery (tree, water, light)
308
+ - Non-linear, associative structure
309
+
310
+ **Structural Analysis**: Abandons conventional narrative for poetic meditation on life's meaning.
311
+
312
+ ---
313
+
314
+ ### Example 2: Hero (2002)
315
+
316
+ **Director**: Zhang Yimou
317
+
318
+ **Why This Style Works**: Uses color as poetic language, with each sequence in different color representing different emotional/philosophical truth.
319
+
320
+ **Key Stylistic Moments**:
321
+ - **Red Sequence**: Passion and violence
322
+ - **Blue Sequence**: Sadness and truth
323
+ - **White Sequence**: Purity and revelation
324
+
325
+ **Techniques Used**:
326
+ - Color as symbolic language
327
+ - Choreographed action as dance/poetry
328
+ - Visual metaphor over literal truth
329
+ - Painterly compositions
330
+
331
+ **Structural Analysis**: Multiple retellings in different colors create poetic exploration of truth and perspective.
332
+
333
+ ---
334
+
335
+ ### Example 3: The Fountain (2006)
336
+
337
+ **Director**: Darren Aronofsky
338
+
339
+ **Why This Style Works**: Three timelines connected through visual poetry and symbolic imagery exploring love, death, and immortality.
340
+
341
+ **Key Stylistic Moments**:
342
+ - **Tree of Life**: Central visual metaphor across all timelines
343
+ - **Space Sequences**: Pure visual poetry
344
+ - **Parallel Imagery**: Same symbols across different eras
345
+
346
+ **Techniques Used**:
347
+ - Recurring visual motifs
348
+ - Symbolic rather than literal storytelling
349
+ - Minimal dialogue in key sequences
350
+ - Transcendent imagery
351
+
352
+ **Structural Analysis**: Three stories unified through poetic visual language rather than plot logic.
353
+
354
+ ---
355
+
356
+ ### Example 4: Baraka (1992)
357
+
358
+ **Director**: Ron Fricke
359
+
360
+ **Why This Style Works**: Dialogue-free visual poem about humanity and nature, pure cinema as poetry.
361
+
362
+ **Key Stylistic Moments**:
363
+ - **Time-lapse sequences**: Nature's rhythms as poetry
364
+ - **Cultural rituals**: Human diversity as visual symphony
365
+ - **Environmental destruction**: Poetic warning
366
+
367
+ **Techniques Used**:
368
+ - No dialogue or narration
369
+ - Musical structure through editing
370
+ - Symbolic juxtapositions
371
+ - Transcendent cinematography
372
+
373
+ **Structural Analysis**: Abandons narrative entirely for pure visual and musical poetry.
374
+
375
+ ---
376
+
377
+ ### Example 5: Days of Heaven (1978)
378
+
379
+ **Director**: Terrence Malick
380
+
381
+ **Why This Style Works**: Simple story elevated through poetic cinematography, sparse dialogue, and lyrical voiceover.
382
+
383
+ **Key Stylistic Moments**:
384
+ - **Golden Hour Photography**: Every frame painterly
385
+ - **Locust Plague**: Biblical imagery as poetry
386
+ - **Child's Voiceover**: Poetic narration
387
+
388
+ **Techniques Used**:
389
+ - Natural light cinematography
390
+ - Minimal dialogue
391
+ - Poetic voiceover
392
+ - Visual metaphor
393
+
394
+ **Structural Analysis**: Simple love triangle becomes poetic meditation on paradise lost.
395
+
396
+ ---
397
+
398
+ ## Integration with Other Features
399
+
400
+ ### Compatible Genres
401
+
402
+ - **Drama**: Poetic approach deepens emotional impact
403
+ - **Fantasy**: Mythic stories suit poetic treatment
404
+ - **Romance**: Love stories benefit from poetic beauty
405
+ - **Spiritual**: Natural fit for transcendent themes
406
+ - **Documentary**: Poetic docs create emotional truth
407
+
408
+ ### Compatible Themes
409
+
410
+ - **Nature**: Poetic style celebrates natural beauty
411
+ - **Spirituality**: Transcendent themes suit poetic approach
412
+ - **Love**: Romance elevated through poetry
413
+ - **Death**: Poetic treatment finds beauty in mortality
414
+ - **Time**: Poetic structure explores temporal themes
415
+
416
+ ### Style Variations
417
+
418
+ - **Lyrical realism**: Poetic approach to realistic stories (Days of Heaven)
419
+ - **Pure visual poetry**: No dialogue (Baraka, Koyaanisqatsi)
420
+ - **Symbolic narrative**: Story told through symbols (The Fountain)
421
+ - **Impressionistic**: Fragmented, memory-like (The Tree of Life)
422
+
423
+ ## Common Pitfalls
424
+
425
+ ### Pitfall 1: Pretentious Emptiness
426
+
427
+ **Problem**: Beautiful images without substance or meaning beneath surface.
428
+
429
+ **Solution**: Ensure poetic approach serves genuine themes and emotions, not just aesthetics.
430
+
431
+ **Example**: The Tree of Life's beauty serves profound philosophical questions.
432
+
433
+ ---
434
+
435
+ ### Pitfall 2: Incomprehensible Obscurity
436
+
437
+ **Problem**: So abstract that audiences can't find any meaning or connection.
438
+
439
+ **Solution**: Ground poetry in recognizable human emotion. Provide some narrative anchor.
440
+
441
+ **Example**: Hero uses poetic color symbolism but maintains comprehensible story.
442
+
443
+ ---
444
+
445
+ ### Pitfall 3: Overwritten Prose
446
+
447
+ **Problem**: Trying too hard to be poetic in action lines, becoming purple prose.
448
+
449
+ **Solution**: Let simplicity and precision create poetry. Avoid flowery excess.
450
+
451
+ **Example**: Malick's screenplays use simple, precise language that becomes poetic through selection.
452
+
453
+ ---
454
+
455
+ ### Pitfall 4: Boring Slowness
456
+
457
+ **Problem**: Confusing slow pacing with poetic depth, creating tedium.
458
+
459
+ **Solution**: Slow pacing must serve aesthetic purpose. Every moment should resonate.
460
+
461
+ **Example**: Baraka's slow pacing creates contemplative space, not boredom.
462
+
463
+ ---
464
+
465
+ ### Pitfall 5: Sacrificing All Narrative
466
+
467
+ **Problem**: Abandoning story entirely in pursuit of pure aesthetics.
468
+
469
+ **Solution**: Even poetic films benefit from some narrative structure. Find balance.
470
+
471
+ **Example**: Days of Heaven maintains simple story while achieving poetic beauty.
472
+
473
+ ---
474
+
475
+ ## Best Practices
476
+
477
+ 1. **Ground poetry in emotion** - Beautiful images should evoke genuine feeling
478
+ 2. **Use symbols consistently** - Establish visual vocabulary and maintain it
479
+ 3. **Trust visual storytelling** - Let images speak louder than words
480
+ 4. **Create rhythm** - Structure film like musical composition
481
+ 5. **Embrace simplicity** - Poetic doesn't mean complicated
482
+ 6. **Serve themes** - Poetry should illuminate meaning, not obscure it
483
+ 7. **Study visual arts** - Learn from painting, photography, poetry
484
+ 8. **Be patient** - Allow moments to breathe and resonate
485
+
486
+ ## Resources
487
+
488
+ - "Sculpting in Time" by Andrei Tarkovsky - Poetic cinema philosophy
489
+ - "The Poetics of Cinema" by Raúl Ruiz - Theory of cinematic poetry
490
+ - "The Tree of Life" screenplay by Terrence Malick - Poetic screenwriting
491
+ - "In the Blink of an Eye" by Walter Murch - Rhythm and editing
492
+ - Poetry collections - Study literary poetry to inform visual poetry
493
+
494
+ ---
495
+
496
+ **Depth Coverage**: 85%
497
+ **Last Updated**: 2026-01-31
498
+ **Version**: 1.0.0
499
+