@mytechtoday/augment-extensions 0.7.0 → 1.2.1

package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md

@@ -1,293 +1,293 @@
-# Superhero Genre
-
-**Category**: Screenplay Genre  
-**Type**: Primary  
-**Complexity**: Medium
-
-## Overview
-
-Superhero films feature characters with extraordinary abilities fighting threats to protect others. The genre emphasizes spectacle, moral responsibility, and the tension between power and humanity.
-
-## Core Concept
-
-Superhero screenplays explore what it means to have power and the responsibility that comes with it. Success depends on balancing spectacular action with character development, creating villains who challenge the hero thematically, and grounding fantastical elements in relatable human emotions. Great superhero films use powers as metaphors for real human struggles and ask what it means to be heroic.
-
-## Core Rules
-
-### Rule 1: Power Must Come with Cost
-
-**Description**: Superpowers should have limitations, costs, or consequences. Perfect power is dramatically inert.
-
-**Why It Matters**: Limitations create tension and stakes. Unlimited power makes conflict meaningless.
-
-**Examples**:
-- ✅ **Good**: Powers drain energy, have moral costs, or create personal sacrifices
-- ❌ **Bad**: Unlimited powers that solve every problem easily
-
-**Film Reference**: Spider-Man 2 (2004) - Powers interfere with Peter's personal life and relationships.
-
----
-
-### Rule 2: The Hero's Journey is Personal
-
-**Description**: Becoming a hero should involve internal transformation, not just gaining powers.
-
-**Why It Matters**: Powers are external. Character growth is what makes the journey meaningful.
-
-**Examples**:
-- ✅ **Good**: Hero learns responsibility, overcomes fear, or accepts their role
-- ❌ **Bad**: Character unchanged except for having powers
-
-**Film Reference**: Iron Man (2008) - Tony Stark's transformation from selfish to selfless.
-
----
-
-### Rule 3: Villain Mirrors Hero Thematically
-
-**Description**: Antagonist should represent dark reflection or ideological opposite of hero, not just obstacle.
-
-**Why It Matters**: Thematic opposition creates deeper conflict than just physical threat.
-
-**Examples**:
-- ✅ **Good**: Villain embodies what hero could become or represents opposing philosophy
-- ❌ **Bad**: Generic bad guy with no thematic connection to hero
-
-**Film Reference**: Black Panther (2018) - Killmonger represents valid critique of T'Challa's isolationism.
-
----
-
-### Rule 4: Ground the Fantastic in Human Emotion
-
-**Description**: No matter how spectacular the powers, story must center on relatable human feelings and relationships.
-
-**Why It Matters**: Audiences connect with humanity, not spectacle. Emotion makes powers meaningful.
-
-**Examples**:
-- ✅ **Good**: Powers complicate relationships, create moral dilemmas, or reflect internal struggles
-- ❌ **Bad**: Cool powers with no emotional or relational impact
-
-**Film Reference**: The Incredibles (2004) - Superhero family dealing with very human family dynamics.
-
----
-
-### Rule 5: Earn the Spectacle
-
-**Description**: Big action set pieces should be emotional climaxes, not just visual effects showcases.
-
-**Why It Matters**: Spectacle without stakes is empty. The biggest battles should be the biggest emotional moments.
-
-**Examples**:
-- ✅ **Good**: Final battle tests hero's growth and resolves thematic conflict
-- ❌ **Bad**: Generic CGI battle with no emotional investment
-
-**Film Reference**: The Dark Knight (2008) - Ferry scene tests Batman's belief in humanity's goodness.
-
----
-
-## Guidelines
-
-### Structure
-
-- **Act I**: Origin (or status quo), call to heroism, initial failure or reluctance
-- **Act II**: Training/growth, escalating threats, personal costs of heroism, dark night of the soul
-- **Act III**: Final confrontation testing growth, sacrifice, resolution of personal and external conflict
-
-### Pacing
-
-- Balance action with character development
-- Build to bigger set pieces
-- Use quiet moments for emotional beats
-- Montages for training or power discovery
-- Climax combines spectacle with emotional resolution
-
-### Character Archetypes
-
-- **Protagonist**: Ordinary person gaining powers or powered person learning humanity
-- **Antagonist**: Villain with opposing ideology or dark mirror of hero
-- **Supporting**: Mentor, love interest, sidekick, ordinary people hero protects
-
-### Tone and Atmosphere
-
-- Can range from dark (The Dark Knight) to light (Shazam!)
-- Sense of wonder at powers
-- Moral seriousness about responsibility
-- Hope and inspiration
-- Often epic in scope
-
-### Visual Style
-
-- Spectacular action and effects
-- Iconic imagery and costumes
-- Dynamic camera work for action
-- Color palette reflecting tone
-- Visual contrast between powered and ordinary
-
-### Dialogue
-
-- Balance quips with sincerity
-- Thematic discussions of power and responsibility
-- Avoid over-explaining powers
-- Character-specific voices
-- Inspirational speeches earned through journey
-
-## Common Pitfalls
-
-### Pitfall 1: Spectacle Over Story
-
-**Problem**: Prioritizing visual effects and action over character development and emotional stakes.
-
-**Solution**: Use spectacle to serve emotional story. Every action beat should have character purpose.
-
-**Example**: Logan (2017) - Intimate character study with superhero elements.
-
----
-
-### Pitfall 2: Invincible Hero
-
-**Problem**: Hero so powerful that there's no real threat or tension.
-
-**Solution**: Create limitations, personal stakes, or moral dilemmas that powers can't solve.
-
-**Example**: Superman (1978) - Kryptonite and protecting Lois create vulnerability.
-
----
-
-### Pitfall 3: Generic World-Ending Threat
-
-**Problem**: Every film ends with stopping apocalypse, making stakes feel repetitive and abstract.
-
-**Solution**: Personal stakes matter more than scale. Smaller, character-driven conflicts can be more engaging.
-
-**Example**: Spider-Man 2 (2004) - Saving city but real stakes are Peter's identity and relationships.
-
----
-
-## Film Examples
-
-### Example 1: The Dark Knight (2008)
-
-**Director**: Christopher Nolan
-
-**Why It Works**: Superhero film as crime thriller. Joker tests Batman's moral code and Gotham's soul.
-
-**Key Scenes**:
-- **Ferry Scene**: Testing humanity's goodness
-- **Interrogation**: Ideological battle between Batman and Joker
-- **Harvey Dent's Fall**: Corruption of white knight
-
-**Techniques Used**:
-- Grounded, realistic approach to superhero
-- Villain as ideological opposite (chaos vs. order)
-- Moral dilemmas powers can't solve
-- Tragic ending despite victory
-
----
-
-### Example 2: Iron Man (2008)
-
-**Director**: Jon Favreau
-
-**Why It Works**: Origin story with character transformation. Selfish billionaire becomes selfless hero.
-
-**Key Scenes**:
-- **Cave Escape**: Birth of Iron Man from trauma
-- **"I am Iron Man"**: Rejecting secret identity
-- **Afghanistan Return**: Using power for justice
-
-**Techniques Used**:
-- Character arc from selfish to heroic
-- Grounded sci-fi technology
-- Charismatic performance (RDJ)
-- Personal stakes (Stark's legacy and redemption)
-
----
-
-### Example 3: Black Panther (2018)
-
-**Director**: Ryan Coogler
-
-**Why It Works**: Superhero film as political drama. Isolationism vs. intervention, tradition vs. change.
-
-**Key Scenes**:
-- **Ancestral Plane**: Confronting father's failures
-- **Killmonger's Challenge**: Legitimate critique of T'Challa's worldview
-- **"Bury me in the ocean with my ancestors"**: Villain's tragic nobility
-
-**Techniques Used**:
-- Villain with valid perspective
-- Political and cultural themes
-- Afrofuturism and world-building
-- Hero grows by accepting villain's critique
-
----
-
-### Example 4: Spider-Man 2 (2004)
-
-**Director**: Sam Raimi
-
-**Why It Works**: Powers as burden. Responsibility vs. personal happiness. Relatable struggles.
-
-**Key Scenes**:
-- **"I'm Spider-Man no more"**: Giving up powers for normal life
-- **Train Fight**: Heroism revealed to public
-- **"Sometimes to do what's right, we have to give up what we want most"**: Theme stated
-
-**Techniques Used**:
-- Powers interfere with personal life
-- Hero questions calling
-- Villain (Doc Ock) as tragic figure
-- Emotional stakes matter more than spectacle
-
----
-
-## Integration with Other Features
-
-### Compatible Themes
-
-- **Power and Responsibility**: Central superhero theme
-- **Identity**: Secret identities and dual lives
-- **Sacrifice**: Heroism requires giving up
-- **Justice vs. Vengeance**: Moral lines
-- **Outsider**: Different from normal people
-
-### Compatible Styles
-
-- **Grounded Superhero**: Realistic approach (The Dark Knight, Logan)
-- **Cosmic Superhero**: Space and gods (Thor, Guardians of the Galaxy)
-- **Street-Level**: Urban crime-fighting (Daredevil, Spider-Man)
-- **Team Superhero**: Ensemble (The Avengers, X-Men)
-
-### Hybrid Combinations
-
-- **Superhero + Thriller**: Espionage and suspense (Captain America: Winter Soldier)
-- **Superhero + Comedy**: Humor-driven (Guardians of the Galaxy, Shazam!)
-- **Superhero + Horror**: Dark and scary (Brightburn, The New Mutants)
-- **Superhero + Drama**: Character-focused (Logan, Joker)
-
-## Best Practices
-
-1. **Power Has Cost**: Limitations and consequences
-2. **Personal Journey**: Internal transformation, not just powers
-3. **Thematic Villain**: Antagonist mirrors or opposes hero's values
-4. **Human Emotion**: Ground fantastic in relatable feelings
-5. **Earn Spectacle**: Big action serves emotional story
-6. **Moral Responsibility**: What does it mean to be heroic?
-7. **Personal Stakes**: Relationships and identity matter
-8. **Origin Matters**: How hero becomes hero shapes who they are
-9. **Sacrifice**: Heroism requires giving up something
-10. **Hope and Inspiration**: Superhero stories should uplift
-
-## Resources
-
-- "The Hero with a Thousand Faces" by Joseph Campbell - Hero's journey
-- "Superman on the Couch" by Danny Fingeroth - Psychology of superheroes
-- "The Dark Knight" screenplay by Jonathan Nolan and Christopher Nolan
-- "Black Panther" screenplay by Ryan Coogler and Joe Robert Cole
-- Marvel and DC comics - Source material and storytelling techniques
-
----
-
-**Depth Coverage**: 85%
-**Last Updated**: 2026-01-31
-**Version**: 1.0.0
-
+# Superhero Genre
+
+**Category**: Screenplay Genre  
+**Type**: Primary  
+**Complexity**: Medium
+
+## Overview
+
+Superhero films feature characters with extraordinary abilities fighting threats to protect others. The genre emphasizes spectacle, moral responsibility, and the tension between power and humanity.
+
+## Core Concept
+
+Superhero screenplays explore what it means to have power and the responsibility that comes with it. Success depends on balancing spectacular action with character development, creating villains who challenge the hero thematically, and grounding fantastical elements in relatable human emotions. Great superhero films use powers as metaphors for real human struggles and ask what it means to be heroic.
+
+## Core Rules
+
+### Rule 1: Power Must Come with Cost
+
+**Description**: Superpowers should have limitations, costs, or consequences. Perfect power is dramatically inert.
+
+**Why It Matters**: Limitations create tension and stakes. Unlimited power makes conflict meaningless.
+
+**Examples**:
+- ✅ **Good**: Powers drain energy, have moral costs, or create personal sacrifices
+- ❌ **Bad**: Unlimited powers that solve every problem easily
+
+**Film Reference**: Spider-Man 2 (2004) - Powers interfere with Peter's personal life and relationships.
+
+---
+
+### Rule 2: The Hero's Journey is Personal
+
+**Description**: Becoming a hero should involve internal transformation, not just gaining powers.
+
+**Why It Matters**: Powers are external. Character growth is what makes the journey meaningful.
+
+**Examples**:
+- ✅ **Good**: Hero learns responsibility, overcomes fear, or accepts their role
+- ❌ **Bad**: Character unchanged except for having powers
+
+**Film Reference**: Iron Man (2008) - Tony Stark's transformation from selfish to selfless.
+
+---
+
+### Rule 3: Villain Mirrors Hero Thematically
+
+**Description**: Antagonist should represent dark reflection or ideological opposite of hero, not just obstacle.
+
+**Why It Matters**: Thematic opposition creates deeper conflict than just physical threat.
+
+**Examples**:
+- ✅ **Good**: Villain embodies what hero could become or represents opposing philosophy
+- ❌ **Bad**: Generic bad guy with no thematic connection to hero
+
+**Film Reference**: Black Panther (2018) - Killmonger represents valid critique of T'Challa's isolationism.
+
+---
+
+### Rule 4: Ground the Fantastic in Human Emotion
+
+**Description**: No matter how spectacular the powers, story must center on relatable human feelings and relationships.
+
+**Why It Matters**: Audiences connect with humanity, not spectacle. Emotion makes powers meaningful.
+
+**Examples**:
+- ✅ **Good**: Powers complicate relationships, create moral dilemmas, or reflect internal struggles
+- ❌ **Bad**: Cool powers with no emotional or relational impact
+
+**Film Reference**: The Incredibles (2004) - Superhero family dealing with very human family dynamics.
+
+---
+
+### Rule 5: Earn the Spectacle
+
+**Description**: Big action set pieces should be emotional climaxes, not just visual effects showcases.
+
+**Why It Matters**: Spectacle without stakes is empty. The biggest battles should be the biggest emotional moments.
+
+**Examples**:
+- ✅ **Good**: Final battle tests hero's growth and resolves thematic conflict
+- ❌ **Bad**: Generic CGI battle with no emotional investment
+
+**Film Reference**: The Dark Knight (2008) - Ferry scene tests Batman's belief in humanity's goodness.
+
+---
+
+## Guidelines
+
+### Structure
+
+- **Act I**: Origin (or status quo), call to heroism, initial failure or reluctance
+- **Act II**: Training/growth, escalating threats, personal costs of heroism, dark night of the soul
+- **Act III**: Final confrontation testing growth, sacrifice, resolution of personal and external conflict
+
+### Pacing
+
+- Balance action with character development
+- Build to bigger set pieces
+- Use quiet moments for emotional beats
+- Montages for training or power discovery
+- Climax combines spectacle with emotional resolution
+
+### Character Archetypes
+
+- **Protagonist**: Ordinary person gaining powers or powered person learning humanity
+- **Antagonist**: Villain with opposing ideology or dark mirror of hero
+- **Supporting**: Mentor, love interest, sidekick, ordinary people hero protects
+
+### Tone and Atmosphere
+
+- Can range from dark (The Dark Knight) to light (Shazam!)
+- Sense of wonder at powers
+- Moral seriousness about responsibility
+- Hope and inspiration
+- Often epic in scope
+
+### Visual Style
+
+- Spectacular action and effects
+- Iconic imagery and costumes
+- Dynamic camera work for action
+- Color palette reflecting tone
+- Visual contrast between powered and ordinary
+
+### Dialogue
+
+- Balance quips with sincerity
+- Thematic discussions of power and responsibility
+- Avoid over-explaining powers
+- Character-specific voices
+- Inspirational speeches earned through journey
+
+## Common Pitfalls
+
+### Pitfall 1: Spectacle Over Story
+
+**Problem**: Prioritizing visual effects and action over character development and emotional stakes.
+
+**Solution**: Use spectacle to serve emotional story. Every action beat should have character purpose.
+
+**Example**: Logan (2017) - Intimate character study with superhero elements.
+
+---
+
+### Pitfall 2: Invincible Hero
+
+**Problem**: Hero so powerful that there's no real threat or tension.
+
+**Solution**: Create limitations, personal stakes, or moral dilemmas that powers can't solve.
+
+**Example**: Superman (1978) - Kryptonite and protecting Lois create vulnerability.
+
+---
+
+### Pitfall 3: Generic World-Ending Threat
+
+**Problem**: Every film ends with stopping apocalypse, making stakes feel repetitive and abstract.
+
+**Solution**: Personal stakes matter more than scale. Smaller, character-driven conflicts can be more engaging.
+
+**Example**: Spider-Man 2 (2004) - Saving city but real stakes are Peter's identity and relationships.
+
+---
+
+## Film Examples
+
+### Example 1: The Dark Knight (2008)
+
+**Director**: Christopher Nolan
+
+**Why It Works**: Superhero film as crime thriller. Joker tests Batman's moral code and Gotham's soul.
+
+**Key Scenes**:
+- **Ferry Scene**: Testing humanity's goodness
+- **Interrogation**: Ideological battle between Batman and Joker
+- **Harvey Dent's Fall**: Corruption of white knight
+
+**Techniques Used**:
+- Grounded, realistic approach to superhero
+- Villain as ideological opposite (chaos vs. order)
+- Moral dilemmas powers can't solve
+- Tragic ending despite victory
+
+---
+
+### Example 2: Iron Man (2008)
+
+**Director**: Jon Favreau
+
+**Why It Works**: Origin story with character transformation. Selfish billionaire becomes selfless hero.
+
+**Key Scenes**:
+- **Cave Escape**: Birth of Iron Man from trauma
+- **"I am Iron Man"**: Rejecting secret identity
+- **Afghanistan Return**: Using power for justice
+
+**Techniques Used**:
+- Character arc from selfish to heroic
+- Grounded sci-fi technology
+- Charismatic performance (RDJ)
+- Personal stakes (Stark's legacy and redemption)
+
+---
+
+### Example 3: Black Panther (2018)
+
+**Director**: Ryan Coogler
+
+**Why It Works**: Superhero film as political drama. Isolationism vs. intervention, tradition vs. change.
+
+**Key Scenes**:
+- **Ancestral Plane**: Confronting father's failures
+- **Killmonger's Challenge**: Legitimate critique of T'Challa's worldview
+- **"Bury me in the ocean with my ancestors"**: Villain's tragic nobility
+
+**Techniques Used**:
+- Villain with valid perspective
+- Political and cultural themes
+- Afrofuturism and world-building
+- Hero grows by accepting villain's critique
+
+---
+
+### Example 4: Spider-Man 2 (2004)
+
+**Director**: Sam Raimi
+
+**Why It Works**: Powers as burden. Responsibility vs. personal happiness. Relatable struggles.
+
+**Key Scenes**:
+- **"I'm Spider-Man no more"**: Giving up powers for normal life
+- **Train Fight**: Heroism revealed to public
+- **"Sometimes to do what's right, we have to give up what we want most"**: Theme stated
+
+**Techniques Used**:
+- Powers interfere with personal life
+- Hero questions calling
+- Villain (Doc Ock) as tragic figure
+- Emotional stakes matter more than spectacle
+
+---
+
+## Integration with Other Features
+
+### Compatible Themes
+
+- **Power and Responsibility**: Central superhero theme
+- **Identity**: Secret identities and dual lives
+- **Sacrifice**: Heroism requires giving up
+- **Justice vs. Vengeance**: Moral lines
+- **Outsider**: Different from normal people
+
+### Compatible Styles
+
+- **Grounded Superhero**: Realistic approach (The Dark Knight, Logan)
+- **Cosmic Superhero**: Space and gods (Thor, Guardians of the Galaxy)
+- **Street-Level**: Urban crime-fighting (Daredevil, Spider-Man)
+- **Team Superhero**: Ensemble (The Avengers, X-Men)
+
+### Hybrid Combinations
+
+- **Superhero + Thriller**: Espionage and suspense (Captain America: Winter Soldier)
+- **Superhero + Comedy**: Humor-driven (Guardians of the Galaxy, Shazam!)
+- **Superhero + Horror**: Dark and scary (Brightburn, The New Mutants)
+- **Superhero + Drama**: Character-focused (Logan, Joker)
+
+## Best Practices
+
+1. **Power Has Cost**: Limitations and consequences
+2. **Personal Journey**: Internal transformation, not just powers
+3. **Thematic Villain**: Antagonist mirrors or opposes hero's values
+4. **Human Emotion**: Ground fantastic in relatable feelings
+5. **Earn Spectacle**: Big action serves emotional story
+6. **Moral Responsibility**: What does it mean to be heroic?
+7. **Personal Stakes**: Relationships and identity matter
+8. **Origin Matters**: How hero becomes hero shapes who they are
+9. **Sacrifice**: Heroism requires giving up something
+10. **Hope and Inspiration**: Superhero stories should uplift
+
+## Resources
+
+- "The Hero with a Thousand Faces" by Joseph Campbell - Hero's journey
+- "Superman on the Couch" by Danny Fingeroth - Psychology of superheroes
+- "The Dark Knight" screenplay by Jonathan Nolan and Christopher Nolan
+- "Black Panther" screenplay by Ryan Coogler and Joe Robert Cole
+- Marvel and DC comics - Source material and storytelling techniques
+
+---
+
+**Depth Coverage**: 85%
+**Last Updated**: 2026-01-31
+**Version**: 1.0.0
+