@mytechtoday/augment-extensions 0.7.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (483) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +109 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +11 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +120 -0
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  476. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  477. package/cli/dist/utils/extractCommandHelp.js +250 -0
  478. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  479. package/cli/dist/utils/install-rules.js +55 -55
  480. package/cli/dist/utils/mcp-integration.js +44 -44
  481. package/cli/dist/utils/rule-install-hooks.js +8 -8
  482. package/modules.md +667 -630
  483. package/package.json +85 -85
@@ -1,289 +1,289 @@
1
- # Science Fiction Genre
2
-
3
- **Category**: Screenplay Genre
4
- **Type**: Primary
5
- **Complexity**: High
6
-
7
- ## Overview
8
-
9
- Science fiction explores the impact of imagined scientific or technological advances on society, individuals, and humanity. The genre uses speculative concepts to examine contemporary issues through a futuristic or alternative lens.
10
-
11
- ## Core Concept
12
-
13
- Sci-fi screenplays are built on "what if?" questions about science, technology, and their consequences. The genre requires internal consistency, plausible extrapolation from current knowledge, and exploration of how technological or scientific changes affect human nature, society, and morality. Great sci-fi uses the fantastic to illuminate the real.
14
-
15
- ## Core Rules
16
-
17
- ### Rule 1: Establish Clear World Rules
18
-
19
- **Description**: Define the scientific/technological premise early and maintain internal consistency throughout.
20
-
21
- **Why It Matters**: Audiences will accept almost any premise if the rules are clear and consistently applied. Breaking your own rules destroys credibility.
22
-
23
- **Examples**:
24
- - ✅ **Good**: Time travel has specific rules (e.g., can't change past) that are established and followed
25
- - ❌ **Bad**: Technology works differently each time it's convenient for the plot
26
-
27
- **Film Reference**: Inception (2010) - Dream mechanics are clearly explained and consistently applied throughout.
28
-
29
- ---
30
-
31
- ### Rule 2: Ground the Fantastic in Human Stakes
32
-
33
- **Description**: No matter how advanced the technology or alien the setting, the story must center on relatable human emotions and conflicts.
34
-
35
- **Why It Matters**: Audiences connect with characters, not concepts. The sci-fi elements should serve character and theme, not overshadow them.
36
-
37
- **Examples**:
38
- - ✅ **Good**: AI story about what it means to be human (Ex Machina)
39
- - ❌ **Bad**: Cool tech with no emotional or philosophical depth
40
-
41
- **Film Reference**: Arrival (2016) - Alien contact story is fundamentally about grief, communication, and choice.
42
-
43
- ---
44
-
45
- ### Rule 3: Extrapolate, Don't Fabricate
46
-
47
- **Description**: Base your speculative elements on real science or logical extensions of current technology.
48
-
49
- **Why It Matters**: Plausibility enhances immersion. Even far-future tech should feel like it evolved from something recognizable.
50
-
51
- **Examples**:
52
- - ✅ **Good**: AI development based on current machine learning trends
53
- - ❌ **Bad**: Magic disguised as science with no logical basis
54
-
55
- **Film Reference**: The Martian (2015) - Survival on Mars using real science and problem-solving.
56
-
57
- ---
58
-
59
- ### Rule 4: Use Sci-Fi to Explore Ideas
60
-
61
- **Description**: The best sci-fi uses its premise to examine philosophical, ethical, or social questions.
62
-
63
- **Why It Matters**: Sci-fi without ideas is just spectacle. The genre's strength is making us think about ourselves and our world.
64
-
65
- **Examples**:
66
- - ✅ **Good**: Blade Runner explores what makes us human through replicants
67
- - ❌ **Bad**: Spaceships and lasers with no thematic depth
68
-
69
- **Film Reference**: Gattaca (1997) - Genetic engineering as lens for examining discrimination and human potential.
70
-
71
- ---
72
-
73
- ### Rule 5: Show the Ripple Effects
74
-
75
- **Description**: Demonstrate how your sci-fi premise affects society, culture, economics, and daily life—not just the plot.
76
-
77
- **Why It Matters**: Believable worldbuilding requires thinking through consequences. Technology changes everything, not just one aspect of life.
78
-
79
- **Examples**:
80
- - ✅ **Good**: Minority Report shows how pre-crime affects law, privacy, and society
81
- - ❌ **Bad**: Revolutionary tech exists but society is otherwise unchanged
82
-
83
- **Film Reference**: Her (2013) - AI companions affect relationships, work, and social norms throughout society.
84
-
85
- ---
86
-
87
- ## Guidelines
88
-
89
- ### Structure
90
-
91
- - **Act I**: Establish the world and its rules, introduce the sci-fi premise, show how it affects the protagonist
92
- - **Act II**: Explore implications of the premise, escalate conflicts arising from the technology/science, test the protagonist's understanding
93
- - **Act III**: Resolve conflicts through understanding or mastery of the sci-fi element, often with thematic revelation
94
-
95
- ### Pacing
96
-
97
- - Balance exposition with action—avoid info dumps
98
- - Use visual storytelling to convey world details
99
- - Introduce concepts gradually through character experience
100
- - Allow time for philosophical exploration without stalling plot
101
- - Build to climax that synthesizes action and ideas
102
-
103
- ### Character Archetypes
104
-
105
- - **Protagonist**: Often scientist, explorer, or ordinary person confronting extraordinary science
106
- - **Antagonist**: Can be human misusing technology, the technology itself, or alien force
107
- - **Supporting**: Mentor scientist, skeptical authority, AI companion, alien ally/enemy
108
-
109
- ### Tone and Atmosphere
110
-
111
- - Can range from optimistic (Star Trek) to dystopian (Blade Runner)
112
- - Sense of wonder at possibilities
113
- - Unease about consequences
114
- - Intellectual curiosity
115
- - Often contemplative or philosophical
116
-
117
- ### Visual Style
118
-
119
- - Production design that feels lived-in and functional
120
- - Technology that looks purposeful, not just decorative
121
- - Consistent aesthetic that reflects the world's logic
122
- - Use of scale to convey scope (vast space, tiny humans)
123
- - Lighting and color palette that supports tone
124
-
125
- ### Dialogue
126
-
127
- - Avoid technobabble unless necessary; keep it minimal
128
- - Characters should understand their world—no exposition for audience benefit
129
- - Scientific concepts explained through character conflict or discovery
130
- - Natural integration of futuristic slang or terminology
131
- - Balance intellectual discussion with emotional authenticity
132
-
133
- ## Common Pitfalls
134
-
135
- ### Pitfall 1: Exposition Overload
136
-
137
- **Problem**: Stopping the story to explain the science or world in lengthy monologues.
138
-
139
- **Solution**: Reveal world details through action, visual storytelling, and character experience. Trust the audience.
140
-
141
- **Example**: Mad Max: Fury Road shows its post-apocalyptic world through action and visuals, minimal exposition.
142
-
143
- ---
144
-
145
- ### Pitfall 2: Inconsistent Rules
146
-
147
- **Problem**: Changing how the technology or science works to serve plot convenience.
148
-
149
- **Solution**: Establish clear limitations and stick to them. Work within your own constraints.
150
-
151
- **Example**: Looper establishes time travel rules and mostly adheres to them, addressing paradoxes directly.
152
-
153
- ---
154
-
155
- ### Pitfall 3: Style Over Substance
156
-
157
- **Problem**: Focusing on cool visuals and tech without exploring meaningful themes or character arcs.
158
-
159
- **Solution**: Use the sci-fi premise to explore human questions. The tech should serve the story, not be the story.
160
-
161
- **Example**: District 9 uses alien refugees as metaphor for apartheid and xenophobia, not just cool alien design.
162
-
163
- ---
164
-
165
- ## Film Examples
166
-
167
- ### Example 1: 2001: A Space Odyssey (1968)
168
-
169
- **Director**: Stanley Kubrick
170
-
171
- **Why It Works**: Combines hard science with philosophical exploration of human evolution and artificial intelligence.
172
-
173
- **Key Scenes**:
174
- - **Bone to Satellite**: Jump cut showing technological evolution
175
- - **HAL's Breakdown**: AI consciousness and the question of what makes us human
176
- - **Star Gate Sequence**: Transcendence beyond human comprehension
177
-
178
- **Techniques Used**:
179
- - Minimal dialogue; visual storytelling
180
- - Scientifically accurate space travel
181
- - Ambiguity that invites interpretation
182
-
183
- ---
184
-
185
- ### Example 2: Blade Runner (1982)
186
-
187
- **Director**: Ridley Scott
188
-
189
- **Why It Works**: Uses replicants to explore identity, memory, mortality, and what defines humanity.
190
-
191
- **Key Scenes**:
192
- - **Voight-Kampff Test**: Measuring empathy to detect artificial beings
193
- - **Tears in Rain**: Replicant's meditation on mortality and meaning
194
- - **Deckard's Uncertainty**: Ambiguity about protagonist's own nature
195
-
196
- **Techniques Used**:
197
- - Noir aesthetic applied to future setting
198
- - Philosophical questions embedded in detective plot
199
- - Lived-in, believable future world
200
-
201
- ---
202
-
203
- ### Example 3: The Matrix (1999)
204
-
205
- **Directors**: The Wachowskis
206
-
207
- **Why It Works**: Combines action with philosophical questions about reality, free will, and human potential.
208
-
209
- **Key Scenes**:
210
- - **Red Pill/Blue Pill**: Choice between comfortable illusion and harsh truth
211
- - **Bullet Time**: Visual representation of seeing beyond normal perception
212
- - **Neo's Resurrection**: Belief and will transcending programmed reality
213
-
214
- **Techniques Used**:
215
- - Philosophical concepts (Plato's Cave, Descartes) in action framework
216
- - Visual effects that serve thematic purpose
217
- - Hero's journey in sci-fi context
218
-
219
- ---
220
-
221
- ### Example 4: Interstellar (2014)
222
-
223
- **Director**: Christopher Nolan
224
-
225
- **Why It Works**: Combines hard science (relativity, black holes) with emotional story about love and sacrifice.
226
-
227
- **Key Scenes**:
228
- - **Time Dilation**: Astronaut ages slower than his children—science creates emotional stakes
229
- - **Tesseract**: Love as dimension that transcends space-time
230
- - **Messages from Earth**: Emotional cost of exploration
231
-
232
- **Techniques Used**:
233
- - Real physics (Kip Thorne consultation)
234
- - Emotional stakes grounded in parent-child relationship
235
- - Practical effects and real locations where possible
236
-
237
- ---
238
-
239
- ## Integration with Other Features
240
-
241
- ### Compatible Themes
242
-
243
- - **Humanity vs. Technology**: Core sci-fi tension
244
- - **Identity and Consciousness**: What makes us who we are
245
- - **Progress and Consequences**: Cost of advancement
246
- - **Isolation**: Space travel, alien worlds, technological disconnect
247
- - **Free Will vs. Determinism**: Especially in time travel or AI stories
248
-
249
- ### Compatible Styles
250
-
251
- - **Hard Sci-Fi**: Emphasis on scientific accuracy (The Martian, Gravity)
252
- - **Cyberpunk**: High tech, low life; corporate dystopia (Blade Runner, Ghost in the Shell)
253
- - **Space Opera**: Epic scope, galactic conflicts (Star Wars, Dune)
254
- - **Post-Apocalyptic**: After technological or environmental collapse (Mad Max, Children of Men)
255
-
256
- ### Hybrid Combinations
257
-
258
- - **Sci-Fi + Horror**: Technology or aliens as threat (Alien, Event Horizon)
259
- - **Sci-Fi + Noir**: Detective stories in future settings (Blade Runner, Altered Carbon)
260
- - **Sci-Fi + Romance**: Love across time, space, or species (Her, Eternal Sunshine)
261
- - **Sci-Fi + Thriller**: Paranoia and conspiracy in tech settings (Minority Report, Ex Machina)
262
-
263
- ## Best Practices
264
-
265
- 1. **Research the Science**: Even if speculative, ground it in real principles
266
- 2. **Think Through Implications**: How does your premise change everything?
267
- 3. **Show, Don't Tell**: Reveal world through visuals and action, not exposition
268
- 4. **Make It Personal**: Connect big ideas to individual human stories
269
- 5. **Consistency is Key**: Establish rules and follow them
270
- 6. **Use Metaphor**: Sci-fi elements should represent real-world issues
271
- 7. **Avoid Technobabble**: Keep scientific dialogue clear and purposeful
272
- 8. **World-Building Details**: Small touches make the world feel real
273
- 9. **Question Assumptions**: Challenge what we take for granted
274
- 10. **Balance Wonder and Warning**: Sci-fi can be optimistic or cautionary
275
-
276
- ## Resources
277
-
278
- - "The Science Fiction Handbook" by M. Keith Booker and Anne-Marie Thomas
279
- - "How to Write Science Fiction & Fantasy" by Orson Scott Card
280
- - "The Cambridge Companion to Science Fiction" edited by Edward James and Farah Mendlesohn
281
- - "Dune" by Frank Herbert - Masterclass in worldbuilding and political sci-fi
282
- - "Foundation" by Isaac Asimov - Exploration of psychohistory and societal prediction
283
-
284
- ---
285
-
286
- **Depth Coverage**: 85%
287
- **Last Updated**: 2026-01-31
288
- **Version**: 1.0.0
289
-
1
+ # Science Fiction Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Science fiction explores the impact of imagined scientific or technological advances on society, individuals, and humanity. The genre uses speculative concepts to examine contemporary issues through a futuristic or alternative lens.
10
+
11
+ ## Core Concept
12
+
13
+ Sci-fi screenplays are built on "what if?" questions about science, technology, and their consequences. The genre requires internal consistency, plausible extrapolation from current knowledge, and exploration of how technological or scientific changes affect human nature, society, and morality. Great sci-fi uses the fantastic to illuminate the real.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Establish Clear World Rules
18
+
19
+ **Description**: Define the scientific/technological premise early and maintain internal consistency throughout.
20
+
21
+ **Why It Matters**: Audiences will accept almost any premise if the rules are clear and consistently applied. Breaking your own rules destroys credibility.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: Time travel has specific rules (e.g., can't change past) that are established and followed
25
+ - ❌ **Bad**: Technology works differently each time it's convenient for the plot
26
+
27
+ **Film Reference**: Inception (2010) - Dream mechanics are clearly explained and consistently applied throughout.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Ground the Fantastic in Human Stakes
32
+
33
+ **Description**: No matter how advanced the technology or alien the setting, the story must center on relatable human emotions and conflicts.
34
+
35
+ **Why It Matters**: Audiences connect with characters, not concepts. The sci-fi elements should serve character and theme, not overshadow them.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: AI story about what it means to be human (Ex Machina)
39
+ - ❌ **Bad**: Cool tech with no emotional or philosophical depth
40
+
41
+ **Film Reference**: Arrival (2016) - Alien contact story is fundamentally about grief, communication, and choice.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Extrapolate, Don't Fabricate
46
+
47
+ **Description**: Base your speculative elements on real science or logical extensions of current technology.
48
+
49
+ **Why It Matters**: Plausibility enhances immersion. Even far-future tech should feel like it evolved from something recognizable.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: AI development based on current machine learning trends
53
+ - ❌ **Bad**: Magic disguised as science with no logical basis
54
+
55
+ **Film Reference**: The Martian (2015) - Survival on Mars using real science and problem-solving.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Use Sci-Fi to Explore Ideas
60
+
61
+ **Description**: The best sci-fi uses its premise to examine philosophical, ethical, or social questions.
62
+
63
+ **Why It Matters**: Sci-fi without ideas is just spectacle. The genre's strength is making us think about ourselves and our world.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Blade Runner explores what makes us human through replicants
67
+ - ❌ **Bad**: Spaceships and lasers with no thematic depth
68
+
69
+ **Film Reference**: Gattaca (1997) - Genetic engineering as lens for examining discrimination and human potential.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Show the Ripple Effects
74
+
75
+ **Description**: Demonstrate how your sci-fi premise affects society, culture, economics, and daily life—not just the plot.
76
+
77
+ **Why It Matters**: Believable worldbuilding requires thinking through consequences. Technology changes everything, not just one aspect of life.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Minority Report shows how pre-crime affects law, privacy, and society
81
+ - ❌ **Bad**: Revolutionary tech exists but society is otherwise unchanged
82
+
83
+ **Film Reference**: Her (2013) - AI companions affect relationships, work, and social norms throughout society.
84
+
85
+ ---
86
+
87
+ ## Guidelines
88
+
89
+ ### Structure
90
+
91
+ - **Act I**: Establish the world and its rules, introduce the sci-fi premise, show how it affects the protagonist
92
+ - **Act II**: Explore implications of the premise, escalate conflicts arising from the technology/science, test the protagonist's understanding
93
+ - **Act III**: Resolve conflicts through understanding or mastery of the sci-fi element, often with thematic revelation
94
+
95
+ ### Pacing
96
+
97
+ - Balance exposition with action—avoid info dumps
98
+ - Use visual storytelling to convey world details
99
+ - Introduce concepts gradually through character experience
100
+ - Allow time for philosophical exploration without stalling plot
101
+ - Build to climax that synthesizes action and ideas
102
+
103
+ ### Character Archetypes
104
+
105
+ - **Protagonist**: Often scientist, explorer, or ordinary person confronting extraordinary science
106
+ - **Antagonist**: Can be human misusing technology, the technology itself, or alien force
107
+ - **Supporting**: Mentor scientist, skeptical authority, AI companion, alien ally/enemy
108
+
109
+ ### Tone and Atmosphere
110
+
111
+ - Can range from optimistic (Star Trek) to dystopian (Blade Runner)
112
+ - Sense of wonder at possibilities
113
+ - Unease about consequences
114
+ - Intellectual curiosity
115
+ - Often contemplative or philosophical
116
+
117
+ ### Visual Style
118
+
119
+ - Production design that feels lived-in and functional
120
+ - Technology that looks purposeful, not just decorative
121
+ - Consistent aesthetic that reflects the world's logic
122
+ - Use of scale to convey scope (vast space, tiny humans)
123
+ - Lighting and color palette that supports tone
124
+
125
+ ### Dialogue
126
+
127
+ - Avoid technobabble unless necessary; keep it minimal
128
+ - Characters should understand their world—no exposition for audience benefit
129
+ - Scientific concepts explained through character conflict or discovery
130
+ - Natural integration of futuristic slang or terminology
131
+ - Balance intellectual discussion with emotional authenticity
132
+
133
+ ## Common Pitfalls
134
+
135
+ ### Pitfall 1: Exposition Overload
136
+
137
+ **Problem**: Stopping the story to explain the science or world in lengthy monologues.
138
+
139
+ **Solution**: Reveal world details through action, visual storytelling, and character experience. Trust the audience.
140
+
141
+ **Example**: Mad Max: Fury Road shows its post-apocalyptic world through action and visuals, minimal exposition.
142
+
143
+ ---
144
+
145
+ ### Pitfall 2: Inconsistent Rules
146
+
147
+ **Problem**: Changing how the technology or science works to serve plot convenience.
148
+
149
+ **Solution**: Establish clear limitations and stick to them. Work within your own constraints.
150
+
151
+ **Example**: Looper establishes time travel rules and mostly adheres to them, addressing paradoxes directly.
152
+
153
+ ---
154
+
155
+ ### Pitfall 3: Style Over Substance
156
+
157
+ **Problem**: Focusing on cool visuals and tech without exploring meaningful themes or character arcs.
158
+
159
+ **Solution**: Use the sci-fi premise to explore human questions. The tech should serve the story, not be the story.
160
+
161
+ **Example**: District 9 uses alien refugees as metaphor for apartheid and xenophobia, not just cool alien design.
162
+
163
+ ---
164
+
165
+ ## Film Examples
166
+
167
+ ### Example 1: 2001: A Space Odyssey (1968)
168
+
169
+ **Director**: Stanley Kubrick
170
+
171
+ **Why It Works**: Combines hard science with philosophical exploration of human evolution and artificial intelligence.
172
+
173
+ **Key Scenes**:
174
+ - **Bone to Satellite**: Jump cut showing technological evolution
175
+ - **HAL's Breakdown**: AI consciousness and the question of what makes us human
176
+ - **Star Gate Sequence**: Transcendence beyond human comprehension
177
+
178
+ **Techniques Used**:
179
+ - Minimal dialogue; visual storytelling
180
+ - Scientifically accurate space travel
181
+ - Ambiguity that invites interpretation
182
+
183
+ ---
184
+
185
+ ### Example 2: Blade Runner (1982)
186
+
187
+ **Director**: Ridley Scott
188
+
189
+ **Why It Works**: Uses replicants to explore identity, memory, mortality, and what defines humanity.
190
+
191
+ **Key Scenes**:
192
+ - **Voight-Kampff Test**: Measuring empathy to detect artificial beings
193
+ - **Tears in Rain**: Replicant's meditation on mortality and meaning
194
+ - **Deckard's Uncertainty**: Ambiguity about protagonist's own nature
195
+
196
+ **Techniques Used**:
197
+ - Noir aesthetic applied to future setting
198
+ - Philosophical questions embedded in detective plot
199
+ - Lived-in, believable future world
200
+
201
+ ---
202
+
203
+ ### Example 3: The Matrix (1999)
204
+
205
+ **Directors**: The Wachowskis
206
+
207
+ **Why It Works**: Combines action with philosophical questions about reality, free will, and human potential.
208
+
209
+ **Key Scenes**:
210
+ - **Red Pill/Blue Pill**: Choice between comfortable illusion and harsh truth
211
+ - **Bullet Time**: Visual representation of seeing beyond normal perception
212
+ - **Neo's Resurrection**: Belief and will transcending programmed reality
213
+
214
+ **Techniques Used**:
215
+ - Philosophical concepts (Plato's Cave, Descartes) in action framework
216
+ - Visual effects that serve thematic purpose
217
+ - Hero's journey in sci-fi context
218
+
219
+ ---
220
+
221
+ ### Example 4: Interstellar (2014)
222
+
223
+ **Director**: Christopher Nolan
224
+
225
+ **Why It Works**: Combines hard science (relativity, black holes) with emotional story about love and sacrifice.
226
+
227
+ **Key Scenes**:
228
+ - **Time Dilation**: Astronaut ages slower than his children—science creates emotional stakes
229
+ - **Tesseract**: Love as dimension that transcends space-time
230
+ - **Messages from Earth**: Emotional cost of exploration
231
+
232
+ **Techniques Used**:
233
+ - Real physics (Kip Thorne consultation)
234
+ - Emotional stakes grounded in parent-child relationship
235
+ - Practical effects and real locations where possible
236
+
237
+ ---
238
+
239
+ ## Integration with Other Features
240
+
241
+ ### Compatible Themes
242
+
243
+ - **Humanity vs. Technology**: Core sci-fi tension
244
+ - **Identity and Consciousness**: What makes us who we are
245
+ - **Progress and Consequences**: Cost of advancement
246
+ - **Isolation**: Space travel, alien worlds, technological disconnect
247
+ - **Free Will vs. Determinism**: Especially in time travel or AI stories
248
+
249
+ ### Compatible Styles
250
+
251
+ - **Hard Sci-Fi**: Emphasis on scientific accuracy (The Martian, Gravity)
252
+ - **Cyberpunk**: High tech, low life; corporate dystopia (Blade Runner, Ghost in the Shell)
253
+ - **Space Opera**: Epic scope, galactic conflicts (Star Wars, Dune)
254
+ - **Post-Apocalyptic**: After technological or environmental collapse (Mad Max, Children of Men)
255
+
256
+ ### Hybrid Combinations
257
+
258
+ - **Sci-Fi + Horror**: Technology or aliens as threat (Alien, Event Horizon)
259
+ - **Sci-Fi + Noir**: Detective stories in future settings (Blade Runner, Altered Carbon)
260
+ - **Sci-Fi + Romance**: Love across time, space, or species (Her, Eternal Sunshine)
261
+ - **Sci-Fi + Thriller**: Paranoia and conspiracy in tech settings (Minority Report, Ex Machina)
262
+
263
+ ## Best Practices
264
+
265
+ 1. **Research the Science**: Even if speculative, ground it in real principles
266
+ 2. **Think Through Implications**: How does your premise change everything?
267
+ 3. **Show, Don't Tell**: Reveal world through visuals and action, not exposition
268
+ 4. **Make It Personal**: Connect big ideas to individual human stories
269
+ 5. **Consistency is Key**: Establish rules and follow them
270
+ 6. **Use Metaphor**: Sci-fi elements should represent real-world issues
271
+ 7. **Avoid Technobabble**: Keep scientific dialogue clear and purposeful
272
+ 8. **World-Building Details**: Small touches make the world feel real
273
+ 9. **Question Assumptions**: Challenge what we take for granted
274
+ 10. **Balance Wonder and Warning**: Sci-fi can be optimistic or cautionary
275
+
276
+ ## Resources
277
+
278
+ - "The Science Fiction Handbook" by M. Keith Booker and Anne-Marie Thomas
279
+ - "How to Write Science Fiction & Fantasy" by Orson Scott Card
280
+ - "The Cambridge Companion to Science Fiction" edited by Edward James and Farah Mendlesohn
281
+ - "Dune" by Frank Herbert - Masterclass in worldbuilding and political sci-fi
282
+ - "Foundation" by Isaac Asimov - Exploration of psychohistory and societal prediction
283
+
284
+ ---
285
+
286
+ **Depth Coverage**: 85%
287
+ **Last Updated**: 2026-01-31
288
+ **Version**: 1.0.0
289
+