@mytechtoday/augment-extensions 1.5.2 → 1.6.1

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 (359) hide show
  1. package/AGENTS.md +76 -0
  2. package/README.md +26 -3
  3. package/augment-extensions/writing-standards/literature/shakespeare/ANNOUNCEMENT.md +176 -0
  4. package/augment-extensions/writing-standards/literature/shakespeare/CHARACTER-THEME-VALIDATION-REPORT.md +465 -0
  5. package/augment-extensions/writing-standards/literature/shakespeare/DRAMA-VALIDATION-REPORT.md +217 -0
  6. package/augment-extensions/writing-standards/literature/shakespeare/LANGUAGE-VALIDATION-REPORT.md +195 -0
  7. package/augment-extensions/writing-standards/literature/shakespeare/PHASE6-VALIDATION-REPORT.md +359 -0
  8. package/augment-extensions/writing-standards/literature/shakespeare/README.md +126 -0
  9. package/augment-extensions/writing-standards/literature/shakespeare/examples/annotated-sonnets/sonnet-130.md +225 -0
  10. package/augment-extensions/writing-standards/literature/shakespeare/examples/annotated-sonnets/sonnet-18.md +188 -0
  11. package/augment-extensions/writing-standards/literature/shakespeare/examples/annotated-sonnets/sonnet-73.md +215 -0
  12. package/augment-extensions/writing-standards/literature/shakespeare/examples/exercises/character-worksheet.md +407 -0
  13. package/augment-extensions/writing-standards/literature/shakespeare/examples/exercises/iambic-pentameter-practice.md +470 -0
  14. package/augment-extensions/writing-standards/literature/shakespeare/examples/exercises/sonnet-writing-exercise.md +360 -0
  15. package/augment-extensions/writing-standards/literature/shakespeare/examples/exercises/theme-analysis-template.md +527 -0
  16. package/augment-extensions/writing-standards/literature/shakespeare/examples/exercises/verse-analysis-exercise.md +426 -0
  17. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/hamlet-to-be-or-not-to-be.md +316 -0
  18. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/king-lear-storm-scene.md +576 -0
  19. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/macbeth-tomorrow-and-tomorrow.md +448 -0
  20. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/much-ado-benedick-eavesdropping.md +496 -0
  21. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/romeo-juliet-balcony.md +287 -0
  22. package/augment-extensions/writing-standards/literature/shakespeare/examples/scene-examples/twelfth-night-malvolio-letter.md +653 -0
  23. package/augment-extensions/writing-standards/literature/shakespeare/module.json +72 -0
  24. package/augment-extensions/writing-standards/literature/shakespeare/rules/character-themes/character-development.md +608 -0
  25. package/augment-extensions/writing-standards/literature/shakespeare/rules/character-themes/thematic-elements.md +471 -0
  26. package/augment-extensions/writing-standards/literature/shakespeare/rules/drama/comedy.md +763 -0
  27. package/augment-extensions/writing-standards/literature/shakespeare/rules/drama/history-plays.md +507 -0
  28. package/augment-extensions/writing-standards/literature/shakespeare/rules/drama/scene-construction.md +870 -0
  29. package/augment-extensions/writing-standards/literature/shakespeare/rules/drama/tragedy.md +743 -0
  30. package/augment-extensions/writing-standards/literature/shakespeare/rules/language/elizabethan-english.md +400 -0
  31. package/augment-extensions/writing-standards/literature/shakespeare/rules/language/rhetoric-wordplay.md +602 -0
  32. package/augment-extensions/writing-standards/literature/shakespeare/rules/language/vocabulary-guide.md +662 -0
  33. package/augment-extensions/writing-standards/literature/shakespeare/rules/poetry/iambic-pentameter.md +447 -0
  34. package/augment-extensions/writing-standards/literature/shakespeare/rules/poetry/narrative-poetry.md +453 -0
  35. package/augment-extensions/writing-standards/literature/shakespeare/rules/poetry/sonnets.md +435 -0
  36. package/augment-extensions/writing-standards/literature/shakespeare/rules/poetry/verse-forms.md +565 -0
  37. package/augment-extensions/writing-standards/screenplay/README.md +62 -9
  38. package/augment-extensions/writing-standards/screenplay/cinematic-styles/MIGRATION.md +213 -0
  39. package/augment-extensions/writing-standards/screenplay/cinematic-styles/README.md +309 -0
  40. package/augment-extensions/writing-standards/screenplay/cinematic-styles/REFACTORING-SUMMARY.md +99 -0
  41. package/augment-extensions/writing-standards/screenplay/cinematic-styles/comedy-formats/module.json +33 -0
  42. package/augment-extensions/writing-standards/screenplay/cinematic-styles/comedy-formats/monty-python/module.json +50 -0
  43. package/augment-extensions/writing-standards/screenplay/cinematic-styles/comedy-formats/monty-python/rules/monty-python.md +243 -0
  44. package/augment-extensions/writing-standards/screenplay/cinematic-styles/comedy-formats/saturday-night-live/module.json +50 -0
  45. package/augment-extensions/writing-standards/screenplay/cinematic-styles/comedy-formats/saturday-night-live/rules/saturday-night-live.md +153 -0
  46. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/README.md +127 -0
  47. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/alfred-hitchcock/module.json +50 -0
  48. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/alfred-hitchcock/rules/alfred-hitchcock.md +168 -0
  49. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/ari-aster/module.json +50 -0
  50. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/ari-aster/rules/ari-aster.md +414 -0
  51. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/brad-bird/module.json +50 -0
  52. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/brad-bird/rules/brad-bird.md +362 -0
  53. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/brian-de-palma/module.json +50 -0
  54. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/brian-de-palma/rules/brian-de-palma.md +445 -0
  55. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/buster-keaton/module.json +50 -0
  56. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/buster-keaton/rules/buster-keaton.md +508 -0
  57. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/christopher-nolan/module.json +50 -0
  58. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/christopher-nolan/rules/christopher-nolan.md +147 -0
  59. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/clint-eastwood/module.json +50 -0
  60. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/clint-eastwood/rules/clint-eastwood.md +639 -0
  61. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/coen-brothers/module.json +50 -0
  62. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/coen-brothers/rules/coen-brothers.md +167 -0
  63. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/darren-aronofsky/module.json +50 -0
  64. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/darren-aronofsky/rules/darren-aronofsky.md +474 -0
  65. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/david-fincher/module.json +50 -0
  66. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/david-fincher/rules/david-fincher.md +203 -0
  67. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/david-lynch/module.json +50 -0
  68. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/david-lynch/rules/david-lynch.md +136 -0
  69. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/denis-villeneuve/module.json +50 -0
  70. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/denis-villeneuve/rules/denis-villeneuve.md +131 -0
  71. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/francis-ford-coppola/module.json +50 -0
  72. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/francis-ford-coppola/rules/francis-ford-coppola.md +190 -0
  73. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/gary-marshall/module.json +50 -0
  74. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/gary-marshall/rules/gary-marshall.md +181 -0
  75. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/george-a-romero/module.json +50 -0
  76. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/george-a-romero/rules/george-a-romero.md +391 -0
  77. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/george-lucas/module.json +50 -0
  78. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/george-lucas/rules/george-lucas.md +129 -0
  79. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/guillermo-del-toro/module.json +50 -0
  80. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/guillermo-del-toro/rules/guillermo-del-toro.md +350 -0
  81. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/gus-van-sant/module.json +50 -0
  82. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/gus-van-sant/rules/gus-van-sant.md +353 -0
  83. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/james-ivory-ismail-merchant/module.json +50 -0
  84. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/james-ivory-ismail-merchant/rules/james-ivory-ismail-merchant.md +164 -0
  85. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/jim-jarmusch/module.json +50 -0
  86. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/jim-jarmusch/rules/jim-jarmusch.md +426 -0
  87. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-carpenter/module.json +50 -0
  88. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-carpenter/rules/john-carpenter.md +450 -0
  89. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-ford/module.json +50 -0
  90. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-ford/rules/john-ford.md +429 -0
  91. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-huston/module.json +50 -0
  92. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-huston/rules/john-huston.md +357 -0
  93. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-landis/module.json +50 -0
  94. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/john-landis/rules/john-landis.md +483 -0
  95. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/jonathan-demme/module.json +50 -0
  96. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/jonathan-demme/rules/jonathan-demme.md +394 -0
  97. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/joseph-l-mankiewicz/module.json +50 -0
  98. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/joseph-l-mankiewicz/rules/joseph-l-mankiewicz.md +406 -0
  99. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kathryn-bigelow/module.json +50 -0
  100. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kathryn-bigelow/rules/kathryn-bigelow.md +443 -0
  101. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kelly-reichardt/module.json +50 -0
  102. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kelly-reichardt/rules/kelly-reichardt.md +365 -0
  103. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kevin-smith/module.json +50 -0
  104. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/kevin-smith/rules/kevin-smith.md +546 -0
  105. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/linda-shayne/module.json +50 -0
  106. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/linda-shayne/rules/linda-shayne.md +341 -0
  107. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/martin-scorsese/module.json +50 -0
  108. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/martin-scorsese/rules/martin-scorsese.md +188 -0
  109. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/mel-brooks/module.json +50 -0
  110. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/mel-brooks/rules/mel-brooks.md +215 -0
  111. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/michael-curtiz/module.json +50 -0
  112. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/michael-curtiz/rules/michael-curtiz.md +429 -0
  113. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/michael-mann/module.json +50 -0
  114. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/michael-mann/rules/michael-mann.md +416 -0
  115. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/mike-nichols/module.json +50 -0
  116. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/mike-nichols/rules/mike-nichols.md +383 -0
  117. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/module.json +410 -0
  118. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/orson-welles/module.json +50 -0
  119. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/orson-welles/rules/orson-welles.md +400 -0
  120. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/park-chan-wook/module.json +50 -0
  121. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/park-chan-wook/rules/park-chan-wook.md +357 -0
  122. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/paul-thomas-anderson/module.json +50 -0
  123. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/paul-thomas-anderson/rules/paul-thomas-anderson.md +143 -0
  124. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/penny-marshall/module.json +50 -0
  125. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/penny-marshall/rules/penny-marshall.md +139 -0
  126. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/peter-bogdanovich/module.json +50 -0
  127. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/peter-bogdanovich/rules/peter-bogdanovich.md +411 -0
  128. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/quentin-tarantino/module.json +50 -0
  129. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/quentin-tarantino/rules/quentin-tarantino.md +178 -0
  130. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/richard-linklater/module.json +50 -0
  131. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/richard-linklater/rules/richard-linklater.md +463 -0
  132. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/rob-reiner/module.json +50 -0
  133. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/rob-reiner/rules/rob-reiner.md +470 -0
  134. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-altman/module.json +50 -0
  135. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-altman/rules/robert-altman.md +447 -0
  136. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-eggers/module.json +50 -0
  137. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-eggers/rules/robert-eggers.md +361 -0
  138. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-zemeckis/module.json +50 -0
  139. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/robert-zemeckis/rules/robert-zemeckis.md +489 -0
  140. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sam-peckinpah/module.json +50 -0
  141. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sam-peckinpah/rules/sam-peckinpah.md +475 -0
  142. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sidney-lumet/module.json +50 -0
  143. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sidney-lumet/rules/sidney-lumet.md +387 -0
  144. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/spike-lee/module.json +50 -0
  145. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/spike-lee/rules/spike-lee.md +500 -0
  146. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/stanley-donen-gene-kelly/module.json +50 -0
  147. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/stanley-donen-gene-kelly/rules/stanley-donen-gene-kelly.md +406 -0
  148. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/stanley-kubrick/module.json +50 -0
  149. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/stanley-kubrick/rules/stanley-kubrick.md +183 -0
  150. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/steve-martin/module.json +50 -0
  151. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/steve-martin/rules/steve-martin.md +138 -0
  152. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/steven-spielberg/module.json +50 -0
  153. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/steven-spielberg/rules/steven-spielberg.md +179 -0
  154. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sydney-pollack/module.json +50 -0
  155. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/sydney-pollack/rules/sydney-pollack.md +356 -0
  156. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/terry-gilliam/module.json +50 -0
  157. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/terry-gilliam/rules/terry-gilliam.md +546 -0
  158. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/tim-burton/module.json +50 -0
  159. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/tim-burton/rules/tim-burton.md +356 -0
  160. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/tobe-hooper/module.json +50 -0
  161. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/tobe-hooper/rules/tobe-hooper.md +596 -0
  162. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/wes-anderson/module.json +50 -0
  163. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/wes-anderson/rules/wes-anderson.md +146 -0
  164. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/william-friedkin/module.json +50 -0
  165. package/augment-extensions/writing-standards/screenplay/cinematic-styles/directors/william-friedkin/rules/william-friedkin.md +378 -0
  166. package/augment-extensions/writing-standards/screenplay/cinematic-styles/examples/style-applications.md +740 -0
  167. package/augment-extensions/writing-standards/screenplay/cinematic-styles/films/blue-ruin/module.json +50 -0
  168. package/augment-extensions/writing-standards/screenplay/cinematic-styles/films/blue-ruin/rules/blue-ruin.md +721 -0
  169. package/augment-extensions/writing-standards/screenplay/cinematic-styles/films/module.json +27 -0
  170. package/augment-extensions/writing-standards/screenplay/cinematic-styles/films/rules/blue-ruin.md.bak +667 -0
  171. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/fast-and-furious/module.json +17 -0
  172. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/fast-and-furious/rules/the-fast-and-furious-saga.md +427 -0
  173. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/harry-potter/module.json +17 -0
  174. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/harry-potter/rules/harry-potter.md +170 -0
  175. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/james-bond/module.json +17 -0
  176. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/james-bond/rules/james-bond.md +440 -0
  177. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/john-wick/module.json +17 -0
  178. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/john-wick/rules/john-wick.md +375 -0
  179. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/lord-of-the-rings/module.json +17 -0
  180. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/lord-of-the-rings/rules/lord-of-the-rings.md +437 -0
  181. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/mcu/module.json +29 -0
  182. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/mcu/rules/mcu-avengers.md +985 -0
  183. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/mcu/rules/mcu-avengers.md.bak +933 -0
  184. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/module.json +93 -0
  185. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/module.json +46 -0
  186. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-deep-space-nine.md +146 -0
  187. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-enterprise.md +149 -0
  188. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-strange-new-world.md +156 -0
  189. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-the-next-generation.md +163 -0
  190. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-tos.md +148 -0
  191. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek-voyager.md +148 -0
  192. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-trek/rules/star-trek.md +163 -0
  193. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-wars/module.json +17 -0
  194. package/augment-extensions/writing-standards/screenplay/cinematic-styles/franchises/star-wars/rules/star-wars.md +213 -0
  195. package/augment-extensions/writing-standards/screenplay/cinematic-styles/module.json +128 -0
  196. package/augment-extensions/writing-standards/screenplay/cinematic-styles/narrative-theory/joseph-campbell/module.json +50 -0
  197. package/augment-extensions/writing-standards/screenplay/cinematic-styles/narrative-theory/joseph-campbell/rules/joseph-campbell.md +178 -0
  198. package/augment-extensions/writing-standards/screenplay/cinematic-styles/narrative-theory/module.json +27 -0
  199. package/augment-extensions/writing-standards/screenplay/cinematic-styles/producers/bruckheimer-and-simpson/module.json +50 -0
  200. package/augment-extensions/writing-standards/screenplay/cinematic-styles/producers/bruckheimer-and-simpson/rules/bruckheimer-and-simpson.md +376 -0
  201. package/augment-extensions/writing-standards/screenplay/cinematic-styles/producers/module.json +26 -0
  202. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/blue-ruin.md +667 -0
  203. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/christopher-nolan.md +126 -0
  204. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/coen-brothers.md +154 -0
  205. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/david-lynch.md +124 -0
  206. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/denis-villeneuve.md +119 -0
  207. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/francis-ford-coppola.md +176 -0
  208. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/george-lucas.md +116 -0
  209. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/joseph-campbell.md +167 -0
  210. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/martin-scorsese.md +174 -0
  211. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/mcu-avengers.md +933 -0
  212. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/monty-python.md +231 -0
  213. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/quentin-tarantino.md +167 -0
  214. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/saturday-night-live.md +141 -0
  215. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/stanley-kubrick.md +169 -0
  216. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/star-wars.md +200 -0
  217. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/steven-spielberg.md +165 -0
  218. package/augment-extensions/writing-standards/screenplay/cinematic-styles/rules/wes-anderson.md +134 -0
  219. package/augment-extensions/writing-standards/screenplay/module.json +48 -1
  220. package/cli/AGENTS.md +22 -0
  221. package/cli/dist/__test_hook-system.d.ts +2 -0
  222. package/cli/dist/__test_hook-system.d.ts.map +1 -0
  223. package/cli/dist/__test_hook-system.js +4 -0
  224. package/cli/dist/__test_hook-system.js.map +1 -0
  225. package/cli/dist/cli.js +21 -0
  226. package/cli/dist/cli.js.map +1 -1
  227. package/cli/dist/commands/generate-shot-list/error-detector.d.ts +92 -0
  228. package/cli/dist/commands/generate-shot-list/error-detector.d.ts.map +1 -0
  229. package/cli/dist/commands/generate-shot-list/error-detector.js +131 -0
  230. package/cli/dist/commands/generate-shot-list/error-detector.js.map +1 -0
  231. package/cli/dist/commands/generate-shot-list/error-recovery.d.ts +85 -0
  232. package/cli/dist/commands/generate-shot-list/error-recovery.d.ts.map +1 -0
  233. package/cli/dist/commands/generate-shot-list/error-recovery.js +208 -0
  234. package/cli/dist/commands/generate-shot-list/error-recovery.js.map +1 -0
  235. package/cli/dist/commands/generate-shot-list/errors.d.ts +52 -0
  236. package/cli/dist/commands/generate-shot-list/errors.d.ts.map +1 -0
  237. package/cli/dist/commands/generate-shot-list/errors.js +287 -0
  238. package/cli/dist/commands/generate-shot-list/errors.js.map +1 -0
  239. package/cli/dist/commands/generate-shot-list/exit-codes.d.ts +42 -0
  240. package/cli/dist/commands/generate-shot-list/exit-codes.d.ts.map +1 -0
  241. package/cli/dist/commands/generate-shot-list/exit-codes.js +83 -0
  242. package/cli/dist/commands/generate-shot-list/exit-codes.js.map +1 -0
  243. package/cli/dist/commands/generate-shot-list/formatter/base-formatter.d.ts +48 -0
  244. package/cli/dist/commands/generate-shot-list/formatter/base-formatter.d.ts.map +1 -0
  245. package/cli/dist/commands/generate-shot-list/formatter/base-formatter.js +113 -0
  246. package/cli/dist/commands/generate-shot-list/formatter/base-formatter.js.map +1 -0
  247. package/cli/dist/commands/generate-shot-list/formatter/csv-formatter.d.ts +45 -0
  248. package/cli/dist/commands/generate-shot-list/formatter/csv-formatter.d.ts.map +1 -0
  249. package/cli/dist/commands/generate-shot-list/formatter/csv-formatter.js +110 -0
  250. package/cli/dist/commands/generate-shot-list/formatter/csv-formatter.js.map +1 -0
  251. package/cli/dist/commands/generate-shot-list/formatter/html-formatter.d.ts +38 -0
  252. package/cli/dist/commands/generate-shot-list/formatter/html-formatter.d.ts.map +1 -0
  253. package/cli/dist/commands/generate-shot-list/formatter/html-formatter.js +82 -0
  254. package/cli/dist/commands/generate-shot-list/formatter/html-formatter.js.map +1 -0
  255. package/cli/dist/commands/generate-shot-list/formatter/html-template.d.ts +11 -0
  256. package/cli/dist/commands/generate-shot-list/formatter/html-template.d.ts.map +1 -0
  257. package/cli/dist/commands/generate-shot-list/formatter/html-template.js +628 -0
  258. package/cli/dist/commands/generate-shot-list/formatter/html-template.js.map +1 -0
  259. package/cli/dist/commands/generate-shot-list/formatter/index.d.ts +13 -0
  260. package/cli/dist/commands/generate-shot-list/formatter/index.d.ts.map +1 -0
  261. package/cli/dist/commands/generate-shot-list/formatter/index.js +41 -0
  262. package/cli/dist/commands/generate-shot-list/formatter/index.js.map +1 -0
  263. package/cli/dist/commands/generate-shot-list/formatter/json-formatter.d.ts +34 -0
  264. package/cli/dist/commands/generate-shot-list/formatter/json-formatter.d.ts.map +1 -0
  265. package/cli/dist/commands/generate-shot-list/formatter/json-formatter.js +123 -0
  266. package/cli/dist/commands/generate-shot-list/formatter/json-formatter.js.map +1 -0
  267. package/cli/dist/commands/generate-shot-list/formatter/jsonl-formatter.d.ts +37 -0
  268. package/cli/dist/commands/generate-shot-list/formatter/jsonl-formatter.d.ts.map +1 -0
  269. package/cli/dist/commands/generate-shot-list/formatter/jsonl-formatter.js +100 -0
  270. package/cli/dist/commands/generate-shot-list/formatter/jsonl-formatter.js.map +1 -0
  271. package/cli/dist/commands/generate-shot-list/formatter/markdown-formatter.d.ts +34 -0
  272. package/cli/dist/commands/generate-shot-list/formatter/markdown-formatter.d.ts.map +1 -0
  273. package/cli/dist/commands/generate-shot-list/formatter/markdown-formatter.js +159 -0
  274. package/cli/dist/commands/generate-shot-list/formatter/markdown-formatter.js.map +1 -0
  275. package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.d.ts +37 -0
  276. package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.d.ts.map +1 -0
  277. package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.js +125 -0
  278. package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.js.map +1 -0
  279. package/cli/dist/commands/generate-shot-list/formatter/types.d.ts +75 -0
  280. package/cli/dist/commands/generate-shot-list/formatter/types.d.ts.map +1 -0
  281. package/cli/dist/commands/generate-shot-list/formatter/types.js +8 -0
  282. package/cli/dist/commands/generate-shot-list/formatter/types.js.map +1 -0
  283. package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts +55 -0
  284. package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts.map +1 -0
  285. package/cli/dist/commands/generate-shot-list/generator/context-builder.js +168 -0
  286. package/cli/dist/commands/generate-shot-list/generator/context-builder.js.map +1 -0
  287. package/cli/dist/commands/generate-shot-list/generator/index.d.ts +40 -0
  288. package/cli/dist/commands/generate-shot-list/generator/index.d.ts.map +1 -0
  289. package/cli/dist/commands/generate-shot-list/generator/index.js +168 -0
  290. package/cli/dist/commands/generate-shot-list/generator/index.js.map +1 -0
  291. package/cli/dist/commands/generate-shot-list/generator/metadata-extractor.d.ts +46 -0
  292. package/cli/dist/commands/generate-shot-list/generator/metadata-extractor.d.ts.map +1 -0
  293. package/cli/dist/commands/generate-shot-list/generator/metadata-extractor.js +170 -0
  294. package/cli/dist/commands/generate-shot-list/generator/metadata-extractor.js.map +1 -0
  295. package/cli/dist/commands/generate-shot-list/generator/scene-segmenter.d.ts +49 -0
  296. package/cli/dist/commands/generate-shot-list/generator/scene-segmenter.d.ts.map +1 -0
  297. package/cli/dist/commands/generate-shot-list/generator/scene-segmenter.js +130 -0
  298. package/cli/dist/commands/generate-shot-list/generator/scene-segmenter.js.map +1 -0
  299. package/cli/dist/commands/generate-shot-list/generator/types.d.ts +118 -0
  300. package/cli/dist/commands/generate-shot-list/generator/types.d.ts.map +1 -0
  301. package/cli/dist/commands/generate-shot-list/generator/types.js +8 -0
  302. package/cli/dist/commands/generate-shot-list/generator/types.js.map +1 -0
  303. package/cli/dist/commands/generate-shot-list/generator/validator.d.ts +40 -0
  304. package/cli/dist/commands/generate-shot-list/generator/validator.d.ts.map +1 -0
  305. package/cli/dist/commands/generate-shot-list/generator/validator.js +117 -0
  306. package/cli/dist/commands/generate-shot-list/generator/validator.js.map +1 -0
  307. package/cli/dist/commands/generate-shot-list/help-text.d.ts +11 -0
  308. package/cli/dist/commands/generate-shot-list/help-text.d.ts.map +1 -0
  309. package/cli/dist/commands/generate-shot-list/help-text.js +160 -0
  310. package/cli/dist/commands/generate-shot-list/help-text.js.map +1 -0
  311. package/cli/dist/commands/generate-shot-list/logger/index.d.ts +25 -0
  312. package/cli/dist/commands/generate-shot-list/logger/index.d.ts.map +1 -0
  313. package/cli/dist/commands/generate-shot-list/logger/index.js +98 -0
  314. package/cli/dist/commands/generate-shot-list/logger/index.js.map +1 -0
  315. package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.d.ts +43 -0
  316. package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.d.ts.map +1 -0
  317. package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.js +123 -0
  318. package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.js.map +1 -0
  319. package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.d.ts +43 -0
  320. package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.d.ts.map +1 -0
  321. package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.js +142 -0
  322. package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.js.map +1 -0
  323. package/cli/dist/commands/generate-shot-list/logger/types.d.ts +145 -0
  324. package/cli/dist/commands/generate-shot-list/logger/types.d.ts.map +1 -0
  325. package/cli/dist/commands/generate-shot-list/logger/types.js +8 -0
  326. package/cli/dist/commands/generate-shot-list/logger/types.js.map +1 -0
  327. package/cli/dist/commands/generate-shot-list/parser/fountain-parser.d.ts +33 -0
  328. package/cli/dist/commands/generate-shot-list/parser/fountain-parser.d.ts.map +1 -0
  329. package/cli/dist/commands/generate-shot-list/parser/fountain-parser.js +249 -0
  330. package/cli/dist/commands/generate-shot-list/parser/fountain-parser.js.map +1 -0
  331. package/cli/dist/commands/generate-shot-list/parser/index.d.ts +24 -0
  332. package/cli/dist/commands/generate-shot-list/parser/index.d.ts.map +1 -0
  333. package/cli/dist/commands/generate-shot-list/parser/index.js +117 -0
  334. package/cli/dist/commands/generate-shot-list/parser/index.js.map +1 -0
  335. package/cli/dist/commands/generate-shot-list/parser/markdown-parser.d.ts +21 -0
  336. package/cli/dist/commands/generate-shot-list/parser/markdown-parser.d.ts.map +1 -0
  337. package/cli/dist/commands/generate-shot-list/parser/markdown-parser.js +197 -0
  338. package/cli/dist/commands/generate-shot-list/parser/markdown-parser.js.map +1 -0
  339. package/cli/dist/commands/generate-shot-list/parser/plaintext-parser.d.ts +29 -0
  340. package/cli/dist/commands/generate-shot-list/parser/plaintext-parser.d.ts.map +1 -0
  341. package/cli/dist/commands/generate-shot-list/parser/plaintext-parser.js +213 -0
  342. package/cli/dist/commands/generate-shot-list/parser/plaintext-parser.js.map +1 -0
  343. package/cli/dist/commands/generate-shot-list/parser/types.d.ts +133 -0
  344. package/cli/dist/commands/generate-shot-list/parser/types.d.ts.map +1 -0
  345. package/cli/dist/commands/generate-shot-list/parser/types.js +22 -0
  346. package/cli/dist/commands/generate-shot-list/parser/types.js.map +1 -0
  347. package/cli/dist/commands/generate-shot-list.d.ts +13 -0
  348. package/cli/dist/commands/generate-shot-list.d.ts.map +1 -0
  349. package/cli/dist/commands/generate-shot-list.js +115 -0
  350. package/cli/dist/commands/generate-shot-list.js.map +1 -0
  351. package/cli/dist/index.d.ts +7 -0
  352. package/cli/dist/index.d.ts.map +1 -0
  353. package/cli/dist/index.js +10 -0
  354. package/cli/dist/index.js.map +1 -0
  355. package/cli/dist/utils/mcp-integration.d.ts +1 -2
  356. package/cli/dist/utils/mcp-integration.d.ts.map +1 -1
  357. package/cli/dist/utils/mcp-integration.js +102 -13
  358. package/cli/dist/utils/mcp-integration.js.map +1 -1
  359. package/package.json +4 -1
@@ -0,0 +1,721 @@
1
+ # Blue Ruin - Screenplay Style Guide
2
+
3
+ ## Table of Contents
4
+ - [Table of Contents](#table-of-contents)
5
+ - [The Incompetent Protagonist Thriller](#the-incompetent-protagonist-thriller)
6
+ - [Overview](#overview)
7
+ - [Core Principles](#core-principles)
8
+ - [1. **Authentic Incompetence**](#1-authentic-incompetence)
9
+ - [2. **Minimal Dialogue**](#2-minimal-dialogue)
10
+ - [3. **Visual Storytelling**](#3-visual-storytelling)
11
+ - [4. **Realistic Violence**](#4-realistic-violence)
12
+ - [Narrative Structure](#narrative-structure)
13
+ - [Act 1: The Ordinary Incompetent (0-20 minutes)](#act-1-the-ordinary-incompetent-0-20-minutes)
14
+ - [Act 2: Escalating Consequences (20-70 minutes)](#act-2-escalating-consequences-20-70-minutes)
15
+ - [Act 3: Inevitable Collision (70-90 minutes)](#act-3-inevitable-collision-70-90-minutes)
16
+ - [Character Development](#character-development)
17
+ - [The Incompetent Protagonist](#the-incompetent-protagonist)
18
+ - [Supporting Characters](#supporting-characters)
19
+ - [Scene Construction](#scene-construction)
20
+ - [The "Competence Test" Scene](#the-competence-test-scene)
21
+ - [The "Quiet Tension" Scene](#the-quiet-tension-scene)
22
+ - [The "Aftermath" Scene](#the-aftermath-scene)
23
+ - [Dialogue Principles](#dialogue-principles)
24
+ - [When to Use Dialogue](#when-to-use-dialogue)
25
+ - [Dialogue Style](#dialogue-style)
26
+ - [Silence as Dialogue](#silence-as-dialogue)
27
+ - [Pacing and Rhythm](#pacing-and-rhythm)
28
+ - [Overall Pacing](#overall-pacing)
29
+ - [Scene Length](#scene-length)
30
+ - [Montage vs. Real-Time](#montage-vs-real-time)
31
+ - [Visual Style Guidelines](#visual-style-guidelines)
32
+ - [Cinematography](#cinematography)
33
+ - [Color Palette](#color-palette)
34
+ - [Production Design](#production-design)
35
+ - [Sound Design](#sound-design)
36
+ - [Minimal Score](#minimal-score)
37
+ - [Sound Effects](#sound-effects)
38
+ - [Common Mistakes to Avoid](#common-mistakes-to-avoid)
39
+ - [DON'T:](#dont)
40
+ - [DO:](#do)
41
+ - [Thematic Elements](#thematic-elements)
42
+ - [Core Themes](#core-themes)
43
+ - [Moral Ambiguity](#moral-ambiguity)
44
+ - [Practical Writing Tips](#practical-writing-tips)
45
+ - [Scene Checklist](#scene-checklist)
46
+ - [Action Scene Checklist](#action-scene-checklist)
47
+ - [Dialogue Checklist](#dialogue-checklist)
48
+ - [Example Scene Breakdown](#example-scene-breakdown)
49
+ - [SCENE: First Confrontation](#scene-first-confrontation)
50
+ - [Final Notes](#final-notes)
51
+ - [The Blue Ruin Formula](#the-blue-ruin-formula)
52
+ - [When to Use This Style](#when-to-use-this-style)
53
+ - [Recommended Viewing](#recommended-viewing)
54
+ - [Conclusion](#conclusion)
55
+
56
+ ## The Incompetent Protagonist Thriller
57
+
58
+ **Film**: Blue Ruin (2013)
59
+ **Writer/Director**: Jeremy Saulnier
60
+ **Genre**: Revenge Thriller / Anti-Action Film
61
+ **Runtime**: 90 minutes
62
+ **Core Concept**: Authentic incompetence in a revenge narrative
63
+
64
+ ---
65
+
66
+ ## Overview
67
+
68
+ Blue Ruin revolutionizes the revenge thriller by asking: "What if the protagonist was slightly less competent than the average person?" This style guide captures the techniques that make this film a masterpiece of grounded, tension-driven storytelling.
69
+
70
+ ---
71
+
72
+ ## Core Principles
73
+
74
+ ### 1. **Authentic Incompetence**
75
+ The protagonist is not comedically inept—he's realistically unprepared.
76
+
77
+ **Key Philosophy**:
78
+ - Character can do nothing the audience cannot do
79
+ - Every "action hero" skill is absent or fumbled
80
+ - Mistakes have real, escalating consequences
81
+ - No plot armor, no convenient expertise
82
+
83
+ **Examples from Film**:
84
+ - Protagonist misses a target from 7 feet away (realistic for untrained shooter)
85
+ - Struggles to slash a tire (harder than it looks)
86
+ - Cannot pick locks, hot-wire cars, or treat wounds properly
87
+ - Gets lost, makes noise, leaves evidence
88
+
89
+ **Writing Approach**:
90
+ ```
91
+ WRONG: "Dwight expertly picks the lock and slips inside."
92
+ RIGHT: "Dwight fumbles with a bent paperclip. The lock doesn't budge.
93
+ He looks around, then smashes a window. Glass cuts his hand."
94
+ ```
95
+
96
+ ### 2. **Minimal Dialogue**
97
+ Blue Ruin uses sparse, purposeful dialogue. Long stretches pass without words.
98
+
99
+ **Dialogue Guidelines**:
100
+ - **Show, don't tell** - Visual storytelling over exposition
101
+ - **Silence as tension** - Quiet moments build dread
102
+ - **Subtext over text** - What's unsaid matters more
103
+ - **Functional only** - Dialogue serves plot or character, never explains
104
+
105
+ **Dialogue Ratio**:
106
+ - First 15 minutes: Nearly silent
107
+ - Average scene: 60% visual, 40% dialogue
108
+ - Key moments: Often wordless
109
+
110
+ **Example Structure**:
111
+ ```
112
+ INT. ABANDONED HOUSE - NIGHT
113
+
114
+ Dwight enters. Checks corners. Listens.
115
+
116
+ Footsteps above.
117
+
118
+ He freezes. Hand on knife. Breathing shallow.
119
+
120
+ The footsteps stop.
121
+
122
+ Long beat. Nothing.
123
+
124
+ He exhales.
125
+ ```
126
+
127
+ ### 3. **Visual Storytelling**
128
+ Every frame communicates character state, danger, or consequence.
129
+
130
+ **Visual Techniques**:
131
+ - **Environmental storytelling** - Setting reveals backstory
132
+ - **Physical state** - Wounds, dirt, exhaustion shown constantly
133
+ - **Practical details** - How things actually work (or don't)
134
+ - **Consequence visibility** - Blood, damage, evidence accumulates
135
+
136
+ **Character Through Visuals**:
137
+ - Protagonist's homelessness shown through appearance, not dialogue
138
+ - Desperation conveyed through body language
139
+ - Fear shown in shaking hands, shallow breathing
140
+ - Inexperience visible in hesitation, fumbling
141
+
142
+ ### 4. **Realistic Violence**
143
+ Violence is messy, painful, and has lasting consequences.
144
+
145
+ **Violence Principles**:
146
+ - **Unglamorous** - No choreography, no style
147
+ - **Consequences** - Injuries don't heal between scenes
148
+ - **Desperation** - Fighting is survival, not skill
149
+ - **Aftermath** - Blood, cleanup, trauma shown
150
+
151
+ **Action Scene Structure**:
152
+ ```
153
+ NOT: Smooth, choreographed fight sequence
154
+ BUT: Desperate scrambling, missed strikes, exhaustion, luck
155
+ ```
156
+
157
+ ---
158
+
159
+ ## Narrative Structure
160
+
161
+ ### Act 1: The Ordinary Incompetent (0-20 minutes)
162
+ **Goal**: Establish protagonist's baseline incompetence before the mission begins
163
+
164
+ **Key Elements**:
165
+ - **Silent opening** - Show character's current state visually
166
+ - **Inciting incident** - External event forces action
167
+ - **Reluctant preparation** - Character clearly unprepared
168
+ - **First failure** - Early mistake establishes pattern
169
+
170
+ **Pacing**:
171
+ - Slow, deliberate
172
+ - Minimal exposition
173
+ - Build dread through silence
174
+ - Audience realizes protagonist is in over his head
175
+
176
+ ### Act 2: Escalating Consequences (20-70 minutes)
177
+ **Goal**: Each mistake compounds into bigger problems
178
+
179
+ **Escalation Pattern**:
180
+ 1. **Small mistake** (leaves evidence, makes noise)
181
+ 2. **Medium consequence** (attracts attention, gets injured)
182
+ 3. **Major complication** (involves family, escalates conflict)
183
+ 4. **Desperate measures** (forced into worse situations)
184
+
185
+ **Key Techniques**:
186
+ - **No easy wins** - Every success comes with a cost
187
+ - **Mounting injuries** - Physical toll accumulates
188
+ - **Moral compromise** - Forced into darker choices
189
+ - **Isolation** - Support systems fail or are pushed away
190
+
191
+ ### Act 3: Inevitable Collision (70-90 minutes)
192
+ **Goal**: Protagonist's incompetence meets final confrontation
193
+
194
+ **Resolution Principles**:
195
+ - **No heroic transformation** - Character remains flawed
196
+ - **Pyrrhic victory** - Success comes at devastating cost
197
+ - **Ambiguous morality** - No clear "good guy wins"
198
+ - **Quiet ending** - Understated, not triumphant
199
+
200
+ ---
201
+
202
+ ## Character Development
203
+
204
+ ### The Incompetent Protagonist
205
+
206
+ **Core Traits**:
207
+ - **Ordinary skills** - Can do what average person can do, nothing more
208
+ - **Determination** - Driven by emotion, not ability
209
+ - **Vulnerability** - Physically and emotionally exposed
210
+ - **Adaptability** - Learns slowly, makes mistakes, improvises poorly
211
+
212
+ **What They CANNOT Do**:
213
+ - Fight multiple opponents
214
+ - Shoot accurately under pressure
215
+ - Pick locks or hot-wire vehicles
216
+ - Treat serious wounds
217
+ - Evade trained pursuers
218
+ - Plan more than one step ahead
219
+ - Keep emotions in check
220
+
221
+ **What They CAN Do**:
222
+ - Feel pain and fear
223
+ - Make desperate choices
224
+ - Stumble into partial success
225
+ - Survive through luck and stubbornness
226
+ - Fail repeatedly but keep going
227
+
228
+ **Character Arc**:
229
+ ```
230
+ NOT: Incompetent → Competent (training montage)
231
+ BUT: Incompetent → Still Incompetent (but more desperate)
232
+ ```
233
+
234
+ ### Supporting Characters
235
+
236
+ **The Competent Antagonists**:
237
+ - **Professional** - Know what they're doing
238
+ - **Organized** - Work as a unit
239
+ - **Experienced** - Have done this before
240
+ - **Dangerous** - Protagonist is outmatched
241
+
242
+ **The Reluctant Helpers**:
243
+ - **Skeptical** - Don't believe protagonist can succeed
244
+ - **Protective** - Try to stop protagonist for their own good
245
+ - **Limited** - Can help, but won't solve problems
246
+ - **Realistic** - Have their own lives and limits
247
+
248
+ ---
249
+
250
+ ## Scene Construction
251
+
252
+ ### The "Competence Test" Scene
253
+ Every action scene is a test of basic competence that the protagonist fails or barely passes.
254
+
255
+ **Structure**:
256
+ 1. **Setup** - Protagonist needs to do something "simple"
257
+ 2. **Attempt** - Shows lack of skill/knowledge
258
+ 3. **Failure** - Task goes wrong in realistic way
259
+ 4. **Consequence** - Failure creates new problem
260
+ 5. **Adaptation** - Protagonist finds messier solution
261
+
262
+ **Example Template**:
263
+ ```
264
+ TASK: Break into a car
265
+ ATTEMPT: Tries to slim-jim the lock
266
+ FAILURE: Doesn't know how, breaks tool
267
+ CONSEQUENCE: Attracts attention, wastes time
268
+ ADAPTATION: Smashes window, cuts hand, sets off alarm
269
+ ```
270
+
271
+ ### The "Quiet Tension" Scene
272
+ Build suspense through silence and visual detail.
273
+
274
+ **Elements**:
275
+ - **Minimal sound** - Footsteps, breathing, ambient noise
276
+ - **Slow pacing** - Let moments breathe
277
+ - **Environmental awareness** - Character scans, listens, waits
278
+ - **False scares** - Build and release tension repeatedly
279
+ - **Real danger** - Payoff is earned, not cheap
280
+
281
+ **Tension Techniques**:
282
+ - Long takes without cuts
283
+ - Handheld camera for unease
284
+ - Natural lighting (darkness is dark)
285
+ - Diegetic sound only (no score)
286
+
287
+ ### The "Aftermath" Scene
288
+ Show the consequences of violence and action.
289
+
290
+ **Required Elements**:
291
+ - **Cleanup** - Blood, evidence, disposal of bodies
292
+ - **Injury care** - Realistic, painful, inadequate
293
+ - **Emotional processing** - Shock, guilt, fear
294
+ - **Practical problems** - Where to go, what to do next
295
+
296
+ **Example**:
297
+ ```
298
+ INT. BATHROOM - NIGHT
299
+
300
+ Dwight strips off bloody shirt. Examines wound in mirror.
301
+
302
+ He pours vodka on it. Grits teeth. Doesn't scream.
303
+
304
+ Tries to thread needle. Hands shake. Drops it.
305
+
306
+ Picks it up. Tries again.
307
+
308
+ Finally gets thread through. Starts stitching.
309
+
310
+ Each stitch: wince, pause, breathe, continue.
311
+
312
+ Sloppy. Uneven. But functional.
313
+
314
+ He wraps it in duct tape and a torn t-shirt.
315
+
316
+ Sits on toilet. Head in hands. Breathing.
317
+ ```
318
+
319
+ ---
320
+
321
+ ## Dialogue Principles
322
+
323
+ ### When to Use Dialogue
324
+
325
+ **USE dialogue for**:
326
+ - Essential plot information that cannot be shown
327
+ - Character relationships and history
328
+ - Immediate tactical communication
329
+ - Moments of emotional breakthrough
330
+
331
+ **AVOID dialogue for**:
332
+ - Explaining what we can see
333
+ - Character backstory (show through environment)
334
+ - Emotional states (show through action)
335
+ - Exposition dumps
336
+
337
+ ### Dialogue Style
338
+
339
+ **Characteristics**:
340
+ - **Sparse** - Every word counts
341
+ - **Realistic** - People talk in fragments, not speeches
342
+ - **Subtext** - What's unsaid is louder
343
+ - **Functional** - Serves immediate purpose
344
+
345
+ **Examples**:
346
+
347
+ **WRONG** (Over-explained):
348
+ ```
349
+ DWIGHT
350
+ I have to do this. The man who killed my parents is
351
+ getting out of prison today. I've been homeless for
352
+ years, waiting for this moment. I know I'm not trained
353
+ for this, but I have to try.
354
+ ```
355
+
356
+ **RIGHT** (Minimal, visual):
357
+ ```
358
+ POLICE OFFICER
359
+ Wade Cleland's being released today.
360
+
361
+ Dwight's face: recognition, pain, determination.
362
+
363
+ DWIGHT
364
+ When?
365
+
366
+ POLICE OFFICER
367
+ This afternoon.
368
+
369
+ Dwight nods. Walks away.
370
+ ```
371
+
372
+ ### Silence as Dialogue
373
+
374
+ **Powerful Silent Moments**:
375
+ - First kill (no words, just action and reaction)
376
+ - Driving scenes (character alone with thoughts)
377
+ - Stalking/surveillance (patience and observation)
378
+ - Injury treatment (pain speaks louder than words)
379
+ - Final confrontation (actions over threats)
380
+
381
+ ---
382
+
383
+ ## Pacing and Rhythm
384
+
385
+ ### Overall Pacing
386
+ - **Slow burn** - Build tension gradually
387
+ - **No rush** - Let scenes breathe
388
+ - **Earned payoffs** - Setup takes time
389
+ - **Quiet between chaos** - Contrast action with stillness
390
+
391
+ ### Scene Length
392
+ - **Varies widely** - Some scenes are 30 seconds, others 5+ minutes
393
+ - **Follows natural rhythm** - Ends when moment is complete
394
+ - **No artificial cuts** - Stay with character through full experience
395
+
396
+ ### Montage vs. Real-Time
397
+ **AVOID**: Training montages, time-skip solutions, convenient skill acquisition
398
+
399
+ **USE**: Real-time struggle, visible learning curve, repeated failures
400
+
401
+ ---
402
+
403
+ ## Visual Style Guidelines
404
+
405
+ ### Cinematography
406
+
407
+ **Camera Work**:
408
+ - **Handheld** - Adds realism and unease
409
+ - **Long takes** - Build tension without cutting
410
+ - **Static frames** - For observation and waiting
411
+ - **Close-ups** - Show physical toll and emotion
412
+ - **Wide shots** - Establish geography and isolation
413
+
414
+ **Lighting**:
415
+ - **Natural** - Available light, practical sources
416
+ - **Darkness** - Actually dark, not "movie dark"
417
+ - **Harsh** - Unflattering, realistic
418
+ - **Minimal** - No glamour lighting
419
+
420
+ ### Color Palette
421
+ - **Desaturated** - Muted, realistic tones
422
+ - **Blue-gray** - Cold, bleak atmosphere
423
+ - **Rust and decay** - Visual metaphor for protagonist
424
+ - **Blood red** - Only vibrant color (violence stands out)
425
+
426
+ ### Production Design
427
+
428
+ **Locations**:
429
+ - **Real places** - Lived-in, authentic
430
+ - **Decay** - Abandoned buildings, run-down areas
431
+ - **Isolation** - Rural, empty, lonely
432
+ - **Practical** - Actual locations, not sets
433
+
434
+ **Props**:
435
+ - **Functional** - Everything works (or doesn't) realistically
436
+ - **Worn** - Nothing is new or pristine
437
+ - **Limited** - Protagonist has minimal resources
438
+ - **Improvised** - Makeshift weapons and tools
439
+
440
+ ---
441
+
442
+ ## Sound Design
443
+
444
+ ### Minimal Score
445
+ - **Sparse music** - Used rarely, for specific emotional beats
446
+ - **Diegetic sound** - What characters hear, we hear
447
+ - **Silence** - Powerful tool for tension
448
+ - **Ambient** - Natural environmental sounds
449
+
450
+ ### Sound Effects
451
+ - **Realistic** - Guns are loud, violence is messy
452
+ - **Detailed** - Footsteps, breathing, fabric rustling
453
+ - **Consequences** - Ringing ears after gunshots
454
+ - **Environmental** - Wind, rain, distant traffic
455
+
456
+ ---
457
+
458
+ ## Common Mistakes to Avoid
459
+
460
+ ### DON'T:
461
+ 1. **Give protagonist convenient skills**
462
+ - No sudden expertise in fighting, shooting, or tactics
463
+ - No "I used to be in the military" reveals
464
+ - No hidden talents that solve problems
465
+
466
+ 2. **Use plot armor**
467
+ - Protagonist can and should get hurt
468
+ - Enemies are competent and dangerous
469
+ - Luck runs out, mistakes compound
470
+
471
+ 3. **Explain everything**
472
+ - Trust visual storytelling
473
+ - Leave gaps for audience to fill
474
+ - Backstory through environment, not dialogue
475
+
476
+ 4. **Make violence cool**
477
+ - No slow-motion heroics
478
+ - No witty one-liners after kills
479
+ - No glamorizing brutality
480
+
481
+ 5. **Rush the pacing**
482
+ - Let tension build naturally
483
+ - Show the full process of tasks
484
+ - Don't skip the hard parts
485
+
486
+ 6. **Provide easy solutions**
487
+ - No deus ex machina
488
+ - No convenient help arriving
489
+ - No last-minute skill acquisition
490
+
491
+ ### DO:
492
+ 1. **Show realistic consequences**
493
+ - Injuries persist and worsen
494
+ - Mistakes create cascading problems
495
+ - Actions have moral weight
496
+
497
+ 2. **Build tension through silence**
498
+ - Long stretches without dialogue
499
+ - Visual storytelling over exposition
500
+ - Quiet moments before violence
501
+
502
+ 3. **Make audience question protagonist**
503
+ - Is this revenge justified?
504
+ - Can they actually succeed?
505
+ - Should they even try?
506
+
507
+ 4. **Ground everything in reality**
508
+ - Research how things actually work
509
+ - Show failures and fumbling
510
+ - No movie magic solutions
511
+
512
+ ---
513
+
514
+ ## Thematic Elements
515
+
516
+ ### Core Themes
517
+
518
+ **1. The Cost of Revenge**
519
+ - Revenge doesn't heal wounds
520
+ - Violence begets violence
521
+ - Protagonist loses more than they gain
522
+ - No catharsis, only consequences
523
+
524
+ **2. Ordinary People in Extraordinary Situations**
525
+ - Average person thrust into thriller plot
526
+ - Lack of preparation is the point
527
+ - Survival through desperation, not skill
528
+ - Realism over wish fulfillment
529
+
530
+ **3. The Illusion of Action Heroes**
531
+ - Deconstructs action movie tropes
532
+ - Shows what "heroism" actually costs
533
+ - No glory in violence
534
+ - Competence is rare and hard-won
535
+
536
+ **4. Isolation and Desperation**
537
+ - Protagonist is alone by choice and circumstance
538
+ - Help is limited or refused
539
+ - Desperation drives poor decisions
540
+ - Loneliness as character state
541
+
542
+ ### Moral Ambiguity
543
+ - **No clear heroes** - Protagonist is sympathetic but flawed
544
+ - **Understandable villains** - Antagonists have their own logic
545
+ - **Questionable choices** - Audience debates protagonist's actions
546
+ - **Pyrrhic victories** - Success feels hollow
547
+
548
+ ---
549
+
550
+ ## Practical Writing Tips
551
+
552
+ ### Scene Checklist
553
+ Before writing any scene, ask:
554
+ 1. Can this be shown without dialogue?
555
+ 2. What can the protagonist realistically do/not do?
556
+ 3. What are the consequences of this action?
557
+ 4. How does this build tension or character?
558
+ 5. Is the pacing too fast? (Slow down)
559
+
560
+ ### Action Scene Checklist
561
+ 1. Is the protagonist outmatched?
562
+ 2. Do they make realistic mistakes?
563
+ 3. Does violence have weight and consequence?
564
+ 4. Is there a cost to "winning"?
565
+ 5. Does it feel desperate, not heroic?
566
+
567
+ ### Dialogue Checklist
568
+ 1. Can this be cut entirely?
569
+ 2. Can it be shorter?
570
+ 3. Is it realistic speech, not exposition?
571
+ 4. Does silence work better?
572
+ 5. What's the subtext?
573
+
574
+ ---
575
+
576
+ ## Example Scene Breakdown
577
+
578
+ ### SCENE: First Confrontation
579
+
580
+ **Setup**: Protagonist must confront the man who killed his parents.
581
+
582
+ **Traditional Thriller Approach**:
583
+ ```
584
+ INT. HOUSE - NIGHT
585
+
586
+ Dwight bursts in, gun drawn. Wade turns, surprised.
587
+
588
+ DWIGHT
589
+ Remember me?
590
+
591
+ WADE
592
+ Who the hell—
593
+
594
+ BANG. Dwight shoots him. Wade falls. Dwight stands over him.
595
+
596
+ DWIGHT
597
+ That's for my parents.
598
+
599
+ Dwight leaves.
600
+ ```
601
+
602
+ **Blue Ruin Approach**:
603
+ ```
604
+ INT. BATHROOM - NIGHT
605
+
606
+ Wade sits on toilet, reading newspaper. Hears door open.
607
+
608
+ WADE
609
+ Occupied!
610
+
611
+ Dwight enters. Knife in shaking hand.
612
+
613
+ Wade looks up. Doesn't recognize him. Starts to stand.
614
+
615
+ Dwight lunges. Knife goes in wrong. Wade screams.
616
+
617
+ They struggle. Crash into sink. Mirror shatters.
618
+
619
+ Wade's stronger. Pushes Dwight back. Dwight slips on water.
620
+
621
+ Wade grabs Dwight's wrist. They're face to face. Both terrified.
622
+
623
+ Dwight headbutts him. Wade's nose breaks. Blood everywhere.
624
+
625
+ They fall. Knife between them. Both grabbing for it.
626
+
627
+ Wade gets it. Raises it.
628
+
629
+ Dwight grabs his throat. Squeezes. Wade can't breathe.
630
+
631
+ Knife drops. Wade's face goes purple. Eyes bulge.
632
+
633
+ Dwight doesn't let go. Keeps squeezing. Tears streaming.
634
+
635
+ Wade stops moving.
636
+
637
+ Dwight holds on. Ten more seconds. Twenty.
638
+
639
+ Finally lets go. Sits back. Covered in blood. Shaking.
640
+
641
+ Looks at Wade's body. No satisfaction. Just horror.
642
+
643
+ Stands. Legs barely work. Stumbles out.
644
+ ```
645
+
646
+ **Key Differences**:
647
+ - No witty dialogue
648
+ - Messy, desperate struggle
649
+ - Both men are terrified
650
+ - No clean kill
651
+ - Protagonist is traumatized, not triumphant
652
+ - Takes time to show full horror
653
+
654
+ ---
655
+
656
+ ## Final Notes
657
+
658
+ ### The Blue Ruin Formula
659
+
660
+ **Core Equation**:
661
+ ```
662
+ Ordinary Person + Extraordinary Situation - Competence = Authentic Tension
663
+ ```
664
+
665
+ **Success Metrics**:
666
+ - Audience thinks: "I couldn't do that either"
667
+ - Tension from realism, not spectacle
668
+ - Silence speaks louder than dialogue
669
+ - Violence disturbs rather than entertains
670
+ - Ending feels inevitable, not triumphant
671
+
672
+ ### When to Use This Style
673
+
674
+ **Best For**:
675
+ - Revenge thrillers
676
+ - Crime dramas
677
+ - Survival stories
678
+ - Character-driven suspense
679
+ - Anti-hero narratives
680
+
681
+ **Not Ideal For**:
682
+ - Traditional action films
683
+ - Superhero stories
684
+ - Comedies (unless very dark)
685
+ - Feel-good narratives
686
+ - Stories requiring competent protagonists
687
+
688
+ ---
689
+
690
+ ## Recommended Viewing
691
+
692
+ **Similar Films** (Incompetent Protagonist Trilogy):
693
+ - **Murder Party** (2007) - Jeremy Saulnier
694
+ - **Blue Ruin** (2013) - Jeremy Saulnier
695
+ - **Green Room** (2015) - Jeremy Saulnier
696
+
697
+ **Thematic Companions**:
698
+ - **No Country for Old Men** - Ordinary people in violent situations
699
+ - **A Simple Plan** - Escalating consequences of bad decisions
700
+ - **The Nice Guys** - Incompetence played for comedy
701
+ - **Hell or High Water** - Desperate people, realistic violence
702
+
703
+ ---
704
+
705
+ ## Conclusion
706
+
707
+ Blue Ruin proves that authenticity creates more tension than spectacle. By stripping away the competence we expect from thriller protagonists, the film forces audiences to confront what revenge actually costs and what ordinary people can actually do.
708
+
709
+ **The Golden Rule**:
710
+ > "If your audience can't do it, your protagonist probably can't either."
711
+
712
+ **The Result**:
713
+ > Quiet, devastating, unforgettable cinema.
714
+
715
+ ---
716
+
717
+ **Version**: 1.0
718
+ **Date**: 2026-02-22
719
+ **Based on**: Blue Ruin (2013) analysis and Jeremy Saulnier's filmmaking approach
720
+
721
+