@mytechtoday/augment-extensions 0.2.0 → 0.4.0

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"
+  }
+}
+

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

@@ -0,0 +1,339 @@
+# Universal Formatting Standards
+
+## Overview
+
+This document defines the universal formatting standards for screenplays based on AMPAS (Academy of Motion Picture Arts and Sciences) Nicholl Fellowship requirements and industry best practices.
+
+## Font and Typography
+
+### Required Font
+
+- **Font Family**: Courier or Courier New
+- **Font Size**: 12-point
+- **Character Spacing**: Monospaced (fixed-width)
+- **Line Spacing**: Single-spaced with double-spacing between elements
+
+**Rationale**: Courier's fixed-width characters ensure consistent page-to-screen-time ratio (~1 page = 1 minute).
+
+### DO
+
+```fountain
+INT. COFFEE SHOP - DAY
+
+SARAH enters, scanning the room.
+```
+
+### DON'T
+
+```
+INT. Coffee Shop - Day  ❌ (Wrong case)
+
+Sarah enters, scanning the room.  ❌ (Wrong font: Arial, Times New Roman)
+```
+
+## Page Margins
+
+### Standard Margins
+
+- **Top**: 1 inch
+- **Bottom**: 0.5 to 1 inch
+- **Left**: 1.5 inches
+- **Right**: 1 inch
+
+### Element-Specific Indentation
+
+- **Scene Headings**: 1.5 inches from left edge
+- **Action**: 1.5 inches from left edge
+- **Character Name**: 3.7 inches from left edge (centered)
+- **Dialogue**: 2.5 inches from left edge
+- **Parentheticals**: 3.1 inches from left edge
+- **Transitions**: 6 inches from left edge (right-aligned)
+
+## Scene Headings (Slug Lines)
+
+### Format
+
+```
+INT./EXT. LOCATION - TIME OF DAY
+```
+
+### Components
+
+1. **INT./EXT.**: Interior or Exterior
+2. **LOCATION**: Specific place (ALL CAPS)
+3. **TIME OF DAY**: DAY, NIGHT, MORNING, EVENING, CONTINUOUS, LATER
+
+### Examples
+
+```fountain
+INT. APARTMENT - NIGHT
+
+EXT. CITY STREET - DAY
+
+INT./EXT. CAR (MOVING) - CONTINUOUS
+```
+
+### DO
+
+- Use ALL CAPS for entire slug line
+- Be specific with locations
+- Use standard time indicators
+
+### DON'T
+
+- Mix case: `Int. Apartment - Night` ❌
+- Be vague: `INT. SOMEWHERE - SOMETIME` ❌
+- Omit time: `INT. APARTMENT` ❌
+
+## Action Lines (Description)
+
+### Guidelines
+
+- **Tense**: Present tense
+- **Voice**: Active voice
+- **Length**: 3-4 lines maximum per paragraph
+- **Focus**: Visual and auditory elements only
+- **Character Introductions**: ALL CAPS on first appearance
+
+### Examples
+
+```fountain
+SARAH, 30s, professional but tired, enters carrying a briefcase.
+
+She sets it down. Looks around. Something's wrong.
+
+A SHADOW moves across the wall.
+```
+
+### DO
+
+- Write what we SEE and HEAR
+- Use short, punchy paragraphs
+- Introduce characters in ALL CAPS
+- Use present tense: "She walks" not "She walked"
+
+### DON'T
+
+- Describe thoughts: "She thinks about her mother" ❌
+- Write camera directions: "CLOSE-UP on her face" ❌
+- Use passive voice: "The door is opened by her" ❌
+- Write long paragraphs (more than 4 lines) ❌
+
+## Dialogue
+
+### Format
+
+```fountain
+CHARACTER NAME
+Dialogue text here.
+```
+
+### With Parenthetical
+
+```fountain
+CHARACTER NAME
+(whispering)
+Dialogue text here.
+```
+
+### With Extension
+
+```fountain
+CHARACTER NAME (V.O.)
+Dialogue text here.
+
+CHARACTER NAME (O.S.)
+Dialogue text here.
+```
+
+### Extensions
+
+- **(V.O.)**: Voice-over (narration, internal thoughts)
+- **(O.S.)**: Off-screen (character not visible but in scene)
+- **(CONT'D)**: Continued (same character continues after action)
+- **(PRE-LAP)**: Dialogue starts before scene transition
+- **(SUBTITLE)**: Foreign language with subtitles
+
+### DO
+
+```fountain
+SARAH
+I can't believe you did this.
+
+JOHN
+(defensive)
+I had no choice.
+
+SARAH (CONT'D)
+There's always a choice.
+```
+
+### DON'T
+
+```fountain
+Sarah  ❌ (Not ALL CAPS)
+I can't believe you did this.
+
+JOHN
+(He's defensive)  ❌ (Parenthetical should be action, not description)
+I had no choice.
+```
+
+## Transitions
+
+### Standard Transitions
+
+- **FADE IN:** (opening)
+- **FADE OUT.** (ending)
+- **CUT TO:**
+- **DISSOLVE TO:**
+- **MATCH CUT TO:**
+- **SMASH CUT TO:**
+
+### Format
+
+```fountain
+FADE IN:
+
+INT. APARTMENT - NIGHT
+
+Action here.
+
+CUT TO:
+
+EXT. STREET - DAY
+
+More action.
+
+FADE OUT.
+```
+
+### DO
+
+- Use sparingly (only when necessary)
+- Right-align (except FADE IN:)
+- Follow with colon
+
+### DON'T
+
+- Overuse: Most cuts are implied ❌
+- Use camera directions: "ZOOM IN:" ❌
+- Mix case: "Cut To:" ❌
+
+## Page Numbering
+
+- **First Page**: No page number
+- **Subsequent Pages**: Top right corner, 0.5 inches from top
+- **Format**: Page number followed by period (e.g., "2.")
+
+## Title Page
+
+### Format
+
+```
+TITLE
+by
+Author Name
+
+Contact Information
+Address
+Phone
+Email
+```
+
+### DO
+
+- Center all text
+- Use title case for title
+- Include contact info bottom left
+
+### DON'T
+
+- Add graphics or logos ❌
+- Use fancy fonts ❌
+- Include copyright notices ❌
+
+## Page-to-Screen-Time Ratio
+
+**Standard**: 1 page = 1 minute of screen time
+
+### Typical Lengths
+
+- **Feature Film**: 90-120 pages
+- **TV Drama (1 hour)**: 50-60 pages
+- **TV Comedy (30 min)**: 22-25 pages
+- **Short Film**: 5-30 pages
+
+## Fountain Markup
+
+### Basic Syntax
+
+```fountain
+# Scene Heading
+INT. LOCATION - DAY
+
+# Action
+Character does something.
+
+# Dialogue
+CHARACTER
+Dialogue here.
+
+# Transition
+> FADE OUT.
+```
+
+### Character Introduction
+
+```fountain
+SARAH, 30s, enters.  # First appearance in ALL CAPS
+```
+
+### Emphasis
+
+```fountain
+*italic*
+**bold**
+***bold italic***
+_underline_
+```
+
+## Best Practices
+
+1. **Consistency**: Use same formatting throughout
+2. **Clarity**: Write visually, not literarily
+3. **Economy**: Every word counts
+4. **Readability**: White space is your friend
+5. **Industry Standard**: Follow AMPAS guidelines
+
+## Common Mistakes
+
+❌ Camera directions (CLOSE-UP, PAN TO, ZOOM IN)  
+❌ Editing notes (MONTAGE, INTERCUT)  
+❌ Music cues (unless diegetic)  
+❌ Thoughts and feelings (unless shown visually)  
+❌ Passive voice  
+❌ Past tense  
+❌ Long action paragraphs (>4 lines)  
+
+## Validation Checklist
+
+- [ ] 12-point Courier font
+- [ ] Correct margins (1.5" left, 1" top/bottom/right)
+- [ ] Scene headings in ALL CAPS
+- [ ] Action in present tense
+- [ ] Character names in ALL CAPS (dialogue)
+- [ ] Dialogue properly indented
+- [ ] Transitions right-aligned
+- [ ] Page numbers top right (except page 1)
+- [ ] ~1 page per minute ratio
+- [ ] No camera directions
+- [ ] No editing notes
+- [ ] White space for readability
+
+## References
+
+- [AMPAS Nicholl Fellowship Requirements](https://www.oscars.org/nicholl/requirements)
+- [Fountain Specification](https://fountain.io/)
+- [Final Draft Formatting Guide](https://www.finaldraft.com/)
+