@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
- # Satirical Narrative Style
2
-
3
- **Category**: Screenplay Narrative Style
4
- **Type**: Tonal
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Satirical narrative uses humor, irony, exaggeration, and ridicule to expose and criticize societal flaws, human folly, or institutional absurdity. This style combines entertainment with social commentary, using comedy as a vehicle for critique.
10
-
11
- ## Core Concept
12
-
13
- Satirical screenwriting weaponizes humor to illuminate truth about society, politics, culture, or human nature. The power lies in making audiences laugh while simultaneously making them think, using exaggeration and absurdity to reveal underlying realities. Success requires sharp observation, wit, and the courage to offend in service of truth.
14
-
15
- ## Definition
16
-
17
- A satirical narrative employs irony, sarcasm, exaggeration, and ridicule to expose and criticize foolishness, corruption, or absurdity in individuals, institutions, or society, typically with the intent to provoke change or awareness.
18
-
19
- ## Structural Requirements
20
-
21
- ### Requirement 1: Clear Target
22
-
23
- **Description**: Satire must have a specific target—an institution, behavior, ideology, or societal norm being critiqued.
24
-
25
- **Why It Matters**: Unfocused satire becomes mere comedy without purpose or impact.
26
-
27
- **Implementation**:
28
- - Identify specific subject of critique
29
- - Maintain consistent focus on target
30
- - Ensure audience understands what's being satirized
31
- - Avoid scattershot approach
32
-
33
- **Examples**:
34
- - ✅ **Good**: Satirizing corporate greed through exaggerated CEO character
35
- - ❌ **Bad**: Random jokes about various topics with no unifying critique
36
-
37
- **Film Reference**: Dr. Strangelove (1964) - Laser-focused satire of Cold War nuclear policy.
38
-
39
- ---
40
-
41
- ### Requirement 2: Exaggeration and Absurdity
42
-
43
- **Description**: Amplify real-world absurdities to comic extremes while maintaining recognizable truth.
44
-
45
- **Why It Matters**: Exaggeration reveals truth by making the ridiculous obvious.
46
-
47
- **Implementation**:
48
- - Take real behaviors to logical extremes
49
- - Create absurd situations rooted in reality
50
- - Use hyperbole to illuminate truth
51
- - Maintain internal logic within absurdity
52
-
53
- **Examples**:
54
- - ✅ **Good**: Corporate meeting where executives discuss profit over human lives with cheerful enthusiasm
55
- - ❌ **Bad**: Random absurdity with no connection to real-world critique
56
-
57
- **Film Reference**: Idiocracy (2006) - Exaggerates anti-intellectualism to absurd future extreme.
58
-
59
- ---
60
-
61
- ### Requirement 3: Irony and Contradiction
62
-
63
- **Description**: Highlight contradictions between stated values and actual behavior, or between appearance and reality.
64
-
65
- **Why It Matters**: Irony exposes hypocrisy and reveals uncomfortable truths.
66
-
67
- **Implementation**:
68
- - Show gap between rhetoric and action
69
- - Create situations where characters' words contradict deeds
70
- - Use dramatic irony where audience knows more than characters
71
- - Employ verbal irony and sarcasm
72
-
73
- **Examples**:
74
- - ✅ **Good**: Politician giving speech about family values while cheating on spouse
75
- - ❌ **Bad**: Straightforward presentation without ironic contrast
76
-
77
- **Film Reference**: Thank You for Smoking (2005) - Tobacco lobbyist's rhetoric contradicts obvious truth.
78
-
79
- ---
80
-
81
- ### Requirement 4: Social Commentary
82
-
83
- **Description**: Satire must offer genuine insight or critique, not just jokes.
84
-
85
- **Why It Matters**: Without meaningful commentary, satire becomes empty parody.
86
-
87
- **Implementation**:
88
- - Ground humor in observable social reality
89
- - Offer perspective on real issues
90
- - Make audience think while they laugh
91
- - Avoid preaching; let satire speak for itself
92
-
93
- **Examples**:
94
- - ✅ **Good**: Satirizing healthcare system through absurd insurance bureaucracy
95
- - ❌ **Bad**: Jokes about healthcare with no actual critique
96
-
97
- **Film Reference**: Network (1976) - Satirizes television industry's exploitation and sensationalism.
98
-
99
- ---
100
-
101
- ### Requirement 5: Wit and Intelligence
102
-
103
- **Description**: Satirical dialogue and situations must demonstrate sharp observation and clever construction.
104
-
105
- **Why It Matters**: Dumb satire undermines its own critique.
106
-
107
- **Implementation**:
108
- - Use wordplay, double meanings, and clever dialogue
109
- - Create situations that reveal absurdity through logic
110
- - Demonstrate knowledge of subject being satirized
111
- - Respect audience intelligence
112
-
113
- **Examples**:
114
- - ✅ **Good**: Clever dialogue that works on multiple levels
115
- - ❌ **Bad**: Obvious, heavy-handed jokes that insult audience intelligence
116
-
117
- **Film Reference**: In the Loop (2009) - Rapid-fire witty dialogue satirizes political spin.
118
-
119
- ---
120
-
121
- ### Requirement 6: Tone Balance
122
-
123
- **Description**: Balance humor with critique, ensuring satire doesn't become either toothless comedy or preachy sermon.
124
-
125
- **Why It Matters**: Too light loses impact; too heavy loses audience.
126
-
127
- **Implementation**:
128
- - Keep humor sharp but not cruel
129
- - Maintain entertainment value while critiquing
130
- - Avoid becoming didactic or preachy
131
- - Let absurdity speak for itself
132
-
133
- **Examples**:
134
- - ✅ **Good**: Funny scenes that also make pointed social commentary
135
- - ❌ **Bad**: Characters delivering speeches about what's wrong with society
136
-
137
- **Film Reference**: The Big Short (2015) - Balances humor with serious critique of financial crisis.
138
-
139
- ---
140
-
141
- ## Pacing Guidelines
142
-
143
- ### Overall Rhythm
144
-
145
- - Quick, energetic pacing to maintain comedic momentum
146
- - Rapid-fire dialogue and situations
147
- - Build absurdity progressively
148
- - Accelerate toward climactic satirical payoff
149
-
150
- ### Scene Length
151
-
152
- - Shorter scenes (2-3 pages) to maintain energy
153
- - Quick cuts between satirical vignettes
154
- - Avoid lingering too long on single joke
155
- - Move swiftly to next target
156
-
157
- ### Act Structure
158
-
159
- - **Act I**: Establish satirical world and targets (25% of runtime)
160
- - **Act II**: Escalate absurdity and deepen critique (50% of runtime)
161
- - **Act III**: Bring satire to logical extreme conclusion (25% of runtime)
162
-
163
- ### Transitions
164
-
165
- - Quick cuts between scenes
166
- - Ironic juxtapositions
167
- - Montages showing absurdity
168
- - Abrupt shifts for comic effect
169
-
170
- ## Visual Storytelling
171
-
172
- ### Camera Work
173
-
174
- - Can range from naturalistic to stylized
175
- - Use framing to emphasize absurdity
176
- - Visual irony through composition
177
- - Deadpan presentation of ridiculous situations
178
-
179
- ### Visual Motifs
180
-
181
- - Symbolic imagery representing critique
182
- - Visual exaggeration of real-world elements
183
- - Recurring visual gags
184
- - Production design that satirizes target
185
-
186
- ### Action Lines
187
-
188
- - Describe absurd situations matter-of-factly
189
- - Note ironic visual details
190
- - Maintain satirical tone in prose
191
- - Highlight contradictions visually
192
-
193
- **Example**:
194
- ```
195
- INT. CORPORATE BOARDROOM - DAY
196
-
197
- Executives in $5,000 suits discuss layoffs while eating catered lunch from a Michelin-starred restaurant.
198
-
199
- CEO
200
- We need to tighten our belts. Starting with the janitorial staff.
201
-
202
- He takes a bite of $200 wagyu beef.
203
- ```
204
-
205
- ## Dialogue Approach
206
-
207
- ### Dialogue Style
208
-
209
- - Sharp, witty, often rapid-fire
210
- - Characters speak in revealing contradictions
211
- - Jargon and buzzwords satirized
212
- - Verbal irony and sarcasm
213
-
214
- ### Subtext
215
-
216
- - Characters often unaware of their own absurdity
217
- - Dramatic irony from audience awareness
218
- - What's not said reveals hypocrisy
219
- - Subtext exposes contradictions
220
-
221
- ### Formatting
222
-
223
- - Standard formatting with punchy dialogue
224
- - Quick exchanges
225
- - Overlapping speech for chaos
226
- - Minimal parentheticals
227
-
228
- **Example**:
229
- ```
230
- SENATOR
231
- I'm deeply committed to transparency.
232
-
233
- AIDE
234
- (whispering)
235
- The press is asking about the offshore accounts.
236
-
237
- SENATOR
238
- (to press)
239
- No further questions at this time.
240
- ```
241
-
242
- ## Technical Formatting
243
-
244
- ### Page Layout
245
-
246
- - Standard screenplay format
247
- - Quick scene changes
248
- - Clear satirical targets
249
- - Energetic pacing on page
250
-
251
- ### Scene Headings
252
-
253
- - Specific locations that enhance satire
254
- - Ironic location choices
255
- - Frequent scene changes
256
- - Varied settings
257
-
258
- ### Special Elements
259
-
260
- - MONTAGE for satirical sequences
261
- - INTERCUT for ironic parallels
262
- - TITLE CARDS for satirical commentary
263
- - ON-SCREEN TEXT for ironic statistics
264
-
265
- ## Strengths and Limitations
266
-
267
- ### Strengths
268
-
269
- - Combines entertainment with social commentary
270
- - Makes difficult subjects accessible through humor
271
- - Can say things straight drama cannot
272
- - Engages audiences intellectually and emotionally
273
- - Memorable and quotable
274
-
275
- ### Limitations
276
-
277
- - Risk of dating quickly as targets change
278
- - Can alienate audiences who disagree with critique
279
- - Difficult to balance humor and message
280
- - May be dismissed as "just comedy"
281
- - Requires sophisticated audience
282
-
283
- ### Best Use Cases
284
-
285
- - Political and social commentary
286
- - Corporate and institutional critique
287
- - Media and entertainment industry satire
288
- - Cultural phenomenon examination
289
- - Exposing hypocrisy and absurdity
290
-
291
- ## Film Examples
292
-
293
- ### Example 1: Dr. Strangelove (1964)
294
-
295
- **Director**: Stanley Kubrick
296
-
297
- **Why This Style Works**: Absurdist satire of Cold War nuclear policy reveals madness of mutually assured destruction through exaggerated characters and situations.
298
-
299
- **Key Stylistic Moments**:
300
- - **War Room**: Generals discuss nuclear war with bureaucratic banality
301
- - **Character Names**: General Jack D. Ripper, Dr. Strangelove—satirical from the start
302
- - **Ending**: Apocalypse presented as darkly comic inevitability
303
-
304
- **Techniques Used**:
305
- - Deadpan delivery of absurd dialogue
306
- - Exaggerated characters representing real attitudes
307
- - Visual irony (war room as mundane office)
308
- - Escalating absurdity to logical extreme
309
-
310
- **Structural Analysis**: Takes real Cold War anxieties to absurd extreme, revealing underlying madness through comedy.
311
-
312
- ---
313
-
314
- ### Example 2: Network (1976)
315
-
316
- **Director**: Sidney Lumet
317
-
318
- **Why This Style Works**: Satirizes television industry's exploitation and sensationalism, predicting reality TV and infotainment.
319
-
320
- **Key Stylistic Moments**:
321
- - **"I'm mad as hell" speech**: Genuine anger commodified for ratings
322
- - **Executive meetings**: Profit prioritized over ethics with cheerful enthusiasm
323
- - **Assassination as entertainment**: Logical extreme of ratings-driven programming
324
-
325
- **Techniques Used**:
326
- - Exaggeration of real industry practices
327
- - Characters unaware of their own absurdity
328
- - Prophetic satire that became reality
329
- - Sharp, witty dialogue
330
-
331
- **Structural Analysis**: Escalates from realistic to absurd, showing how profit motive corrupts journalism.
332
-
333
- ---
334
-
335
- ### Example 3: Thank You for Smoking (2005)
336
-
337
- **Director**: Jason Reitman
338
-
339
- **Why This Style Works**: Satirizes spin culture and lobbying through charismatic tobacco lobbyist who defends the indefensible.
340
-
341
- **Key Stylistic Moments**:
342
- - **MOD Squad**: Lobbyists for tobacco, alcohol, firearms bond over shared amorality
343
- - **Talk show debate**: Protagonist wins argument despite being obviously wrong
344
- - **Son's education**: Teaching child to manipulate truth
345
-
346
- **Techniques Used**:
347
- - Charismatic protagonist doing terrible things
348
- - Witty dialogue that reveals hypocrisy
349
- - No one smokes in film about tobacco lobbying (ironic choice)
350
- - Satirizes rhetoric and spin, not just tobacco
351
-
352
- **Structural Analysis**: Uses likable protagonist to satirize how rhetoric can defend anything.
353
-
354
- ---
355
-
356
- ### Example 4: The Big Short (2015)
357
-
358
- **Director**: Adam McKay
359
-
360
- **Why This Style Works**: Makes complex financial crisis accessible through satirical approach, breaking fourth wall and using celebrity cameos to explain concepts.
361
-
362
- **Key Stylistic Moments**:
363
- - **Celebrity cameos**: Margot Robbie in bathtub explains subprime mortgages
364
- - **Fourth wall breaks**: Characters address audience directly
365
- - **Absurd meetings**: Bankers' obliviousness to impending disaster
366
-
367
- **Techniques Used**:
368
- - Satirical explanations of complex topics
369
- - Ironic contrast between characters' knowledge and bankers' ignorance
370
- - Dark humor about real tragedy
371
- - Innovative narrative techniques
372
-
373
- **Structural Analysis**: Satirizes financial industry while educating audience about 2008 crisis.
374
-
375
- ---
376
-
377
- ### Example 5: In the Loop (2009)
378
-
379
- **Director**: Armando Iannucci
380
-
381
- **Why This Style Works**: Rapid-fire satirical dialogue exposes political spin and bureaucratic absurdity around Iraq War.
382
-
383
- **Key Stylistic Moments**:
384
- - **Profane tirades**: Malcolm Tucker's creative insults
385
- - **Spin meetings**: Truth manipulated for political advantage
386
- - **War as bureaucratic process**: Life-and-death decisions made casually
387
-
388
- **Techniques Used**:
389
- - Extremely fast-paced dialogue
390
- - Improvised feel with scripted precision
391
- - Characters' obliviousness to their own absurdity
392
- - Handheld camera for documentary realism
393
-
394
- **Structural Analysis**: Satirizes how war decisions are made through bureaucratic incompetence and political spin.
395
-
396
- ---
397
-
398
- ## Integration with Other Features
399
-
400
- ### Compatible Genres
401
-
402
- - **Comedy**: Natural fit for satirical approach
403
- - **Drama**: Dark satire can be dramatic
404
- - **Thriller**: Satirical thrillers expose systemic issues
405
- - **Science Fiction**: Dystopian satire (Idiocracy, Brazil)
406
- - **Political**: Natural target for satire
407
-
408
- ### Compatible Themes
409
-
410
- - **Power and Corruption**: Satire exposes abuse
411
- - **Hypocrisy**: Perfect target for satirical treatment
412
- - **Greed**: Corporate satire reveals excess
413
- - **Media Manipulation**: Satire of spin and propaganda
414
- - **Social Inequality**: Satirical lens on class issues
415
-
416
- ### Style Variations
417
-
418
- - **Absurdist satire**: Extreme exaggeration (Dr. Strangelove)
419
- - **Deadpan satire**: Straight-faced presentation (Office Space)
420
- - **Dark satire**: Serious subjects with satirical edge (The Big Short)
421
- - **Farcical satire**: Broad, physical comedy with satirical intent
422
-
423
- ## Common Pitfalls
424
-
425
- ### Pitfall 1: Preaching Instead of Satirizing
426
-
427
- **Problem**: Characters deliver speeches about what's wrong instead of showing it through satire.
428
-
429
- **Solution**: Let absurdity speak for itself. Show, don't tell, what's wrong.
430
-
431
- **Example**: Network shows television's corruption through action, not speeches about it.
432
-
433
- ---
434
-
435
- ### Pitfall 2: Toothless Satire
436
-
437
- **Problem**: Satire becomes so gentle it loses all bite and impact.
438
-
439
- **Solution**: Be willing to offend in service of truth. Satire should have edge.
440
-
441
- **Example**: Dr. Strangelove doesn't pull punches about nuclear war absurdity.
442
-
443
- ---
444
-
445
- ### Pitfall 3: Unclear Target
446
-
447
- **Problem**: Audience can't tell what's being satirized or why.
448
-
449
- **Solution**: Maintain clear focus on specific target. Make critique obvious.
450
-
451
- **Example**: Thank You for Smoking clearly satirizes spin culture and lobbying.
452
-
453
- ---
454
-
455
- ### Pitfall 4: Mean-Spirited Cruelty
456
-
457
- **Problem**: Satire becomes cruel mockery without insight or purpose.
458
-
459
- **Solution**: Satirize institutions and behaviors, not individuals. Maintain humanity.
460
-
461
- **Example**: In the Loop satirizes political system, not specific real politicians.
462
-
463
- ---
464
-
465
- ### Pitfall 5: Dating Quickly
466
-
467
- **Problem**: Topical satire becomes irrelevant as targets change.
468
-
469
- **Solution**: Focus on timeless human folly and institutional problems, not just current events.
470
-
471
- **Example**: Network remains relevant decades later because it satirizes timeless media issues.
472
-
473
- ---
474
-
475
- ## Best Practices
476
-
477
- 1. **Know your target** - Research what you're satirizing thoroughly
478
- 2. **Exaggerate truthfully** - Base absurdity on real observations
479
- 3. **Maintain internal logic** - Even absurd worlds need consistent rules
480
- 4. **Balance humor and critique** - Entertain while making points
481
- 5. **Respect audience intelligence** - Trust them to get the satire
482
- 6. **Be fearless** - Satire requires courage to offend
483
- 7. **Show, don't preach** - Let situations reveal absurdity
484
- 8. **Find universal truths** - Satirize timeless human folly
485
-
486
- ## Resources
487
-
488
- - "Satire: A Critical Reintroduction" by Dustin Griffin - Theory of satire
489
- - "The Anatomy of Satire" by Gilbert Highet - Classical satirical techniques
490
- - "Dr. Strangelove" screenplay by Stanley Kubrick, Terry Southern, Peter George - Master class
491
- - "Network" screenplay by Paddy Chayefsky - Prophetic media satire
492
- - "In the Loop" screenplay by Jesse Armstrong, Simon Blackwell, Armando Iannucci, Tony Roche - Political satire
493
-
494
- ---
495
-
496
- **Depth Coverage**: 85%
497
- **Last Updated**: 2026-01-31
498
- **Version**: 1.0.0
499
-
1
+ # Satirical Narrative Style
2
+
3
+ **Category**: Screenplay Narrative Style
4
+ **Type**: Tonal
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Satirical narrative uses humor, irony, exaggeration, and ridicule to expose and criticize societal flaws, human folly, or institutional absurdity. This style combines entertainment with social commentary, using comedy as a vehicle for critique.
10
+
11
+ ## Core Concept
12
+
13
+ Satirical screenwriting weaponizes humor to illuminate truth about society, politics, culture, or human nature. The power lies in making audiences laugh while simultaneously making them think, using exaggeration and absurdity to reveal underlying realities. Success requires sharp observation, wit, and the courage to offend in service of truth.
14
+
15
+ ## Definition
16
+
17
+ A satirical narrative employs irony, sarcasm, exaggeration, and ridicule to expose and criticize foolishness, corruption, or absurdity in individuals, institutions, or society, typically with the intent to provoke change or awareness.
18
+
19
+ ## Structural Requirements
20
+
21
+ ### Requirement 1: Clear Target
22
+
23
+ **Description**: Satire must have a specific target—an institution, behavior, ideology, or societal norm being critiqued.
24
+
25
+ **Why It Matters**: Unfocused satire becomes mere comedy without purpose or impact.
26
+
27
+ **Implementation**:
28
+ - Identify specific subject of critique
29
+ - Maintain consistent focus on target
30
+ - Ensure audience understands what's being satirized
31
+ - Avoid scattershot approach
32
+
33
+ **Examples**:
34
+ - ✅ **Good**: Satirizing corporate greed through exaggerated CEO character
35
+ - ❌ **Bad**: Random jokes about various topics with no unifying critique
36
+
37
+ **Film Reference**: Dr. Strangelove (1964) - Laser-focused satire of Cold War nuclear policy.
38
+
39
+ ---
40
+
41
+ ### Requirement 2: Exaggeration and Absurdity
42
+
43
+ **Description**: Amplify real-world absurdities to comic extremes while maintaining recognizable truth.
44
+
45
+ **Why It Matters**: Exaggeration reveals truth by making the ridiculous obvious.
46
+
47
+ **Implementation**:
48
+ - Take real behaviors to logical extremes
49
+ - Create absurd situations rooted in reality
50
+ - Use hyperbole to illuminate truth
51
+ - Maintain internal logic within absurdity
52
+
53
+ **Examples**:
54
+ - ✅ **Good**: Corporate meeting where executives discuss profit over human lives with cheerful enthusiasm
55
+ - ❌ **Bad**: Random absurdity with no connection to real-world critique
56
+
57
+ **Film Reference**: Idiocracy (2006) - Exaggerates anti-intellectualism to absurd future extreme.
58
+
59
+ ---
60
+
61
+ ### Requirement 3: Irony and Contradiction
62
+
63
+ **Description**: Highlight contradictions between stated values and actual behavior, or between appearance and reality.
64
+
65
+ **Why It Matters**: Irony exposes hypocrisy and reveals uncomfortable truths.
66
+
67
+ **Implementation**:
68
+ - Show gap between rhetoric and action
69
+ - Create situations where characters' words contradict deeds
70
+ - Use dramatic irony where audience knows more than characters
71
+ - Employ verbal irony and sarcasm
72
+
73
+ **Examples**:
74
+ - ✅ **Good**: Politician giving speech about family values while cheating on spouse
75
+ - ❌ **Bad**: Straightforward presentation without ironic contrast
76
+
77
+ **Film Reference**: Thank You for Smoking (2005) - Tobacco lobbyist's rhetoric contradicts obvious truth.
78
+
79
+ ---
80
+
81
+ ### Requirement 4: Social Commentary
82
+
83
+ **Description**: Satire must offer genuine insight or critique, not just jokes.
84
+
85
+ **Why It Matters**: Without meaningful commentary, satire becomes empty parody.
86
+
87
+ **Implementation**:
88
+ - Ground humor in observable social reality
89
+ - Offer perspective on real issues
90
+ - Make audience think while they laugh
91
+ - Avoid preaching; let satire speak for itself
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Satirizing healthcare system through absurd insurance bureaucracy
95
+ - ❌ **Bad**: Jokes about healthcare with no actual critique
96
+
97
+ **Film Reference**: Network (1976) - Satirizes television industry's exploitation and sensationalism.
98
+
99
+ ---
100
+
101
+ ### Requirement 5: Wit and Intelligence
102
+
103
+ **Description**: Satirical dialogue and situations must demonstrate sharp observation and clever construction.
104
+
105
+ **Why It Matters**: Dumb satire undermines its own critique.
106
+
107
+ **Implementation**:
108
+ - Use wordplay, double meanings, and clever dialogue
109
+ - Create situations that reveal absurdity through logic
110
+ - Demonstrate knowledge of subject being satirized
111
+ - Respect audience intelligence
112
+
113
+ **Examples**:
114
+ - ✅ **Good**: Clever dialogue that works on multiple levels
115
+ - ❌ **Bad**: Obvious, heavy-handed jokes that insult audience intelligence
116
+
117
+ **Film Reference**: In the Loop (2009) - Rapid-fire witty dialogue satirizes political spin.
118
+
119
+ ---
120
+
121
+ ### Requirement 6: Tone Balance
122
+
123
+ **Description**: Balance humor with critique, ensuring satire doesn't become either toothless comedy or preachy sermon.
124
+
125
+ **Why It Matters**: Too light loses impact; too heavy loses audience.
126
+
127
+ **Implementation**:
128
+ - Keep humor sharp but not cruel
129
+ - Maintain entertainment value while critiquing
130
+ - Avoid becoming didactic or preachy
131
+ - Let absurdity speak for itself
132
+
133
+ **Examples**:
134
+ - ✅ **Good**: Funny scenes that also make pointed social commentary
135
+ - ❌ **Bad**: Characters delivering speeches about what's wrong with society
136
+
137
+ **Film Reference**: The Big Short (2015) - Balances humor with serious critique of financial crisis.
138
+
139
+ ---
140
+
141
+ ## Pacing Guidelines
142
+
143
+ ### Overall Rhythm
144
+
145
+ - Quick, energetic pacing to maintain comedic momentum
146
+ - Rapid-fire dialogue and situations
147
+ - Build absurdity progressively
148
+ - Accelerate toward climactic satirical payoff
149
+
150
+ ### Scene Length
151
+
152
+ - Shorter scenes (2-3 pages) to maintain energy
153
+ - Quick cuts between satirical vignettes
154
+ - Avoid lingering too long on single joke
155
+ - Move swiftly to next target
156
+
157
+ ### Act Structure
158
+
159
+ - **Act I**: Establish satirical world and targets (25% of runtime)
160
+ - **Act II**: Escalate absurdity and deepen critique (50% of runtime)
161
+ - **Act III**: Bring satire to logical extreme conclusion (25% of runtime)
162
+
163
+ ### Transitions
164
+
165
+ - Quick cuts between scenes
166
+ - Ironic juxtapositions
167
+ - Montages showing absurdity
168
+ - Abrupt shifts for comic effect
169
+
170
+ ## Visual Storytelling
171
+
172
+ ### Camera Work
173
+
174
+ - Can range from naturalistic to stylized
175
+ - Use framing to emphasize absurdity
176
+ - Visual irony through composition
177
+ - Deadpan presentation of ridiculous situations
178
+
179
+ ### Visual Motifs
180
+
181
+ - Symbolic imagery representing critique
182
+ - Visual exaggeration of real-world elements
183
+ - Recurring visual gags
184
+ - Production design that satirizes target
185
+
186
+ ### Action Lines
187
+
188
+ - Describe absurd situations matter-of-factly
189
+ - Note ironic visual details
190
+ - Maintain satirical tone in prose
191
+ - Highlight contradictions visually
192
+
193
+ **Example**:
194
+ ```
195
+ INT. CORPORATE BOARDROOM - DAY
196
+
197
+ Executives in $5,000 suits discuss layoffs while eating catered lunch from a Michelin-starred restaurant.
198
+
199
+ CEO
200
+ We need to tighten our belts. Starting with the janitorial staff.
201
+
202
+ He takes a bite of $200 wagyu beef.
203
+ ```
204
+
205
+ ## Dialogue Approach
206
+
207
+ ### Dialogue Style
208
+
209
+ - Sharp, witty, often rapid-fire
210
+ - Characters speak in revealing contradictions
211
+ - Jargon and buzzwords satirized
212
+ - Verbal irony and sarcasm
213
+
214
+ ### Subtext
215
+
216
+ - Characters often unaware of their own absurdity
217
+ - Dramatic irony from audience awareness
218
+ - What's not said reveals hypocrisy
219
+ - Subtext exposes contradictions
220
+
221
+ ### Formatting
222
+
223
+ - Standard formatting with punchy dialogue
224
+ - Quick exchanges
225
+ - Overlapping speech for chaos
226
+ - Minimal parentheticals
227
+
228
+ **Example**:
229
+ ```
230
+ SENATOR
231
+ I'm deeply committed to transparency.
232
+
233
+ AIDE
234
+ (whispering)
235
+ The press is asking about the offshore accounts.
236
+
237
+ SENATOR
238
+ (to press)
239
+ No further questions at this time.
240
+ ```
241
+
242
+ ## Technical Formatting
243
+
244
+ ### Page Layout
245
+
246
+ - Standard screenplay format
247
+ - Quick scene changes
248
+ - Clear satirical targets
249
+ - Energetic pacing on page
250
+
251
+ ### Scene Headings
252
+
253
+ - Specific locations that enhance satire
254
+ - Ironic location choices
255
+ - Frequent scene changes
256
+ - Varied settings
257
+
258
+ ### Special Elements
259
+
260
+ - MONTAGE for satirical sequences
261
+ - INTERCUT for ironic parallels
262
+ - TITLE CARDS for satirical commentary
263
+ - ON-SCREEN TEXT for ironic statistics
264
+
265
+ ## Strengths and Limitations
266
+
267
+ ### Strengths
268
+
269
+ - Combines entertainment with social commentary
270
+ - Makes difficult subjects accessible through humor
271
+ - Can say things straight drama cannot
272
+ - Engages audiences intellectually and emotionally
273
+ - Memorable and quotable
274
+
275
+ ### Limitations
276
+
277
+ - Risk of dating quickly as targets change
278
+ - Can alienate audiences who disagree with critique
279
+ - Difficult to balance humor and message
280
+ - May be dismissed as "just comedy"
281
+ - Requires sophisticated audience
282
+
283
+ ### Best Use Cases
284
+
285
+ - Political and social commentary
286
+ - Corporate and institutional critique
287
+ - Media and entertainment industry satire
288
+ - Cultural phenomenon examination
289
+ - Exposing hypocrisy and absurdity
290
+
291
+ ## Film Examples
292
+
293
+ ### Example 1: Dr. Strangelove (1964)
294
+
295
+ **Director**: Stanley Kubrick
296
+
297
+ **Why This Style Works**: Absurdist satire of Cold War nuclear policy reveals madness of mutually assured destruction through exaggerated characters and situations.
298
+
299
+ **Key Stylistic Moments**:
300
+ - **War Room**: Generals discuss nuclear war with bureaucratic banality
301
+ - **Character Names**: General Jack D. Ripper, Dr. Strangelove—satirical from the start
302
+ - **Ending**: Apocalypse presented as darkly comic inevitability
303
+
304
+ **Techniques Used**:
305
+ - Deadpan delivery of absurd dialogue
306
+ - Exaggerated characters representing real attitudes
307
+ - Visual irony (war room as mundane office)
308
+ - Escalating absurdity to logical extreme
309
+
310
+ **Structural Analysis**: Takes real Cold War anxieties to absurd extreme, revealing underlying madness through comedy.
311
+
312
+ ---
313
+
314
+ ### Example 2: Network (1976)
315
+
316
+ **Director**: Sidney Lumet
317
+
318
+ **Why This Style Works**: Satirizes television industry's exploitation and sensationalism, predicting reality TV and infotainment.
319
+
320
+ **Key Stylistic Moments**:
321
+ - **"I'm mad as hell" speech**: Genuine anger commodified for ratings
322
+ - **Executive meetings**: Profit prioritized over ethics with cheerful enthusiasm
323
+ - **Assassination as entertainment**: Logical extreme of ratings-driven programming
324
+
325
+ **Techniques Used**:
326
+ - Exaggeration of real industry practices
327
+ - Characters unaware of their own absurdity
328
+ - Prophetic satire that became reality
329
+ - Sharp, witty dialogue
330
+
331
+ **Structural Analysis**: Escalates from realistic to absurd, showing how profit motive corrupts journalism.
332
+
333
+ ---
334
+
335
+ ### Example 3: Thank You for Smoking (2005)
336
+
337
+ **Director**: Jason Reitman
338
+
339
+ **Why This Style Works**: Satirizes spin culture and lobbying through charismatic tobacco lobbyist who defends the indefensible.
340
+
341
+ **Key Stylistic Moments**:
342
+ - **MOD Squad**: Lobbyists for tobacco, alcohol, firearms bond over shared amorality
343
+ - **Talk show debate**: Protagonist wins argument despite being obviously wrong
344
+ - **Son's education**: Teaching child to manipulate truth
345
+
346
+ **Techniques Used**:
347
+ - Charismatic protagonist doing terrible things
348
+ - Witty dialogue that reveals hypocrisy
349
+ - No one smokes in film about tobacco lobbying (ironic choice)
350
+ - Satirizes rhetoric and spin, not just tobacco
351
+
352
+ **Structural Analysis**: Uses likable protagonist to satirize how rhetoric can defend anything.
353
+
354
+ ---
355
+
356
+ ### Example 4: The Big Short (2015)
357
+
358
+ **Director**: Adam McKay
359
+
360
+ **Why This Style Works**: Makes complex financial crisis accessible through satirical approach, breaking fourth wall and using celebrity cameos to explain concepts.
361
+
362
+ **Key Stylistic Moments**:
363
+ - **Celebrity cameos**: Margot Robbie in bathtub explains subprime mortgages
364
+ - **Fourth wall breaks**: Characters address audience directly
365
+ - **Absurd meetings**: Bankers' obliviousness to impending disaster
366
+
367
+ **Techniques Used**:
368
+ - Satirical explanations of complex topics
369
+ - Ironic contrast between characters' knowledge and bankers' ignorance
370
+ - Dark humor about real tragedy
371
+ - Innovative narrative techniques
372
+
373
+ **Structural Analysis**: Satirizes financial industry while educating audience about 2008 crisis.
374
+
375
+ ---
376
+
377
+ ### Example 5: In the Loop (2009)
378
+
379
+ **Director**: Armando Iannucci
380
+
381
+ **Why This Style Works**: Rapid-fire satirical dialogue exposes political spin and bureaucratic absurdity around Iraq War.
382
+
383
+ **Key Stylistic Moments**:
384
+ - **Profane tirades**: Malcolm Tucker's creative insults
385
+ - **Spin meetings**: Truth manipulated for political advantage
386
+ - **War as bureaucratic process**: Life-and-death decisions made casually
387
+
388
+ **Techniques Used**:
389
+ - Extremely fast-paced dialogue
390
+ - Improvised feel with scripted precision
391
+ - Characters' obliviousness to their own absurdity
392
+ - Handheld camera for documentary realism
393
+
394
+ **Structural Analysis**: Satirizes how war decisions are made through bureaucratic incompetence and political spin.
395
+
396
+ ---
397
+
398
+ ## Integration with Other Features
399
+
400
+ ### Compatible Genres
401
+
402
+ - **Comedy**: Natural fit for satirical approach
403
+ - **Drama**: Dark satire can be dramatic
404
+ - **Thriller**: Satirical thrillers expose systemic issues
405
+ - **Science Fiction**: Dystopian satire (Idiocracy, Brazil)
406
+ - **Political**: Natural target for satire
407
+
408
+ ### Compatible Themes
409
+
410
+ - **Power and Corruption**: Satire exposes abuse
411
+ - **Hypocrisy**: Perfect target for satirical treatment
412
+ - **Greed**: Corporate satire reveals excess
413
+ - **Media Manipulation**: Satire of spin and propaganda
414
+ - **Social Inequality**: Satirical lens on class issues
415
+
416
+ ### Style Variations
417
+
418
+ - **Absurdist satire**: Extreme exaggeration (Dr. Strangelove)
419
+ - **Deadpan satire**: Straight-faced presentation (Office Space)
420
+ - **Dark satire**: Serious subjects with satirical edge (The Big Short)
421
+ - **Farcical satire**: Broad, physical comedy with satirical intent
422
+
423
+ ## Common Pitfalls
424
+
425
+ ### Pitfall 1: Preaching Instead of Satirizing
426
+
427
+ **Problem**: Characters deliver speeches about what's wrong instead of showing it through satire.
428
+
429
+ **Solution**: Let absurdity speak for itself. Show, don't tell, what's wrong.
430
+
431
+ **Example**: Network shows television's corruption through action, not speeches about it.
432
+
433
+ ---
434
+
435
+ ### Pitfall 2: Toothless Satire
436
+
437
+ **Problem**: Satire becomes so gentle it loses all bite and impact.
438
+
439
+ **Solution**: Be willing to offend in service of truth. Satire should have edge.
440
+
441
+ **Example**: Dr. Strangelove doesn't pull punches about nuclear war absurdity.
442
+
443
+ ---
444
+
445
+ ### Pitfall 3: Unclear Target
446
+
447
+ **Problem**: Audience can't tell what's being satirized or why.
448
+
449
+ **Solution**: Maintain clear focus on specific target. Make critique obvious.
450
+
451
+ **Example**: Thank You for Smoking clearly satirizes spin culture and lobbying.
452
+
453
+ ---
454
+
455
+ ### Pitfall 4: Mean-Spirited Cruelty
456
+
457
+ **Problem**: Satire becomes cruel mockery without insight or purpose.
458
+
459
+ **Solution**: Satirize institutions and behaviors, not individuals. Maintain humanity.
460
+
461
+ **Example**: In the Loop satirizes political system, not specific real politicians.
462
+
463
+ ---
464
+
465
+ ### Pitfall 5: Dating Quickly
466
+
467
+ **Problem**: Topical satire becomes irrelevant as targets change.
468
+
469
+ **Solution**: Focus on timeless human folly and institutional problems, not just current events.
470
+
471
+ **Example**: Network remains relevant decades later because it satirizes timeless media issues.
472
+
473
+ ---
474
+
475
+ ## Best Practices
476
+
477
+ 1. **Know your target** - Research what you're satirizing thoroughly
478
+ 2. **Exaggerate truthfully** - Base absurdity on real observations
479
+ 3. **Maintain internal logic** - Even absurd worlds need consistent rules
480
+ 4. **Balance humor and critique** - Entertain while making points
481
+ 5. **Respect audience intelligence** - Trust them to get the satire
482
+ 6. **Be fearless** - Satire requires courage to offend
483
+ 7. **Show, don't preach** - Let situations reveal absurdity
484
+ 8. **Find universal truths** - Satirize timeless human folly
485
+
486
+ ## Resources
487
+
488
+ - "Satire: A Critical Reintroduction" by Dustin Griffin - Theory of satire
489
+ - "The Anatomy of Satire" by Gilbert Highet - Classical satirical techniques
490
+ - "Dr. Strangelove" screenplay by Stanley Kubrick, Terry Southern, Peter George - Master class
491
+ - "Network" screenplay by Paddy Chayefsky - Prophetic media satire
492
+ - "In the Loop" screenplay by Jesse Armstrong, Simon Blackwell, Armando Iannucci, Tony Roche - Political satire
493
+
494
+ ---
495
+
496
+ **Depth Coverage**: 85%
497
+ **Last Updated**: 2026-01-31
498
+ **Version**: 1.0.0
499
+