@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md

@@ -0,0 +1,277 @@
+# VS Code Integration for Screenplay Writing
+
+## Overview
+
+This guide covers integrating screenplay writing tools with Visual Studio Code for professional screenplay development.
+
+---
+
+## Better Fountain Extension
+
+### Installation
+
+1. Open VS Code
+2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
+3. Search for "Better Fountain"
+4. Install the extension by Piers Deseilligny
+
+### Features
+
+**Syntax Highlighting**
+- Automatic syntax highlighting for .fountain files
+- Color-coded scene headings, character names, dialogue, action
+- Parentheticals and transitions clearly marked
+
+**Live Preview**
+- Real-time PDF preview of screenplay
+- Side-by-side editing and preview
+- Automatic page count and timing
+
+**Auto-Completion**
+- Character name auto-completion
+- Scene heading suggestions
+- Transition shortcuts
+
+**Export Options**
+- Export to PDF (industry-standard formatting)
+- Export to HTML
+- Export to Final Draft (.fdx)
+
+### Configuration
+
+Add to your `.vscode/settings.json`:
+
+```json
+{
+  "fountain.general.previewTheme": "paper",
+  "fountain.general.previewTexture": true,
+  "fountain.pdf.emboldenSceneHeaders": true,
+  "fountain.pdf.showPageNumbers": true,
+  "fountain.pdf.splitDialog": true,
+  "fountain.pdf.printTitlePage": true,
+  "fountain.pdf.printProfile": "a4",
+  "fountain.general.parentheticalNewLine": false,
+  "fountain.general.numberSections": false,
+  "fountain.general.showPageNumbers": true
+}
+```
+
+---
+
+## Fountain Format Basics
+
+### Scene Headings
+
+```fountain
+INT. COFFEE SHOP - DAY
+
+EXT. CITY STREET - NIGHT
+
+INT./EXT. CAR - MOVING - DAY
+```
+
+**Rules:**
+- Must start with INT, EXT, or INT./EXT.
+- Followed by location
+- End with time of day
+- Blank line before and after
+
+### Character Names
+
+```fountain
+SARAH
+This is dialogue.
+
+MARCUS (O.S.)
+This is off-screen dialogue.
+
+NARRATOR (V.O.)
+This is voice-over.
+```
+
+**Rules:**
+- All caps
+- Centered automatically
+- Extensions in parentheses: (O.S.), (V.O.), (CONT'D)
+
+### Dialogue
+
+```fountain
+SARAH
+I can't believe this is happening.
+
+MARCUS
+(concerned)
+Are you okay?
+```
+
+**Rules:**
+- Character name on its own line
+- Dialogue below character name
+- Parentheticals for direction/emotion
+
+### Action/Description
+
+```fountain
+Sarah walks to the window, staring out at the rain.
+
+The phone RINGS. She doesn't answer.
+```
+
+**Rules:**
+- Regular text (not all caps unless emphasizing)
+- Sound effects in ALL CAPS
+- Keep paragraphs short (3-4 lines max)
+
+### Transitions
+
+```fountain
+CUT TO:
+
+FADE OUT.
+
+DISSOLVE TO:
+```
+
+**Rules:**
+- Right-aligned (automatic in Fountain)
+- End with colon or period
+- Use sparingly
+
+---
+
+## Keyboard Shortcuts
+
+### Better Fountain Shortcuts
+
+- **Ctrl+Shift+P** (Cmd+Shift+P): Command palette
+  - "Fountain: Show Preview" - Open live preview
+  - "Fountain: Export PDF" - Export to PDF
+  - "Fountain: Statistics" - Show word count, page count, etc.
+
+### Custom Snippets
+
+Add to your user snippets (File > Preferences > User Snippets > fountain.json):
+
+```json
+{
+  "Scene Heading INT": {
+    "prefix": "int",
+    "body": [
+      "INT. ${1:LOCATION} - ${2:DAY}",
+      "",
+      "$0"
+    ]
+  },
+  "Scene Heading EXT": {
+    "prefix": "ext",
+    "body": [
+      "EXT. ${1:LOCATION} - ${2:DAY}",
+      "",
+      "$0"
+    ]
+  },
+  "Character Dialogue": {
+    "prefix": "char",
+    "body": [
+      "${1:CHARACTER}",
+      "${2:Dialogue}",
+      "",
+      "$0"
+    ]
+  }
+}
+```
+
+---
+
+## Export Workflow
+
+### PDF Export
+
+1. Open .fountain file
+2. Cmd/Ctrl+Shift+P
+3. Type "Fountain: Export PDF"
+4. Choose location and filename
+5. PDF generated with industry-standard formatting
+
+### Final Draft Export
+
+1. Open .fountain file
+2. Cmd/Ctrl+Shift+P
+3. Type "Fountain: Export to Final Draft"
+4. .fdx file created
+5. Open in Final Draft for further editing
+
+---
+
+## Project Structure
+
+Recommended folder structure for screenplay projects:
+
+```
+my-screenplay/
+├── screenplay.fountain          # Main screenplay
+├── characters/
+│   ├── sarah-profile.yaml
+│   ├── marcus-profile.yaml
+│   └── elena-profile.yaml
+├── planning/
+│   ├── beat-sheet.yaml
+│   ├── plot-outline.yaml
+│   └── trope-inventory.yaml
+├── exports/
+│   ├── screenplay-draft-1.pdf
+│   └── screenplay-draft-2.pdf
+└── .vscode/
+    └── settings.json
+```
+
+---
+
+## Tips for VS Code Screenplay Writing
+
+**Use Multi-Cursor Editing**
+- Alt+Click to add cursors
+- Useful for formatting multiple character names
+
+**Use Find and Replace**
+- Ctrl+H (Cmd+H) for find/replace
+- Useful for character name changes
+
+**Use Outline View**
+- View > Outline
+- Shows scene structure
+- Quick navigation between scenes
+
+**Use Zen Mode**
+- View > Appearance > Zen Mode
+- Distraction-free writing
+- Toggle with Ctrl+K Z (Cmd+K Z)
+
+---
+
+## Troubleshooting
+
+**Preview not showing:**
+- Ensure Better Fountain extension is installed
+- Try reloading window (Ctrl+Shift+P > "Reload Window")
+
+**Export not working:**
+- Check file permissions
+- Ensure output directory exists
+- Try exporting to different location
+
+**Formatting issues:**
+- Check Fountain syntax
+- Ensure blank lines between elements
+- Verify scene headings start with INT/EXT
+
+---
+
+## Additional Resources
+
+- Better Fountain Documentation: https://github.com/piersdeseilligny/betterfountain
+- Fountain Syntax: https://fountain.io/syntax
+- VS Code Documentation: https://code.visualstudio.com/docs
+

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)
+