@mytechtoday/augment-extensions 0.4.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md

@@ -0,0 +1,637 @@
+# Theme Integration Across Acts
+
+**Purpose**: Demonstrate how themes develop and deepen across the full three-act screenplay structure.
+
+---
+
+## Example Screenplay: "The Algorithm"
+
+**Logline**: A data scientist creates an AI that predicts crimes before they happen, but when it targets her brother, she must choose between perfect security and human freedom.
+
+**Primary Theme**: Technology  
+**Secondary Theme**: Power  
+**Tertiary Theme**: Sacrifice
+
+**Thematic Statement**: "Technology that promises perfect control ultimately controls us; freedom requires accepting uncertainty."
+
+---
+
+## Act I: Setup (Pages 1-25)
+
+### Thematic Introduction
+
+**Opening Image** (Page 1):
+```
+INT. SURVEILLANCE CENTER - NIGHT
+
+Hundreds of screens show city streets. DR. MAYA CHEN (32) 
+watches algorithms predict human behavior with 99% accuracy.
+
+On screen: A man approaches a store. Red box appears around 
+him. "SHOPLIFTING - 98% PROBABILITY."
+
+Security stops him. Finds stolen goods in his bag.
+
+Maya smiles. The system works.
+```
+
+**Thematic Setup**:
+- **Technology Theme**: AI prediction system introduced
+- **Power Theme**: Maya has power to predict and prevent crime
+- **Visual Motif**: Screens, surveillance, red boxes (control)
+- **Maya's Belief**: "Technology can create perfect security"
+
+### Character's Relationship to Theme (Pages 1-10)
+
+**Scene: Maya's Presentation to City Council**
+```
+INT. CITY HALL - DAY
+
+Maya presents to council members.
+
+MAYA
+Imagine a city with zero crime. Not 
+because we punish it, but because we 
+prevent it. The Algorithm makes this possible.
+
+COUNCILMAN TORRES
+What about privacy? Civil liberties?
+
+MAYA
+What about the victims we could save? 
+Every crime prevented is a life protected.
+
+Council votes to expand the program citywide.
+```
+
+**Thematic Elements**:
+- Maya values security over freedom
+- Technology presented as purely beneficial
+- Opposing viewpoint introduced (Torres) but dismissed
+- Maya's confidence in technology
+
+### Inciting Incident (Page 12)
+
+**Scene: The Red Box**
+```
+INT. MAYA'S APARTMENT - NIGHT
+
+Maya monitors the system from home. Her brother DANIEL (28) 
+appears on screen, walking downtown.
+
+A red box appears around him.
+
+"ASSAULT - 87% PROBABILITY. RECOMMEND INTERVENTION."
+
+Maya stares. Daniel? Impossible.
+
+She calls him. No answer.
+
+The algorithm has never been wrong.
+```
+
+**Thematic Challenge**:
+- Technology Maya trusts targets someone she loves
+- Personal stakes introduced
+- First doubt about the system
+
+### Debate (Pages 15-25)
+
+**Scene: Confronting Daniel**
+```
+INT. DANIEL'S APARTMENT - DAY
+
+Maya shows Daniel the prediction.
+
+DANIEL
+It's wrong. I'm not going to hurt anyone.
+
+MAYA
+The algorithm is 99% accurate.
+
+DANIEL
+So I'm guilty of something I haven't done?
+
+MAYA
+You're flagged for intervention. Counseling, 
+monitoring. It's preventive.
+
+DANIEL
+It's pre-crime. You're treating me like 
+a criminal for something I might do.
+
+MAYA
+To protect potential victims.
+
+DANIEL
+What about protecting me? I'm your brother!
+
+Maya hesitates. First real doubt.
+```
+
+**Thematic Development**:
+- Technology vs. human relationships
+- Security vs. freedom
+- Maya's belief challenged personally
+- Sacrifice theme introduced (brother vs. system)
+
+### Break into Act II (Page 25)
+
+**Scene: The Choice**
+```
+INT. SURVEILLANCE CENTER - NIGHT
+
+Maya's boss, DIRECTOR WALSH, reviews Daniel's file.
+
+WALSH
+Standard protocol. Mandatory monitoring.
+
+MAYA
+He's my brother. I know him.
+
+WALSH
+The algorithm knows him better. It sees 
+patterns we can't. That's the point.
+
+MAYA
+What if it's wrong?
+
+WALSH
+It's not. And if you can't be objective, 
+you're off the project.
+
+Maya looks at the screens. Daniel's red box still active.
+
+MAYA
+I'll handle it.
+
+She's committed now. But to what?
+```
+
+**Thematic Commitment**:
+- Maya chooses to stay on project (power)
+- But now has personal stake (sacrifice)
+- Technology's infallibility questioned
+- Act II journey: Can she prove the algorithm wrong?
+
+---
+
+## Act II: Confrontation (Pages 25-85)
+
+### Rising Action: Testing the Theme (Pages 25-45)
+
+**Scene: Investigating the Algorithm**
+```
+INT. MAYA'S LAB - NIGHT
+
+Maya digs into the algorithm's code. How did it flag Daniel?
+
+She finds the data points:
+- Visited gun range (legal)
+- Searched "how to fight back" (after being mugged)
+- Increased stress markers (work pressure)
+- Association with flagged individual (childhood friend)
+
+Each innocent. Together, they create a threat profile.
+
+MAYA
+(to herself)
+Context. The algorithm doesn't understand context.
+```
+
+**Thematic Exploration**:
+- Technology's limitation revealed
+- Data without context creates false conclusions
+- Maya's belief beginning to crack
+
+**Scene: The B-Story - Meeting Alex** (Page 30)
+```
+INT. COFFEE SHOP - DAY
+
+Maya meets ALEX (35), a civil liberties lawyer fighting 
+the algorithm.
+
+ALEX
+Your system is a digital panopticon. 
+People change behavior because they're 
+watched, not because they're safer.
+
+MAYA
+If it prevents crime—
+
+ALEX
+At what cost? Freedom? Privacy? The 
+presumption of innocence?
+
+MAYA
+Those are luxuries victims don't have.
+
+ALEX
+And what happens when the algorithm 
+targets you? Or someone you love?
+
+Maya doesn't answer. He's hit the truth.
+```
+
+**Thematic Function**:
+- Alex represents opposing thematic view
+- Challenges Maya's beliefs
+- Foreshadows her journey
+- Romance subplot tied to theme
+
+### Midpoint: False Victory (Page 55)
+
+**Scene: Proving Daniel's Innocence**
+```
+INT. SURVEILLANCE CENTER - DAY
+
+Maya presents her findings to Walsh.
+
+MAYA
+The algorithm misinterpreted the data. 
+Daniel isn't a threat.
+
+WALSH
+The algorithm doesn't misinterpret. 
+It calculates probability.
+
+MAYA
+Based on flawed assumptions.
+
+WALSH
+Based on patterns that predict behavior 
+with 99% accuracy.
+
+MAYA
+What about the 1%?
+
+WALSH
+Acceptable margin of error.
+
+MAYA
+Not when it's my brother.
+
+Walsh removes Daniel's red box. Victory.
+
+WALSH
+But we're adding more surveillance. 
+To improve accuracy.
+
+Maya realizes: She hasn't fixed the problem. 
+She's made it worse.
+```
+
+**Thematic Turning Point**:
+- Apparent victory (Daniel cleared)
+- But system expands (power grows)
+- Maya realizes she's part of the problem
+- Technology theme deepens: Control increases
+
+### Complications: Theme Deepens (Pages 55-75)
+
+**Scene: The System Expands**
+```
+INT. CITY STREETS - DAY (MONTAGE)
+
+Red boxes appear everywhere. More people flagged.
+
+- A teenager flagged for "truancy probability"
+- A woman flagged for "fraud probability"
+- An elderly man flagged for "dementia-related danger"
+
+The algorithm is predicting everything. Controlling everything.
+
+Maya watches from the surveillance center. 
+She created this.
+```
+
+**Thematic Escalation**:
+- Technology controlling all aspects of life
+- Power corrupting (even with good intentions)
+- Maya's responsibility for consequences
+
+**Scene: Personal Cost**
+```
+INT. MAYA'S APARTMENT - NIGHT
+
+Alex confronts Maya.
+
+ALEX
+You're expanding the system? After 
+what happened with Daniel?
+
+MAYA
+I'm trying to fix it from inside.
+
+ALEX
+You're enabling it. Every day it runs, 
+more people lose their freedom.
+
+MAYA
+And more people are protected!
+
+ALEX
+Are they? Or are they just controlled?
+
+MAYA
+There's a difference.
+
+ALEX
+Is there?
+
+He leaves. Maya alone with her screens.
+```
+
+**Thematic Cost**:
+- Relationship sacrificed for system
+- Maya isolated by power
+- Technology separating her from humanity
+
+### All Is Lost (Page 75)
+
+**Scene: The Algorithm Targets Maya**
+```
+INT. SURVEILLANCE CENTER - NIGHT
+
+Maya's own face appears on screen. Red box.
+
+"SYSTEM SABOTAGE - 94% PROBABILITY. RECOMMEND IMMEDIATE REMOVAL."
+
+WALSH
+The algorithm flagged you.
+
+MAYA
+That's insane. I created it!
+
+WALSH
+And you've been accessing restricted files, 
+questioning the system, showing bias. 
+The algorithm sees a threat.
+
+MAYA
+I'm trying to improve it!
+
+WALSH
+Or destroy it. Security will escort you out.
+
+Maya looks at the screens. The system she created 
+has turned against her.
+```
+
+**Thematic Crisis**:
+- Technology controlling creator
+- Power consuming those who wield it
+- Maya loses everything
+- Ultimate irony: Victim of her own creation
+
+### Dark Night of the Soul (Pages 75-85)
+
+**Scene: Confronting the Truth**
+```
+INT. MAYA'S APARTMENT - NIGHT
+
+Maya sits in darkness. No screens. No technology.
+
+Daniel arrives.
+
+DANIEL
+I heard. I'm sorry.
+
+MAYA
+You were right. All of you were right.
+
+DANIEL
+About what?
+
+MAYA
+The algorithm. It doesn't create safety. 
+It creates control. And I... I built a prison.
+
+DANIEL
+So tear it down.
+
+MAYA
+How? I have no access. No authority.
+
+DANIEL
+You have something better. You know 
+how it works.
+
+Maya looks up. Realization.
+
+MAYA
+And I know how to stop it.
+```
+
+**Thematic Clarity**:
+- Maya accepts truth about technology
+- Recognizes power's corruption
+- Chooses sacrifice (career, creation) for freedom
+- Transformation complete
+
+---
+
+## Act III: Resolution (Pages 85-110)
+
+### Break into Three (Page 85)
+
+**Scene: The Plan**
+```
+INT. ALEX'S OFFICE - DAY
+
+Maya, Alex, and Daniel plan.
+
+MAYA
+The algorithm has a kill switch. 
+Hardcoded. In case of catastrophic failure.
+
+ALEX
+Can you access it?
+
+MAYA
+Not remotely. I'd need to be in the 
+server room.
+
+DANIEL
+They'll never let you in.
+
+MAYA
+They will if the algorithm tells them to.
+
+She smiles. She's going to hack her own creation.
+```
+
+**Thematic Action**:
+- Using technology against itself
+- Reclaiming power for freedom
+- Sacrifice accepted (this will end her career)
+
+### Climax (Pages 95-105)
+
+**Scene: Infiltration**
+```
+INT. SURVEILLANCE CENTER - NIGHT
+
+Maya enters. Security stops her.
+
+SECURITY
+You're flagged. You can't be here.
+
+Maya holds up her phone. The algorithm's interface.
+
+MAYA
+Check again.
+
+Security checks. Maya's red box is gone.
+
+SECURITY
+You're cleared. Sorry, Dr. Chen.
+
+Maya walks past. She's hacked the algorithm to clear herself.
+
+INT. SERVER ROOM - NIGHT
+
+Maya accesses the kill switch. Her hand hovers over it.
+
+On screens: The entire city under surveillance. 
+Thousands of red boxes. Perfect control.
+
+She thinks of Daniel. Of Alex. Of freedom.
+
+She presses the switch.
+
+The screens go dark.
+```
+
+**Thematic Climax**:
+- Maya destroys her creation
+- Chooses freedom over control
+- Sacrifices power for principles
+- Technology defeated by its creator
+
+### Resolution (Pages 105-110)
+
+**Scene: Aftermath**
+```
+INT. CITY HALL - DAY
+
+Maya testifies before the council.
+
+COUNCILMAN TORRES
+You destroyed a billion-dollar system.
+
+MAYA
+I destroyed a system that treated 
+people like data points. That punished 
+them for crimes they hadn't committed.
+
+TORRES
+It prevented crime.
+
+MAYA
+It prevented freedom. There's a difference.
+
+WALSH
+(from audience)
+The algorithm was 99% accurate!
+
+MAYA
+And 100% wrong. Because it couldn't 
+understand context. Couldn't see humanity. 
+Couldn't allow for change.
+
+She looks at Daniel in the audience.
+
+MAYA (CONT'D)
+My brother was flagged. He never 
+committed a crime. How many others 
+were condemned for possibilities?
+
+Silence.
+
+MAYA (CONT'D)
+Perfect security isn't worth losing 
+our freedom. Our privacy. Our humanity.
+
+The council votes. The program is terminated.
+```
+
+**Thematic Resolution**:
+- Technology theme: Control vs. freedom resolved
+- Power theme: Maya gives up power for principles
+- Sacrifice theme: Career sacrificed for values
+- Thematic statement proven through action
+
+### Final Image (Page 110)
+
+**Scene: New Beginning**
+```
+EXT. PARK - DAY
+
+Maya sits on a bench. No screens. No surveillance.
+
+Daniel and Alex join her.
+
+DANIEL
+What now?
+
+MAYA
+I don't know. And that's okay.
+
+ALEX
+No algorithm to predict the future?
+
+MAYA
+(smiling)
+No algorithm. Just... possibility.
+
+They sit together. Free. Uncertain. Human.
+
+FADE OUT.
+```
+
+**Thematic Closure**:
+- Visual contrast: Park (nature) vs. surveillance center (technology)
+- Uncertainty embraced (vs. algorithmic certainty)
+- Human connection (vs. digital isolation)
+- Freedom chosen (vs. controlled security)
+
+---
+
+## Thematic Tracking Across Acts
+
+### Technology Theme Arc
+
+**Act I**: Technology as solution → Perfect control possible  
+**Act II**: Technology as problem → Control becomes oppression  
+**Act III**: Technology as tool → Must serve humanity, not control it
+
+### Power Theme Arc
+
+**Act I**: Power as positive → Maya uses power to help  
+**Act II**: Power as corrupting → System consumes creator  
+**Act III**: Power as choice → Giving up power is strength
+
+### Sacrifice Theme Arc
+
+**Act I**: Sacrifice avoided → Maya doesn't see cost  
+**Act II**: Sacrifice forced → Loses relationships, position  
+**Act III**: Sacrifice chosen → Willingly gives up creation for principles
+
+---
+
+## Key Techniques Demonstrated
+
+1. **Thematic Progression**: Each act deepens understanding
+2. **Visual Consistency**: Screens/surveillance vs. nature/freedom
+3. **Character Transformation**: Belief → Doubt → Understanding → Action
+4. **Thematic Irony**: Creator becomes victim of creation
+5. **Multiple Themes**: Three themes woven together
+6. **Subtext**: Theme shown through action, not speeches
+7. **Moral Complexity**: No easy answers, genuine dilemmas
+8. **Earned Resolution**: Transformation feels deserved
+
+---
+
+**Application**: Use this structure as a template for developing your own themes across three acts.
+

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

@@ -0,0 +1,66 @@
+{
+  "name": "screenplay-themes",
+  "version": "1.0.0",
+  "displayName": "Screenplay Themes",
+  "description": "Thematic integration rules and guidelines for screenplay writing across 15+ universal themes",
+  "type": "writing-standards",
+  "category": "screenplay",
+  "tags": [
+    "screenplay",
+    "themes",
+    "storytelling",
+    "character-development",
+    "subtext"
+  ],
+  "dependencies": {
+    "required": [],
+    "optional": []
+  },
+  "augment": {
+    "characterCount": 0,
+    "priority": "high",
+    "category": "screenplay-themes",
+    "appliesTo": {
+      "filePatterns": [
+        "**/*.fountain",
+        "**/*.screenplay",
+        "**/screenplay/**/*.md"
+      ],
+      "languages": ["fountain", "markdown"]
+    }
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link module: augx link writing-standards/screenplay/themes",
+      "Configure themes in .augment/screenplay-config.json",
+      "Select specific themes to integrate"
+    ]
+  },
+  "configuration": {
+    "schema": "../schemas/feature-selection.json",
+    "defaultConfig": {
+      "enabled": true,
+      "selected": []
+    }
+  },
+  "contents": [
+    "rules/redemption.md - Redemption theme integration",
+    "rules/love.md - Love theme integration",
+    "rules/revenge.md - Revenge theme integration",
+    "rules/identity.md - Identity theme integration",
+    "rules/power.md - Power theme integration",
+    "rules/survival.md - Survival theme integration",
+    "rules/friendship.md - Friendship theme integration",
+    "rules/betrayal.md - Betrayal theme integration",
+    "rules/growth.md - Growth theme integration",
+    "rules/isolation.md - Isolation theme integration",
+    "rules/justice.md - Justice theme integration",
+    "rules/ambition.md - Ambition theme integration",
+    "rules/fate.md - Fate theme integration",
+    "rules/technology.md - Technology's Impact theme integration",
+    "rules/environment.md - Environmental Concerns theme integration",
+    "examples/theme-integrations.md - Theme integration examples"
+  ]
+}
+

package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep

@@ -0,0 +1,2 @@
+# Placeholder for themes/rules directory
+