@mytechtoday/augment-extensions 0.4.0 → 0.7.0

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

@@ -0,0 +1,293 @@
+# Western Genre
+
+**Category**: Screenplay Genre  
+**Type**: Primary  
+**Complexity**: Medium
+
+## Overview
+
+Westerns are set in the American frontier (typically 1860s-1900s) and explore themes of civilization vs. wilderness, law vs. lawlessness, and individual freedom vs. community. The genre emphasizes moral codes, violence, and the mythology of the Old West.
+
+## Core Concept
+
+Western screenplays explore the tension between the untamed frontier and encroaching civilization, often through morally complex protagonists navigating a world where formal law is absent or corrupt. Success depends on authentic period detail, strong moral conflicts, and exploration of American mythology. Great westerns use the frontier setting to examine timeless themes of justice, honor, and what it means to be civilized.
+
+## Core Rules
+
+### Rule 1: Establish a Clear Moral Code
+
+**Description**: Protagonist must have a personal code of honor, even if it conflicts with law or society.
+
+**Why It Matters**: In lawless frontier, personal codes define character. The code creates internal conflict and guides decisions.
+
+**Examples**:
+- ✅ **Good**: Gunslinger with strict rules about when violence is justified
+- ❌ **Bad**: Character with no consistent values or principles
+
+**Film Reference**: High Noon (1952) - Marshal's duty to protect town despite being abandoned by citizens.
+
+---
+
+### Rule 2: Civilization vs. Wilderness
+
+**Description**: Explore the tension between frontier freedom and the order/restrictions of civilization.
+
+**Why It Matters**: This is the central thematic conflict of the western genre.
+
+**Examples**:
+- ✅ **Good**: Outlaw struggling with settling down vs. life on the run
+- ❌ **Bad**: Setting is Old West but themes could be anywhere/anytime
+
+**Film Reference**: The Man Who Shot Liberty Valance (1962) - Law and education vs. gun violence.
+
+---
+
+### Rule 3: Make Violence Consequential
+
+**Description**: Gunfights and violence should have weight, cost, and moral implications, not be casual entertainment.
+
+**Why It Matters**: Violence defines the frontier. It must matter and affect characters deeply.
+
+**Examples**:
+- ✅ **Good**: Each killing haunts the protagonist or changes them
+- ❌ **Bad**: Dozens killed with no emotional or moral impact
+
+**Film Reference**: Unforgiven (1992) - Violence is brutal, unglamorous, and psychologically damaging.
+
+---
+
+### Rule 4: Use the Landscape
+
+**Description**: The harsh, beautiful frontier landscape should be a character itself, shaping the story and characters.
+
+**Why It Matters**: The West's vastness, danger, and beauty are essential to the genre's identity.
+
+**Examples**:
+- ✅ **Good**: Desert, mountains, or plains create obstacles, isolation, and visual grandeur
+- ❌ **Bad**: Could be filmed on a soundstage; landscape is irrelevant
+
+**Film Reference**: The Searchers (1956) - Monument Valley's epic vistas reflect the protagonist's isolation and obsession.
+
+---
+
+### Rule 5: Subvert or Honor Mythology
+
+**Description**: Either embrace the romantic mythology of the Old West or deliberately deconstruct it, but be intentional.
+
+**Why It Matters**: Westerns exist in dialogue with their own mythology. Acknowledge this relationship.
+
+**Examples**:
+- ✅ **Good**: Revisionist western questioning heroic myths, or classical western celebrating them
+- ❌ **Bad**: Unaware of genre conventions and mythology
+
+**Film Reference**: Django Unchained (2012) - Uses western tropes to explore slavery and revenge.
+
+---
+
+## Guidelines
+
+### Structure
+
+- **Act I**: Establish frontier setting, introduce protagonist's code, inciting incident disrupts status quo
+- **Act II**: Conflict escalates, protagonist's code tested, community or personal stakes rise, preparation for confrontation
+- **Act III**: Final showdown (often gunfight), resolution of moral conflict, new order established or protagonist rides off
+
+### Pacing
+
+- Deliberate, patient pacing with sudden bursts of violence
+- Build tension through standoffs and confrontations
+- Use landscape and silence for atmosphere
+- Climactic gunfight or showdown
+- Denouement showing new equilibrium
+
+### Character Archetypes
+
+- **Protagonist**: Gunslinger, lawman, outlaw, or drifter with personal code
+- **Antagonist**: Outlaw gang, corrupt rancher, or lawless force
+- **Supporting**: Schoolteacher/civilizing influence, saloon owner, Native Americans, townspeople, sidekick
+
+### Tone and Atmosphere
+
+- Rugged, harsh, unforgiving
+- Moral seriousness and weight
+- Can be elegiac, violent, or mythic
+- Isolation and self-reliance
+- Honor and masculinity (often examined critically in modern westerns)
+
+### Visual Style
+
+- Wide shots emphasizing landscape and isolation
+- Natural lighting and dusty, muted colors
+- Iconic imagery: horses, guns, saloons, main street showdowns
+- Use of horizon lines and vast spaces
+- Close-ups for tense confrontations
+
+### Dialogue
+
+- Laconic, economical speech
+- Subtext and what's left unsaid
+- Period-appropriate language without being archaic
+- Threats and challenges delivered calmly
+- Silence used effectively
+
+## Common Pitfalls
+
+### Pitfall 1: Romanticizing Problematic Elements
+
+**Problem**: Uncritically celebrating violence, sexism, or racism inherent in Old West mythology.
+
+**Solution**: Acknowledge historical realities while exploring moral complexities. Modern westerns can examine these issues critically.
+
+**Example**: The Power of the Dog (2021) - Examines toxic masculinity and repressed sexuality in western context.
+
+---
+
+### Pitfall 2: Inauthentic Period Detail
+
+**Problem**: Anachronistic language, technology, or social attitudes that break immersion.
+
+**Solution**: Research period thoroughly. Details should feel lived-in and authentic.
+
+**Example**: True Grit (2010) - Authentic period language and detail without feeling stilted.
+
+---
+
+### Pitfall 3: Ignoring Native American Perspectives
+
+**Problem**: Portraying Native Americans as one-dimensional savages or noble savages without complexity.
+
+**Solution**: Treat all characters as fully realized humans with motivations, culture, and agency.
+
+**Example**: Dances with Wolves (1990) - Lakota characters portrayed with depth, culture, and humanity.
+
+---
+
+## Film Examples
+
+### Example 1: The Good, the Bad and the Ugly (1966)
+
+**Director**: Sergio Leone
+
+**Why It Works**: Epic spaghetti western with iconic imagery, moral ambiguity, and operatic scope.
+
+**Key Scenes**:
+- **Three-Way Standoff**: Tension through silence, close-ups, and Morricone score
+- **Civil War Battle**: Futility of war contrasted with treasure hunt
+- **Final Duel**: Choreographed showdown as ballet of violence
+
+**Techniques Used**:
+- Extreme close-ups and wide shots
+- Iconic Ennio Morricone score
+- Morally ambiguous protagonists
+- Epic scope and runtime
+
+---
+
+### Example 2: Unforgiven (1992)
+
+**Director**: Clint Eastwood
+
+**Why It Works**: Revisionist western deconstructing myths of heroic gunfighters. Violence is ugly and damaging.
+
+**Key Scenes**:
+- **"Deserve's got nothing to do with it"**: Killing without glory
+- **Ned's Death**: Consequences of violence for innocent
+- **Final Shootout**: Brutal, efficient, haunted
+
+**Techniques Used**:
+- Aging gunfighter confronting past
+- Violence portrayed as traumatic, not heroic
+- Deconstruction of western mythology
+- Moral complexity and regret
+
+---
+
+### Example 3: True Grit (2010)
+
+**Director**: Coen Brothers
+
+**Why It Works**: Classical western with authentic period detail, strong female protagonist, and themes of justice and vengeance.
+
+**Key Scenes**:
+- **Mattie's Negotiation**: Young girl's determination and intelligence
+- **River Crossing**: Harsh frontier conditions
+- **Snake Pit Rescue**: Sacrifice and consequences
+
+**Techniques Used**:
+- Authentic period language from novel
+- Female protagonist driving narrative
+- Harsh realism of frontier life
+- Justice vs. vengeance theme
+
+---
+
+### Example 4: No Country for Old Men (2007)
+
+**Director**: Coen Brothers
+
+**Why It Works**: Modern neo-western exploring violence, fate, and changing times. Western themes in contemporary setting.
+
+**Key Scenes**:
+- **Coin Toss**: Fate and chance determine life and death
+- **Motel Shootout**: Violence erupts suddenly, brutally
+- **Sheriff's Monologue**: Old values in changing world
+
+**Techniques Used**:
+- Western archetypes in modern Texas
+- Unstoppable force (Chigurh) as antagonist
+- Moral man (Sheriff) unable to stop violence
+- Themes of aging and obsolescence
+
+---
+
+## Integration with Other Features
+
+### Compatible Themes
+
+- **Justice vs. Revenge**: Personal codes in lawless land
+- **Civilization vs. Wilderness**: Order vs. freedom
+- **Redemption**: Violent past seeking atonement
+- **Honor and Duty**: Personal codes and sacrifice
+- **Obsolescence**: Old ways dying out
+
+### Compatible Styles
+
+- **Classical Western**: Heroic myths and clear morality (John Ford)
+- **Spaghetti Western**: Stylized, morally ambiguous (Sergio Leone)
+- **Revisionist Western**: Deconstructing myths (Unforgiven, Deadwood)
+- **Neo-Western**: Western themes in modern settings (No Country for Old Men, Hell or High Water)
+
+### Hybrid Combinations
+
+- **Western + Horror**: Supernatural frontier (Bone Tomahawk, The Burrowers)
+- **Western + Sci-Fi**: Space westerns (Star Wars, Firefly)
+- **Western + Comedy**: Comedic takes on genre (Blazing Saddles, A Million Ways to Die in the West)
+- **Western + Drama**: Character-driven frontier stories (The Assassination of Jesse James)
+
+## Best Practices
+
+1. **Establish Personal Code**: Protagonist's moral compass in lawless world
+2. **Use the Landscape**: Frontier as character and obstacle
+3. **Make Violence Matter**: Consequences and moral weight
+4. **Period Authenticity**: Research language, technology, social norms
+5. **Explore Central Tension**: Civilization vs. wilderness
+6. **Subtext in Dialogue**: Say less, mean more
+7. **Iconic Imagery**: Leverage genre's visual language
+8. **Moral Complexity**: Avoid simple good vs. evil
+9. **Respect History**: Acknowledge problematic elements critically
+10. **Know the Mythology**: Engage with genre traditions intentionally
+
+## Resources
+
+- "The Western" by Richard Slotkin - Academic analysis of genre
+- "The BFI Companion to the Western" edited by Edward Buscombe
+- "Unforgiven" screenplay by David Webb Peoples - Revisionist masterpiece
+- "True Grit" by Charles Portis - Novel with authentic period voice
+- "The Searchers" (1956) - Essential classical western
+
+---
+
+**Depth Coverage**: 85%
+**Last Updated**: 2026-01-31
+**Version**: 1.0.0
+

package/augment-extensions/writing-standards/screenplay/module.json

@@ -25,7 +25,7 @@
   ],
   "dependencies": [],
   "augment": {
-    "characterCount": 0,
+    "characterCount": 163500,
     "priority": "high",
     "category": "writing-standards"
   },

package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md

@@ -0,0 +1,339 @@
+# AAA Hollywood Films
+
+## Overview
+
+AAA Hollywood blockbusters are high-budget, wide-release films designed for maximum commercial appeal and global audiences. These films prioritize spectacle, star power, and franchise potential while maintaining strong narrative foundations.
+
+## Defining Characteristics
+
+### Budget and Scale
+**Typical Budget**: $100M - $400M+
+- High production values
+- A-list talent (actors, directors, crew)
+- Extensive marketing campaigns
+- Wide theatrical release (3,000+ screens)
+- Global distribution strategy
+
+### Target Audience
+- Broad demographic appeal
+- International markets (especially China)
+- Four-quadrant appeal (male/female, young/old)
+- Family-friendly or PG-13 rating preferred
+- Repeat viewing potential
+
+## Narrative Structure
+
+### High-Stakes Storytelling
+**Requirements**:
+- World-threatening or civilization-ending stakes
+- Clear, easily understood conflict
+- Personal stakes within global threat
+- Ticking clock/time pressure
+- Multiple escalating set pieces
+
+**Example Stakes**:
+- Alien invasion
+- Global pandemic
+- Nuclear threat
+- Supernatural apocalypse
+- Superhero vs. supervillain
+
+### Three-Act Structure (Rigid)
+**Act 1** (25-30 pages):
+- Spectacular opening sequence
+- Introduce hero in ordinary world
+- Establish stakes and threat
+- Inciting incident (pages 10-15)
+- Hero commits to journey (page 25-30)
+
+**Act 2** (50-60 pages):
+- Escalating action set pieces
+- Midpoint reversal (page 55-60)
+- "All is lost" moment (page 75-80)
+- Hero's lowest point
+- Preparation for final battle
+
+**Act 3** (25-30 pages):
+- Climactic battle/confrontation
+- Maximum spectacle
+- Hero's triumph
+- Resolution of personal arc
+- Setup for sequel (optional)
+
+### Set Pieces
+**Requirements**:
+- 4-6 major action sequences
+- Escalating scale and stakes
+- Spaced every 15-20 pages
+- Visual spectacle
+- Clear geography and stakes
+- Emotional investment
+
+**Set Piece Structure**:
+1. Setup and anticipation
+2. Escalation and complications
+3. Climax and resolution
+4. Aftermath and consequences
+
+## Character Requirements
+
+### Protagonist
+**Characteristics**:
+- Relatable despite extraordinary circumstances
+- Clear motivation and goal
+- Personal flaw to overcome
+- Heroic qualities
+- Star vehicle (written for A-list actor)
+
+**Arc**:
+- Reluctant hero to willing champion
+- Selfish to selfless
+- Broken to whole
+- Ordinary to extraordinary
+
+### Ensemble Cast
+**Structure**:
+- Lead protagonist (star)
+- Supporting hero/sidekick
+- Love interest
+- Mentor figure
+- Comic relief character
+- Diverse team members
+
+**Balance**:
+- Each character has moment to shine
+- Distinct personalities and skills
+- Interpersonal dynamics and conflict
+- Team-building arc
+
+### Antagonist
+**Requirements**:
+- Formidable threat
+- Clear motivation (even if wrong)
+- Personal connection to hero (preferred)
+- Escalating menace
+- Memorable presence
+
+**Types**:
+- Supervillain
+- Corrupt authority
+- Alien/monster threat
+- Natural disaster
+- Rogue AI/technology
+
+## Visual Spectacle
+
+### Action Sequences
+**Guidelines**:
+- Clear choreography
+- Escalating intensity
+- Practical and CGI blend
+- Geographic clarity
+- Emotional stakes
+- Hero ingenuity
+
+**Description**:
+```
+The building EXPLODES. Sarah leaps from the window,
+grabbing the helicopter skid as it swoops past.
+
+Below, the street ERUPTS in flames.
+
+Sarah pulls herself up, muscles straining. The pilot
+banks hard, trying to shake her loose.
+```
+
+### Visual Effects
+**Integration**:
+- Specify VFX moments clearly
+- Balance practical and digital
+- Serve story, not just spectacle
+- Budget-conscious writing
+- Feasibility consideration
+
+**Notation**:
+```
+The alien mothership MATERIALIZES above the city,
+BLOTTING OUT THE SUN. Miles wide, impossibly massive.
+```
+
+## Franchise Potential
+
+### World-Building
+**Elements**:
+- Rich, expandable universe
+- Mythology and lore
+- Multiple story possibilities
+- Spin-off potential
+- Merchandising opportunities
+
+### Sequel Setup
+**Techniques**:
+- Resolve main plot
+- Leave larger questions unanswered
+- Introduce future threats (post-credits)
+- Establish ongoing relationships
+- Create anticipation
+
+**Balance**:
+- Satisfying standalone story
+- Hooks for continuation
+- Don't sacrifice current film for future
+- Earn the sequel
+
+## Dialogue and Tone
+
+### Quotable Lines
+**Characteristics**:
+- Memorable one-liners
+- Catchphrases
+- Trailer-worthy moments
+- Emotional declarations
+- Witty banter
+
+**Examples**:
+- "I am Iron Man."
+- "I'll be back."
+- "May the Force be with you."
+
+### Tone Balance
+**Mix**:
+- Serious stakes
+- Humor and levity
+- Emotional depth
+- Crowd-pleasing moments
+- Inspirational themes
+
+### Accessibility
+**Guidelines**:
+- Clear, straightforward dialogue
+- Avoid overly complex exposition
+- Universal themes
+- Minimal cultural specificity
+- Translatable humor
+
+## Pacing and Structure
+
+### Opening Sequence
+**Requirements** (First 10 pages):
+- Spectacular action or visual
+- Establish tone and scale
+- Hook audience immediately
+- Introduce key elements
+- Set up central conflict
+
+### Midpoint Escalation
+**Page 55-60**:
+- Major revelation or reversal
+- Stakes increase dramatically
+- Hero commits fully
+- Point of no return
+- Shift in power dynamic
+
+### Climactic Battle
+**Final 15-20 pages**:
+- Maximum spectacle
+- All characters involved
+- Personal and global stakes converge
+- Hero's growth demonstrated
+- Satisfying resolution
+
+## Commercial Considerations
+
+### Rating
+**PG-13 Preferred**:
+- Maximum audience reach
+- Limited violence/language
+- No explicit content
+- Family-friendly
+- International appeal
+
+**Guidelines**:
+- One F-word allowed (if used)
+- Violence without gore
+- Implied rather than explicit
+- Heroic, not gratuitous
+
+### International Markets
+**Considerations**:
+- Universal themes
+- Minimal dialogue-dependent humor
+- Visual storytelling
+- Cultural sensitivity
+- Avoid US-centric references
+
+### Merchandising
+**Opportunities**:
+- Distinctive costumes/armor
+- Unique weapons or gadgets
+- Memorable creatures/vehicles
+- Collectible characters
+- Toy-friendly designs
+
+## Genre-Specific Guidelines
+
+### Superhero Films
+- Origin story or team-up
+- Powers clearly defined
+- Secret identity dynamics
+- Moral responsibility themes
+- Comic book inspiration
+
+### Science Fiction
+- High-concept premise
+- Technological spectacle
+- Exploration themes
+- Humanity vs. technology
+- Awe and wonder
+
+### Fantasy/Adventure
+- Quest structure
+- Magical elements
+- Mythological foundations
+- Hero's journey
+- Good vs. evil
+
+### Action/Thriller
+- Conspiracy or threat
+- Ticking clock
+- Betrayal and twists
+- Physical prowess
+- Impossible odds
+
+## Best Practices
+
+### DO
+✅ Open with spectacular sequence
+✅ Establish clear, high stakes
+✅ Create memorable set pieces
+✅ Balance spectacle with character
+✅ Write for global audience
+✅ Include quotable dialogue
+✅ Build franchise potential
+✅ Maintain clear narrative through action
+✅ Create emotional investment
+✅ End with satisfying resolution
+
+### DON'T
+❌ Sacrifice story for spectacle
+❌ Overcomplicate plot
+❌ Neglect character development
+❌ Ignore pacing between set pieces
+❌ Write culturally specific humor
+❌ Exceed PG-13 rating unnecessarily
+❌ Forget international audience
+❌ Make action sequences unclear
+❌ Rely solely on CGI spectacle
+❌ Leave main plot unresolved
+
+## Examples
+
+**Successful AAA Films**:
+- Marvel Cinematic Universe films
+- Star Wars franchise
+- Jurassic World series
+- Fast & Furious franchise
+- Mission: Impossible series
+- Avatar
+- Top Gun: Maverick
+