@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,489 +1,489 @@
1
- # Revenge Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- The revenge theme explores the destructive and transformative power of seeking retribution for wrongs committed. It examines the moral complexity of vengeance, asking whether revenge brings justice or perpetuates cycles of violence, and what it costs the person who pursues it.
10
-
11
- ## Core Concept
12
-
13
- Revenge in storytelling represents the primal human desire for justice when the system fails or when wrongs are too personal for institutional resolution. It explores the transformation that occurs when someone dedicates themselves to retribution, examining whether revenge satisfies or destroys, whether it's justice or just another crime, and what happens to someone who lives for vengeance.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of revenge explores whether retribution brings justice or perpetuates violence, examining the cost of vengeance to the avenger's soul and whether revenge can ever truly satisfy the need for justice.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Make the Wrong Personal and Devastating
22
-
23
- **Description**: The inciting wrong must be severe enough to justify the protagonist's obsession with revenge. The audience must understand why revenge becomes the character's sole purpose.
24
-
25
- **Why It Matters**: Revenge for minor slights feels petty. The wrong must be devastating enough that the audience understands (even if they don't condone) the desire for vengeance.
26
-
27
- **Application**:
28
- - **Act I**: Establish what the protagonist loses (loved ones, innocence, identity, everything)
29
- - **Act II**: Show how the wrong continues to haunt and define the protagonist
30
- - **Act III**: Resolve whether revenge addresses or perpetuates the original wound
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *Kill Bill*, the Bride's entire wedding party is murdered and her unborn child is taken—a wrong so devastating that her quest for revenge feels inevitable
34
- - ❌ **Bad**: A character seeks elaborate revenge for a minor insult or easily resolved conflict
35
-
36
- ---
37
-
38
- ### Rule 2: Show the Cost of Revenge
39
-
40
- **Description**: Revenge must exact a terrible price from the avenger—their humanity, relationships, morality, or life itself. The pursuit of vengeance transforms and often destroys.
41
-
42
- **Why It Matters**: Revenge without cost feels like simple justice. The price demonstrates the moral complexity and destructive nature of vengeance.
43
-
44
- **Application**:
45
- - **Act I**: Establish what the character values (morality, relationships, peace)
46
- - **Act II**: Show revenge forcing the character to sacrifice these values
47
- - **Act III**: Demonstrate the ultimate cost—what revenge has taken from the avenger
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *Oldboy*, Oh Dae-su's revenge quest leads him to commit incest unknowingly, destroying him even as he achieves vengeance
51
- - ❌ **Bad**: The character gets revenge without any moral compromise or personal cost
52
-
53
- ---
54
-
55
- ### Rule 3: Create Moral Ambiguity
56
-
57
- **Description**: Revenge stories should question whether vengeance is justice or just another crime. The audience should feel conflicted about whether the revenge is justified.
58
-
59
- **Why It Matters**: Clear-cut moral revenge is just heroism. True revenge themes explore the gray area between justice and murder.
60
-
61
- **Application**:
62
- - **Act I**: Establish the wrong and the protagonist's initial moral state
63
- - **Act II**: Show the protagonist crossing moral lines in pursuit of revenge
64
- - **Act III**: Leave the audience questioning whether the revenge was worth it
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *The Count of Monte Cristo*, Edmond Dantès' elaborate revenge destroys innocent people along with the guilty, raising questions about justice
68
- - ❌ **Bad**: The villain is so evil that killing them feels like pure heroism with no moral complexity
69
-
70
- ---
71
-
72
- ### Rule 4: Transform the Avenger
73
-
74
- **Description**: The pursuit of revenge must fundamentally change the protagonist. They cannot remain the same person they were before the wrong.
75
-
76
- **Why It Matters**: Revenge is a transformative obsession. Characters who pursue it become different people—harder, colder, more violent.
77
-
78
- **Application**:
79
- - **Act I**: Establish the character's original personality and values
80
- - **Act II**: Show gradual transformation as revenge consumes them
81
- - **Act III**: Demonstrate how different they've become, for better or worse
82
-
83
- **Examples**:
84
- - ✅ **Good**: The Bride in *Kill Bill* transforms from a pregnant bride to a ruthless killer, losing her softness in pursuit of vengeance
85
- - ❌ **Bad**: The character pursues revenge but remains fundamentally unchanged
86
-
87
- ---
88
-
89
- ### Rule 5: Question Whether Revenge Satisfies
90
-
91
- **Description**: Revenge stories should explore whether achieving vengeance actually brings the satisfaction, closure, or justice the avenger seeks.
92
-
93
- **Why It Matters**: The central question of revenge is whether it's worth it. The answer is rarely simple.
94
-
95
- **Application**:
96
- - **Act I**: Establish the avenger's belief that revenge will bring peace or justice
97
- - **Act II**: Show moments of doubt about whether revenge will satisfy
98
- - **Act III**: Reveal whether revenge brings satisfaction, emptiness, or something unexpected
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *Oldboy*, revenge brings only horror and regret, not satisfaction
102
- - ❌ **Bad**: Revenge brings complete satisfaction and closure with no complications
103
-
104
- ---
105
-
106
- ### Rule 6: Create a Worthy Adversary
107
-
108
- **Description**: The target of revenge must be formidable enough to make the quest difficult and dangerous. Easy revenge lacks dramatic power.
109
-
110
- **Why It Matters**: The difficulty of achieving revenge demonstrates the avenger's commitment and creates dramatic tension.
111
-
112
- **Application**:
113
- - **Act I**: Establish the target's power, resources, or protection
114
- - **Act II**: Show the target actively opposing the avenger, creating escalating conflict
115
- - **Act III**: Make the final confrontation a true test of the avenger's transformation
116
-
117
- **Examples**:
118
- - ✅ **Good**: Bill in *Kill Bill* is a legendary assassin, making the Bride's quest genuinely dangerous
119
- - ❌ **Bad**: The target is easily accessible and defeated without significant challenge
120
-
121
- ---
122
-
123
- ### Rule 7: Explore the Cycle of Violence
124
-
125
- **Description**: Revenge often perpetuates cycles of violence. The avenger's actions may create new victims who seek their own revenge.
126
-
127
- **Why It Matters**: This explores the broader moral implications of revenge beyond the individual story.
128
-
129
- **Application**:
130
- - **Act I**: Establish the original cycle of violence (if applicable)
131
- - **Act II**: Show how the avenger's actions affect innocent people or create new enemies
132
- - **Act III**: Address whether the cycle continues or is broken
133
-
134
- **Examples**:
135
- - ✅ **Good**: In *Kill Bill Vol. 2*, Vernita Green's daughter witnesses her mother's death, potentially creating a future avenger
136
- - ❌ **Bad**: Revenge has no consequences beyond the immediate target
137
-
138
- ---
139
-
140
- ### Rule 8: Consider Alternatives to Revenge
141
-
142
- **Description**: The story should present alternatives to revenge (forgiveness, justice system, moving on) to make the choice of vengeance meaningful.
143
-
144
- **Why It Matters**: Revenge is only dramatically interesting if it's a choice among options, not the only path.
145
-
146
- **Application**:
147
- - **Act I**: Establish possible alternatives to revenge
148
- - **Act II**: Show the protagonist rejecting alternatives in favor of vengeance
149
- - **Act III**: Reflect on whether the alternative path might have been better
150
-
151
- **Examples**:
152
- - ✅ **Good**: In *The Count of Monte Cristo*, Dantès could have simply revealed the truth and let justice take its course, but chooses elaborate revenge instead
153
- - ❌ **Bad**: Revenge is presented as the only possible response with no alternatives considered
154
-
155
- ---
156
-
157
- ## Integration Guidelines
158
-
159
- ### Act I: Setup
160
-
161
- **Thematic Introduction**:
162
- - Establish the protagonist's life before the wrong
163
- - Show the devastating wrong that incites the revenge quest
164
- - Demonstrate the protagonist's initial response (grief, rage, despair)
165
- - Plant the seed of revenge as a possibility
166
-
167
- **Character Connection**:
168
- - Show the protagonist's original moral state and values
169
- - Establish what they're willing to do (or not do) before the wrong
170
- - Demonstrate their capacity for violence or their initial pacifism
171
-
172
- **Visual/Symbolic Introduction**:
173
- - Use visual motifs representing violence, blood, weapons
174
- - Establish symbolic objects connected to the wrong (photographs, weapons, locations)
175
- - Create visual language for the protagonist's transformation (appearance, posture, eyes)
176
-
177
- ### Act II: Development
178
-
179
- **Thematic Exploration**:
180
- - Show the protagonist's transformation as revenge consumes them
181
- - Create escalating violence as they pursue their target
182
- - Introduce moral complications and innocent casualties
183
- - Test the protagonist's commitment with setbacks and doubts
184
-
185
- **Subtext Techniques**:
186
- - Use dialogue that reveals the protagonist's changing morality
187
- - Show physical transformation (scars, hardness, weapon proficiency)
188
- - Create visual progression toward darkness and violence
189
- - Use other characters' reactions to show the protagonist's change
190
-
191
- **Thematic Complications**:
192
- - The protagonist must cross moral lines they never thought they would
193
- - Innocent people are harmed in the pursuit of revenge
194
- - Relationships are destroyed by the obsession with vengeance
195
- - Moments of doubt about whether revenge is worth the cost
196
-
197
- ### Act III: Resolution
198
-
199
- **Thematic Payoff**:
200
- - Present the final confrontation with the target
201
- - Require ultimate choice about how far the protagonist will go
202
- - Reveal whether revenge brings satisfaction or emptiness
203
- - Demonstrate the total cost of the revenge quest
204
-
205
- **Avoiding Preachiness**:
206
- - Let the consequences speak for themselves
207
- - Avoid characters explicitly stating "revenge is wrong" or "revenge is right"
208
- - Show the complexity through action and outcome
209
- - Allow for ambiguity—revenge can be both satisfying and destructive
210
-
211
- ## Character Connection
212
-
213
- ### Protagonist
214
-
215
- **Thematic Relationship**: The protagonist is defined by their quest for revenge. Their entire arc is the transformation from victim to avenger and the cost of that transformation.
216
-
217
- **Arc Integration**: The character arc IS the revenge arc. Every choice, every action, every sacrifice relates to the pursuit of vengeance.
218
-
219
- **Key Moments**:
220
- - **Thematic Introduction**: The moment of the devastating wrong that incites revenge
221
- - **Thematic Challenge**: The moment they must cross a moral line to continue their quest
222
- - **Thematic Resolution**: The final confrontation and the revelation of whether revenge satisfies
223
-
224
- ### Antagonist
225
-
226
- **Thematic Opposition**: The antagonist is the target of revenge, but may also represent the protagonist's potential future—what they could become if revenge consumes them completely.
227
-
228
- **Thematic Function**: The antagonist tests the protagonist's commitment and forces them to become more like their enemy to achieve revenge.
229
-
230
- ### Supporting Characters
231
-
232
- **Thematic Mirrors**: Supporting characters represent different responses to the revenge theme:
233
- - The voice of reason who urges forgiveness or legal justice
234
- - The fellow avenger who shows what complete obsession looks like
235
- - The innocent victim of the protagonist's revenge, showing the cost
236
- - The mentor who either enables or tries to prevent the revenge
237
-
238
- **Thematic Perspectives**: Different characters embody different beliefs about revenge—whether it's justice, whether it's worth the cost, whether it perpetuates violence.
239
-
240
- ## Subtext Techniques
241
-
242
- ### Dialogue
243
-
244
- - Characters discuss justice, fairness, and retribution without explicitly mentioning "revenge"
245
- - Use metaphors of debt, balance, and payment
246
- - Create conversations where the protagonist justifies increasingly extreme actions
247
- - Include moments where others question the protagonist's path
248
-
249
- ### Visual Storytelling
250
-
251
- - **Visual motifs**: Blood, weapons, scars, darkness
252
- - **Color palette**: Progression from normal colors to darker, more violent tones
253
- - **Symbolic imagery**: Weapons as extensions of the avenger, blood as moral stain
254
- - **Physical transformation**: Show the protagonist becoming harder, scarred, more dangerous
255
-
256
- ### Action and Behavior
257
-
258
- - Show increasing violence and ruthlessness
259
- - Demonstrate the protagonist sacrificing relationships and values
260
- - Create moments where the protagonist doesn't recognize themselves
261
- - Show physical changes (scars, weapon proficiency, cold eyes)
262
-
263
- ## Film Examples
264
-
265
- ### Example 1: Kill Bill Vol. 1 & 2 (2003-2004)
266
-
267
- **Director**: Quentin Tarantino
268
-
269
- **Thematic Exploration**: Explores revenge as both a justified quest and a destructive obsession, examining what it costs to become a killer and whether revenge brings closure.
270
-
271
- **Key Thematic Moments**:
272
- - **The wedding massacre**: Establishes the devastating wrong that justifies the Bride's quest
273
- - **The hospital scene**: Shows the Bride's ruthlessness and transformation
274
- - **Vernita Green's death**: Introduces the cycle of violence (her daughter witnesses)
275
- - **O-Ren Ishii's death**: Demonstrates the Bride's complete transformation into a killer
276
- - **Bill's death**: Reveals that revenge brings sadness, not satisfaction
277
-
278
- **Thematic Resolution**: Revenge is achieved but brings complex emotions—satisfaction mixed with loss and the knowledge that violence has consumed years of the Bride's life.
279
-
280
- **Techniques Used**:
281
- - Visual style emphasizing violence and blood
282
- - Chapter structure allowing methodical revenge
283
- - Flashbacks revealing the depth of the wrong
284
- - The Bride's physical transformation (from bride to killer)
285
- - Ambiguous ending (daughter as future avenger)
286
-
287
- ---
288
-
289
- ### Example 2: The Count of Monte Cristo (2002 / Multiple Adaptations)
290
-
291
- **Director**: Kevin Reynolds (2002 version)
292
-
293
- **Thematic Exploration**: Explores elaborate, calculated revenge versus impulsive vengeance, examining whether revenge brings justice or just perpetuates suffering.
294
-
295
- **Key Thematic Moments**:
296
- - **The betrayal**: Edmond's friends destroy his life for petty reasons
297
- - **Prison transformation**: Edmond becomes educated and hardened
298
- - **The treasure**: Provides means for elaborate revenge
299
- - **Mercedes' recognition**: Forces Edmond to confront what he's become
300
- - **Albert's near-duel**: Innocent people are harmed by Edmond's revenge
301
-
302
- **Thematic Resolution**: Edmond realizes revenge has made him cruel and nearly destroyed innocent lives. He chooses mercy over complete vengeance.
303
-
304
- **Techniques Used**:
305
- - Dual timeline (before and after transformation)
306
- - Elaborate schemes showing the planning of revenge
307
- - Innocent casualties raising moral questions
308
- - Love interest as moral compass
309
- - Redemption through mercy
310
-
311
- ---
312
-
313
- ### Example 3: Oldboy (2003)
314
-
315
- **Director**: Park Chan-wook
316
-
317
- **Thematic Exploration**: Explores revenge as a trap, examining how the pursuit of vengeance can lead to self-destruction and how revenge can be turned against the avenger.
318
-
319
- **Key Thematic Moments**:
320
- - **The imprisonment**: Oh Dae-su's mysterious 15-year captivity
321
- - **The release**: His obsessive quest to understand why
322
- - **The violence**: Oh Dae-su's brutal methods showing his transformation
323
- - **The revelation**: The revenge was against him all along
324
- - **The incest**: Ultimate horror—his revenge quest led him to commit the unthinkable
325
-
326
- **Thematic Resolution**: Revenge destroys everyone involved. Oh Dae-su achieves his revenge but is utterly destroyed by the revelation of what he's done.
327
-
328
- **Techniques Used**:
329
- - Mystery structure (who and why)
330
- - Extreme violence showing transformation
331
- - Twist revealing revenge within revenge
332
- - Hypnosis ending suggesting the impossibility of escaping revenge's consequences
333
- - Moral horror rather than physical horror as ultimate cost
334
-
335
- ---
336
-
337
- ### Example 4: Gladiator (2000)
338
-
339
- **Director**: Ridley Scott
340
-
341
- **Thematic Exploration**: Explores revenge in the context of honor and justice, examining whether personal vengeance can align with broader justice.
342
-
343
- **Key Thematic Moments**:
344
- - **Family's murder**: Establishes the devastating wrong
345
- - **Slavery**: Maximus' fall from general to slave
346
- - **"My name is Maximus"**: Revelation of identity and revenge motive
347
- - **The arena**: Using the system to pursue revenge
348
- - **Final duel**: Achieving revenge but at the cost of his life
349
-
350
- **Thematic Resolution**: Revenge is achieved and brings some satisfaction, but costs Maximus his life. His revenge also serves broader justice by removing a tyrant.
351
-
352
- **Techniques Used**:
353
- - Visual contrast (general to slave to gladiator)
354
- - Arena as metaphor for revenge (public spectacle)
355
- - Dreams of family showing what's lost
356
- - Revenge aligned with justice (removing tyrant)
357
- - Death as price of revenge
358
-
359
- ---
360
-
361
- ### Example 5: Blue Ruin (2013)
362
-
363
- **Director**: Jeremy Saulnier
364
-
365
- **Thematic Exploration**: Explores revenge pursued by someone unprepared for violence, examining the reality of vengeance versus the fantasy.
366
-
367
- **Key Thematic Moments**:
368
- - **Dwight's homeless state**: Shows how the original wrong destroyed his life
369
- - **The first kill**: Messy, difficult, not satisfying
370
- - **The escalation**: Dwight's incompetence leads to more violence
371
- - **Family involvement**: Innocent people drawn into the cycle
372
- - **The final confrontation**: Dwight achieves revenge but loses everything
373
-
374
- **Thematic Resolution**: Revenge brings no satisfaction, only more death and loss. The cycle of violence continues.
375
-
376
- **Techniques Used**:
377
- - Realistic violence (messy, difficult, unglamorous)
378
- - Protagonist's incompetence showing revenge isn't heroic
379
- - Escalating consequences
380
- - Minimal dialogue emphasizing action and consequence
381
- - Bleak ending showing revenge's futility
382
-
383
- ---
384
-
385
- ## Integration with Other Features
386
-
387
- ### Compatible Genres
388
-
389
- - **Action**: Revenge provides motivation for spectacular violence
390
- - **Thriller**: The hunt for revenge creates suspense
391
- - **Drama**: Explores the moral and emotional complexity of revenge
392
- - **Western**: Classic revenge narratives in frontier justice settings
393
- - **Crime**: Revenge within criminal underworlds
394
- - **Historical**: Revenge in contexts where formal justice doesn't exist
395
-
396
- ### Compatible Themes (Multi-Theme Stories)
397
-
398
- - **Justice**: Revenge as alternative to or perversion of justice
399
- - **Redemption**: Can the avenger be redeemed after revenge?
400
- - **Sacrifice**: What must be sacrificed to achieve revenge?
401
- - **Identity**: Revenge transforms identity
402
- - **Power**: Revenge as reclaiming power from those who took it
403
- - **Betrayal**: Often the inciting wrong for revenge
404
-
405
- ### Compatible Styles
406
-
407
- - **Action-Driven**: Emphasizes the physical pursuit of revenge
408
- - **Character-Driven**: Explores the psychological transformation
409
- - **Non-Linear**: Flashbacks reveal the wrong and its impact
410
- - **Minimalist**: Focuses on the essential elements of revenge
411
-
412
- ## Common Pitfalls
413
-
414
- ### Pitfall 1: Making Revenge Too Easy
415
-
416
- **Problem**: The protagonist achieves revenge without significant cost, challenge, or moral compromise.
417
-
418
- **Solution**: Make revenge difficult, costly, and morally complex.
419
-
420
- **Example**: The protagonist must sacrifice relationships, morality, or life itself to achieve revenge.
421
-
422
- ---
423
-
424
- ### Pitfall 2: Clear-Cut Morality
425
-
426
- **Problem**: The villain is so evil that revenge feels like pure heroism with no moral ambiguity.
427
-
428
- **Solution**: Create moral complexity—innocent casualties, questionable methods, or sympathetic aspects to the target.
429
-
430
- **Example**: The revenge harms innocent people or requires the protagonist to become like their enemy.
431
-
432
- ---
433
-
434
- ### Pitfall 3: Revenge Without Transformation
435
-
436
- **Problem**: The character pursues revenge but remains fundamentally unchanged.
437
-
438
- **Solution**: Show how revenge transforms the protagonist, usually making them harder, colder, more violent.
439
-
440
- **Example**: The protagonist becomes unrecognizable to loved ones, having sacrificed their humanity for vengeance.
441
-
442
- ---
443
-
444
- ### Pitfall 4: Instant Satisfaction
445
-
446
- **Problem**: Revenge immediately brings complete satisfaction and closure.
447
-
448
- **Solution**: Show revenge as complex—it may bring some satisfaction but also emptiness, regret, or new problems.
449
-
450
- **Example**: After achieving revenge, the protagonist feels empty or realizes they've wasted years on vengeance.
451
-
452
- ---
453
-
454
- ### Pitfall 5: No Alternatives Considered
455
-
456
- **Problem**: Revenge is presented as the only possible response.
457
-
458
- **Solution**: Show alternatives (forgiveness, legal justice, moving on) to make the choice of revenge meaningful.
459
-
460
- **Example**: Characters suggest alternatives that the protagonist rejects, showing revenge is a choice.
461
-
462
- ---
463
-
464
- ## Best Practices
465
-
466
- 1. **Make the wrong devastating** - The inciting wrong must justify the obsession with revenge
467
- 2. **Show the cost** - Revenge must exact a terrible price from the avenger
468
- 3. **Create moral ambiguity** - Question whether revenge is justice or just another crime
469
- 4. **Transform the avenger** - Revenge must fundamentally change the protagonist
470
- 5. **Question satisfaction** - Explore whether revenge actually brings what the avenger seeks
471
- 6. **Create worthy adversaries** - Make revenge difficult and dangerous to achieve
472
- 7. **Explore the cycle** - Show how revenge perpetuates violence
473
- 8. **Consider alternatives** - Present other options to make revenge a meaningful choice
474
- 9. **Use visual storytelling** - Show transformation through imagery and symbolism
475
- 10. **Avoid preachiness** - Let consequences speak rather than moral pronouncements
476
-
477
- ## Resources
478
-
479
- - *Hamlet* by William Shakespeare - Classic revenge tragedy exploring moral complexity
480
- - *The Anatomy of Story* by John Truby - Discusses revenge as a story type
481
- - *Save the Cat!* by Blake Snyder - Covers revenge plots ("Dude with a Problem")
482
- - *Story* by Robert McKee - Explores revenge narratives and their moral dimensions
483
- - *The Writer's Journey* by Christopher Vogler - Discusses revenge within the hero's journey
484
-
485
- ---
486
-
487
- **Depth Coverage**: 85%
488
- **Last Updated**: 2026-01-31
489
- **Version**: 1.0.0
1
+ # Revenge Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ The revenge theme explores the destructive and transformative power of seeking retribution for wrongs committed. It examines the moral complexity of vengeance, asking whether revenge brings justice or perpetuates cycles of violence, and what it costs the person who pursues it.
10
+
11
+ ## Core Concept
12
+
13
+ Revenge in storytelling represents the primal human desire for justice when the system fails or when wrongs are too personal for institutional resolution. It explores the transformation that occurs when someone dedicates themselves to retribution, examining whether revenge satisfies or destroys, whether it's justice or just another crime, and what happens to someone who lives for vengeance.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of revenge explores whether retribution brings justice or perpetuates violence, examining the cost of vengeance to the avenger's soul and whether revenge can ever truly satisfy the need for justice.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Make the Wrong Personal and Devastating
22
+
23
+ **Description**: The inciting wrong must be severe enough to justify the protagonist's obsession with revenge. The audience must understand why revenge becomes the character's sole purpose.
24
+
25
+ **Why It Matters**: Revenge for minor slights feels petty. The wrong must be devastating enough that the audience understands (even if they don't condone) the desire for vengeance.
26
+
27
+ **Application**:
28
+ - **Act I**: Establish what the protagonist loses (loved ones, innocence, identity, everything)
29
+ - **Act II**: Show how the wrong continues to haunt and define the protagonist
30
+ - **Act III**: Resolve whether revenge addresses or perpetuates the original wound
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *Kill Bill*, the Bride's entire wedding party is murdered and her unborn child is taken—a wrong so devastating that her quest for revenge feels inevitable
34
+ - ❌ **Bad**: A character seeks elaborate revenge for a minor insult or easily resolved conflict
35
+
36
+ ---
37
+
38
+ ### Rule 2: Show the Cost of Revenge
39
+
40
+ **Description**: Revenge must exact a terrible price from the avenger—their humanity, relationships, morality, or life itself. The pursuit of vengeance transforms and often destroys.
41
+
42
+ **Why It Matters**: Revenge without cost feels like simple justice. The price demonstrates the moral complexity and destructive nature of vengeance.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish what the character values (morality, relationships, peace)
46
+ - **Act II**: Show revenge forcing the character to sacrifice these values
47
+ - **Act III**: Demonstrate the ultimate cost—what revenge has taken from the avenger
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *Oldboy*, Oh Dae-su's revenge quest leads him to commit incest unknowingly, destroying him even as he achieves vengeance
51
+ - ❌ **Bad**: The character gets revenge without any moral compromise or personal cost
52
+
53
+ ---
54
+
55
+ ### Rule 3: Create Moral Ambiguity
56
+
57
+ **Description**: Revenge stories should question whether vengeance is justice or just another crime. The audience should feel conflicted about whether the revenge is justified.
58
+
59
+ **Why It Matters**: Clear-cut moral revenge is just heroism. True revenge themes explore the gray area between justice and murder.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish the wrong and the protagonist's initial moral state
63
+ - **Act II**: Show the protagonist crossing moral lines in pursuit of revenge
64
+ - **Act III**: Leave the audience questioning whether the revenge was worth it
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *The Count of Monte Cristo*, Edmond Dantès' elaborate revenge destroys innocent people along with the guilty, raising questions about justice
68
+ - ❌ **Bad**: The villain is so evil that killing them feels like pure heroism with no moral complexity
69
+
70
+ ---
71
+
72
+ ### Rule 4: Transform the Avenger
73
+
74
+ **Description**: The pursuit of revenge must fundamentally change the protagonist. They cannot remain the same person they were before the wrong.
75
+
76
+ **Why It Matters**: Revenge is a transformative obsession. Characters who pursue it become different people—harder, colder, more violent.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish the character's original personality and values
80
+ - **Act II**: Show gradual transformation as revenge consumes them
81
+ - **Act III**: Demonstrate how different they've become, for better or worse
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: The Bride in *Kill Bill* transforms from a pregnant bride to a ruthless killer, losing her softness in pursuit of vengeance
85
+ - ❌ **Bad**: The character pursues revenge but remains fundamentally unchanged
86
+
87
+ ---
88
+
89
+ ### Rule 5: Question Whether Revenge Satisfies
90
+
91
+ **Description**: Revenge stories should explore whether achieving vengeance actually brings the satisfaction, closure, or justice the avenger seeks.
92
+
93
+ **Why It Matters**: The central question of revenge is whether it's worth it. The answer is rarely simple.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish the avenger's belief that revenge will bring peace or justice
97
+ - **Act II**: Show moments of doubt about whether revenge will satisfy
98
+ - **Act III**: Reveal whether revenge brings satisfaction, emptiness, or something unexpected
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *Oldboy*, revenge brings only horror and regret, not satisfaction
102
+ - ❌ **Bad**: Revenge brings complete satisfaction and closure with no complications
103
+
104
+ ---
105
+
106
+ ### Rule 6: Create a Worthy Adversary
107
+
108
+ **Description**: The target of revenge must be formidable enough to make the quest difficult and dangerous. Easy revenge lacks dramatic power.
109
+
110
+ **Why It Matters**: The difficulty of achieving revenge demonstrates the avenger's commitment and creates dramatic tension.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish the target's power, resources, or protection
114
+ - **Act II**: Show the target actively opposing the avenger, creating escalating conflict
115
+ - **Act III**: Make the final confrontation a true test of the avenger's transformation
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: Bill in *Kill Bill* is a legendary assassin, making the Bride's quest genuinely dangerous
119
+ - ❌ **Bad**: The target is easily accessible and defeated without significant challenge
120
+
121
+ ---
122
+
123
+ ### Rule 7: Explore the Cycle of Violence
124
+
125
+ **Description**: Revenge often perpetuates cycles of violence. The avenger's actions may create new victims who seek their own revenge.
126
+
127
+ **Why It Matters**: This explores the broader moral implications of revenge beyond the individual story.
128
+
129
+ **Application**:
130
+ - **Act I**: Establish the original cycle of violence (if applicable)
131
+ - **Act II**: Show how the avenger's actions affect innocent people or create new enemies
132
+ - **Act III**: Address whether the cycle continues or is broken
133
+
134
+ **Examples**:
135
+ - ✅ **Good**: In *Kill Bill Vol. 2*, Vernita Green's daughter witnesses her mother's death, potentially creating a future avenger
136
+ - ❌ **Bad**: Revenge has no consequences beyond the immediate target
137
+
138
+ ---
139
+
140
+ ### Rule 8: Consider Alternatives to Revenge
141
+
142
+ **Description**: The story should present alternatives to revenge (forgiveness, justice system, moving on) to make the choice of vengeance meaningful.
143
+
144
+ **Why It Matters**: Revenge is only dramatically interesting if it's a choice among options, not the only path.
145
+
146
+ **Application**:
147
+ - **Act I**: Establish possible alternatives to revenge
148
+ - **Act II**: Show the protagonist rejecting alternatives in favor of vengeance
149
+ - **Act III**: Reflect on whether the alternative path might have been better
150
+
151
+ **Examples**:
152
+ - ✅ **Good**: In *The Count of Monte Cristo*, Dantès could have simply revealed the truth and let justice take its course, but chooses elaborate revenge instead
153
+ - ❌ **Bad**: Revenge is presented as the only possible response with no alternatives considered
154
+
155
+ ---
156
+
157
+ ## Integration Guidelines
158
+
159
+ ### Act I: Setup
160
+
161
+ **Thematic Introduction**:
162
+ - Establish the protagonist's life before the wrong
163
+ - Show the devastating wrong that incites the revenge quest
164
+ - Demonstrate the protagonist's initial response (grief, rage, despair)
165
+ - Plant the seed of revenge as a possibility
166
+
167
+ **Character Connection**:
168
+ - Show the protagonist's original moral state and values
169
+ - Establish what they're willing to do (or not do) before the wrong
170
+ - Demonstrate their capacity for violence or their initial pacifism
171
+
172
+ **Visual/Symbolic Introduction**:
173
+ - Use visual motifs representing violence, blood, weapons
174
+ - Establish symbolic objects connected to the wrong (photographs, weapons, locations)
175
+ - Create visual language for the protagonist's transformation (appearance, posture, eyes)
176
+
177
+ ### Act II: Development
178
+
179
+ **Thematic Exploration**:
180
+ - Show the protagonist's transformation as revenge consumes them
181
+ - Create escalating violence as they pursue their target
182
+ - Introduce moral complications and innocent casualties
183
+ - Test the protagonist's commitment with setbacks and doubts
184
+
185
+ **Subtext Techniques**:
186
+ - Use dialogue that reveals the protagonist's changing morality
187
+ - Show physical transformation (scars, hardness, weapon proficiency)
188
+ - Create visual progression toward darkness and violence
189
+ - Use other characters' reactions to show the protagonist's change
190
+
191
+ **Thematic Complications**:
192
+ - The protagonist must cross moral lines they never thought they would
193
+ - Innocent people are harmed in the pursuit of revenge
194
+ - Relationships are destroyed by the obsession with vengeance
195
+ - Moments of doubt about whether revenge is worth the cost
196
+
197
+ ### Act III: Resolution
198
+
199
+ **Thematic Payoff**:
200
+ - Present the final confrontation with the target
201
+ - Require ultimate choice about how far the protagonist will go
202
+ - Reveal whether revenge brings satisfaction or emptiness
203
+ - Demonstrate the total cost of the revenge quest
204
+
205
+ **Avoiding Preachiness**:
206
+ - Let the consequences speak for themselves
207
+ - Avoid characters explicitly stating "revenge is wrong" or "revenge is right"
208
+ - Show the complexity through action and outcome
209
+ - Allow for ambiguity—revenge can be both satisfying and destructive
210
+
211
+ ## Character Connection
212
+
213
+ ### Protagonist
214
+
215
+ **Thematic Relationship**: The protagonist is defined by their quest for revenge. Their entire arc is the transformation from victim to avenger and the cost of that transformation.
216
+
217
+ **Arc Integration**: The character arc IS the revenge arc. Every choice, every action, every sacrifice relates to the pursuit of vengeance.
218
+
219
+ **Key Moments**:
220
+ - **Thematic Introduction**: The moment of the devastating wrong that incites revenge
221
+ - **Thematic Challenge**: The moment they must cross a moral line to continue their quest
222
+ - **Thematic Resolution**: The final confrontation and the revelation of whether revenge satisfies
223
+
224
+ ### Antagonist
225
+
226
+ **Thematic Opposition**: The antagonist is the target of revenge, but may also represent the protagonist's potential future—what they could become if revenge consumes them completely.
227
+
228
+ **Thematic Function**: The antagonist tests the protagonist's commitment and forces them to become more like their enemy to achieve revenge.
229
+
230
+ ### Supporting Characters
231
+
232
+ **Thematic Mirrors**: Supporting characters represent different responses to the revenge theme:
233
+ - The voice of reason who urges forgiveness or legal justice
234
+ - The fellow avenger who shows what complete obsession looks like
235
+ - The innocent victim of the protagonist's revenge, showing the cost
236
+ - The mentor who either enables or tries to prevent the revenge
237
+
238
+ **Thematic Perspectives**: Different characters embody different beliefs about revenge—whether it's justice, whether it's worth the cost, whether it perpetuates violence.
239
+
240
+ ## Subtext Techniques
241
+
242
+ ### Dialogue
243
+
244
+ - Characters discuss justice, fairness, and retribution without explicitly mentioning "revenge"
245
+ - Use metaphors of debt, balance, and payment
246
+ - Create conversations where the protagonist justifies increasingly extreme actions
247
+ - Include moments where others question the protagonist's path
248
+
249
+ ### Visual Storytelling
250
+
251
+ - **Visual motifs**: Blood, weapons, scars, darkness
252
+ - **Color palette**: Progression from normal colors to darker, more violent tones
253
+ - **Symbolic imagery**: Weapons as extensions of the avenger, blood as moral stain
254
+ - **Physical transformation**: Show the protagonist becoming harder, scarred, more dangerous
255
+
256
+ ### Action and Behavior
257
+
258
+ - Show increasing violence and ruthlessness
259
+ - Demonstrate the protagonist sacrificing relationships and values
260
+ - Create moments where the protagonist doesn't recognize themselves
261
+ - Show physical changes (scars, weapon proficiency, cold eyes)
262
+
263
+ ## Film Examples
264
+
265
+ ### Example 1: Kill Bill Vol. 1 & 2 (2003-2004)
266
+
267
+ **Director**: Quentin Tarantino
268
+
269
+ **Thematic Exploration**: Explores revenge as both a justified quest and a destructive obsession, examining what it costs to become a killer and whether revenge brings closure.
270
+
271
+ **Key Thematic Moments**:
272
+ - **The wedding massacre**: Establishes the devastating wrong that justifies the Bride's quest
273
+ - **The hospital scene**: Shows the Bride's ruthlessness and transformation
274
+ - **Vernita Green's death**: Introduces the cycle of violence (her daughter witnesses)
275
+ - **O-Ren Ishii's death**: Demonstrates the Bride's complete transformation into a killer
276
+ - **Bill's death**: Reveals that revenge brings sadness, not satisfaction
277
+
278
+ **Thematic Resolution**: Revenge is achieved but brings complex emotions—satisfaction mixed with loss and the knowledge that violence has consumed years of the Bride's life.
279
+
280
+ **Techniques Used**:
281
+ - Visual style emphasizing violence and blood
282
+ - Chapter structure allowing methodical revenge
283
+ - Flashbacks revealing the depth of the wrong
284
+ - The Bride's physical transformation (from bride to killer)
285
+ - Ambiguous ending (daughter as future avenger)
286
+
287
+ ---
288
+
289
+ ### Example 2: The Count of Monte Cristo (2002 / Multiple Adaptations)
290
+
291
+ **Director**: Kevin Reynolds (2002 version)
292
+
293
+ **Thematic Exploration**: Explores elaborate, calculated revenge versus impulsive vengeance, examining whether revenge brings justice or just perpetuates suffering.
294
+
295
+ **Key Thematic Moments**:
296
+ - **The betrayal**: Edmond's friends destroy his life for petty reasons
297
+ - **Prison transformation**: Edmond becomes educated and hardened
298
+ - **The treasure**: Provides means for elaborate revenge
299
+ - **Mercedes' recognition**: Forces Edmond to confront what he's become
300
+ - **Albert's near-duel**: Innocent people are harmed by Edmond's revenge
301
+
302
+ **Thematic Resolution**: Edmond realizes revenge has made him cruel and nearly destroyed innocent lives. He chooses mercy over complete vengeance.
303
+
304
+ **Techniques Used**:
305
+ - Dual timeline (before and after transformation)
306
+ - Elaborate schemes showing the planning of revenge
307
+ - Innocent casualties raising moral questions
308
+ - Love interest as moral compass
309
+ - Redemption through mercy
310
+
311
+ ---
312
+
313
+ ### Example 3: Oldboy (2003)
314
+
315
+ **Director**: Park Chan-wook
316
+
317
+ **Thematic Exploration**: Explores revenge as a trap, examining how the pursuit of vengeance can lead to self-destruction and how revenge can be turned against the avenger.
318
+
319
+ **Key Thematic Moments**:
320
+ - **The imprisonment**: Oh Dae-su's mysterious 15-year captivity
321
+ - **The release**: His obsessive quest to understand why
322
+ - **The violence**: Oh Dae-su's brutal methods showing his transformation
323
+ - **The revelation**: The revenge was against him all along
324
+ - **The incest**: Ultimate horror—his revenge quest led him to commit the unthinkable
325
+
326
+ **Thematic Resolution**: Revenge destroys everyone involved. Oh Dae-su achieves his revenge but is utterly destroyed by the revelation of what he's done.
327
+
328
+ **Techniques Used**:
329
+ - Mystery structure (who and why)
330
+ - Extreme violence showing transformation
331
+ - Twist revealing revenge within revenge
332
+ - Hypnosis ending suggesting the impossibility of escaping revenge's consequences
333
+ - Moral horror rather than physical horror as ultimate cost
334
+
335
+ ---
336
+
337
+ ### Example 4: Gladiator (2000)
338
+
339
+ **Director**: Ridley Scott
340
+
341
+ **Thematic Exploration**: Explores revenge in the context of honor and justice, examining whether personal vengeance can align with broader justice.
342
+
343
+ **Key Thematic Moments**:
344
+ - **Family's murder**: Establishes the devastating wrong
345
+ - **Slavery**: Maximus' fall from general to slave
346
+ - **"My name is Maximus"**: Revelation of identity and revenge motive
347
+ - **The arena**: Using the system to pursue revenge
348
+ - **Final duel**: Achieving revenge but at the cost of his life
349
+
350
+ **Thematic Resolution**: Revenge is achieved and brings some satisfaction, but costs Maximus his life. His revenge also serves broader justice by removing a tyrant.
351
+
352
+ **Techniques Used**:
353
+ - Visual contrast (general to slave to gladiator)
354
+ - Arena as metaphor for revenge (public spectacle)
355
+ - Dreams of family showing what's lost
356
+ - Revenge aligned with justice (removing tyrant)
357
+ - Death as price of revenge
358
+
359
+ ---
360
+
361
+ ### Example 5: Blue Ruin (2013)
362
+
363
+ **Director**: Jeremy Saulnier
364
+
365
+ **Thematic Exploration**: Explores revenge pursued by someone unprepared for violence, examining the reality of vengeance versus the fantasy.
366
+
367
+ **Key Thematic Moments**:
368
+ - **Dwight's homeless state**: Shows how the original wrong destroyed his life
369
+ - **The first kill**: Messy, difficult, not satisfying
370
+ - **The escalation**: Dwight's incompetence leads to more violence
371
+ - **Family involvement**: Innocent people drawn into the cycle
372
+ - **The final confrontation**: Dwight achieves revenge but loses everything
373
+
374
+ **Thematic Resolution**: Revenge brings no satisfaction, only more death and loss. The cycle of violence continues.
375
+
376
+ **Techniques Used**:
377
+ - Realistic violence (messy, difficult, unglamorous)
378
+ - Protagonist's incompetence showing revenge isn't heroic
379
+ - Escalating consequences
380
+ - Minimal dialogue emphasizing action and consequence
381
+ - Bleak ending showing revenge's futility
382
+
383
+ ---
384
+
385
+ ## Integration with Other Features
386
+
387
+ ### Compatible Genres
388
+
389
+ - **Action**: Revenge provides motivation for spectacular violence
390
+ - **Thriller**: The hunt for revenge creates suspense
391
+ - **Drama**: Explores the moral and emotional complexity of revenge
392
+ - **Western**: Classic revenge narratives in frontier justice settings
393
+ - **Crime**: Revenge within criminal underworlds
394
+ - **Historical**: Revenge in contexts where formal justice doesn't exist
395
+
396
+ ### Compatible Themes (Multi-Theme Stories)
397
+
398
+ - **Justice**: Revenge as alternative to or perversion of justice
399
+ - **Redemption**: Can the avenger be redeemed after revenge?
400
+ - **Sacrifice**: What must be sacrificed to achieve revenge?
401
+ - **Identity**: Revenge transforms identity
402
+ - **Power**: Revenge as reclaiming power from those who took it
403
+ - **Betrayal**: Often the inciting wrong for revenge
404
+
405
+ ### Compatible Styles
406
+
407
+ - **Action-Driven**: Emphasizes the physical pursuit of revenge
408
+ - **Character-Driven**: Explores the psychological transformation
409
+ - **Non-Linear**: Flashbacks reveal the wrong and its impact
410
+ - **Minimalist**: Focuses on the essential elements of revenge
411
+
412
+ ## Common Pitfalls
413
+
414
+ ### Pitfall 1: Making Revenge Too Easy
415
+
416
+ **Problem**: The protagonist achieves revenge without significant cost, challenge, or moral compromise.
417
+
418
+ **Solution**: Make revenge difficult, costly, and morally complex.
419
+
420
+ **Example**: The protagonist must sacrifice relationships, morality, or life itself to achieve revenge.
421
+
422
+ ---
423
+
424
+ ### Pitfall 2: Clear-Cut Morality
425
+
426
+ **Problem**: The villain is so evil that revenge feels like pure heroism with no moral ambiguity.
427
+
428
+ **Solution**: Create moral complexity—innocent casualties, questionable methods, or sympathetic aspects to the target.
429
+
430
+ **Example**: The revenge harms innocent people or requires the protagonist to become like their enemy.
431
+
432
+ ---
433
+
434
+ ### Pitfall 3: Revenge Without Transformation
435
+
436
+ **Problem**: The character pursues revenge but remains fundamentally unchanged.
437
+
438
+ **Solution**: Show how revenge transforms the protagonist, usually making them harder, colder, more violent.
439
+
440
+ **Example**: The protagonist becomes unrecognizable to loved ones, having sacrificed their humanity for vengeance.
441
+
442
+ ---
443
+
444
+ ### Pitfall 4: Instant Satisfaction
445
+
446
+ **Problem**: Revenge immediately brings complete satisfaction and closure.
447
+
448
+ **Solution**: Show revenge as complex—it may bring some satisfaction but also emptiness, regret, or new problems.
449
+
450
+ **Example**: After achieving revenge, the protagonist feels empty or realizes they've wasted years on vengeance.
451
+
452
+ ---
453
+
454
+ ### Pitfall 5: No Alternatives Considered
455
+
456
+ **Problem**: Revenge is presented as the only possible response.
457
+
458
+ **Solution**: Show alternatives (forgiveness, legal justice, moving on) to make the choice of revenge meaningful.
459
+
460
+ **Example**: Characters suggest alternatives that the protagonist rejects, showing revenge is a choice.
461
+
462
+ ---
463
+
464
+ ## Best Practices
465
+
466
+ 1. **Make the wrong devastating** - The inciting wrong must justify the obsession with revenge
467
+ 2. **Show the cost** - Revenge must exact a terrible price from the avenger
468
+ 3. **Create moral ambiguity** - Question whether revenge is justice or just another crime
469
+ 4. **Transform the avenger** - Revenge must fundamentally change the protagonist
470
+ 5. **Question satisfaction** - Explore whether revenge actually brings what the avenger seeks
471
+ 6. **Create worthy adversaries** - Make revenge difficult and dangerous to achieve
472
+ 7. **Explore the cycle** - Show how revenge perpetuates violence
473
+ 8. **Consider alternatives** - Present other options to make revenge a meaningful choice
474
+ 9. **Use visual storytelling** - Show transformation through imagery and symbolism
475
+ 10. **Avoid preachiness** - Let consequences speak rather than moral pronouncements
476
+
477
+ ## Resources
478
+
479
+ - *Hamlet* by William Shakespeare - Classic revenge tragedy exploring moral complexity
480
+ - *The Anatomy of Story* by John Truby - Discusses revenge as a story type
481
+ - *Save the Cat!* by Blake Snyder - Covers revenge plots ("Dude with a Problem")
482
+ - *Story* by Robert McKee - Explores revenge narratives and their moral dimensions
483
+ - *The Writer's Journey* by Christopher Vogler - Discusses revenge within the hero's journey
484
+
485
+ ---
486
+
487
+ **Depth Coverage**: 85%
488
+ **Last Updated**: 2026-01-31
489
+ **Version**: 1.0.0