@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,293 +1,293 @@
1
- # Romance Genre
2
-
3
- **Category**: Screenplay Genre
4
- **Type**: Primary
5
- **Complexity**: Medium
6
-
7
- ## Overview
8
-
9
- Romance films center on the development of a romantic relationship between protagonists. The genre emphasizes emotional connection, obstacles to love, and the journey toward commitment or heartbreak.
10
-
11
- ## Core Concept
12
-
13
- Romance screenplays explore the complexities of love, attraction, and relationships. Success depends on creating believable chemistry, meaningful obstacles that test the relationship, and emotional authenticity. Great romance makes audiences invest in whether the couple will overcome their differences and end up together, while exploring what love means and costs.
14
-
15
- ## Core Rules
16
-
17
- ### Rule 1: Create Genuine Chemistry
18
-
19
- **Description**: The romantic leads must have believable attraction - emotional, intellectual, or physical - that the audience can feel.
20
-
21
- **Why It Matters**: Without chemistry, the entire romance falls flat. Audiences must want these people together.
22
-
23
- **Examples**:
24
- - ✅ **Good**: Witty banter, shared vulnerabilities, moments of genuine connection
25
- - ❌ **Bad**: Characters say they love each other but show no real connection or compatibility
26
-
27
- **Film Reference**: When Harry Met Sally (1989) - Chemistry built through years of friendship, conversation, and gradual realization.
28
-
29
- ---
30
-
31
- ### Rule 2: Obstacles Must Be Meaningful
32
-
33
- **Description**: What keeps the couple apart must be substantial, believable, and rooted in character or circumstance, not contrivance.
34
-
35
- **Why It Matters**: Weak obstacles feel artificial. Strong obstacles create genuine tension and test whether love can overcome real challenges.
36
-
37
- **Examples**:
38
- - ✅ **Good**: Class differences, conflicting life goals, past trauma, family opposition with real stakes
39
- - ❌ **Bad**: Simple misunderstanding that could be resolved with one conversation
40
-
41
- **Film Reference**: The Notebook (2004) - Class differences, family opposition, and memory loss create layered obstacles.
42
-
43
- ---
44
-
45
- ### Rule 3: Both Characters Must Grow
46
-
47
- **Description**: Romance should transform both people. Each must change, compromise, or evolve to make the relationship work.
48
-
49
- **Why It Matters**: One-sided growth suggests unhealthy relationship. Mutual transformation shows true partnership.
50
-
51
- **Examples**:
52
- - ✅ **Good**: Both characters confront their flaws and grow to meet each other
53
- - ❌ **Bad**: One character changes everything while the other remains static
54
-
55
- **Film Reference**: Pride and Prejudice (2005) - Both Elizabeth and Darcy must overcome pride and prejudice to find love.
56
-
57
- ---
58
-
59
- ### Rule 4: Earn the Emotional Beats
60
-
61
- **Description**: Major romantic moments (first kiss, declaration of love, reunion) must be earned through buildup and character development.
62
-
63
- **Why It Matters**: Unearned moments feel hollow. Emotional payoff requires proper setup and timing.
64
-
65
- **Examples**:
66
- - ✅ **Good**: First kiss after building tension and connection over multiple scenes
67
- - ❌ **Bad**: Love confession in first meeting with no foundation
68
-
69
- **Film Reference**: Before Sunrise (1995) - Every moment of connection earned through hours of conversation and shared experience.
70
-
71
- ---
72
-
73
- ### Rule 5: Make the Stakes Personal
74
-
75
- **Description**: What's at risk must matter deeply to the characters - not just the relationship, but their sense of self, dreams, or values.
76
-
77
- **Why It Matters**: Higher personal stakes create deeper emotional investment. Love should challenge who they are.
78
-
79
- **Examples**:
80
- - ✅ **Good**: Choosing love means sacrificing career, confronting past trauma, or changing life direction
81
- - ❌ **Bad**: Only stake is whether they date or not, with no deeper implications
82
-
83
- **Film Reference**: La La Land (2016) - Love vs. artistic ambition - both must choose between relationship and dreams.
84
-
85
- ---
86
-
87
- ## Guidelines
88
-
89
- ### Structure
90
-
91
- - **Act I**: Meet-cute or introduction, initial attraction (or antagonism), first obstacle appears
92
- - **Act II**: Relationship develops, deeper connection forms, major obstacles threaten relationship, possible breakup or separation
93
- - **Act III**: Grand gesture or realization, final obstacle overcome (or tragic separation), resolution - together or apart
94
-
95
- ### Pacing
96
-
97
- - Build attraction gradually (unless "love at first sight" is the premise)
98
- - Alternate between moments of connection and conflict
99
- - Use setbacks to test and deepen the relationship
100
- - Accelerate toward emotional climax
101
- - Allow denouement for emotional resolution
102
-
103
- ### Character Archetypes
104
-
105
- - **Protagonists**: Often opposites (cynic/optimist, rich/poor, career-focused/free-spirit) who complement each other
106
- - **Antagonist**: Can be rival suitor, disapproving family, or internal fears/past trauma
107
- - **Supporting**: Best friend confidant, wise mentor, comic relief sidekick
108
-
109
- ### Tone and Atmosphere
110
-
111
- - Can range from light rom-com to tragic romance
112
- - Emotional vulnerability and intimacy
113
- - Hope and longing
114
- - Humor often balances emotional intensity
115
- - Warmth and connection
116
-
117
- ### Visual Style
118
-
119
- - Intimate framing for emotional moments
120
- - Soft lighting for romantic scenes
121
- - Use of meaningful locations that reflect relationship
122
- - Color palette that supports tone (warm for hopeful, cool for melancholy)
123
- - Close-ups to capture emotional nuance
124
-
125
- ### Dialogue
126
-
127
- - Subtext - what's unsaid is as important as what's said
128
- - Witty banter or deep conversation depending on tone
129
- - Vulnerability in key moments
130
- - Avoid overly flowery declarations unless earned
131
- - Natural, character-specific speech patterns
132
-
133
- ## Common Pitfalls
134
-
135
- ### Pitfall 1: Contrived Misunderstandings
136
-
137
- **Problem**: Keeping couple apart through simple miscommunication that could be resolved instantly.
138
-
139
- **Solution**: Create obstacles rooted in genuine character flaws, values conflicts, or external circumstances.
140
-
141
- **Example**: Eternal Sunshine of the Spotless Mind - Relationship fails due to real incompatibilities, not simple misunderstandings.
142
-
143
- ---
144
-
145
- ### Pitfall 2: Toxic Relationships Romanticized
146
-
147
- **Problem**: Portraying controlling, manipulative, or abusive behavior as romantic or passionate.
148
-
149
- **Solution**: Show healthy conflict resolution, respect, and mutual growth. Passion doesn't require toxicity.
150
-
151
- **Example**: Crazy, Stupid, Love - Characters learn healthy relationship patterns and self-respect.
152
-
153
- ---
154
-
155
- ### Pitfall 3: No Conflict or Stakes
156
-
157
- **Problem**: Couple is perfect for each other with no real obstacles, making the story boring.
158
-
159
- **Solution**: Create meaningful internal or external conflicts that genuinely test the relationship.
160
-
161
- **Example**: The Big Sick (2017) - Cultural differences, family expectations, and life-threatening illness create real stakes.
162
-
163
- ---
164
-
165
- ## Film Examples
166
-
167
- ### Example 1: Casablanca (1942)
168
-
169
- **Director**: Michael Curtiz
170
-
171
- **Why It Works**: Timeless romance with impossible choices, sacrifice, and bittersweet ending. Love vs. duty.
172
-
173
- **Key Scenes**:
174
- - **"Of all the gin joints"**: Reunion after years, unresolved feelings
175
- - **Flashback to Paris**: Showing the depth of their past love
176
- - **Airport Farewell**: Sacrifice for greater good - "We'll always have Paris"
177
-
178
- **Techniques Used**:
179
- - Wartime setting raises stakes
180
- - Love triangle with moral complexity
181
- - Sacrifice as ultimate expression of love
182
- - Dialogue that's become iconic
183
-
184
- ---
185
-
186
- ### Example 2: Eternal Sunshine of the Spotless Mind (2004)
187
-
188
- **Director**: Michel Gondry
189
-
190
- **Why It Works**: Innovative structure exploring why relationships fail and whether love is worth the pain.
191
-
192
- **Key Scenes**:
193
- - **Memory Erasure**: Desperate attempt to forget painful relationship
194
- - **Montage of Relationship**: Showing both joy and deterioration
195
- - **"Meet me in Montauk"**: Choosing to try again despite knowing they'll fail
196
-
197
- **Techniques Used**:
198
- - Non-linear narrative reflecting memory
199
- - Sci-fi premise exploring emotional truth
200
- - Shows relationship's full arc - beginning, middle, and end
201
- - Bittersweet acceptance of love's imperfection
202
-
203
- ---
204
-
205
- ### Example 3: Before Sunrise (1995)
206
-
207
- **Director**: Richard Linklater
208
-
209
- **Why It Works**: Entire romance in one night through conversation. Chemistry and connection over plot.
210
-
211
- **Key Scenes**:
212
- - **Train Meeting**: Spontaneous decision to spend night together
213
- - **Listening Booth**: Intimate moment without words
214
- - **Sunrise Separation**: Bittersweet parting with uncertain future
215
-
216
- **Techniques Used**:
217
- - Real-time pacing creates intimacy
218
- - Dialogue-driven character development
219
- - Minimal plot - focus on connection
220
- - Ambiguous ending (resolved in sequels)
221
-
222
- ---
223
-
224
- ### Example 4: The Shape of Water (2017)
225
-
226
- **Director**: Guillermo del Toro
227
-
228
- **Why It Works**: Unconventional romance between woman and creature. Love transcends boundaries.
229
-
230
- **Key Scenes**:
231
- - **First Connection**: Communication beyond words
232
- - **Musical Fantasy**: Expression of romantic longing
233
- - **Rescue and Transformation**: Love as salvation
234
-
235
- **Techniques Used**:
236
- - Fairy tale structure in realistic setting
237
- - Outsiders finding connection
238
- - Visual storytelling over dialogue
239
- - Fantasy as metaphor for acceptance
240
-
241
- ---
242
-
243
- ## Integration with Other Features
244
-
245
- ### Compatible Themes
246
-
247
- - **Love vs. Duty**: Choosing between heart and obligation
248
- - **Self-Discovery**: Finding yourself through relationship
249
- - **Sacrifice**: What you'll give up for love
250
- - **Second Chances**: Redemption through love
251
- - **Class/Cultural Barriers**: Love across divides
252
-
253
- ### Compatible Styles
254
-
255
- - **Romantic Comedy**: Light, humorous approach to love (rom-com)
256
- - **Romantic Drama**: Serious, often tragic exploration of love
257
- - **Period Romance**: Historical settings and social constraints
258
- - **Contemporary Romance**: Modern dating and relationships
259
-
260
- ### Hybrid Combinations
261
-
262
- - **Romance + Comedy**: Rom-com (When Harry Met Sally, The Proposal)
263
- - **Romance + Drama**: Serious relationship exploration (Blue Valentine, Revolutionary Road)
264
- - **Romance + Fantasy**: Magical or supernatural love (The Shape of Water, Ghost)
265
- - **Romance + Sci-Fi**: Love across time/space (About Time, Her)
266
-
267
- ## Best Practices
268
-
269
- 1. **Chemistry is Everything**: Cast and write for genuine connection
270
- 2. **Show, Don't Tell**: Demonstrate love through actions, not just words
271
- 3. **Create Real Obstacles**: Meaningful conflicts, not contrivances
272
- 4. **Both Must Grow**: Mutual transformation, not one-sided change
273
- 5. **Earn Emotional Moments**: Build to big beats through character work
274
- 6. **Avoid Clichés**: Fresh takes on familiar tropes
275
- 7. **Respect the Audience**: Trust them to feel emotions without manipulation
276
- 8. **Make It Specific**: Unique details make romance memorable
277
- 9. **Balance Hope and Realism**: Romantic but grounded in truth
278
- 10. **The Ending Matters**: Whether together or apart, make it earned and satisfying
279
-
280
- ## Resources
281
-
282
- - "Romancing the Beat" by Gwen Hayes - Romance story structure
283
- - "The Notebook" screenplay by Jeremy Leven - Epic romance structure
284
- - "When Harry Met Sally" screenplay by Nora Ephron - Rom-com masterclass
285
- - "Pride and Prejudice" by Jane Austen - Classic romance structure
286
- - "Save the Cat! Writes a Novel" by Jessica Brody - Includes romance beats
287
-
288
- ---
289
-
290
- **Depth Coverage**: 85%
291
- **Last Updated**: 2026-01-31
292
- **Version**: 1.0.0
293
-
1
+ # Romance Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ Romance films center on the development of a romantic relationship between protagonists. The genre emphasizes emotional connection, obstacles to love, and the journey toward commitment or heartbreak.
10
+
11
+ ## Core Concept
12
+
13
+ Romance screenplays explore the complexities of love, attraction, and relationships. Success depends on creating believable chemistry, meaningful obstacles that test the relationship, and emotional authenticity. Great romance makes audiences invest in whether the couple will overcome their differences and end up together, while exploring what love means and costs.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Create Genuine Chemistry
18
+
19
+ **Description**: The romantic leads must have believable attraction - emotional, intellectual, or physical - that the audience can feel.
20
+
21
+ **Why It Matters**: Without chemistry, the entire romance falls flat. Audiences must want these people together.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: Witty banter, shared vulnerabilities, moments of genuine connection
25
+ - ❌ **Bad**: Characters say they love each other but show no real connection or compatibility
26
+
27
+ **Film Reference**: When Harry Met Sally (1989) - Chemistry built through years of friendship, conversation, and gradual realization.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Obstacles Must Be Meaningful
32
+
33
+ **Description**: What keeps the couple apart must be substantial, believable, and rooted in character or circumstance, not contrivance.
34
+
35
+ **Why It Matters**: Weak obstacles feel artificial. Strong obstacles create genuine tension and test whether love can overcome real challenges.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: Class differences, conflicting life goals, past trauma, family opposition with real stakes
39
+ - ❌ **Bad**: Simple misunderstanding that could be resolved with one conversation
40
+
41
+ **Film Reference**: The Notebook (2004) - Class differences, family opposition, and memory loss create layered obstacles.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Both Characters Must Grow
46
+
47
+ **Description**: Romance should transform both people. Each must change, compromise, or evolve to make the relationship work.
48
+
49
+ **Why It Matters**: One-sided growth suggests unhealthy relationship. Mutual transformation shows true partnership.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Both characters confront their flaws and grow to meet each other
53
+ - ❌ **Bad**: One character changes everything while the other remains static
54
+
55
+ **Film Reference**: Pride and Prejudice (2005) - Both Elizabeth and Darcy must overcome pride and prejudice to find love.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Earn the Emotional Beats
60
+
61
+ **Description**: Major romantic moments (first kiss, declaration of love, reunion) must be earned through buildup and character development.
62
+
63
+ **Why It Matters**: Unearned moments feel hollow. Emotional payoff requires proper setup and timing.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: First kiss after building tension and connection over multiple scenes
67
+ - ❌ **Bad**: Love confession in first meeting with no foundation
68
+
69
+ **Film Reference**: Before Sunrise (1995) - Every moment of connection earned through hours of conversation and shared experience.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Make the Stakes Personal
74
+
75
+ **Description**: What's at risk must matter deeply to the characters - not just the relationship, but their sense of self, dreams, or values.
76
+
77
+ **Why It Matters**: Higher personal stakes create deeper emotional investment. Love should challenge who they are.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Choosing love means sacrificing career, confronting past trauma, or changing life direction
81
+ - ❌ **Bad**: Only stake is whether they date or not, with no deeper implications
82
+
83
+ **Film Reference**: La La Land (2016) - Love vs. artistic ambition - both must choose between relationship and dreams.
84
+
85
+ ---
86
+
87
+ ## Guidelines
88
+
89
+ ### Structure
90
+
91
+ - **Act I**: Meet-cute or introduction, initial attraction (or antagonism), first obstacle appears
92
+ - **Act II**: Relationship develops, deeper connection forms, major obstacles threaten relationship, possible breakup or separation
93
+ - **Act III**: Grand gesture or realization, final obstacle overcome (or tragic separation), resolution - together or apart
94
+
95
+ ### Pacing
96
+
97
+ - Build attraction gradually (unless "love at first sight" is the premise)
98
+ - Alternate between moments of connection and conflict
99
+ - Use setbacks to test and deepen the relationship
100
+ - Accelerate toward emotional climax
101
+ - Allow denouement for emotional resolution
102
+
103
+ ### Character Archetypes
104
+
105
+ - **Protagonists**: Often opposites (cynic/optimist, rich/poor, career-focused/free-spirit) who complement each other
106
+ - **Antagonist**: Can be rival suitor, disapproving family, or internal fears/past trauma
107
+ - **Supporting**: Best friend confidant, wise mentor, comic relief sidekick
108
+
109
+ ### Tone and Atmosphere
110
+
111
+ - Can range from light rom-com to tragic romance
112
+ - Emotional vulnerability and intimacy
113
+ - Hope and longing
114
+ - Humor often balances emotional intensity
115
+ - Warmth and connection
116
+
117
+ ### Visual Style
118
+
119
+ - Intimate framing for emotional moments
120
+ - Soft lighting for romantic scenes
121
+ - Use of meaningful locations that reflect relationship
122
+ - Color palette that supports tone (warm for hopeful, cool for melancholy)
123
+ - Close-ups to capture emotional nuance
124
+
125
+ ### Dialogue
126
+
127
+ - Subtext - what's unsaid is as important as what's said
128
+ - Witty banter or deep conversation depending on tone
129
+ - Vulnerability in key moments
130
+ - Avoid overly flowery declarations unless earned
131
+ - Natural, character-specific speech patterns
132
+
133
+ ## Common Pitfalls
134
+
135
+ ### Pitfall 1: Contrived Misunderstandings
136
+
137
+ **Problem**: Keeping couple apart through simple miscommunication that could be resolved instantly.
138
+
139
+ **Solution**: Create obstacles rooted in genuine character flaws, values conflicts, or external circumstances.
140
+
141
+ **Example**: Eternal Sunshine of the Spotless Mind - Relationship fails due to real incompatibilities, not simple misunderstandings.
142
+
143
+ ---
144
+
145
+ ### Pitfall 2: Toxic Relationships Romanticized
146
+
147
+ **Problem**: Portraying controlling, manipulative, or abusive behavior as romantic or passionate.
148
+
149
+ **Solution**: Show healthy conflict resolution, respect, and mutual growth. Passion doesn't require toxicity.
150
+
151
+ **Example**: Crazy, Stupid, Love - Characters learn healthy relationship patterns and self-respect.
152
+
153
+ ---
154
+
155
+ ### Pitfall 3: No Conflict or Stakes
156
+
157
+ **Problem**: Couple is perfect for each other with no real obstacles, making the story boring.
158
+
159
+ **Solution**: Create meaningful internal or external conflicts that genuinely test the relationship.
160
+
161
+ **Example**: The Big Sick (2017) - Cultural differences, family expectations, and life-threatening illness create real stakes.
162
+
163
+ ---
164
+
165
+ ## Film Examples
166
+
167
+ ### Example 1: Casablanca (1942)
168
+
169
+ **Director**: Michael Curtiz
170
+
171
+ **Why It Works**: Timeless romance with impossible choices, sacrifice, and bittersweet ending. Love vs. duty.
172
+
173
+ **Key Scenes**:
174
+ - **"Of all the gin joints"**: Reunion after years, unresolved feelings
175
+ - **Flashback to Paris**: Showing the depth of their past love
176
+ - **Airport Farewell**: Sacrifice for greater good - "We'll always have Paris"
177
+
178
+ **Techniques Used**:
179
+ - Wartime setting raises stakes
180
+ - Love triangle with moral complexity
181
+ - Sacrifice as ultimate expression of love
182
+ - Dialogue that's become iconic
183
+
184
+ ---
185
+
186
+ ### Example 2: Eternal Sunshine of the Spotless Mind (2004)
187
+
188
+ **Director**: Michel Gondry
189
+
190
+ **Why It Works**: Innovative structure exploring why relationships fail and whether love is worth the pain.
191
+
192
+ **Key Scenes**:
193
+ - **Memory Erasure**: Desperate attempt to forget painful relationship
194
+ - **Montage of Relationship**: Showing both joy and deterioration
195
+ - **"Meet me in Montauk"**: Choosing to try again despite knowing they'll fail
196
+
197
+ **Techniques Used**:
198
+ - Non-linear narrative reflecting memory
199
+ - Sci-fi premise exploring emotional truth
200
+ - Shows relationship's full arc - beginning, middle, and end
201
+ - Bittersweet acceptance of love's imperfection
202
+
203
+ ---
204
+
205
+ ### Example 3: Before Sunrise (1995)
206
+
207
+ **Director**: Richard Linklater
208
+
209
+ **Why It Works**: Entire romance in one night through conversation. Chemistry and connection over plot.
210
+
211
+ **Key Scenes**:
212
+ - **Train Meeting**: Spontaneous decision to spend night together
213
+ - **Listening Booth**: Intimate moment without words
214
+ - **Sunrise Separation**: Bittersweet parting with uncertain future
215
+
216
+ **Techniques Used**:
217
+ - Real-time pacing creates intimacy
218
+ - Dialogue-driven character development
219
+ - Minimal plot - focus on connection
220
+ - Ambiguous ending (resolved in sequels)
221
+
222
+ ---
223
+
224
+ ### Example 4: The Shape of Water (2017)
225
+
226
+ **Director**: Guillermo del Toro
227
+
228
+ **Why It Works**: Unconventional romance between woman and creature. Love transcends boundaries.
229
+
230
+ **Key Scenes**:
231
+ - **First Connection**: Communication beyond words
232
+ - **Musical Fantasy**: Expression of romantic longing
233
+ - **Rescue and Transformation**: Love as salvation
234
+
235
+ **Techniques Used**:
236
+ - Fairy tale structure in realistic setting
237
+ - Outsiders finding connection
238
+ - Visual storytelling over dialogue
239
+ - Fantasy as metaphor for acceptance
240
+
241
+ ---
242
+
243
+ ## Integration with Other Features
244
+
245
+ ### Compatible Themes
246
+
247
+ - **Love vs. Duty**: Choosing between heart and obligation
248
+ - **Self-Discovery**: Finding yourself through relationship
249
+ - **Sacrifice**: What you'll give up for love
250
+ - **Second Chances**: Redemption through love
251
+ - **Class/Cultural Barriers**: Love across divides
252
+
253
+ ### Compatible Styles
254
+
255
+ - **Romantic Comedy**: Light, humorous approach to love (rom-com)
256
+ - **Romantic Drama**: Serious, often tragic exploration of love
257
+ - **Period Romance**: Historical settings and social constraints
258
+ - **Contemporary Romance**: Modern dating and relationships
259
+
260
+ ### Hybrid Combinations
261
+
262
+ - **Romance + Comedy**: Rom-com (When Harry Met Sally, The Proposal)
263
+ - **Romance + Drama**: Serious relationship exploration (Blue Valentine, Revolutionary Road)
264
+ - **Romance + Fantasy**: Magical or supernatural love (The Shape of Water, Ghost)
265
+ - **Romance + Sci-Fi**: Love across time/space (About Time, Her)
266
+
267
+ ## Best Practices
268
+
269
+ 1. **Chemistry is Everything**: Cast and write for genuine connection
270
+ 2. **Show, Don't Tell**: Demonstrate love through actions, not just words
271
+ 3. **Create Real Obstacles**: Meaningful conflicts, not contrivances
272
+ 4. **Both Must Grow**: Mutual transformation, not one-sided change
273
+ 5. **Earn Emotional Moments**: Build to big beats through character work
274
+ 6. **Avoid Clichés**: Fresh takes on familiar tropes
275
+ 7. **Respect the Audience**: Trust them to feel emotions without manipulation
276
+ 8. **Make It Specific**: Unique details make romance memorable
277
+ 9. **Balance Hope and Realism**: Romantic but grounded in truth
278
+ 10. **The Ending Matters**: Whether together or apart, make it earned and satisfying
279
+
280
+ ## Resources
281
+
282
+ - "Romancing the Beat" by Gwen Hayes - Romance story structure
283
+ - "The Notebook" screenplay by Jeremy Leven - Epic romance structure
284
+ - "When Harry Met Sally" screenplay by Nora Ephron - Rom-com masterclass
285
+ - "Pride and Prejudice" by Jane Austen - Classic romance structure
286
+ - "Save the Cat! Writes a Novel" by Jessica Brody - Includes romance beats
287
+
288
+ ---
289
+
290
+ **Depth Coverage**: 85%
291
+ **Last Updated**: 2026-01-31
292
+ **Version**: 1.0.0
293
+