@mytechtoday/augment-extensions 1.5.1 → 1.6.0

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

@@ -124,15 +124,68 @@ augment-extensions/writing-standards/screenplay/
 │   ├── 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
+├── 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
+├── styles/                        # Sub-module: Narrative styles
+│   ├── module.json
+│   ├── README.md
+│   ├── rules/                     # Narrative style techniques
+│   │   ├── linear.md
+│   │   ├── non-linear.md
+│   │   ├── ensemble.md
+│   │   └── ... (13 narrative styles)
+│   └── examples/
+├── cinematic-styles/              # Sub-module: Film/franchise style guides
+│   ├── module.json
+│   ├── README.md
+│   ├── rules/                     # Specific film/franchise styles
+│   │   ├── mcu-avengers.md       # Marvel Cinematic Universe style
+│   │   ├── blue-ruin.md          # Blue Ruin incompetent protagonist style
+│   │   └── ... (more to be added)
+│   └── examples/
+├── genres/                        # Sub-module: Genre conventions
+│   └── ... (to be developed)
+└── themes/                        # Sub-module: Thematic integration
+    └── ... (to be developed)
+```
+
+## Sub-Modules
+
+This module is organized into several sub-modules for selective loading:
+
+### 1. Core Screenplay Standards (Main Module)
+Universal formatting, narrative structures, character development, dialogue, and category-specific rules.
+
+**Link**: `augx link writing-standards/screenplay`
+
+### 2. Narrative Styles
+Narrative style techniques (linear, non-linear, ensemble, minimalist, epic, etc.)
+
+**Link**: `augx link writing-standards/screenplay/styles`
+
+### 3. Cinematic Style Guides (NEW)
+Film and franchise-specific style guides capturing the unique voice and techniques of iconic films.
+
+**Link**: `augx link writing-standards/screenplay/cinematic-styles`
+
+**Available Styles**:
+- **MCU/Avengers** - Ensemble superhero epic with heart and humor
+- **Blue Ruin** - Incompetent protagonist thriller with realistic violence
+
+**Future Additions**: Christopher Nolan, Quentin Tarantino, Wes Anderson, Denis Villeneuve, and more
+
+### 4. Genre Conventions
+Genre-specific screenplay conventions (to be developed)
+
+### 5. Thematic Integration
+Thematic elements and integration techniques (to be developed)
 ```
 
 ## Core Guidelines

package/augment-extensions/writing-standards/screenplay/cinematic-styles/MIGRATION.md

@@ -0,0 +1,158 @@
+# Cinematic Styles Module - Migration Summary
+
+**Date**: 2026-02-22  
+**Version**: 1.0.0
+
+## Overview
+
+This document summarizes the refactoring of screenplay style guides from `ai-prompts/` into a proper sub-module structure within the screenplay module.
+
+## What Was Done
+
+### 1. Created New Sub-Module Structure
+
+Created `augment-extensions/writing-standards/screenplay/cinematic-styles/` as a new sub-module following the same pattern as the existing `styles/` sub-module.
+
+**Directory Structure**:
+```
+cinematic-styles/
+├── module.json                    # Module metadata
+├── README.md                      # Module overview and usage
+├── MIGRATION.md                   # This file
+├── rules/                         # Film/franchise style guides
+│   ├── mcu-avengers.md           # Marvel Cinematic Universe style
+│   └── blue-ruin.md              # Blue Ruin incompetent protagonist style
+└── examples/
+    └── style-applications.md      # Practical application examples
+```
+
+### 2. Migrated Style Guides
+
+**Source Files** (original location):
+- `ai-prompts/Avengers-style-guide.md` → `cinematic-styles/rules/mcu-avengers.md`
+- `ai-prompts/BlueRuin-style-guide.md` → `cinematic-styles/rules/blue-ruin.md`
+
+**Note**: Original files remain in `ai-prompts/` for now. They can be deleted once migration is verified.
+
+### 3. Created Module Metadata
+
+**module.json**:
+- Name: `cinematic-styles`
+- Version: 1.0.0
+- Character Count: ~150,000 (2 style guides)
+- Category: `screenplay`
+- Type: `writing-standards`
+
+### 4. Updated Parent Module
+
+Updated `augment-extensions/writing-standards/screenplay/module.json` to include `subModules` array documenting all available sub-modules:
+- `styles` - Narrative style techniques
+- `cinematic-styles` - Film/franchise style guides (NEW)
+- `genres` - Genre conventions (future)
+- `themes` - Thematic integration (future)
+
+Updated `augment-extensions/writing-standards/screenplay/README.md` to document the new sub-module structure.
+
+## Usage
+
+### Linking the Module
+
+```bash
+# Link the cinematic-styles sub-module
+augx link writing-standards/screenplay/cinematic-styles
+
+# Or link the entire screenplay module (includes all sub-modules)
+augx link writing-standards/screenplay
+```
+
+### Configuration
+
+Add to `.augment/screenplay-config.json`:
+
+```json
+{
+  "screenplay_enhancements": {
+    "enabled": true,
+    "features": {
+      "cinematic_styles": {
+        "enabled": true,
+        "selected": ["mcu-avengers"]
+      }
+    }
+  }
+}
+```
+
+### Querying the Module
+
+```bash
+# Show all available cinematic styles
+augx show writing-standards/screenplay/cinematic-styles
+
+# Show specific style guide
+augx show writing-standards/screenplay/cinematic-styles/mcu-avengers
+```
+
+## Benefits of This Structure
+
+1. **Modular**: Users can selectively load only the cinematic styles they need
+2. **Scalable**: Easy to add new film/franchise style guides in the future
+3. **Organized**: Clear separation between narrative styles and cinematic styles
+4. **Discoverable**: Follows established sub-module pattern (like ADR in software-architecture)
+5. **Maintainable**: Each style guide is a standalone file with clear naming
+
+## Future Additions
+
+The following cinematic style guides are planned for future releases:
+
+- **Christopher Nolan** - Non-linear, cerebral blockbusters
+- **Quentin Tarantino** - Dialogue-heavy, non-linear crime films
+- **Wes Anderson** - Symmetrical, whimsical, ensemble comedies
+- **Denis Villeneuve** - Atmospheric, slow-burn sci-fi
+- **Edgar Wright** - Fast-paced, visual comedy
+- **Coen Brothers** - Dark comedy, regional dialects
+- **Star Wars** - Space opera, hero's journey
+- **Lord of the Rings** - Epic fantasy, ensemble adventure
+- **John Wick** - Stylized action, world-building through visuals
+- **A24 Horror** - Elevated horror, slow-burn dread
+
+## Cleanup Tasks
+
+Once migration is verified:
+
+1. **Optional**: Delete original files from `ai-prompts/`:
+   - `ai-prompts/Avengers-style-guide.md`
+   - `ai-prompts/BlueRuin-style-guide.md`
+
+2. **Update**: Any references to the old file paths in documentation or prompts
+
+## Verification
+
+To verify the migration was successful:
+
+```bash
+# Check directory structure
+ls augment-extensions/writing-standards/screenplay/cinematic-styles/
+
+# Verify files exist
+cat augment-extensions/writing-standards/screenplay/cinematic-styles/rules/mcu-avengers.md | head -20
+cat augment-extensions/writing-standards/screenplay/cinematic-styles/rules/blue-ruin.md | head -20
+
+# Test linking
+augx link writing-standards/screenplay/cinematic-styles
+augx show writing-standards/screenplay/cinematic-styles
+```
+
+## Related Documentation
+
+- `augment-extensions/writing-standards/screenplay/README.md` - Main screenplay module documentation
+- `augment-extensions/writing-standards/screenplay/styles/README.md` - Narrative styles sub-module
+- `augment-extensions/writing-standards/screenplay/cinematic-styles/README.md` - This sub-module's documentation
+
+## Questions or Issues
+
+If you encounter any issues with this migration or have questions about the new structure, please refer to:
+- The main screenplay module README
+- The cinematic-styles README
+- The example applications in `examples/style-applications.md`
+

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

@@ -0,0 +1,157 @@
+# Cinematic Style Guides Module
+
+**Version**: 1.0.0  
+**Type**: Writing Standards  
+**Category**: Screenplay
+
+## Overview
+
+This module provides film and franchise-specific screenplay style guides that capture the unique voice, structure, and techniques of iconic films and cinematic universes. Each style guide is a comprehensive analysis of how specific films or franchises approach storytelling, character development, dialogue, action, pacing, and visual style.
+
+## Key Features
+
+- **Film/Franchise Specific**: Deep-dive style guides for specific films or cinematic universes
+- **Comprehensive Analysis**: Structure, dialogue, character development, visual style, sound design
+- **Practical Templates**: Scene construction templates and writing approaches
+- **Real Examples**: Actual scenes and techniques from the analyzed films
+- **Modular Activation**: Select the cinematic style that fits your screenplay vision
+
+## Available Style Guides
+
+### 1. Marvel Cinematic Universe (MCU) - Avengers Style
+**File**: `rules/mcu-avengers.md`  
+**Films Analyzed**: 20+ MCU films (2008-2021)  
+**Core Concept**: Character-driven spectacle with heart, humor, and interconnected world-building
+
+**Key Characteristics**:
+- Ensemble superhero epic
+- Quippy dialogue with emotional depth
+- Character first, spectacle second
+- Grounded spectacle with human stakes
+- Found family themes
+
+**Best For**: Superhero ensemble films, action-adventure with heart, franchise/universe building
+
+### 2. Blue Ruin - Incompetent Protagonist Thriller
+**File**: `rules/blue-ruin.md`  
+**Film**: Blue Ruin (2013) - Jeremy Saulnier  
+**Core Concept**: Authentic incompetence in a revenge narrative
+
+**Key Characteristics**:
+- Realistic protagonist limitations
+- Minimal dialogue, visual storytelling
+- Unglamorous, consequential violence
+- Slow-burn tension
+- Anti-action film approach
+
+**Best For**: Revenge thrillers, crime dramas, survival stories, anti-hero narratives
+
+## Installation
+
+### With CLI (Recommended)
+```bash
+augx link writing-standards/screenplay/cinematic-styles
+```
+
+### Manual Setup
+1. Copy `augment-extensions/writing-standards/screenplay/cinematic-styles/` to your project
+2. Reference style files in your `.augment/` configuration
+3. Configure active style in `.augment/screenplay-config.json`
+
+## Configuration
+
+Create or update `.augment/screenplay-config.json`:
+
+```json
+{
+  "screenplay_enhancements": {
+    "enabled": true,
+    "features": {
+      "cinematic_styles": {
+        "enabled": true,
+        "selected": ["mcu-avengers"]
+      }
+    }
+  }
+}
+```
+
+**Note**: Typically only ONE cinematic style should be selected per screenplay project.
+
+## Directory Structure
+
+```
+cinematic-styles/
+├── module.json           # Module metadata
+├── README.md             # This file
+├── rules/                # Film/franchise-specific style guides
+│   ├── mcu-avengers.md   # Marvel Cinematic Universe style
+│   └── blue-ruin.md      # Blue Ruin incompetent protagonist style
+└── examples/
+    └── style-applications.md
+```
+
+## Usage
+
+### Selecting a Cinematic Style
+
+When developing a screenplay, select the cinematic style that best matches your vision:
+
+```json
+{
+  "cinematic_styles": {
+    "selected": ["mcu-avengers"]
+  }
+}
+```
+
+### Applying Style Rules
+
+AI agents will automatically apply the selected cinematic style rules when:
+- Structuring the screenplay
+- Writing dialogue
+- Crafting action sequences
+- Developing characters
+- Determining pacing and tone
+- Creating visual descriptions
+
+## Future Additions
+
+This module will expand to include additional film and franchise style guides:
+
+- **Christopher Nolan** - Non-linear, cerebral blockbusters
+- **Quentin Tarantino** - Dialogue-heavy, non-linear crime films
+- **Wes Anderson** - Symmetrical, whimsical, ensemble comedies
+- **Denis Villeneuve** - Atmospheric, slow-burn sci-fi
+- **Edgar Wright** - Fast-paced, visual comedy
+- **Coen Brothers** - Dark comedy, regional dialects
+- **Star Wars** - Space opera, hero's journey
+- **Lord of the Rings** - Epic fantasy, ensemble adventure
+- **John Wick** - Stylized action, world-building through visuals
+- **A24 Horror** - Elevated horror, slow-burn dread
+- And many more...
+
+## Character Count
+
+**Current**: ~150,000 characters (2 style guides)  
+**Projected**: 500,000+ characters (10+ style guides)
+
+## Contents
+
+- `rules/mcu-avengers.md` - Marvel Cinematic Universe ensemble superhero style guide
+- `rules/blue-ruin.md` - Incompetent protagonist thriller style guide (Jeremy Saulnier)
+- `examples/style-applications.md` - Practical examples of applying cinematic styles
+
+## Related Modules
+
+- `writing-standards/screenplay` - Core screenplay standards
+- `writing-standards/screenplay/styles` - Narrative style techniques
+- `writing-standards/screenplay/genres` - Genre-specific conventions
+- `writing-standards/screenplay/themes` - Thematic integration
+
+## References
+
+- Marvel Cinematic Universe (2008-present) - Kevin Feige, Marvel Studios
+- Blue Ruin (2013) - Jeremy Saulnier (Writer/Director)
+- Additional references in individual style guide files
+

package/augment-extensions/writing-standards/screenplay/cinematic-styles/examples/style-applications.md

@@ -0,0 +1,257 @@
+# Cinematic Style Applications
+
+This document provides practical examples of how to apply specific cinematic styles to your screenplay.
+
+## MCU/Avengers Style Application
+
+### When to Use
+- Superhero ensemble films
+- Action-adventure with emotional stakes
+- Franchise/universe building
+- Character-driven spectacle
+- Stories about found family and sacrifice
+
+### Key Elements to Apply
+
+**1. Character-First Action**
+Every action sequence should reveal character and advance emotional arcs.
+
+**Example**:
+```fountain
+EXT. CITY STREET - DAY
+
+Iron Man hovers above the chaos. His HUD flashes: PEPPER - DANGER.
+
+TONY STARK
+(to himself)
+Not again. Not her.
+
+He ignores the alien army, diving toward Stark Tower.
+
+JARVIS (V.O.)
+Sir, the team needs—
+
+TONY STARK
+I don't care. Get me to Pepper. Now.
+```
+
+**2. Quippy Dialogue with Heart**
+Balance humor with genuine emotion. Jokes reveal character, not undercut stakes.
+
+**Example**:
+```fountain
+INT. QUINJET - NIGHT
+
+Steve and Tony sit in tense silence.
+
+TONY STARK
+You know, for a guy who's supposed to be
+all about teamwork, you're pretty bad at it.
+
+STEVE ROGERS
+(quiet)
+I'm trying to keep us together.
+
+TONY STARK
+By lying?
+
+Beat. Steve has no answer.
+
+TONY STARK (CONT'D)
+(softer)
+I get it. You wanted to protect me.
+But I needed the truth more than protection.
+```
+
+**3. Ensemble Balance**
+Give every character a moment to shine, even in crowded scenes.
+
+**Example**:
+```fountain
+INT. AVENGERS COMPOUND - WAR ROOM - DAY
+
+The team gathers around a holographic display.
+
+TONY STARK
+We hit them here, here, and here.
+
+NATASHA
+What about civilians?
+
+STEVE ROGERS
+We evacuate first. No exceptions.
+
+THOR
+I can create a barrier with lightning.
+
+BRUCE BANNER
+And I can... smash things, I guess.
+
+Everyone looks at him.
+
+BRUCE BANNER (CONT'D)
+What? I'm working on my contributions.
+
+Small smiles. Tension breaks.
+```
+
+## Blue Ruin Style Application
+
+### When to Use
+- Revenge thrillers
+- Crime dramas with realistic violence
+- Survival stories
+- Anti-hero narratives
+- Stories deconstructing action tropes
+
+### Key Elements to Apply
+
+**1. Authentic Incompetence**
+Protagonist struggles with tasks that action heroes make look easy.
+
+**Example**:
+```fountain
+INT. ABANDONED HOUSE - NIGHT
+
+Dwight tries to pick the lock with a paperclip. His hands shake.
+
+The paperclip bends. Breaks.
+
+He looks around. Frustrated. Desperate.
+
+Picks up a rock. Smashes the window.
+
+CRASH. Glass everywhere.
+
+He freezes. Listens. Did anyone hear?
+
+Long beat. Nothing.
+
+He climbs through. Cuts his hand on broken glass.
+
+Winces. Doesn't make a sound.
+```
+
+**2. Minimal Dialogue**
+Show, don't tell. Let silence build tension.
+
+**Example**:
+```fountain
+INT. BATHROOM - NIGHT
+
+Dwight examines the wound in the mirror. Deep. Bleeding.
+
+He opens the medicine cabinet. Finds vodka. Pours it on the wound.
+
+His face: pain. But no sound.
+
+Threads a needle. Hands shaking. Drops it.
+
+Picks it up. Tries again.
+
+Finally gets it. Starts stitching.
+
+Each stitch: wince, pause, breathe, continue.
+
+Sloppy. Uneven. But functional.
+```
+
+**3. Realistic Violence**
+Violence is messy, painful, and has lasting consequences.
+
+**Example**:
+```fountain
+INT. KITCHEN - NIGHT
+
+Dwight and Wade struggle. Both terrified.
+
+Wade's stronger. Pushes Dwight against the counter.
+
+Dwight grabs a knife. Swings wildly.
+
+Misses. Wade grabs his wrist.
+
+They crash into the table. Chairs scatter.
+
+Dwight headbutts Wade. Wade's nose breaks. Blood everywhere.
+
+They fall. Both scrambling for the knife.
+
+Wade gets it. Raises it.
+
+Dwight grabs his throat. Squeezes.
+
+Wade can't breathe. Drops the knife.
+
+Dwight doesn't let go. Keeps squeezing. Tears streaming.
+
+Wade stops moving.
+
+Dwight holds on. Ten more seconds. Twenty.
+
+Finally lets go. Sits back. Shaking. Covered in blood.
+
+No triumph. Just horror.
+```
+
+## Combining Styles (Advanced)
+
+While typically you should select ONE cinematic style per project, you can occasionally blend elements:
+
+**Example: MCU Humor + Blue Ruin Realism**
+```fountain
+INT. SAFE HOUSE - NIGHT
+
+Peter Parker tries to treat a gunshot wound. Fails miserably.
+
+PETER PARKER
+(to himself)
+Okay, YouTube said... no, wait, that's
+for a paper cut. This is... bigger.
+
+He pours hydrogen peroxide. Screams.
+
+PETER PARKER (CONT'D)
+Why does Mr. Stark make this look so easy?!
+
+He tries to stitch it. Needle won't go through.
+
+PETER PARKER (CONT'D)
+(crying)
+I should've paid attention in health class.
+```
+
+This combines Peter's nervous rambling (MCU) with realistic incompetence (Blue Ruin).
+
+## Configuration Examples
+
+### Pure MCU Style
+```json
+{
+  "cinematic_styles": {
+    "selected": ["mcu-avengers"]
+  }
+}
+```
+
+### Pure Blue Ruin Style
+```json
+{
+  "cinematic_styles": {
+    "selected": ["blue-ruin"]
+  }
+}
+```
+
+## Tips for AI Agents
+
+When applying a cinematic style:
+
+1. **Read the full style guide** before writing
+2. **Identify key characteristics** of the selected style
+3. **Apply consistently** throughout the screenplay
+4. **Don't mix styles** unless intentionally creating contrast
+5. **Reference examples** from the style guide
+6. **Maintain tone** appropriate to the style
+7. **Respect the rules** of the cinematic universe/film being emulated
+

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

@@ -0,0 +1,63 @@
+{
+  "name": "cinematic-styles",
+  "version": "1.0.0",
+  "displayName": "Cinematic Style Guides",
+  "description": "Film and franchise-specific screenplay style guides capturing the unique voice, structure, and techniques of iconic films and cinematic universes",
+  "type": "writing-standards",
+  "category": "screenplay",
+  "tags": [
+    "screenplay",
+    "cinematic-style",
+    "film-analysis",
+    "franchise",
+    "mcu",
+    "thriller",
+    "action",
+    "ensemble",
+    "character-driven"
+  ],
+  "dependencies": {
+    "required": [],
+    "optional": ["writing-standards/screenplay"]
+  },
+  "augment": {
+    "characterCount": 150000,
+    "priority": "high",
+    "category": "cinematic-styles",
+    "appliesTo": {
+      "filePatterns": [
+        "**/*.fountain",
+        "**/*.screenplay",
+        "**/screenplay/**/*.md",
+        "**/screenplays/**/*"
+      ],
+      "languages": ["fountain", "markdown"]
+    }
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link module: augx link writing-standards/screenplay/cinematic-styles",
+      "Configure active style in .augment/screenplay-config.json",
+      "Select specific film/franchise style to apply"
+    ]
+  },
+  "configuration": {
+    "schema": "../schemas/feature-selection.json",
+    "defaultConfig": {
+      "enabled": true,
+      "selected": []
+    }
+  },
+  "contents": [
+    "rules/mcu-avengers.md - Marvel Cinematic Universe ensemble superhero style",
+    "rules/blue-ruin.md - Incompetent protagonist thriller style (Jeremy Saulnier)",
+    "examples/style-applications.md - Cinematic style application examples"
+  ],
+  "references": {
+    "mcu": "Marvel Cinematic Universe (2008-present)",
+    "blueRuin": "Blue Ruin (2013) - Jeremy Saulnier",
+    "futureStyles": "Additional film/franchise styles to be added"
+  }
+}
+