@mytechtoday/augment-extensions 0.4.0 → 0.7.0

package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md

@@ -0,0 +1,329 @@
+# AI Integration Testing Guide
+
+## Overview
+
+This guide covers testing AI-generated screenplays against industry standards and the screenplay module rules.
+
+---
+
+## Testing Checklist
+
+### Format Validation
+
+**Scene Headings:**
+- [ ] All scene headings start with INT, EXT, or INT./EXT.
+- [ ] Scene headings include location and time of day
+- [ ] Blank lines before and after scene headings
+- [ ] Scene headings are in ALL CAPS
+
+**Character Names:**
+- [ ] Character names are in ALL CAPS
+- [ ] Character names are consistent throughout
+- [ ] Extensions (O.S., V.O., CONT'D) are properly formatted
+- [ ] Character names are on their own line
+
+**Dialogue:**
+- [ ] Dialogue follows character names
+- [ ] Parentheticals are properly formatted
+- [ ] Dialogue is natural and character-appropriate
+- [ ] No overly long dialogue blocks
+
+**Action Lines:**
+- [ ] Action paragraphs are 3-4 lines maximum
+- [ ] Sound effects are in ALL CAPS
+- [ ] Action is visual and specific
+- [ ] No camera directions (unless category-appropriate)
+
+**Transitions:**
+- [ ] Transitions are used sparingly
+- [ ] Transitions are in ALL CAPS
+- [ ] Transitions end with colon or period
+
+---
+
+## Category-Specific Validation
+
+### AAA Hollywood Films
+
+**Spectacle:**
+- [ ] Action sequences are visually dynamic
+- [ ] Set pieces are clearly described
+- [ ] Visual effects notes are included where appropriate
+
+**Pacing:**
+- [ ] Fast-paced action
+- [ ] Quick scene transitions
+- [ ] High-stakes moments every 10-15 pages
+
+**Structure:**
+- [ ] Clear three-act structure
+- [ ] Major plot points at expected page numbers
+- [ ] Satisfying climax and resolution
+
+### Independent Films
+
+**Character Depth:**
+- [ ] Complex, nuanced characters
+- [ ] Character-driven plot
+- [ ] Emotional authenticity
+
+**Dialogue:**
+- [ ] Natural, realistic dialogue
+- [ ] Subtext and layered meaning
+- [ ] Character voice consistency
+
+**Themes:**
+- [ ] Clear thematic exploration
+- [ ] Meaningful character arcs
+- [ ] Thought-provoking content
+
+### TV Series
+
+**Episode Structure:**
+- [ ] Teaser/cold open (if applicable)
+- [ ] Act breaks at appropriate moments
+- [ ] Cliffhanger or hook at end
+- [ ] Series continuity maintained
+
+**Character Consistency:**
+- [ ] Characters match established series canon
+- [ ] Character development progresses logically
+- [ ] Relationships evolve appropriately
+
+**Timing:**
+- [ ] Appropriate page count for format
+- [ ] Pacing suitable for episode length
+- [ ] Commercial breaks considered (if applicable)
+
+---
+
+## AI-Specific Validation
+
+### Common AI Mistakes
+
+**Over-Description:**
+```fountain
+❌ Sarah, a beautiful woman in her early thirties with long flowing brown hair 
+and piercing green eyes, walks slowly and deliberately across the room, her 
+footsteps echoing on the hardwood floor as she contemplates her next move.
+
+✅ Sarah crosses the room, hesitant.
+```
+
+**Unnatural Dialogue:**
+```fountain
+❌ SARAH
+As you know, Marcus, we have been working together for five years at the 
+social services department where we both help families in need.
+
+✅ SARAH
+Five years we've been doing this.
+```
+
+**Camera Directions (unless appropriate):**
+```fountain
+❌ CLOSE ON Sarah's face as a single tear rolls down her cheek.
+
+✅ A tear rolls down Sarah's face.
+```
+
+**Telling Instead of Showing:**
+```fountain
+❌ Sarah is sad and lonely.
+
+✅ Sarah sits alone, staring at her phone. No messages.
+```
+
+---
+
+## Before/After Examples
+
+### Example 1: Over-Written Action
+
+**Before (AI-generated):**
+```fountain
+INT. COFFEE SHOP - DAY
+
+The coffee shop is bustling with activity. People are sitting at tables, 
+drinking coffee and having conversations. The barista is making drinks behind 
+the counter. Sarah, a woman in her thirties, enters through the front door 
+and looks around the room, searching for someone. She spots Marcus sitting 
+at a table in the corner and walks over to him.
+```
+
+**After (Revised):**
+```fountain
+INT. COFFEE SHOP - DAY
+
+Busy. Sarah enters, scans the room.
+
+She spots Marcus in the corner, heads over.
+```
+
+### Example 2: Unnatural Dialogue
+
+**Before (AI-generated):**
+```fountain
+SARAH
+Hello, Marcus. Thank you for agreeing to meet with me today. I wanted to 
+discuss the case we have been working on together regarding the Rodriguez 
+family and their ongoing struggles with addiction.
+
+MARCUS
+Of course, Sarah. I am always happy to discuss our cases with you. What 
+specifically did you want to talk about?
+```
+
+**After (Revised):**
+```fountain
+SARAH
+Thanks for meeting me.
+
+MARCUS
+Of course. What's up?
+
+SARAH
+It's the Rodriguez case. I'm worried.
+```
+
+### Example 3: Character Inconsistency
+
+**Before (AI-generated):**
+```fountain
+SARAH
+(cheerfully)
+Everything's great! I love my job and I'm so happy!
+```
+
+**After (Revised - consistent with character):**
+```fountain
+SARAH
+(deflecting)
+I'm fine. Let's focus on the case.
+```
+
+---
+
+## Validation Tools
+
+### Automated Checks
+
+**Format Validation:**
+- Better Fountain (VS Code) - syntax checking
+- Highland 2 - format validation
+- Fade In - industry standard checking
+
+**Character Consistency:**
+- Search for character name variations
+- Check dialogue patterns
+- Verify character voice
+
+**Page Count:**
+- Target: 1 page = 1 minute screen time
+- Feature film: 90-120 pages
+- TV hour: 50-60 pages
+- TV half-hour: 25-35 pages
+
+### Manual Review
+
+**Read Aloud:**
+- Dialogue should sound natural
+- Action should be clear and visual
+- Pacing should feel right
+
+**Character Voice:**
+- Each character should sound distinct
+- Dialogue should match character background
+- Consistency throughout screenplay
+
+**Visual Clarity:**
+- Can you "see" the scene?
+- Is action clear and specific?
+- Are visuals compelling?
+
+---
+
+## Industry Standards Compliance
+
+### AMPAS (Academy) Standards
+
+**Formatting:**
+- Courier 12pt font
+- 1.5" left margin, 1" other margins
+- Scene headings in ALL CAPS
+- Character names in ALL CAPS
+- Proper spacing between elements
+
+**Page Count:**
+- Feature film: 90-120 pages
+- One page = approximately one minute
+
+**Title Page:**
+- Title centered
+- Author credit
+- Contact information
+- Draft date
+
+### BBC Standards (for UK productions)
+
+**Formatting:**
+- Similar to AMPAS with minor variations
+- A4 paper size (vs. US Letter)
+- Slightly different margin specifications
+
+**Style:**
+- British spelling and terminology
+- Cultural considerations
+- Regional dialects noted
+
+---
+
+## Quality Metrics
+
+### Excellent AI-Generated Screenplay
+
+- [ ] Formatting is 100% compliant
+- [ ] Dialogue sounds natural when read aloud
+- [ ] Characters are distinct and consistent
+- [ ] Action is visual and specific
+- [ ] Pacing is appropriate for category
+- [ ] Structure follows established beats
+- [ ] No camera directions (unless appropriate)
+- [ ] No over-description
+- [ ] Theme is clear and explored
+- [ ] Emotional beats land effectively
+
+### Needs Revision
+
+- [ ] Formatting errors present
+- [ ] Dialogue sounds artificial
+- [ ] Characters lack distinction
+- [ ] Action is vague or over-written
+- [ ] Pacing issues
+- [ ] Structure problems
+- [ ] Excessive camera directions
+- [ ] Over-description
+- [ ] Unclear theme
+- [ ] Emotional beats don't land
+
+---
+
+## Testing Workflow
+
+1. **Generate screenplay** using AI with module rules
+2. **Automated validation** using Better Fountain or similar
+3. **Manual review** against checklist
+4. **Category-specific validation** 
+5. **Read aloud test** for dialogue
+6. **Revision** based on findings
+7. **Final validation** before export
+
+---
+
+## Resources
+
+- AMPAS Screenplay Format Guide
+- BBC Writers' Room Format Guide
+- Better Fountain Documentation
+- Industry Standard Screenplay Examples
+

package/augment-extensions/writing-standards/screenplay/rules/character-development.md

@@ -0,0 +1,169 @@
+# Character Development
+
+## Overview
+
+Character development is the foundation of compelling storytelling. Well-developed characters drive narrative, create emotional engagement, and provide the human element that audiences connect with.
+
+## Character Arc Models
+
+### Positive Arc (Growth)
+- **Starting Point**: Character has a flaw, weakness, or false belief
+- **Catalyst**: Event challenges their worldview
+- **Struggle**: Character resists change
+- **Revelation**: Character gains insight
+- **Transformation**: Character overcomes flaw and achieves goal
+- **Examples**: Luke Skywalker (Star Wars), Andy Dufresne (Shawshank Redemption)
+
+### Negative Arc (Fall)
+- **Starting Point**: Character has potential or virtue
+- **Temptation**: Character faces corrupting influence
+- **Compromise**: Character makes moral concessions
+- **Descent**: Character loses their way
+- **Tragedy**: Character is destroyed or corrupted
+- **Examples**: Michael Corleone (The Godfather), Walter White (Breaking Bad)
+
+### Flat Arc (Steadfast)
+- **Starting Point**: Character already has truth/strength
+- **Challenge**: World tries to change or corrupt character
+- **Resistance**: Character maintains principles
+- **Influence**: Character changes the world around them
+- **Resolution**: Character's truth prevails
+- **Examples**: Captain America, Atticus Finch (To Kill a Mockingbird)
+
+## Core Character Elements
+
+### Traits
+**Physical Traits**:
+- Age, appearance, mannerisms
+- Physical limitations or abilities
+- Distinctive features
+
+**Personality Traits**:
+- Temperament (optimistic, cynical, anxious)
+- Habits and quirks
+- Strengths and weaknesses
+- Values and beliefs
+
+**Social Traits**:
+- Background and upbringing
+- Education and skills
+- Relationships and social status
+
+### Motivations
+**External Motivations** (Plot-driven):
+- Survival
+- Love/relationships
+- Wealth/power
+- Justice/revenge
+- Achievement/recognition
+
+**Internal Motivations** (Character-driven):
+- Self-worth
+- Belonging
+- Identity
+- Redemption
+- Understanding
+
+### Backstory
+**Essential Elements**:
+- Formative experiences
+- Wounds and traumas
+- Relationships that shaped them
+- Secrets and hidden truths
+
+**Best Practices**:
+- Reveal backstory gradually through action and dialogue
+- Only include backstory that impacts present story
+- Avoid exposition dumps
+- Use "iceberg principle" - show 10%, imply 90%
+
+### Relationships
+**Types**:
+- Protagonist/Antagonist (conflict)
+- Mentor/Student (guidance)
+- Allies/Friends (support)
+- Love interests (romance)
+- Foils (contrast)
+
+**Dynamics**:
+- Power balance
+- Emotional connection
+- Shared history
+- Conflicting goals
+- Evolution over time
+
+## Character Voice
+
+### Dialogue Patterns
+Each character should have distinctive:
+- Vocabulary level and word choice
+- Sentence structure (short/long, simple/complex)
+- Speech patterns (formal/casual, verbose/terse)
+- Catchphrases or recurring expressions
+- Cultural/regional influences
+
+### Subtext
+- What character says vs. what they mean
+- Hidden agendas
+- Emotional undercurrents
+- Power dynamics in conversation
+
+## Character Transformation
+
+### Stages of Change
+1. **Stasis**: Character in their normal world
+2. **Disruption**: Inciting incident forces change
+3. **Resistance**: Character clings to old ways
+4. **Acceptance**: Character commits to journey
+5. **Growth**: Character develops new skills/perspective
+6. **Testing**: Character faces ultimate challenge
+7. **Integration**: Character embodies new self
+
+### Tracking Transformation
+- **Act 1**: Establish who character is
+- **Act 2**: Challenge and change character
+- **Act 3**: Reveal who character has become
+
+## Character Types
+
+### Protagonist
+- Drives the story forward
+- Has clear goal and motivation
+- Faces obstacles and opposition
+- Undergoes transformation
+- Audience identification figure
+
+### Antagonist
+- Opposes protagonist's goal
+- Has own valid motivation (not just "evil")
+- Challenges protagonist to grow
+- May be person, system, nature, or internal conflict
+
+### Supporting Characters
+- **Mentor**: Guides protagonist
+- **Ally**: Supports protagonist
+- **Trickster**: Provides comic relief, challenges assumptions
+- **Herald**: Brings news, catalyzes change
+- **Threshold Guardian**: Tests protagonist's commitment
+- **Shapeshifter**: Loyalty/nature unclear
+
+## Best Practices
+
+### DO
+✅ Give characters contradictions and complexity
+✅ Show character through action, not description
+✅ Create characters with agency who make choices
+✅ Develop unique voice for each character
+✅ Connect character arc to theme
+✅ Make character flaws integral to plot
+✅ Show character growth through behavior change
+
+### DON'T
+❌ Create perfect characters without flaws
+❌ Rely on stereotypes or clichés
+❌ Tell character traits through exposition
+❌ Make all characters sound the same
+❌ Change character arbitrarily without motivation
+❌ Forget supporting characters' arcs
+❌ Sacrifice character consistency for plot convenience
+