@mytechtoday/augment-extensions 0.2.0 → 0.5.0

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
+

package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md

@@ -0,0 +1,413 @@
+# Screenplay Formatting Validation
+
+## Overview
+
+This guide provides comprehensive validation rules for screenplay formatting against AMPAS (Academy of Motion Picture Arts and Sciences) standards.
+
+---
+
+## AMPAS Formatting Standards
+
+### Page Setup
+
+**Paper Size:** US Letter (8.5" x 11")
+
+**Margins:**
+- Top: 1.0"
+- Bottom: 0.5" - 1.0"
+- Left: 1.5"
+- Right: 1.0"
+
+**Font:**
+- Courier or Courier New
+- 12 point
+- Fixed-width (monospace)
+
+**Line Spacing:**
+- Single-spaced within elements
+- Double-spaced between elements
+
+---
+
+## Element Formatting
+
+### Scene Headings
+
+**Format:**
+```
+INT. LOCATION - TIME
+```
+
+**Specifications:**
+- Left margin: 1.5"
+- All caps
+- Blank line before and after
+- Must start with: INT, EXT, INT./EXT, I/E
+
+**Examples:**
+```fountain
+INT. COFFEE SHOP - DAY
+
+EXT. CITY STREET - NIGHT
+
+INT./EXT. CAR - MOVING - DUSK
+```
+
+**Validation:**
+- [ ] Starts with INT, EXT, or variant
+- [ ] All caps
+- [ ] Includes location
+- [ ] Includes time of day
+- [ ] Blank line before
+- [ ] Blank line after
+
+### Action/Description
+
+**Specifications:**
+- Left margin: 1.5"
+- Right margin: 1.0"
+- Width: 6.0"
+- Mixed case (except sound effects)
+- Blank line before and after
+
+**Examples:**
+```fountain
+Sarah walks to the window.
+
+The phone RINGS.
+
+She doesn't answer.
+```
+
+**Validation:**
+- [ ] Left-aligned
+- [ ] Proper margins
+- [ ] Sound effects in caps
+- [ ] Paragraphs 3-4 lines max
+- [ ] Blank line between paragraphs
+
+### Character Names
+
+**Specifications:**
+- Left margin: 3.7"
+- All caps
+- Extensions in parentheses
+- Blank line before (from action)
+
+**Examples:**
+```fountain
+SARAH
+
+MARCUS (O.S.)
+
+NARRATOR (V.O.)
+
+SARAH (CONT'D)
+```
+
+**Validation:**
+- [ ] All caps
+- [ ] Proper indentation (3.7")
+- [ ] Extensions formatted correctly
+- [ ] Consistent throughout screenplay
+
+### Dialogue
+
+**Specifications:**
+- Left margin: 2.5"
+- Right margin: 2.5"
+- Width: 3.5"
+- Mixed case
+- No blank line after character name
+
+**Examples:**
+```fountain
+SARAH
+I can't believe this is happening.
+```
+
+**Validation:**
+- [ ] Proper margins (2.5" left, 2.5" right)
+- [ ] Follows character name immediately
+- [ ] Natural language
+- [ ] Appropriate length
+
+### Parentheticals
+
+**Specifications:**
+- Left margin: 3.1"
+- Right margin: 3.5"
+- Wrapped in parentheses
+- Lowercase (except proper nouns)
+
+**Examples:**
+```fountain
+SARAH
+(to Marcus)
+I need to tell you something.
+
+MARCUS
+(nervous)
+What is it?
+```
+
+**Validation:**
+- [ ] Proper indentation (3.1")
+- [ ] Wrapped in parentheses
+- [ ] Lowercase
+- [ ] Brief (2-3 words ideal)
+
+### Transitions
+
+**Specifications:**
+- Right-aligned (6.0" from left)
+- All caps
+- End with colon or period
+- Blank line before and after
+
+**Examples:**
+```fountain
+CUT TO:
+
+FADE OUT.
+
+DISSOLVE TO:
+```
+
+**Validation:**
+- [ ] Right-aligned
+- [ ] All caps
+- [ ] Proper punctuation
+- [ ] Used sparingly
+
+---
+
+## Page Count Standards
+
+### Feature Films
+
+**Target:** 90-120 pages
+- 90-100 pages: Tight, fast-paced
+- 100-110 pages: Standard
+- 110-120 pages: Epic, complex
+
+**Rule of Thumb:** 1 page = 1 minute screen time
+
+### Television
+
+**One-Hour Drama:** 50-60 pages
+- Network: 50-55 pages (with commercials)
+- Cable/Streaming: 55-60 pages
+
+**Half-Hour Comedy:** 25-35 pages
+- Network: 25-30 pages (with commercials)
+- Cable/Streaming: 30-35 pages
+
+**Half-Hour Drama:** 30-40 pages
+
+---
+
+## Title Page Format
+
+**Required Elements:**
+```
+                    TITLE
+                (all caps, centered)
+
+
+              Written by
+           (centered, lowercase)
+
+
+               Author Name
+              (centered, mixed case)
+
+
+                                        Contact Info
+                                        (bottom right)
+                                        
+                                        Draft Date
+                                        (bottom right)
+```
+
+**Validation:**
+- [ ] Title centered and in caps
+- [ ] "Written by" centered
+- [ ] Author name centered
+- [ ] Contact info bottom right
+- [ ] Draft date included
+
+---
+
+## Common Formatting Errors
+
+### Scene Headings
+
+**❌ Incorrect:**
+```
+int. coffee shop - day          (not all caps)
+INT COFFEE SHOP DAY             (missing hyphens)
+COFFEE SHOP - DAY               (missing INT/EXT)
+INT. COFFEE SHOP                (missing time)
+```
+
+**✅ Correct:**
+```
+INT. COFFEE SHOP - DAY
+```
+
+### Character Names
+
+**❌ Incorrect:**
+```
+Sarah                           (not all caps)
+SARAH(O.S.)                     (no space)
+sarah (o.s.)                    (not all caps)
+```
+
+**✅ Correct:**
+```
+SARAH
+SARAH (O.S.)
+```
+
+### Dialogue
+
+**❌ Incorrect:**
+```
+SARAH: I can't do this.         (colon after name)
+
+SARAH
+    I can't do this.            (indented)
+```
+
+**✅ Correct:**
+```
+SARAH
+I can't do this.
+```
+
+### Action
+
+**❌ Incorrect:**
+```
+SARAH WALKS TO THE WINDOW.      (all caps)
+
+Sarah walks to the window and stares out at the rain for a long moment 
+before turning back to Marcus with tears streaming down her face as she 
+contemplates what to say next.  (too long)
+```
+
+**✅ Correct:**
+```
+Sarah walks to the window.
+
+She stares out at the rain.
+
+A beat.
+
+She turns back to Marcus, tears in her eyes.
+```
+
+---
+
+## Validation Checklist
+
+### Overall Format
+
+- [ ] Courier 12pt font
+- [ ] Proper margins (1.5" left, 1" right/top/bottom)
+- [ ] US Letter paper size
+- [ ] Single-spaced within elements
+- [ ] Double-spaced between elements
+
+### Scene Headings
+
+- [ ] All caps
+- [ ] Start with INT/EXT
+- [ ] Include location and time
+- [ ] Blank lines before and after
+
+### Characters and Dialogue
+
+- [ ] Character names all caps
+- [ ] Proper indentation
+- [ ] Natural dialogue
+- [ ] Parentheticals formatted correctly
+
+### Action
+
+- [ ] Mixed case (except sound effects)
+- [ ] Short paragraphs (3-4 lines)
+- [ ] Visual and specific
+- [ ] No camera directions (unless appropriate)
+
+### Page Count
+
+- [ ] Appropriate for format
+- [ ] Approximately 1 page = 1 minute
+
+### Title Page
+
+- [ ] Properly formatted
+- [ ] All required information
+- [ ] Professional appearance
+
+---
+
+## Automated Validation Tools
+
+**Better Fountain (VS Code):**
+- Real-time syntax checking
+- Format validation
+- Page count tracking
+
+**Highland 2:**
+- Industry-standard formatting
+- Automatic validation
+- Export to multiple formats
+
+**Fade In:**
+- Professional formatting
+- Validation against industry standards
+- Collaboration features
+
+---
+
+## Manual Validation Process
+
+1. **Visual Inspection:**
+   - Check overall appearance
+   - Verify consistent formatting
+   - Look for obvious errors
+
+2. **Element-by-Element Review:**
+   - Scene headings
+   - Character names
+   - Dialogue
+   - Action
+   - Transitions
+
+3. **Page Count Check:**
+   - Verify appropriate length
+   - Check pacing (1 page = 1 minute)
+
+4. **Read-Through:**
+   - Read entire screenplay
+   - Note formatting inconsistencies
+   - Mark areas for revision
+
+5. **Final Validation:**
+   - Run automated tools
+   - Manual checklist review
+   - Professional appearance check
+
+---
+
+## Resources
+
+- AMPAS Screenplay Format Guide
+- The Hollywood Standard by Christopher Riley
+- Better Fountain Documentation
+- Industry Standard Examples
+