@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,490 +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
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