@mytechtoday/augment-extensions 0.5.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 (523) 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 +113 -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 +15 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +576 -23
  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/config-system.d.ts +111 -0
  476. package/cli/dist/utils/config-system.d.ts.map +1 -0
  477. package/cli/dist/utils/config-system.js +239 -0
  478. package/cli/dist/utils/config-system.js.map +1 -0
  479. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  480. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  481. package/cli/dist/utils/extractCommandHelp.js +250 -0
  482. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  483. package/cli/dist/utils/hook-system.d.ts +84 -0
  484. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  485. package/cli/dist/utils/hook-system.js +151 -0
  486. package/cli/dist/utils/hook-system.js.map +1 -0
  487. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  488. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  489. package/cli/dist/utils/inspection-cache.js +166 -0
  490. package/cli/dist/utils/inspection-cache.js.map +1 -0
  491. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  492. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  493. package/cli/dist/utils/inspection-handlers.js +171 -0
  494. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  495. package/cli/dist/utils/install-rules.js +55 -55
  496. package/cli/dist/utils/mcp-integration.js +44 -44
  497. package/cli/dist/utils/module-system.d.ts +1 -0
  498. package/cli/dist/utils/module-system.d.ts.map +1 -1
  499. package/cli/dist/utils/module-system.js +8 -3
  500. package/cli/dist/utils/module-system.js.map +1 -1
  501. package/cli/dist/utils/plugin-system.d.ts +133 -0
  502. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  503. package/cli/dist/utils/plugin-system.js +210 -0
  504. package/cli/dist/utils/plugin-system.js.map +1 -0
  505. package/cli/dist/utils/progress.d.ts +67 -0
  506. package/cli/dist/utils/progress.d.ts.map +1 -0
  507. package/cli/dist/utils/progress.js +146 -0
  508. package/cli/dist/utils/progress.js.map +1 -0
  509. package/cli/dist/utils/rule-install-hooks.js +8 -8
  510. package/cli/dist/utils/stream-reader.d.ts +34 -0
  511. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  512. package/cli/dist/utils/stream-reader.js +147 -0
  513. package/cli/dist/utils/stream-reader.js.map +1 -0
  514. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  515. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  516. package/cli/dist/utils/vscode-editor.js +171 -0
  517. package/cli/dist/utils/vscode-editor.js.map +1 -0
  518. package/cli/dist/utils/vscode-links.d.ts +49 -0
  519. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  520. package/cli/dist/utils/vscode-links.js +167 -0
  521. package/cli/dist/utils/vscode-links.js.map +1 -0
  522. package/modules.md +667 -630
  523. package/package.json +85 -85
@@ -1,458 +1,458 @@
1
- # Ambition Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- The ambition theme explores the drive to achieve goals, examining what people will sacrifice for success, whether ambition leads to fulfillment or destruction, and the line between healthy drive and destructive obsession.
10
-
11
- ## Core Concept
12
-
13
- Ambition in storytelling represents the hunger for achievement, success, or greatness. It explores the motivations behind ambition, the sacrifices it demands, and the question of whether achieving our goals brings satisfaction or reveals their emptiness.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of ambition explores the drive to achieve greatness, examining what must be sacrificed for success and whether achieving our goals brings fulfillment or reveals their hollowness.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Establish the Goal and Its Appeal
22
-
23
- **Description**: The ambitious goal must be genuinely appealing—offering success, recognition, wealth, or achievement that the audience understands pursuing.
24
-
25
- **Why It Matters**: If the goal isn't attractive, the character's ambition seems irrational.
26
-
27
- **Application**:
28
- - **Act I**: Clearly establish the goal and why it's worth pursuing
29
- - **Act II**: Show the goal's continued appeal despite costs
30
- - **Act III**: Reveal whether achieving the goal was worth it
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *The Social Network*, creating Facebook offers innovation, wealth, and social validation
34
- - ❌ **Bad**: The character pursues a goal with no clear appeal or value
35
-
36
- ---
37
-
38
- ### Rule 2: Show the Cost of Ambition
39
-
40
- **Description**: Ambition requires sacrifice—of relationships, morality, health, or other opportunities. The cost must be significant.
41
-
42
- **Why It Matters**: Ambition without cost feels unearned. Sacrifice demonstrates commitment and creates moral complexity.
43
-
44
- **Application**:
45
- - **Act I**: Establish what the character values (relationships, integrity, health)
46
- - **Act II**: Force them to sacrifice these for their ambition
47
- - **Act III**: Show the cumulative cost of their choices
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *Whiplash*, Andrew sacrifices relationships, health, and well-being for musical greatness
51
- - ❌ **Bad**: The character achieves their goals without sacrificing anything
52
-
53
- ---
54
-
55
- ### Rule 3: Differentiate Healthy Drive from Destructive Obsession
56
-
57
- **Description**: Explore the line between productive ambition and destructive obsession. When does drive become unhealthy?
58
-
59
- **Why It Matters**: This distinction creates moral complexity and character depth.
60
-
61
- **Application**:
62
- - **Act I**: Show ambition as positive drive
63
- - **Act II**: Demonstrate the shift from healthy to destructive
64
- - **Act III**: Answer whether the character recognizes and addresses the obsession
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *Black Swan*, Nina's ambition shifts from dedication to destructive obsession
68
- - ❌ **Bad**: Ambition is portrayed as purely positive or purely negative
69
-
70
- ---
71
-
72
- ### Rule 4: Question Whether Achievement Brings Fulfillment
73
-
74
- **Description**: The story should explore whether achieving the goal brings the satisfaction the character expected or reveals its emptiness.
75
-
76
- **Why It Matters**: This is the central question of ambition themes—is the goal worth the pursuit?
77
-
78
- **Application**:
79
- - **Act I**: Establish the character's belief that achieving the goal will bring fulfillment
80
- - **Act II**: Show doubts and hints that achievement might not satisfy
81
- - **Act III**: Reveal whether achievement brings fulfillment or disappointment
82
-
83
- **Examples**:
84
- - ✅ **Good**: In *Citizen Kane*, Kane achieves wealth and power but dies alone and unfulfilled
85
- - ❌ **Bad**: Achievement automatically brings complete satisfaction
86
-
87
- ---
88
-
89
- ### Rule 5: Create Obstacles That Test Commitment
90
-
91
- **Description**: The path to the goal must be difficult, with obstacles that test whether the character will continue despite costs.
92
-
93
- **Why It Matters**: Easy achievement lacks dramatic power. Obstacles reveal character and commitment.
94
-
95
- **Application**:
96
- - **Act I**: Establish the difficulty of the goal
97
- - **Act II**: Create escalating obstacles that test commitment
98
- - **Act III**: Present ultimate obstacle that proves dedication
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *The Pursuit of Happyness*, Chris faces homelessness and extreme hardship pursuing his goal
102
- - ❌ **Bad**: The character achieves their goal easily without significant obstacles
103
-
104
- ---
105
-
106
- ### Rule 6: Show Ambition's Effect on Others
107
-
108
- **Description**: Ambition doesn't just affect the ambitious person—it impacts everyone around them. Show the collateral damage.
109
-
110
- **Why It Matters**: This explores the broader consequences of ambition beyond the individual.
111
-
112
- **Application**:
113
- - **Act I**: Establish relationships that will be affected
114
- - **Act II**: Show how ambition damages these relationships
115
- - **Act III**: Demonstrate the full impact on others
116
-
117
- **Examples**:
118
- - ✅ **Good**: In *The Social Network*, Zuckerberg's ambition destroys his friendship with Eduardo
119
- - ❌ **Bad**: Ambition only affects the ambitious character
120
-
121
- ---
122
-
123
- ## Integration Guidelines
124
-
125
- ### Act I: Setup
126
-
127
- **Thematic Introduction**:
128
- - Introduce the ambitious goal and why it's worth pursuing
129
- - Establish what the character believes success will bring
130
- - Show the character's current state and what they lack
131
- - Plant seeds of what will be sacrificed for ambition
132
-
133
- **Character Connection**:
134
- - Demonstrate the character's drive and motivation
135
- - Show what they value (relationships, integrity, health)
136
- - Establish their current limitations or failures
137
- - Reveal why they need to achieve this goal
138
-
139
- **Visual/Symbolic Introduction**:
140
- - Use visual motifs representing success (trophies, heights, wealth)
141
- - Establish symbolic objects that represent the goal
142
- - Create visual language for ambition vs. contentment
143
-
144
- ### Act II: Development
145
-
146
- **Thematic Exploration**:
147
- - Show the character making progress toward their goal
148
- - Demonstrate increasing sacrifices required
149
- - Create situations where ambition conflicts with other values
150
- - Show the character changing as they pursue success
151
-
152
- **Subtext Techniques**:
153
- - Use dialogue about success, achievement, and worth
154
- - Show behavioral changes as ambition consumes the character
155
- - Create visual progression showing the cost (isolation, exhaustion)
156
- - Use other characters' reactions to show the transformation
157
-
158
- **Thematic Complications**:
159
- - Relationships are damaged by single-minded pursuit
160
- - Moral lines must be crossed for advancement
161
- - The character becomes someone they don't recognize
162
- - Doubts arise about whether the goal is worth it
163
-
164
- ### Act III: Resolution
165
-
166
- **Thematic Payoff**:
167
- - Present the moment of achieving (or failing to achieve) the goal
168
- - Reveal whether success brings the expected fulfillment
169
- - Demonstrate the full cost of the ambition
170
- - Answer whether the sacrifice was worth it
171
-
172
- **Avoiding Preachiness**:
173
- - Let consequences demonstrate theme rather than speeches
174
- - Avoid characters explicitly stating "ambition is bad/good"
175
- - Show complexity—ambition can be both productive and destructive
176
- - Allow for ambiguity in whether achievement was worth the cost
177
-
178
- ## Character Connection
179
-
180
- ### Protagonist
181
-
182
- **Thematic Relationship**: The protagonist's journey is driven by ambition. Their arc explores whether drive becomes destructive and whether achievement brings fulfillment.
183
-
184
- **Arc Integration**: The character arc should reflect the transformation caused by pursuing ambition—what they gain and what they lose.
185
-
186
- **Key Moments**:
187
- - **Thematic Introduction**: The moment they commit to pursuing the ambitious goal
188
- - **Thematic Challenge**: The moment they must choose between ambition and something they value
189
- - **Thematic Resolution**: The moment they achieve (or fail) and discover whether it was worth it
190
-
191
- ### Antagonist
192
-
193
- **Thematic Opposition**: The antagonist may represent obstacles to success, alternative paths, or the cautionary tale of ambition taken too far.
194
-
195
- **Thematic Function**: The antagonist tests whether the protagonist's ambition will consume them or whether they can maintain balance.
196
-
197
- ### Supporting Characters
198
-
199
- **Thematic Mirrors**: Supporting characters represent different approaches to ambition:
200
- - The character who achieved success and found it empty
201
- - The character who chose relationships over ambition
202
- - The character consumed by ambition (cautionary tale)
203
- - The mentor who models healthy drive
204
-
205
- **Thematic Perspectives**: Different characters embody different beliefs about ambition—whether it's worth pursuing, what should be sacrificed, where the line is.
206
-
207
- ## Subtext Techniques
208
-
209
- ### Dialogue
210
-
211
- - Characters discuss success, achievement, and worth without explicitly mentioning "ambition"
212
- - Use metaphors of climbing, reaching, winning
213
- - Create conversations where characters justify sacrifices
214
- - Include moments where others question the cost
215
-
216
- ### Visual Storytelling
217
-
218
- - **Visual motifs**: Heights, ladders, trophies, wealth symbols
219
- - **Color palette**: Often cooler tones as ambition isolates
220
- - **Symbolic imagery**: Objects representing success and what's sacrificed
221
- - **Physical positioning**: Character rising above others, isolated at the top
222
-
223
- ### Action and Behavior
224
-
225
- - Show increasing work hours and decreasing personal time
226
- - Demonstrate relationships being neglected
227
- - Create moments where character chooses work over people
228
- - Show physical changes (exhaustion, stress, aging)
229
-
230
- ## Film Examples
231
-
232
- ### Example 1: The Social Network (2010)
233
-
234
- **Director**: David Fincher
235
-
236
- **Thematic Exploration**: Explores ambition in the digital age, examining how the drive to create something revolutionary destroys friendships and creates isolation.
237
-
238
- **Key Thematic Moments**:
239
- - **Opening breakup**: Powerlessness driving ambition
240
- - **Creating Facebook**: Ambition as response to rejection
241
- - **Betraying Eduardo**: Friendship sacrificed for success
242
- - **"A million dollars isn't cool"**: Ambition's escalating demands
243
- - **Final scene**: Alone, refreshing page, waiting for friend request
244
-
245
- **Thematic Resolution**: Zuckerberg achieves immense success but loses all authentic relationships, ending alone despite creating a social network.
246
-
247
- **Techniques Used**:
248
- - Fast-paced dialogue showing drive
249
- - Framing device (depositions) showing consequences
250
- - Visual isolation despite success
251
- - Contrast between connection platform and personal isolation
252
- - Final image of loneliness at the height of success
253
-
254
- ---
255
-
256
- ### Example 2: Whiplash (2014)
257
-
258
- **Director**: Damien Chazelle
259
-
260
- **Thematic Exploration**: Explores the line between healthy ambition and destructive obsession, examining what must be sacrificed for greatness.
261
-
262
- **Key Thematic Moments**:
263
- - **First practice**: Andrew's hunger for recognition
264
- - **Fletcher's abuse**: Ambition exploited and weaponized
265
- - **Breakup with Nicole**: Relationship sacrificed for drumming
266
- - **Car accident**: Physical cost of obsession
267
- - **Final performance**: Ultimate test of whether sacrifice was worth it
268
-
269
- **Thematic Resolution**: Ambiguous—Andrew achieves musical greatness but at terrible cost. The film questions whether the sacrifice was worth it.
270
-
271
- **Techniques Used**:
272
- - Intense close-ups showing obsession
273
- - Jazz as metaphor for ambition
274
- - Abusive mentor relationship
275
- - Physical deterioration (bloody hands)
276
- - Ambiguous ending refusing simple answers
277
-
278
- ---
279
-
280
- ### Example 3: Black Swan (2010)
281
-
282
- **Director**: Darren Aronofsky
283
-
284
- **Thematic Exploration**: Explores ambition shifting from dedication to destructive obsession, examining the psychological cost of perfectionism.
285
-
286
- **Key Thematic Moments**:
287
- - **Casting**: Nina's desperate desire for the role
288
- - **"I just want to be perfect"**: Ambition as obsession
289
- - **Transformation**: Becoming the Black Swan
290
- - **Hallucinations**: Psychological breakdown
291
- - **Final performance**: Achieving perfection through self-destruction
292
-
293
- **Thematic Resolution**: Nina achieves her goal but destroys herself in the process. Perfection costs everything.
294
-
295
- **Techniques Used**:
296
- - Psychological horror elements
297
- - Visual transformation (Nina becoming swan)
298
- - Mirrors and reflections showing fractured self
299
- - Body horror showing physical cost
300
- - Tragic ending showing ultimate price
301
-
302
- ---
303
-
304
- ### Example 4: The Pursuit of Happyness (2006)
305
-
306
- **Director**: Gabriele Muccino
307
-
308
- **Thematic Exploration**: Explores ambition as survival and hope, examining what a parent will endure to provide for their child.
309
-
310
- **Key Thematic Moments**:
311
- - **Losing everything**: Homelessness while pursuing internship
312
- - **Bathroom scene**: Lowest point, protecting son
313
- - **Unpaid internship**: Sacrificing security for opportunity
314
- - **Selling blood**: Desperation to survive while pursuing goal
315
- - **Getting the job**: Ambition rewarded after extreme sacrifice
316
-
317
- **Thematic Resolution**: Ambition combined with love and perseverance leads to success. The sacrifice was worth it.
318
-
319
- **Techniques Used**:
320
- - Father-son relationship grounding ambition
321
- - Visual contrast (homelessness vs. success)
322
- - Real-time struggle showing cost
323
- - Emotional restraint making triumph powerful
324
- - Based on true story adding authenticity
325
-
326
- ---
327
-
328
- ### Example 5: Citizen Kane (1941)
329
-
330
- **Director**: Orson Welles
331
-
332
- **Thematic Exploration**: Explores how ambition for wealth and power leads to isolation and emptiness, questioning whether achievement brings happiness.
333
-
334
- **Key Thematic Moments**:
335
- - **"Rosebud"**: Mystery representing what ambition cost
336
- - **Building empire**: Accumulating wealth and power
337
- - **Failed relationships**: Ambition destroying love
338
- - **Xanadu**: Isolation in palace of achievement
339
- - **Death alone**: Ultimate emptiness despite success
340
-
341
- **Thematic Resolution**: Ambition brings everything except what matters—connection, love, happiness. Kane dies alone despite immense success.
342
-
343
- **Techniques Used**:
344
- - Non-linear structure revealing cost
345
- - Visual symbolism (Xanadu as gilded cage)
346
- - Deep focus showing isolation in vast spaces
347
- - "Rosebud" as symbol of lost innocence
348
- - Contrast between public success and private emptiness
349
-
350
- ---
351
-
352
- ## Integration with Other Features
353
-
354
- ### Compatible Genres
355
-
356
- - **Drama**: Deep exploration of ambition's psychological effects
357
- - **Thriller**: Ambition creating dangerous situations
358
- - **Crime**: Ambition within criminal enterprises
359
- - **Sports**: Physical ambition and competition
360
- - **Business**: Corporate ambition and success
361
- - **Music/Arts**: Artistic ambition and perfectionism
362
-
363
- ### Compatible Themes (Multi-Theme Stories)
364
-
365
- - **Success**: Ambition drives pursuit of success
366
- - **Sacrifice**: Ambition requires sacrifice
367
- - **Identity**: Ambition shapes who we become
368
- - **Power**: Ambition often seeks power
369
- - **Isolation**: Ambition can isolate
370
- - **Obsession**: Ambition can become obsession
371
-
372
- ### Compatible Styles
373
-
374
- - **Character-Driven**: Explores psychological transformation
375
- - **Fast-Paced**: Mirrors the drive of ambition
376
- - **Minimalist**: Focuses on essential ambition elements
377
- - **Epic**: Large-scale ambition and achievement
378
-
379
- ## Common Pitfalls
380
-
381
- ### Pitfall 1: Ambition Without Appeal
382
-
383
- **Problem**: The goal isn't attractive, making pursuit seem irrational.
384
-
385
- **Solution**: Show genuine benefits and appeal of the goal.
386
-
387
- **Example**: Demonstrate what success offers—wealth, recognition, security, achievement.
388
-
389
- ---
390
-
391
- ### Pitfall 2: Ambition Without Cost
392
-
393
- **Problem**: Character achieves goals without sacrificing anything.
394
-
395
- **Solution**: Make ambition require real sacrifice of relationships, health, or values.
396
-
397
- **Example**: Show the character losing loved ones, compromising morals, or damaging health.
398
-
399
- ---
400
-
401
- ### Pitfall 3: One-Dimensional Portrayal
402
-
403
- **Problem**: Ambition is purely positive or purely negative.
404
-
405
- **Solution**: Show complexity—ambition can be both productive and destructive.
406
-
407
- **Example**: Demonstrate both achievements and costs of ambition.
408
-
409
- ---
410
-
411
- ### Pitfall 4: Easy Achievement
412
-
413
- **Problem**: Goals are achieved without significant obstacles.
414
-
415
- **Solution**: Create genuine challenges that test commitment.
416
-
417
- **Example**: Present obstacles that make success uncertain and hard-won.
418
-
419
- ---
420
-
421
- ### Pitfall 5: No Transformation
422
-
423
- **Problem**: Character remains unchanged despite pursuing ambition.
424
-
425
- **Solution**: Show how ambition transforms the character.
426
-
427
- **Example**: Demonstrate the character becoming harder, more isolated, or more driven.
428
-
429
- ---
430
-
431
- ## Best Practices
432
-
433
- 1. **Make goals appealing** - The audience must understand why the character pursues them
434
- 2. **Show the cost** - Ambition must require real sacrifice
435
- 3. **Differentiate drive from obsession** - Explore when healthy becomes destructive
436
- 4. **Question fulfillment** - Does achievement bring expected satisfaction?
437
- 5. **Create obstacles** - Test commitment through genuine challenges
438
- 6. **Show effect on others** - Ambition impacts everyone around the character
439
- 7. **Transform the character** - Ambition must change who they are
440
- 8. **Use visual storytelling** - Show isolation, exhaustion, transformation
441
- 9. **Avoid preachiness** - Let consequences speak for themselves
442
- 10. **Allow complexity** - Ambition can be both valuable and destructive
443
-
444
- ## Resources
445
-
446
- - *The Anatomy of Story* by John Truby - Character motivation and moral argument
447
- - *Story* by Robert McKee - Ambition in character arcs
448
- - *The Writer's Journey* by Christopher Vogler - Hero's ambition and transformation
449
- - *Into the Woods* by John Yorke - Ambition and story structure
450
- - *Save the Cat!* by Blake Snyder - Ambition in various story types
451
-
452
- ---
453
-
454
- **Depth Coverage**: 85%
455
- **Last Updated**: 2026-01-31
456
- **Version**: 1.0.0
457
-
458
-
1
+ # Ambition Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ The ambition theme explores the drive to achieve goals, examining what people will sacrifice for success, whether ambition leads to fulfillment or destruction, and the line between healthy drive and destructive obsession.
10
+
11
+ ## Core Concept
12
+
13
+ Ambition in storytelling represents the hunger for achievement, success, or greatness. It explores the motivations behind ambition, the sacrifices it demands, and the question of whether achieving our goals brings satisfaction or reveals their emptiness.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of ambition explores the drive to achieve greatness, examining what must be sacrificed for success and whether achieving our goals brings fulfillment or reveals their hollowness.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Establish the Goal and Its Appeal
22
+
23
+ **Description**: The ambitious goal must be genuinely appealing—offering success, recognition, wealth, or achievement that the audience understands pursuing.
24
+
25
+ **Why It Matters**: If the goal isn't attractive, the character's ambition seems irrational.
26
+
27
+ **Application**:
28
+ - **Act I**: Clearly establish the goal and why it's worth pursuing
29
+ - **Act II**: Show the goal's continued appeal despite costs
30
+ - **Act III**: Reveal whether achieving the goal was worth it
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *The Social Network*, creating Facebook offers innovation, wealth, and social validation
34
+ - ❌ **Bad**: The character pursues a goal with no clear appeal or value
35
+
36
+ ---
37
+
38
+ ### Rule 2: Show the Cost of Ambition
39
+
40
+ **Description**: Ambition requires sacrifice—of relationships, morality, health, or other opportunities. The cost must be significant.
41
+
42
+ **Why It Matters**: Ambition without cost feels unearned. Sacrifice demonstrates commitment and creates moral complexity.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish what the character values (relationships, integrity, health)
46
+ - **Act II**: Force them to sacrifice these for their ambition
47
+ - **Act III**: Show the cumulative cost of their choices
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *Whiplash*, Andrew sacrifices relationships, health, and well-being for musical greatness
51
+ - ❌ **Bad**: The character achieves their goals without sacrificing anything
52
+
53
+ ---
54
+
55
+ ### Rule 3: Differentiate Healthy Drive from Destructive Obsession
56
+
57
+ **Description**: Explore the line between productive ambition and destructive obsession. When does drive become unhealthy?
58
+
59
+ **Why It Matters**: This distinction creates moral complexity and character depth.
60
+
61
+ **Application**:
62
+ - **Act I**: Show ambition as positive drive
63
+ - **Act II**: Demonstrate the shift from healthy to destructive
64
+ - **Act III**: Answer whether the character recognizes and addresses the obsession
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *Black Swan*, Nina's ambition shifts from dedication to destructive obsession
68
+ - ❌ **Bad**: Ambition is portrayed as purely positive or purely negative
69
+
70
+ ---
71
+
72
+ ### Rule 4: Question Whether Achievement Brings Fulfillment
73
+
74
+ **Description**: The story should explore whether achieving the goal brings the satisfaction the character expected or reveals its emptiness.
75
+
76
+ **Why It Matters**: This is the central question of ambition themes—is the goal worth the pursuit?
77
+
78
+ **Application**:
79
+ - **Act I**: Establish the character's belief that achieving the goal will bring fulfillment
80
+ - **Act II**: Show doubts and hints that achievement might not satisfy
81
+ - **Act III**: Reveal whether achievement brings fulfillment or disappointment
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *Citizen Kane*, Kane achieves wealth and power but dies alone and unfulfilled
85
+ - ❌ **Bad**: Achievement automatically brings complete satisfaction
86
+
87
+ ---
88
+
89
+ ### Rule 5: Create Obstacles That Test Commitment
90
+
91
+ **Description**: The path to the goal must be difficult, with obstacles that test whether the character will continue despite costs.
92
+
93
+ **Why It Matters**: Easy achievement lacks dramatic power. Obstacles reveal character and commitment.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish the difficulty of the goal
97
+ - **Act II**: Create escalating obstacles that test commitment
98
+ - **Act III**: Present ultimate obstacle that proves dedication
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *The Pursuit of Happyness*, Chris faces homelessness and extreme hardship pursuing his goal
102
+ - ❌ **Bad**: The character achieves their goal easily without significant obstacles
103
+
104
+ ---
105
+
106
+ ### Rule 6: Show Ambition's Effect on Others
107
+
108
+ **Description**: Ambition doesn't just affect the ambitious person—it impacts everyone around them. Show the collateral damage.
109
+
110
+ **Why It Matters**: This explores the broader consequences of ambition beyond the individual.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish relationships that will be affected
114
+ - **Act II**: Show how ambition damages these relationships
115
+ - **Act III**: Demonstrate the full impact on others
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *The Social Network*, Zuckerberg's ambition destroys his friendship with Eduardo
119
+ - ❌ **Bad**: Ambition only affects the ambitious character
120
+
121
+ ---
122
+
123
+ ## Integration Guidelines
124
+
125
+ ### Act I: Setup
126
+
127
+ **Thematic Introduction**:
128
+ - Introduce the ambitious goal and why it's worth pursuing
129
+ - Establish what the character believes success will bring
130
+ - Show the character's current state and what they lack
131
+ - Plant seeds of what will be sacrificed for ambition
132
+
133
+ **Character Connection**:
134
+ - Demonstrate the character's drive and motivation
135
+ - Show what they value (relationships, integrity, health)
136
+ - Establish their current limitations or failures
137
+ - Reveal why they need to achieve this goal
138
+
139
+ **Visual/Symbolic Introduction**:
140
+ - Use visual motifs representing success (trophies, heights, wealth)
141
+ - Establish symbolic objects that represent the goal
142
+ - Create visual language for ambition vs. contentment
143
+
144
+ ### Act II: Development
145
+
146
+ **Thematic Exploration**:
147
+ - Show the character making progress toward their goal
148
+ - Demonstrate increasing sacrifices required
149
+ - Create situations where ambition conflicts with other values
150
+ - Show the character changing as they pursue success
151
+
152
+ **Subtext Techniques**:
153
+ - Use dialogue about success, achievement, and worth
154
+ - Show behavioral changes as ambition consumes the character
155
+ - Create visual progression showing the cost (isolation, exhaustion)
156
+ - Use other characters' reactions to show the transformation
157
+
158
+ **Thematic Complications**:
159
+ - Relationships are damaged by single-minded pursuit
160
+ - Moral lines must be crossed for advancement
161
+ - The character becomes someone they don't recognize
162
+ - Doubts arise about whether the goal is worth it
163
+
164
+ ### Act III: Resolution
165
+
166
+ **Thematic Payoff**:
167
+ - Present the moment of achieving (or failing to achieve) the goal
168
+ - Reveal whether success brings the expected fulfillment
169
+ - Demonstrate the full cost of the ambition
170
+ - Answer whether the sacrifice was worth it
171
+
172
+ **Avoiding Preachiness**:
173
+ - Let consequences demonstrate theme rather than speeches
174
+ - Avoid characters explicitly stating "ambition is bad/good"
175
+ - Show complexity—ambition can be both productive and destructive
176
+ - Allow for ambiguity in whether achievement was worth the cost
177
+
178
+ ## Character Connection
179
+
180
+ ### Protagonist
181
+
182
+ **Thematic Relationship**: The protagonist's journey is driven by ambition. Their arc explores whether drive becomes destructive and whether achievement brings fulfillment.
183
+
184
+ **Arc Integration**: The character arc should reflect the transformation caused by pursuing ambition—what they gain and what they lose.
185
+
186
+ **Key Moments**:
187
+ - **Thematic Introduction**: The moment they commit to pursuing the ambitious goal
188
+ - **Thematic Challenge**: The moment they must choose between ambition and something they value
189
+ - **Thematic Resolution**: The moment they achieve (or fail) and discover whether it was worth it
190
+
191
+ ### Antagonist
192
+
193
+ **Thematic Opposition**: The antagonist may represent obstacles to success, alternative paths, or the cautionary tale of ambition taken too far.
194
+
195
+ **Thematic Function**: The antagonist tests whether the protagonist's ambition will consume them or whether they can maintain balance.
196
+
197
+ ### Supporting Characters
198
+
199
+ **Thematic Mirrors**: Supporting characters represent different approaches to ambition:
200
+ - The character who achieved success and found it empty
201
+ - The character who chose relationships over ambition
202
+ - The character consumed by ambition (cautionary tale)
203
+ - The mentor who models healthy drive
204
+
205
+ **Thematic Perspectives**: Different characters embody different beliefs about ambition—whether it's worth pursuing, what should be sacrificed, where the line is.
206
+
207
+ ## Subtext Techniques
208
+
209
+ ### Dialogue
210
+
211
+ - Characters discuss success, achievement, and worth without explicitly mentioning "ambition"
212
+ - Use metaphors of climbing, reaching, winning
213
+ - Create conversations where characters justify sacrifices
214
+ - Include moments where others question the cost
215
+
216
+ ### Visual Storytelling
217
+
218
+ - **Visual motifs**: Heights, ladders, trophies, wealth symbols
219
+ - **Color palette**: Often cooler tones as ambition isolates
220
+ - **Symbolic imagery**: Objects representing success and what's sacrificed
221
+ - **Physical positioning**: Character rising above others, isolated at the top
222
+
223
+ ### Action and Behavior
224
+
225
+ - Show increasing work hours and decreasing personal time
226
+ - Demonstrate relationships being neglected
227
+ - Create moments where character chooses work over people
228
+ - Show physical changes (exhaustion, stress, aging)
229
+
230
+ ## Film Examples
231
+
232
+ ### Example 1: The Social Network (2010)
233
+
234
+ **Director**: David Fincher
235
+
236
+ **Thematic Exploration**: Explores ambition in the digital age, examining how the drive to create something revolutionary destroys friendships and creates isolation.
237
+
238
+ **Key Thematic Moments**:
239
+ - **Opening breakup**: Powerlessness driving ambition
240
+ - **Creating Facebook**: Ambition as response to rejection
241
+ - **Betraying Eduardo**: Friendship sacrificed for success
242
+ - **"A million dollars isn't cool"**: Ambition's escalating demands
243
+ - **Final scene**: Alone, refreshing page, waiting for friend request
244
+
245
+ **Thematic Resolution**: Zuckerberg achieves immense success but loses all authentic relationships, ending alone despite creating a social network.
246
+
247
+ **Techniques Used**:
248
+ - Fast-paced dialogue showing drive
249
+ - Framing device (depositions) showing consequences
250
+ - Visual isolation despite success
251
+ - Contrast between connection platform and personal isolation
252
+ - Final image of loneliness at the height of success
253
+
254
+ ---
255
+
256
+ ### Example 2: Whiplash (2014)
257
+
258
+ **Director**: Damien Chazelle
259
+
260
+ **Thematic Exploration**: Explores the line between healthy ambition and destructive obsession, examining what must be sacrificed for greatness.
261
+
262
+ **Key Thematic Moments**:
263
+ - **First practice**: Andrew's hunger for recognition
264
+ - **Fletcher's abuse**: Ambition exploited and weaponized
265
+ - **Breakup with Nicole**: Relationship sacrificed for drumming
266
+ - **Car accident**: Physical cost of obsession
267
+ - **Final performance**: Ultimate test of whether sacrifice was worth it
268
+
269
+ **Thematic Resolution**: Ambiguous—Andrew achieves musical greatness but at terrible cost. The film questions whether the sacrifice was worth it.
270
+
271
+ **Techniques Used**:
272
+ - Intense close-ups showing obsession
273
+ - Jazz as metaphor for ambition
274
+ - Abusive mentor relationship
275
+ - Physical deterioration (bloody hands)
276
+ - Ambiguous ending refusing simple answers
277
+
278
+ ---
279
+
280
+ ### Example 3: Black Swan (2010)
281
+
282
+ **Director**: Darren Aronofsky
283
+
284
+ **Thematic Exploration**: Explores ambition shifting from dedication to destructive obsession, examining the psychological cost of perfectionism.
285
+
286
+ **Key Thematic Moments**:
287
+ - **Casting**: Nina's desperate desire for the role
288
+ - **"I just want to be perfect"**: Ambition as obsession
289
+ - **Transformation**: Becoming the Black Swan
290
+ - **Hallucinations**: Psychological breakdown
291
+ - **Final performance**: Achieving perfection through self-destruction
292
+
293
+ **Thematic Resolution**: Nina achieves her goal but destroys herself in the process. Perfection costs everything.
294
+
295
+ **Techniques Used**:
296
+ - Psychological horror elements
297
+ - Visual transformation (Nina becoming swan)
298
+ - Mirrors and reflections showing fractured self
299
+ - Body horror showing physical cost
300
+ - Tragic ending showing ultimate price
301
+
302
+ ---
303
+
304
+ ### Example 4: The Pursuit of Happyness (2006)
305
+
306
+ **Director**: Gabriele Muccino
307
+
308
+ **Thematic Exploration**: Explores ambition as survival and hope, examining what a parent will endure to provide for their child.
309
+
310
+ **Key Thematic Moments**:
311
+ - **Losing everything**: Homelessness while pursuing internship
312
+ - **Bathroom scene**: Lowest point, protecting son
313
+ - **Unpaid internship**: Sacrificing security for opportunity
314
+ - **Selling blood**: Desperation to survive while pursuing goal
315
+ - **Getting the job**: Ambition rewarded after extreme sacrifice
316
+
317
+ **Thematic Resolution**: Ambition combined with love and perseverance leads to success. The sacrifice was worth it.
318
+
319
+ **Techniques Used**:
320
+ - Father-son relationship grounding ambition
321
+ - Visual contrast (homelessness vs. success)
322
+ - Real-time struggle showing cost
323
+ - Emotional restraint making triumph powerful
324
+ - Based on true story adding authenticity
325
+
326
+ ---
327
+
328
+ ### Example 5: Citizen Kane (1941)
329
+
330
+ **Director**: Orson Welles
331
+
332
+ **Thematic Exploration**: Explores how ambition for wealth and power leads to isolation and emptiness, questioning whether achievement brings happiness.
333
+
334
+ **Key Thematic Moments**:
335
+ - **"Rosebud"**: Mystery representing what ambition cost
336
+ - **Building empire**: Accumulating wealth and power
337
+ - **Failed relationships**: Ambition destroying love
338
+ - **Xanadu**: Isolation in palace of achievement
339
+ - **Death alone**: Ultimate emptiness despite success
340
+
341
+ **Thematic Resolution**: Ambition brings everything except what matters—connection, love, happiness. Kane dies alone despite immense success.
342
+
343
+ **Techniques Used**:
344
+ - Non-linear structure revealing cost
345
+ - Visual symbolism (Xanadu as gilded cage)
346
+ - Deep focus showing isolation in vast spaces
347
+ - "Rosebud" as symbol of lost innocence
348
+ - Contrast between public success and private emptiness
349
+
350
+ ---
351
+
352
+ ## Integration with Other Features
353
+
354
+ ### Compatible Genres
355
+
356
+ - **Drama**: Deep exploration of ambition's psychological effects
357
+ - **Thriller**: Ambition creating dangerous situations
358
+ - **Crime**: Ambition within criminal enterprises
359
+ - **Sports**: Physical ambition and competition
360
+ - **Business**: Corporate ambition and success
361
+ - **Music/Arts**: Artistic ambition and perfectionism
362
+
363
+ ### Compatible Themes (Multi-Theme Stories)
364
+
365
+ - **Success**: Ambition drives pursuit of success
366
+ - **Sacrifice**: Ambition requires sacrifice
367
+ - **Identity**: Ambition shapes who we become
368
+ - **Power**: Ambition often seeks power
369
+ - **Isolation**: Ambition can isolate
370
+ - **Obsession**: Ambition can become obsession
371
+
372
+ ### Compatible Styles
373
+
374
+ - **Character-Driven**: Explores psychological transformation
375
+ - **Fast-Paced**: Mirrors the drive of ambition
376
+ - **Minimalist**: Focuses on essential ambition elements
377
+ - **Epic**: Large-scale ambition and achievement
378
+
379
+ ## Common Pitfalls
380
+
381
+ ### Pitfall 1: Ambition Without Appeal
382
+
383
+ **Problem**: The goal isn't attractive, making pursuit seem irrational.
384
+
385
+ **Solution**: Show genuine benefits and appeal of the goal.
386
+
387
+ **Example**: Demonstrate what success offers—wealth, recognition, security, achievement.
388
+
389
+ ---
390
+
391
+ ### Pitfall 2: Ambition Without Cost
392
+
393
+ **Problem**: Character achieves goals without sacrificing anything.
394
+
395
+ **Solution**: Make ambition require real sacrifice of relationships, health, or values.
396
+
397
+ **Example**: Show the character losing loved ones, compromising morals, or damaging health.
398
+
399
+ ---
400
+
401
+ ### Pitfall 3: One-Dimensional Portrayal
402
+
403
+ **Problem**: Ambition is purely positive or purely negative.
404
+
405
+ **Solution**: Show complexity—ambition can be both productive and destructive.
406
+
407
+ **Example**: Demonstrate both achievements and costs of ambition.
408
+
409
+ ---
410
+
411
+ ### Pitfall 4: Easy Achievement
412
+
413
+ **Problem**: Goals are achieved without significant obstacles.
414
+
415
+ **Solution**: Create genuine challenges that test commitment.
416
+
417
+ **Example**: Present obstacles that make success uncertain and hard-won.
418
+
419
+ ---
420
+
421
+ ### Pitfall 5: No Transformation
422
+
423
+ **Problem**: Character remains unchanged despite pursuing ambition.
424
+
425
+ **Solution**: Show how ambition transforms the character.
426
+
427
+ **Example**: Demonstrate the character becoming harder, more isolated, or more driven.
428
+
429
+ ---
430
+
431
+ ## Best Practices
432
+
433
+ 1. **Make goals appealing** - The audience must understand why the character pursues them
434
+ 2. **Show the cost** - Ambition must require real sacrifice
435
+ 3. **Differentiate drive from obsession** - Explore when healthy becomes destructive
436
+ 4. **Question fulfillment** - Does achievement bring expected satisfaction?
437
+ 5. **Create obstacles** - Test commitment through genuine challenges
438
+ 6. **Show effect on others** - Ambition impacts everyone around the character
439
+ 7. **Transform the character** - Ambition must change who they are
440
+ 8. **Use visual storytelling** - Show isolation, exhaustion, transformation
441
+ 9. **Avoid preachiness** - Let consequences speak for themselves
442
+ 10. **Allow complexity** - Ambition can be both valuable and destructive
443
+
444
+ ## Resources
445
+
446
+ - *The Anatomy of Story* by John Truby - Character motivation and moral argument
447
+ - *Story* by Robert McKee - Ambition in character arcs
448
+ - *The Writer's Journey* by Christopher Vogler - Hero's ambition and transformation
449
+ - *Into the Woods* by John Yorke - Ambition and story structure
450
+ - *Save the Cat!* by Blake Snyder - Ambition in various story types
451
+
452
+ ---
453
+
454
+ **Depth Coverage**: 85%
455
+ **Last Updated**: 2026-01-31
456
+ **Version**: 1.0.0
457
+
458
+