@mytechtoday/augment-extensions 0.4.0 → 0.7.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 (226) hide show
  1. package/README.md +6 -6
  2. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -0
  3. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -0
  4. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -0
  5. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -0
  6. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -0
  7. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -0
  8. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -0
  9. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -0
  10. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -0
  11. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -0
  12. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -0
  13. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -0
  14. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -0
  15. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -0
  16. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -0
  17. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -0
  18. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -0
  19. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -0
  20. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -0
  21. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -0
  22. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -0
  23. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -0
  24. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -0
  25. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -0
  26. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -0
  27. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -0
  28. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/README.md +136 -0
  29. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/SCHEMA-VALIDATION-REPORT.md +216 -0
  30. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/brand-kit-example.yaml +292 -0
  31. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/campaign-brief-example.yaml +389 -0
  32. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/content-calendar-example.yaml +643 -0
  33. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/email-newsletter-example.md +376 -0
  34. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/landing-page-example.md +934 -0
  35. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/ppc-ad-copy-example.md +301 -0
  36. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/seo-blog-post-example.md +347 -0
  37. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/examples/social-media-campaign-example.md +606 -0
  38. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/module.json +50 -0
  39. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/affiliate-influencer-marketing.md +593 -0
  40. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/asset-management.md +418 -0
  41. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/brand-consistency.md +210 -0
  42. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/content-marketing.md +337 -0
  43. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/conversion-optimization.md +455 -0
  44. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/direct-sales.md +499 -0
  45. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/email-marketing.md +439 -0
  46. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/legal-compliance.md +227 -0
  47. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/ppc-advertising.md +569 -0
  48. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/seo-optimization.md +470 -0
  49. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/social-media-marketing.md +414 -0
  50. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/universal-marketing.md +177 -0
  51. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/asset-inventory.schema.json +247 -0
  52. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/brand-kit.schema.json +326 -0
  53. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/campaign-brief.schema.json +342 -0
  54. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/color-palette.schema.json +223 -0
  55. package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/schemas/content-template.schema.json +383 -0
  56. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -0
  57. package/augment-extensions/workflows/beads-integration/README.md +143 -0
  58. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -0
  59. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -0
  60. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -0
  61. package/augment-extensions/workflows/beads-integration/module.json +75 -0
  62. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -0
  63. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -0
  64. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -0
  65. package/augment-extensions/writing-standards/screenplay/README.md +135 -6
  66. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -0
  67. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -0
  68. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -0
  69. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -0
  70. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -0
  71. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -0
  72. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -0
  73. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -0
  74. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -0
  75. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -0
  76. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -0
  77. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -0
  78. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -0
  79. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -0
  80. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -0
  81. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -0
  82. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -0
  83. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -0
  84. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -0
  85. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -0
  86. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -0
  87. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -0
  88. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -0
  89. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -0
  90. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -0
  91. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -0
  92. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -0
  93. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -0
  94. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -0
  95. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -0
  96. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -0
  97. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -0
  98. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -0
  99. package/augment-extensions/writing-standards/screenplay/module.json +1 -1
  100. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -0
  101. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -0
  102. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -0
  103. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -0
  104. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -0
  105. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -0
  106. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -0
  107. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -0
  108. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -0
  109. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -0
  110. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -0
  111. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -0
  112. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -0
  113. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -0
  114. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -0
  115. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -0
  116. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -0
  117. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -0
  118. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -0
  119. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -0
  120. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -0
  121. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -0
  122. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -0
  123. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -0
  124. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -0
  125. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -0
  126. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -0
  127. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -0
  128. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -0
  129. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -0
  130. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -0
  131. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -0
  132. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -0
  133. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -0
  134. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -0
  135. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -0
  136. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -0
  137. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -0
  138. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -0
  139. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -0
  140. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -0
  141. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -0
  142. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -0
  143. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -0
  144. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -0
  145. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -0
  146. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -0
  147. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -0
  148. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -0
  149. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -0
  150. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -0
  151. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -0
  152. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -0
  153. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -0
  154. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -0
  155. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -0
  156. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -0
  157. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -0
  158. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -0
  159. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -0
  160. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -0
  161. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -0
  162. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -0
  163. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -0
  164. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -0
  165. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -0
  166. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -0
  167. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -0
  168. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -0
  169. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -0
  170. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -0
  171. package/cli/dist/cli.js +30 -1
  172. package/cli/dist/cli.js.map +1 -1
  173. package/cli/dist/commands/show.d.ts +23 -0
  174. package/cli/dist/commands/show.d.ts.map +1 -1
  175. package/cli/dist/commands/show.js +928 -10
  176. package/cli/dist/commands/show.js.map +1 -1
  177. package/cli/dist/types/gui.d.ts +62 -0
  178. package/cli/dist/types/gui.d.ts.map +1 -0
  179. package/cli/dist/types/gui.js +30 -0
  180. package/cli/dist/types/gui.js.map +1 -0
  181. package/cli/dist/utils/config-system.d.ts +111 -0
  182. package/cli/dist/utils/config-system.d.ts.map +1 -0
  183. package/cli/dist/utils/config-system.js +239 -0
  184. package/cli/dist/utils/config-system.js.map +1 -0
  185. package/cli/dist/utils/gui-helpers.d.ts +23 -0
  186. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  187. package/cli/dist/utils/gui-helpers.js +159 -0
  188. package/cli/dist/utils/gui-helpers.js.map +1 -0
  189. package/cli/dist/utils/hook-system.d.ts +84 -0
  190. package/cli/dist/utils/hook-system.d.ts.map +1 -0
  191. package/cli/dist/utils/hook-system.js +151 -0
  192. package/cli/dist/utils/hook-system.js.map +1 -0
  193. package/cli/dist/utils/inspection-cache.d.ts +56 -0
  194. package/cli/dist/utils/inspection-cache.d.ts.map +1 -0
  195. package/cli/dist/utils/inspection-cache.js +166 -0
  196. package/cli/dist/utils/inspection-cache.js.map +1 -0
  197. package/cli/dist/utils/inspection-handlers.d.ts +75 -0
  198. package/cli/dist/utils/inspection-handlers.d.ts.map +1 -0
  199. package/cli/dist/utils/inspection-handlers.js +171 -0
  200. package/cli/dist/utils/inspection-handlers.js.map +1 -0
  201. package/cli/dist/utils/module-system.d.ts +81 -1
  202. package/cli/dist/utils/module-system.d.ts.map +1 -1
  203. package/cli/dist/utils/module-system.js +393 -16
  204. package/cli/dist/utils/module-system.js.map +1 -1
  205. package/cli/dist/utils/plugin-system.d.ts +133 -0
  206. package/cli/dist/utils/plugin-system.d.ts.map +1 -0
  207. package/cli/dist/utils/plugin-system.js +210 -0
  208. package/cli/dist/utils/plugin-system.js.map +1 -0
  209. package/cli/dist/utils/progress.d.ts +67 -0
  210. package/cli/dist/utils/progress.d.ts.map +1 -0
  211. package/cli/dist/utils/progress.js +146 -0
  212. package/cli/dist/utils/progress.js.map +1 -0
  213. package/cli/dist/utils/stream-reader.d.ts +34 -0
  214. package/cli/dist/utils/stream-reader.d.ts.map +1 -0
  215. package/cli/dist/utils/stream-reader.js +147 -0
  216. package/cli/dist/utils/stream-reader.js.map +1 -0
  217. package/cli/dist/utils/vscode-editor.d.ts +45 -0
  218. package/cli/dist/utils/vscode-editor.d.ts.map +1 -0
  219. package/cli/dist/utils/vscode-editor.js +171 -0
  220. package/cli/dist/utils/vscode-editor.js.map +1 -0
  221. package/cli/dist/utils/vscode-links.d.ts +49 -0
  222. package/cli/dist/utils/vscode-links.d.ts.map +1 -0
  223. package/cli/dist/utils/vscode-links.js +167 -0
  224. package/cli/dist/utils/vscode-links.js.map +1 -0
  225. package/modules.md +44 -2
  226. package/package.json +6 -4
@@ -0,0 +1,293 @@
1
+ # Biographical Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Biographical films (biopics) dramatize the lives of real people, focusing on significant periods, achievements, or struggles. The genre emphasizes character transformation, historical context, and finding universal themes in individual lives.
10
+
11
+ ## Core Concept
12
+
13
+ Biographical screenplays transform real lives into compelling drama by selecting specific periods or themes rather than attempting comprehensive life stories. Success depends on finding the dramatic arc within a real life, balancing factual accuracy with narrative structure, and revealing universal human truths through specific individual experiences. Great biopics make audiences care about the person, not just their achievements.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Find the Dramatic Arc
18
+
19
+ **Description**: Don't try to tell an entire life. Focus on a specific period, conflict, or transformation that has clear dramatic structure.
20
+
21
+ **Why It Matters**: Lives don't naturally follow three-act structure. You must find or create the arc.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: Focus on specific period (Lincoln's final months, Jobs creating iPod)
25
+ - ❌ **Bad**: Birth-to-death chronology with no clear dramatic focus
26
+
27
+ **Film Reference**: The Social Network (2010) - Focuses on Facebook's founding, not Zuckerberg's entire life.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Show the Person, Not the Icon
32
+
33
+ **Description**: Humanize the subject. Show flaws, contradictions, and private moments, not just public achievements.
34
+
35
+ **Why It Matters**: Icons are distant; humans are relatable. Complexity creates compelling drama.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: Subject shown with flaws, failures, and personal struggles
39
+ - ❌ **Bad**: Hagiography that worships subject without complexity
40
+
41
+ **Film Reference**: Raging Bull (1980) - Jake LaMotta shown as brilliant boxer and deeply flawed human.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Use Supporting Characters Actively
46
+
47
+ **Description**: People around the subject should be fully realized characters with their own arcs, not just witnesses to greatness.
48
+
49
+ **Why It Matters**: Supporting characters provide perspective, conflict, and emotional depth.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Family, rivals, and colleagues with their own motivations and development
53
+ - ❌ **Bad**: Cardboard cutouts who exist only to react to protagonist
54
+
55
+ **Film Reference**: The Theory of Everything (2014) - Jane Hawking's perspective and arc as important as Stephen's.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Thematic Truth Over Literal Truth
60
+
61
+ **Description**: Capture the essence and meaning of the person's life, even if specific details are compressed or dramatized.
62
+
63
+ **Why It Matters**: Dramatic truth serves the story; literal accuracy can be dramatically inert.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Composite characters or compressed timeline that serves emotional truth
67
+ - ❌ **Bad**: Inventing major events that contradict known facts or character
68
+
69
+ **Film Reference**: Amadeus (1984) - Historically inaccurate but captures truth about genius and envy.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Make It Universal
74
+
75
+ **Description**: The specific life should illuminate universal human experiences - ambition, love, failure, redemption.
76
+
77
+ **Why It Matters**: Audiences connect through shared humanity, not just admiration for achievements.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Specific story that resonates with universal themes
81
+ - ❌ **Bad**: "Greatest hits" of achievements with no emotional core
82
+
83
+ **Film Reference**: Milk (2008) - Harvey Milk's specific struggle illuminates universal fight for equality.
84
+
85
+ ---
86
+
87
+ ## Guidelines
88
+
89
+ ### Structure
90
+
91
+ - **Act I**: Introduce subject in their world, establish what they want or what drives them, inciting incident that launches main conflict
92
+ - **Act II**: Pursuit of goal, obstacles and setbacks, relationships tested, character transformation begins
93
+ - **Act III**: Climax of main conflict, resolution (triumph, tragedy, or both), epilogue showing legacy or outcome
94
+
95
+ ### Pacing
96
+
97
+ - Start in medias res or at crucial moment, not necessarily birth
98
+ - Use flashbacks sparingly and purposefully
99
+ - Montages for passage of time or achievements
100
+ - Focus on key moments that reveal character
101
+ - Epilogue can provide historical context or outcome
102
+
103
+ ### Character Archetypes
104
+
105
+ - **Protagonist**: The biographical subject with clear wants and flaws
106
+ - **Antagonist**: Rival, system, or internal demons opposing protagonist
107
+ - **Supporting**: Family, mentors, collaborators, witnesses - all fully realized
108
+
109
+ ### Tone and Atmosphere
110
+
111
+ - Varies by subject (inspirational, tragic, complex)
112
+ - Intimate even when depicting public figures
113
+ - Emotional authenticity over reverence
114
+ - Can be celebratory or critical
115
+ - Often reflective on legacy and meaning
116
+
117
+ ### Visual Style
118
+
119
+ - Period-appropriate production design
120
+ - Visual motifs reflecting subject's work or life
121
+ - Intimate cinematography for personal moments
122
+ - Can use stylistic choices to reflect subject's art or perspective
123
+ - Archival footage or photos in epilogue
124
+
125
+ ### Dialogue
126
+
127
+ - Research subject's actual speech patterns and vocabulary
128
+ - Balance authenticity with accessibility
129
+ - Key quotes from real life can be powerful
130
+ - Avoid over-explaining achievements - show don't tell
131
+ - Subtext in personal relationships
132
+
133
+ ## Common Pitfalls
134
+
135
+ ### Pitfall 1: Cradle-to-Grave Structure
136
+
137
+ **Problem**: Trying to cover entire life results in superficial greatest-hits montage.
138
+
139
+ **Solution**: Focus on specific period or theme with clear dramatic arc.
140
+
141
+ **Example**: Steve Jobs (2015) - Three product launches, not entire life.
142
+
143
+ ---
144
+
145
+ ### Pitfall 2: Hagiography
146
+
147
+ **Problem**: Worshipful portrayal that ignores flaws or complexity.
148
+
149
+ **Solution**: Show subject as fully human - flawed, contradictory, complex.
150
+
151
+ **Example**: Walk the Line (2005) - Johnny Cash's addiction and failures alongside his talent.
152
+
153
+ ---
154
+
155
+ ### Pitfall 3: Explaining Instead of Showing
156
+
157
+ **Problem**: Characters explaining subject's importance or achievements instead of dramatizing them.
158
+
159
+ **Solution**: Show the work, the struggle, the impact through action and consequence.
160
+
161
+ **Example**: Whiplash (2014) - Shows the brutal pursuit of musical excellence, doesn't explain it.
162
+
163
+ ---
164
+
165
+ ## Film Examples
166
+
167
+ ### Example 1: Raging Bull (1980)
168
+
169
+ **Director**: Martin Scorsese
170
+
171
+ **Why It Works**: Brutal, unflinching portrait of boxer Jake LaMotta. Genius and self-destruction intertwined.
172
+
173
+ **Key Scenes**:
174
+ - **Sugar Ray Robinson Fight**: Stylized violence as character expression
175
+ - **"You never got me down, Ray"**: Pride and delusion
176
+ - **"I'm not an animal"**: Broken man confronting his nature
177
+
178
+ **Techniques Used**:
179
+ - Black and white cinematography
180
+ - Expressionistic fight sequences
181
+ - Unflinching portrayal of protagonist's flaws
182
+ - Character study over achievement celebration
183
+
184
+ ---
185
+
186
+ ### Example 2: The Social Network (2010)
187
+
188
+ **Director**: David Fincher
189
+
190
+ **Why It Works**: Facebook's founding as character study of ambition, betrayal, and loneliness.
191
+
192
+ **Key Scenes**:
193
+ - **Opening Breakup**: Establishes Zuckerberg's social dysfunction
194
+ - **Depositions**: Multiple perspectives on events
195
+ - **"You're not an asshole, Mark. You're just trying so hard to be"**: Lonely at the top
196
+
197
+ **Techniques Used**:
198
+ - Dual timeline (flashbacks and depositions)
199
+ - Fast-paced dialogue (Aaron Sorkin)
200
+ - Multiple perspectives on same events
201
+ - Recent history treated as drama
202
+
203
+ ---
204
+
205
+ ### Example 3: Milk (2008)
206
+
207
+ **Director**: Gus Van Sant
208
+
209
+ **Why It Works**: Harvey Milk's activism and assassination. Personal and political intertwined.
210
+
211
+ **Key Scenes**:
212
+ - **Castro Street**: Building community and movement
213
+ - **Prop 6 Campaign**: Political struggle with personal stakes
214
+ - **Assassination**: Tragic culmination of political and personal threats
215
+
216
+ **Techniques Used**:
217
+ - Archival footage integrated with drama
218
+ - Political struggle as personal journey
219
+ - Supporting characters fully realized
220
+ - Tragic ending with hopeful legacy
221
+
222
+ ---
223
+
224
+ ### Example 4: I, Tonya (2017)
225
+
226
+ **Director**: Craig Gillespie
227
+
228
+ **Why It Works**: Tonya Harding's story through multiple unreliable perspectives. Darkly comic and tragic.
229
+
230
+ **Key Scenes**:
231
+ - **Breaking Fourth Wall**: Characters directly address camera
232
+ - **"America's Sweetheart"**: Class and image in figure skating
233
+ - **The Incident**: Multiple contradictory versions of same event
234
+
235
+ **Techniques Used**:
236
+ - Unreliable narrators with conflicting accounts
237
+ - Dark comedy mixed with tragedy
238
+ - Class commentary through sports
239
+ - Sympathy for controversial figure
240
+
241
+ ---
242
+
243
+ ## Integration with Other Features
244
+
245
+ ### Compatible Themes
246
+
247
+ - **Ambition and Success**: Drive to achieve greatness
248
+ - **Genius and Madness**: Talent and its costs
249
+ - **Redemption**: Overcoming past or finding meaning
250
+ - **Legacy**: What we leave behind
251
+ - **Individual vs. System**: Fighting institutions or norms
252
+
253
+ ### Compatible Styles
254
+
255
+ - **Traditional Biopic**: Straightforward life story (The King's Speech, The Theory of Everything)
256
+ - **Stylized Biopic**: Artistic interpretation (Raging Bull, I'm Not There)
257
+ - **Ensemble Biopic**: Multiple perspectives (The Social Network, I, Tonya)
258
+ - **Musical Biopic**: Musicians' lives (Walk the Line, Bohemian Rhapsody)
259
+
260
+ ### Hybrid Combinations
261
+
262
+ - **Biopic + Drama**: Character-driven life stories (Capote, The Aviator)
263
+ - **Biopic + Thriller**: Dangerous lives (Catch Me If You Can, American Gangster)
264
+ - **Biopic + Musical**: Musicians and performers (Ray, Rocketman)
265
+ - **Biopic + Historical**: Historical figures (Lincoln, Gandhi)
266
+
267
+ ## Best Practices
268
+
269
+ 1. **Find the Arc**: Specific period or theme, not entire life
270
+ 2. **Humanize the Subject**: Flaws and complexity, not worship
271
+ 3. **Thematic Focus**: What is this life really about?
272
+ 4. **Active Supporting Cast**: Fully realized characters around subject
273
+ 5. **Show the Work**: Dramatize achievements, don't explain them
274
+ 6. **Emotional Truth**: Essence over literal accuracy
275
+ 7. **Universal Themes**: Specific life illuminating shared humanity
276
+ 8. **Avoid Greatest Hits**: Select moments that reveal character
277
+ 9. **Research Deeply**: Know the subject intimately
278
+ 10. **Respect Complexity**: Real people are contradictory
279
+
280
+ ## Resources
281
+
282
+ - "The Art of Adaptation" by Linda Seger - Includes biopic structure
283
+ - "Raging Bull" screenplay by Paul Schrader and Mardik Martin
284
+ - "The Social Network" screenplay by Aaron Sorkin - Modern biopic masterclass
285
+ - "Into the Wild" by Jon Krakauer - Biographical narrative structure
286
+ - "Steve Jobs" screenplay by Aaron Sorkin - Three-act structure in real-time
287
+
288
+ ---
289
+
290
+ **Depth Coverage**: 85%
291
+ **Last Updated**: 2026-01-31
292
+ **Version**: 1.0.0
293
+
@@ -0,0 +1,401 @@
1
+ # Comedy Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Comedy films prioritize humor, laughter, and entertainment through wit, physical gags, situational irony, and character-based humor. The genre emphasizes timing, surprise, and the subversion of expectations.
10
+
11
+ ## Core Concept
12
+
13
+ Comedy screenplays are built around creating laughter through character flaws, misunderstandings, absurd situations, or clever wordplay. Success depends on establishing a comedic tone early, maintaining consistent logic within the absurdity, and balancing humor with genuine emotion or stakes.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Establish the Comedic Tone Immediately
18
+
19
+ **Description**: The first 5-10 pages must signal to the audience what kind of comedy this is and what to expect.
20
+
21
+ **Why It Matters**: Audiences need to calibrate their expectations. Tonal confusion kills comedy.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: Opening scene demonstrates the specific type of humor (slapstick, witty banter, awkward situations)
25
+ - ❌ **Bad**: First 20 pages are serious drama, then comedy appears randomly
26
+
27
+ **Film Reference**: Airplane! (1980) - Absurdist humor established in the first minute.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Comedy Comes from Character
32
+
33
+ **Description**: The funniest moments arise from characters behaving consistently with their established personalities, not from random jokes.
34
+
35
+ **Why It Matters**: Character-based comedy is sustainable and emotionally resonant. Random jokes feel disconnected.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: Uptight character's rigid behavior creates humor in chaotic situations
39
+ - ❌ **Bad**: Characters act out of character just to deliver a punchline
40
+
41
+ **Film Reference**: The Big Lebowski (1998) - The Dude's laid-back personality creates humor in every situation.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Rule of Three
46
+
47
+ **Description**: Comedic patterns work best in threes - setup, reinforcement, payoff/subversion.
48
+
49
+ **Why It Matters**: Two is predictable, four is repetitive. Three is the sweet spot for comedic rhythm.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Character fails twice in similar ways, third attempt succeeds in unexpected manner
53
+ - ❌ **Bad**: Same joke repeated five times with no variation
54
+
55
+ **Film Reference**: Hot Fuzz (2007) - "The greater good" repeated three times for comedic effect.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Escalate the Absurdity
60
+
61
+ **Description**: Each comedic set piece should be more outrageous than the last, while maintaining internal logic.
62
+
63
+ **Why It Matters**: Escalation maintains energy and prevents the comedy from feeling flat or repetitive.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Small lie → bigger lie to cover first lie → elaborate scheme to maintain lies → complete chaos
67
+ - ❌ **Bad**: Same level of absurdity throughout with no escalation
68
+
69
+ **Film Reference**: Liar Liar (1997) - Jim Carrey's inability to lie escalates from minor to catastrophic.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Subvert Expectations
74
+
75
+ **Description**: Set up audience expectations, then deliver something unexpected but logical in hindsight.
76
+
77
+ **Why It Matters**: Surprise is essential to comedy. Predictable jokes aren't funny.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Setup suggests one outcome, deliver a different but equally logical outcome
81
+ - ❌ **Bad**: Telegraphed punchlines the audience sees coming
82
+
83
+ **Film Reference**: Monty Python and the Holy Grail (1975) - Constant subversion of medieval epic expectations.
84
+
85
+ ---
86
+
87
+ ### Rule 6: Ground Comedy in Truth
88
+
89
+ **Description**: Even absurd comedy should be rooted in recognizable human behavior, emotions, or situations.
90
+
91
+ **Why It Matters**: Audiences connect with truth. Grounded comedy is more relatable and sustainable.
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Exaggerated version of real awkward social situations
95
+ - ❌ **Bad**: Random absurdity with no connection to reality
96
+
97
+ **Film Reference**: The Office (2005-2013) - Workplace comedy grounded in real office dynamics.
98
+
99
+ ---
100
+
101
+ ### Rule 7: Timing is Everything
102
+
103
+ **Description**: Comedic beats need proper setup, breathing room, and precise delivery timing on the page.
104
+
105
+ **Why It Matters**: Rushed or poorly timed jokes fall flat. White space and pacing create rhythm.
106
+
107
+ **Examples**:
108
+ - ✅ **Good**: Setup... brief pause... punchline. New paragraph for reaction.
109
+ - ❌ **Bad**: Setup and punchline crammed together with no breathing room
110
+
111
+ **Film Reference**: Arrested Development (2003-2019) - Masterful comedic timing and callbacks.
112
+
113
+ ---
114
+
115
+ ### Rule 8: Create Comedic Conflict
116
+
117
+ **Description**: Comedy should arise from genuine conflict between characters, goals, or values.
118
+
119
+ **Why It Matters**: Conflict creates stakes and makes the comedy meaningful, not just random gags.
120
+
121
+ **Examples**:
122
+ - ✅ **Good**: Two characters with opposing goals forced to work together
123
+ - ❌ **Bad**: Characters tell jokes at each other with no real conflict
124
+
125
+ **Film Reference**: The Odd Couple (1968) - Conflict between neat freak and slob drives all comedy.
126
+
127
+ ---
128
+
129
+ ### Rule 9: Balance Humor with Heart
130
+
131
+ **Description**: Audiences need to care about characters and outcomes, not just laugh at them.
132
+
133
+ **Why It Matters**: Pure mockery becomes mean. Emotional investment makes comedy more satisfying.
134
+
135
+ **Examples**:
136
+ - ✅ **Good**: We laugh with characters we care about, not just at them
137
+ - ❌ **Bad**: Characters are punching bags with no depth or sympathy
138
+
139
+ **Film Reference**: Groundhog Day (1993) - Bill Murray's character growth gives comedy emotional weight.
140
+
141
+ ---
142
+
143
+ ### Rule 10: Maintain Internal Logic
144
+
145
+ **Description**: Even in absurd comedy, the world must follow its own established rules consistently.
146
+
147
+ **Why It Matters**: Inconsistent logic feels lazy. Consistent absurdity is funnier.
148
+
149
+ **Examples**:
150
+ - ✅ **Good**: If magic exists, it follows specific rules that create comedic situations
151
+ - ❌ **Bad**: Rules change based on what's convenient for the joke
152
+
153
+ **Film Reference**: Ghostbusters (1984) - Supernatural elements follow consistent rules that enable comedy.
154
+
155
+ ---
156
+
157
+ ## Guidelines
158
+
159
+ ### Structure
160
+
161
+ - **Act I**: Establish comedic tone, introduce flawed protagonist, inciting incident creates comedic situation (pages 1-25)
162
+ - **Act II**: Escalating comedic complications, character's flaws make things worse, false victory, all seems lost (pages 25-85)
163
+ - **Act III**: Final comedic set piece, character growth resolves situation, emotional payoff (pages 85-110)
164
+
165
+ ### Pacing
166
+
167
+ - Joke or comedic moment every page (at minimum)
168
+ - Major comedic set piece every 10-15 pages
169
+ - Vary joke types (verbal, physical, situational, character-based)
170
+ - Allow brief emotional beats between major comedic sequences
171
+ - Build to biggest laugh in climax
172
+
173
+ ### Character Archetypes
174
+
175
+ - **Protagonist**: Flawed but likable, often oblivious to their own ridiculousness
176
+ - **Straight Man**: Reacts to absurdity, grounds the comedy
177
+ - **Comic Relief**: Intentionally funny character (use sparingly in comedy - everyone should be funny)
178
+ - **Antagonist**: Often uptight, rigid, or representing what protagonist must overcome
179
+
180
+ ### Tone and Atmosphere
181
+
182
+ - Consistent comedic voice throughout
183
+ - Optimistic and playful
184
+ - Self-aware without being meta (unless that's the style)
185
+ - Energetic pacing
186
+ - Subgenre-specific (slapstick vs. witty vs. dark comedy)
187
+
188
+ ### Visual Style
189
+
190
+ - Physical comedy requires clear staging
191
+ - Reaction shots are crucial
192
+ - Visual gags in background
193
+ - Exaggerated but readable expressions
194
+ - Timing indicated through white space and formatting
195
+
196
+ ### Dialogue
197
+
198
+ - Wit and wordplay
199
+ - Subtext and irony
200
+ - Callbacks and running gags
201
+ - Rhythm and musicality
202
+ - Character-specific speech patterns that create humor
203
+
204
+ ## Common Pitfalls
205
+
206
+ ### Pitfall 1: Jokes Without Story
207
+
208
+ **Problem**: String of unconnected gags with no narrative throughline.
209
+
210
+ **Solution**: Every joke should serve character or plot. Comedy enhances story, doesn't replace it.
211
+
212
+ **Example**: Jokes arise from character trying to achieve their goal, not random asides.
213
+
214
+ ---
215
+
216
+ ### Pitfall 2: Mean-Spirited Humor
217
+
218
+ **Problem**: Laughing at characters' pain without empathy or growth.
219
+
220
+ **Solution**: Make characters sympathetic. Earn the right to mock them by making them human first.
221
+
222
+ **Example**: We laugh at their mistakes because we relate, not because we're cruel.
223
+
224
+ ---
225
+
226
+ ### Pitfall 3: Explaining the Joke
227
+
228
+ **Problem**: Characters or narration explain why something is funny.
229
+
230
+ **Solution**: Trust the audience. If a joke needs explanation, it's not working.
231
+
232
+ **Example**: Let the situation speak for itself. Cut any line that says "That's funny because..."
233
+
234
+ ---
235
+
236
+ ### Pitfall 4: Inconsistent Tone
237
+
238
+ **Problem**: Shifting between comedy styles or mixing comedy with drama clumsily.
239
+
240
+ **Solution**: Establish your comedic voice early and maintain it. Emotional moments should feel earned, not jarring.
241
+
242
+ **Example**: Dramedy requires careful balance - don't undercut serious moments with inappropriate jokes.
243
+
244
+ ---
245
+
246
+ ### Pitfall 5: Relying on References
247
+
248
+ **Problem**: Jokes depend entirely on pop culture references that will date quickly.
249
+
250
+ **Solution**: Use references sparingly. Focus on character and situation-based humor that's timeless.
251
+
252
+ **Example**: Character-based humor from Groundhog Day still works decades later; topical references from 1993 don't.
253
+
254
+ ---
255
+
256
+ ## Film Examples
257
+
258
+ ### Example 1: Groundhog Day (1993)
259
+
260
+ **Director**: Harold Ramis
261
+
262
+ **Why It Works**: High-concept premise, character growth, perfect balance of humor and heart.
263
+
264
+ **Key Scenes**:
265
+ - **First Loop**: Establishes the comedic premise
266
+ - **Montage of Attempts**: Escalating absurdity as Phil tries different approaches
267
+ - **Piano Lesson**: Emotional depth beneath the comedy
268
+
269
+ **Techniques Used**:
270
+ - Repetition with variation
271
+ - Character transformation through comedy
272
+ - Grounded fantasy premise
273
+ - Emotional payoff
274
+
275
+ ---
276
+
277
+ ### Example 2: The Big Lebowski (1998)
278
+
279
+ **Director**: Joel and Ethan Coen
280
+
281
+ **Why It Works**: Unique characters, quotable dialogue, absurd situations grounded in character.
282
+
283
+ **Key Scenes**:
284
+ - **Rug Peed On**: Inciting incident is perfectly absurd
285
+ - **Bowling Alley**: Character dynamics create constant humor
286
+ - **Dream Sequence**: Surreal comedy that fits the tone
287
+
288
+ **Techniques Used**:
289
+ - Character-based humor
290
+ - Quotable dialogue
291
+ - Absurdist situations
292
+ - Consistent tone
293
+
294
+ ---
295
+
296
+ ### Example 3: Airplane! (1980)
297
+
298
+ **Director**: Jim Abrahams, David Zucker, Jerry Zucker
299
+
300
+ **Why It Works**: Rapid-fire jokes, visual gags, parody done right, commitment to absurdity.
301
+
302
+ **Key Scenes**:
303
+ - **"Don't call me Shirley"**: Wordplay and deadpan delivery
304
+ - **Autopilot**: Visual gag taken to extreme
305
+ - **"I picked the wrong week to quit smoking"**: Running gag escalation
306
+
307
+ **Techniques Used**:
308
+ - Joke density (multiple jokes per page)
309
+ - Deadpan delivery of absurdity
310
+ - Visual and verbal gags layered
311
+ - Parody with love for source material
312
+
313
+ ---
314
+
315
+ ### Example 4: Bridesmaids (2011)
316
+
317
+ **Director**: Paul Feig
318
+
319
+ **Why It Works**: Female-driven comedy, emotional authenticity, mix of crude and heartfelt humor.
320
+
321
+ **Key Scenes**:
322
+ - **Bridal Shop Food Poisoning**: Physical comedy with character stakes
323
+ - **Airplane Freakout**: Escalating absurdity from character flaw
324
+ - **Reconciliation**: Emotional payoff earned through comedy
325
+
326
+ **Techniques Used**:
327
+ - Character flaws drive comedy
328
+ - Balance crude and sweet
329
+ - Female friendship as foundation
330
+ - Emotional stakes
331
+
332
+ ---
333
+
334
+ ### Example 5: Hot Fuzz (2007)
335
+
336
+ **Director**: Edgar Wright
337
+
338
+ **Why It Works**: Genre parody, visual comedy, tight plotting, callbacks and payoffs.
339
+
340
+ **Key Scenes**:
341
+ - **Paperwork Montage**: Action movie editing for mundane tasks
342
+ - **"The greater good"**: Running gag with payoff
343
+ - **Final Shootout**: Action parody with comedic commitment
344
+
345
+ **Techniques Used**:
346
+ - Visual comedy and editing
347
+ - Setup and payoff
348
+ - Genre awareness
349
+ - Commitment to premise
350
+
351
+ ---
352
+
353
+ ## Integration with Other Features
354
+
355
+ ### Compatible Themes
356
+
357
+ - **Growth**: Character learns through comedic mistakes (Groundhog Day)
358
+ - **Love**: Romantic comedy (When Harry Met Sally)
359
+ - **Identity**: Character discovers themselves through humor (Tootsie)
360
+ - **Friendship**: Bonds formed through shared absurdity (Superbad)
361
+
362
+ ### Compatible Styles
363
+
364
+ - **Linear**: Traditional comedy structure (most comedies)
365
+ - **Ensemble**: Multiple comedic characters (The Hangover)
366
+ - **Satirical**: Social commentary through humor (Dr. Strangelove)
367
+
368
+ ### Hybrid Combinations
369
+
370
+ - **Rom-Com**: Romance + Comedy (When Harry Met Sally, The Proposal)
371
+ - **Action-Comedy**: Action + Comedy (Rush Hour, The Nice Guys)
372
+ - **Horror-Comedy**: Horror + Comedy (Shaun of the Dead, What We Do in the Shadows)
373
+ - **Dramedy**: Drama + Comedy (Little Miss Sunshine, The Royal Tenenbaums)
374
+
375
+ ## Best Practices
376
+
377
+ 1. **Establish tone in first 5 pages** - Audience needs to know what kind of comedy to expect
378
+ 2. **Make characters funny, not just situations** - Character-based comedy is sustainable
379
+ 3. **Use the rule of three** - Setup, reinforcement, payoff/subversion
380
+ 4. **Escalate the absurdity** - Each set piece should top the last
381
+ 5. **Ground comedy in truth** - Exaggerate reality, don't abandon it
382
+ 6. **Balance humor with heart** - Audiences need to care, not just laugh
383
+ 7. **Vary your joke types** - Mix verbal, physical, situational, and character-based humor
384
+ 8. **Trust the audience** - Don't explain jokes or telegraph punchlines
385
+ 9. **Maintain internal logic** - Even absurd worlds need consistent rules
386
+ 10. **Rewrite for rhythm** - Comedy is about timing; read dialogue aloud
387
+
388
+ ## Resources
389
+
390
+ - "The Comic Toolbox" by John Vorhaus
391
+ - "Writing the Comedy Film" by Stuart Voytilla and Scott Petri
392
+ - "Poking a Dead Frog" by Mike Sacks
393
+ - "The Hidden Tools of Comedy" by Steve Kaplan
394
+ - Study: Groundhog Day, The Big Lebowski, Airplane!, Bridesmaids, Hot Fuzz, Arrested Development
395
+
396
+ ---
397
+
398
+ **Depth Coverage**: 85%
399
+ **Last Updated**: 2026-01-31
400
+ **Version**: 1.0.0
401
+