@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,464 +1,464 @@
1
- # Isolation Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: Medium
6
-
7
- ## Overview
8
-
9
- The isolation theme explores physical or emotional separation from others, examining the effects of loneliness, the human need for connection, and whether isolation is chosen or imposed.
10
-
11
- ## Core Concept
12
-
13
- Isolation in storytelling represents separation from human connection—whether physical (stranded, imprisoned) or emotional (alienated, misunderstood). It explores the psychological effects of loneliness, the desperate need for connection, and the question of whether isolation destroys or reveals the self.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of isolation explores the effects of separation from human connection, examining whether isolation destroys or reveals the self, and what drives the need for belonging.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Establish What Connection Means
22
-
23
- **Description**: Before exploring isolation, establish what the character has lost—relationships, community, understanding, or belonging.
24
-
25
- **Why It Matters**: Isolation has no impact without understanding what's missing.
26
-
27
- **Application**:
28
- - **Act I**: Show the character's connections before isolation or what they lack
29
- - **Act II**: Demonstrate the absence of connection
30
- - **Act III**: Resolve whether connection is restored or isolation accepted
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *Cast Away*, we see Chuck's life and relationships before isolation, making the loss meaningful
34
- - ❌ **Bad**: The character is isolated but we never understand what they're missing
35
-
36
- ---
37
-
38
- ### Rule 2: Differentiate Physical and Emotional Isolation
39
-
40
- **Description**: Isolation can be physical (alone in space, stranded) or emotional (surrounded by people but disconnected). Each has different dynamics.
41
-
42
- **Why It Matters**: Different types of isolation create different stories and challenges.
43
-
44
- **Application**:
45
- - **Act I**: Establish which type of isolation (or both) the character faces
46
- - **Act II**: Explore the specific challenges of that isolation type
47
- - **Act III**: Resolve the isolation in ways specific to its type
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *Her*, Theodore is emotionally isolated despite being surrounded by people
51
- - ❌ **Bad**: All isolation is treated identically regardless of type
52
-
53
- ---
54
-
55
- ### Rule 3: Show Psychological Effects
56
-
57
- **Description**: Isolation must visibly affect the character's mental state—through loneliness, desperation, hallucination, or personality changes.
58
-
59
- **Why It Matters**: Isolation without psychological impact feels unrealistic.
60
-
61
- **Application**:
62
- - **Act I**: Establish the character's baseline mental state
63
- - **Act II**: Show progressive psychological deterioration or adaptation
64
- - **Act III**: Demonstrate lasting psychological effects
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *The Shining*, Jack's isolation leads to progressive madness
68
- - ❌ **Bad**: The character is isolated but mentally unchanged
69
-
70
- ---
71
-
72
- ### Rule 4: Create Desperate Attempts at Connection
73
-
74
- **Description**: Isolated characters should desperately seek connection—creating imaginary companions, talking to objects, or risking everything for human contact.
75
-
76
- **Why It Matters**: This demonstrates the fundamental human need for connection.
77
-
78
- **Application**:
79
- - **Act I**: Establish the character's social nature
80
- - **Act II**: Show increasingly desperate attempts to connect
81
- - **Act III**: Resolve whether connection is achieved or isolation accepted
82
-
83
- **Examples**:
84
- - ✅ **Good**: In *Cast Away*, Chuck creates Wilson as a companion, showing desperate need for connection
85
- - ❌ **Bad**: The character is content alone with no desire for connection
86
-
87
- ---
88
-
89
- ### Rule 5: Explore Whether Isolation Is Chosen or Imposed
90
-
91
- **Description**: Isolation can be forced (imprisonment, abandonment) or chosen (withdrawal, self-protection). Each raises different questions.
92
-
93
- **Why It Matters**: Chosen vs. imposed isolation creates different moral and psychological dynamics.
94
-
95
- **Application**:
96
- - **Act I**: Establish whether isolation is chosen or imposed
97
- - **Act II**: Explore the reasons for chosen isolation or attempts to escape imposed isolation
98
- - **Act III**: Resolve whether the character chooses connection or continued isolation
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *Into the Wild*, Chris chooses isolation to escape society, raising questions about that choice
102
- - ❌ **Bad**: The story doesn't explore why the character is isolated
103
-
104
- ---
105
-
106
- ### Rule 6: Question Whether Isolation Reveals or Destroys
107
-
108
- **Description**: The story should explore whether isolation strips away false self to reveal truth, or whether it destroys the self entirely.
109
-
110
- **Why It Matters**: This is the central philosophical question of isolation themes.
111
-
112
- **Application**:
113
- - **Act I**: Establish the character's social self
114
- - **Act II**: Show isolation revealing or destroying aspects of self
115
- - **Act III**: Answer whether isolation was revelatory or destructive
116
-
117
- **Examples**:
118
- - ✅ **Good**: In *Moon*, Sam's isolation reveals uncomfortable truths about his identity
119
- - ❌ **Bad**: Isolation has no effect on self-understanding
120
-
121
- ---
122
-
123
- ## Integration Guidelines
124
-
125
- ### Act I: Setup
126
-
127
- **Thematic Introduction**:
128
- - Establish the character's isolated state (physical, emotional, or social)
129
- - Show what caused the isolation or why it exists
130
- - Demonstrate the character's relationship with their isolation
131
- - Introduce the possibility of connection or deeper isolation
132
-
133
- **Character Connection**:
134
- - Show whether isolation is chosen or imposed
135
- - Demonstrate what the character has lost or never had
136
- - Establish their coping mechanisms for loneliness
137
- - Reveal their desire for or fear of connection
138
-
139
- **Visual/Symbolic Introduction**:
140
- - Use visual motifs representing isolation (empty spaces, barriers, distance)
141
- - Establish symbolic objects that represent connection or separation
142
- - Create visual language for loneliness vs. connection
143
-
144
- ### Act II: Development
145
-
146
- **Thematic Exploration**:
147
- - Deepen the isolation or introduce opportunities for connection
148
- - Show the psychological effects of prolonged isolation
149
- - Create situations that test whether the character will remain isolated
150
- - Demonstrate the cost of isolation and the risk of connection
151
-
152
- **Subtext Techniques**:
153
- - Use dialogue (or lack thereof) to emphasize isolation
154
- - Show behavioral changes from loneliness
155
- - Create visual progression showing increasing isolation or gradual connection
156
- - Use environment to reflect emotional isolation
157
-
158
- **Thematic Complications**:
159
- - Opportunities for connection are rejected or sabotaged
160
- - Isolation becomes comfortable or terrifying
161
- - The character's isolation affects others
162
- - Connection requires vulnerability the character fears
163
-
164
- ### Act III: Resolution
165
-
166
- **Thematic Payoff**:
167
- - Present the ultimate choice between isolation and connection
168
- - Reveal whether the character can overcome their isolation
169
- - Answer whether isolation was protective or destructive
170
- - Demonstrate the consequences of remaining isolated or connecting
171
-
172
- **Avoiding Preachiness**:
173
- - Let actions and consequences demonstrate theme
174
- - Avoid characters explicitly stating "isolation is bad"
175
- - Show complexity—isolation can be both refuge and prison
176
- - Allow for ambiguity in whether connection is achieved
177
-
178
- ## Character Connection
179
-
180
- ### Protagonist
181
-
182
- **Thematic Relationship**: The protagonist's journey explores their relationship with isolation and their ability or inability to connect.
183
-
184
- **Arc Integration**: The character arc should reflect movement toward or away from connection, or acceptance of isolation.
185
-
186
- **Key Moments**:
187
- - **Thematic Introduction**: The moment we see their isolated state
188
- - **Thematic Challenge**: The moment they must choose between isolation and connection
189
- - **Thematic Resolution**: The moment they connect or accept permanent isolation
190
-
191
- ### Antagonist
192
-
193
- **Thematic Opposition**: The antagonist may represent forces that isolate the protagonist, or the protagonist's own fear of connection.
194
-
195
- **Thematic Function**: The antagonist tests whether the protagonist can overcome isolation or will remain alone.
196
-
197
- ### Supporting Characters
198
-
199
- **Thematic Mirrors**: Supporting characters represent different relationships with isolation:
200
- - The character who overcame isolation
201
- - The character who chose isolation and regrets it
202
- - The character who offers connection
203
- - The character who represents what isolation costs
204
-
205
- **Thematic Perspectives**: Different characters embody different beliefs about isolation—whether it's safety or prison, choice or curse.
206
-
207
- ## Subtext Techniques
208
-
209
- ### Dialogue
210
-
211
- - Sparse dialogue emphasizing isolation
212
- - Characters struggle to communicate after prolonged isolation
213
- - Use metaphors of distance, walls, islands
214
- - Create conversations where connection is attempted but difficult
215
- - Include moments of silence that speak volumes
216
-
217
- ### Visual Storytelling
218
-
219
- - **Visual motifs**: Empty spaces, barriers, windows, distance
220
- - **Color palette**: Often desaturated or monochromatic
221
- - **Symbolic imagery**: Islands, walls, glass, empty rooms
222
- - **Framing**: Character alone in frame, separated from others
223
-
224
- ### Action and Behavior
225
-
226
- - Show routines of isolated life
227
- - Demonstrate difficulty with social interaction
228
- - Create moments where character withdraws from connection
229
- - Show physical manifestations of isolation (talking to self, objects as companions)
230
-
231
- ## Film Examples
232
-
233
- ### Example 1: Cast Away (2000)
234
-
235
- **Director**: Robert Zemeckis
236
-
237
- **Thematic Exploration**: Explores extreme physical isolation, examining human need for connection and what isolation does to the psyche.
238
-
239
- **Key Thematic Moments**:
240
- - **The crash**: Sudden complete isolation
241
- - **Wilson**: Creating companionship from inanimate object
242
- - **Talking to Wilson**: Isolation driving need for connection
243
- - **Losing Wilson**: Devastating loss of only "companion"
244
- - **Return**: Discovering isolation changed him permanently
245
- - **Final crossroads**: Choosing new direction after isolation
246
-
247
- **Thematic Resolution**: Isolation reveals human need for connection. Even after rescue, the isolated person is forever changed.
248
-
249
- **Techniques Used**:
250
- - Minimal dialogue emphasizing isolation
251
- - Wilson as symbol of human need for connection
252
- - Visual emptiness of island
253
- - Time passage showing adaptation to isolation
254
- - Contrast between before and after
255
-
256
- ---
257
-
258
- ### Example 2: Moon (2009)
259
-
260
- **Director**: Duncan Jones
261
-
262
- **Thematic Exploration**: Explores isolation in space and the psychological effects of prolonged solitude, questioning identity and sanity.
263
-
264
- **Key Thematic Moments**:
265
- - **Alone on moon base**: Extreme isolation
266
- - **Video messages**: One-way connection to Earth
267
- - **Meeting his clone**: Isolation creating identity crisis
268
- - **Discovering the truth**: Isolation and exploitation
269
- - **Connection with clone**: Finding companionship in unexpected place
270
- - **Sacrifice**: One clone helping the other escape
271
-
272
- **Thematic Resolution**: Even in extreme isolation, humans seek connection. Identity requires relationship with others.
273
-
274
- **Techniques Used**:
275
- - Sterile, isolated setting
276
- - Minimal cast emphasizing loneliness
277
- - Technology as inadequate substitute for connection
278
- - Clone as mirror and companion
279
- - Psychological deterioration from isolation
280
-
281
- ---
282
-
283
- ### Example 3: Her (2013)
284
-
285
- **Director**: Spike Jonze
286
-
287
- **Thematic Exploration**: Explores emotional isolation in a connected world, examining whether technology can substitute for human connection.
288
-
289
- **Key Thematic Moments**:
290
- - **Theodore's isolation**: Alone in crowds
291
- - **Connecting with Samantha**: Finding intimacy with AI
292
- - **The surrogate**: Attempting physical connection
293
- - **Samantha's evolution**: Discovering she connects with thousands
294
- - **Final isolation**: Losing even artificial connection
295
- - **Human connection**: Finally connecting with Amy
296
-
297
- **Thematic Resolution**: Technology can't fully replace human connection. True intimacy requires vulnerability with other humans.
298
-
299
- **Techniques Used**:
300
- - Visual isolation (Theodore alone in frame)
301
- - Color palette (warm for connection, cool for isolation)
302
- - Voice performance creating intimacy
303
- - Contrast between digital and human connection
304
- - Final scene showing human connection
305
-
306
- ---
307
-
308
- ### Example 4: The Lighthouse (2019)
309
-
310
- **Director**: Robert Eggers
311
-
312
- **Thematic Exploration**: Explores how isolation drives madness and reveals darkness, examining what happens when humans are cut off from civilization.
313
-
314
- **Key Thematic Moments**:
315
- - **Arrival at lighthouse**: Beginning of isolation
316
- - **Growing tension**: Isolation breeding conflict
317
- - **Psychological deterioration**: Madness from isolation
318
- - **Violence**: Isolation removing civilized restraints
319
- - **Obsession with light**: Isolation creating fixation
320
- - **Final madness**: Complete psychological breakdown
321
-
322
- **Thematic Resolution**: Extreme isolation destroys sanity and reveals primal darkness. Humans need society to remain human.
323
-
324
- **Techniques Used**:
325
- - Claustrophobic framing
326
- - Black and white emphasizing bleakness
327
- - Two-person cast intensifying isolation
328
- - Surreal imagery showing madness
329
- - Ambiguous ending leaving interpretation open
330
-
331
- ---
332
-
333
- ### Example 5: Lost in Translation (2003)
334
-
335
- **Director**: Sofia Coppola
336
-
337
- **Thematic Exploration**: Explores emotional isolation in a foreign place, examining how loneliness can create unexpected connections.
338
-
339
- **Key Thematic Moments**:
340
- - **Tokyo isolation**: Foreignness emphasizing loneliness
341
- - **Bob and Charlotte's meetings**: Finding connection in shared isolation
342
- - **Brief intimacy**: Temporary escape from loneliness
343
- - **The whisper**: Private moment of connection
344
- - **Parting**: Returning to their isolated lives
345
- - **Ambiguous ending**: Connection that can't last
346
-
347
- **Thematic Resolution**: Isolation can be temporarily relieved by connection, but some loneliness is permanent. Brief connections still matter.
348
-
349
- **Techniques Used**:
350
- - Visual isolation in crowded city
351
- - Language barrier emphasizing disconnection
352
- - Quiet, contemplative pacing
353
- - Intimate moments contrasted with public isolation
354
- - Ambiguous whisper leaving meaning private
355
-
356
- ---
357
-
358
- ## Integration with Other Features
359
-
360
- ### Compatible Genres
361
-
362
- - **Drama**: Psychological exploration of isolation
363
- - **Science Fiction**: Physical isolation in space or future
364
- - **Horror**: Isolation creating vulnerability
365
- - **Thriller**: Isolation as danger
366
- - **Romance**: Overcoming isolation through love
367
- - **Survival**: Physical isolation and survival
368
-
369
- ### Compatible Themes (Multi-Theme Stories)
370
-
371
- - **Loneliness**: The emotional experience of isolation
372
- - **Connection**: The opposite of isolation
373
- - **Identity**: Isolation affecting sense of self
374
- - **Madness**: Isolation driving insanity
375
- - **Survival**: Physical isolation and survival
376
- - **Alienation**: Social or cultural isolation
377
-
378
- ### Compatible Styles
379
-
380
- - **Minimalist**: Stripped-down focus on isolation
381
- - **Contemplative**: Meditative exploration of loneliness
382
- - **Psychological**: Internal effects of isolation
383
- - **Atmospheric**: Environment reflecting isolation
384
-
385
- ## Common Pitfalls
386
-
387
- ### Pitfall 1: Isolation Without Cause
388
-
389
- **Problem**: Character is isolated for no clear reason.
390
-
391
- **Solution**: Establish why the character is isolated (choice, circumstance, trauma).
392
-
393
- **Example**: Show what caused the isolation or why the character chooses it.
394
-
395
- ---
396
-
397
- ### Pitfall 2: Isolation Without Cost
398
-
399
- **Problem**: Character is isolated but suffers no psychological effects.
400
-
401
- **Solution**: Show the toll isolation takes on mental health and behavior.
402
-
403
- **Example**: Demonstrate loneliness, difficulty with social interaction, or psychological deterioration.
404
-
405
- ---
406
-
407
- ### Pitfall 3: Easy Connection
408
-
409
- **Problem**: Character overcomes isolation instantly without struggle.
410
-
411
- **Solution**: Make connection difficult and gradual.
412
-
413
- **Example**: Show the character struggling to open up and connect.
414
-
415
- ---
416
-
417
- ### Pitfall 4: Isolation as Purely Negative
418
-
419
- **Problem**: Isolation presented only as suffering with no complexity.
420
-
421
- **Solution**: Show both the pain and the appeal of isolation.
422
-
423
- **Example**: Demonstrate how isolation can be both refuge and prison.
424
-
425
- ---
426
-
427
- ### Pitfall 5: No Visual Isolation
428
-
429
- **Problem**: Character claims to be isolated but visuals don't support it.
430
-
431
- **Solution**: Use visual language to emphasize isolation.
432
-
433
- **Example**: Frame character alone, use empty spaces, show physical distance.
434
-
435
- ---
436
-
437
- ## Best Practices
438
-
439
- 1. **Establish the cause** - Show why the character is isolated
440
- 2. **Show the cost** - Demonstrate psychological and emotional toll
441
- 3. **Use visual language** - Frame isolation visually
442
- 4. **Create complexity** - Isolation can be both refuge and prison
443
- 5. **Make connection difficult** - Overcoming isolation requires struggle
444
- 6. **Show behavioral effects** - Isolation changes how people act
445
- 7. **Use environment** - Setting should reflect emotional isolation
446
- 8. **Minimize dialogue** - Let silence emphasize loneliness
447
- 9. **Avoid easy solutions** - Connection isn't instant
448
- 10. **Allow ambiguity** - Not all isolation must be overcome
449
-
450
- ## Resources
451
-
452
- - *Solitude* by Anthony Storr - Psychology of isolation
453
- - *The Lonely City* by Olivia Laing - Art and loneliness
454
- - *Into the Wild* by Jon Krakauer - Chosen isolation
455
- - *The Anatomy of Story* by John Truby - Isolation in character arc
456
- - *Story* by Robert McKee - Isolation and connection in narrative
457
-
458
- ---
459
-
460
- **Depth Coverage**: 85%
461
- **Last Updated**: 2026-01-31
462
- **Version**: 1.0.0
463
-
464
-
1
+ # Isolation Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ The isolation theme explores physical or emotional separation from others, examining the effects of loneliness, the human need for connection, and whether isolation is chosen or imposed.
10
+
11
+ ## Core Concept
12
+
13
+ Isolation in storytelling represents separation from human connection—whether physical (stranded, imprisoned) or emotional (alienated, misunderstood). It explores the psychological effects of loneliness, the desperate need for connection, and the question of whether isolation destroys or reveals the self.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of isolation explores the effects of separation from human connection, examining whether isolation destroys or reveals the self, and what drives the need for belonging.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Establish What Connection Means
22
+
23
+ **Description**: Before exploring isolation, establish what the character has lost—relationships, community, understanding, or belonging.
24
+
25
+ **Why It Matters**: Isolation has no impact without understanding what's missing.
26
+
27
+ **Application**:
28
+ - **Act I**: Show the character's connections before isolation or what they lack
29
+ - **Act II**: Demonstrate the absence of connection
30
+ - **Act III**: Resolve whether connection is restored or isolation accepted
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *Cast Away*, we see Chuck's life and relationships before isolation, making the loss meaningful
34
+ - ❌ **Bad**: The character is isolated but we never understand what they're missing
35
+
36
+ ---
37
+
38
+ ### Rule 2: Differentiate Physical and Emotional Isolation
39
+
40
+ **Description**: Isolation can be physical (alone in space, stranded) or emotional (surrounded by people but disconnected). Each has different dynamics.
41
+
42
+ **Why It Matters**: Different types of isolation create different stories and challenges.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish which type of isolation (or both) the character faces
46
+ - **Act II**: Explore the specific challenges of that isolation type
47
+ - **Act III**: Resolve the isolation in ways specific to its type
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *Her*, Theodore is emotionally isolated despite being surrounded by people
51
+ - ❌ **Bad**: All isolation is treated identically regardless of type
52
+
53
+ ---
54
+
55
+ ### Rule 3: Show Psychological Effects
56
+
57
+ **Description**: Isolation must visibly affect the character's mental state—through loneliness, desperation, hallucination, or personality changes.
58
+
59
+ **Why It Matters**: Isolation without psychological impact feels unrealistic.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish the character's baseline mental state
63
+ - **Act II**: Show progressive psychological deterioration or adaptation
64
+ - **Act III**: Demonstrate lasting psychological effects
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *The Shining*, Jack's isolation leads to progressive madness
68
+ - ❌ **Bad**: The character is isolated but mentally unchanged
69
+
70
+ ---
71
+
72
+ ### Rule 4: Create Desperate Attempts at Connection
73
+
74
+ **Description**: Isolated characters should desperately seek connection—creating imaginary companions, talking to objects, or risking everything for human contact.
75
+
76
+ **Why It Matters**: This demonstrates the fundamental human need for connection.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish the character's social nature
80
+ - **Act II**: Show increasingly desperate attempts to connect
81
+ - **Act III**: Resolve whether connection is achieved or isolation accepted
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *Cast Away*, Chuck creates Wilson as a companion, showing desperate need for connection
85
+ - ❌ **Bad**: The character is content alone with no desire for connection
86
+
87
+ ---
88
+
89
+ ### Rule 5: Explore Whether Isolation Is Chosen or Imposed
90
+
91
+ **Description**: Isolation can be forced (imprisonment, abandonment) or chosen (withdrawal, self-protection). Each raises different questions.
92
+
93
+ **Why It Matters**: Chosen vs. imposed isolation creates different moral and psychological dynamics.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish whether isolation is chosen or imposed
97
+ - **Act II**: Explore the reasons for chosen isolation or attempts to escape imposed isolation
98
+ - **Act III**: Resolve whether the character chooses connection or continued isolation
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *Into the Wild*, Chris chooses isolation to escape society, raising questions about that choice
102
+ - ❌ **Bad**: The story doesn't explore why the character is isolated
103
+
104
+ ---
105
+
106
+ ### Rule 6: Question Whether Isolation Reveals or Destroys
107
+
108
+ **Description**: The story should explore whether isolation strips away false self to reveal truth, or whether it destroys the self entirely.
109
+
110
+ **Why It Matters**: This is the central philosophical question of isolation themes.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish the character's social self
114
+ - **Act II**: Show isolation revealing or destroying aspects of self
115
+ - **Act III**: Answer whether isolation was revelatory or destructive
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *Moon*, Sam's isolation reveals uncomfortable truths about his identity
119
+ - ❌ **Bad**: Isolation has no effect on self-understanding
120
+
121
+ ---
122
+
123
+ ## Integration Guidelines
124
+
125
+ ### Act I: Setup
126
+
127
+ **Thematic Introduction**:
128
+ - Establish the character's isolated state (physical, emotional, or social)
129
+ - Show what caused the isolation or why it exists
130
+ - Demonstrate the character's relationship with their isolation
131
+ - Introduce the possibility of connection or deeper isolation
132
+
133
+ **Character Connection**:
134
+ - Show whether isolation is chosen or imposed
135
+ - Demonstrate what the character has lost or never had
136
+ - Establish their coping mechanisms for loneliness
137
+ - Reveal their desire for or fear of connection
138
+
139
+ **Visual/Symbolic Introduction**:
140
+ - Use visual motifs representing isolation (empty spaces, barriers, distance)
141
+ - Establish symbolic objects that represent connection or separation
142
+ - Create visual language for loneliness vs. connection
143
+
144
+ ### Act II: Development
145
+
146
+ **Thematic Exploration**:
147
+ - Deepen the isolation or introduce opportunities for connection
148
+ - Show the psychological effects of prolonged isolation
149
+ - Create situations that test whether the character will remain isolated
150
+ - Demonstrate the cost of isolation and the risk of connection
151
+
152
+ **Subtext Techniques**:
153
+ - Use dialogue (or lack thereof) to emphasize isolation
154
+ - Show behavioral changes from loneliness
155
+ - Create visual progression showing increasing isolation or gradual connection
156
+ - Use environment to reflect emotional isolation
157
+
158
+ **Thematic Complications**:
159
+ - Opportunities for connection are rejected or sabotaged
160
+ - Isolation becomes comfortable or terrifying
161
+ - The character's isolation affects others
162
+ - Connection requires vulnerability the character fears
163
+
164
+ ### Act III: Resolution
165
+
166
+ **Thematic Payoff**:
167
+ - Present the ultimate choice between isolation and connection
168
+ - Reveal whether the character can overcome their isolation
169
+ - Answer whether isolation was protective or destructive
170
+ - Demonstrate the consequences of remaining isolated or connecting
171
+
172
+ **Avoiding Preachiness**:
173
+ - Let actions and consequences demonstrate theme
174
+ - Avoid characters explicitly stating "isolation is bad"
175
+ - Show complexity—isolation can be both refuge and prison
176
+ - Allow for ambiguity in whether connection is achieved
177
+
178
+ ## Character Connection
179
+
180
+ ### Protagonist
181
+
182
+ **Thematic Relationship**: The protagonist's journey explores their relationship with isolation and their ability or inability to connect.
183
+
184
+ **Arc Integration**: The character arc should reflect movement toward or away from connection, or acceptance of isolation.
185
+
186
+ **Key Moments**:
187
+ - **Thematic Introduction**: The moment we see their isolated state
188
+ - **Thematic Challenge**: The moment they must choose between isolation and connection
189
+ - **Thematic Resolution**: The moment they connect or accept permanent isolation
190
+
191
+ ### Antagonist
192
+
193
+ **Thematic Opposition**: The antagonist may represent forces that isolate the protagonist, or the protagonist's own fear of connection.
194
+
195
+ **Thematic Function**: The antagonist tests whether the protagonist can overcome isolation or will remain alone.
196
+
197
+ ### Supporting Characters
198
+
199
+ **Thematic Mirrors**: Supporting characters represent different relationships with isolation:
200
+ - The character who overcame isolation
201
+ - The character who chose isolation and regrets it
202
+ - The character who offers connection
203
+ - The character who represents what isolation costs
204
+
205
+ **Thematic Perspectives**: Different characters embody different beliefs about isolation—whether it's safety or prison, choice or curse.
206
+
207
+ ## Subtext Techniques
208
+
209
+ ### Dialogue
210
+
211
+ - Sparse dialogue emphasizing isolation
212
+ - Characters struggle to communicate after prolonged isolation
213
+ - Use metaphors of distance, walls, islands
214
+ - Create conversations where connection is attempted but difficult
215
+ - Include moments of silence that speak volumes
216
+
217
+ ### Visual Storytelling
218
+
219
+ - **Visual motifs**: Empty spaces, barriers, windows, distance
220
+ - **Color palette**: Often desaturated or monochromatic
221
+ - **Symbolic imagery**: Islands, walls, glass, empty rooms
222
+ - **Framing**: Character alone in frame, separated from others
223
+
224
+ ### Action and Behavior
225
+
226
+ - Show routines of isolated life
227
+ - Demonstrate difficulty with social interaction
228
+ - Create moments where character withdraws from connection
229
+ - Show physical manifestations of isolation (talking to self, objects as companions)
230
+
231
+ ## Film Examples
232
+
233
+ ### Example 1: Cast Away (2000)
234
+
235
+ **Director**: Robert Zemeckis
236
+
237
+ **Thematic Exploration**: Explores extreme physical isolation, examining human need for connection and what isolation does to the psyche.
238
+
239
+ **Key Thematic Moments**:
240
+ - **The crash**: Sudden complete isolation
241
+ - **Wilson**: Creating companionship from inanimate object
242
+ - **Talking to Wilson**: Isolation driving need for connection
243
+ - **Losing Wilson**: Devastating loss of only "companion"
244
+ - **Return**: Discovering isolation changed him permanently
245
+ - **Final crossroads**: Choosing new direction after isolation
246
+
247
+ **Thematic Resolution**: Isolation reveals human need for connection. Even after rescue, the isolated person is forever changed.
248
+
249
+ **Techniques Used**:
250
+ - Minimal dialogue emphasizing isolation
251
+ - Wilson as symbol of human need for connection
252
+ - Visual emptiness of island
253
+ - Time passage showing adaptation to isolation
254
+ - Contrast between before and after
255
+
256
+ ---
257
+
258
+ ### Example 2: Moon (2009)
259
+
260
+ **Director**: Duncan Jones
261
+
262
+ **Thematic Exploration**: Explores isolation in space and the psychological effects of prolonged solitude, questioning identity and sanity.
263
+
264
+ **Key Thematic Moments**:
265
+ - **Alone on moon base**: Extreme isolation
266
+ - **Video messages**: One-way connection to Earth
267
+ - **Meeting his clone**: Isolation creating identity crisis
268
+ - **Discovering the truth**: Isolation and exploitation
269
+ - **Connection with clone**: Finding companionship in unexpected place
270
+ - **Sacrifice**: One clone helping the other escape
271
+
272
+ **Thematic Resolution**: Even in extreme isolation, humans seek connection. Identity requires relationship with others.
273
+
274
+ **Techniques Used**:
275
+ - Sterile, isolated setting
276
+ - Minimal cast emphasizing loneliness
277
+ - Technology as inadequate substitute for connection
278
+ - Clone as mirror and companion
279
+ - Psychological deterioration from isolation
280
+
281
+ ---
282
+
283
+ ### Example 3: Her (2013)
284
+
285
+ **Director**: Spike Jonze
286
+
287
+ **Thematic Exploration**: Explores emotional isolation in a connected world, examining whether technology can substitute for human connection.
288
+
289
+ **Key Thematic Moments**:
290
+ - **Theodore's isolation**: Alone in crowds
291
+ - **Connecting with Samantha**: Finding intimacy with AI
292
+ - **The surrogate**: Attempting physical connection
293
+ - **Samantha's evolution**: Discovering she connects with thousands
294
+ - **Final isolation**: Losing even artificial connection
295
+ - **Human connection**: Finally connecting with Amy
296
+
297
+ **Thematic Resolution**: Technology can't fully replace human connection. True intimacy requires vulnerability with other humans.
298
+
299
+ **Techniques Used**:
300
+ - Visual isolation (Theodore alone in frame)
301
+ - Color palette (warm for connection, cool for isolation)
302
+ - Voice performance creating intimacy
303
+ - Contrast between digital and human connection
304
+ - Final scene showing human connection
305
+
306
+ ---
307
+
308
+ ### Example 4: The Lighthouse (2019)
309
+
310
+ **Director**: Robert Eggers
311
+
312
+ **Thematic Exploration**: Explores how isolation drives madness and reveals darkness, examining what happens when humans are cut off from civilization.
313
+
314
+ **Key Thematic Moments**:
315
+ - **Arrival at lighthouse**: Beginning of isolation
316
+ - **Growing tension**: Isolation breeding conflict
317
+ - **Psychological deterioration**: Madness from isolation
318
+ - **Violence**: Isolation removing civilized restraints
319
+ - **Obsession with light**: Isolation creating fixation
320
+ - **Final madness**: Complete psychological breakdown
321
+
322
+ **Thematic Resolution**: Extreme isolation destroys sanity and reveals primal darkness. Humans need society to remain human.
323
+
324
+ **Techniques Used**:
325
+ - Claustrophobic framing
326
+ - Black and white emphasizing bleakness
327
+ - Two-person cast intensifying isolation
328
+ - Surreal imagery showing madness
329
+ - Ambiguous ending leaving interpretation open
330
+
331
+ ---
332
+
333
+ ### Example 5: Lost in Translation (2003)
334
+
335
+ **Director**: Sofia Coppola
336
+
337
+ **Thematic Exploration**: Explores emotional isolation in a foreign place, examining how loneliness can create unexpected connections.
338
+
339
+ **Key Thematic Moments**:
340
+ - **Tokyo isolation**: Foreignness emphasizing loneliness
341
+ - **Bob and Charlotte's meetings**: Finding connection in shared isolation
342
+ - **Brief intimacy**: Temporary escape from loneliness
343
+ - **The whisper**: Private moment of connection
344
+ - **Parting**: Returning to their isolated lives
345
+ - **Ambiguous ending**: Connection that can't last
346
+
347
+ **Thematic Resolution**: Isolation can be temporarily relieved by connection, but some loneliness is permanent. Brief connections still matter.
348
+
349
+ **Techniques Used**:
350
+ - Visual isolation in crowded city
351
+ - Language barrier emphasizing disconnection
352
+ - Quiet, contemplative pacing
353
+ - Intimate moments contrasted with public isolation
354
+ - Ambiguous whisper leaving meaning private
355
+
356
+ ---
357
+
358
+ ## Integration with Other Features
359
+
360
+ ### Compatible Genres
361
+
362
+ - **Drama**: Psychological exploration of isolation
363
+ - **Science Fiction**: Physical isolation in space or future
364
+ - **Horror**: Isolation creating vulnerability
365
+ - **Thriller**: Isolation as danger
366
+ - **Romance**: Overcoming isolation through love
367
+ - **Survival**: Physical isolation and survival
368
+
369
+ ### Compatible Themes (Multi-Theme Stories)
370
+
371
+ - **Loneliness**: The emotional experience of isolation
372
+ - **Connection**: The opposite of isolation
373
+ - **Identity**: Isolation affecting sense of self
374
+ - **Madness**: Isolation driving insanity
375
+ - **Survival**: Physical isolation and survival
376
+ - **Alienation**: Social or cultural isolation
377
+
378
+ ### Compatible Styles
379
+
380
+ - **Minimalist**: Stripped-down focus on isolation
381
+ - **Contemplative**: Meditative exploration of loneliness
382
+ - **Psychological**: Internal effects of isolation
383
+ - **Atmospheric**: Environment reflecting isolation
384
+
385
+ ## Common Pitfalls
386
+
387
+ ### Pitfall 1: Isolation Without Cause
388
+
389
+ **Problem**: Character is isolated for no clear reason.
390
+
391
+ **Solution**: Establish why the character is isolated (choice, circumstance, trauma).
392
+
393
+ **Example**: Show what caused the isolation or why the character chooses it.
394
+
395
+ ---
396
+
397
+ ### Pitfall 2: Isolation Without Cost
398
+
399
+ **Problem**: Character is isolated but suffers no psychological effects.
400
+
401
+ **Solution**: Show the toll isolation takes on mental health and behavior.
402
+
403
+ **Example**: Demonstrate loneliness, difficulty with social interaction, or psychological deterioration.
404
+
405
+ ---
406
+
407
+ ### Pitfall 3: Easy Connection
408
+
409
+ **Problem**: Character overcomes isolation instantly without struggle.
410
+
411
+ **Solution**: Make connection difficult and gradual.
412
+
413
+ **Example**: Show the character struggling to open up and connect.
414
+
415
+ ---
416
+
417
+ ### Pitfall 4: Isolation as Purely Negative
418
+
419
+ **Problem**: Isolation presented only as suffering with no complexity.
420
+
421
+ **Solution**: Show both the pain and the appeal of isolation.
422
+
423
+ **Example**: Demonstrate how isolation can be both refuge and prison.
424
+
425
+ ---
426
+
427
+ ### Pitfall 5: No Visual Isolation
428
+
429
+ **Problem**: Character claims to be isolated but visuals don't support it.
430
+
431
+ **Solution**: Use visual language to emphasize isolation.
432
+
433
+ **Example**: Frame character alone, use empty spaces, show physical distance.
434
+
435
+ ---
436
+
437
+ ## Best Practices
438
+
439
+ 1. **Establish the cause** - Show why the character is isolated
440
+ 2. **Show the cost** - Demonstrate psychological and emotional toll
441
+ 3. **Use visual language** - Frame isolation visually
442
+ 4. **Create complexity** - Isolation can be both refuge and prison
443
+ 5. **Make connection difficult** - Overcoming isolation requires struggle
444
+ 6. **Show behavioral effects** - Isolation changes how people act
445
+ 7. **Use environment** - Setting should reflect emotional isolation
446
+ 8. **Minimize dialogue** - Let silence emphasize loneliness
447
+ 9. **Avoid easy solutions** - Connection isn't instant
448
+ 10. **Allow ambiguity** - Not all isolation must be overcome
449
+
450
+ ## Resources
451
+
452
+ - *Solitude* by Anthony Storr - Psychology of isolation
453
+ - *The Lonely City* by Olivia Laing - Art and loneliness
454
+ - *Into the Wild* by Jon Krakauer - Chosen isolation
455
+ - *The Anatomy of Story* by John Truby - Isolation in character arc
456
+ - *Story* by Robert McKee - Isolation and connection in narrative
457
+
458
+ ---
459
+
460
+ **Depth Coverage**: 85%
461
+ **Last Updated**: 2026-01-31
462
+ **Version**: 1.0.0
463
+
464
+