@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/_templates/style-template.md

@@ -0,0 +1,243 @@
+# [Style Name] Narrative Style
+
+**Category**: Screenplay Narrative Style  
+**Type**: [Structural/Tonal/Technical]  
+**Complexity**: [Low/Medium/High]
+
+## Overview
+
+[Brief description of the narrative style - 2-3 sentences explaining what defines this approach]
+
+## Core Concept
+
+[Detailed explanation of the style's fundamental characteristics and what makes it unique]
+
+## Definition
+
+[Clear, precise definition of this narrative style and when it should be used]
+
+## Structural Requirements
+
+### Requirement 1: [Requirement Name]
+
+**Description**: [What this structural requirement entails]
+
+**Why It Matters**: [Explanation of why this is essential to the style]
+
+**Implementation**:
+- [How to implement this requirement]
+- [Technical considerations]
+- [Formatting implications]
+
+**Examples**:
+- ✅ **Good**: [Example demonstrating correct application]
+- ❌ **Bad**: [Example demonstrating violation]
+
+**Film Reference**: [Film title] - [Specific scene or structural element]
+
+---
+
+### Requirement 2: [Requirement Name]
+
+[Repeat structure for 5-8 structural requirements]
+
+---
+
+## Pacing Guidelines
+
+### Overall Rhythm
+
+- [Description of the pacing rhythm for this style]
+- [How scenes should flow]
+- [Tempo considerations]
+
+### Scene Length
+
+- [Typical scene length for this style]
+- [When to use longer vs. shorter scenes]
+- [Pacing variations]
+
+### Act Structure
+
+- **Act I**: [Pacing approach for Act I]
+- **Act II**: [Pacing approach for Act II]
+- **Act III**: [Pacing approach for Act III]
+
+### Transitions
+
+- [How to transition between scenes in this style]
+- [Transition techniques specific to this style]
+- [What to avoid]
+
+## Visual Storytelling
+
+### Camera Work
+
+- [Camera movement approach for this style]
+- [Shot composition considerations]
+- [Visual rhythm]
+
+### Visual Motifs
+
+- [Common visual motifs for this style]
+- [Symbolic imagery]
+- [Color and lighting considerations]
+
+### Action Lines
+
+- [How to write action lines for this style]
+- [Level of detail required]
+- [Formatting approach]
+
+**Example**:
+```
+[Example action line demonstrating the style]
+```
+
+## Dialogue Approach
+
+### Dialogue Style
+
+- [How dialogue functions in this style]
+- [Dialogue density (sparse vs. heavy)]
+- [Naturalism vs. stylization]
+
+### Subtext
+
+- [How subtext works in this style]
+- [Balance between what's said and unsaid]
+
+### Formatting
+
+- [Any special dialogue formatting for this style]
+- [Parentheticals usage]
+- [Dialogue rhythm]
+
+**Example**:
+```
+CHARACTER
+[Example dialogue demonstrating the style]
+```
+
+## Technical Formatting
+
+### Page Layout
+
+- [Any special page layout considerations]
+- [White space usage]
+- [Visual density]
+
+### Scene Headings
+
+- [How to format scene headings for this style]
+- [Frequency of scene breaks]
+- [Special considerations]
+
+### Special Elements
+
+- [Any unique formatting elements for this style]
+- [Montages, flashbacks, etc.]
+- [How to indicate style-specific techniques]
+
+## Strengths and Limitations
+
+### Strengths
+
+- [Strength 1: What this style does exceptionally well]
+- [Strength 2]
+- [Strength 3]
+
+### Limitations
+
+- [Limitation 1: What this style struggles with]
+- [Limitation 2]
+- [Limitation 3]
+
+### Best Use Cases
+
+- [When to use this style]
+- [What types of stories benefit from this style]
+- [Genre compatibility]
+
+## Film Examples
+
+### Example 1: [Film Title] ([Year])
+
+**Director**: [Director Name]
+
+**Why This Style Works**: [Explanation of how this film exemplifies the style]
+
+**Key Stylistic Moments**:
+- **[Scene Description]**: [How this scene demonstrates the style]
+- **[Scene Description]**: [How this scene demonstrates the style]
+
+**Techniques Used**:
+- [Technique 1]
+- [Technique 2]
+- [Technique 3]
+
+**Structural Analysis**: [How the overall structure reflects the style]
+
+---
+
+### Example 2: [Film Title] ([Year])
+
+[Repeat for 3-5 film examples]
+
+---
+
+## Integration with Other Features
+
+### Compatible Genres
+
+- **[Genre Name]**: [How this style works with this genre]
+- **[Genre Name]**: [How this style works with this genre]
+
+### Compatible Themes
+
+- **[Theme Name]**: [How this style enhances this theme]
+- **[Theme Name]**: [How this style enhances this theme]
+
+### Style Variations
+
+- [Variation 1: How to adapt this style]
+- [Variation 2: How to adapt this style]
+
+## Common Pitfalls
+
+### Pitfall 1: [Pitfall Name]
+
+**Problem**: [Description of the common mistake]
+
+**Solution**: [How to avoid or fix this pitfall]
+
+**Example**: [Brief example]
+
+---
+
+### Pitfall 2: [Pitfall Name]
+
+[Repeat for 3-5 common pitfalls]
+
+---
+
+## Best Practices
+
+1. [Best practice 1]
+2. [Best practice 2]
+3. [Best practice 3]
+4. [Best practice 4]
+5. [Best practice 5]
+
+## Resources
+
+- [Resource 1: Book, article, or reference]
+- [Resource 2: Book, article, or reference]
+- [Resource 3: Book, article, or reference]
+
+---
+
+**Depth Coverage**: 85%  
+**Last Updated**: [Date]  
+**Version**: 1.0.0
+

package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md

@@ -0,0 +1,213 @@
+# [Theme Name] Theme
+
+**Category**: Screenplay Theme  
+**Type**: Universal Theme  
+**Complexity**: [Low/Medium/High]
+
+## Overview
+
+[Brief description of the theme - 2-3 sentences explaining what this theme explores]
+
+## Core Concept
+
+[Detailed explanation of the theme's fundamental meaning and what it represents in storytelling]
+
+## Thematic Statement
+
+[A clear, concise statement of what this theme explores - e.g., "The theme of redemption explores whether people can truly change and atone for past mistakes"]
+
+## Core Rules
+
+### Rule 1: [Rule Name]
+
+**Description**: [What this rule requires for thematic consistency]
+
+**Why It Matters**: [Explanation of why this rule is important to the theme]
+
+**Application**:
+- **Act I**: [How to introduce this aspect of the theme]
+- **Act II**: [How to develop this aspect of the theme]
+- **Act III**: [How to resolve/payoff this aspect of the theme]
+
+**Examples**:
+- ✅ **Good**: [Example demonstrating correct thematic integration]
+- ❌ **Bad**: [Example demonstrating weak thematic integration]
+
+---
+
+### Rule 2: [Rule Name]
+
+[Repeat structure for 5-8 core rules]
+
+---
+
+## Integration Guidelines
+
+### Act I: Setup
+
+**Thematic Introduction**:
+- [How to introduce the theme in Act I]
+- [What thematic questions to raise]
+- [How to connect theme to protagonist]
+
+**Character Connection**:
+- [How protagonist relates to theme initially]
+- [What thematic wound or desire drives them]
+
+**Visual/Symbolic Introduction**:
+- [Visual motifs that represent the theme]
+- [Symbolic elements to establish]
+
+### Act II: Development
+
+**Thematic Exploration**:
+- [How to deepen the theme in Act II]
+- [What thematic conflicts to explore]
+- [How to test the protagonist's relationship to the theme]
+
+**Subtext Techniques**:
+- [How to weave theme into dialogue]
+- [How to show theme through action]
+- [How to use visual storytelling for theme]
+
+**Thematic Complications**:
+- [How the theme creates obstacles]
+- [How to challenge the protagonist's thematic beliefs]
+
+### Act III: Resolution
+
+**Thematic Payoff**:
+- [How to resolve the thematic question]
+- [What thematic transformation should occur]
+- [How to deliver thematic satisfaction]
+
+**Avoiding Preachiness**:
+- [How to convey theme without being heavy-handed]
+- [Balance between clarity and subtlety]
+
+## Character Connection
+
+### Protagonist
+
+**Thematic Relationship**: [How the protagonist embodies or struggles with this theme]
+
+**Arc Integration**: [How the character arc reflects the theme]
+
+**Key Moments**:
+- **Thematic Introduction**: [When protagonist first encounters theme]
+- **Thematic Challenge**: [When protagonist is tested by theme]
+- **Thematic Resolution**: [When protagonist resolves their relationship to theme]
+
+### Antagonist
+
+**Thematic Opposition**: [How the antagonist represents the opposite or dark side of the theme]
+
+**Thematic Function**: [What the antagonist reveals about the theme]
+
+### Supporting Characters
+
+**Thematic Mirrors**: [How supporting characters reflect different aspects of the theme]
+
+**Thematic Perspectives**: [Different viewpoints on the theme represented by supporting cast]
+
+## Subtext Techniques
+
+### Dialogue
+
+- [How to embed theme in dialogue without being obvious]
+- [Thematic questions characters should ask]
+- [Thematic conflicts in conversation]
+
+### Visual Storytelling
+
+- [Visual motifs that represent the theme]
+- [Color palette considerations]
+- [Symbolic imagery]
+
+### Action and Behavior
+
+- [How characters' actions reflect the theme]
+- [Behavioral patterns that reinforce theme]
+
+## Film Examples
+
+### Example 1: [Film Title] ([Year])
+
+**Director**: [Director Name]
+
+**Thematic Exploration**: [How this film explores the theme]
+
+**Key Thematic Moments**:
+- **[Scene Description]**: [How this scene develops the theme]
+- **[Scene Description]**: [How this scene develops the theme]
+
+**Thematic Resolution**: [How the film resolves the thematic question]
+
+**Techniques Used**:
+- [Technique 1]
+- [Technique 2]
+- [Technique 3]
+
+---
+
+### Example 2: [Film Title] ([Year])
+
+[Repeat for 3-5 film examples]
+
+---
+
+## Integration with Other Features
+
+### Compatible Genres
+
+- **[Genre Name]**: [How this theme works with this genre]
+- **[Genre Name]**: [How this theme works with this genre]
+
+### Compatible Themes (Multi-Theme Stories)
+
+- **[Theme Name]**: [How these themes work together]
+- **[Theme Name]**: [How these themes work together]
+
+### Compatible Styles
+
+- **[Style Name]**: [How this style enhances this theme]
+- **[Style Name]**: [How this style enhances this theme]
+
+## Common Pitfalls
+
+### Pitfall 1: Being Too On-the-Nose
+
+**Problem**: [Description of how writers make theme too obvious]
+
+**Solution**: [How to maintain subtlety]
+
+**Example**: [Brief example]
+
+---
+
+### Pitfall 2: [Pitfall Name]
+
+[Repeat for 3-5 common pitfalls]
+
+---
+
+## Best Practices
+
+1. [Best practice 1]
+2. [Best practice 2]
+3. [Best practice 3]
+4. [Best practice 4]
+5. [Best practice 5]
+
+## Resources
+
+- [Resource 1: Book, article, or reference]
+- [Resource 2: Book, article, or reference]
+- [Resource 3: Book, article, or reference]
+
+---
+
+**Depth Coverage**: 85%  
+**Last Updated**: [Date]  
+**Version**: 1.0.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/examples/beat-sheet-example.yaml

@@ -0,0 +1,95 @@
+# Beat Sheet Example - Save the Cat Structure
+# Demonstrates the beat-sheet.json schema usage
+# Based on a psychological thriller about a social worker
+
+title: "The Weight We Carry"
+logline: "A dedicated social worker must confront her own traumatic past when a case mirrors the addiction that destroyed her family."
+genre: "Psychological Drama/Thriller"
+targetLength: 110
+
+beats:
+  openingImage:
+    page: 1
+    description: "Sarah sits alone in her car outside a rundown apartment building at 3 AM, watching a window. She's been here before - many times. This is her life: watching, waiting, trying to save people who don't want to be saved."
+    visualMetaphor: "Sarah isolated in her car, separated from the world by glass - representing her emotional isolation and her role as observer rather than participant in life."
+
+  themeStated:
+    page: 5
+    description: "Sarah's supervisor, Dr. Hayes, tells her during a review meeting."
+    dialogue: "You can't save everyone, Sarah. And you can't save anyone if you don't save yourself first."
+
+  catalyst:
+    page: 12
+    description: "Sarah is assigned a new case: Elena Rodriguez, a young mother with a 6-year-old daughter, struggling with opioid addiction. When Sarah meets Elena, she's shocked - Elena could be her mother 25 years ago. Same age, same situation, same desperate eyes."
+    impact: "Sarah sees a chance to save the mother she couldn't save as a child. She becomes obsessed with Elena's case."
+
+  debate:
+    page: 15
+    description: "Sarah debates whether to take the case. Dr. Hayes warns her she's too personally invested. Marcus, her colleague, offers to take it instead. But Sarah can't let go - this is her chance to rewrite history."
+    internalConflict: "Should she recuse herself from a case that's clearly triggering her own trauma, or is this her opportunity to finally make things right?"
+
+  breakIntoTwo:
+    page: 25
+    description: "Sarah commits to Elena's case despite warnings. She promises Elena's daughter, Sofia, that she'll keep her family together. It's a promise she couldn't keep for her own family."
+    decision: "Sarah officially takes on Elena's case and begins intensive intervention, crossing professional boundaries in her determination to succeed."
+
+  bStory:
+    page: 30
+    description: "Marcus becomes more present in Sarah's life. He's been interested in her for months, but she's always kept him at arm's length. Now, as the case intensifies, he refuses to let her isolate herself completely."
+    characters:
+      - "Sarah Mitchell"
+      - "Marcus Thompson"
+
+  funAndGames:
+    page: 35
+    description: "Sarah throws herself into helping Elena. We see her success: Elena enters rehab, starts attending meetings, reconnects with her daughter. Sarah feels like she's finally winning. She also begins to open up to Marcus, allowing small moments of connection."
+    setpieces:
+      - "Emotional breakthrough session with Elena"
+      - "Sarah and Marcus's first real conversation over late-night coffee"
+      - "Sofia's joy when Elena completes 30 days sober"
+      - "Sarah letting Marcus see her apartment (her private space) for the first time"
+
+  midpoint:
+    page: 55
+    description: "False victory: Elena celebrates 60 days sober. Sarah is praised at work. She and Marcus share their first kiss. For the first time in years, Sarah feels like she might deserve happiness. Stakes are raised when Elena's abusive ex-boyfriend is released from prison."
+    type: "false-victory"
+    stakeRaise: "Elena's ex, the source of her trauma and addiction, returns. Sarah's personal investment deepens as she sees parallels to her own mother's destructive relationships."
+
+  badGuysCloseIn:
+    page: 60
+    description: "Elena's ex manipulates his way back into her life. Elena starts missing meetings. Sarah becomes increasingly desperate, working longer hours, neglecting her own wellbeing. Marcus tries to help but Sarah pushes him away. Dr. Hayes threatens to remove Sarah from the case."
+    escalation:
+      - "Elena misses a supervised visit with Sofia"
+      - "Sarah finds evidence Elena is using again"
+      - "Marcus confronts Sarah about her obsessive behavior"
+      - "Dr. Hayes officially warns Sarah about boundary violations"
+      - "Sarah's own trauma symptoms intensify - insomnia, anxiety, flashbacks"
+
+  allIsLost:
+    page: 75
+    description: "Elena overdoses. She survives, but Sofia is removed from her care and placed in foster care. Sarah has failed - just like she failed her mother. Dr. Hayes removes her from the case. Marcus tells her he can't watch her destroy herself anymore."
+    whiffOfDeath: "Elena's overdose mirrors Sarah's mother's death. Sarah has a panic attack, reliving finding her mother's body."
+
+  darkNightOfTheSoul:
+    page: 85
+    description: "Sarah sits alone in her apartment, surrounded by Elena's case files. She's lost everything - the case, Marcus, her sense of purpose. She looks at an old photo of her mother and realizes: she's been trying to save her mother through Elena, but her mother is gone. She can't change the past."
+    realization: "Sarah realizes she's been running from her own pain by trying to fix everyone else. She can't save Elena or anyone else until she confronts her own trauma and accepts that her mother's death wasn't her fault."
+
+  breakIntoThree:
+    page: 90
+    description: "Sarah does something she's never done: she asks for help. She calls Marcus and admits she needs support. She starts seeing a therapist. She visits Elena in the hospital - not as a savior, but as someone who understands."
+    solution: "Instead of trying to save Elena, Sarah offers her something more valuable: the truth that recovery is possible, but it has to be Elena's choice, not Sarah's mission."
+
+  finale:
+    page: 95
+    description: "Sarah testifies at Elena's custody hearing. Instead of making promises she can't keep, she tells the truth: recovery is hard, relapse is part of the process, but Elena deserves the chance to fight for her daughter. Elena chooses rehab - for herself, not for Sarah. Sarah reconnects with Marcus, this time with honesty and vulnerability. She begins her own healing journey."
+    climax: "Elena must choose between her ex and her daughter. Sarah must choose between her savior complex and genuine connection."
+    resolution: "Elena chooses recovery (though the outcome is uncertain). Sarah chooses vulnerability and begins building real relationships. Sofia gets a chance at stability, whether with Elena or in a loving foster home."
+
+  finalImage:
+    page: 110
+    description: "Sarah sits in her car outside an apartment building - but this time, Marcus is with her. She's not alone anymore. She's not watching from outside; she's part of the world. She gets out of the car and walks toward her own apartment, toward her own life."
+    transformation: "The opening image showed Sarah isolated, watching life from behind glass. The final image shows her connected, participating, moving forward. She's learned that she can't save everyone, but she can save herself - and that's enough."
+
+notes: "This beat sheet follows the Save the Cat structure while telling a character-driven story about trauma, codependency, and healing. The external plot (saving Elena) drives the internal plot (Sarah saving herself). Each beat serves both the plot and character arc."
+