@mytechtoday/augment-extensions 0.4.0 → 0.7.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 (226) hide show
  1. package/README.md +6 -6
  2. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -0
  3. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -0
  4. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -0
  5. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -0
  6. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -0
  7. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -0
  8. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -0
  9. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -0
  10. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -0
  11. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -0
  12. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -0
  13. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -0
  14. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -0
  15. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -0
  16. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -0
  17. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -0
  18. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -0
  19. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -0
  20. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -0
  21. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -0
  22. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -0
  23. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -0
  24. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -0
  25. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -0
  26. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -0
  27. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -0
  28. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/README.md +136 -0
  29. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/SCHEMA-VALIDATION-REPORT.md +216 -0
  30. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/brand-kit-example.yaml +292 -0
  31. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/campaign-brief-example.yaml +389 -0
  32. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/content-calendar-example.yaml +643 -0
  33. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/email-newsletter-example.md +376 -0
  34. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/landing-page-example.md +934 -0
  35. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/ppc-ad-copy-example.md +301 -0
  36. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/seo-blog-post-example.md +347 -0
  37. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/social-media-campaign-example.md +606 -0
  38. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/module.json +50 -0
  39. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/affiliate-influencer-marketing.md +593 -0
  40. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/asset-management.md +418 -0
  41. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/brand-consistency.md +210 -0
  42. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/content-marketing.md +337 -0
  43. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/conversion-optimization.md +455 -0
  44. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/direct-sales.md +499 -0
  45. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/email-marketing.md +439 -0
  46. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/legal-compliance.md +227 -0
  47. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/ppc-advertising.md +569 -0
  48. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/seo-optimization.md +470 -0
  49. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/social-media-marketing.md +414 -0
  50. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/universal-marketing.md +177 -0
  51. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/asset-inventory.schema.json +247 -0
  52. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/brand-kit.schema.json +326 -0
  53. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/campaign-brief.schema.json +342 -0
  54. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/color-palette.schema.json +223 -0
  55. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/content-template.schema.json +383 -0
  56. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -0
  57. package/augment-extensions/workflows/beads-integration/README.md +143 -0
  58. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -0
  59. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -0
  60. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -0
  61. package/augment-extensions/workflows/beads-integration/module.json +75 -0
  62. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -0
  63. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -0
  64. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -0
  65. package/augment-extensions/writing-standards/screenplay/README.md +135 -6
  66. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -0
  67. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -0
  68. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -0
  69. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -0
  70. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -0
  71. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -0
  72. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -0
  73. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -0
  74. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -0
  75. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -0
  76. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -0
  77. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -0
  78. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -0
  79. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -0
  80. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -0
  81. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -0
  82. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -0
  83. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -0
  84. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -0
  85. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -0
  86. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -0
  87. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -0
  88. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -0
  89. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -0
  90. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -0
  91. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -0
  92. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -0
  93. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -0
  94. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -0
  95. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -0
  96. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -0
  97. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -0
  98. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -0
  99. package/augment-extensions/writing-standards/screenplay/module.json +1 -1
  100. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -0
  101. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -0
  102. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -0
  103. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -0
  104. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -0
  105. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -0
  106. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -0
  107. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -0
  108. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -0
  109. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -0
  110. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -0
  111. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -0
  112. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -0
  113. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -0
  114. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -0
  115. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -0
  116. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -0
  117. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -0
  118. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -0
  119. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -0
  120. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -0
  121. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -0
  122. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -0
  123. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -0
  124. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -0
  125. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -0
  126. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -0
  127. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -0
  128. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -0
  129. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -0
  130. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -0
  131. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -0
  132. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -0
  133. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -0
  134. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -0
  135. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -0
  136. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -0
  137. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -0
  138. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -0
  139. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -0
  140. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -0
  141. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -0
  142. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -0
  143. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -0
  144. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -0
  145. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -0
  146. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -0
  147. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -0
  148. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -0
  149. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -0
  150. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -0
  151. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -0
  152. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -0
  153. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -0
  154. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -0
  155. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -0
  156. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -0
  157. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -0
  158. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -0
  159. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -0
  160. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -0
  161. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -0
  162. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -0
  163. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -0
  164. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -0
  165. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -0
  166. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -0
  167. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -0
  168. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -0
  169. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -0
  170. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -0
  171. package/cli/dist/cli.js +30 -1
  172. package/cli/dist/cli.js.map +1 -1
  173. package/cli/dist/commands/show.d.ts +23 -0
  174. package/cli/dist/commands/show.d.ts.map +1 -1
  175. package/cli/dist/commands/show.js +928 -10
  176. package/cli/dist/commands/show.js.map +1 -1
  177. package/cli/dist/types/gui.d.ts +62 -0
  178. package/cli/dist/types/gui.d.ts.map +1 -0
  179. package/cli/dist/types/gui.js +30 -0
  180. package/cli/dist/types/gui.js.map +1 -0
  181. package/cli/dist/utils/config-system.d.ts +111 -0
  182. package/cli/dist/utils/config-system.d.ts.map +1 -0
  183. package/cli/dist/utils/config-system.js +239 -0
  184. package/cli/dist/utils/config-system.js.map +1 -0
  185. package/cli/dist/utils/gui-helpers.d.ts +23 -0
  186. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  187. package/cli/dist/utils/gui-helpers.js +159 -0
  188. package/cli/dist/utils/gui-helpers.js.map +1 -0
  189. package/cli/dist/utils/hook-system.d.ts +84 -0
  190. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  191. package/cli/dist/utils/hook-system.js +151 -0
  192. package/cli/dist/utils/hook-system.js.map +1 -0
  193. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  194. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  195. package/cli/dist/utils/inspection-cache.js +166 -0
  196. package/cli/dist/utils/inspection-cache.js.map +1 -0
  197. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  198. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  199. package/cli/dist/utils/inspection-handlers.js +171 -0
  200. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  201. package/cli/dist/utils/module-system.d.ts +81 -1
  202. package/cli/dist/utils/module-system.d.ts.map +1 -1
  203. package/cli/dist/utils/module-system.js +393 -16
  204. package/cli/dist/utils/module-system.js.map +1 -1
  205. package/cli/dist/utils/plugin-system.d.ts +133 -0
  206. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  207. package/cli/dist/utils/plugin-system.js +210 -0
  208. package/cli/dist/utils/plugin-system.js.map +1 -0
  209. package/cli/dist/utils/progress.d.ts +67 -0
  210. package/cli/dist/utils/progress.d.ts.map +1 -0
  211. package/cli/dist/utils/progress.js +146 -0
  212. package/cli/dist/utils/progress.js.map +1 -0
  213. package/cli/dist/utils/stream-reader.d.ts +34 -0
  214. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  215. package/cli/dist/utils/stream-reader.js +147 -0
  216. package/cli/dist/utils/stream-reader.js.map +1 -0
  217. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  218. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  219. package/cli/dist/utils/vscode-editor.js +171 -0
  220. package/cli/dist/utils/vscode-editor.js.map +1 -0
  221. package/cli/dist/utils/vscode-links.d.ts +49 -0
  222. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  223. package/cli/dist/utils/vscode-links.js +167 -0
  224. package/cli/dist/utils/vscode-links.js.map +1 -0
  225. package/modules.md +44 -2
  226. package/package.json +6 -4
@@ -0,0 +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