@mytechtoday/augment-extensions 0.2.0 → 0.5.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 (420) hide show
  1. package/README.md +614 -39
  2. package/augment-extensions/coding-standards/bash/README.md +196 -0
  3. package/augment-extensions/coding-standards/bash/module.json +163 -0
  4. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -0
  5. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -0
  6. package/augment-extensions/coding-standards/css/README.md +40 -0
  7. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -0
  8. package/augment-extensions/coding-standards/css/module.json +44 -0
  9. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -0
  10. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -0
  11. package/augment-extensions/coding-standards/html/README.md +40 -0
  12. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -0
  13. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -0
  14. package/augment-extensions/coding-standards/html/module.json +44 -0
  15. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -0
  16. package/augment-extensions/coding-standards/html-css-js/README.md +194 -0
  17. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -0
  18. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -0
  19. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -0
  20. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -0
  21. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -0
  22. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -0
  23. package/augment-extensions/coding-standards/html-css-js/module.json +48 -0
  24. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -0
  25. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -0
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -0
  27. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -0
  28. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -0
  29. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -0
  30. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -0
  31. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -0
  32. package/augment-extensions/coding-standards/js/README.md +46 -0
  33. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -0
  34. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -0
  35. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -0
  36. package/augment-extensions/coding-standards/js/module.json +49 -0
  37. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -0
  38. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -0
  39. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -0
  40. package/augment-extensions/coding-standards/js/rules/performance.md +463 -0
  41. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -0
  42. package/augment-extensions/coding-standards/php/README.md +248 -0
  43. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -0
  44. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -0
  45. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -0
  46. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -0
  47. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -0
  48. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -0
  49. package/augment-extensions/coding-standards/php/module.json +166 -0
  50. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -0
  51. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -0
  52. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -0
  53. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -0
  54. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -0
  55. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -0
  56. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -0
  57. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -0
  58. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -0
  59. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -0
  60. package/augment-extensions/coding-standards/php/rules/performance.md +392 -0
  61. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -0
  62. package/augment-extensions/coding-standards/php/rules/security.md +358 -0
  63. package/augment-extensions/coding-standards/php/rules/testing.md +403 -0
  64. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -0
  65. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -0
  66. package/augment-extensions/coding-standards/powershell/README.md +154 -0
  67. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -0
  68. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -0
  69. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -0
  70. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -0
  71. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -0
  72. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -0
  73. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -0
  74. package/augment-extensions/coding-standards/powershell/module.json +165 -0
  75. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -0
  76. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -0
  77. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -0
  78. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -0
  79. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -0
  80. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -0
  81. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -0
  82. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -0
  83. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -0
  84. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -0
  85. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -0
  86. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -0
  87. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -0
  88. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -0
  89. package/augment-extensions/coding-standards/python/README.md +12 -8
  90. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -0
  91. package/augment-extensions/coding-standards/python/module.json +8 -4
  92. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -0
  93. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -0
  94. package/augment-extensions/coding-standards/python/rules/error-handling.md +855 -68
  95. package/augment-extensions/coding-standards/python/rules/testing.md +409 -0
  96. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -0
  97. package/augment-extensions/coding-standards/python/rules/type-hints.md +115 -50
  98. package/augment-extensions/collections/html-css-js/README.md +82 -0
  99. package/augment-extensions/collections/html-css-js/collection.json +41 -0
  100. package/augment-extensions/domain-rules/database/README.md +161 -0
  101. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -0
  102. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -0
  103. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -0
  104. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -0
  105. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -0
  106. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -0
  107. package/augment-extensions/domain-rules/database/module.json +28 -0
  108. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -0
  109. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -0
  110. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -0
  111. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -0
  112. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -0
  113. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -0
  114. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -0
  115. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -0
  116. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -0
  117. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -0
  118. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -0
  119. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -0
  120. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -0
  121. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -0
  122. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -0
  123. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -0
  124. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -0
  125. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -0
  126. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -0
  127. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -0
  128. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -0
  129. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -0
  130. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -0
  131. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -0
  132. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -0
  133. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -0
  134. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -0
  135. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -0
  136. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -0
  137. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -0
  138. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -0
  139. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -0
  140. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -0
  141. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -0
  142. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -0
  143. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -0
  144. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -0
  145. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -0
  146. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -0
  147. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -0
  148. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -0
  149. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -0
  150. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/README.md +136 -0
  151. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/SCHEMA-VALIDATION-REPORT.md +216 -0
  152. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/brand-kit-example.yaml +292 -0
  153. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/campaign-brief-example.yaml +389 -0
  154. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/content-calendar-example.yaml +643 -0
  155. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/email-newsletter-example.md +376 -0
  156. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/landing-page-example.md +934 -0
  157. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/ppc-ad-copy-example.md +301 -0
  158. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/seo-blog-post-example.md +347 -0
  159. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/social-media-campaign-example.md +606 -0
  160. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/module.json +50 -0
  161. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/affiliate-influencer-marketing.md +593 -0
  162. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/asset-management.md +418 -0
  163. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/brand-consistency.md +210 -0
  164. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/content-marketing.md +337 -0
  165. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/conversion-optimization.md +455 -0
  166. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/direct-sales.md +499 -0
  167. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/email-marketing.md +439 -0
  168. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/legal-compliance.md +227 -0
  169. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/ppc-advertising.md +569 -0
  170. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/seo-optimization.md +470 -0
  171. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/social-media-marketing.md +414 -0
  172. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/universal-marketing.md +177 -0
  173. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/asset-inventory.schema.json +247 -0
  174. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/brand-kit.schema.json +326 -0
  175. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/campaign-brief.schema.json +342 -0
  176. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/color-palette.schema.json +223 -0
  177. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/content-template.schema.json +383 -0
  178. package/augment-extensions/domain-rules/mcp/README.md +150 -0
  179. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -0
  180. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -0
  181. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -0
  182. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -0
  183. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -0
  184. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -0
  185. package/augment-extensions/domain-rules/mcp/module.json +49 -0
  186. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -0
  187. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -0
  188. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -0
  189. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -0
  190. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -0
  191. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -0
  192. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -0
  193. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -0
  194. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -0
  195. package/augment-extensions/workflows/beads/module.json +4 -3
  196. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -0
  197. package/augment-extensions/workflows/beads-integration/README.md +143 -0
  198. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -0
  199. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -0
  200. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -0
  201. package/augment-extensions/workflows/beads-integration/module.json +75 -0
  202. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -0
  203. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -0
  204. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -0
  205. package/augment-extensions/workflows/database/README.md +195 -0
  206. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -0
  207. package/augment-extensions/workflows/database/examples/migration-example.md +498 -0
  208. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -0
  209. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -0
  210. package/augment-extensions/workflows/database/module.json +42 -0
  211. package/augment-extensions/workflows/database/rules/data-migration.md +249 -0
  212. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -0
  213. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -0
  214. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -0
  215. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -0
  216. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -0
  217. package/augment-extensions/workflows/database/rules/workflow.md +458 -0
  218. package/augment-extensions/workflows/openspec/module.json +4 -3
  219. package/augment-extensions/writing-standards/screenplay/README.md +300 -0
  220. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -0
  221. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -0
  222. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -0
  223. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -0
  224. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -0
  225. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -0
  226. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -0
  227. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -0
  228. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -0
  229. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -0
  230. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -0
  231. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -0
  232. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -0
  233. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -0
  234. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -0
  235. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -0
  236. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -0
  237. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -0
  238. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -0
  239. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -0
  240. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -0
  241. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -0
  242. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -0
  243. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -0
  244. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -0
  245. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -0
  246. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -0
  247. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -0
  248. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -0
  249. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -0
  250. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -0
  251. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -0
  252. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -0
  253. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -0
  254. package/augment-extensions/writing-standards/screenplay/module.json +124 -0
  255. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -0
  256. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -0
  257. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -0
  258. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -0
  259. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -0
  260. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -0
  261. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -0
  262. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -0
  263. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -0
  264. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -0
  265. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -0
  266. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -0
  267. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -0
  268. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -0
  269. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -0
  270. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -0
  271. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -0
  272. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -0
  273. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -0
  274. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -0
  275. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -0
  276. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -0
  277. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -0
  278. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -0
  279. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -0
  280. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -0
  281. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -0
  282. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -0
  283. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -0
  284. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -0
  285. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -0
  286. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -0
  287. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -0
  288. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -0
  289. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -0
  290. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -0
  291. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -0
  292. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -0
  293. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -0
  294. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -0
  295. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -0
  296. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -0
  297. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -0
  298. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -0
  299. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -0
  300. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -0
  301. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -0
  302. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -0
  303. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -0
  304. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -0
  305. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -0
  306. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -0
  307. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -0
  308. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -0
  309. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -0
  310. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -0
  311. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -0
  312. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -0
  313. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -0
  314. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -0
  315. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -0
  316. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -0
  317. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -0
  318. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -0
  319. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -0
  320. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -0
  321. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -0
  322. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -0
  323. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -0
  324. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -0
  325. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -0
  326. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -0
  327. package/cli/MODULES.md +302 -0
  328. package/cli/dist/cli.js +168 -10
  329. package/cli/dist/cli.js.map +1 -1
  330. package/cli/dist/commands/catalog.d.ts +13 -0
  331. package/cli/dist/commands/catalog.d.ts.map +1 -0
  332. package/cli/dist/commands/catalog.js +104 -0
  333. package/cli/dist/commands/catalog.js.map +1 -0
  334. package/cli/dist/commands/gui.d.ts +6 -0
  335. package/cli/dist/commands/gui.d.ts.map +1 -0
  336. package/cli/dist/commands/gui.js +211 -0
  337. package/cli/dist/commands/gui.js.map +1 -0
  338. package/cli/dist/commands/init.d.ts.map +1 -1
  339. package/cli/dist/commands/init.js +12 -0
  340. package/cli/dist/commands/init.js.map +1 -1
  341. package/cli/dist/commands/install-rules.d.ts +14 -0
  342. package/cli/dist/commands/install-rules.d.ts.map +1 -0
  343. package/cli/dist/commands/install-rules.js +127 -0
  344. package/cli/dist/commands/install-rules.js.map +1 -0
  345. package/cli/dist/commands/link.d.ts.map +1 -1
  346. package/cli/dist/commands/link.js +9 -11
  347. package/cli/dist/commands/link.js.map +1 -1
  348. package/cli/dist/commands/list.d.ts.map +1 -1
  349. package/cli/dist/commands/list.js +11 -28
  350. package/cli/dist/commands/list.js.map +1 -1
  351. package/cli/dist/commands/mcp.d.ts +48 -0
  352. package/cli/dist/commands/mcp.d.ts.map +1 -0
  353. package/cli/dist/commands/mcp.js +229 -0
  354. package/cli/dist/commands/mcp.js.map +1 -0
  355. package/cli/dist/commands/self-remove.d.ts +7 -0
  356. package/cli/dist/commands/self-remove.d.ts.map +1 -0
  357. package/cli/dist/commands/self-remove.js +179 -0
  358. package/cli/dist/commands/self-remove.js.map +1 -0
  359. package/cli/dist/commands/show.d.ts +19 -0
  360. package/cli/dist/commands/show.d.ts.map +1 -1
  361. package/cli/dist/commands/show.js +478 -63
  362. package/cli/dist/commands/show.js.map +1 -1
  363. package/cli/dist/commands/skill.d.ts +67 -0
  364. package/cli/dist/commands/skill.d.ts.map +1 -0
  365. package/cli/dist/commands/skill.js +513 -0
  366. package/cli/dist/commands/skill.js.map +1 -0
  367. package/cli/dist/commands/unlink.d.ts +6 -0
  368. package/cli/dist/commands/unlink.d.ts.map +1 -0
  369. package/cli/dist/commands/unlink.js +115 -0
  370. package/cli/dist/commands/unlink.js.map +1 -0
  371. package/cli/dist/commands/validate.d.ts +6 -0
  372. package/cli/dist/commands/validate.d.ts.map +1 -0
  373. package/cli/dist/commands/validate.js +159 -0
  374. package/cli/dist/commands/validate.js.map +1 -0
  375. package/cli/dist/types/gui.d.ts +62 -0
  376. package/cli/dist/types/gui.d.ts.map +1 -0
  377. package/cli/dist/types/gui.js +30 -0
  378. package/cli/dist/types/gui.js.map +1 -0
  379. package/cli/dist/utils/catalog-sync.d.ts +22 -0
  380. package/cli/dist/utils/catalog-sync.d.ts.map +1 -0
  381. package/cli/dist/utils/catalog-sync.js +157 -0
  382. package/cli/dist/utils/catalog-sync.js.map +1 -0
  383. package/cli/dist/utils/character-count.d.ts +56 -0
  384. package/cli/dist/utils/character-count.d.ts.map +1 -0
  385. package/cli/dist/utils/character-count.js +190 -0
  386. package/cli/dist/utils/character-count.js.map +1 -0
  387. package/cli/dist/utils/documentation-validator.d.ts +18 -0
  388. package/cli/dist/utils/documentation-validator.d.ts.map +1 -0
  389. package/cli/dist/utils/documentation-validator.js +233 -0
  390. package/cli/dist/utils/documentation-validator.js.map +1 -0
  391. package/cli/dist/utils/gui-helpers.d.ts +23 -0
  392. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  393. package/cli/dist/utils/gui-helpers.js +159 -0
  394. package/cli/dist/utils/gui-helpers.js.map +1 -0
  395. package/cli/dist/utils/install-rules.d.ts +32 -0
  396. package/cli/dist/utils/install-rules.d.ts.map +1 -0
  397. package/cli/dist/utils/install-rules.js +375 -0
  398. package/cli/dist/utils/install-rules.js.map +1 -0
  399. package/cli/dist/utils/mcp-integration.d.ts +70 -0
  400. package/cli/dist/utils/mcp-integration.d.ts.map +1 -0
  401. package/cli/dist/utils/mcp-integration.js +292 -0
  402. package/cli/dist/utils/mcp-integration.js.map +1 -0
  403. package/cli/dist/utils/module-system.d.ts +232 -0
  404. package/cli/dist/utils/module-system.d.ts.map +1 -0
  405. package/cli/dist/utils/module-system.js +900 -0
  406. package/cli/dist/utils/module-system.js.map +1 -0
  407. package/cli/dist/utils/modules-catalog.d.ts +33 -0
  408. package/cli/dist/utils/modules-catalog.d.ts.map +1 -0
  409. package/cli/dist/utils/modules-catalog.js +163 -0
  410. package/cli/dist/utils/modules-catalog.js.map +1 -0
  411. package/cli/dist/utils/rule-install-hooks.d.ts +19 -0
  412. package/cli/dist/utils/rule-install-hooks.d.ts.map +1 -0
  413. package/cli/dist/utils/rule-install-hooks.js +224 -0
  414. package/cli/dist/utils/rule-install-hooks.js.map +1 -0
  415. package/cli/dist/utils/skill-system.d.ts +95 -0
  416. package/cli/dist/utils/skill-system.d.ts.map +1 -0
  417. package/cli/dist/utils/skill-system.js +313 -0
  418. package/cli/dist/utils/skill-system.js.map +1 -0
  419. package/modules.md +559 -105
  420. package/package.json +17 -6
@@ -0,0 +1,399 @@
1
+ # Action Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: Medium
6
+
7
+ ## Overview
8
+
9
+ Action films prioritize physical feats, chase sequences, fights, and spectacular set pieces. The genre emphasizes visual storytelling, kinetic energy, and escalating stakes through physical conflict and danger.
10
+
11
+ ## Core Concept
12
+
13
+ Action screenplays are built around a protagonist who must overcome physical obstacles and adversaries through skill, determination, and resourcefulness. The genre thrives on momentum, clear objectives, and visceral excitement. Success depends on balancing spectacular action sequences with character development and emotional stakes.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Establish Clear Physical Stakes
18
+
19
+ **Description**: Every action sequence must have clear, tangible stakes that the audience can understand and care about.
20
+
21
+ **Why It Matters**: Without clear stakes, action becomes empty spectacle. The audience needs to know what's at risk and why it matters.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: "If the hero doesn't defuse the bomb in 10 minutes, the stadium full of people will explode"
25
+ - ❌ **Bad**: "The hero fights random henchmen for unclear reasons"
26
+
27
+ **Film Reference**: Die Hard (1988) - John McClane must save hostages including his wife, with a clear ticking clock and escalating danger.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Escalate Action Throughout
32
+
33
+ **Description**: Each action sequence should be more intense, complex, or dangerous than the last.
34
+
35
+ **Why It Matters**: Escalation maintains audience engagement and builds toward a climactic finale. Flat or declining action energy kills momentum.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: Fistfight → Car chase → Building explosion → Helicopter battle
39
+ - ❌ **Bad**: Massive explosion in Act I, then smaller fights in Act II
40
+
41
+ **Film Reference**: Mad Max: Fury Road (2015) - Action escalates from desert chase to canyon battle to final war rig confrontation.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Root Action in Character
46
+
47
+ **Description**: Action sequences should reveal character, advance relationships, or force character growth.
48
+
49
+ **Why It Matters**: Action without character development is forgettable. The best action scenes change the protagonist or their relationships.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: During a fight, the hero chooses to save an enemy, revealing their moral code
53
+ - ❌ **Bad**: Generic fight scene that could be removed without affecting the story
54
+
55
+ **Film Reference**: The Raid (2011) - Rama's fighting style and choices reveal his honor code and relationship with his brother.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Maintain Spatial Clarity
60
+
61
+ **Description**: The audience must always understand the geography of action sequences - where characters are, what they're trying to reach, and what obstacles stand in their way.
62
+
63
+ **Why It Matters**: Confused audiences disengage. Clear spatial relationships create tension and allow audiences to anticipate danger.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: "The hero is on the third floor. The exit is on the ground floor. Guards block the stairwell."
67
+ - ❌ **Bad**: "The hero runs through various rooms fighting people in unclear locations"
68
+
69
+ **Film Reference**: Mission: Impossible - Fallout (2018) - The bathroom fight maintains perfect spatial clarity throughout.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Use Action to Advance Plot
74
+
75
+ **Description**: Every major action sequence should move the story forward, reveal new information, or change the situation.
76
+
77
+ **Why It Matters**: Action for action's sake pads runtime without purpose. Purposeful action keeps the story moving.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: During a chase, the hero discovers the villain's hideout location
81
+ - ❌ **Bad**: A 10-minute fight that ends exactly where it started with no new information
82
+
83
+ **Film Reference**: The Bourne Identity (2002) - Every action sequence reveals more about Bourne's past or advances his investigation.
84
+
85
+ ---
86
+
87
+ ### Rule 6: Establish Hero's Competence Early
88
+
89
+ **Description**: Show the protagonist's physical skills and resourcefulness in Act I, before the main conflict begins.
90
+
91
+ **Why It Matters**: The audience needs to believe the hero can handle the challenges ahead. Early competence builds credibility.
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Opening sequence shows hero's military training, quick thinking, or combat skills
95
+ - ❌ **Bad**: Hero suddenly becomes skilled fighter in Act II with no setup
96
+
97
+ **Film Reference**: John Wick (2014) - Opening scenes establish John's legendary status and skills before the main conflict.
98
+
99
+ ---
100
+
101
+ ### Rule 7: Create Obstacles, Not Just Opponents
102
+
103
+ **Description**: Action sequences should feature environmental challenges, time pressure, and physical obstacles beyond just fighting enemies.
104
+
105
+ **Why It Matters**: Varied obstacles create more interesting and unpredictable action. Pure combat becomes repetitive.
106
+
107
+ **Examples**:
108
+ - ✅ **Good**: Hero must fight while building collapses, fire spreads, and timer counts down
109
+ - ❌ **Bad**: Hero fights identical groups of henchmen in similar locations
110
+
111
+ **Film Reference**: Speed (1994) - The bus itself is the primary obstacle, with human antagonists as secondary threats.
112
+
113
+ ---
114
+
115
+ ### Rule 8: Balance Action with Breathing Room
116
+
117
+ **Description**: Follow intense action sequences with quieter moments for character development, humor, or emotional processing.
118
+
119
+ **Why It Matters**: Constant action creates fatigue and diminishing returns. Contrast makes action more impactful.
120
+
121
+ **Examples**:
122
+ - ✅ **Good**: Major action sequence → quiet character moment → build tension → next action sequence
123
+ - ❌ **Bad**: 90 minutes of non-stop action with no character moments
124
+
125
+ **Film Reference**: Terminator 2 (1991) - Balances massive action set pieces with intimate character scenes between Sarah, John, and the T-800.
126
+
127
+ ---
128
+
129
+ ### Rule 9: Make Action Visual, Not Verbal
130
+
131
+ **Description**: Show action through visual description, not dialogue explanation. Minimize talking during action sequences.
132
+
133
+ **Why It Matters**: Action is a visual medium. Excessive dialogue during action kills momentum and feels unnatural.
134
+
135
+ **Examples**:
136
+ - ✅ **Good**: "Sarah LEAPS from the roof, CRASHES through the skylight, ROLLS to her feet"
137
+ - ❌ **Bad**: Characters explain their actions while fighting: "I'm going to punch you now!"
138
+
139
+ **Film Reference**: Mad Max: Fury Road (2015) - Minimal dialogue, maximum visual storytelling.
140
+
141
+ ---
142
+
143
+ ### Rule 10: Establish Rules and Limitations
144
+
145
+ **Description**: Define what the hero can and cannot do physically. Establish the rules of the world's action early.
146
+
147
+ **Why It Matters**: Limitations create tension. If the hero can do anything, there's no suspense. Consistent rules maintain believability.
148
+
149
+ **Examples**:
150
+ - ✅ **Good**: Hero is skilled but can be injured, has limited ammunition, or faces superior numbers
151
+ - ❌ **Bad**: Hero's abilities change based on plot convenience
152
+
153
+ **Film Reference**: Die Hard (1988) - John McClane is tough but vulnerable, bleeds, runs out of bullets, and makes mistakes.
154
+
155
+ ---
156
+
157
+ ## Guidelines
158
+
159
+ ### Structure
160
+
161
+ - **Act I**: Establish hero's skills, introduce the threat, inciting incident triggers main conflict (pages 1-25)
162
+ - **Act II**: Escalating action sequences, hero faces setbacks, stakes increase, all seems lost moment (pages 25-85)
163
+ - **Act III**: Final confrontation, maximum stakes, hero uses everything learned, resolution (pages 85-110)
164
+
165
+ ### Pacing
166
+
167
+ - Open with action or establish action potential within first 10 pages
168
+ - Major action sequence every 15-20 pages
169
+ - Build tension between action sequences
170
+ - Climax should be the longest and most intense action sequence
171
+ - Keep individual action sequences to 3-7 pages in script (3-7 minutes screen time)
172
+
173
+ ### Character Archetypes
174
+
175
+ - **Protagonist**: Skilled, resourceful, morally clear, physically capable, often reluctant hero
176
+ - **Antagonist**: Formidable physical threat, clear opposing goal, often mirror of hero's skills
177
+ - **Supporting**: Sidekick/partner, mentor figure, person to protect, comic relief, tech support
178
+
179
+ ### Tone and Atmosphere
180
+
181
+ - High energy and forward momentum
182
+ - Clear moral stakes (good vs. evil, right vs. wrong)
183
+ - Optimistic despite danger (hero can win)
184
+ - Visceral and immediate
185
+ - Often includes humor to release tension
186
+
187
+ ### Visual Style
188
+
189
+ - Dynamic camera movement during action
190
+ - Clear shot composition (audience can follow the action)
191
+ - Practical effects when possible for authenticity
192
+ - Spectacular locations and set pieces
193
+ - Strong use of color and lighting to guide the eye
194
+
195
+ ### Dialogue
196
+
197
+ - Economical and purposeful
198
+ - Quips and one-liners during action (if appropriate to tone)
199
+ - Minimal exposition during action sequences
200
+ - Strong, declarative statements
201
+ - Subtext through action, not words
202
+
203
+ ## Common Pitfalls
204
+
205
+ ### Pitfall 1: Incomprehensible Action
206
+
207
+ **Problem**: Overly complex choreography or unclear spatial relationships make action impossible to follow on the page.
208
+
209
+ **Solution**: Write action in clear, short sentences. Establish geography first. Use white space. Break complex sequences into beats.
210
+
211
+ **Example**: Instead of "They fight through the building," write "INT. STAIRWELL - John BLOCKS a punch. COUNTERS with an elbow. Shoves the guard DOWN the stairs."
212
+
213
+ ---
214
+
215
+ ### Pitfall 2: Consequence-Free Action
216
+
217
+ **Problem**: Hero emerges from every action sequence unscathed, making future danger feel meaningless.
218
+
219
+ **Solution**: Show cumulative damage. Hero gets tired, injured, runs low on resources. Victories come at a cost.
220
+
221
+ **Example**: After each fight, John's limp worsens, his face shows more bruises, he's visibly exhausted.
222
+
223
+ ---
224
+
225
+ ### Pitfall 3: Unmotivated Action
226
+
227
+ **Problem**: Action sequences occur because "it's time for an action scene," not because the story demands it.
228
+
229
+ **Solution**: Every action sequence should be triggered by character choices or plot developments. Ask "why now?" for each sequence.
230
+
231
+ **Example**: Hero doesn't randomly encounter enemies; they're discovered because of a choice the hero made.
232
+
233
+ ---
234
+
235
+ ### Pitfall 4: Identical Set Pieces
236
+
237
+ **Problem**: Every action sequence feels the same - same location type, same fighting style, same resolution.
238
+
239
+ **Solution**: Vary locations, obstacles, stakes, and action types. Mix hand-to-hand combat, chases, shootouts, escapes, etc.
240
+
241
+ **Example**: Warehouse fight → car chase → stealth infiltration → rooftop showdown - each feels distinct.
242
+
243
+ ---
244
+
245
+ ### Pitfall 5: Neglecting Emotional Stakes
246
+
247
+ **Problem**: Focusing solely on physical danger without emotional investment in the outcome.
248
+
249
+ **Solution**: Connect action to relationships, values, or personal stakes. Make the audience care about more than just survival.
250
+
251
+ **Example**: Hero fights not just to survive, but to save their child, prove their worth, or protect their home.
252
+
253
+ ---
254
+
255
+ ## Film Examples
256
+
257
+ ### Example 1: Die Hard (1988)
258
+
259
+ **Director**: John McTiernan
260
+
261
+ **Why It Works**: Perfect balance of character, humor, and escalating action. John McClane is vulnerable, relatable, and resourceful.
262
+
263
+ **Key Scenes**:
264
+ - **Nakatomi Plaza Takeover**: Establishes stakes, geography, and McClane's isolation
265
+ - **Rooftop Explosion**: Escalates danger, shows McClane's resourcefulness and vulnerability
266
+ - **Final Confrontation**: Emotional and physical stakes converge
267
+
268
+ **Techniques Used**:
269
+ - Confined setting creates clear spatial relationships
270
+ - Radio communication maintains character connection during action
271
+ - Cumulative damage makes hero increasingly vulnerable
272
+ - Humor releases tension without undercutting stakes
273
+
274
+ ---
275
+
276
+ ### Example 2: Mad Max: Fury Road (2015)
277
+
278
+ **Director**: George Miller
279
+
280
+ **Why It Works**: Visual storytelling masterclass. Minimal dialogue, maximum action, clear character arcs through action.
281
+
282
+ **Key Scenes**:
283
+ - **Initial Chase**: Establishes world, characters, and stakes through pure action
284
+ - **Sandstorm Sequence**: Environmental obstacles create unique action challenges
285
+ - **Final War Rig Battle**: Culmination of character arcs through action choices
286
+
287
+ **Techniques Used**:
288
+ - Continuous forward momentum (literal and narrative)
289
+ - Action reveals character (Furiosa's determination, Max's evolution)
290
+ - Practical effects create visceral reality
291
+ - Color and visual design guide the eye through chaos
292
+
293
+ ---
294
+
295
+ ### Example 3: The Raid (2011)
296
+
297
+ **Director**: Gareth Evans
298
+
299
+ **Why It Works**: Innovative choreography, clear spatial progression (floor by floor), escalating difficulty.
300
+
301
+ **Key Scenes**:
302
+ - **Hallway Fight**: Introduces Rama's skills and moral code
303
+ - **Mad Dog Fight**: Two-on-one battle showcases escalation and stakes
304
+ - **Final Boss Fight**: Emotional and physical climax
305
+
306
+ **Techniques Used**:
307
+ - Vertical progression creates clear structure
308
+ - Martial arts choreography is readable and impactful
309
+ - Limited ammunition forces creative problem-solving
310
+ - Brother relationship adds emotional stakes to action
311
+
312
+ ---
313
+
314
+ ### Example 4: Mission: Impossible - Fallout (2018)
315
+
316
+ **Director**: Christopher McQuarrie
317
+
318
+ **Why It Works**: Practical stunts, clear stakes, character-driven action choices.
319
+
320
+ **Key Scenes**:
321
+ - **Bathroom Fight**: Brutal, realistic combat with perfect spatial clarity
322
+ - **Paris Chase**: Multiple vehicles, clear geography, escalating danger
323
+ - **Helicopter Finale**: Character choices drive action, emotional stakes peak
324
+
325
+ **Techniques Used**:
326
+ - Practical stunts create authentic danger
327
+ - Ticking clock creates urgency
328
+ - Character relationships affect action choices
329
+ - Clear cause-and-effect throughout
330
+
331
+ ---
332
+
333
+ ### Example 5: John Wick (2014)
334
+
335
+ **Director**: Chad Stahelski
336
+
337
+ **Why It Works**: Stylized action with clear rules, emotional motivation, and escalating stakes.
338
+
339
+ **Key Scenes**:
340
+ - **Home Invasion**: Establishes John's skills and the world's rules
341
+ - **Red Circle Nightclub**: Long-take action showcases choreography
342
+ - **Final Confrontation**: Emotional payoff through action
343
+
344
+ **Techniques Used**:
345
+ - "Gun-fu" style is consistent and readable
346
+ - World-building through action (Continental rules, markers)
347
+ - Emotional motivation (dog) grounds spectacular action
348
+ - Consequence and injury accumulate
349
+
350
+ ---
351
+
352
+ ## Integration with Other Features
353
+
354
+ ### Compatible Themes
355
+
356
+ - **Revenge**: Action driven by personal vendetta (John Wick, Kill Bill)
357
+ - **Redemption**: Hero atones through heroic action (The Equalizer)
358
+ - **Survival**: Physical action as fight for life (The Revenant)
359
+ - **Justice**: Action to right wrongs (The Dark Knight)
360
+
361
+ ### Compatible Styles
362
+
363
+ - **Linear**: Clear cause-and-effect action progression (Die Hard)
364
+ - **Minimalist**: Stripped-down, focused action (The Raid)
365
+ - **Epic**: Large-scale action spectacle (Lord of the Rings battles)
366
+
367
+ ### Hybrid Combinations
368
+
369
+ - **Action-Comedy**: Humor integrated into action (Rush Hour, The Nice Guys)
370
+ - **Action-Thriller**: Suspense and mystery drive action (The Bourne Identity)
371
+ - **Sci-Fi Action**: Futuristic tech and settings (The Matrix, Blade Runner 2049)
372
+
373
+ ## Best Practices
374
+
375
+ 1. **Start with character, not spectacle** - Know who your hero is before designing action
376
+ 2. **Establish geography clearly** - Readers and audiences need to understand space
377
+ 3. **Escalate consistently** - Each sequence should raise the stakes
378
+ 4. **Show consequences** - Injuries, exhaustion, and losses accumulate
379
+ 5. **Vary your action** - Mix combat styles, locations, and obstacles
380
+ 6. **Write for the screen** - Use visual, active language; avoid novelistic description
381
+ 7. **Balance action and character** - Use quiet moments to develop relationships and motivation
382
+ 8. **Make action purposeful** - Every sequence should advance plot or character
383
+ 9. **Respect physics** - Even in heightened reality, maintain internal consistency
384
+ 10. **End with emotional resolution** - Physical victory should resolve emotional journey
385
+
386
+ ## Resources
387
+
388
+ - "The Anatomy of Action Scenes" by John Truby
389
+ - "Action Screenwriting" by Chad Gervich
390
+ - "Writing the Action Adventure Film" by Neill D. Hicks
391
+ - "The Action Movie Handbook" by David Bordwell
392
+ - Study: Die Hard, Mad Max: Fury Road, The Raid, Mission: Impossible series, John Wick series
393
+
394
+ ---
395
+
396
+ **Depth Coverage**: 85%
397
+ **Last Updated**: 2026-01-31
398
+ **Version**: 1.0.0
399
+