@mytechtoday/augment-extensions 0.4.0 → 0.7.0

package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md

@@ -0,0 +1,261 @@
+# Diversity and Inclusion
+
+## Overview
+
+Inclusive storytelling creates richer narratives, broader audience connection, and authentic representation. This guide provides frameworks for creating diverse, respectful, and authentic characters and stories.
+
+## The Bechdel Test
+
+### Definition
+A work passes the Bechdel Test if it meets three criteria:
+1. It has at least two named female characters
+2. Who talk to each other
+3. About something other than a man
+
+### Purpose
+- Minimum baseline for female representation
+- Highlights gender imbalance in storytelling
+- Not a measure of quality, but of representation
+
+### Beyond the Bechdel Test
+**Other Representation Tests**:
+- **Vito Russo Test** (LGBTQ+ representation)
+- **DuVernay Test** (racial representation in positions of power)
+- **Riz Test** (Muslim representation)
+- **Mako Mori Test** (female character arcs)
+
+### Application
+- Use as starting point, not endpoint
+- Consider intersectionality
+- Evaluate quality of representation, not just presence
+- Apply across all marginalized groups
+
+## Authentic Representation
+
+### Research and Consultation
+**Best Practices**:
+- Consult members of represented communities
+- Hire sensitivity readers
+- Research cultural practices and history
+- Avoid relying on stereotypes
+- Listen to feedback
+
+**Resources**:
+- Cultural consultants
+- Community organizations
+- Academic research
+- First-person accounts
+- Sensitivity readers
+
+### Avoiding Tokenism
+**Tokenism Indicators**:
+- Single representative of entire group
+- Character exists only to serve majority characters
+- No character development or arc
+- Stereotypical portrayal
+- No agency or complexity
+
+**Solutions**:
+- Multiple characters from underrepresented groups
+- Give characters their own goals and arcs
+- Show diversity within groups
+- Avoid making identity the only character trait
+- Create fully realized individuals
+
+## Stereotypes to Avoid
+
+### Racial and Ethnic Stereotypes
+**Common Harmful Tropes**:
+- Magical Negro (Black character exists to help white protagonist)
+- Model Minority (Asian characters as uniformly successful)
+- Spicy Latina (Latina characters as fiery/sexual)
+- Noble Savage (Indigenous characters as mystical/primitive)
+- Terrorist (Middle Eastern characters as threats)
+
+**Better Approach**:
+- Create complex, individualized characters
+- Show diversity within racial/ethnic groups
+- Avoid reducing characters to cultural stereotypes
+- Give characters agency and depth
+- Consult with community members
+
+### Gender Stereotypes
+**Harmful Tropes**:
+- Damsel in Distress (woman needs rescuing)
+- Manic Pixie Dream Girl (quirky woman exists to inspire man)
+- Shrew/Nag (woman as obstacle to man's happiness)
+- Born Sexy Yesterday (naive woman with childlike innocence)
+- Smurfette Principle (one woman among many men)
+
+**Better Approach**:
+- Women with agency and goals
+- Complex female characters with flaws
+- Women in diverse roles and professions
+- Female friendships and relationships
+- Women as protagonists, not accessories
+
+### LGBTQ+ Stereotypes
+**Harmful Tropes**:
+- Bury Your Gays (LGBTQ+ characters die for plot)
+- Gay Best Friend (exists to support straight protagonist)
+- Predatory Lesbian/Gay Panic
+- Tragic Queer (suffering as only narrative)
+- Deceptive Transgender Person
+
+**Better Approach**:
+- LGBTQ+ characters with happy endings
+- Characters whose identity isn't their only trait
+- Diverse LGBTQ+ representation
+- Authentic relationships and experiences
+- Consult LGBTQ+ writers and consultants
+
+### Disability Stereotypes
+**Harmful Tropes**:
+- Inspiration Porn (disabled person inspires able-bodied people)
+- Magical Disability (disability grants special powers)
+- Better Off Dead (death preferable to disability)
+- Cure Narrative (disability must be "fixed")
+- Bitter Disabled Person
+
+**Better Approach**:
+- Disabled characters as full people
+- Disability as part of identity, not defining trait
+- Authentic portrayal of lived experience
+- Consult disabled actors and writers
+- Show accommodations and accessibility
+
+## Cultural Sensitivity
+
+### Religious Representation
+**Guidelines**:
+- Research religious practices accurately
+- Avoid conflating religion with extremism
+- Show diversity within religious communities
+- Respect sacred practices and symbols
+- Consult religious scholars and practitioners
+
+### Language and Dialect
+**Best Practices**:
+- Use authentic language patterns
+- Avoid phonetic spellings that mock
+- Research regional and cultural speech
+- Don't use dialect to indicate intelligence
+- Consult native speakers
+
+### Cultural Practices
+**Respectful Portrayal**:
+- Research cultural significance
+- Avoid cultural appropriation
+- Show practices in context
+- Respect sacred or private traditions
+- Consult cultural experts
+
+## Intersectionality
+
+### Definition
+Recognition that people have multiple, overlapping identities that create unique experiences of discrimination and privilege.
+
+### Application
+**Consider**:
+- Race + Gender
+- Disability + Sexual Orientation
+- Class + Ethnicity
+- Age + Gender Identity
+- Religion + Race
+
+**Avoid**:
+- Single-axis representation
+- Assuming universal experiences within groups
+- Ignoring how identities interact
+- Simplifying complex identities
+
+## Power and Representation
+
+### Who Tells the Story?
+**Questions to Ask**:
+- Who has creative control?
+- Whose perspective is centered?
+- Who benefits from this story?
+- Are we perpetuating harm?
+- Have we consulted affected communities?
+
+### Representation in Roles
+**Beyond Characters**:
+- Writers from diverse backgrounds
+- Directors and producers
+- Crew members
+- Consultants and advisors
+- Decision-makers
+
+## Inclusive Storytelling Techniques
+
+### Normalization
+**Approach**:
+- Diverse characters in everyday roles
+- Identity not always central to plot
+- Casual representation
+- Diverse backgrounds as default
+
+**Example**:
+- Doctor happens to be in wheelchair
+- Same-sex couple as neighbors
+- Protagonist's best friend is Muslim
+- Identity present but not plot point
+
+### Authentic Conflict
+**Guidelines**:
+- Conflict from character, not stereotype
+- Avoid trauma porn
+- Show resilience and joy
+- Balance struggle with triumph
+- Respect lived experiences
+
+### Positive Representation
+**Balance**:
+- Show challenges authentically
+- Include moments of joy and success
+- Avoid only tragic narratives
+- Celebrate culture and identity
+- Provide hope and empowerment
+
+## Best Practices
+
+### DO
+✅ Research thoroughly and consult experts
+✅ Hire diverse writers and consultants
+✅ Create complex, individualized characters
+✅ Show diversity within groups
+✅ Give underrepresented characters agency
+✅ Include casual, normalized representation
+✅ Listen to feedback from communities
+✅ Show intersectional identities
+✅ Balance challenge with joy
+✅ Question your assumptions
+
+### DON'T
+❌ Rely on stereotypes or tropes
+❌ Create token characters
+❌ Make identity the only character trait
+❌ Appropriate cultural practices
+❌ Ignore intersectionality
+❌ Assume universal experiences
+❌ Write trauma without research
+❌ Ignore feedback from represented communities
+❌ Perpetuate harmful narratives
+❌ Claim to speak for entire groups
+
+## Resources
+
+### Organizations
+- GLAAD (LGBTQ+ representation)
+- Geena Davis Institute (gender representation)
+- Color of Change (racial justice in media)
+- RespectAbility (disability representation)
+- Muslim Public Affairs Council (Muslim representation)
+
+### Guidelines
+- GLAAD Media Reference Guide
+- Conscious Style Guide
+- Disability Language Style Guide
+- Indigenous Peoples' Style Guide
+

package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md

@@ -0,0 +1,315 @@
+# Screenplay Examples Guide
+
+## Overview
+
+This guide provides detailed explanations and annotations for all example files in the screenplay module.
+
+---
+
+## Fountain Examples
+
+### AAA Hollywood Scene (aaa-hollywood-scene.fountain)
+
+**Purpose:** Demonstrates high-stakes action sequence with visual spectacle
+
+**Key Features:**
+- Fast-paced action
+- Visual effects notes
+- Clear spatial geography
+- Escalating tension
+- Cinematic set pieces
+
+**What to Learn:**
+- How to write action that's visual and dynamic
+- Balancing description with pacing
+- Using sound effects effectively
+- Creating tension through action
+
+**Category:** AAA Hollywood Films
+
+---
+
+### Independent Film Monologue (independent-monologue.fountain)
+
+**Purpose:** Demonstrates character-driven emotional scene
+
+**Key Features:**
+- Deep character exploration
+- Emotional authenticity
+- Minimal action, maximum emotion
+- Subtext and layered meaning
+- Natural, realistic dialogue
+
+**What to Learn:**
+- Writing emotional monologues
+- Character voice and authenticity
+- Using silence and pauses
+- Creating intimacy on the page
+
+**Category:** Independent Films
+
+**Character Analysis:**
+- Sarah is grieving, isolated, struggling
+- Monologue reveals internal conflict
+- Physical actions support emotional state
+- Vulnerability without melodrama
+
+---
+
+### TV Episode Teaser (tv-episode-teaser.fountain)
+
+**Purpose:** Demonstrates cold open/teaser structure for TV series
+
+**Key Features:**
+- Hook within first 30 seconds
+- Escalating mystery
+- Cliffhanger ending
+- Series-appropriate tone
+- Act break structure
+
+**What to Learn:**
+- Creating compelling teasers
+- Building suspense
+- Ending on cliffhanger
+- Establishing tone quickly
+
+**Category:** TV Series (Drama/Thriller)
+
+**Structure Breakdown:**
+- Pages 1-2: Setup (lighthouse keeper, routine)
+- Pages 2-4: Inciting incident (distress call)
+- Pages 4-6: Investigation (approaching boat)
+- Pages 6-8: Escalation (mysterious circumstances)
+- Pages 8-10: Cliffhanger (trapped, something in cabin)
+
+---
+
+### News Broadcast Segment (news-segment.fountain)
+
+**Purpose:** Demonstrates news broadcast format with timing and production notes
+
+**Key Features:**
+- Timing marks (critical for broadcast)
+- B-roll notes
+- Interview segments
+- Production notes
+- Call-to-action
+
+**What to Learn:**
+- Broadcast script formatting
+- Timing and pacing for news
+- Integrating B-roll and interviews
+- Production considerations
+
+**Category:** News Broadcasts
+
+**Production Elements:**
+- Total runtime: 2:30
+- Anchor segments: 1:00
+- Interviews: 1:00
+- B-roll: 0:30
+- Graphics: 3 total
+
+---
+
+### 30-Second Commercial (commercial-30sec.fountain)
+
+**Purpose:** Demonstrates commercial script with precise timing
+
+**Key Features:**
+- Exact timing breakdown
+- Visual storytelling
+- Brand messaging
+- Call-to-action
+- Production notes
+
+**What to Learn:**
+- Writing for precise time constraints
+- Visual storytelling without dialogue
+- Brand integration
+- Production planning
+
+**Category:** Commercials
+
+**Timing Breakdown:**
+- :00-:12 - Opening visual (mountain summit)
+- :12-:24 - Product messaging (voiceover)
+- :24-:30 - Call-to-action (brand/tagline)
+
+---
+
+## YAML Examples
+
+### Character Profile Example (character-profile-example.yaml)
+
+**Purpose:** Demonstrates comprehensive character development using schema
+
+**Character:** Sarah Mitchell (protagonist)
+
+**Key Features:**
+- Complete character profile
+- Physical and psychological traits
+- Backstory with formative events
+- Character arc definition
+- Relationship mapping
+- Voice and speech patterns
+
+**What to Learn:**
+- Creating three-dimensional characters
+- Connecting backstory to present behavior
+- Defining clear character arcs
+- Establishing distinct voice
+
+**Usage:**
+- Use as template for your characters
+- Adapt depth to character importance
+- Ensure consistency with screenplay
+
+---
+
+### Beat Sheet Example (beat-sheet-example.yaml)
+
+**Purpose:** Demonstrates Save the Cat beat structure
+
+**Story:** "The Weight We Carry" (psychological drama)
+
+**Key Features:**
+- All 15 Save the Cat beats
+- Page number guidelines
+- Beat descriptions
+- Thematic connections
+- Character arc integration
+
+**What to Learn:**
+- Applying Save the Cat structure
+- Timing major plot points
+- Connecting beats to theme
+- Balancing plot and character
+
+**Structure Highlights:**
+- Opening Image (p.1): Sarah isolated in car
+- Catalyst (p.12): Meets Elena, sees her mother
+- Midpoint (p.55): False victory, stakes raised
+- All Is Lost (p.75): Elena overdoses
+- Final Image (p.110): Sarah connected, moving forward
+
+---
+
+### Plot Outline Example (plot-outline-example.yaml)
+
+**Purpose:** Demonstrates three-act structure with sequences and scenes
+
+**Story:** "The Weight We Carry"
+
+**Key Features:**
+- Three-act structure
+- Sequences within acts
+- Individual scene breakdowns
+- Turning points
+- Subplots
+
+**What to Learn:**
+- Organizing screenplay structure
+- Breaking story into manageable pieces
+- Scene-by-scene planning
+- Integrating subplots
+
+**Act Breakdown:**
+- Act 1 (pp.1-25): Setup - Sarah's world, catalyst
+- Act 2 (pp.26-85): Confrontation - Progress and unraveling
+- Act 3 (pp.86-110): Resolution - Healing and transformation
+
+---
+
+## Using the Examples
+
+### For Learning
+
+1. **Read the example**
+2. **Study the annotations** (this guide)
+3. **Identify techniques** used
+4. **Apply to your work**
+
+### For Templates
+
+1. **Copy example structure**
+2. **Replace with your content**
+3. **Maintain formatting**
+4. **Adapt to your needs**
+
+### For Reference
+
+1. **Keep examples handy**
+2. **Refer when stuck**
+3. **Compare your work**
+4. **Validate formatting**
+
+---
+
+## Common Patterns Across Examples
+
+### Visual Storytelling
+
+All examples prioritize showing over telling:
+- Action reveals character
+- Visuals convey emotion
+- Minimal exposition
+- Specific, concrete details
+
+### Formatting Consistency
+
+All examples follow industry standards:
+- Proper Fountain syntax
+- Correct element formatting
+- Appropriate spacing
+- Professional appearance
+
+### Category Appropriateness
+
+Each example fits its category:
+- AAA Hollywood: Spectacle and action
+- Independent: Character and emotion
+- TV: Structure and hooks
+- News: Information and timing
+- Commercial: Brand and brevity
+
+---
+
+## Practice Exercises
+
+### Exercise 1: Adaptation
+
+Take the independent monologue and adapt it for:
+- AAA Hollywood (add action, external conflict)
+- TV Series (add cliffhanger, series context)
+
+### Exercise 2: Structure
+
+Use the beat sheet example to outline:
+- Your own story
+- A favorite film
+- A story idea
+
+### Exercise 3: Character
+
+Create a character profile for:
+- Protagonist of your screenplay
+- Antagonist
+- Key supporting character
+
+### Exercise 4: Format
+
+Write a scene in the style of:
+- AAA Hollywood action
+- Independent character moment
+- TV teaser
+
+---
+
+## Resources
+
+- All example files in `examples/` directory
+- Schema files in `schemas/` directory
+- Rule files in `rules/` directory
+- Module README for overview
+