@mytechtoday/augment-extensions 0.4.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/rules/web-content.md

@@ -0,0 +1,393 @@
+# Web Content
+
+## Overview
+
+Web content for platforms like YouTube, TikTok, Instagram, and other digital platforms requires immediate hooks, platform-specific optimization, and engagement-driven storytelling designed for short attention spans and algorithm-driven distribution.
+
+## Platform-Specific Formats
+
+### YouTube
+**Short-Form** (1-5 minutes):
+- Quick tutorials
+- Comedy sketches
+- Reaction videos
+- Vlogs
+
+**Mid-Form** (5-15 minutes):
+- Detailed content
+- Narrative stories
+- Documentary-style
+- Educational content
+
+**Long-Form** (15+ minutes):
+- In-depth analysis
+- Extended narratives
+- Interview format
+- Series content
+
+### TikTok/Instagram Reels/YouTube Shorts
+**Ultra-Short** (15-60 seconds):
+- Immediate hook (first 3 seconds)
+- Single concept/joke
+- Vertical format (9:16)
+- Text overlays
+- Trending audio
+
+### Instagram/Facebook
+**Stories** (15 seconds per slide):
+- Episodic content
+- Behind-the-scenes
+- Quick updates
+- Interactive elements
+
+**Feed Videos** (1-3 minutes):
+- Polished content
+- Square or vertical format
+- Captions required
+- Thumbnail optimization
+
+## Core Principles
+
+### The 3-Second Rule
+**Hook Immediately**:
+- Visual impact in first frame
+- Intriguing question
+- Shocking statement
+- Action in progress
+- Emotional trigger
+
+**Bad Opening**:
+```
+FADE IN:
+
+INT. BEDROOM - DAY
+
+Sarah wakes up, stretches, and gets out of bed.
+```
+
+**Good Opening**:
+```
+SMASH CUT TO:
+
+Sarah's phone EXPLODES with notifications. Her face
+goes pale as she reads the screen.
+```
+
+### Engagement Optimization
+**Techniques**:
+- Pattern interrupts (every 5-10 seconds)
+- Visual variety
+- Text overlays for key points
+- Music/sound effects
+- Emotional peaks and valleys
+- Call-to-action
+
+### Retention Strategies
+**Keep Viewers Watching**:
+- Tease payoff early
+- Build curiosity loops
+- Use cliffhangers
+- Promise value
+- Deliver quickly
+- Avoid slow burns
+
+## Structure for Short-Form
+
+### 15-60 Second Format
+**Structure**:
+1. **Hook** (0-3 seconds): Grab attention
+2. **Setup** (3-10 seconds): Establish premise
+3. **Development** (10-45 seconds): Build/escalate
+4. **Payoff** (45-60 seconds): Deliver resolution
+5. **CTA** (final 3 seconds): Like/follow/comment
+
+**Example**:
+```
+HOOK (0-3s):
+"This simple trick will change your life."
+
+SETUP (3-10s):
+Show problem everyone relates to.
+
+DEVELOPMENT (10-45s):
+Demonstrate solution step-by-step.
+
+PAYOFF (45-60s):
+Show amazing result.
+
+CTA (final 3s):
+"Follow for more tips!"
+```
+
+### 1-5 Minute Format
+**Structure**:
+1. **Hook** (0-10 seconds)
+2. **Promise** (10-20 seconds): What viewer will get
+3. **Content** (20 seconds - 4 minutes): Deliver value
+4. **Recap** (final 30 seconds): Summarize key points
+5. **CTA** (final 10 seconds): Subscribe/like/comment
+
+## Viral Hooks
+
+### Types of Hooks
+**Question Hook**:
+- "What would you do if..."
+- "Have you ever wondered..."
+- "Why does..."
+
+**Shock Hook**:
+- Unexpected visual
+- Surprising statement
+- Dramatic moment
+- Controversial claim
+
+**Relatability Hook**:
+- "POV: You're..."
+- "When you..."
+- "That feeling when..."
+
+**Curiosity Hook**:
+- "You won't believe..."
+- "The secret to..."
+- "What happens next..."
+
+**Value Hook**:
+- "3 ways to..."
+- "How to..."
+- "The best..."
+
+## Visual Storytelling
+
+### Vertical Format (9:16)
+**Composition**:
+- Center important elements
+- Use full vertical space
+- Text in safe zones
+- Face close-ups
+- Dynamic framing
+
+**Avoid**:
+- Horizontal compositions
+- Small text
+- Wide shots
+- Complex visuals
+
+### Text Overlays
+**Best Practices**:
+- Large, readable fonts
+- High contrast
+- Animated text
+- Key words emphasized
+- Captions for accessibility
+- Emoji for emphasis
+
+**Placement**:
+- Top third: Headlines
+- Middle: Main content
+- Bottom third: Captions/CTA
+
+### Visual Pacing
+**Techniques**:
+- Quick cuts (every 2-3 seconds)
+- Zoom transitions
+- Jump cuts
+- B-roll inserts
+- Graphics and animations
+- Color grading shifts
+
+## Audio Considerations
+
+### Music Selection
+**Purpose**:
+- Set tone and mood
+- Increase energy
+- Trending audio (TikTok/Reels)
+- Copyright-free options
+- Match pacing
+
+### Sound Effects
+**Usage**:
+- Emphasize moments
+- Create comedy
+- Build tension
+- Transition scenes
+- Enhance impact
+
+### Voiceover
+**Delivery**:
+- Energetic and engaging
+- Clear enunciation
+- Conversational tone
+- Paced for retention
+- Emotional variation
+
+## Platform Algorithms
+
+### YouTube Algorithm
+**Optimization**:
+- Click-through rate (thumbnail + title)
+- Watch time (retention)
+- Engagement (likes, comments, shares)
+- Session time (keeps viewers on platform)
+- Consistency (regular uploads)
+
+### TikTok/Reels Algorithm
+**Optimization**:
+- Completion rate (watch to end)
+- Re-watches
+- Shares
+- Comments
+- Trending audio/hashtags
+- Post timing
+
+### Engagement Metrics
+**Track**:
+- View duration
+- Drop-off points
+- Engagement rate
+- Share rate
+- Click-through rate
+- Conversion rate
+
+## Content Categories
+
+### Educational
+**Structure**:
+- Clear learning objective
+- Step-by-step instruction
+- Visual demonstrations
+- Recap key points
+- Actionable takeaways
+
+### Entertainment
+**Types**:
+- Comedy sketches
+- Challenges
+- Reactions
+- Parodies
+- Storytelling
+
+### Inspirational
+**Elements**:
+- Emotional journey
+- Relatable struggle
+- Transformation
+- Uplifting message
+- Call to action
+
+### Behind-the-Scenes
+**Content**:
+- Process reveals
+- Day-in-the-life
+- Authentic moments
+- Personality showcase
+- Community building
+
+## Call-to-Action (CTA)
+
+### Types
+**Engagement CTAs**:
+- "Like if you agree"
+- "Comment your thoughts"
+- "Share with someone who needs this"
+- "Which one are you?"
+
+**Growth CTAs**:
+- "Follow for more"
+- "Subscribe for part 2"
+- "Turn on notifications"
+- "Check out my other videos"
+
+**Conversion CTAs**:
+- "Link in bio"
+- "Visit my website"
+- "Use code..."
+- "Download now"
+
+### Placement
+- Verbal CTA at end
+- Text overlay throughout
+- Pin comment
+- Description link
+- End screen
+
+## Series and Serialization
+
+### Multi-Part Content
+**Strategy**:
+- Cliffhanger endings
+- "Part 1 of 3" labeling
+- Consistent posting schedule
+- Cross-reference parts
+- Playlist organization
+
+### Recurring Formats
+**Benefits**:
+- Brand recognition
+- Audience expectation
+- Easier production
+- Algorithm favor
+- Community building
+
+**Examples**:
+- "Myth Busting Mondays"
+- "Story Time Series"
+- "Weekly Challenges"
+- "Q&A Fridays"
+
+## Best Practices
+
+### DO
+✅ Hook in first 3 seconds
+✅ Optimize for platform format
+✅ Use captions/text overlays
+✅ Keep pacing fast
+✅ Include clear CTA
+✅ Test different hooks
+✅ Analyze retention data
+✅ Engage with comments
+✅ Post consistently
+✅ Follow platform trends
+
+### DON'T
+❌ Bury the lead
+❌ Use slow intros
+❌ Ignore platform specs
+❌ Forget captions
+❌ Make content too long
+❌ Neglect thumbnails
+❌ Ignore analytics
+❌ Copy others exactly
+❌ Sacrifice quality for speed
+❌ Forget audience retention
+
+## Scripting Format
+
+### Short-Form Script
+```
+HOOK (0-3s):
+[Visual: Close-up of shocked face]
+[Text: "I can't believe this worked"]
+[Audio: Trending sound]
+
+SETUP (3-10s):
+[Visual: Show problem]
+[VO: "I tried this viral hack..."]
+
+PAYOFF (10-30s):
+[Visual: Demonstrate result]
+[Text: "MIND BLOWN 🤯"]
+
+CTA (final 3s):
+[Text: "Follow for more hacks!"]
+```
+
+## Examples
+
+**Successful Web Content Creators**:
+- MrBeast (high-production YouTube)
+- Khaby Lame (simple TikTok comedy)
+- Zach King (magic vines/shorts)
+- Emma Chamberlain (vlog style)
+- Marques Brownlee (tech reviews)
+

package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json

@@ -0,0 +1,332 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment.dev/schemas/screenplay/beat-sheet.json",
+  "title": "Beat Sheet",
+  "description": "JSON schema for screenplay beat sheets using Save the Cat structure",
+  "type": "object",
+  "required": ["title", "beats"],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Title of the screenplay"
+    },
+    "logline": {
+      "type": "string",
+      "description": "One-sentence story summary"
+    },
+    "genre": {
+      "type": "string",
+      "description": "Story genre"
+    },
+    "targetLength": {
+      "type": "integer",
+      "description": "Target screenplay length in pages"
+    },
+    "beats": {
+      "type": "object",
+      "required": ["openingImage", "themeStated", "catalyst", "debate", "breakIntoTwo", "bStory", "funAndGames", "midpoint", "badGuysCloseIn", "allIsLost", "darkNightOfTheSoul", "breakIntoThree", "finale", "finalImage"],
+      "properties": {
+        "openingImage": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Page number (typically 1)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Opening image that sets tone and theme"
+            },
+            "visualMetaphor": {
+              "type": "string",
+              "description": "Visual metaphor for the story's theme"
+            }
+          }
+        },
+        "themeStated": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5,
+              "description": "Page number (typically 1-5)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Statement of the story's theme"
+            },
+            "dialogue": {
+              "type": "string",
+              "description": "Actual dialogue that states the theme"
+            }
+          }
+        },
+        "catalyst": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 10,
+              "maximum": 12,
+              "description": "Page number (typically 10-12)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Inciting incident that disrupts the status quo"
+            },
+            "impact": {
+              "type": "string",
+              "description": "How this event affects the protagonist"
+            }
+          }
+        },
+        "debate": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 12,
+              "maximum": 25,
+              "description": "Page number (typically 12-25)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist debates whether to act"
+            },
+            "internalConflict": {
+              "type": "string",
+              "description": "Internal struggle the protagonist faces"
+            }
+          }
+        },
+        "breakIntoTwo": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 25,
+              "maximum": 30,
+              "description": "Page number (typically 25-30)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist commits to the journey (Act 2 begins)"
+            },
+            "decision": {
+              "type": "string",
+              "description": "The specific decision or action taken"
+            }
+          }
+        },
+        "bStory": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 30,
+              "description": "Page number (typically 30)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Introduction of B-story (usually love story or relationship)"
+            },
+            "characters": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Characters involved in B-story"
+            }
+          }
+        },
+        "funAndGames": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 30,
+              "maximum": 55,
+              "description": "Page number (typically 30-55)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Promise of the premise - what the trailer would show"
+            },
+            "setpieces": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Key set pieces and fun moments"
+            }
+          }
+        },
+        "midpoint": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 55,
+              "maximum": 60,
+              "description": "Page number (typically 55-60)"
+            },
+            "description": {
+              "type": "string",
+              "description": "False victory or false defeat - stakes are raised"
+            },
+            "type": {
+              "type": "string",
+              "enum": ["false-victory", "false-defeat"],
+              "description": "Type of midpoint"
+            },
+            "stakeRaise": {
+              "type": "string",
+              "description": "How the stakes are raised"
+            }
+          }
+        },
+        "badGuysCloseIn": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 60,
+              "maximum": 75,
+              "description": "Page number (typically 60-75)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Opposition intensifies, team falls apart"
+            },
+            "escalation": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "How problems escalate"
+            }
+          }
+        },
+        "allIsLost": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 75,
+              "maximum": 85,
+              "description": "Page number (typically 75-85)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Lowest point - opposite of midpoint"
+            },
+            "whiffOfDeath": {
+              "type": "string",
+              "description": "Literal or metaphorical death moment"
+            }
+          }
+        },
+        "darkNightOfTheSoul": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 85,
+              "maximum": 90,
+              "description": "Page number (typically 85-90)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist's moment of despair and reflection"
+            },
+            "realization": {
+              "type": "string",
+              "description": "What the protagonist realizes or learns"
+            }
+          }
+        },
+        "breakIntoThree": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 90,
+              "maximum": 95,
+              "description": "Page number (typically 90-95)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Solution found - Act 3 begins"
+            },
+            "solution": {
+              "type": "string",
+              "description": "The specific solution or plan"
+            }
+          }
+        },
+        "finale": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 95,
+              "maximum": 110,
+              "description": "Page number (typically 95-110)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Climax and resolution"
+            },
+            "climax": {
+              "type": "string",
+              "description": "The climactic confrontation"
+            },
+            "resolution": {
+              "type": "string",
+              "description": "How conflicts are resolved"
+            }
+          }
+        },
+        "finalImage": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 110,
+              "description": "Page number (typically 110)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Final image - opposite of opening image showing change"
+            },
+            "transformation": {
+              "type": "string",
+              "description": "How this image shows the protagonist's transformation"
+            }
+          }
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional notes about the beat sheet"
+    }
+  }
+}
+