@mytechtoday/augment-extensions 0.1.2 → 0.4.0

package/augment-extensions/writing-standards/screenplay/README.md

@@ -0,0 +1,171 @@
+# Screenplay Writing Standards
+
+## Overview
+
+Comprehensive screenplay writing and crafting standards for AI-driven content creation across multiple formats and industries.
+
+**Version**: 1.0.0  
+**Type**: writing-standards  
+**Character Count**: ~TBD
+
+## Key Benefits
+
+✅ **Industry-Standard Formatting** - AMPAS Nicholl Fellowship formatting standards  
+✅ **Narrative Frameworks** - Syd Field, Blake Snyder, Joseph Campbell structures  
+✅ **Category-Specific Rules** - 8 screenplay categories (Hollywood, indie, TV, web, news, commercials, streaming, live TV)  
+✅ **Character Development** - Programmatic character arcs, traits, motivations  
+✅ **Dialogue Mastery** - Natural speech, subtext, character voice  
+✅ **Screen Continuity** - Visual consistency rules (180-degree rule, match cuts)  
+✅ **Fountain Format** - Industry-standard plain-text screenplay markup  
+✅ **VS Code Integration** - Better Fountain extension support  
+✅ **Export Tools** - Final Draft (.fdx), PDF, HTML export
+
+## Installation
+
+### With CLI (Recommended)
+
+```bash
+augx link writing-standards/screenplay
+```
+
+### Manual Setup
+
+1. Copy `augment-extensions/writing-standards/screenplay/` to your project
+2. Create `.augment/screenplay-config.json` with category selection
+3. Reference rule files in your AI prompts
+
+## Configuration
+
+Create `.augment/screenplay-config.json`:
+
+```json
+{
+  "categories": ["aaa-hollywood-films"],
+  "universalRules": true,
+  "fountainFormat": true,
+  "exportFormats": ["fdx", "pdf"]
+}
+```
+
+### Available Categories
+
+1. **aaa-hollywood-films** - AAA Hollywood blockbusters
+2. **independent-films** - Independent/art-house films
+3. **tv-series** - Television series (episodic)
+4. **web-content** - Web series and short-form content
+5. **news-broadcasts** - News segments and broadcasts
+6. **commercials** - Advertising and commercials
+7. **streaming-content** - Streaming platform content
+8. **live-tv-productions** - Live TV productions
+
+## Directory Structure
+
+```
+augment-extensions/writing-standards/screenplay/
+├── module.json                    # Module metadata
+├── README.md                      # This file
+├── rules/                         # Screenplay writing rules
+│   ├── universal-formatting.md   # AMPAS formatting standards
+│   ├── narrative-structures.md   # Three-act, beat sheets, hero's journey
+│   ├── character-development.md  # Character arcs and development
+│   ├── dialogue-writing.md       # Dialogue best practices
+│   ├── screen-continuity.md      # Visual consistency rules
+│   ├── pacing-timing.md          # Pacing and timing guidelines
+│   ├── diversity-inclusion.md    # Diversity and inclusion standards
+│   ├── aaa-hollywood-films.md    # AAA Hollywood category rules
+│   ├── independent-films.md      # Independent film category rules
+│   ├── tv-series.md              # TV series category rules
+│   ├── web-content.md            # Web content category rules
+│   ├── news-broadcasts.md        # News broadcast category rules
+│   ├── commercials.md            # Commercial category rules
+│   ├── streaming-content.md      # Streaming content category rules
+│   └── live-tv-productions.md    # Live TV category rules
+├── schemas/                       # JSON schemas for screenplay data
+│   ├── character-profile.json    # Character profile schema
+│   ├── beat-sheet.json           # Beat sheet schema
+│   ├── plot-outline.json         # Plot outline schema
+│   └── trope-inventory.json      # Trope inventory schema
+└── examples/                      # Example screenplay files
+    ├── aaa-hollywood-scene.fountain
+    ├── independent-monologue.fountain
+    ├── tv-episode-teaser.fountain
+    ├── news-segment.fountain
+    ├── commercial-30sec.fountain
+    ├── character-profile-example.yaml
+    ├── beat-sheet-example.yaml
+    └── plot-outline-example.yaml
+```
+
+## Core Guidelines
+
+### Universal Formatting (AMPAS Standards)
+
+- **Font**: 12-point Courier or Courier New
+- **Margins**: 1-inch top/bottom/right, 1.5-inch left
+- **Page Length**: ~1 page per minute of screen time
+- **Scene Headings**: ALL CAPS, INT./EXT., location, time of day
+- **Action**: Present tense, active voice, visual descriptions
+- **Dialogue**: Character name centered, dialogue indented
+- **Transitions**: RIGHT-ALIGNED (FADE IN:, CUT TO:, DISSOLVE TO:)
+
+### Narrative Structures
+
+1. **Three-Act Structure** (Syd Field)
+   - Act I: Setup (25% - pages 1-30)
+   - Act II: Confrontation (50% - pages 30-90)
+   - Act III: Resolution (25% - pages 90-120)
+
+2. **Save the Cat Beat Sheet** (Blake Snyder)
+   - Opening Image, Theme Stated, Setup, Catalyst, Debate, Break into Two, B Story, Fun and Games, Midpoint, Bad Guys Close In, All Is Lost, Dark Night of the Soul, Break into Three, Finale, Final Image
+
+3. **Hero's Journey** (Joseph Campbell)
+   - Ordinary World, Call to Adventure, Refusal, Meeting the Mentor, Crossing the Threshold, Tests/Allies/Enemies, Approach, Ordeal, Reward, The Road Back, Resurrection, Return with Elixir
+
+### Character Development
+
+- **Character Arc**: Transformation from beginning to end
+- **Traits**: Physical, psychological, sociological
+- **Motivations**: Internal and external goals
+- **Relationships**: Protagonist, antagonist, allies, mentors
+- **Dialogue Voice**: Unique speech patterns per character
+
+## VS Code Integration
+
+### Better Fountain Extension
+
+1. Install: `ext install piersdeseilligny.betterfountain`
+2. Open `.fountain` files for syntax highlighting
+3. Use `Ctrl+Shift+P` → "Fountain: Export to PDF"
+
+### Fountain Syntax
+
+```fountain
+INT. COFFEE SHOP - DAY
+
+SARAH, 30s, sits alone with a laptop.
+
+SARAH
+(to herself)
+This is it. The moment of truth.
+
+She hits ENTER. Waits.
+
+FADE OUT.
+```
+
+## Export Formats
+
+- **Final Draft (.fdx)**: Industry-standard format
+- **PDF**: Print-ready screenplay
+- **HTML**: Web-friendly format
+
+## References
+
+- [AMPAS Nicholl Fellowship Requirements](https://www.oscars.org/nicholl/requirements)
+- [Fountain Specification](https://fountain.io/)
+- [Final Draft](https://www.finaldraft.com/)
+- Syd Field: "Screenplay: The Foundations of Screenwriting"
+- Blake Snyder: "Save the Cat!"
+- Joseph Campbell: "The Hero with a Thousand Faces"
+- Robert McKee: "Story"
+

package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain

@@ -0,0 +1,164 @@
+Title: THE LAST PROTOCOL
+Credit: Written by
+Author: AI Agent (Example)
+Draft date: 2026-01-30
+
+===
+
+FADE IN:
+
+EXT. TOKYO SKYLINE - NIGHT
+
+Neon lights pierce through rain. A city that never sleeps.
+
+INT. PENTHOUSE APARTMENT - CONTINUOUS
+
+Floor-to-ceiling windows overlook the city. Minimalist. Cold.
+
+ALEX CHEN, 35, ex-military, scars tell stories, stands at the window. Phone to ear.
+
+ALEX
+(into phone)
+I'm out. Find someone else.
+
+VOICE (V.O.)
+(filtered, distorted)
+You don't get to be out, Alex. Not after what you know.
+
+Alex hangs up. Tosses the phone on a glass table.
+
+A RED DOT appears on the window. Laser sight.
+
+Alex DIVES as the window EXPLODES. Glass rains down.
+
+EXT. ROOFTOP ACROSS THE STREET - CONTINUOUS
+
+SNIPER, masked, adjusts scope. Fires again.
+
+INT. PENTHOUSE APARTMENT - CONTINUOUS
+
+Alex rolls behind a concrete pillar. Pulls a GLOCK from an ankle holster.
+
+ALEX
+(to herself)
+So much for retirement.
+
+She low-crawls to a side door. Bullets PUNCH through the walls above her.
+
+INT. PENTHOUSE HALLWAY - CONTINUOUS
+
+Alex bursts through. Sprints toward the elevator.
+
+The elevator doors are CLOSING. She slides through just in time.
+
+INT. ELEVATOR - CONTINUOUS
+
+Alex catches her breath. Checks the gun. Full magazine.
+
+The elevator LURCHES. Stops between floors.
+
+VOICE (V.O.)
+(over speaker)
+Going somewhere?
+
+The lights CUT OUT. Emergency lighting kicks in. Red glow.
+
+ALEX
+(calm, deadly)
+You made a mistake.
+
+She PUNCHES through the ceiling panel. Pulls herself up.
+
+INT. ELEVATOR SHAFT - CONTINUOUS
+
+Alex climbs the cable. Hand over hand. Thirty floors up.
+
+Below, the elevator PLUMMETS. CRASHES at the bottom.
+
+Alex doesn't look down. Keeps climbing.
+
+She reaches a maintenance door. Kicks it open.
+
+INT. MAINTENANCE CORRIDOR - CONTINUOUS
+
+Narrow. Pipes and wiring. Alex moves fast.
+
+A FIGURE steps out ahead. Gun raised.
+
+OPERATIVE
+End of the line.
+
+Alex doesn't slow down. Runs STRAIGHT at him.
+
+The Operative FIRES. Alex slides under the shot. Sweeps his legs.
+
+He goes down. Alex disarms him in one fluid motion.
+
+ALEX
+Who sent you?
+
+OPERATIVE
+(laughing)
+You really don't know, do you?
+
+Alex pistol-whips him. He's out cold.
+
+She takes his radio. Listens.
+
+RADIO VOICE (V.O.)
+Target is in the maintenance level. All units converge.
+
+ALEX
+(into radio, mimicking)
+Copy that. Moving to intercept.
+
+She drops the radio. Crushes it under her boot.
+
+INT. PARKING GARAGE - MOMENTS LATER
+
+Alex emerges from a service door. Scans the area.
+
+Rows of luxury cars. Empty. Too quiet.
+
+She moves between vehicles. Reaches a BLACK MOTORCYCLE.
+
+Hotwires it in seconds. Engine ROARS to life.
+
+HEADLIGHTS flood the garage. Three BLACK SUVS screech in.
+
+ALEX
+(smirking)
+Showtime.
+
+She GUNS the throttle. The motorcycle LAUNCHES forward.
+
+The SUVs give chase. Bullets RICOCHET off concrete pillars.
+
+Alex weaves through the garage. Hits a ramp. Goes AIRBORNE.
+
+EXT. CITY STREET - CONTINUOUS
+
+The motorcycle lands hard. Alex doesn't flinch.
+
+She races through traffic. The SUVs follow, smashing through cars.
+
+PEDESTRIANS scatter. Horns BLARE.
+
+Alex spots an alley. Cuts hard right.
+
+EXT. NARROW ALLEY - CONTINUOUS
+
+Barely wide enough for the bike. The SUVs can't follow.
+
+Alex emerges on the other side. Slows down. Blends into traffic.
+
+She pulls out a burner phone. Dials.
+
+ALEX
+(into phone)
+It's me. I need a favor.
+
+FADE OUT.
+
+THE END
+

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

@@ -0,0 +1,124 @@
+{
+  "name": "screenplay",
+  "version": "1.0.0",
+  "displayName": "Screenplay Writing Standards",
+  "description": "Comprehensive screenplay writing and crafting standards for AI-driven content creation across AAA Hollywood films, independent films, TV series, web content, news broadcasts, commercials, streaming content, and live TV productions",
+  "type": "writing-standards",
+  "language": "screenplay",
+  "tags": [
+    "screenplay",
+    "writing",
+    "film",
+    "tv",
+    "narrative",
+    "dialogue",
+    "formatting",
+    "fountain",
+    "final-draft",
+    "ampas",
+    "hollywood",
+    "independent",
+    "streaming",
+    "web-content",
+    "news",
+    "commercials"
+  ],
+  "dependencies": [],
+  "augment": {
+    "characterCount": 0,
+    "priority": "high",
+    "category": "writing-standards"
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link module using: augx link writing-standards/screenplay",
+      "Configure category in .augment/screenplay-config.json",
+      "Install VS Code extension: Better Fountain (optional)",
+      "Use Fountain format (.fountain) for screenplay files"
+    ]
+  },
+  "configuration": {
+    "file": ".augment/screenplay-config.json",
+    "schema": {
+      "categories": {
+        "type": "array",
+        "items": {
+          "enum": [
+            "aaa-hollywood-films",
+            "independent-films",
+            "tv-series",
+            "web-content",
+            "news-broadcasts",
+            "commercials",
+            "streaming-content",
+            "live-tv-productions"
+          ]
+        },
+        "description": "Select screenplay categories to apply"
+      },
+      "universalRules": {
+        "type": "boolean",
+        "default": true,
+        "description": "Apply universal formatting and narrative standards"
+      },
+      "fountainFormat": {
+        "type": "boolean",
+        "default": true,
+        "description": "Use Fountain markup format"
+      },
+      "exportFormats": {
+        "type": "array",
+        "items": {
+          "enum": ["fdx", "pdf", "html"]
+        },
+        "description": "Supported export formats"
+      }
+    }
+  },
+  "contents": {
+    "rules": [
+      "universal-formatting.md",
+      "narrative-structures.md",
+      "character-development.md",
+      "dialogue-writing.md",
+      "screen-continuity.md",
+      "pacing-timing.md",
+      "diversity-inclusion.md",
+      "aaa-hollywood-films.md",
+      "independent-films.md",
+      "tv-series.md",
+      "web-content.md",
+      "news-broadcasts.md",
+      "commercials.md",
+      "streaming-content.md",
+      "live-tv-productions.md"
+    ],
+    "schemas": [
+      "character-profile.json",
+      "beat-sheet.json",
+      "plot-outline.json",
+      "trope-inventory.json"
+    ],
+    "examples": [
+      "aaa-hollywood-scene.fountain",
+      "independent-monologue.fountain",
+      "tv-episode-teaser.fountain",
+      "news-segment.fountain",
+      "commercial-30sec.fountain",
+      "character-profile-example.yaml",
+      "beat-sheet-example.yaml",
+      "plot-outline-example.yaml"
+    ]
+  },
+  "references": {
+    "ampas": "https://www.oscars.org/nicholl/requirements",
+    "fountain": "https://fountain.io/",
+    "finalDraft": "https://www.finaldraft.com/",
+    "sydField": "Screenplay: The Foundations of Screenwriting",
+    "blakeSnyder": "Save the Cat!",
+    "josephCampbell": "The Hero with a Thousand Faces",
+    "robertMcKee": "Story: Substance, Structure, Style and the Principles of Screenwriting"
+  }
+}
+