@mytechtoday/augment-extensions 0.4.0 → 0.7.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/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."
+

package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml

@@ -0,0 +1,116 @@
+# Character Profile Example
+# Demonstrates the character-profile.json schema usage
+
+name: "Sarah Mitchell"
+role: "protagonist"
+age: 32
+gender: "Female"
+
+physicalDescription:
+  height: "5'6\""
+  build: "Athletic, runner's physique"
+  hairColor: "Dark brown, shoulder-length"
+  eyeColor: "Green"
+  distinguishingFeatures:
+    - "Small scar above left eyebrow from childhood accident"
+    - "Wears her grandmother's silver locket"
+  appearance: "Professional but approachable. Often wears practical clothing - jeans, comfortable shoes. Minimal makeup. Carries herself with quiet confidence that masks deep insecurity."
+
+personality:
+  traits:
+    - "Intelligent and analytical"
+    - "Compassionate but guarded"
+    - "Perfectionist"
+    - "Self-sacrificing"
+    - "Struggles with vulnerability"
+  strengths:
+    - "Problem-solving ability"
+    - "Empathy for others"
+    - "Determination and resilience"
+    - "Loyalty to those she cares about"
+  weaknesses:
+    - "Difficulty trusting others"
+    - "Tendency to isolate when stressed"
+    - "Fear of failure"
+    - "Puts others' needs before her own to a fault"
+  fears:
+    - "Abandonment"
+    - "Being a burden to others"
+    - "Losing control"
+    - "Repeating her mother's mistakes"
+  desires:
+    - "To build meaningful connections"
+    - "To prove her worth"
+    - "To break free from her past"
+    - "To find a place where she belongs"
+
+backstory:
+  summary: "Raised by a single mother who struggled with addiction, Sarah learned early to be self-reliant. She put herself through college, became a social worker, and dedicated her life to helping others - perhaps as a way to save the mother she couldn't save as a child."
+  formativeEvents:
+    - event: "Mother's first overdose"
+      age: 8
+      impact: "Learned she couldn't rely on adults to take care of her. Became hyper-responsible and self-sufficient."
+    - event: "Placed in foster care temporarily"
+      age: 12
+      impact: "Developed deep fear of abandonment and loss of control. Vowed never to be helpless again."
+    - event: "Mother's death from overdose"
+      age: 19
+      impact: "Reinforced belief that she failed to save someone she loved. Drives her work as a social worker but also her inability to accept help."
+    - event: "Failed engagement at 28"
+      age: 28
+      impact: "Confirmed her fear that she's incapable of maintaining close relationships. Withdrew further emotionally."
+  family: "Only child. Mother deceased. Father unknown. No extended family connections."
+  education: "Bachelor's in Social Work from state university. Graduated with honors while working two jobs."
+  occupation: "Social worker specializing in addiction and family services"
+
+motivations:
+  externalGoal: "To save a troubled family from the same fate as her own"
+  internalGoal: "To learn that she's worthy of love and doesn't have to earn her place in the world"
+  stakes: "If she fails, she'll confirm her deepest fear - that she's fundamentally broken and incapable of saving anyone, including herself"
+  conflictingMotivations:
+    - "Wants to help others but fears getting too close"
+    - "Desires connection but pushes people away"
+    - "Needs to be in control but must learn to trust"
+
+characterArc:
+  arcType: "positive"
+  startingState: "Emotionally isolated, believes she must handle everything alone, defines her worth by her ability to save others"
+  endingState: "Learns to accept help, builds genuine connections, understands that her worth isn't dependent on being perfect or saving everyone"
+  transformation: "From self-reliant isolation to vulnerable connection. Learns that asking for help isn't weakness and that she deserves love not because of what she does, but because of who she is."
+
+relationships:
+  - character: "Marcus Thompson"
+    relationship: "Colleague and potential love interest"
+    description: "Fellow social worker who sees through Sarah's walls. Patient, kind, but won't let her push him away completely."
+    conflictPoints:
+      - "Sarah's inability to accept his help or support"
+      - "Her tendency to prioritize work over personal connection"
+      - "His frustration with her self-destructive patterns"
+  
+  - character: "Elena Rodriguez"
+    relationship: "Client/Mirror character"
+    description: "Young mother struggling with addiction. Reminds Sarah of her own mother. Their relationship becomes the catalyst for Sarah's transformation."
+    conflictPoints:
+      - "Sarah's over-identification with Elena's situation"
+      - "Professional boundaries vs. personal investment"
+      - "Elena's resistance to help mirrors Sarah's own patterns"
+  
+  - character: "Dr. Patricia Hayes"
+    relationship: "Mentor/Supervisor"
+    description: "Sarah's supervisor who recognizes Sarah's talent but worries about her burnout and emotional isolation."
+    conflictPoints:
+      - "Patricia pushes Sarah to take care of herself"
+      - "Challenges Sarah's belief that she must save everyone"
+      - "Forces Sarah to confront her own trauma"
+
+voice:
+  speechPattern: "Measured and professional in work settings. More hesitant and uncertain in personal conversations. Uses humor as deflection."
+  vocabulary: "Professional social work terminology when discussing cases. Simpler, more vulnerable language when discussing personal matters (though she rarely does)."
+  catchphrases:
+    - "I'm fine" (when she's clearly not)
+    - "I've got it handled" (when she's overwhelmed)
+    - "It's not about me" (deflecting from her own needs)
+  accent: "Neutral American, slight working-class inflections that emerge when stressed"
+
+notes: "Sarah's journey is about learning that vulnerability is strength, not weakness. Her arc parallels Elena's - as Sarah helps Elena, she must confront her own need for help. The key is that Sarah can't save Elena (or anyone) until she learns to save herself by accepting that she doesn't have to do it alone."
+

package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain

@@ -0,0 +1,151 @@
+Title: MOUNTAIN PEAK COFFEE - 30 SECOND SPOT
+Credit: Written by
+Author: Example Commercial Script
+Draft date: 01/31/2026
+Format: Commercial
+
+===
+
+COMMERCIAL: MOUNTAIN PEAK COFFEE
+LENGTH: :30
+CLIENT: Mountain Peak Coffee Co.
+PRODUCT: Premium Organic Coffee
+TARGET: Adults 25-45, coffee enthusiasts
+
+---
+
+FADE IN:
+
+EXT. MOUNTAIN SUMMIT - DAWN
+
+Golden sunlight breaks over a snow-capped mountain peak. Breathtaking vista.
+
+SUPER: "5:47 AM"
+
+:00-:03
+
+A HIKER (30s) reaches the summit, removes backpack, pulls out a thermos.
+
+:03-:06
+
+CLOSE ON: Steam rising from the thermos as she pours coffee into a cup.
+
+:06-:08
+
+She takes a sip. Eyes close. Moment of pure satisfaction.
+
+:08-:10
+
+WIDE SHOT: Hiker silhouetted against the sunrise, coffee in hand.
+
+:10-:12
+
+VOICEOVER (V.O.)
+(warm, authentic)
+Some moments deserve exceptional coffee.
+
+:12-:15
+
+QUICK CUTS:
+- Coffee beans being roasted
+- Hands carefully packaging coffee
+- Mountain Peak Coffee logo on bag
+
+:15-:18
+
+VOICEOVER (V.O.)
+Mountain Peak Coffee. Organically grown at high altitude. Roasted in small batches. Crafted for moments that matter.
+
+:18-:24
+
+BACK TO: Hiker on summit, taking another sip, smiling at the view.
+
+:24-:26
+
+PRODUCT SHOT: Mountain Peak Coffee bag against mountain backdrop.
+
+SUPER: "MOUNTAIN PEAK COFFEE"
+SUPER: "Elevate Your Morning"
+
+:26-:28
+
+VOICEOVER (V.O.)
+Mountain Peak Coffee. Elevate your morning.
+
+:28-:30
+
+FADE OUT.
+
+---
+
+PRODUCTION NOTES:
+
+VISUAL STYLE:
+- Natural lighting, golden hour cinematography
+- Authentic, documentary feel
+- Emphasis on natural beauty and craftsmanship
+
+MUSIC:
+- Gentle acoustic guitar
+- Builds subtly with sunrise
+- Warm, inviting tone
+
+SOUND DESIGN:
+- Mountain wind (subtle)
+- Coffee pouring
+- Thermos opening
+- Natural ambiance
+
+TALENT:
+- 1 principal (hiker)
+- Authentic, relatable, diverse casting
+
+LOCATIONS:
+- Mountain summit (sunrise shoot)
+- Coffee roasting facility (B-roll)
+
+PROPS:
+- Hiking gear (backpack, thermos)
+- Mountain Peak Coffee products
+- Coffee brewing equipment
+
+CALL TO ACTION:
+- Brand name and tagline
+- Emphasis on quality and experience
+- Emotional connection to product
+
+BRAND MESSAGING:
+- Premium quality
+- Organic/sustainable
+- Craftsmanship
+- Moments that matter
+- Authentic experience
+
+TARGET EMOTION:
+- Aspiration
+- Satisfaction
+- Connection to nature
+- Quality of life
+
+---
+
+SHOT LIST:
+
+1. Wide: Mountain peak at dawn (:00-:03)
+2. Medium: Hiker reaching summit (:03-:06)
+3. Close: Coffee pouring from thermos (:06-:08)
+4. Close: Hiker's face, eyes closed, sipping (:08-:10)
+5. Wide: Silhouette against sunrise (:10-:12)
+6. Close: Coffee beans roasting (:15-:16)
+7. Close: Hands packaging coffee (:16-:17)
+8. Close: Mountain Peak logo (:17-:18)
+9. Medium: Hiker enjoying view (:24-:26)
+10. Product shot: Coffee bag (:26-:28)
+
+TIMING BREAKDOWN:
+- Opening visual: 12 seconds
+- VO + product shots: 12 seconds
+- Closing visual + CTA: 6 seconds
+
+END COMMERCIAL
+

package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain

@@ -0,0 +1,67 @@
+Title: The Weight of Silence
+Credit: Written by
+Author: Example Screenplay
+Draft date: 01/31/2026
+Contact:
+    Example Productions
+    example@screenplay.com
+
+===
+
+INT. SMALL APARTMENT - NIGHT
+
+A cramped studio apartment. Peeling wallpaper. A single window overlooks a fire escape. SARAH (32), disheveled, sits on the edge of a worn couch, staring at a photograph in her hands.
+
+The room is silent except for the distant hum of traffic.
+
+She sets the photo down gently on the coffee table - it shows a younger version of herself with a man, both smiling.
+
+SARAH
+(quietly, to herself)
+You know what the hardest part is?
+
+She stands, walks to the window. Her reflection stares back at her.
+
+SARAH (CONT'D)
+It's not the big moments. Not the funeral, not the condolences, not even the empty side of the bed.
+
+She touches the glass, her fingers leaving prints.
+
+SARAH (CONT'D)
+It's the small things. The way you'd leave your coffee cup on the counter, half-finished. How you'd hum that stupid song in the shower - what was it? Something from the eighties.
+
+A bitter laugh escapes her.
+
+SARAH (CONT'D)
+I used to hate that. The humming. The half-finished coffee. The way you'd leave your shoes right in the middle of the hallway where I'd trip over them every single morning.
+
+She turns away from the window, her voice breaking.
+
+SARAH (CONT'D)
+And now... now I'd give anything to trip over those shoes one more time. To hear that off-key humming. To pour out that cold coffee and complain about the waste.
+
+She sinks back onto the couch, picking up the photograph again.
+
+SARAH (CONT'D)
+Everyone keeps telling me it gets easier. That time heals. But they don't understand - I don't want it to get easier. Because easier means forgetting. And forgetting means losing you all over again.
+
+Tears stream down her face now.
+
+SARAH (CONT'D)
+So I keep your coffee cup on the counter. I play that eighties song every morning. I leave your shoes in the hallway.
+
+She clutches the photograph to her chest.
+
+SARAH (CONT'D)
+Because if I can't have you here... at least I can keep you close. Even if it hurts. Especially because it hurts.
+
+She closes her eyes, rocking slightly.
+
+SARAH (CONT'D)
+(whispered)
+I'm not ready to let go. I don't know if I ever will be.
+
+The room falls silent again. Sarah sits motionless, the photograph pressed against her heart.
+
+FADE OUT.
+