@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,496 +1,496 @@
1
- # Survival Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: Medium
6
-
7
- ## Overview
8
-
9
- The survival theme explores the human will to live and what people become when survival is threatened. It examines the choices people make under extreme pressure, what they're willing to sacrifice to survive, and whether survival at any cost is worth it.
10
-
11
- ## Core Concept
12
-
13
- Survival in storytelling represents the most primal human drive—the will to live. It explores how extreme circumstances strip away civilization and reveal core human nature, examining whether survival brings out our best or worst, and what moral lines we'll cross when life is at stake.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of survival explores what humans become when life is threatened, examining the moral compromises survival demands and whether living at any cost is worth it.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Create Genuine Life-or-Death Stakes
22
-
23
- **Description**: The threat to survival must be real, immediate, and inescapable. The audience must believe the character could actually die.
24
-
25
- **Why It Matters**: Survival stories without genuine stakes become adventure stories. Death must be a real possibility.
26
-
27
- **Application**:
28
- - **Act I**: Establish the life-threatening situation clearly
29
- - **Act II**: Escalate the threat, showing near-death experiences
30
- - **Act III**: Bring the character to the absolute brink before resolution
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *127 Hours*, Aron Ralston is trapped with no rescue coming, making his choice to amputate his arm credible
34
- - ❌ **Bad**: The character is in "danger" but the audience never believes they might actually die
35
-
36
- ---
37
-
38
- ### Rule 2: Force Moral Compromises
39
-
40
- **Description**: Survival must require the character to do things they never thought they would—betray others, kill, abandon values, or sacrifice their humanity.
41
-
42
- **Why It Matters**: Survival without moral cost is just action. The compromises reveal character and create thematic depth.
43
-
44
- **Application**:
45
- - **Act I**: Establish the character's moral code and values
46
- - **Act II**: Force them to violate these values to survive
47
- - **Act III**: Show the cost of these compromises
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *The Road*, the father must decide whether to kill others to protect his son, compromising his humanity
51
- - ❌ **Bad**: The character survives without making any difficult moral choices
52
-
53
- ---
54
-
55
- ### Rule 3: Strip Away Civilization
56
-
57
- **Description**: Survival situations should progressively remove the comforts and rules of civilization, revealing what humans are beneath social conditioning.
58
-
59
- **Why It Matters**: Survival themes explore human nature. Removing civilization reveals core character.
60
-
61
- **Application**:
62
- - **Act I**: Show the character in civilized context
63
- - **Act II**: Progressively remove civilized comforts and rules
64
- - **Act III**: Show the character at their most primal
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *Cast Away*, Chuck Noland loses all civilization—technology, human contact, even language—revealing his core self
68
- - ❌ **Bad**: The character maintains all civilized comforts while supposedly fighting for survival
69
-
70
- ---
71
-
72
- ### Rule 4: Explore What Makes Life Worth Living
73
-
74
- **Description**: Survival stories should question not just how to survive, but why. What makes life worth the struggle?
75
-
76
- **Why It Matters**: Pure survival is empty. The story needs to explore what gives survival meaning.
77
-
78
- **Application**:
79
- - **Act I**: Establish what the character lives for (family, hope, purpose)
80
- - **Act II**: Test whether these reasons are enough to justify the struggle
81
- - **Act III**: Answer what makes survival worthwhile
82
-
83
- **Examples**:
84
- - ✅ **Good**: In *The Revenant*, Glass survives for revenge and to honor his son, giving his suffering meaning
85
- - ❌ **Bad**: The character survives just to survive with no deeper purpose explored
86
-
87
- ---
88
-
89
- ### Rule 5: Show Physical and Psychological Toll
90
-
91
- **Description**: Survival must visibly damage the character—physically through injury and deprivation, psychologically through trauma and moral compromise.
92
-
93
- **Why It Matters**: Survival without cost feels unrealistic. The toll demonstrates the price of living.
94
-
95
- **Application**:
96
- - **Act I**: Establish the character's physical and mental baseline
97
- - **Act II**: Show progressive deterioration
98
- - **Act III**: Demonstrate lasting damage even if they survive
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *Gravity*, Ryan Stone is physically and emotionally battered, with visible trauma
102
- - ❌ **Bad**: The character emerges from survival situation unscathed and unchanged
103
-
104
- ---
105
-
106
- ### Rule 6: Question Whether Survival Is Worth the Cost
107
-
108
- **Description**: The story should explore whether surviving at any cost is worth it, or if some prices are too high.
109
-
110
- **Why It Matters**: This is the central moral question of survival themes.
111
-
112
- **Application**:
113
- - **Act I**: Establish what the character values beyond survival
114
- - **Act II**: Force them to sacrifice these values to survive
115
- - **Act III**: Answer whether survival was worth what it cost
116
-
117
- **Examples**:
118
- - ✅ **Good**: In *The Road*, the question of whether to keep living in a dead world is constantly examined
119
- - ❌ **Bad**: Survival is presented as always worth any cost without questioning this assumption
120
-
121
- ---
122
-
123
- ### Rule 7: Show Resourcefulness and Adaptation
124
-
125
- **Description**: Survival requires ingenuity, adaptation, and using whatever resources are available. Characters must be clever and resourceful.
126
-
127
- **Why It Matters**: Passive survival is boring. Active problem-solving creates engagement.
128
-
129
- **Application**:
130
- - **Act I**: Establish the character's skills and resources
131
- - **Act II**: Show creative problem-solving and adaptation
132
- - **Act III**: Demonstrate ultimate resourcefulness in final crisis
133
-
134
- **Examples**:
135
- - ✅ **Good**: In *The Martian*, Mark Watney uses science and ingenuity to solve each survival problem
136
- - ❌ **Bad**: The character survives through luck or deus ex machina rather than resourcefulness
137
-
138
- ---
139
-
140
- ### Rule 8: Explore What Survival Reveals About Human Nature
141
-
142
- **Description**: Survival situations reveal core character—whether humans are fundamentally good or selfish, cooperative or competitive.
143
-
144
- **Why It Matters**: This is the philosophical heart of survival themes.
145
-
146
- **Application**:
147
- - **Act I**: Establish assumptions about human nature
148
- - **Act II**: Test these assumptions through survival situations
149
- - **Act III**: Answer what survival reveals about humanity
150
-
151
- **Examples**:
152
- - ✅ **Good**: In *Lord of the Flies*, survival reveals the darkness within civilized children
153
- - ❌ **Bad**: Characters behave exactly as expected with no revelation about human nature
154
-
155
- ---
156
-
157
- ## Integration Guidelines
158
-
159
- ### Act I: Setup
160
-
161
- **Thematic Introduction**:
162
- - Establish the character's normal, safe life
163
- - Introduce the survival threat
164
- - Show the character's initial resources and capabilities
165
- - Establish what they have to lose
166
-
167
- **Character Connection**:
168
- - Demonstrate the character's values and moral code
169
- - Show their relationships and what they live for
170
- - Establish their physical and mental baseline
171
- - Reveal their survival skills (or lack thereof)
172
-
173
- **Visual/Symbolic Introduction**:
174
- - Use visual motifs representing safety vs. danger
175
- - Establish symbolic objects that aid or represent survival
176
- - Create visual language for civilization vs. wilderness
177
-
178
- ### Act II: Development
179
-
180
- **Thematic Exploration**:
181
- - Escalate the survival threat progressively
182
- - Force moral compromises and difficult choices
183
- - Show physical and psychological deterioration
184
- - Demonstrate resourcefulness and adaptation
185
-
186
- **Subtext Techniques**:
187
- - Use dialogue that reveals changing priorities
188
- - Show behavioral changes as survival instinct takes over
189
- - Create visual progression showing deterioration
190
- - Use environment as character (hostile nature, space, etc.)
191
-
192
- **Thematic Complications**:
193
- - Resources run out or are lost
194
- - Moral lines must be crossed
195
- - Hope fades and despair threatens
196
- - Other survivors create conflict
197
-
198
- ### Act III: Resolution
199
-
200
- **Thematic Payoff**:
201
- - Present ultimate survival crisis
202
- - Require final sacrifice or moral choice
203
- - Answer whether survival was worth the cost
204
- - Show lasting impact of survival ordeal
205
-
206
- **Avoiding Preachiness**:
207
- - Let actions and consequences speak
208
- - Avoid characters explicitly stating survival themes
209
- - Show complexity—survival can be both triumph and tragedy
210
- - Allow for ambiguity in whether survival was worth it
211
-
212
- ## Character Connection
213
-
214
- ### Protagonist
215
-
216
- **Thematic Relationship**: The protagonist's journey is the fight for survival and what it reveals about them.
217
-
218
- **Arc Integration**: The character arc should reflect transformation through survival ordeal.
219
-
220
- **Key Moments**:
221
- - **Thematic Introduction**: The moment survival is threatened
222
- - **Thematic Challenge**: The moment they must cross moral lines to survive
223
- - **Thematic Resolution**: The moment they survive (or don't) and what it cost
224
-
225
- ### Antagonist
226
-
227
- **Thematic Opposition**: The antagonist is often the environment, nature, or other survivors competing for resources.
228
-
229
- **Thematic Function**: The antagonist represents the forces threatening survival.
230
-
231
- ### Supporting Characters
232
-
233
- **Thematic Mirrors**: Supporting characters represent different survival strategies:
234
- - The character who maintains humanity despite circumstances
235
- - The character who becomes savage
236
- - The character who gives up
237
- - The character who sacrifices themselves
238
-
239
- **Thematic Perspectives**: Different characters embody different beliefs about survival—what's worth sacrificing, what makes life worth living.
240
-
241
- ## Subtext Techniques
242
-
243
- ### Dialogue
244
-
245
- - Characters discuss hope, purpose, and what makes life worth living
246
- - Use metaphors of endurance, strength, and will
247
- - Create conversations about moral choices
248
- - Include moments of doubt about whether to keep fighting
249
-
250
- ### Visual Storytelling
251
-
252
- - **Visual motifs**: Fire, water, shelter representing survival needs
253
- - **Color palette**: Often harsh, desaturated colors
254
- - **Symbolic imagery**: Objects representing hope or civilization
255
- - **Physical deterioration**: Show visible damage to character
256
-
257
- ### Action and Behavior
258
-
259
- - Show increasing desperation and primal behavior
260
- - Demonstrate resourcefulness and problem-solving
261
- - Create moments of moral choice under pressure
262
- - Show physical changes (weight loss, injuries, exhaustion)
263
-
264
- ## Film Examples
265
-
266
- ### Example 1: Cast Away (2000)
267
-
268
- **Director**: Robert Zemeckis
269
-
270
- **Thematic Exploration**: Explores survival in complete isolation, examining what makes life worth living and how humans adapt to extreme circumstances.
271
-
272
- **Key Thematic Moments**:
273
- - **The crash**: Sudden transition from civilization to survival
274
- - **Wilson**: Creating companionship from inanimate object
275
- - **Tooth extraction**: Brutal self-surgery showing desperation
276
- - **Failed suicide**: Choosing to keep living despite hopelessness
277
- - **The escape**: Ultimate resourcefulness and risk
278
- - **Return**: Discovering survival changed him permanently
279
-
280
- **Thematic Resolution**: Survival is possible but transforms the survivor. Chuck returns but can never fully reintegrate.
281
-
282
- **Techniques Used**:
283
- - Minimal dialogue emphasizing isolation
284
- - Visual transformation (physical deterioration)
285
- - Wilson as symbol of human need for connection
286
- - Time passage showing adaptation
287
- - Contrast between before and after
288
-
289
- ---
290
-
291
- ### Example 2: The Revenant (2015)
292
-
293
- **Director**: Alejandro González Iñárritu
294
-
295
- **Thematic Exploration**: Explores survival driven by revenge, examining what humans can endure and what makes survival worthwhile.
296
-
297
- **Key Thematic Moments**:
298
- - **Bear attack**: Brutal establishment of survival threat
299
- - **Burial alive**: Ultimate vulnerability
300
- - **Crawling journey**: Extreme physical endurance
301
- - **Eating raw bison**: Crossing civilized boundaries
302
- - **Final confrontation**: Revenge as survival purpose
303
- - **Letting go**: Choosing to live rather than die with revenge
304
-
305
- **Thematic Resolution**: Survival requires becoming almost inhuman, but humanity can be reclaimed.
306
-
307
- **Techniques Used**:
308
- - Natural lighting emphasizing harsh environment
309
- - Long takes showing physical ordeal
310
- - Minimal dialogue emphasizing primal struggle
311
- - Environment as antagonist
312
- - Revenge as survival motivation
313
-
314
- ---
315
-
316
- ### Example 3: 127 Hours (2010)
317
-
318
- **Director**: Danny Boyle
319
-
320
- **Thematic Exploration**: Explores survival in impossible circumstances, examining what someone will sacrifice to live.
321
-
322
- **Key Thematic Moments**:
323
- - **The fall**: Sudden entrapment
324
- - **Failed escape attempts**: Desperation and resourcefulness
325
- - **Video messages**: Confronting mortality
326
- - **Hallucinations**: Psychological deterioration
327
- - **The amputation**: Ultimate sacrifice for survival
328
- - **Rebirth**: Emerging transformed
329
-
330
- **Thematic Resolution**: Survival requires unthinkable sacrifice but leads to appreciation for life.
331
-
332
- **Techniques Used**:
333
- - Claustrophobic framing emphasizing entrapment
334
- - Split screens showing mental state
335
- - Hallucinations revealing psychology
336
- - Real-time tension building
337
- - Physical transformation
338
-
339
- ---
340
-
341
- ### Example 4: The Road (2009)
342
-
343
- **Director**: John Hillcoat
344
-
345
- **Thematic Exploration**: Explores survival in post-apocalyptic world, questioning whether survival in a dead world is worth it.
346
-
347
- **Key Thematic Moments**:
348
- - **The gray world**: Establishing hopeless environment
349
- - **"Carrying the fire"**: Maintaining humanity as survival purpose
350
- - **Cannibal encounters**: Showing what others become
351
- - **The bunker**: Temporary hope and resources
352
- - **The father's death**: Passing survival to next generation
353
- - **Finding the family**: Hope that humanity survives
354
-
355
- **Thematic Resolution**: Survival is worth it if humanity and hope are maintained, not just physical life.
356
-
357
- **Techniques Used**:
358
- - Desaturated color palette
359
- - Father-son relationship as survival purpose
360
- - Contrast between maintaining humanity and becoming savage
361
- - Sparse dialogue emphasizing bleakness
362
- - Ambiguous hopeful ending
363
-
364
- ---
365
-
366
- ### Example 5: Gravity (2013)
367
-
368
- **Director**: Alfonso Cuarón
369
-
370
- **Thematic Exploration**: Explores survival in space, examining the will to live and overcoming despair.
371
-
372
- **Key Thematic Moments**:
373
- - **The debris strike**: Sudden survival crisis
374
- - **Drifting in space**: Ultimate vulnerability
375
- - **Oxygen running out**: Escalating threat
376
- - **Giving up**: Moment of despair and acceptance of death
377
- - **Hallucination of Matt**: Choosing to fight for life
378
- - **Rebirth on Earth**: Survival as transformation
379
-
380
- **Thematic Resolution**: Survival requires choosing to live even when giving up seems easier.
381
-
382
- **Techniques Used**:
383
- - Continuous shots creating real-time tension
384
- - Silence of space emphasizing isolation
385
- - Visual symbolism (fetal position, rebirth)
386
- - Minimal cast focusing on individual struggle
387
- - Earth as symbol of life and hope
388
-
389
- ---
390
-
391
- ## Integration with Other Features
392
-
393
- ### Compatible Genres
394
-
395
- - **Thriller**: Survival creates inherent suspense
396
- - **Adventure**: Survival in exotic or dangerous locations
397
- - **Science Fiction**: Survival in space or future scenarios
398
- - **Horror**: Survival against supernatural threats
399
- - **War**: Survival in combat situations
400
- - **Drama**: Psychological survival
401
-
402
- ### Compatible Themes (Multi-Theme Stories)
403
-
404
- - **Resilience**: Survival demonstrates resilience
405
- - **Hope**: What keeps people fighting to survive
406
- - **Humanity**: What makes us human under pressure
407
- - **Sacrifice**: What must be sacrificed to survive
408
- - **Nature**: Humans vs. natural world
409
- - **Isolation**: Survival often involves isolation
410
-
411
- ### Compatible Styles
412
-
413
- - **Minimalist**: Stripped-down focus on survival essentials
414
- - **Real-time**: Heightens tension and immediacy
415
- - **Character-Driven**: Focuses on psychological survival
416
- - **Action-Driven**: Emphasizes physical survival challenges
417
-
418
- ## Common Pitfalls
419
-
420
- ### Pitfall 1: Survival Without Stakes
421
-
422
- **Problem**: The audience never believes the character might actually die.
423
-
424
- **Solution**: Create genuine life-or-death stakes with real possibility of failure.
425
-
426
- **Example**: Show near-death experiences and escalating threats.
427
-
428
- ---
429
-
430
- ### Pitfall 2: Survival Without Cost
431
-
432
- **Problem**: Character survives without moral compromise or lasting damage.
433
-
434
- **Solution**: Force moral choices and show physical/psychological toll.
435
-
436
- **Example**: Require the character to do terrible things to survive and show lasting trauma.
437
-
438
- ---
439
-
440
- ### Pitfall 3: Passive Survival
441
-
442
- **Problem**: Character survives through luck rather than resourcefulness.
443
-
444
- **Solution**: Show active problem-solving and clever adaptation.
445
-
446
- **Example**: Demonstrate the character using skills and ingenuity to overcome each obstacle.
447
-
448
- ---
449
-
450
- ### Pitfall 4: Survival Without Purpose
451
-
452
- **Problem**: Character survives just to survive with no deeper meaning explored.
453
-
454
- **Solution**: Explore what makes survival worthwhile.
455
-
456
- **Example**: Show what the character is surviving for—family, hope, revenge, purpose.
457
-
458
- ---
459
-
460
- ### Pitfall 5: Unchanged Survivor
461
-
462
- **Problem**: Character emerges from survival ordeal completely unchanged.
463
-
464
- **Solution**: Show lasting physical and psychological transformation.
465
-
466
- **Example**: Demonstrate that survival permanently changes the character.
467
-
468
- ---
469
-
470
- ## Best Practices
471
-
472
- 1. **Create genuine stakes** - Death must be a real possibility
473
- 2. **Force moral compromises** - Survival requires crossing lines
474
- 3. **Strip away civilization** - Reveal core human nature
475
- 4. **Explore purpose** - What makes survival worthwhile?
476
- 5. **Show physical/psychological toll** - Survival damages the survivor
477
- 6. **Question the cost** - Is survival worth any price?
478
- 7. **Demonstrate resourcefulness** - Active problem-solving, not luck
479
- 8. **Reveal human nature** - What does survival show about humanity?
480
- 9. **Use visual storytelling** - Show deterioration and struggle
481
- 10. **Avoid easy answers** - Survival is complex, not simple triumph
482
-
483
- ## Resources
484
-
485
- - *Deep Survival* by Laurence Gonzales - Psychology of survival
486
- - *The Anatomy of Story* by John Truby - Survival as story type
487
- - *Story* by Robert McKee - Survival narratives
488
- - *Into the Woods* by John Yorke - Survival and story structure
489
- - *The Hero with a Thousand Faces* by Joseph Campbell - Survival in mythic journey
490
-
491
- ---
492
-
493
- **Depth Coverage**: 85%
494
- **Last Updated**: 2026-01-31
495
- **Version**: 1.0.0
496
-
1
+ # Survival Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ The survival theme explores the human will to live and what people become when survival is threatened. It examines the choices people make under extreme pressure, what they're willing to sacrifice to survive, and whether survival at any cost is worth it.
10
+
11
+ ## Core Concept
12
+
13
+ Survival in storytelling represents the most primal human drive—the will to live. It explores how extreme circumstances strip away civilization and reveal core human nature, examining whether survival brings out our best or worst, and what moral lines we'll cross when life is at stake.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of survival explores what humans become when life is threatened, examining the moral compromises survival demands and whether living at any cost is worth it.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Create Genuine Life-or-Death Stakes
22
+
23
+ **Description**: The threat to survival must be real, immediate, and inescapable. The audience must believe the character could actually die.
24
+
25
+ **Why It Matters**: Survival stories without genuine stakes become adventure stories. Death must be a real possibility.
26
+
27
+ **Application**:
28
+ - **Act I**: Establish the life-threatening situation clearly
29
+ - **Act II**: Escalate the threat, showing near-death experiences
30
+ - **Act III**: Bring the character to the absolute brink before resolution
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *127 Hours*, Aron Ralston is trapped with no rescue coming, making his choice to amputate his arm credible
34
+ - ❌ **Bad**: The character is in "danger" but the audience never believes they might actually die
35
+
36
+ ---
37
+
38
+ ### Rule 2: Force Moral Compromises
39
+
40
+ **Description**: Survival must require the character to do things they never thought they would—betray others, kill, abandon values, or sacrifice their humanity.
41
+
42
+ **Why It Matters**: Survival without moral cost is just action. The compromises reveal character and create thematic depth.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish the character's moral code and values
46
+ - **Act II**: Force them to violate these values to survive
47
+ - **Act III**: Show the cost of these compromises
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *The Road*, the father must decide whether to kill others to protect his son, compromising his humanity
51
+ - ❌ **Bad**: The character survives without making any difficult moral choices
52
+
53
+ ---
54
+
55
+ ### Rule 3: Strip Away Civilization
56
+
57
+ **Description**: Survival situations should progressively remove the comforts and rules of civilization, revealing what humans are beneath social conditioning.
58
+
59
+ **Why It Matters**: Survival themes explore human nature. Removing civilization reveals core character.
60
+
61
+ **Application**:
62
+ - **Act I**: Show the character in civilized context
63
+ - **Act II**: Progressively remove civilized comforts and rules
64
+ - **Act III**: Show the character at their most primal
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *Cast Away*, Chuck Noland loses all civilization—technology, human contact, even language—revealing his core self
68
+ - ❌ **Bad**: The character maintains all civilized comforts while supposedly fighting for survival
69
+
70
+ ---
71
+
72
+ ### Rule 4: Explore What Makes Life Worth Living
73
+
74
+ **Description**: Survival stories should question not just how to survive, but why. What makes life worth the struggle?
75
+
76
+ **Why It Matters**: Pure survival is empty. The story needs to explore what gives survival meaning.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish what the character lives for (family, hope, purpose)
80
+ - **Act II**: Test whether these reasons are enough to justify the struggle
81
+ - **Act III**: Answer what makes survival worthwhile
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *The Revenant*, Glass survives for revenge and to honor his son, giving his suffering meaning
85
+ - ❌ **Bad**: The character survives just to survive with no deeper purpose explored
86
+
87
+ ---
88
+
89
+ ### Rule 5: Show Physical and Psychological Toll
90
+
91
+ **Description**: Survival must visibly damage the character—physically through injury and deprivation, psychologically through trauma and moral compromise.
92
+
93
+ **Why It Matters**: Survival without cost feels unrealistic. The toll demonstrates the price of living.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish the character's physical and mental baseline
97
+ - **Act II**: Show progressive deterioration
98
+ - **Act III**: Demonstrate lasting damage even if they survive
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *Gravity*, Ryan Stone is physically and emotionally battered, with visible trauma
102
+ - ❌ **Bad**: The character emerges from survival situation unscathed and unchanged
103
+
104
+ ---
105
+
106
+ ### Rule 6: Question Whether Survival Is Worth the Cost
107
+
108
+ **Description**: The story should explore whether surviving at any cost is worth it, or if some prices are too high.
109
+
110
+ **Why It Matters**: This is the central moral question of survival themes.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish what the character values beyond survival
114
+ - **Act II**: Force them to sacrifice these values to survive
115
+ - **Act III**: Answer whether survival was worth what it cost
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *The Road*, the question of whether to keep living in a dead world is constantly examined
119
+ - ❌ **Bad**: Survival is presented as always worth any cost without questioning this assumption
120
+
121
+ ---
122
+
123
+ ### Rule 7: Show Resourcefulness and Adaptation
124
+
125
+ **Description**: Survival requires ingenuity, adaptation, and using whatever resources are available. Characters must be clever and resourceful.
126
+
127
+ **Why It Matters**: Passive survival is boring. Active problem-solving creates engagement.
128
+
129
+ **Application**:
130
+ - **Act I**: Establish the character's skills and resources
131
+ - **Act II**: Show creative problem-solving and adaptation
132
+ - **Act III**: Demonstrate ultimate resourcefulness in final crisis
133
+
134
+ **Examples**:
135
+ - ✅ **Good**: In *The Martian*, Mark Watney uses science and ingenuity to solve each survival problem
136
+ - ❌ **Bad**: The character survives through luck or deus ex machina rather than resourcefulness
137
+
138
+ ---
139
+
140
+ ### Rule 8: Explore What Survival Reveals About Human Nature
141
+
142
+ **Description**: Survival situations reveal core character—whether humans are fundamentally good or selfish, cooperative or competitive.
143
+
144
+ **Why It Matters**: This is the philosophical heart of survival themes.
145
+
146
+ **Application**:
147
+ - **Act I**: Establish assumptions about human nature
148
+ - **Act II**: Test these assumptions through survival situations
149
+ - **Act III**: Answer what survival reveals about humanity
150
+
151
+ **Examples**:
152
+ - ✅ **Good**: In *Lord of the Flies*, survival reveals the darkness within civilized children
153
+ - ❌ **Bad**: Characters behave exactly as expected with no revelation about human nature
154
+
155
+ ---
156
+
157
+ ## Integration Guidelines
158
+
159
+ ### Act I: Setup
160
+
161
+ **Thematic Introduction**:
162
+ - Establish the character's normal, safe life
163
+ - Introduce the survival threat
164
+ - Show the character's initial resources and capabilities
165
+ - Establish what they have to lose
166
+
167
+ **Character Connection**:
168
+ - Demonstrate the character's values and moral code
169
+ - Show their relationships and what they live for
170
+ - Establish their physical and mental baseline
171
+ - Reveal their survival skills (or lack thereof)
172
+
173
+ **Visual/Symbolic Introduction**:
174
+ - Use visual motifs representing safety vs. danger
175
+ - Establish symbolic objects that aid or represent survival
176
+ - Create visual language for civilization vs. wilderness
177
+
178
+ ### Act II: Development
179
+
180
+ **Thematic Exploration**:
181
+ - Escalate the survival threat progressively
182
+ - Force moral compromises and difficult choices
183
+ - Show physical and psychological deterioration
184
+ - Demonstrate resourcefulness and adaptation
185
+
186
+ **Subtext Techniques**:
187
+ - Use dialogue that reveals changing priorities
188
+ - Show behavioral changes as survival instinct takes over
189
+ - Create visual progression showing deterioration
190
+ - Use environment as character (hostile nature, space, etc.)
191
+
192
+ **Thematic Complications**:
193
+ - Resources run out or are lost
194
+ - Moral lines must be crossed
195
+ - Hope fades and despair threatens
196
+ - Other survivors create conflict
197
+
198
+ ### Act III: Resolution
199
+
200
+ **Thematic Payoff**:
201
+ - Present ultimate survival crisis
202
+ - Require final sacrifice or moral choice
203
+ - Answer whether survival was worth the cost
204
+ - Show lasting impact of survival ordeal
205
+
206
+ **Avoiding Preachiness**:
207
+ - Let actions and consequences speak
208
+ - Avoid characters explicitly stating survival themes
209
+ - Show complexity—survival can be both triumph and tragedy
210
+ - Allow for ambiguity in whether survival was worth it
211
+
212
+ ## Character Connection
213
+
214
+ ### Protagonist
215
+
216
+ **Thematic Relationship**: The protagonist's journey is the fight for survival and what it reveals about them.
217
+
218
+ **Arc Integration**: The character arc should reflect transformation through survival ordeal.
219
+
220
+ **Key Moments**:
221
+ - **Thematic Introduction**: The moment survival is threatened
222
+ - **Thematic Challenge**: The moment they must cross moral lines to survive
223
+ - **Thematic Resolution**: The moment they survive (or don't) and what it cost
224
+
225
+ ### Antagonist
226
+
227
+ **Thematic Opposition**: The antagonist is often the environment, nature, or other survivors competing for resources.
228
+
229
+ **Thematic Function**: The antagonist represents the forces threatening survival.
230
+
231
+ ### Supporting Characters
232
+
233
+ **Thematic Mirrors**: Supporting characters represent different survival strategies:
234
+ - The character who maintains humanity despite circumstances
235
+ - The character who becomes savage
236
+ - The character who gives up
237
+ - The character who sacrifices themselves
238
+
239
+ **Thematic Perspectives**: Different characters embody different beliefs about survival—what's worth sacrificing, what makes life worth living.
240
+
241
+ ## Subtext Techniques
242
+
243
+ ### Dialogue
244
+
245
+ - Characters discuss hope, purpose, and what makes life worth living
246
+ - Use metaphors of endurance, strength, and will
247
+ - Create conversations about moral choices
248
+ - Include moments of doubt about whether to keep fighting
249
+
250
+ ### Visual Storytelling
251
+
252
+ - **Visual motifs**: Fire, water, shelter representing survival needs
253
+ - **Color palette**: Often harsh, desaturated colors
254
+ - **Symbolic imagery**: Objects representing hope or civilization
255
+ - **Physical deterioration**: Show visible damage to character
256
+
257
+ ### Action and Behavior
258
+
259
+ - Show increasing desperation and primal behavior
260
+ - Demonstrate resourcefulness and problem-solving
261
+ - Create moments of moral choice under pressure
262
+ - Show physical changes (weight loss, injuries, exhaustion)
263
+
264
+ ## Film Examples
265
+
266
+ ### Example 1: Cast Away (2000)
267
+
268
+ **Director**: Robert Zemeckis
269
+
270
+ **Thematic Exploration**: Explores survival in complete isolation, examining what makes life worth living and how humans adapt to extreme circumstances.
271
+
272
+ **Key Thematic Moments**:
273
+ - **The crash**: Sudden transition from civilization to survival
274
+ - **Wilson**: Creating companionship from inanimate object
275
+ - **Tooth extraction**: Brutal self-surgery showing desperation
276
+ - **Failed suicide**: Choosing to keep living despite hopelessness
277
+ - **The escape**: Ultimate resourcefulness and risk
278
+ - **Return**: Discovering survival changed him permanently
279
+
280
+ **Thematic Resolution**: Survival is possible but transforms the survivor. Chuck returns but can never fully reintegrate.
281
+
282
+ **Techniques Used**:
283
+ - Minimal dialogue emphasizing isolation
284
+ - Visual transformation (physical deterioration)
285
+ - Wilson as symbol of human need for connection
286
+ - Time passage showing adaptation
287
+ - Contrast between before and after
288
+
289
+ ---
290
+
291
+ ### Example 2: The Revenant (2015)
292
+
293
+ **Director**: Alejandro González Iñárritu
294
+
295
+ **Thematic Exploration**: Explores survival driven by revenge, examining what humans can endure and what makes survival worthwhile.
296
+
297
+ **Key Thematic Moments**:
298
+ - **Bear attack**: Brutal establishment of survival threat
299
+ - **Burial alive**: Ultimate vulnerability
300
+ - **Crawling journey**: Extreme physical endurance
301
+ - **Eating raw bison**: Crossing civilized boundaries
302
+ - **Final confrontation**: Revenge as survival purpose
303
+ - **Letting go**: Choosing to live rather than die with revenge
304
+
305
+ **Thematic Resolution**: Survival requires becoming almost inhuman, but humanity can be reclaimed.
306
+
307
+ **Techniques Used**:
308
+ - Natural lighting emphasizing harsh environment
309
+ - Long takes showing physical ordeal
310
+ - Minimal dialogue emphasizing primal struggle
311
+ - Environment as antagonist
312
+ - Revenge as survival motivation
313
+
314
+ ---
315
+
316
+ ### Example 3: 127 Hours (2010)
317
+
318
+ **Director**: Danny Boyle
319
+
320
+ **Thematic Exploration**: Explores survival in impossible circumstances, examining what someone will sacrifice to live.
321
+
322
+ **Key Thematic Moments**:
323
+ - **The fall**: Sudden entrapment
324
+ - **Failed escape attempts**: Desperation and resourcefulness
325
+ - **Video messages**: Confronting mortality
326
+ - **Hallucinations**: Psychological deterioration
327
+ - **The amputation**: Ultimate sacrifice for survival
328
+ - **Rebirth**: Emerging transformed
329
+
330
+ **Thematic Resolution**: Survival requires unthinkable sacrifice but leads to appreciation for life.
331
+
332
+ **Techniques Used**:
333
+ - Claustrophobic framing emphasizing entrapment
334
+ - Split screens showing mental state
335
+ - Hallucinations revealing psychology
336
+ - Real-time tension building
337
+ - Physical transformation
338
+
339
+ ---
340
+
341
+ ### Example 4: The Road (2009)
342
+
343
+ **Director**: John Hillcoat
344
+
345
+ **Thematic Exploration**: Explores survival in post-apocalyptic world, questioning whether survival in a dead world is worth it.
346
+
347
+ **Key Thematic Moments**:
348
+ - **The gray world**: Establishing hopeless environment
349
+ - **"Carrying the fire"**: Maintaining humanity as survival purpose
350
+ - **Cannibal encounters**: Showing what others become
351
+ - **The bunker**: Temporary hope and resources
352
+ - **The father's death**: Passing survival to next generation
353
+ - **Finding the family**: Hope that humanity survives
354
+
355
+ **Thematic Resolution**: Survival is worth it if humanity and hope are maintained, not just physical life.
356
+
357
+ **Techniques Used**:
358
+ - Desaturated color palette
359
+ - Father-son relationship as survival purpose
360
+ - Contrast between maintaining humanity and becoming savage
361
+ - Sparse dialogue emphasizing bleakness
362
+ - Ambiguous hopeful ending
363
+
364
+ ---
365
+
366
+ ### Example 5: Gravity (2013)
367
+
368
+ **Director**: Alfonso Cuarón
369
+
370
+ **Thematic Exploration**: Explores survival in space, examining the will to live and overcoming despair.
371
+
372
+ **Key Thematic Moments**:
373
+ - **The debris strike**: Sudden survival crisis
374
+ - **Drifting in space**: Ultimate vulnerability
375
+ - **Oxygen running out**: Escalating threat
376
+ - **Giving up**: Moment of despair and acceptance of death
377
+ - **Hallucination of Matt**: Choosing to fight for life
378
+ - **Rebirth on Earth**: Survival as transformation
379
+
380
+ **Thematic Resolution**: Survival requires choosing to live even when giving up seems easier.
381
+
382
+ **Techniques Used**:
383
+ - Continuous shots creating real-time tension
384
+ - Silence of space emphasizing isolation
385
+ - Visual symbolism (fetal position, rebirth)
386
+ - Minimal cast focusing on individual struggle
387
+ - Earth as symbol of life and hope
388
+
389
+ ---
390
+
391
+ ## Integration with Other Features
392
+
393
+ ### Compatible Genres
394
+
395
+ - **Thriller**: Survival creates inherent suspense
396
+ - **Adventure**: Survival in exotic or dangerous locations
397
+ - **Science Fiction**: Survival in space or future scenarios
398
+ - **Horror**: Survival against supernatural threats
399
+ - **War**: Survival in combat situations
400
+ - **Drama**: Psychological survival
401
+
402
+ ### Compatible Themes (Multi-Theme Stories)
403
+
404
+ - **Resilience**: Survival demonstrates resilience
405
+ - **Hope**: What keeps people fighting to survive
406
+ - **Humanity**: What makes us human under pressure
407
+ - **Sacrifice**: What must be sacrificed to survive
408
+ - **Nature**: Humans vs. natural world
409
+ - **Isolation**: Survival often involves isolation
410
+
411
+ ### Compatible Styles
412
+
413
+ - **Minimalist**: Stripped-down focus on survival essentials
414
+ - **Real-time**: Heightens tension and immediacy
415
+ - **Character-Driven**: Focuses on psychological survival
416
+ - **Action-Driven**: Emphasizes physical survival challenges
417
+
418
+ ## Common Pitfalls
419
+
420
+ ### Pitfall 1: Survival Without Stakes
421
+
422
+ **Problem**: The audience never believes the character might actually die.
423
+
424
+ **Solution**: Create genuine life-or-death stakes with real possibility of failure.
425
+
426
+ **Example**: Show near-death experiences and escalating threats.
427
+
428
+ ---
429
+
430
+ ### Pitfall 2: Survival Without Cost
431
+
432
+ **Problem**: Character survives without moral compromise or lasting damage.
433
+
434
+ **Solution**: Force moral choices and show physical/psychological toll.
435
+
436
+ **Example**: Require the character to do terrible things to survive and show lasting trauma.
437
+
438
+ ---
439
+
440
+ ### Pitfall 3: Passive Survival
441
+
442
+ **Problem**: Character survives through luck rather than resourcefulness.
443
+
444
+ **Solution**: Show active problem-solving and clever adaptation.
445
+
446
+ **Example**: Demonstrate the character using skills and ingenuity to overcome each obstacle.
447
+
448
+ ---
449
+
450
+ ### Pitfall 4: Survival Without Purpose
451
+
452
+ **Problem**: Character survives just to survive with no deeper meaning explored.
453
+
454
+ **Solution**: Explore what makes survival worthwhile.
455
+
456
+ **Example**: Show what the character is surviving for—family, hope, revenge, purpose.
457
+
458
+ ---
459
+
460
+ ### Pitfall 5: Unchanged Survivor
461
+
462
+ **Problem**: Character emerges from survival ordeal completely unchanged.
463
+
464
+ **Solution**: Show lasting physical and psychological transformation.
465
+
466
+ **Example**: Demonstrate that survival permanently changes the character.
467
+
468
+ ---
469
+
470
+ ## Best Practices
471
+
472
+ 1. **Create genuine stakes** - Death must be a real possibility
473
+ 2. **Force moral compromises** - Survival requires crossing lines
474
+ 3. **Strip away civilization** - Reveal core human nature
475
+ 4. **Explore purpose** - What makes survival worthwhile?
476
+ 5. **Show physical/psychological toll** - Survival damages the survivor
477
+ 6. **Question the cost** - Is survival worth any price?
478
+ 7. **Demonstrate resourcefulness** - Active problem-solving, not luck
479
+ 8. **Reveal human nature** - What does survival show about humanity?
480
+ 9. **Use visual storytelling** - Show deterioration and struggle
481
+ 10. **Avoid easy answers** - Survival is complex, not simple triumph
482
+
483
+ ## Resources
484
+
485
+ - *Deep Survival* by Laurence Gonzales - Psychology of survival
486
+ - *The Anatomy of Story* by John Truby - Survival as story type
487
+ - *Story* by Robert McKee - Survival narratives
488
+ - *Into the Woods* by John Yorke - Survival and story structure
489
+ - *The Hero with a Thousand Faces* by Joseph Campbell - Survival in mythic journey
490
+
491
+ ---
492
+
493
+ **Depth Coverage**: 85%
494
+ **Last Updated**: 2026-01-31
495
+ **Version**: 1.0.0
496
+