@mytechtoday/augment-extensions 0.7.0 → 1.2.1

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,500 +1,500 @@
1
- # Voice-Over Driven Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Technical/Tonal
5
- **Complexity**: Medium-High
6
-
7
- ## Overview
8
-
9
- Voice-over driven narrative uses narration as a primary storytelling device, with the narrator's voice providing context, commentary, insight, or counterpoint to visual action. This style creates intimate connection with narrator while allowing complex temporal and psychological storytelling.
10
-
11
- ## Core Concept
12
-
13
- Voice-over screenwriting uses the human voice as a narrative instrument, creating direct communication between narrator and audience. The power lies in the unique intimacy of voice, the ability to access internal thoughts, and the capacity to bridge time and space. Success requires finding the right voice, balancing narration with visual storytelling, and ensuring voice-over enhances rather than replaces cinematic storytelling.
14
-
15
- ## Definition
16
-
17
- A voice-over driven narrative uses narration as a primary storytelling element, with a character's or narrator's voice providing essential context, commentary, or insight that shapes how the audience experiences the visual narrative.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Distinctive Voice
22
-
23
- **Description**: Narrator must have unique, compelling voice with personality and perspective.
24
-
25
- **Why It Matters**: Voice-over lives or dies on the quality and distinctiveness of the voice.
26
-
27
- **Implementation**:
28
- - Create specific vocal personality
29
- - Establish clear perspective and attitude
30
- - Develop consistent tone
31
- - Make voice memorable
32
-
33
- **Examples**:
34
- - ✅ **Good**: Cynical detective with world-weary wit (Sunset Boulevard)
35
- - ❌ **Bad**: Generic, personality-free narration
36
-
37
- **Film Reference**: A Clockwork Orange (1971) - Alex's distinctive slang-filled narration.
38
-
39
- ---
40
-
41
- ### Requirement 2: Visual-Verbal Relationship
42
-
43
- **Description**: Voice-over must have purposeful relationship to visuals—complement, contradict, or expand.
44
-
45
- **Why It Matters**: Voice-over should enhance cinema, not replace it.
46
-
47
- **Implementation**:
48
- - Avoid describing what we see
49
- - Use voice-over for what visuals can't show
50
- - Create ironic counterpoint when effective
51
- - Complement visuals with context
52
-
53
- **Examples**:
54
- - ✅ **Good**: Narrator describes inner thoughts while visuals show contradictory actions
55
- - ❌ **Bad**: "I walked into the room" while showing character walking into room
56
-
57
- **Film Reference**: Goodfellas (1990) - Voice-over provides context visuals can't convey.
58
-
59
- ---
60
-
61
- ### Requirement 3: Temporal Flexibility
62
-
63
- **Description**: Voice-over enables fluid movement through time and perspective.
64
-
65
- **Why It Matters**: Narration can bridge time periods and provide retrospective insight.
66
-
67
- **Implementation**:
68
- - Use voice-over to jump through time
69
- - Provide retrospective commentary
70
- - Connect disparate time periods
71
- - Create temporal layers
72
-
73
- **Examples**:
74
- - ✅ **Good**: Older narrator reflecting on past events we're watching
75
- - ❌ **Bad**: Voice-over locked to present moment only
76
-
77
- **Film Reference**: The Shawshank Redemption (1994) - Red's narration spans decades.
78
-
79
- ---
80
-
81
- ### Requirement 4: Internal Access
82
-
83
- **Description**: Voice-over provides access to narrator's thoughts, feelings, and perspective.
84
-
85
- **Why It Matters**: Narration can reveal what visuals and dialogue cannot.
86
-
87
- **Implementation**:
88
- - Share internal monologue
89
- - Reveal hidden motivations
90
- - Express unspoken thoughts
91
- - Provide psychological insight
92
-
93
- **Examples**:
94
- - ✅ **Good**: Narrator reveals thoughts they'd never speak aloud
95
- - ❌ **Bad**: Voice-over only states obvious external facts
96
-
97
- **Film Reference**: Taxi Driver (1976) - Travis's disturbed internal monologue.
98
-
99
- ---
100
-
101
- ### Requirement 5: Narrative Purpose
102
-
103
- **Description**: Voice-over must serve clear narrative function beyond convenience.
104
-
105
- **Why It Matters**: Lazy voice-over becomes crutch for weak visual storytelling.
106
-
107
- **Implementation**:
108
- - Justify voice-over's existence
109
- - Ensure it serves story needs
110
- - Avoid using as exposition dump
111
- - Make narration essential
112
-
113
- **Examples**:
114
- - ✅ **Good**: Voice-over provides unique perspective impossible to show
115
- - ❌ **Bad**: Voice-over explains plot because visuals are unclear
116
-
117
- **Film Reference**: Fight Club (1999) - Narrator's voice essential to unreliable narrative.
118
-
119
- ---
120
-
121
- ### Requirement 6: Tonal Consistency
122
-
123
- **Description**: Voice-over tone must remain consistent or evolve purposefully.
124
-
125
- **Why It Matters**: Inconsistent narration breaks audience connection.
126
-
127
- **Implementation**:
128
- - Establish clear tonal baseline
129
- - Maintain consistent voice
130
- - Evolve tone only with purpose
131
- - Match voice to story needs
132
-
133
- **Examples**:
134
- - ✅ **Good**: Cynical noir voice maintained throughout
135
- - ❌ **Bad**: Tone shifts randomly between scenes
136
-
137
- **Film Reference**: The Big Lebowski (1998) - The Stranger's folksy tone consistent throughout.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Voice-over creates rhythmic punctuation
146
- - Balance narration with silence
147
- - Use voice-over to control pacing
148
- - Create rhythm through narration patterns
149
-
150
- ### Scene Length
151
-
152
- - Voice-over can compress or expand time
153
- - Narration allows quick scene transitions
154
- - Montages with voice-over bridge time
155
- - Flexible scene length
156
-
157
- ### Act Structure
158
-
159
- - Voice-over can mark act transitions
160
- - Narration provides structural signposts
161
- - Retrospective framing device
162
- - Flexible structure
163
-
164
- ### Transitions
165
-
166
- - Voice-over bridges scenes smoothly
167
- - Narration connects disparate moments
168
- - Temporal jumps via voice-over
169
- - Seamless transitions
170
-
171
- ## Visual Storytelling
172
-
173
- ### Camera Work
174
-
175
- - Visuals must work with narration
176
- - Show what voice-over doesn't say
177
- - Create visual-verbal counterpoint
178
- - Cinematic storytelling maintained
179
-
180
- ### Visual Motifs
181
-
182
- - Visual elements complement narration
183
- - Recurring images with voice-over
184
- - Symbolic visuals with commentary
185
- - Layered meaning
186
-
187
- ### Action Lines
188
-
189
- - Describe visuals clearly
190
- - Note voice-over placement
191
- - Balance description with narration
192
- - Visual storytelling priority
193
-
194
- **Example**:
195
- ```
196
- INT. DINER - NIGHT
197
-
198
- Jake sits alone, coffee growing cold.
199
-
200
- JAKE (V.O.)
201
- I'd been waiting three hours. She wasn't coming. I knew that. But I kept waiting anyway.
202
-
203
- He stares at the door. Doesn't touch his coffee.
204
- ```
205
-
206
- ## Dialogue Approach
207
-
208
- ### Dialogue Style
209
-
210
- - Balance voice-over with spoken dialogue
211
- - Narration and dialogue serve different functions
212
- - Voice-over more literary, dialogue more natural
213
- - Distinct voices for narration vs. speech
214
-
215
- ### Subtext
216
-
217
- - Voice-over can reveal subtext
218
- - Or create ironic distance from dialogue
219
- - Narration exposes what's unspoken
220
- - Layered meaning
221
-
222
- ### Formatting
223
-
224
- - V.O. (voice-over) for narration
225
- - Clear distinction from dialogue
226
- - Placement indicates timing
227
- - Standard formatting
228
-
229
- **Example**:
230
- ```
231
- SARAH
232
- Everything's fine.
233
-
234
- SARAH (V.O.)
235
- Nothing was fine. Everything was falling apart.
236
-
237
- She forces a smile.
238
- ```
239
-
240
- ## Technical Formatting
241
-
242
- ### Page Layout
243
-
244
- - Standard screenplay format
245
- - V.O. clearly marked
246
- - Voice-over placement clear
247
- - Balance narration with action
248
-
249
- ### Scene Headings
250
-
251
- - Standard headings
252
- - Voice-over doesn't replace scene setting
253
- - Clear visual locations
254
- - Temporal markers when needed
255
-
256
- ### Special Elements
257
-
258
- - MONTAGE with voice-over
259
- - SERIES OF SHOTS with narration
260
- - FLASHBACK with voice-over framing
261
- - Clear technical notation
262
-
263
- ## Strengths and Limitations
264
-
265
- ### Strengths
266
-
267
- - Intimate connection with narrator
268
- - Access to internal thoughts
269
- - Temporal flexibility
270
- - Complex storytelling enabled
271
- - Unique perspective
272
- - Literary quality
273
-
274
- ### Limitations
275
-
276
- - Risk of over-reliance on narration
277
- - Can replace visual storytelling
278
- - May feel dated or literary
279
- - Requires strong writing
280
- - Can become exposition dump
281
- - Passive storytelling risk
282
-
283
- ### Best Use Cases
284
-
285
- - Noir and detective stories
286
- - Memoir and biographical films
287
- - Complex temporal narratives
288
- - Character studies
289
- - Literary adaptations
290
- - Retrospective narratives
291
-
292
- ## Film Examples
293
-
294
- ### Example 1: Sunset Boulevard (1950)
295
-
296
- **Director**: Billy Wilder
297
-
298
- **Why This Style Works**: Dead narrator provides ironic, cynical voice-over creating noir masterpiece.
299
-
300
- **Key Stylistic Moments**:
301
- - **Opening**: Dead man narrates his own death
302
- - **Cynical Commentary**: World-weary Hollywood observations
303
- - **Retrospective Irony**: Knowing the ending colors everything
304
-
305
- **Techniques Used**:
306
- - Dead narrator (ultimate retrospective)
307
- - Cynical, witty voice
308
- - Ironic counterpoint to visuals
309
- - Noir voice-over perfected
310
-
311
- **Structural Analysis**: Voice-over frames entire narrative as flashback from death.
312
-
313
- ---
314
-
315
- ### Example 2: Goodfellas (1990)
316
-
317
- **Director**: Martin Scorsese
318
-
319
- **Why This Style Works**: Henry and Karen's voice-overs provide insider perspective on mob life.
320
-
321
- **Key Stylistic Moments**:
322
- - **"As far back as I can remember..."**: Iconic opening
323
- - **Dual Narrators**: Henry and Karen's perspectives
324
- - **Insider Knowledge**: Voice-over provides context visuals can't
325
-
326
- **Techniques Used**:
327
- - Multiple narrators
328
- - Insider perspective
329
- - Temporal compression via voice-over
330
- - Voice-over as storytelling engine
331
-
332
- **Structural Analysis**: Voice-over enables decades-spanning narrative with intimate detail.
333
-
334
- ---
335
-
336
- ### Example 3: The Shawshank Redemption (1994)
337
-
338
- **Director**: Frank Darabont
339
-
340
- **Why This Style Works**: Red's voice-over provides warmth, wisdom, and emotional anchor.
341
-
342
- **Key Stylistic Moments**:
343
- - **"I must admit..."**: Red's reflective observations
344
- - **Hope Theme**: Voice-over articulates central theme
345
- - **Temporal Bridges**: Narration spans decades
346
-
347
- **Techniques Used**:
348
- - Warm, reflective voice
349
- - Thematic commentary
350
- - Temporal flexibility
351
- - Emotional anchor
352
-
353
- **Structural Analysis**: Voice-over provides continuity across decades and emotional center.
354
-
355
- ---
356
-
357
- ### Example 4**: A Clockwork Orange (1971)
358
-
359
- **Director**: Stanley Kubrick
360
-
361
- **Why This Style Works**: Alex's distinctive slang-filled narration creates unique linguistic world.
362
-
363
- **Key Stylistic Moments**:
364
- - **Nadsat Slang**: Invented language in narration
365
- - **Unreliable Narrator**: Alex's perspective questionable
366
- - **Direct Address**: Intimate connection with audience
367
-
368
- **Techniques Used**:
369
- - Distinctive linguistic style
370
- - Unreliable narration
371
- - Direct audience address
372
- - Voice as character
373
-
374
- **Structural Analysis**: Voice-over creates linguistic and psychological world.
375
-
376
- ---
377
-
378
- ### Example 5: Fight Club (1999)
379
-
380
- **Director**: David Fincher
381
-
382
- **Why This Style Works**: Narrator's voice-over essential to unreliable narrative and twist.
383
-
384
- **Key Stylistic Moments**:
385
- - **Insomniac Rambling**: Stream-of-consciousness style
386
- - **Unreliable Narration**: Voice-over misleads deliberately
387
- - **Direct Address**: Breaking fourth wall
388
-
389
- **Techniques Used**:
390
- - Unreliable narrator
391
- - Stream-of-consciousness
392
- - Voice-over as misdirection
393
- - Essential to twist
394
-
395
- **Structural Analysis**: Voice-over enables unreliable narrative essential to story.
396
-
397
- ---
398
-
399
- ## Integration with Other Features
400
-
401
- ### Compatible Genres
402
-
403
- - **Noir**: Classic voice-over territory
404
- - **Crime**: Insider perspective valuable
405
- - **Drama**: Internal access deepens emotion
406
- - **Comedy**: Comedic narration (The Big Lebowski)
407
- - **Thriller**: Unreliable narrators create suspense
408
-
409
- ### Compatible Themes
410
-
411
- - **Memory**: Retrospective narration natural
412
- - **Identity**: Internal voice explores self
413
- - **Morality**: Narrator can provide moral commentary
414
- - **Time**: Voice-over bridges temporal gaps
415
- - **Perspective**: Narration provides unique viewpoint
416
-
417
- ### Style Variations
418
-
419
- - **Noir voice-over**: Cynical, world-weary (Sunset Boulevard)
420
- - **Memoir voice-over**: Reflective, nostalgic (Shawshank)
421
- - **Unreliable voice-over**: Misleading narration (Fight Club)
422
- - **Comic voice-over**: Humorous narration (The Big Lebowski)
423
-
424
- ## Common Pitfalls
425
-
426
- ### Pitfall 1: Describing What We See
427
-
428
- **Problem**: Voice-over narrates obvious visual information.
429
-
430
- **Solution**: Use voice-over only for what visuals can't convey.
431
-
432
- **Example**: Goodfellas uses voice-over for context and insider knowledge, not description.
433
-
434
- ---
435
-
436
- ### Pitfall 2: Exposition Dump
437
-
438
- **Problem**: Voice-over becomes lazy way to deliver backstory and information.
439
-
440
- **Solution**: Integrate exposition naturally. Show when possible, tell only when necessary.
441
-
442
- **Example**: Shawshank integrates exposition into Red's natural reflections.
443
-
444
- ---
445
-
446
- ### Pitfall 3: Replacing Visual Storytelling
447
-
448
- **Problem**: Over-reliance on narration instead of showing through action.
449
-
450
- **Solution**: Balance voice-over with strong visual storytelling.
451
-
452
- **Example**: Sunset Boulevard maintains strong visual storytelling despite heavy narration.
453
-
454
- ---
455
-
456
- ### Pitfall 4: Inconsistent Voice
457
-
458
- **Problem**: Narrator's tone, style, or perspective shifts randomly.
459
-
460
- **Solution**: Maintain consistent voice or evolve it purposefully.
461
-
462
- **Example**: A Clockwork Orange maintains Alex's distinctive voice throughout.
463
-
464
- ---
465
-
466
- ### Pitfall 5: Unnecessary Narration
467
-
468
- **Problem**: Using voice-over when story doesn't require it.
469
-
470
- **Solution**: Ensure voice-over serves essential narrative function.
471
-
472
- **Example**: Fight Club's voice-over is essential to unreliable narrative structure.
473
-
474
- ---
475
-
476
- ## Best Practices
477
-
478
- 1. **Create distinctive voice** - Make narrator memorable and unique
479
- 2. **Avoid describing visuals** - Use voice-over for what we can't see
480
- 3. **Establish clear purpose** - Know why story needs narration
481
- 4. **Balance with visuals** - Don't replace cinematic storytelling
482
- 5. **Maintain consistency** - Keep voice consistent or evolve purposefully
483
- 6. **Use for internal access** - Reveal thoughts and feelings
484
- 7. **Create temporal flexibility** - Bridge time periods effectively
485
- 8. **Write well** - Voice-over requires strong writing
486
-
487
- ## Resources
488
-
489
- - "Voice-Over Narration in Film" by Sarah Kozloff - Comprehensive study
490
- - "Sunset Boulevard" screenplay by Billy Wilder and Charles Brackett - Noir voice-over master class
491
- - "Goodfellas" screenplay by Nicholas Pileggi and Martin Scorsese - Multiple narrators
492
- - "The Shawshank Redemption" screenplay by Frank Darabont - Warm, reflective voice-over
493
- - "Fight Club" screenplay by Jim Uhls - Unreliable narrator
494
-
495
- ---
496
-
497
- **Depth Coverage**: 85%
498
- **Last Updated**: 2026-01-31
499
- **Version**: 1.0.0
500
-
1
+ # Voice-Over Driven Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Technical/Tonal
5
+ **Complexity**: Medium-High
6
+
7
+ ## Overview
8
+
9
+ Voice-over driven narrative uses narration as a primary storytelling device, with the narrator's voice providing context, commentary, insight, or counterpoint to visual action. This style creates intimate connection with narrator while allowing complex temporal and psychological storytelling.
10
+
11
+ ## Core Concept
12
+
13
+ Voice-over screenwriting uses the human voice as a narrative instrument, creating direct communication between narrator and audience. The power lies in the unique intimacy of voice, the ability to access internal thoughts, and the capacity to bridge time and space. Success requires finding the right voice, balancing narration with visual storytelling, and ensuring voice-over enhances rather than replaces cinematic storytelling.
14
+
15
+ ## Definition
16
+
17
+ A voice-over driven narrative uses narration as a primary storytelling element, with a character's or narrator's voice providing essential context, commentary, or insight that shapes how the audience experiences the visual narrative.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Distinctive Voice
22
+
23
+ **Description**: Narrator must have unique, compelling voice with personality and perspective.
24
+
25
+ **Why It Matters**: Voice-over lives or dies on the quality and distinctiveness of the voice.
26
+
27
+ **Implementation**:
28
+ - Create specific vocal personality
29
+ - Establish clear perspective and attitude
30
+ - Develop consistent tone
31
+ - Make voice memorable
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Cynical detective with world-weary wit (Sunset Boulevard)
35
+ - ❌ **Bad**: Generic, personality-free narration
36
+
37
+ **Film Reference**: A Clockwork Orange (1971) - Alex's distinctive slang-filled narration.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Visual-Verbal Relationship
42
+
43
+ **Description**: Voice-over must have purposeful relationship to visuals—complement, contradict, or expand.
44
+
45
+ **Why It Matters**: Voice-over should enhance cinema, not replace it.
46
+
47
+ **Implementation**:
48
+ - Avoid describing what we see
49
+ - Use voice-over for what visuals can't show
50
+ - Create ironic counterpoint when effective
51
+ - Complement visuals with context
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Narrator describes inner thoughts while visuals show contradictory actions
55
+ - ❌ **Bad**: "I walked into the room" while showing character walking into room
56
+
57
+ **Film Reference**: Goodfellas (1990) - Voice-over provides context visuals can't convey.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Temporal Flexibility
62
+
63
+ **Description**: Voice-over enables fluid movement through time and perspective.
64
+
65
+ **Why It Matters**: Narration can bridge time periods and provide retrospective insight.
66
+
67
+ **Implementation**:
68
+ - Use voice-over to jump through time
69
+ - Provide retrospective commentary
70
+ - Connect disparate time periods
71
+ - Create temporal layers
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Older narrator reflecting on past events we're watching
75
+ - ❌ **Bad**: Voice-over locked to present moment only
76
+
77
+ **Film Reference**: The Shawshank Redemption (1994) - Red's narration spans decades.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Internal Access
82
+
83
+ **Description**: Voice-over provides access to narrator's thoughts, feelings, and perspective.
84
+
85
+ **Why It Matters**: Narration can reveal what visuals and dialogue cannot.
86
+
87
+ **Implementation**:
88
+ - Share internal monologue
89
+ - Reveal hidden motivations
90
+ - Express unspoken thoughts
91
+ - Provide psychological insight
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Narrator reveals thoughts they'd never speak aloud
95
+ - ❌ **Bad**: Voice-over only states obvious external facts
96
+
97
+ **Film Reference**: Taxi Driver (1976) - Travis's disturbed internal monologue.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Narrative Purpose
102
+
103
+ **Description**: Voice-over must serve clear narrative function beyond convenience.
104
+
105
+ **Why It Matters**: Lazy voice-over becomes crutch for weak visual storytelling.
106
+
107
+ **Implementation**:
108
+ - Justify voice-over's existence
109
+ - Ensure it serves story needs
110
+ - Avoid using as exposition dump
111
+ - Make narration essential
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Voice-over provides unique perspective impossible to show
115
+ - ❌ **Bad**: Voice-over explains plot because visuals are unclear
116
+
117
+ **Film Reference**: Fight Club (1999) - Narrator's voice essential to unreliable narrative.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Tonal Consistency
122
+
123
+ **Description**: Voice-over tone must remain consistent or evolve purposefully.
124
+
125
+ **Why It Matters**: Inconsistent narration breaks audience connection.
126
+
127
+ **Implementation**:
128
+ - Establish clear tonal baseline
129
+ - Maintain consistent voice
130
+ - Evolve tone only with purpose
131
+ - Match voice to story needs
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Cynical noir voice maintained throughout
135
+ - ❌ **Bad**: Tone shifts randomly between scenes
136
+
137
+ **Film Reference**: The Big Lebowski (1998) - The Stranger's folksy tone consistent throughout.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Voice-over creates rhythmic punctuation
146
+ - Balance narration with silence
147
+ - Use voice-over to control pacing
148
+ - Create rhythm through narration patterns
149
+
150
+ ### Scene Length
151
+
152
+ - Voice-over can compress or expand time
153
+ - Narration allows quick scene transitions
154
+ - Montages with voice-over bridge time
155
+ - Flexible scene length
156
+
157
+ ### Act Structure
158
+
159
+ - Voice-over can mark act transitions
160
+ - Narration provides structural signposts
161
+ - Retrospective framing device
162
+ - Flexible structure
163
+
164
+ ### Transitions
165
+
166
+ - Voice-over bridges scenes smoothly
167
+ - Narration connects disparate moments
168
+ - Temporal jumps via voice-over
169
+ - Seamless transitions
170
+
171
+ ## Visual Storytelling
172
+
173
+ ### Camera Work
174
+
175
+ - Visuals must work with narration
176
+ - Show what voice-over doesn't say
177
+ - Create visual-verbal counterpoint
178
+ - Cinematic storytelling maintained
179
+
180
+ ### Visual Motifs
181
+
182
+ - Visual elements complement narration
183
+ - Recurring images with voice-over
184
+ - Symbolic visuals with commentary
185
+ - Layered meaning
186
+
187
+ ### Action Lines
188
+
189
+ - Describe visuals clearly
190
+ - Note voice-over placement
191
+ - Balance description with narration
192
+ - Visual storytelling priority
193
+
194
+ **Example**:
195
+ ```
196
+ INT. DINER - NIGHT
197
+
198
+ Jake sits alone, coffee growing cold.
199
+
200
+ JAKE (V.O.)
201
+ I'd been waiting three hours. She wasn't coming. I knew that. But I kept waiting anyway.
202
+
203
+ He stares at the door. Doesn't touch his coffee.
204
+ ```
205
+
206
+ ## Dialogue Approach
207
+
208
+ ### Dialogue Style
209
+
210
+ - Balance voice-over with spoken dialogue
211
+ - Narration and dialogue serve different functions
212
+ - Voice-over more literary, dialogue more natural
213
+ - Distinct voices for narration vs. speech
214
+
215
+ ### Subtext
216
+
217
+ - Voice-over can reveal subtext
218
+ - Or create ironic distance from dialogue
219
+ - Narration exposes what's unspoken
220
+ - Layered meaning
221
+
222
+ ### Formatting
223
+
224
+ - V.O. (voice-over) for narration
225
+ - Clear distinction from dialogue
226
+ - Placement indicates timing
227
+ - Standard formatting
228
+
229
+ **Example**:
230
+ ```
231
+ SARAH
232
+ Everything's fine.
233
+
234
+ SARAH (V.O.)
235
+ Nothing was fine. Everything was falling apart.
236
+
237
+ She forces a smile.
238
+ ```
239
+
240
+ ## Technical Formatting
241
+
242
+ ### Page Layout
243
+
244
+ - Standard screenplay format
245
+ - V.O. clearly marked
246
+ - Voice-over placement clear
247
+ - Balance narration with action
248
+
249
+ ### Scene Headings
250
+
251
+ - Standard headings
252
+ - Voice-over doesn't replace scene setting
253
+ - Clear visual locations
254
+ - Temporal markers when needed
255
+
256
+ ### Special Elements
257
+
258
+ - MONTAGE with voice-over
259
+ - SERIES OF SHOTS with narration
260
+ - FLASHBACK with voice-over framing
261
+ - Clear technical notation
262
+
263
+ ## Strengths and Limitations
264
+
265
+ ### Strengths
266
+
267
+ - Intimate connection with narrator
268
+ - Access to internal thoughts
269
+ - Temporal flexibility
270
+ - Complex storytelling enabled
271
+ - Unique perspective
272
+ - Literary quality
273
+
274
+ ### Limitations
275
+
276
+ - Risk of over-reliance on narration
277
+ - Can replace visual storytelling
278
+ - May feel dated or literary
279
+ - Requires strong writing
280
+ - Can become exposition dump
281
+ - Passive storytelling risk
282
+
283
+ ### Best Use Cases
284
+
285
+ - Noir and detective stories
286
+ - Memoir and biographical films
287
+ - Complex temporal narratives
288
+ - Character studies
289
+ - Literary adaptations
290
+ - Retrospective narratives
291
+
292
+ ## Film Examples
293
+
294
+ ### Example 1: Sunset Boulevard (1950)
295
+
296
+ **Director**: Billy Wilder
297
+
298
+ **Why This Style Works**: Dead narrator provides ironic, cynical voice-over creating noir masterpiece.
299
+
300
+ **Key Stylistic Moments**:
301
+ - **Opening**: Dead man narrates his own death
302
+ - **Cynical Commentary**: World-weary Hollywood observations
303
+ - **Retrospective Irony**: Knowing the ending colors everything
304
+
305
+ **Techniques Used**:
306
+ - Dead narrator (ultimate retrospective)
307
+ - Cynical, witty voice
308
+ - Ironic counterpoint to visuals
309
+ - Noir voice-over perfected
310
+
311
+ **Structural Analysis**: Voice-over frames entire narrative as flashback from death.
312
+
313
+ ---
314
+
315
+ ### Example 2: Goodfellas (1990)
316
+
317
+ **Director**: Martin Scorsese
318
+
319
+ **Why This Style Works**: Henry and Karen's voice-overs provide insider perspective on mob life.
320
+
321
+ **Key Stylistic Moments**:
322
+ - **"As far back as I can remember..."**: Iconic opening
323
+ - **Dual Narrators**: Henry and Karen's perspectives
324
+ - **Insider Knowledge**: Voice-over provides context visuals can't
325
+
326
+ **Techniques Used**:
327
+ - Multiple narrators
328
+ - Insider perspective
329
+ - Temporal compression via voice-over
330
+ - Voice-over as storytelling engine
331
+
332
+ **Structural Analysis**: Voice-over enables decades-spanning narrative with intimate detail.
333
+
334
+ ---
335
+
336
+ ### Example 3: The Shawshank Redemption (1994)
337
+
338
+ **Director**: Frank Darabont
339
+
340
+ **Why This Style Works**: Red's voice-over provides warmth, wisdom, and emotional anchor.
341
+
342
+ **Key Stylistic Moments**:
343
+ - **"I must admit..."**: Red's reflective observations
344
+ - **Hope Theme**: Voice-over articulates central theme
345
+ - **Temporal Bridges**: Narration spans decades
346
+
347
+ **Techniques Used**:
348
+ - Warm, reflective voice
349
+ - Thematic commentary
350
+ - Temporal flexibility
351
+ - Emotional anchor
352
+
353
+ **Structural Analysis**: Voice-over provides continuity across decades and emotional center.
354
+
355
+ ---
356
+
357
+ ### Example 4**: A Clockwork Orange (1971)
358
+
359
+ **Director**: Stanley Kubrick
360
+
361
+ **Why This Style Works**: Alex's distinctive slang-filled narration creates unique linguistic world.
362
+
363
+ **Key Stylistic Moments**:
364
+ - **Nadsat Slang**: Invented language in narration
365
+ - **Unreliable Narrator**: Alex's perspective questionable
366
+ - **Direct Address**: Intimate connection with audience
367
+
368
+ **Techniques Used**:
369
+ - Distinctive linguistic style
370
+ - Unreliable narration
371
+ - Direct audience address
372
+ - Voice as character
373
+
374
+ **Structural Analysis**: Voice-over creates linguistic and psychological world.
375
+
376
+ ---
377
+
378
+ ### Example 5: Fight Club (1999)
379
+
380
+ **Director**: David Fincher
381
+
382
+ **Why This Style Works**: Narrator's voice-over essential to unreliable narrative and twist.
383
+
384
+ **Key Stylistic Moments**:
385
+ - **Insomniac Rambling**: Stream-of-consciousness style
386
+ - **Unreliable Narration**: Voice-over misleads deliberately
387
+ - **Direct Address**: Breaking fourth wall
388
+
389
+ **Techniques Used**:
390
+ - Unreliable narrator
391
+ - Stream-of-consciousness
392
+ - Voice-over as misdirection
393
+ - Essential to twist
394
+
395
+ **Structural Analysis**: Voice-over enables unreliable narrative essential to story.
396
+
397
+ ---
398
+
399
+ ## Integration with Other Features
400
+
401
+ ### Compatible Genres
402
+
403
+ - **Noir**: Classic voice-over territory
404
+ - **Crime**: Insider perspective valuable
405
+ - **Drama**: Internal access deepens emotion
406
+ - **Comedy**: Comedic narration (The Big Lebowski)
407
+ - **Thriller**: Unreliable narrators create suspense
408
+
409
+ ### Compatible Themes
410
+
411
+ - **Memory**: Retrospective narration natural
412
+ - **Identity**: Internal voice explores self
413
+ - **Morality**: Narrator can provide moral commentary
414
+ - **Time**: Voice-over bridges temporal gaps
415
+ - **Perspective**: Narration provides unique viewpoint
416
+
417
+ ### Style Variations
418
+
419
+ - **Noir voice-over**: Cynical, world-weary (Sunset Boulevard)
420
+ - **Memoir voice-over**: Reflective, nostalgic (Shawshank)
421
+ - **Unreliable voice-over**: Misleading narration (Fight Club)
422
+ - **Comic voice-over**: Humorous narration (The Big Lebowski)
423
+
424
+ ## Common Pitfalls
425
+
426
+ ### Pitfall 1: Describing What We See
427
+
428
+ **Problem**: Voice-over narrates obvious visual information.
429
+
430
+ **Solution**: Use voice-over only for what visuals can't convey.
431
+
432
+ **Example**: Goodfellas uses voice-over for context and insider knowledge, not description.
433
+
434
+ ---
435
+
436
+ ### Pitfall 2: Exposition Dump
437
+
438
+ **Problem**: Voice-over becomes lazy way to deliver backstory and information.
439
+
440
+ **Solution**: Integrate exposition naturally. Show when possible, tell only when necessary.
441
+
442
+ **Example**: Shawshank integrates exposition into Red's natural reflections.
443
+
444
+ ---
445
+
446
+ ### Pitfall 3: Replacing Visual Storytelling
447
+
448
+ **Problem**: Over-reliance on narration instead of showing through action.
449
+
450
+ **Solution**: Balance voice-over with strong visual storytelling.
451
+
452
+ **Example**: Sunset Boulevard maintains strong visual storytelling despite heavy narration.
453
+
454
+ ---
455
+
456
+ ### Pitfall 4: Inconsistent Voice
457
+
458
+ **Problem**: Narrator's tone, style, or perspective shifts randomly.
459
+
460
+ **Solution**: Maintain consistent voice or evolve it purposefully.
461
+
462
+ **Example**: A Clockwork Orange maintains Alex's distinctive voice throughout.
463
+
464
+ ---
465
+
466
+ ### Pitfall 5: Unnecessary Narration
467
+
468
+ **Problem**: Using voice-over when story doesn't require it.
469
+
470
+ **Solution**: Ensure voice-over serves essential narrative function.
471
+
472
+ **Example**: Fight Club's voice-over is essential to unreliable narrative structure.
473
+
474
+ ---
475
+
476
+ ## Best Practices
477
+
478
+ 1. **Create distinctive voice** - Make narrator memorable and unique
479
+ 2. **Avoid describing visuals** - Use voice-over for what we can't see
480
+ 3. **Establish clear purpose** - Know why story needs narration
481
+ 4. **Balance with visuals** - Don't replace cinematic storytelling
482
+ 5. **Maintain consistency** - Keep voice consistent or evolve purposefully
483
+ 6. **Use for internal access** - Reveal thoughts and feelings
484
+ 7. **Create temporal flexibility** - Bridge time periods effectively
485
+ 8. **Write well** - Voice-over requires strong writing
486
+
487
+ ## Resources
488
+
489
+ - "Voice-Over Narration in Film" by Sarah Kozloff - Comprehensive study
490
+ - "Sunset Boulevard" screenplay by Billy Wilder and Charles Brackett - Noir voice-over master class
491
+ - "Goodfellas" screenplay by Nicholas Pileggi and Martin Scorsese - Multiple narrators
492
+ - "The Shawshank Redemption" screenplay by Frank Darabont - Warm, reflective voice-over
493
+ - "Fight Club" screenplay by Jim Uhls - Unreliable narrator
494
+
495
+ ---
496
+
497
+ **Depth Coverage**: 85%
498
+ **Last Updated**: 2026-01-31
499
+ **Version**: 1.0.0
500
+