@mytechtoday/augment-extensions 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) 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 +26 -1
  172. package/cli/dist/cli.js.map +1 -1
  173. package/cli/dist/commands/show.d.ts +19 -0
  174. package/cli/dist/commands/show.d.ts.map +1 -1
  175. package/cli/dist/commands/show.js +495 -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/gui-helpers.d.ts +23 -0
  182. package/cli/dist/utils/gui-helpers.d.ts.map +1 -0
  183. package/cli/dist/utils/gui-helpers.js +159 -0
  184. package/cli/dist/utils/gui-helpers.js.map +1 -0
  185. package/cli/dist/utils/module-system.d.ts +80 -1
  186. package/cli/dist/utils/module-system.d.ts.map +1 -1
  187. package/cli/dist/utils/module-system.js +388 -16
  188. package/cli/dist/utils/module-system.js.map +1 -1
  189. package/modules.md +44 -2
  190. package/package.json +6 -4
@@ -0,0 +1,293 @@
1
+ # Documentary Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Documentaries present factual content about real people, events, or issues. The genre emphasizes truth-telling, research, and compelling narrative structure applied to non-fiction material.
10
+
11
+ ## Core Concept
12
+
13
+ Documentary screenplays (or treatments/outlines) structure real-world material into compelling narratives. Success depends on thorough research, finding the story within facts, ethical representation of subjects, and using cinematic techniques to engage audiences with reality. Great documentaries reveal truth while entertaining and enlightening.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Find the Narrative
18
+
19
+ **Description**: Real life doesn't naturally follow story structure. You must find or shape the narrative arc within factual material.
20
+
21
+ **Why It Matters**: Even non-fiction needs dramatic structure to engage audiences.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: Identify protagonist, conflict, stakes, and resolution within real events
25
+ - ❌ **Bad**: Chronological recitation of facts with no dramatic shape
26
+
27
+ **Film Reference**: Man on Wire (2008) - Philippe Petit's tightrope walk structured as heist film.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Maintain Ethical Integrity
32
+
33
+ **Description**: Represent subjects and facts honestly. Don't manipulate reality to create false narratives.
34
+
35
+ **Why It Matters**: Documentary's power comes from truth. Deception destroys credibility and harms subjects.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: Present multiple perspectives, acknowledge complexity, transparent about methods
39
+ - ❌ **Bad**: Deceptive editing, misrepresenting subjects, fabricating events
40
+
41
+ **Film Reference**: The Act of Killing (2012) - Controversial but transparent about its methods and perspective.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Show, Don't Just Tell
46
+
47
+ **Description**: Use visual evidence, observational footage, and cinematic techniques, not just talking heads.
48
+
49
+ **Why It Matters**: Documentary is cinema, not radio. Visual storytelling engages more than interviews alone.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Vérité footage, archival material, visual metaphors, observational sequences
53
+ - ❌ **Bad**: Endless talking heads explaining everything
54
+
55
+ **Film Reference**: Free Solo (2018) - Stunning cinematography of climbing makes the stakes visceral.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Establish Stakes and Tension
60
+
61
+ **Description**: Make clear what's at risk and create suspense, even when outcome may be known.
62
+
63
+ **Why It Matters**: Documentaries need dramatic tension to maintain engagement.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Clear stakes (life, justice, truth), obstacles, ticking clocks
67
+ - ❌ **Bad**: Interesting subject but no dramatic tension or stakes
68
+
69
+ **Film Reference**: Grizzly Man (2005) - Tension from knowing tragic outcome while watching journey.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Have a Point of View
74
+
75
+ **Description**: Documentary should have perspective or thesis, not just present information neutrally.
76
+
77
+ **Why It Matters**: Perspective creates argument and engagement. Pure objectivity is impossible and often boring.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Clear perspective while acknowledging complexity
81
+ - ❌ **Bad**: Wishy-washy "both sides" that says nothing
82
+
83
+ **Film Reference**: 13th (2016) - Clear thesis about mass incarceration and racial injustice.
84
+
85
+ ---
86
+
87
+ ## Guidelines
88
+
89
+ ### Structure
90
+
91
+ - **Act I**: Introduce subject/issue, establish stakes, present central question or conflict
92
+ - **Act II**: Investigation/exploration, complications, revelations, deepening understanding
93
+ - **Act III**: Climax or resolution (or acknowledgment of ongoing situation), reflection on meaning
94
+
95
+ ### Pacing
96
+
97
+ - Vary between talking heads, vérité, archival, and visual sequences
98
+ - Build tension toward revelations or climactic moments
99
+ - Use music and editing for emotional pacing
100
+ - Allow quiet moments for reflection
101
+ - Structure around dramatic beats, not just chronology
102
+
103
+ ### Character Archetypes
104
+
105
+ - **Protagonist**: Central subject or filmmaker as investigator
106
+ - **Antagonist**: Opposition, system, or problem being examined
107
+ - **Supporting**: Experts, witnesses, affected parties
108
+
109
+ ### Tone and Atmosphere
110
+
111
+ - Varies by subject (investigative, celebratory, elegiac, urgent)
112
+ - Often serious but can include humor
113
+ - Intimate or epic depending on scope
114
+ - Emotional engagement with real stakes
115
+ - Sense of discovery or revelation
116
+
117
+ ### Visual Style
118
+
119
+ - Vérité (observational, handheld)
120
+ - Formal interviews (controlled lighting, composition)
121
+ - Archival footage and photos
122
+ - Reenactments (if used, clearly marked)
123
+ - Visual metaphors and b-roll
124
+
125
+ ### Dialogue
126
+
127
+ - Interview questions (often removed in final cut)
128
+ - Natural speech from subjects
129
+ - Voiceover narration (filmmaker or subject)
130
+ - Minimal scripting - capture authentic voices
131
+ - Let subjects tell their own stories
132
+
133
+ ## Common Pitfalls
134
+
135
+ ### Pitfall 1: Talking Heads Syndrome
136
+
137
+ **Problem**: Relying entirely on interviews with no visual storytelling.
138
+
139
+ **Solution**: Use vérité footage, archival material, visual sequences to show the story.
140
+
141
+ **Example**: The Thin Blue Line (1988) - Stylized reenactments and visual sequences beyond interviews.
142
+
143
+ ---
144
+
145
+ ### Pitfall 2: Lack of Access or Footage
146
+
147
+ **Problem**: Important events or subjects unavailable, forcing reliance on description.
148
+
149
+ **Solution**: Use creative solutions - reenactments, animation, archival, or acknowledge limitations.
150
+
151
+ **Example**: Waltz with Bashir (2008) - Animated documentary when footage doesn't exist.
152
+
153
+ ---
154
+
155
+ ### Pitfall 3: Losing Objectivity
156
+
157
+ **Problem**: Becoming so invested in thesis that you ignore contradictory evidence or manipulate facts.
158
+
159
+ **Solution**: Present strongest version of opposing views, acknowledge complexity, be transparent about perspective.
160
+
161
+ **Example**: The Fog of War (2003) - Lets Robert McNamara speak extensively, revealing complexity.
162
+
163
+ ---
164
+
165
+ ## Film Examples
166
+
167
+ ### Example 1: Hoop Dreams (1994)
168
+
169
+ **Director**: Steve James
170
+
171
+ **Why It Works**: Five-year vérité following two basketball players. Epic scope, intimate character study.
172
+
173
+ **Key Scenes**:
174
+ - **Recruitment**: Dreams and exploitation
175
+ - **Injuries and Setbacks**: Reality crushing dreams
176
+ - **Graduation**: Bittersweet resolution
177
+
178
+ **Techniques Used**:
179
+ - Long-term observational filming
180
+ - Character-driven narrative structure
181
+ - Social commentary through personal stories
182
+ - No narration - subjects tell their own stories
183
+
184
+ ---
185
+
186
+ ### Example 2: Man on Wire (2008)
187
+
188
+ **Director**: James Marsh
189
+
190
+ **Why It Works**: Philippe Petit's World Trade Center tightrope walk structured as heist thriller.
191
+
192
+ **Key Scenes**:
193
+ - **Planning**: Heist film structure
194
+ - **The Walk**: Archival photos create suspense
195
+ - **Aftermath**: Reflection on meaning
196
+
197
+ **Techniques Used**:
198
+ - Heist film structure for documentary
199
+ - Reenactments integrated with interviews
200
+ - Archival photos as climax
201
+ - Suspense despite known outcome
202
+
203
+ ---
204
+
205
+ ### Example 3: 13th (2016)
206
+
207
+ **Director**: Ava DuVernay
208
+
209
+ **Why It Works**: Powerful thesis about mass incarceration and racial injustice. Clear argument with extensive evidence.
210
+
211
+ **Key Scenes**:
212
+ - **13th Amendment Loophole**: Central thesis established
213
+ - **Historical Montage**: Visual evidence of systemic racism
214
+ - **Modern Prison System**: Connecting past to present
215
+
216
+ **Techniques Used**:
217
+ - Archival footage as evidence
218
+ - Expert interviews building argument
219
+ - Clear thesis and structure
220
+ - Historical analysis with contemporary relevance
221
+
222
+ ---
223
+
224
+ ### Example 4: Free Solo (2018)
225
+
226
+ **Director**: Elizabeth Chai Vasarhelyi, Jimmy Chin
227
+
228
+ **Why It Works**: Stunning cinematography of Alex Honnold's El Capitan climb. Life-or-death stakes.
229
+
230
+ **Key Scenes**:
231
+ - **Practice Falls**: Establishing danger
232
+ - **Relationship Tension**: Personal stakes
233
+ - **The Climb**: Breathtaking, terrifying climax
234
+
235
+ **Techniques Used**:
236
+ - Incredible cinematography of climbing
237
+ - Character study alongside athletic achievement
238
+ - Building suspense toward known event
239
+ - Ethical questions about filming dangerous activity
240
+
241
+ ---
242
+
243
+ ## Integration with Other Features
244
+
245
+ ### Compatible Themes
246
+
247
+ - **Truth and Justice**: Investigative documentaries
248
+ - **Human Achievement**: Sports, art, exploration
249
+ - **Social Issues**: Activism and change
250
+ - **Nature**: Environmental and wildlife
251
+ - **History**: Past events and their meaning
252
+
253
+ ### Compatible Styles
254
+
255
+ - **Vérité**: Observational, fly-on-wall (Hoop Dreams, Minding the Gap)
256
+ - **Investigative**: Uncovering truth (The Thin Blue Line, Citizenfour)
257
+ - **Essay Film**: Personal reflection (Sherman's March, Stories We Tell)
258
+ - **Archive-Based**: Historical events (The Fog of War, Amy)
259
+
260
+ ### Hybrid Combinations
261
+
262
+ - **Documentary + Thriller**: Investigative suspense (Citizenfour, Icarus)
263
+ - **Documentary + Biography**: Life stories (Won't You Be My Neighbor?, RBG)
264
+ - **Documentary + Nature**: Wildlife and environment (Planet Earth, My Octopus Teacher)
265
+ - **Documentary + Music**: Musicians and performances (20 Feet from Stardom, Summer of Soul)
266
+
267
+ ## Best Practices
268
+
269
+ 1. **Find the Story**: Narrative structure within facts
270
+ 2. **Ethical Representation**: Honesty and transparency
271
+ 3. **Visual Storytelling**: Show don't just tell
272
+ 4. **Establish Stakes**: What's at risk?
273
+ 5. **Have a Perspective**: Point of view, not false neutrality
274
+ 6. **Vary Visual Approach**: Mix interviews, vérité, archival
275
+ 7. **Build Tension**: Dramatic structure even in non-fiction
276
+ 8. **Respect Subjects**: Represent people fairly and complexly
277
+ 9. **Research Thoroughly**: Know your subject deeply
278
+ 10. **Acknowledge Limitations**: Be transparent about what you don't know
279
+
280
+ ## Resources
281
+
282
+ - "Introduction to Documentary" by Bill Nichols
283
+ - "Directing the Documentary" by Michael Rabiger
284
+ - "The Documentary Handbook" by Peter Lee-Wright
285
+ - "Man with a Movie Camera" (1929) - Pioneering documentary techniques
286
+ - "The Act of Killing" - Controversial, innovative documentary approach
287
+
288
+ ---
289
+
290
+ **Depth Coverage**: 85%
291
+ **Last Updated**: 2026-01-31
292
+ **Version**: 1.0.0
293
+
@@ -0,0 +1,409 @@
1
+ # Drama Genre
2
+
3
+ **Category**: Screenplay Genre
4
+ **Type**: Primary
5
+ **Complexity**: High
6
+
7
+ ## Overview
8
+
9
+ Drama films focus on realistic characters facing emotional conflicts, moral dilemmas, and personal struggles. The genre emphasizes character development, authentic relationships, and meaningful themes over spectacle or plot mechanics.
10
+
11
+ ## Core Concept
12
+
13
+ Drama screenplays are built around characters confronting difficult truths, making hard choices, and experiencing genuine emotional transformation. Success depends on creating complex, believable characters, authentic dialogue, and situations that resonate with universal human experiences.
14
+
15
+ ## Core Rules
16
+
17
+ ### Rule 1: Character is Plot
18
+
19
+ **Description**: In drama, what happens is less important than how it affects the characters and what it reveals about them.
20
+
21
+ **Why It Matters**: Drama is character-driven. External events serve internal journeys, not vice versa.
22
+
23
+ **Examples**:
24
+ - ✅ **Good**: A family dinner reveals long-buried resentments and forces confrontation
25
+ - ❌ **Bad**: Action-packed events with no character impact or growth
26
+
27
+ **Film Reference**: Manchester by the Sea (2016) - Every plot point reveals character and deepens emotional complexity.
28
+
29
+ ---
30
+
31
+ ### Rule 2: Establish Authentic Emotional Stakes
32
+
33
+ **Description**: The audience must understand and care deeply about what the character stands to lose or gain emotionally.
34
+
35
+ **Why It Matters**: Without genuine emotional investment, drama becomes melodrama or feels hollow.
36
+
37
+ **Examples**:
38
+ - ✅ **Good**: A parent fighting to maintain relationship with their child
39
+ - ❌ **Bad**: Generic conflict with no emotional specificity
40
+
41
+ **Film Reference**: Kramer vs. Kramer (1979) - Custody battle grounded in authentic parental love and growth.
42
+
43
+ ---
44
+
45
+ ### Rule 3: Show Internal Conflict Externally
46
+
47
+ **Description**: Make internal struggles visible through behavior, choices, and dialogue rather than exposition.
48
+
49
+ **Why It Matters**: Film is a visual medium. Internal conflict must manifest in observable ways.
50
+
51
+ **Examples**:
52
+ - ✅ **Good**: Character's addiction shown through missed appointments, broken promises, physical deterioration
53
+ - ❌ **Bad**: Character tells therapist about their internal struggles in exposition-heavy scenes
54
+
55
+ **Film Reference**: Requiem for a Dream (2000) - Addiction's internal grip shown through escalating external consequences.
56
+
57
+ ---
58
+
59
+ ### Rule 4: Create Moral Complexity
60
+
61
+ **Description**: Avoid simple good vs. evil. Give characters understandable motivations even when they make wrong choices.
62
+
63
+ **Why It Matters**: Moral complexity creates richer drama and more realistic characters. Real people are contradictory.
64
+
65
+ **Examples**:
66
+ - ✅ **Good**: Antagonist has valid grievances and relatable motivations
67
+ - ❌ **Bad**: Villain is evil for evil's sake with no depth
68
+
69
+ **Film Reference**: There Will Be Blood (2007) - Daniel Plainview is compelling despite being morally compromised.
70
+
71
+ ---
72
+
73
+ ### Rule 5: Build Through Subtext
74
+
75
+ **Description**: Characters should rarely say exactly what they mean. Meaning lives beneath the surface of dialogue.
76
+
77
+ **Why It Matters**: Subtext creates depth, realism, and engagement. People in real life avoid direct confrontation.
78
+
79
+ **Examples**:
80
+ - ✅ **Good**: Couple argues about dishes when really discussing their failing marriage
81
+ - ❌ **Bad**: Characters explicitly state their feelings and motivations constantly
82
+
83
+ **Film Reference**: Revolutionary Road (2008) - Suburban pleasantries mask deep dissatisfaction and rage.
84
+
85
+ ---
86
+
87
+ ### Rule 6: Earn Emotional Moments
88
+
89
+ **Description**: Big emotional beats must be set up through careful character development and escalation.
90
+
91
+ **Why It Matters**: Unearned emotion feels manipulative. Audiences resent being told how to feel.
92
+
93
+ **Examples**:
94
+ - ✅ **Good**: Breakdown comes after accumulation of specific, relatable pressures
95
+ - ❌ **Bad**: Character cries in scene 3 before we know or care about them
96
+
97
+ **Film Reference**: Moonlight (2016) - Every emotional moment earned through careful character building.
98
+
99
+ ---
100
+
101
+ ### Rule 7: Use Specificity Over Generality
102
+
103
+ **Description**: Ground drama in specific details of time, place, culture, and character rather than generic situations.
104
+
105
+ **Why It Matters**: Specificity creates authenticity and universality. Generic feels false.
106
+
107
+ **Examples**:
108
+ - ✅ **Good**: Working-class Boston family with specific cultural touchstones and speech patterns
109
+ - ❌ **Bad**: Generic "family" with no cultural or regional identity
110
+
111
+ **Film Reference**: Fences (2016) - Specific African American experience in 1950s Pittsburgh creates universal themes.
112
+
113
+ ---
114
+
115
+ ### Rule 8: Escalate Emotional Pressure
116
+
117
+ **Description**: Each scene should increase the emotional stakes or pressure on the protagonist.
118
+
119
+ **Why It Matters**: Drama needs momentum. Flat emotional energy loses audience engagement.
120
+
121
+ **Examples**:
122
+ - ✅ **Good**: Small lie → bigger lie → confrontation → revelation → consequences
123
+ - ❌ **Bad**: Same level of conflict throughout with no escalation
124
+
125
+ **Film Reference**: A Marriage Story (2019) - Divorce proceedings escalate from civil to devastating.
126
+
127
+ ---
128
+
129
+ ### Rule 9: Create Moments of Grace
130
+
131
+ **Description**: Balance heavy drama with moments of beauty, humor, or human connection.
132
+
133
+ **Why It Matters**: Relentless darkness becomes numbing. Contrast makes drama more powerful.
134
+
135
+ **Examples**:
136
+ - ✅ **Good**: Grieving family shares a genuine laugh remembering the deceased
137
+ - ❌ **Bad**: Two hours of unrelenting misery with no light
138
+
139
+ **Film Reference**: The Florida Project (2017) - Childhood wonder and play amid poverty and dysfunction.
140
+
141
+ ---
142
+
143
+ ### Rule 10: Resolve Emotionally, Not Just Plotwise
144
+
145
+ **Description**: The ending must provide emotional resolution or meaningful change, even if plot threads remain open.
146
+
147
+ **Why It Matters**: Drama is about emotional journeys. Plot resolution without emotional payoff feels empty.
148
+
149
+ **Examples**:
150
+ - ✅ **Good**: Character doesn't get what they wanted but achieves understanding or acceptance
151
+ - ❌ **Bad**: All plot points tied up but character unchanged and unaffected
152
+
153
+ **Film Reference**: Lady Bird (2017) - Plot ends with college, but emotional resolution is mother-daughter understanding.
154
+
155
+ ---
156
+
157
+ ## Guidelines
158
+
159
+ ### Structure
160
+
161
+ - **Act I**: Establish character's world, relationships, and internal conflict; inciting incident disrupts status quo (pages 1-25)
162
+ - **Act II**: Character confronts conflict, makes choices that complicate situation, relationships tested, crisis point (pages 25-85)
163
+ - **Act III**: Final confrontation with self or others, emotional climax, resolution or acceptance (pages 85-110)
164
+
165
+ ### Pacing
166
+
167
+ - Allow scenes to breathe - drama needs time for emotional beats
168
+ - Build tension through character interaction, not just plot events
169
+ - Use quiet moments strategically
170
+ - Escalate emotional stakes gradually
171
+ - Climax should be emotional peak, not necessarily action peak
172
+
173
+ ### Character Archetypes
174
+
175
+ - **Protagonist**: Flawed, complex, relatable, facing internal and external conflict
176
+ - **Antagonist**: Often another complex character with opposing needs (not evil villain)
177
+ - **Supporting**: Mirror protagonist's journey, offer contrast, or represent different choices
178
+ - **Confidant**: Character protagonist can be honest with (therapist, friend, mentor)
179
+
180
+ ### Tone and Atmosphere
181
+
182
+ - Realistic and grounded
183
+ - Emotionally authentic
184
+ - Serious but not necessarily humorless
185
+ - Intimate and character-focused
186
+ - Subgenre-specific (family drama vs. courtroom drama vs. addiction drama)
187
+
188
+ ### Visual Style
189
+
190
+ - Naturalistic lighting and cinematography
191
+ - Close-ups for emotional moments
192
+ - Environment reflects character's internal state
193
+ - Minimal stylization (unless serving theme)
194
+ - Focus on faces and reactions
195
+
196
+ ### Dialogue
197
+
198
+ - Subtext-heavy
199
+ - Character-specific voices
200
+ - Realistic speech patterns (interruptions, pauses, fragments)
201
+ - Avoid exposition dumps
202
+ - What's NOT said is often more important than what is
203
+
204
+ ## Common Pitfalls
205
+
206
+ ### Pitfall 1: Melodrama
207
+
208
+ **Problem**: Over-the-top emotions, contrived situations, or manipulative music cues instead of earned drama.
209
+
210
+ **Solution**: Ground emotions in specific, believable circumstances. Trust the audience to feel without forcing it.
211
+
212
+ **Example**: Character's quiet devastation is more powerful than theatrical breakdown.
213
+
214
+ ---
215
+
216
+ ### Pitfall 2: Talking Heads
217
+
218
+ **Problem**: Scenes of people sitting and talking with no visual interest or subtext.
219
+
220
+ **Solution**: Give characters activities, use environment, create visual metaphors, employ subtext.
221
+
222
+ **Example**: Difficult conversation happens while packing boxes, cooking dinner, or walking - activity adds layers.
223
+
224
+ ---
225
+
226
+ ### Pitfall 3: Passive Protagonist
227
+
228
+ **Problem**: Things happen TO the character rather than the character making active choices.
229
+
230
+ **Solution**: Give protagonist agency. Even in difficult circumstances, they must make choices that drive the story.
231
+
232
+ **Example**: Character chooses to confront their past rather than being forced into it by circumstances.
233
+
234
+ ---
235
+
236
+ ### Pitfall 4: Unearned Resolution
237
+
238
+ **Problem**: Character suddenly changes or problem resolves without sufficient development or consequence.
239
+
240
+ **Solution**: Transformation must be gradual and hard-won. Show the work of change.
241
+
242
+ **Example**: Addict's recovery shown through specific struggles and setbacks, not sudden epiphany.
243
+
244
+ ---
245
+
246
+ ### Pitfall 5: Lack of Specificity
247
+
248
+ **Problem**: Generic characters in generic situations saying generic things.
249
+
250
+ **Solution**: Research, observe, and create specific details of culture, class, region, profession, era.
251
+
252
+ **Example**: Don't write "a family" - write "a second-generation Korean-American family running a laundromat in 1980s Los Angeles."
253
+
254
+ ---
255
+
256
+ ## Film Examples
257
+
258
+ ### Example 1: Manchester by the Sea (2016)
259
+
260
+ **Director**: Kenneth Lonergan
261
+
262
+ **Why It Works**: Devastating emotional honesty, complex protagonist, authentic grief, earned moments.
263
+
264
+ **Key Scenes**:
265
+ - **Flashback Revelation**: Reveals Lee's trauma through carefully structured flashbacks
266
+ - **Hospital Confrontation**: Lee's inability to forgive himself shown through rejection of ex-wife's forgiveness
267
+ - **Final Scene**: Emotional resolution without false hope
268
+
269
+ **Techniques Used**:
270
+ - Non-linear structure reveals character gradually
271
+ - Subtext in every scene
272
+ - Humor balances grief
273
+ - Specific cultural and regional details
274
+ - Quiet devastation over melodrama
275
+
276
+ ---
277
+
278
+ ### Example 2: Moonlight (2016)
279
+
280
+ **Director**: Barry Jenkins
281
+
282
+ **Why It Works**: Three-act structure showing character at different life stages, visual poetry, restrained emotion.
283
+
284
+ **Key Scenes**:
285
+ - **Swimming Lesson**: Tenderness and mentorship
286
+ - **Diner Confrontation**: Chiron's transformation and suppressed emotion
287
+ - **Final Reunion**: Vulnerability and connection
288
+
289
+ **Techniques Used**:
290
+ - Triptych structure (three life stages)
291
+ - Visual storytelling over dialogue
292
+ - Specific cultural context
293
+ - Intimacy and restraint
294
+ - Color and music as emotional language
295
+
296
+ ---
297
+
298
+ ### Example 3: A Marriage Story (2019)
299
+
300
+ **Director**: Noah Baumbach
301
+
302
+ **Why It Works**: Authentic portrayal of divorce, complex characters both right and wrong, escalating conflict.
303
+
304
+ **Key Scenes**:
305
+ - **Opening Montages**: What they love about each other (never spoken aloud)
306
+ - **Argument Scene**: Escalation from civil to devastating
307
+ - **Shoe-Tying**: Small gesture of lingering care
308
+
309
+ **Techniques Used**:
310
+ - Dual perspective (both characters sympathetic)
311
+ - Escalating conflict
312
+ - Specific details of marriage and divorce
313
+ - Humor amid pain
314
+ - Small moments carry weight
315
+
316
+ ---
317
+
318
+ ### Example 4: The Florida Project (2017)
319
+
320
+ **Director**: Sean Baker
321
+
322
+ **Why It Works**: Child's perspective on poverty, beauty in hardship, non-judgmental observation.
323
+
324
+ **Key Scenes**:
325
+ - **Ice Cream**: Small kindness amid struggle
326
+ - **Final Confrontation**: Mother's desperation
327
+ - **Ending**: Childhood imagination as escape
328
+
329
+ **Techniques Used**:
330
+ - Child's POV creates distance and intimacy
331
+ - Vibrant colors contrast with subject matter
332
+ - Non-professional actors add authenticity
333
+ - Observational style
334
+ - Empathy without sentimentality
335
+
336
+ ---
337
+
338
+ ### Example 5: There Will Be Blood (2007)
339
+
340
+ **Director**: Paul Thomas Anderson
341
+
342
+ **Why It Works**: Epic scope with intimate character study, moral complexity, visual storytelling.
343
+
344
+ **Key Scenes**:
345
+ - **Opening Sequence**: Wordless character establishment
346
+ - **Milkshake Speech**: Culmination of rivalry and greed
347
+ - **Final Confrontation**: Moral degradation complete
348
+
349
+ **Techniques Used**:
350
+ - Visual storytelling (minimal dialogue early)
351
+ - Character as force of nature
352
+ - Historical specificity
353
+ - Moral complexity
354
+ - Operatic scope with intimate focus
355
+
356
+ ---
357
+
358
+ ## Integration with Other Features
359
+
360
+ ### Compatible Themes
361
+
362
+ - **Redemption**: Character seeks to atone (The Wrestler)
363
+ - **Identity**: Character discovers or accepts self (Moonlight)
364
+ - **Love**: Relationships tested and transformed (Blue Valentine)
365
+ - **Betrayal**: Trust broken and consequences (The Godfather Part II)
366
+ - **Growth**: Character matures through hardship (Lady Bird)
367
+
368
+ ### Compatible Styles
369
+
370
+ - **Linear**: Traditional dramatic structure (most dramas)
371
+ - **Non-Linear**: Flashbacks reveal character (Manchester by the Sea)
372
+ - **Ensemble**: Multiple character perspectives (Magnolia)
373
+ - **Minimalist**: Stripped-down, focused drama (45 Years)
374
+
375
+ ### Hybrid Combinations
376
+
377
+ - **Courtroom Drama**: Legal framework for moral questions (A Few Good Men)
378
+ - **Family Drama**: Domestic conflicts (August: Osage County)
379
+ - **Historical Drama**: Personal stories in historical context (12 Years a Slave)
380
+ - **Addiction Drama**: Substance abuse and recovery (Requiem for a Dream)
381
+ - **Coming-of-Age Drama**: Youth and maturation (Boyhood)
382
+
383
+ ## Best Practices
384
+
385
+ 1. **Start with character, not plot** - Know who they are before deciding what happens
386
+ 2. **Create specific, not generic** - Details of culture, class, region make drama universal
387
+ 3. **Show, don't tell** - Internal conflict must manifest externally
388
+ 4. **Earn every emotion** - Build to big moments through careful development
389
+ 5. **Use subtext constantly** - People rarely say what they mean
390
+ 6. **Make characters complex** - Everyone is the hero of their own story
391
+ 7. **Balance darkness with light** - Moments of grace make drama more powerful
392
+ 8. **Let scenes breathe** - Drama needs time for emotional beats
393
+ 9. **Escalate emotional stakes** - Each scene should increase pressure
394
+ 10. **Resolve emotionally** - Plot resolution without emotional payoff is empty
395
+
396
+ ## Resources
397
+
398
+ - "The Art of Dramatic Writing" by Lajos Egri
399
+ - "Writing Drama" by Yves Lavandier
400
+ - "The Anatomy of Story" by John Truby
401
+ - "Screenplay" by Syd Field
402
+ - Study: Manchester by the Sea, Moonlight, A Marriage Story, The Florida Project, There Will Be Blood
403
+
404
+ ---
405
+
406
+ **Depth Coverage**: 85%
407
+ **Last Updated**: 2026-01-31
408
+ **Version**: 1.0.0
409
+