@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,490 @@
1
+ # Betrayal Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ The betrayal theme explores the breaking of trust and loyalty, examining why people betray, how betrayal damages both betrayer and betrayed, and whether trust can be rebuilt after it's broken.
10
+
11
+ ## Core Concept
12
+
13
+ Betrayal in storytelling represents the violation of trust—the moment when someone we rely on chooses their interests over loyalty. It explores the motivations for betrayal, the devastation it causes, and the question of whether forgiveness is possible or wise.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of betrayal explores why people violate trust, examining the damage betrayal causes to both parties and whether trust can ever be rebuilt after it's broken.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Establish Trust Before Breaking It
22
+
23
+ **Description**: Betrayal has no impact without established trust. The audience must believe in the relationship before it's violated.
24
+
25
+ **Why It Matters**: Betrayal of a stranger means nothing. The deeper the trust, the more powerful the betrayal.
26
+
27
+ **Application**:
28
+ - **Act I**: Establish genuine trust, loyalty, and connection between characters
29
+ - **Act II**: Show the relationship deepening before the betrayal
30
+ - **Act III**: Make the betrayal devastating because of the established trust
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *The Godfather Part II*, Fredo's betrayal devastates because of established family loyalty
34
+ - ❌ **Bad**: A character betrays someone they just met or never trusted
35
+
36
+ ---
37
+
38
+ ### Rule 2: Give the Betrayer Understandable Motivations
39
+
40
+ **Description**: Betrayal should have comprehensible motivations—fear, ambition, survival, love for another. The betrayer shouldn't be purely evil.
41
+
42
+ **Why It Matters**: Motiveless betrayal feels arbitrary. Understanding why makes it tragic rather than just villainous.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish the betrayer's values, fears, and desires
46
+ - **Act II**: Create circumstances that make betrayal tempting or seemingly necessary
47
+ - **Act III**: Show the betrayer living with consequences of their choice
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *The Departed*, Billy's "betrayal" of the mob is motivated by duty and morality
51
+ - ❌ **Bad**: A character betrays for no reason or purely out of evil
52
+
53
+ ---
54
+
55
+ ### Rule 3: Show the Cost to Both Parties
56
+
57
+ **Description**: Betrayal damages both the betrayed and the betrayer. Both should suffer consequences.
58
+
59
+ **Why It Matters**: One-sided consequences reduce complexity. Betrayal is tragic for everyone involved.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish what both characters value
63
+ - **Act II**: Show betrayal threatening these values
64
+ - **Act III**: Demonstrate lasting damage to both parties
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *The Godfather Part II*, Fredo's betrayal destroys him as much as it hurts Michael
68
+ - ❌ **Bad**: Only the betrayed character suffers while the betrayer is unaffected
69
+
70
+ ---
71
+
72
+ ### Rule 4: Make the Betrayal Specific and Personal
73
+
74
+ **Description**: Betrayal should violate specific trust, not just generic disloyalty. The more personal, the more powerful.
75
+
76
+ **Why It Matters**: Generic betrayal lacks emotional impact. Specific violations create deeper wounds.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish specific trust and loyalty
80
+ - **Act II**: Violate that specific trust in the most painful way
81
+ - **Act III**: Address the specific nature of the betrayal
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *The Empire Strikes Back*, Vader's revelation betrays Luke's trust in his father's memory
85
+ - ❌ **Bad**: Vague disloyalty without specific trust being violated
86
+
87
+ ---
88
+
89
+ ### Rule 5: Explore Whether Forgiveness Is Possible
90
+
91
+ **Description**: The story should question whether trust can be rebuilt, whether forgiveness is possible, and whether it's wise.
92
+
93
+ **Why It Matters**: This is the central moral question of betrayal themes.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish the value of trust and loyalty
97
+ - **Act II**: Show betrayal destroying trust
98
+ - **Act III**: Answer whether forgiveness is granted, denied, or complicated
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *The Godfather Part II*, Michael cannot forgive Fredo, showing some betrayals are unforgivable
102
+ - ❌ **Bad**: Forgiveness is automatic without addressing whether trust can be rebuilt
103
+
104
+ ---
105
+
106
+ ### Rule 6: Show the Moment of Choice
107
+
108
+ **Description**: Betrayal should involve a clear moment of choice where the betrayer decides between loyalty and self-interest.
109
+
110
+ **Why It Matters**: Accidental betrayal lacks moral weight. The choice makes it meaningful.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish the relationship and loyalty
114
+ - **Act II**: Create the moment where betrayal becomes a choice
115
+ - **Act III**: Show the betrayer living with their choice
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *The Departed*, Colin makes clear choices to betray the police
119
+ - ❌ **Bad**: Betrayal happens accidentally or without conscious choice
120
+
121
+ ---
122
+
123
+ ### Rule 7: Show the Ripple Effects of Betrayal
124
+
125
+ **Description**: Betrayal doesn't just affect the betrayed—it impacts everyone connected to both parties and changes the broader world.
126
+
127
+ **Why It Matters**: Isolated betrayal lacks scope. Ripple effects demonstrate the full cost.
128
+
129
+ **Application**:
130
+ - **Act I**: Establish the web of relationships that will be affected
131
+ - **Act II**: Show how betrayal spreads through the network
132
+ - **Act III**: Demonstrate the full scope of damage
133
+
134
+ **Examples**:
135
+ - ✅ **Good**: In *The Godfather Part II*, Michael's betrayals destroy his entire family
136
+ - ❌ **Bad**: Betrayal only affects the two people directly involved
137
+
138
+ ---
139
+
140
+ ### Rule 8: Show Betrayal Through Action, Not Just Revelation
141
+
142
+ **Description**: Betrayal should be demonstrated through choices and behavior, not just revealed through exposition.
143
+
144
+ **Why It Matters**: Showing betrayal creates emotional impact. Telling feels distant.
145
+
146
+ **Application**:
147
+ - **Act I**: Plant seeds of potential betrayal through behavior
148
+ - **Act II**: Show the betrayal happening through specific actions
149
+ - **Act III**: Demonstrate consequences through continued action
150
+
151
+ **Examples**:
152
+ - ✅ **Good**: In *The Departed*, we see Billy's undercover work and Colin's corruption through their actions
153
+ - ❌ **Bad**: Characters simply tell us about betrayal that happened off-screen
154
+
155
+ ---
156
+
157
+ ## Integration Guidelines
158
+
159
+ ### Act I: Setup
160
+
161
+ **Thematic Introduction**:
162
+ - Establish the relationship and trust that will be betrayed
163
+ - Show what the trust means to both parties
164
+ - Plant subtle seeds of potential betrayal (motivations, pressures, conflicts)
165
+ - Demonstrate the value of what will be lost
166
+
167
+ **Character Connection**:
168
+ - Show the depth of the relationship before betrayal
169
+ - Establish what each character values and needs
170
+ - Demonstrate mutual dependence or vulnerability
171
+ - Reveal potential fault lines in the relationship
172
+
173
+ **Visual/Symbolic Introduction**:
174
+ - Use visual motifs representing trust (shared spaces, gifts, rituals)
175
+ - Establish symbolic elements that will be violated
176
+ - Create visual language for intimacy that will be broken
177
+
178
+ ### Act II: Development
179
+
180
+ **Thematic Exploration**:
181
+ - Show the betrayer's motivations and internal conflict
182
+ - Demonstrate the moment of betrayal and its immediate impact
183
+ - Explore the betrayed's discovery and emotional devastation
184
+ - Show how betrayal spreads to affect others
185
+
186
+ **Subtext Techniques**:
187
+ - Use dramatic irony (audience knows betrayal before victim)
188
+ - Show betrayer's guilt through behavior and body language
189
+ - Create visual distance between betrayer and betrayed
190
+ - Use dialogue that carries double meaning
191
+
192
+ **Thematic Complications**:
193
+ - Betrayer faces consequences and potential guilt
194
+ - Betrayed must decide how to respond
195
+ - Other characters take sides or are caught in the middle
196
+ - The full scope of damage becomes clear
197
+
198
+ ### Act III: Resolution
199
+
200
+ **Thematic Payoff**:
201
+ - Answer whether betrayal can be forgiven or avenged
202
+ - Show the ultimate cost to both betrayer and betrayed
203
+ - Demonstrate whether trust can be rebuilt or is permanently broken
204
+ - Resolve the broader impact on all affected parties
205
+
206
+ **Avoiding Preachiness**:
207
+ - Let consequences speak rather than moral speeches
208
+ - Avoid simple "betrayal is bad" messaging
209
+ - Show complexity—betrayers may have understandable motivations
210
+ - Allow for moral ambiguity in responses to betrayal
211
+
212
+ ## Character Connection
213
+
214
+ ### Protagonist
215
+
216
+ **Thematic Relationship**: The protagonist is either the betrayer, the betrayed, or caught between both, forcing them to confront questions of trust and loyalty.
217
+
218
+ **Arc Integration**: The character arc should reflect transformation caused by betrayal—loss of innocence, hardening, or learning to trust again.
219
+
220
+ **Key Moments**:
221
+ - **Thematic Introduction**: The moment that establishes the trust that will be broken
222
+ - **Thematic Challenge**: The betrayal itself and its discovery
223
+ - **Thematic Resolution**: The choice of how to respond to betrayal
224
+
225
+ ### Antagonist
226
+
227
+ **Thematic Opposition**: The antagonist may be the betrayer, or may exploit betrayal to achieve their goals.
228
+
229
+ **Thematic Function**: The antagonist tests whether trust is weakness or strength, whether loyalty matters.
230
+
231
+ ### Supporting Characters
232
+
233
+ **Thematic Mirrors**: Supporting characters represent different responses to betrayal:
234
+ - The character who forgives showing mercy
235
+ - The character who seeks revenge showing justice
236
+ - The character who was betrayed before showing the long-term effects
237
+ - The character who never trusted showing the cost of cynicism
238
+
239
+ **Thematic Perspectives**: Different characters embody different beliefs about trust, loyalty, and forgiveness.
240
+
241
+ ## Subtext Techniques
242
+
243
+ ### Dialogue
244
+
245
+ - Use dramatic irony where audience knows betrayal before victim
246
+ - Create double meanings in betrayer's words
247
+ - Show betrayer's guilt through evasive or overcompensating dialogue
248
+ - Include moments where betrayed character expresses trust, creating painful irony
249
+
250
+ ### Visual Storytelling
251
+
252
+ - **Visual motifs**: Broken objects, shattered mirrors, divided frames
253
+ - **Color palette**: Shift from warm (trust) to cold (betrayal)
254
+ - **Symbolic imagery**: Physical distance, turned backs, shadows
255
+ - **Framing**: Separate betrayer and betrayed visually after the breach
256
+
257
+ ### Action and Behavior
258
+
259
+ - Show betrayer's guilt through nervous behavior
260
+ - Demonstrate betrayed's suspicion through watchfulness
261
+ - Create moments where betrayer almost confesses
262
+ - Show physical recoil or distance after betrayal is revealed
263
+
264
+ ## Film Examples
265
+
266
+ ### Example 1: The Godfather Part II (1974)
267
+
268
+ **Director**: Francis Ford Coppola
269
+
270
+ **Thematic Exploration**: Explores betrayal within family and criminal organization, examining how power corrupts loyalty and trust.
271
+
272
+ **Key Thematic Moments**:
273
+ - **Fredo's betrayal**: "I know it was you, Fredo. You broke my heart."
274
+ - **Michael's coldness**: Refusing to acknowledge Fredo at the party
275
+ - **The kiss of death**: Michael's final betrayal of his brother
276
+ - **Kay's betrayal**: Revealing she aborted Michael's son
277
+ - **Flashback contrast**: Young Vito's loyalty vs. Michael's betrayals
278
+
279
+ **Thematic Resolution**: Betrayal destroys Michael's family and soul. His response to betrayal—more betrayal—leaves him powerful but utterly alone.
280
+
281
+ **Techniques Used**:
282
+ - Parallel structure (Vito's loyalty vs. Michael's betrayal)
283
+ - Visual isolation of Michael after betrayals
284
+ - Dramatic irony (audience knows Fredo's betrayal before Michael)
285
+ - The final shot of Michael alone showing the cost
286
+ - Multiple betrayals creating cumulative devastation
287
+
288
+ ---
289
+
290
+ ### Example 2: The Departed (2006)
291
+
292
+ **Director**: Martin Scorsese
293
+
294
+ **Thematic Exploration**: Explores mutual betrayal and double lives, examining identity and loyalty when everyone is deceiving everyone.
295
+
296
+ **Key Thematic Moments**:
297
+ - **Dual infiltration**: Both sides have traitors
298
+ - **Billy's isolation**: Living a lie, unable to trust anyone
299
+ - **Colin's double life**: Betraying the police while appearing loyal
300
+ - **Madolyn caught between**: Unknowingly involved with both men
301
+ - **Elevator massacre**: Ultimate betrayal and violence
302
+
303
+ **Thematic Resolution**: Betrayal breeds more betrayal until everyone is destroyed. No one escapes the consequences of living a lie.
304
+
305
+ **Techniques Used**:
306
+ - Parallel editing showing both betrayers
307
+ - Visual motifs (rats, X's marking death)
308
+ - Dramatic irony throughout
309
+ - Tense scenes where betrayers nearly discover each other
310
+ - Shocking violence as consequence of betrayal
311
+
312
+ ---
313
+
314
+ ### Example 3: Atonement (2007)
315
+
316
+ **Director**: Joe Wright
317
+
318
+ **Thematic Exploration**: Explores false accusation as betrayal, examining whether atonement is possible for irreparable damage.
319
+
320
+ **Key Thematic Moments**:
321
+ - **Briony's accusation**: Child's misunderstanding destroying lives
322
+ - **Robbie's arrest**: Innocent man betrayed by false testimony
323
+ - **Separation**: Cecilia and Robbie torn apart
324
+ - **War sequences**: Robbie suffering consequences of betrayal
325
+ - **Briony's confession**: Attempting atonement through writing
326
+
327
+ **Thematic Resolution**: Some betrayals cannot be undone. Atonement may be impossible, leaving only the attempt to bear witness to truth.
328
+
329
+ **Techniques Used**:
330
+ - Unreliable narrator revealing truth gradually
331
+ - Visual beauty contrasting with emotional devastation
332
+ - Time jumps showing long-term consequences
333
+ - Metafictional ending questioning whether atonement through art is valid
334
+ - Typewriter motif representing attempt to rewrite the past
335
+
336
+ ---
337
+
338
+ ### Example 4: Shutter Island (2010)
339
+
340
+ **Director**: Martin Scorsese
341
+
342
+ **Thematic Exploration**: Explores self-betrayal and the betrayal of reality, examining how we deceive ourselves to avoid unbearable truth.
343
+
344
+ **Key Thematic Moments**:
345
+ - **The investigation**: Teddy's search for truth
346
+ - **Gradual revelations**: Reality breaking through delusion
347
+ - **The lighthouse**: Confrontation with truth
348
+ - **"Which would be worse?"**: Choosing between painful truth and comforting lie
349
+ - **Final line**: Suggesting Teddy chooses lobotomy over truth
350
+
351
+ **Thematic Resolution**: Sometimes we betray ourselves to survive unbearable reality. The question is whether living with truth or living with delusion is worse.
352
+
353
+ **Techniques Used**:
354
+ - Unreliable protagonist perspective
355
+ - Visual distortions suggesting mental state
356
+ - Gradual revelation of truth
357
+ - Ambiguous ending leaving interpretation open
358
+ - Gothic atmosphere reflecting psychological horror
359
+
360
+ ---
361
+
362
+ ### Example 5: Doubt (2008)
363
+
364
+ **Director**: John Patrick Shanley
365
+
366
+ **Thematic Exploration**: Explores accusation and uncertainty, examining betrayal of trust in institutions and the impossibility of certainty.
367
+
368
+ **Key Thematic Moments**:
369
+ - **Sister Aloysius's suspicion**: Accusing Father Flynn
370
+ - **Lack of evidence**: Certainty without proof
371
+ - **Mrs. Miller's response**: Complicated perspective on protection
372
+ - **Father Flynn's transfer**: Avoiding resolution
373
+ - **"I have doubts"**: Final admission of uncertainty
374
+
375
+ **Thematic Resolution**: Certainty about betrayal may be impossible. Acting on suspicion may itself be a betrayal, but inaction may enable harm.
376
+
377
+ **Techniques Used**:
378
+ - Theatrical staging emphasizing dialogue
379
+ - Ambiguity maintained throughout
380
+ - No definitive answer to guilt or innocence
381
+ - Visual symbolism (wind, shadows, isolation)
382
+ - Title reflecting central theme of uncertainty
383
+
384
+ ---
385
+
386
+ ## Integration with Other Features
387
+
388
+ ### Compatible Genres
389
+
390
+ - **Drama**: Deep exploration of betrayal's emotional impact
391
+ - **Thriller**: Betrayal creating suspense and danger
392
+ - **Crime**: Betrayal within criminal organizations
393
+ - **War**: Betrayal of comrades or country
394
+ - **Romance**: Infidelity and broken trust
395
+ - **Political**: Betrayal of ideals or allies
396
+
397
+ ### Compatible Themes (Multi-Theme Stories)
398
+
399
+ - **Trust**: Betrayal is the breaking of trust
400
+ - **Loyalty**: Betrayal violates loyalty
401
+ - **Revenge**: Betrayal often motivates revenge
402
+ - **Redemption**: Betrayer may seek redemption
403
+ - **Justice**: Betrayed may seek justice
404
+ - **Forgiveness**: Whether betrayal can be forgiven
405
+
406
+ ### Compatible Styles
407
+
408
+ - **Psychological**: Internal experience of betrayal
409
+ - **Noir**: Betrayal in morally ambiguous world
410
+ - **Tragedy**: Betrayal leading to downfall
411
+ - **Mystery**: Discovering who betrayed and why
412
+
413
+ ## Common Pitfalls
414
+
415
+ ### Pitfall 1: Unmotivated Betrayal
416
+
417
+ **Problem**: Betrayer has no clear reason for betraying, making it feel arbitrary.
418
+
419
+ **Solution**: Establish clear motivations—greed, fear, jealousy, ideology, or survival.
420
+
421
+ **Example**: Show what the betrayer gains or fears losing that motivates the betrayal.
422
+
423
+ ---
424
+
425
+ ### Pitfall 2: Instant Forgiveness
426
+
427
+ **Problem**: Betrayal is forgiven immediately without processing the damage.
428
+
429
+ **Solution**: Show the painful process of deciding whether to forgive and rebuilding trust.
430
+
431
+ **Example**: Forgiveness, if it comes, should be earned through time and changed behavior.
432
+
433
+ ---
434
+
435
+ ### Pitfall 3: Shallow Relationships
436
+
437
+ **Problem**: The relationship before betrayal isn't established, so the betrayal lacks impact.
438
+
439
+ **Solution**: Invest time showing the depth of trust before it's broken.
440
+
441
+ **Example**: Show shared history, vulnerability, and mutual dependence before betrayal.
442
+
443
+ ---
444
+
445
+ ### Pitfall 4: One-Dimensional Betrayer
446
+
447
+ **Problem**: Betrayer is purely evil with no complexity or internal conflict.
448
+
449
+ **Solution**: Show the betrayer's motivations, guilt, and humanity.
450
+
451
+ **Example**: Even villainous betrayers should have understandable (if not justifiable) reasons.
452
+
453
+ ---
454
+
455
+ ### Pitfall 5: No Consequences
456
+
457
+ **Problem**: Betrayal happens but has no lasting impact on anyone.
458
+
459
+ **Solution**: Show the ripple effects and permanent changes caused by betrayal.
460
+
461
+ **Example**: Betrayal should fundamentally alter relationships and characters.
462
+
463
+ ---
464
+
465
+ ## Best Practices
466
+
467
+ 1. **Establish deep trust first** - The deeper the trust, the more devastating the betrayal
468
+ 2. **Motivate the betrayer** - Clear reasons for betrayal create complexity
469
+ 3. **Show internal conflict** - Betrayers should struggle with their choice
470
+ 4. **Use dramatic irony** - Audience knowing before victim creates tension
471
+ 5. **Demonstrate ripple effects** - Betrayal affects everyone, not just the betrayed
472
+ 6. **Question forgiveness** - Explore whether betrayal can be forgiven
473
+ 7. **Show long-term impact** - Betrayal permanently changes people
474
+ 8. **Avoid simple morality** - Betrayal can have complex motivations
475
+ 9. **Use visual storytelling** - Show broken trust through imagery
476
+ 10. **Make it personal** - Betrayal should cut to the core of identity
477
+
478
+ ## Resources
479
+
480
+ - *The Anatomy of Story* by John Truby - Character relationships and moral complexity
481
+ - *Story* by Robert McKee - Betrayal in dramatic structure
482
+ - *The Writer's Journey* by Christopher Vogler - Shapeshifter archetype and betrayal
483
+ - *Into the Woods* by John Yorke - Relationship dynamics and trust
484
+ - *Poetics* by Aristotle - Reversal and recognition in tragedy
485
+
486
+ ---
487
+
488
+ **Depth Coverage**: 85%
489
+ **Last Updated**: 2026-01-31
490
+ **Version**: 1.0.0