@mytechtoday/augment-extensions 0.5.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (523) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +113 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +15 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +576 -23
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/config-system.d.ts +111 -0
  476. package/cli/dist/utils/config-system.d.ts.map +1 -0
  477. package/cli/dist/utils/config-system.js +239 -0
  478. package/cli/dist/utils/config-system.js.map +1 -0
  479. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  480. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  481. package/cli/dist/utils/extractCommandHelp.js +250 -0
  482. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  483. package/cli/dist/utils/hook-system.d.ts +84 -0
  484. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  485. package/cli/dist/utils/hook-system.js +151 -0
  486. package/cli/dist/utils/hook-system.js.map +1 -0
  487. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  488. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  489. package/cli/dist/utils/inspection-cache.js +166 -0
  490. package/cli/dist/utils/inspection-cache.js.map +1 -0
  491. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  492. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  493. package/cli/dist/utils/inspection-handlers.js +171 -0
  494. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  495. package/cli/dist/utils/install-rules.js +55 -55
  496. package/cli/dist/utils/mcp-integration.js +44 -44
  497. package/cli/dist/utils/module-system.d.ts +1 -0
  498. package/cli/dist/utils/module-system.d.ts.map +1 -1
  499. package/cli/dist/utils/module-system.js +8 -3
  500. package/cli/dist/utils/module-system.js.map +1 -1
  501. package/cli/dist/utils/plugin-system.d.ts +133 -0
  502. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  503. package/cli/dist/utils/plugin-system.js +210 -0
  504. package/cli/dist/utils/plugin-system.js.map +1 -0
  505. package/cli/dist/utils/progress.d.ts +67 -0
  506. package/cli/dist/utils/progress.d.ts.map +1 -0
  507. package/cli/dist/utils/progress.js +146 -0
  508. package/cli/dist/utils/progress.js.map +1 -0
  509. package/cli/dist/utils/rule-install-hooks.js +8 -8
  510. package/cli/dist/utils/stream-reader.d.ts +34 -0
  511. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  512. package/cli/dist/utils/stream-reader.js +147 -0
  513. package/cli/dist/utils/stream-reader.js.map +1 -0
  514. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  515. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  516. package/cli/dist/utils/vscode-editor.js +171 -0
  517. package/cli/dist/utils/vscode-editor.js.map +1 -0
  518. package/cli/dist/utils/vscode-links.d.ts +49 -0
  519. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  520. package/cli/dist/utils/vscode-links.js +167 -0
  521. package/cli/dist/utils/vscode-links.js.map +1 -0
  522. package/modules.md +667 -630
  523. package/package.json +85 -85
@@ -1,491 +1,491 @@
1
- # Friendship Theme
2
-
3
- **Category**: Screenplay Theme
4
- **Type**: Universal Theme
5
- **Complexity**: Medium
6
-
7
- ## Overview
8
-
9
- The friendship theme explores the bonds formed through shared experience, loyalty, and mutual support. It examines what makes friendships endure, what tests them, and how friends transform each other.
10
-
11
- ## Core Concept
12
-
13
- Friendship in storytelling represents chosen family—the bonds we create rather than inherit. It explores loyalty, sacrifice, shared growth, and the question of what we owe those we choose to stand beside.
14
-
15
- ## Thematic Statement
16
-
17
- The theme of friendship explores the bonds formed through shared experience, examining what loyalty demands, how friends transform each other, and whether friendship can survive betrayal and hardship.
18
-
19
- ## Core Rules
20
-
21
- ### Rule 1: Establish Complementary Characters
22
-
23
- **Description**: Friends should complement each other—different strengths, weaknesses, and perspectives that make them stronger together than apart.
24
-
25
- **Why It Matters**: Identical friends lack dramatic potential. Differences create both conflict and synergy.
26
-
27
- **Application**:
28
- - **Act I**: Establish each friend's unique qualities and how they complement each other
29
- - **Act II**: Show how their differences create both strength and conflict
30
- - **Act III**: Demonstrate how they're better together than apart
31
-
32
- **Examples**:
33
- - ✅ **Good**: In *Toy Story*, Woody's leadership complements Buzz's courage, creating a stronger team
34
- - ❌ **Bad**: Friends are interchangeable with no unique contributions to the relationship
35
-
36
- ---
37
-
38
- ### Rule 2: Test the Friendship
39
-
40
- **Description**: True friendship must be tested through conflict, betrayal, or circumstances that force friends to choose between loyalty and self-interest.
41
-
42
- **Why It Matters**: Untested friendship lacks dramatic weight. Tests reveal the depth of the bond.
43
-
44
- **Application**:
45
- - **Act I**: Establish the friendship and what it means to each character
46
- - **Act II**: Create situations that test loyalty and commitment
47
- - **Act III**: Prove the friendship through ultimate test or sacrifice
48
-
49
- **Examples**:
50
- - ✅ **Good**: In *The Lord of the Rings*, Sam's loyalty is tested repeatedly, proving the friendship's depth
51
- - ❌ **Bad**: Friends never face situations that test their loyalty or commitment
52
-
53
- ---
54
-
55
- ### Rule 3: Show Mutual Transformation
56
-
57
- **Description**: Friends should change each other. Each character should be different because of the friendship.
58
-
59
- **Why It Matters**: Static friendships lack growth. Transformation demonstrates the relationship's impact.
60
-
61
- **Application**:
62
- - **Act I**: Establish each character's starting state
63
- - **Act II**: Show how each friend influences the other's growth
64
- - **Act III**: Demonstrate how both have changed because of the friendship
65
-
66
- **Examples**:
67
- - ✅ **Good**: In *Stand by Me*, each boy is transformed by their shared journey and friendship
68
- - ❌ **Bad**: Friends remain unchanged despite their relationship
69
-
70
- ---
71
-
72
- ### Rule 4: Create Shared Goals and Conflicts
73
-
74
- **Description**: Friends should have both shared goals that unite them and individual goals that create tension.
75
-
76
- **Why It Matters**: Shared goals create unity; conflicting goals create drama.
77
-
78
- **Application**:
79
- - **Act I**: Establish what unites the friends and what might divide them
80
- - **Act II**: Create situations where individual and shared goals conflict
81
- - **Act III**: Resolve whether friendship or individual goals take priority
82
-
83
- **Examples**:
84
- - ✅ **Good**: In *The Shawshank Redemption*, Andy and Red share the goal of maintaining hope but have different approaches
85
- - ❌ **Bad**: Friends have identical goals with no individual desires creating tension
86
-
87
- ---
88
-
89
- ### Rule 5: Explore the Cost of Loyalty
90
-
91
- **Description**: Friendship requires sacrifice—of time, resources, safety, or other opportunities. Friends must choose loyalty over easier alternatives.
92
-
93
- **Why It Matters**: Loyalty without cost feels cheap. Sacrifice demonstrates friendship's value.
94
-
95
- **Application**:
96
- - **Act I**: Establish what each friend values (safety, success, other relationships)
97
- - **Act II**: Force friends to choose between loyalty and self-interest
98
- - **Act III**: Require ultimate sacrifice that proves the friendship
99
-
100
- **Examples**:
101
- - ✅ **Good**: In *Toy Story 3*, the toys choose to face destruction together rather than abandon each other
102
- - ❌ **Bad**: Friendship never requires sacrifice or difficult choices
103
-
104
- ---
105
-
106
- ### Rule 6: Show Vulnerability and Trust
107
-
108
- **Description**: True friendship requires emotional vulnerability and trust. Friends must see each other's weaknesses and fears.
109
-
110
- **Why It Matters**: Surface-level friendships lack depth. Vulnerability creates authentic connection.
111
-
112
- **Application**:
113
- - **Act I**: Establish each character's emotional walls
114
- - **Act II**: Show gradual vulnerability and trust building
115
- - **Act III**: Demonstrate complete trust through ultimate vulnerability
116
-
117
- **Examples**:
118
- - ✅ **Good**: In *Good Will Hunting*, Will's friendship with Chuckie involves deep vulnerability about their futures
119
- - ❌ **Bad**: Friends never share vulnerabilities or emotional truths
120
-
121
- ---
122
-
123
- ### Rule 7: Balance Unity and Individuality
124
-
125
- **Description**: Friends should maintain individual identities while being united. They're stronger together but complete separately.
126
-
127
- **Why It Matters**: Codependent friendships lack healthy boundaries. Balance creates realistic relationships.
128
-
129
- **Application**:
130
- - **Act I**: Establish each friend's individual identity
131
- - **Act II**: Show how friendship enhances rather than erases individuality
132
- - **Act III**: Demonstrate that friends remain individuals while being united
133
-
134
- **Examples**:
135
- - ✅ **Good**: In *Thelma & Louise*, both women maintain distinct personalities while supporting each other
136
- - ❌ **Bad**: Friends lose all individual identity and become interchangeable
137
-
138
- ---
139
-
140
- ### Rule 8: Show Friendship Through Action, Not Declaration
141
-
142
- **Description**: Friendship must be demonstrated through behavior, sacrifice, and support—not just characters saying they're friends.
143
-
144
- **Why It Matters**: Telling isn't showing. Actions prove the depth of friendship.
145
-
146
- **Application**:
147
- - **Act I**: Show friendship through small gestures and interactions
148
- - **Act II**: Demonstrate friendship through increasingly significant actions
149
- - **Act III**: Prove friendship through ultimate sacrifice or support
150
-
151
- **Examples**:
152
- - ✅ **Good**: In *The Lord of the Rings*, Sam's friendship is shown through carrying Frodo, not speeches about friendship
153
- - ❌ **Bad**: Characters constantly declare their friendship but never demonstrate it through action
154
-
155
- ---
156
-
157
- ## Integration Guidelines
158
-
159
- ### Act I: Setup
160
-
161
- **Thematic Introduction**:
162
- - Introduce the friends and establish their relationship
163
- - Show what each brings to the friendship
164
- - Demonstrate the bond through interaction and shared history
165
- - Establish what the friendship means to each character
166
-
167
- **Character Connection**:
168
- - Show how each friend complements the other
169
- - Establish shared goals and individual differences
170
- - Demonstrate the foundation of trust and loyalty
171
- - Reveal what each friend needs from the relationship
172
-
173
- **Visual/Symbolic Introduction**:
174
- - Use visual motifs representing friendship (shared spaces, objects, rituals)
175
- - Establish symbolic elements that represent the bond
176
- - Create visual language for unity and separation
177
-
178
- ### Act II: Development
179
-
180
- **Thematic Exploration**:
181
- - Test the friendship through conflict or external pressure
182
- - Show how friends support each other through challenges
183
- - Create situations where loyalty conflicts with self-interest
184
- - Demonstrate mutual transformation through the relationship
185
-
186
- **Subtext Techniques**:
187
- - Use dialogue that reveals unspoken understanding
188
- - Show friendship through small gestures and knowing looks
189
- - Create visual intimacy through framing and proximity
190
- - Use shared experiences to deepen the bond
191
-
192
- **Thematic Complications**:
193
- - External forces threaten to separate the friends
194
- - Individual goals conflict with friendship
195
- - Misunderstandings or betrayals test the bond
196
- - One friend must sacrifice for the other
197
-
198
- ### Act III: Resolution
199
-
200
- **Thematic Payoff**:
201
- - Present ultimate test of the friendship
202
- - Require sacrifice that proves the bond's depth
203
- - Show how both friends have changed because of each other
204
- - Demonstrate whether friendship survives or is transformed
205
-
206
- **Avoiding Preachiness**:
207
- - Let actions demonstrate friendship rather than speeches
208
- - Avoid characters explicitly stating friendship themes
209
- - Make the bond feel earned through shared experience
210
- - Allow for complexity—friendship can be messy and imperfect
211
-
212
- ## Character Connection
213
-
214
- ### Protagonist
215
-
216
- **Thematic Relationship**: The protagonist's journey is enhanced and complicated by friendship. The friend provides support, challenge, and mirror.
217
-
218
- **Arc Integration**: The character arc should reflect growth catalyzed or supported by friendship.
219
-
220
- **Key Moments**:
221
- - **Thematic Introduction**: The moment that establishes the friendship's foundation
222
- - **Thematic Challenge**: The crisis that tests whether friendship will endure
223
- - **Thematic Resolution**: The moment that proves the friendship's depth through action
224
-
225
- ### Antagonist
226
-
227
- **Thematic Opposition**: The antagonist may threaten the friendship, represent isolation, or offer temptations that conflict with loyalty.
228
-
229
- **Thematic Function**: The antagonist tests whether friendship is strong enough to overcome obstacles.
230
-
231
- ### Supporting Characters
232
-
233
- **Thematic Mirrors**: Supporting characters represent different approaches to friendship:
234
- - The character with no friends showing the cost of isolation
235
- - The character with superficial friendships showing the difference
236
- - The character who betrays friendship showing what's at stake
237
- - The mentor who models healthy friendship
238
-
239
- **Thematic Perspectives**: Different characters embody different beliefs about friendship—its value, its costs, what it requires.
240
-
241
- ## Subtext Techniques
242
-
243
- ### Dialogue
244
-
245
- - Friends communicate through shorthand and unspoken understanding
246
- - Use inside jokes and shared references
247
- - Create conversations where friends challenge each other lovingly
248
- - Include moments of comfortable silence showing deep connection
249
-
250
- ### Visual Storytelling
251
-
252
- - **Visual motifs**: Shared spaces, parallel framing, physical proximity
253
- - **Color palette**: Warm tones for connection, cool for separation
254
- - **Symbolic imagery**: Objects representing the friendship (gifts, shared possessions)
255
- - **Framing**: Friends in frame together showing unity, separated showing conflict
256
-
257
- ### Action and Behavior
258
-
259
- - Show friends anticipating each other's needs
260
- - Demonstrate sacrifice without being asked
261
- - Create moments of nonverbal communication
262
- - Show physical comfort (hugs, shoulder touches) appropriate to the relationship
263
-
264
- ## Film Examples
265
-
266
- ### Example 1: The Shawshank Redemption (1994)
267
-
268
- **Director**: Frank Darabont
269
-
270
- **Thematic Exploration**: Explores friendship as survival, hope, and mutual transformation in the most hopeless circumstances.
271
-
272
- **Key Thematic Moments**:
273
- - **The rooftop scene**: Andy earns Red's friendship through generosity
274
- - **The opera scene**: Andy shares beauty with Red and others
275
- - **"Get busy living or get busy dying"**: Red's philosophy shaped by Andy
276
- - **The escape reveal**: Andy's ultimate gift to Red—hope and freedom
277
- - **Zihuatanejo**: Friendship reunited, both men transformed
278
-
279
- **Thematic Resolution**: Friendship provides hope, purpose, and transformation even in prison. Both men are better because of each other.
280
-
281
- **Techniques Used**:
282
- - Voice-over narration from Red's perspective showing friendship's impact
283
- - Gradual development of trust over years
284
- - Contrast between Andy's hope and Red's cynicism
285
- - Visual symbolism (the rock hammer, the poster, the ocean)
286
- - Reunion as ultimate payoff of friendship
287
-
288
- ---
289
-
290
- ### Example 2: Toy Story (1995)
291
-
292
- **Director**: John Lasseter
293
-
294
- **Thematic Exploration**: Explores friendship formed through rivalry, examining jealousy, loyalty, and learning to value each other's strengths.
295
-
296
- **Key Thematic Moments**:
297
- - **Buzz's arrival**: Woody's jealousy threatening friendship before it begins
298
- - **"You are a toy!"**: Woody's cruel truth-telling damaging Buzz
299
- - **Working together**: Learning to combine their strengths
300
- - **"You've got a friend in me"**: Theme song explicitly stating friendship theme
301
- - **Choosing each other**: Both toys choosing friendship over individual glory
302
-
303
- **Thematic Resolution**: True friendship requires accepting each other's differences and valuing complementary strengths.
304
-
305
- **Techniques Used**:
306
- - Rivalry to friendship arc
307
- - Complementary character design (cowboy vs. spaceman)
308
- - Visual language of separation and unity
309
- - Shared goal (returning to Andy) uniting them
310
- - Sacrifice for each other proving friendship
311
-
312
- ---
313
-
314
- ### Example 3: Stand by Me (1986)
315
-
316
- **Director**: Rob Reiner
317
-
318
- **Thematic Exploration**: Explores childhood friendship and its formative power, examining how shared experience creates bonds that shape who we become.
319
-
320
- **Key Thematic Moments**:
321
- - **The journey begins**: Four boys seeking adventure together
322
- - **Sharing stories**: Vulnerability and imagination bonding them
323
- - **Facing the train**: Shared danger proving courage
324
- - **Gordie's story**: Creative expression supported by friends
325
- - **"I never had any friends later on like the ones I had when I was twelve"**: Acknowledging friendship's unique power
326
-
327
- **Thematic Resolution**: Childhood friendships are formative and irreplaceable, shaping who we become even as we grow apart.
328
-
329
- **Techniques Used**:
330
- - Coming-of-age journey structure
331
- - Voice-over from adult Gordie reflecting on friendship
332
- - Shared danger and adventure bonding characters
333
- - Individual character arcs supported by friendship
334
- - Bittersweet ending acknowledging friendships change
335
-
336
- ---
337
-
338
- ### Example 4: The Lord of the Rings Trilogy (2001-2003)
339
-
340
- **Director**: Peter Jackson
341
-
342
- **Thematic Exploration**: Explores friendship as loyalty, sacrifice, and the strength to endure impossible challenges together.
343
-
344
- **Key Thematic Moments**:
345
- - **The Fellowship forms**: Different races united in friendship
346
- - **"You have my sword/bow/axe"**: Pledging loyalty
347
- - **Sam carrying Frodo**: Ultimate physical demonstration of friendship
348
- - **"I can't carry it for you, but I can carry you"**: Defining friendship's limits and strengths
349
- - **The Grey Havens**: Friendship enduring even through separation
350
-
351
- **Thematic Resolution**: Friendship provides the strength to endure impossible burdens and accomplish what individuals cannot.
352
-
353
- **Techniques Used**:
354
- - Epic scale emphasizing friendship's power
355
- - Multiple friendship pairs (Frodo/Sam, Merry/Pippin, Legolas/Gimli)
356
- - Physical journey mirroring emotional journey
357
- - Sacrifice as ultimate proof of friendship
358
- - Visual symbolism (the Ring as burden, friends as support)
359
-
360
- ---
361
-
362
- ### Example 5: Thelma & Louise (1991)
363
-
364
- **Director**: Ridley Scott
365
-
366
- **Thematic Exploration**: Explores female friendship as liberation, examining how friends empower each other to break free from oppression.
367
-
368
- **Key Thematic Moments**:
369
- - **The road trip begins**: Escape from ordinary life together
370
- - **Louise protecting Thelma**: Friendship as protection
371
- - **Thelma's transformation**: Empowered by Louise's support
372
- - **"You're a good friend"**: Acknowledging the bond
373
- - **The final drive**: Choosing freedom together over capture
374
-
375
- **Thematic Resolution**: Friendship empowers transformation and provides courage to choose freedom even at ultimate cost.
376
-
377
- **Techniques Used**:
378
- - Road movie structure emphasizing journey together
379
- - Visual transformation (appearance, confidence)
380
- - Complementary character arcs (Louise's control, Thelma's liberation)
381
- - Landscape as metaphor for freedom
382
- - Controversial ending showing ultimate unity
383
-
384
- ---
385
-
386
- ## Integration with Other Features
387
-
388
- ### Compatible Genres
389
-
390
- - **Drama**: Deep exploration of friendship dynamics
391
- - **Comedy**: Friendship through humor and shared experiences
392
- - **Adventure**: Friends united by shared quest
393
- - **Coming-of-Age**: Formative friendships shaping identity
394
- - **War**: Friendship forged in extreme circumstances
395
- - **Buddy Films**: Friendship as central relationship
396
-
397
- ### Compatible Themes (Multi-Theme Stories)
398
-
399
- - **Loyalty**: Friendship requires and demonstrates loyalty
400
- - **Growth**: Friends catalyze each other's transformation
401
- - **Sacrifice**: Friendship often requires sacrifice
402
- - **Identity**: Friends help discover or shape identity
403
- - **Belonging**: Friendship provides sense of belonging
404
- - **Trust**: Foundation of all friendship
405
-
406
- ### Compatible Styles
407
-
408
- - **Character-Driven**: Focuses on relationship dynamics
409
- - **Ensemble**: Multiple friendships explored simultaneously
410
- - **Journey/Quest**: Friends united by shared goal
411
- - **Slice-of-Life**: Friendship in everyday moments
412
-
413
- ## Common Pitfalls
414
-
415
- ### Pitfall 1: Interchangeable Friends
416
-
417
- **Problem**: Friends have no distinct personalities or contributions to the relationship.
418
-
419
- **Solution**: Create complementary characters with unique strengths and perspectives.
420
-
421
- **Example**: Each friend should bring something specific to the relationship that the other lacks.
422
-
423
- ---
424
-
425
- ### Pitfall 2: Untested Friendship
426
-
427
- **Problem**: Friends never face situations that genuinely test their loyalty or bond.
428
-
429
- **Solution**: Create conflicts that force friends to choose between loyalty and self-interest.
430
-
431
- **Example**: Present situations where supporting the friend costs something significant.
432
-
433
- ---
434
-
435
- ### Pitfall 3: Telling Instead of Showing
436
-
437
- **Problem**: Characters constantly declare their friendship but never demonstrate it through action.
438
-
439
- **Solution**: Show friendship through behavior, sacrifice, and support.
440
-
441
- **Example**: Instead of "you're my best friend," show the character risking something for their friend.
442
-
443
- ---
444
-
445
- ### Pitfall 4: No Individual Identity
446
-
447
- **Problem**: Friends lose all individual personality and become codependent or interchangeable.
448
-
449
- **Solution**: Maintain distinct individual identities while showing unity.
450
-
451
- **Example**: Friends should have individual goals, personalities, and arcs while supporting each other.
452
-
453
- ---
454
-
455
- ### Pitfall 5: Conflict-Free Friendship
456
-
457
- **Problem**: Friends never disagree or have tension, making the relationship feel shallow.
458
-
459
- **Solution**: Include realistic conflicts that test and ultimately strengthen the bond.
460
-
461
- **Example**: Friends should challenge each other and have disagreements that reveal character.
462
-
463
- ---
464
-
465
- ## Best Practices
466
-
467
- 1. **Create complementary characters** - Different strengths that make them stronger together
468
- 2. **Test the friendship** - Conflicts that force choice between loyalty and self-interest
469
- 3. **Show mutual transformation** - Both friends change because of the relationship
470
- 4. **Balance shared and individual goals** - Unity and individuality coexist
471
- 5. **Require sacrifice** - Friendship must cost something to feel valuable
472
- 6. **Show vulnerability** - True friendship requires emotional openness
473
- 7. **Maintain individual identity** - Friends enhance rather than erase individuality
474
- 8. **Demonstrate through action** - Show friendship through behavior, not declarations
475
- 9. **Use visual storytelling** - Show connection through imagery and framing
476
- 10. **Avoid preachiness** - Let the relationship speak for itself
477
-
478
- ## Resources
479
-
480
- - *The Anatomy of Story* by John Truby - Relationship dynamics in narrative
481
- - *Story* by Robert McKee - Character relationships and bonds
482
- - *The Writer's Journey* by Christopher Vogler - Allies and friendship in hero's journey
483
- - *Into the Woods* by John Yorke - Relationship arcs and structure
484
- - *Save the Cat!* by Blake Snyder - Buddy film structure
485
-
486
- ---
487
-
488
- **Depth Coverage**: 85%
489
- **Last Updated**: 2026-01-31
490
- **Version**: 1.0.0
491
-
1
+ # Friendship Theme
2
+
3
+ **Category**: Screenplay Theme
4
+ **Type**: Universal Theme
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ The friendship theme explores the bonds formed through shared experience, loyalty, and mutual support. It examines what makes friendships endure, what tests them, and how friends transform each other.
10
+
11
+ ## Core Concept
12
+
13
+ Friendship in storytelling represents chosen family—the bonds we create rather than inherit. It explores loyalty, sacrifice, shared growth, and the question of what we owe those we choose to stand beside.
14
+
15
+ ## Thematic Statement
16
+
17
+ The theme of friendship explores the bonds formed through shared experience, examining what loyalty demands, how friends transform each other, and whether friendship can survive betrayal and hardship.
18
+
19
+ ## Core Rules
20
+
21
+ ### Rule 1: Establish Complementary Characters
22
+
23
+ **Description**: Friends should complement each other—different strengths, weaknesses, and perspectives that make them stronger together than apart.
24
+
25
+ **Why It Matters**: Identical friends lack dramatic potential. Differences create both conflict and synergy.
26
+
27
+ **Application**:
28
+ - **Act I**: Establish each friend's unique qualities and how they complement each other
29
+ - **Act II**: Show how their differences create both strength and conflict
30
+ - **Act III**: Demonstrate how they're better together than apart
31
+
32
+ **Examples**:
33
+ - ✅ **Good**: In *Toy Story*, Woody's leadership complements Buzz's courage, creating a stronger team
34
+ - ❌ **Bad**: Friends are interchangeable with no unique contributions to the relationship
35
+
36
+ ---
37
+
38
+ ### Rule 2: Test the Friendship
39
+
40
+ **Description**: True friendship must be tested through conflict, betrayal, or circumstances that force friends to choose between loyalty and self-interest.
41
+
42
+ **Why It Matters**: Untested friendship lacks dramatic weight. Tests reveal the depth of the bond.
43
+
44
+ **Application**:
45
+ - **Act I**: Establish the friendship and what it means to each character
46
+ - **Act II**: Create situations that test loyalty and commitment
47
+ - **Act III**: Prove the friendship through ultimate test or sacrifice
48
+
49
+ **Examples**:
50
+ - ✅ **Good**: In *The Lord of the Rings*, Sam's loyalty is tested repeatedly, proving the friendship's depth
51
+ - ❌ **Bad**: Friends never face situations that test their loyalty or commitment
52
+
53
+ ---
54
+
55
+ ### Rule 3: Show Mutual Transformation
56
+
57
+ **Description**: Friends should change each other. Each character should be different because of the friendship.
58
+
59
+ **Why It Matters**: Static friendships lack growth. Transformation demonstrates the relationship's impact.
60
+
61
+ **Application**:
62
+ - **Act I**: Establish each character's starting state
63
+ - **Act II**: Show how each friend influences the other's growth
64
+ - **Act III**: Demonstrate how both have changed because of the friendship
65
+
66
+ **Examples**:
67
+ - ✅ **Good**: In *Stand by Me*, each boy is transformed by their shared journey and friendship
68
+ - ❌ **Bad**: Friends remain unchanged despite their relationship
69
+
70
+ ---
71
+
72
+ ### Rule 4: Create Shared Goals and Conflicts
73
+
74
+ **Description**: Friends should have both shared goals that unite them and individual goals that create tension.
75
+
76
+ **Why It Matters**: Shared goals create unity; conflicting goals create drama.
77
+
78
+ **Application**:
79
+ - **Act I**: Establish what unites the friends and what might divide them
80
+ - **Act II**: Create situations where individual and shared goals conflict
81
+ - **Act III**: Resolve whether friendship or individual goals take priority
82
+
83
+ **Examples**:
84
+ - ✅ **Good**: In *The Shawshank Redemption*, Andy and Red share the goal of maintaining hope but have different approaches
85
+ - ❌ **Bad**: Friends have identical goals with no individual desires creating tension
86
+
87
+ ---
88
+
89
+ ### Rule 5: Explore the Cost of Loyalty
90
+
91
+ **Description**: Friendship requires sacrifice—of time, resources, safety, or other opportunities. Friends must choose loyalty over easier alternatives.
92
+
93
+ **Why It Matters**: Loyalty without cost feels cheap. Sacrifice demonstrates friendship's value.
94
+
95
+ **Application**:
96
+ - **Act I**: Establish what each friend values (safety, success, other relationships)
97
+ - **Act II**: Force friends to choose between loyalty and self-interest
98
+ - **Act III**: Require ultimate sacrifice that proves the friendship
99
+
100
+ **Examples**:
101
+ - ✅ **Good**: In *Toy Story 3*, the toys choose to face destruction together rather than abandon each other
102
+ - ❌ **Bad**: Friendship never requires sacrifice or difficult choices
103
+
104
+ ---
105
+
106
+ ### Rule 6: Show Vulnerability and Trust
107
+
108
+ **Description**: True friendship requires emotional vulnerability and trust. Friends must see each other's weaknesses and fears.
109
+
110
+ **Why It Matters**: Surface-level friendships lack depth. Vulnerability creates authentic connection.
111
+
112
+ **Application**:
113
+ - **Act I**: Establish each character's emotional walls
114
+ - **Act II**: Show gradual vulnerability and trust building
115
+ - **Act III**: Demonstrate complete trust through ultimate vulnerability
116
+
117
+ **Examples**:
118
+ - ✅ **Good**: In *Good Will Hunting*, Will's friendship with Chuckie involves deep vulnerability about their futures
119
+ - ❌ **Bad**: Friends never share vulnerabilities or emotional truths
120
+
121
+ ---
122
+
123
+ ### Rule 7: Balance Unity and Individuality
124
+
125
+ **Description**: Friends should maintain individual identities while being united. They're stronger together but complete separately.
126
+
127
+ **Why It Matters**: Codependent friendships lack healthy boundaries. Balance creates realistic relationships.
128
+
129
+ **Application**:
130
+ - **Act I**: Establish each friend's individual identity
131
+ - **Act II**: Show how friendship enhances rather than erases individuality
132
+ - **Act III**: Demonstrate that friends remain individuals while being united
133
+
134
+ **Examples**:
135
+ - ✅ **Good**: In *Thelma & Louise*, both women maintain distinct personalities while supporting each other
136
+ - ❌ **Bad**: Friends lose all individual identity and become interchangeable
137
+
138
+ ---
139
+
140
+ ### Rule 8: Show Friendship Through Action, Not Declaration
141
+
142
+ **Description**: Friendship must be demonstrated through behavior, sacrifice, and support—not just characters saying they're friends.
143
+
144
+ **Why It Matters**: Telling isn't showing. Actions prove the depth of friendship.
145
+
146
+ **Application**:
147
+ - **Act I**: Show friendship through small gestures and interactions
148
+ - **Act II**: Demonstrate friendship through increasingly significant actions
149
+ - **Act III**: Prove friendship through ultimate sacrifice or support
150
+
151
+ **Examples**:
152
+ - ✅ **Good**: In *The Lord of the Rings*, Sam's friendship is shown through carrying Frodo, not speeches about friendship
153
+ - ❌ **Bad**: Characters constantly declare their friendship but never demonstrate it through action
154
+
155
+ ---
156
+
157
+ ## Integration Guidelines
158
+
159
+ ### Act I: Setup
160
+
161
+ **Thematic Introduction**:
162
+ - Introduce the friends and establish their relationship
163
+ - Show what each brings to the friendship
164
+ - Demonstrate the bond through interaction and shared history
165
+ - Establish what the friendship means to each character
166
+
167
+ **Character Connection**:
168
+ - Show how each friend complements the other
169
+ - Establish shared goals and individual differences
170
+ - Demonstrate the foundation of trust and loyalty
171
+ - Reveal what each friend needs from the relationship
172
+
173
+ **Visual/Symbolic Introduction**:
174
+ - Use visual motifs representing friendship (shared spaces, objects, rituals)
175
+ - Establish symbolic elements that represent the bond
176
+ - Create visual language for unity and separation
177
+
178
+ ### Act II: Development
179
+
180
+ **Thematic Exploration**:
181
+ - Test the friendship through conflict or external pressure
182
+ - Show how friends support each other through challenges
183
+ - Create situations where loyalty conflicts with self-interest
184
+ - Demonstrate mutual transformation through the relationship
185
+
186
+ **Subtext Techniques**:
187
+ - Use dialogue that reveals unspoken understanding
188
+ - Show friendship through small gestures and knowing looks
189
+ - Create visual intimacy through framing and proximity
190
+ - Use shared experiences to deepen the bond
191
+
192
+ **Thematic Complications**:
193
+ - External forces threaten to separate the friends
194
+ - Individual goals conflict with friendship
195
+ - Misunderstandings or betrayals test the bond
196
+ - One friend must sacrifice for the other
197
+
198
+ ### Act III: Resolution
199
+
200
+ **Thematic Payoff**:
201
+ - Present ultimate test of the friendship
202
+ - Require sacrifice that proves the bond's depth
203
+ - Show how both friends have changed because of each other
204
+ - Demonstrate whether friendship survives or is transformed
205
+
206
+ **Avoiding Preachiness**:
207
+ - Let actions demonstrate friendship rather than speeches
208
+ - Avoid characters explicitly stating friendship themes
209
+ - Make the bond feel earned through shared experience
210
+ - Allow for complexity—friendship can be messy and imperfect
211
+
212
+ ## Character Connection
213
+
214
+ ### Protagonist
215
+
216
+ **Thematic Relationship**: The protagonist's journey is enhanced and complicated by friendship. The friend provides support, challenge, and mirror.
217
+
218
+ **Arc Integration**: The character arc should reflect growth catalyzed or supported by friendship.
219
+
220
+ **Key Moments**:
221
+ - **Thematic Introduction**: The moment that establishes the friendship's foundation
222
+ - **Thematic Challenge**: The crisis that tests whether friendship will endure
223
+ - **Thematic Resolution**: The moment that proves the friendship's depth through action
224
+
225
+ ### Antagonist
226
+
227
+ **Thematic Opposition**: The antagonist may threaten the friendship, represent isolation, or offer temptations that conflict with loyalty.
228
+
229
+ **Thematic Function**: The antagonist tests whether friendship is strong enough to overcome obstacles.
230
+
231
+ ### Supporting Characters
232
+
233
+ **Thematic Mirrors**: Supporting characters represent different approaches to friendship:
234
+ - The character with no friends showing the cost of isolation
235
+ - The character with superficial friendships showing the difference
236
+ - The character who betrays friendship showing what's at stake
237
+ - The mentor who models healthy friendship
238
+
239
+ **Thematic Perspectives**: Different characters embody different beliefs about friendship—its value, its costs, what it requires.
240
+
241
+ ## Subtext Techniques
242
+
243
+ ### Dialogue
244
+
245
+ - Friends communicate through shorthand and unspoken understanding
246
+ - Use inside jokes and shared references
247
+ - Create conversations where friends challenge each other lovingly
248
+ - Include moments of comfortable silence showing deep connection
249
+
250
+ ### Visual Storytelling
251
+
252
+ - **Visual motifs**: Shared spaces, parallel framing, physical proximity
253
+ - **Color palette**: Warm tones for connection, cool for separation
254
+ - **Symbolic imagery**: Objects representing the friendship (gifts, shared possessions)
255
+ - **Framing**: Friends in frame together showing unity, separated showing conflict
256
+
257
+ ### Action and Behavior
258
+
259
+ - Show friends anticipating each other's needs
260
+ - Demonstrate sacrifice without being asked
261
+ - Create moments of nonverbal communication
262
+ - Show physical comfort (hugs, shoulder touches) appropriate to the relationship
263
+
264
+ ## Film Examples
265
+
266
+ ### Example 1: The Shawshank Redemption (1994)
267
+
268
+ **Director**: Frank Darabont
269
+
270
+ **Thematic Exploration**: Explores friendship as survival, hope, and mutual transformation in the most hopeless circumstances.
271
+
272
+ **Key Thematic Moments**:
273
+ - **The rooftop scene**: Andy earns Red's friendship through generosity
274
+ - **The opera scene**: Andy shares beauty with Red and others
275
+ - **"Get busy living or get busy dying"**: Red's philosophy shaped by Andy
276
+ - **The escape reveal**: Andy's ultimate gift to Red—hope and freedom
277
+ - **Zihuatanejo**: Friendship reunited, both men transformed
278
+
279
+ **Thematic Resolution**: Friendship provides hope, purpose, and transformation even in prison. Both men are better because of each other.
280
+
281
+ **Techniques Used**:
282
+ - Voice-over narration from Red's perspective showing friendship's impact
283
+ - Gradual development of trust over years
284
+ - Contrast between Andy's hope and Red's cynicism
285
+ - Visual symbolism (the rock hammer, the poster, the ocean)
286
+ - Reunion as ultimate payoff of friendship
287
+
288
+ ---
289
+
290
+ ### Example 2: Toy Story (1995)
291
+
292
+ **Director**: John Lasseter
293
+
294
+ **Thematic Exploration**: Explores friendship formed through rivalry, examining jealousy, loyalty, and learning to value each other's strengths.
295
+
296
+ **Key Thematic Moments**:
297
+ - **Buzz's arrival**: Woody's jealousy threatening friendship before it begins
298
+ - **"You are a toy!"**: Woody's cruel truth-telling damaging Buzz
299
+ - **Working together**: Learning to combine their strengths
300
+ - **"You've got a friend in me"**: Theme song explicitly stating friendship theme
301
+ - **Choosing each other**: Both toys choosing friendship over individual glory
302
+
303
+ **Thematic Resolution**: True friendship requires accepting each other's differences and valuing complementary strengths.
304
+
305
+ **Techniques Used**:
306
+ - Rivalry to friendship arc
307
+ - Complementary character design (cowboy vs. spaceman)
308
+ - Visual language of separation and unity
309
+ - Shared goal (returning to Andy) uniting them
310
+ - Sacrifice for each other proving friendship
311
+
312
+ ---
313
+
314
+ ### Example 3: Stand by Me (1986)
315
+
316
+ **Director**: Rob Reiner
317
+
318
+ **Thematic Exploration**: Explores childhood friendship and its formative power, examining how shared experience creates bonds that shape who we become.
319
+
320
+ **Key Thematic Moments**:
321
+ - **The journey begins**: Four boys seeking adventure together
322
+ - **Sharing stories**: Vulnerability and imagination bonding them
323
+ - **Facing the train**: Shared danger proving courage
324
+ - **Gordie's story**: Creative expression supported by friends
325
+ - **"I never had any friends later on like the ones I had when I was twelve"**: Acknowledging friendship's unique power
326
+
327
+ **Thematic Resolution**: Childhood friendships are formative and irreplaceable, shaping who we become even as we grow apart.
328
+
329
+ **Techniques Used**:
330
+ - Coming-of-age journey structure
331
+ - Voice-over from adult Gordie reflecting on friendship
332
+ - Shared danger and adventure bonding characters
333
+ - Individual character arcs supported by friendship
334
+ - Bittersweet ending acknowledging friendships change
335
+
336
+ ---
337
+
338
+ ### Example 4: The Lord of the Rings Trilogy (2001-2003)
339
+
340
+ **Director**: Peter Jackson
341
+
342
+ **Thematic Exploration**: Explores friendship as loyalty, sacrifice, and the strength to endure impossible challenges together.
343
+
344
+ **Key Thematic Moments**:
345
+ - **The Fellowship forms**: Different races united in friendship
346
+ - **"You have my sword/bow/axe"**: Pledging loyalty
347
+ - **Sam carrying Frodo**: Ultimate physical demonstration of friendship
348
+ - **"I can't carry it for you, but I can carry you"**: Defining friendship's limits and strengths
349
+ - **The Grey Havens**: Friendship enduring even through separation
350
+
351
+ **Thematic Resolution**: Friendship provides the strength to endure impossible burdens and accomplish what individuals cannot.
352
+
353
+ **Techniques Used**:
354
+ - Epic scale emphasizing friendship's power
355
+ - Multiple friendship pairs (Frodo/Sam, Merry/Pippin, Legolas/Gimli)
356
+ - Physical journey mirroring emotional journey
357
+ - Sacrifice as ultimate proof of friendship
358
+ - Visual symbolism (the Ring as burden, friends as support)
359
+
360
+ ---
361
+
362
+ ### Example 5: Thelma & Louise (1991)
363
+
364
+ **Director**: Ridley Scott
365
+
366
+ **Thematic Exploration**: Explores female friendship as liberation, examining how friends empower each other to break free from oppression.
367
+
368
+ **Key Thematic Moments**:
369
+ - **The road trip begins**: Escape from ordinary life together
370
+ - **Louise protecting Thelma**: Friendship as protection
371
+ - **Thelma's transformation**: Empowered by Louise's support
372
+ - **"You're a good friend"**: Acknowledging the bond
373
+ - **The final drive**: Choosing freedom together over capture
374
+
375
+ **Thematic Resolution**: Friendship empowers transformation and provides courage to choose freedom even at ultimate cost.
376
+
377
+ **Techniques Used**:
378
+ - Road movie structure emphasizing journey together
379
+ - Visual transformation (appearance, confidence)
380
+ - Complementary character arcs (Louise's control, Thelma's liberation)
381
+ - Landscape as metaphor for freedom
382
+ - Controversial ending showing ultimate unity
383
+
384
+ ---
385
+
386
+ ## Integration with Other Features
387
+
388
+ ### Compatible Genres
389
+
390
+ - **Drama**: Deep exploration of friendship dynamics
391
+ - **Comedy**: Friendship through humor and shared experiences
392
+ - **Adventure**: Friends united by shared quest
393
+ - **Coming-of-Age**: Formative friendships shaping identity
394
+ - **War**: Friendship forged in extreme circumstances
395
+ - **Buddy Films**: Friendship as central relationship
396
+
397
+ ### Compatible Themes (Multi-Theme Stories)
398
+
399
+ - **Loyalty**: Friendship requires and demonstrates loyalty
400
+ - **Growth**: Friends catalyze each other's transformation
401
+ - **Sacrifice**: Friendship often requires sacrifice
402
+ - **Identity**: Friends help discover or shape identity
403
+ - **Belonging**: Friendship provides sense of belonging
404
+ - **Trust**: Foundation of all friendship
405
+
406
+ ### Compatible Styles
407
+
408
+ - **Character-Driven**: Focuses on relationship dynamics
409
+ - **Ensemble**: Multiple friendships explored simultaneously
410
+ - **Journey/Quest**: Friends united by shared goal
411
+ - **Slice-of-Life**: Friendship in everyday moments
412
+
413
+ ## Common Pitfalls
414
+
415
+ ### Pitfall 1: Interchangeable Friends
416
+
417
+ **Problem**: Friends have no distinct personalities or contributions to the relationship.
418
+
419
+ **Solution**: Create complementary characters with unique strengths and perspectives.
420
+
421
+ **Example**: Each friend should bring something specific to the relationship that the other lacks.
422
+
423
+ ---
424
+
425
+ ### Pitfall 2: Untested Friendship
426
+
427
+ **Problem**: Friends never face situations that genuinely test their loyalty or bond.
428
+
429
+ **Solution**: Create conflicts that force friends to choose between loyalty and self-interest.
430
+
431
+ **Example**: Present situations where supporting the friend costs something significant.
432
+
433
+ ---
434
+
435
+ ### Pitfall 3: Telling Instead of Showing
436
+
437
+ **Problem**: Characters constantly declare their friendship but never demonstrate it through action.
438
+
439
+ **Solution**: Show friendship through behavior, sacrifice, and support.
440
+
441
+ **Example**: Instead of "you're my best friend," show the character risking something for their friend.
442
+
443
+ ---
444
+
445
+ ### Pitfall 4: No Individual Identity
446
+
447
+ **Problem**: Friends lose all individual personality and become codependent or interchangeable.
448
+
449
+ **Solution**: Maintain distinct individual identities while showing unity.
450
+
451
+ **Example**: Friends should have individual goals, personalities, and arcs while supporting each other.
452
+
453
+ ---
454
+
455
+ ### Pitfall 5: Conflict-Free Friendship
456
+
457
+ **Problem**: Friends never disagree or have tension, making the relationship feel shallow.
458
+
459
+ **Solution**: Include realistic conflicts that test and ultimately strengthen the bond.
460
+
461
+ **Example**: Friends should challenge each other and have disagreements that reveal character.
462
+
463
+ ---
464
+
465
+ ## Best Practices
466
+
467
+ 1. **Create complementary characters** - Different strengths that make them stronger together
468
+ 2. **Test the friendship** - Conflicts that force choice between loyalty and self-interest
469
+ 3. **Show mutual transformation** - Both friends change because of the relationship
470
+ 4. **Balance shared and individual goals** - Unity and individuality coexist
471
+ 5. **Require sacrifice** - Friendship must cost something to feel valuable
472
+ 6. **Show vulnerability** - True friendship requires emotional openness
473
+ 7. **Maintain individual identity** - Friends enhance rather than erase individuality
474
+ 8. **Demonstrate through action** - Show friendship through behavior, not declarations
475
+ 9. **Use visual storytelling** - Show connection through imagery and framing
476
+ 10. **Avoid preachiness** - Let the relationship speak for itself
477
+
478
+ ## Resources
479
+
480
+ - *The Anatomy of Story* by John Truby - Relationship dynamics in narrative
481
+ - *Story* by Robert McKee - Character relationships and bonds
482
+ - *The Writer's Journey* by Christopher Vogler - Allies and friendship in hero's journey
483
+ - *Into the Woods* by John Yorke - Relationship arcs and structure
484
+ - *Save the Cat!* by Blake Snyder - Buddy film structure
485
+
486
+ ---
487
+
488
+ **Depth Coverage**: 85%
489
+ **Last Updated**: 2026-01-31
490
+ **Version**: 1.0.0
491
+