@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/README.md

@@ -0,0 +1,300 @@
+# Screenplay Writing Standards
+
+## Overview
+
+Comprehensive screenplay writing and crafting standards for AI-driven content creation across multiple formats and industries.
+
+**Version**: 1.0.0
+**Type**: writing-standards
+**Character Count**: ~163,500
+
+## Key Benefits
+
+✅ **Industry-Standard Formatting** - AMPAS Nicholl Fellowship formatting standards  
+✅ **Narrative Frameworks** - Syd Field, Blake Snyder, Joseph Campbell structures  
+✅ **Category-Specific Rules** - 8 screenplay categories (Hollywood, indie, TV, web, news, commercials, streaming, live TV)  
+✅ **Character Development** - Programmatic character arcs, traits, motivations  
+✅ **Dialogue Mastery** - Natural speech, subtext, character voice  
+✅ **Screen Continuity** - Visual consistency rules (180-degree rule, match cuts)  
+✅ **Fountain Format** - Industry-standard plain-text screenplay markup  
+✅ **VS Code Integration** - Better Fountain extension support  
+✅ **Export Tools** - Final Draft (.fdx), PDF, HTML export
+
+## Installation
+
+### With CLI (Recommended)
+
+```bash
+augx link writing-standards/screenplay
+```
+
+### Manual Setup
+
+1. Copy `augment-extensions/writing-standards/screenplay/` to your project
+2. Create `.augment/screenplay-config.json` with category selection
+3. Reference rule files in your AI prompts
+
+## Configuration
+
+Create `.augment/screenplay-config.json`:
+
+```json
+{
+  "categories": ["aaa-hollywood-films"],
+  "universalRules": true,
+  "fountainFormat": true,
+  "exportFormats": ["fdx", "pdf"]
+}
+```
+
+### Available Categories
+
+1. **aaa-hollywood-films** - AAA Hollywood blockbusters
+2. **independent-films** - Independent/art-house films
+3. **tv-series** - Television series (episodic)
+4. **web-content** - Web series and short-form content
+5. **news-broadcasts** - News segments and broadcasts
+6. **commercials** - Advertising and commercials
+7. **streaming-content** - Streaming platform content
+8. **live-tv-productions** - Live TV productions
+
+## Directory Structure
+
+```
+augment-extensions/writing-standards/screenplay/
+├── module.json                    # Module metadata
+├── README.md                      # This file
+├── rules/                         # Screenplay writing rules
+│   ├── universal-formatting.md   # AMPAS formatting standards
+│   ├── narrative-structures.md   # Three-act, beat sheets, hero's journey
+│   ├── character-development.md  # Character arcs and development
+│   ├── dialogue-writing.md       # Dialogue best practices
+│   ├── screen-continuity.md      # Visual consistency rules
+│   ├── pacing-timing.md          # Pacing and timing guidelines
+│   ├── diversity-inclusion.md    # Diversity and inclusion standards
+│   ├── aaa-hollywood-films.md    # AAA Hollywood category rules
+│   ├── independent-films.md      # Independent film category rules
+│   ├── tv-series.md              # TV series category rules
+│   ├── web-content.md            # Web content category rules
+│   ├── news-broadcasts.md        # News broadcast category rules
+│   ├── commercials.md            # Commercial category rules
+│   ├── streaming-content.md      # Streaming content category rules
+│   └── live-tv-productions.md    # Live TV category rules
+├── schemas/                       # JSON schemas for screenplay data
+│   ├── character-profile.json    # Character profile schema
+│   ├── beat-sheet.json           # Beat sheet schema
+│   ├── plot-outline.json         # Plot outline schema
+│   └── trope-inventory.json      # Trope inventory schema
+└── examples/                      # Example screenplay files
+    ├── aaa-hollywood-scene.fountain
+    ├── independent-monologue.fountain
+    ├── tv-episode-teaser.fountain
+    ├── news-segment.fountain
+    ├── commercial-30sec.fountain
+    ├── character-profile-example.yaml
+    ├── beat-sheet-example.yaml
+    └── plot-outline-example.yaml
+```
+
+## Core Guidelines
+
+### Universal Formatting (AMPAS Standards)
+
+- **Font**: 12-point Courier or Courier New
+- **Margins**: 1-inch top/bottom/right, 1.5-inch left
+- **Page Length**: ~1 page per minute of screen time
+- **Scene Headings**: ALL CAPS, INT./EXT., location, time of day
+- **Action**: Present tense, active voice, visual descriptions
+- **Dialogue**: Character name centered, dialogue indented
+- **Transitions**: RIGHT-ALIGNED (FADE IN:, CUT TO:, DISSOLVE TO:)
+
+### Narrative Structures
+
+1. **Three-Act Structure** (Syd Field)
+   - Act I: Setup (25% - pages 1-30)
+   - Act II: Confrontation (50% - pages 30-90)
+   - Act III: Resolution (25% - pages 90-120)
+
+2. **Save the Cat Beat Sheet** (Blake Snyder)
+   - Opening Image, Theme Stated, Setup, Catalyst, Debate, Break into Two, B Story, Fun and Games, Midpoint, Bad Guys Close In, All Is Lost, Dark Night of the Soul, Break into Three, Finale, Final Image
+
+3. **Hero's Journey** (Joseph Campbell)
+   - Ordinary World, Call to Adventure, Refusal, Meeting the Mentor, Crossing the Threshold, Tests/Allies/Enemies, Approach, Ordeal, Reward, The Road Back, Resurrection, Return with Elixir
+
+### Character Development
+
+- **Character Arc**: Transformation from beginning to end
+- **Traits**: Physical, psychological, sociological
+- **Motivations**: Internal and external goals
+- **Relationships**: Protagonist, antagonist, allies, mentors
+- **Dialogue Voice**: Unique speech patterns per character
+
+## VS Code Integration
+
+### Better Fountain Extension
+
+1. Install: `ext install piersdeseilligny.betterfountain`
+2. Open `.fountain` files for syntax highlighting
+3. Use `Ctrl+Shift+P` → "Fountain: Export to PDF"
+
+### Fountain Syntax
+
+```fountain
+INT. COFFEE SHOP - DAY
+
+SARAH, 30s, sits alone with a laptop.
+
+SARAH
+(to herself)
+This is it. The moment of truth.
+
+She hits ENTER. Waits.
+
+FADE OUT.
+```
+
+## Export Formats
+
+### Final Draft (.fdx)
+**Industry Standard** - Most widely used professional screenplay format
+
+**Tools**:
+- **Better Fountain** (VS Code): Export → Final Draft
+- **Fountain CLI**: `fountain --fdx screenplay.fountain`
+- **Highland 2**: Native Fountain support with FDX export
+- **WriterDuet**: Import Fountain, export FDX
+
+**Use Cases**:
+- Professional submissions
+- Studio collaboration
+- Production scheduling
+- Script breakdowns
+
+### PDF
+**Print-Ready** - Universal format for reading and distribution
+
+**Tools**:
+- **Better Fountain** (VS Code): `Ctrl+Shift+P` → "Fountain: Export to PDF"
+- **Fountain CLI**: `fountain --pdf screenplay.fountain`
+- **Highland 2**: Export → PDF
+- **Wrap**: Online Fountain to PDF converter
+
+**Formatting**:
+- Industry-standard margins
+- Courier 12pt font
+- Page numbers
+- Title page
+- Proper scene numbering
+
+**Use Cases**:
+- Script distribution
+- Table reads
+- Submissions
+- Archival
+
+### HTML
+**Web-Friendly** - For online viewing and sharing
+
+**Tools**:
+- **Better Fountain** (VS Code): Export → HTML
+- **Fountain CLI**: `fountain --html screenplay.fountain`
+- **Afterwriting**: Online Fountain editor with HTML export
+
+**Features**:
+- Responsive design
+- Searchable text
+- Hyperlinked scenes
+- Mobile-friendly
+- Easy sharing
+
+**Use Cases**:
+- Online portfolios
+- Web publishing
+- Collaborative review
+- Mobile reading
+
+### Conversion Workflow
+
+**Fountain → Final Draft**:
+```bash
+# Using Better Fountain in VS Code
+1. Open .fountain file
+2. Ctrl+Shift+P
+3. "Fountain: Export to Final Draft"
+4. Save as .fdx
+```
+
+**Fountain → PDF**:
+```bash
+# Using Better Fountain in VS Code
+1. Open .fountain file
+2. Ctrl+Shift+P
+3. "Fountain: Export to PDF"
+4. Configure settings (title page, scene numbers)
+5. Save as .pdf
+```
+
+**Fountain → HTML**:
+```bash
+# Using Fountain CLI
+fountain --html screenplay.fountain > screenplay.html
+```
+
+### Recommended Tools
+
+**VS Code + Better Fountain** (Free):
+- Syntax highlighting
+- Live preview
+- Export to PDF/FDX/HTML
+- Autocomplete
+- Snippet support
+
+**Highland 2** ($50):
+- Native Fountain support
+- Professional export options
+- Revision tracking
+- Gender analysis
+- Sprint mode
+
+**WriterDuet** (Free/Pro):
+- Real-time collaboration
+- Cloud-based
+- Import/export Fountain
+- Mobile apps
+- Version control
+
+**Fade In** ($80):
+- Professional screenwriting software
+- Fountain import/export
+- Production features
+- Cross-platform
+
+### Export Best Practices
+
+**Before Exporting**:
+- ✅ Spell check
+- ✅ Verify scene headings
+- ✅ Check character name consistency
+- ✅ Review dialogue formatting
+- ✅ Confirm page count
+- ✅ Add title page
+- ✅ Number scenes (if required)
+
+**For Submissions**:
+- Use PDF for most submissions
+- Use FDX for production/collaboration
+- Include title page with contact info
+- Follow specific submission guidelines
+- Verify file size limits
+- Test file opens correctly
+
+## References
+
+- [AMPAS Nicholl Fellowship Requirements](https://www.oscars.org/nicholl/requirements)
+- [Fountain Specification](https://fountain.io/)
+- [Final Draft](https://www.finaldraft.com/)
+- Syd Field: "Screenplay: The Foundations of Screenwriting"
+- Blake Snyder: "Save the Cat!"
+- Joseph Campbell: "The Hero with a Thousand Faces"
+- Robert McKee: "Story"
+

package/augment-extensions/writing-standards/screenplay/_templates/README.md

@@ -0,0 +1,121 @@
+# Screenplay Rule Templates
+
+This directory contains templates for creating genre, theme, and style rule files.
+
+## Templates
+
+### genre-template.md
+
+Use this template when creating a new genre rule file. Each genre should include:
+
+- **Core Rules**: 5-10 fundamental rules that define the genre
+- **Guidelines**: 10-15 specific guidelines for structure, pacing, characters, tone, visuals, and dialogue
+- **Common Pitfalls**: 3-5 mistakes to avoid
+- **Film Examples**: 3-5 real films with specific scene references
+- **Integration**: How the genre works with themes and styles
+- **Best Practices**: 5+ actionable tips
+
+**Target Depth Coverage**: 85%
+
+### theme-template.md
+
+Use this template when creating a new theme rule file. Each theme should include:
+
+- **Core Rules**: 5-8 rules for thematic consistency
+- **Integration Guidelines**: How to weave the theme through Acts I, II, and III
+- **Character Connection**: How protagonist, antagonist, and supporting characters relate to the theme
+- **Subtext Techniques**: How to convey theme through dialogue, visuals, and action
+- **Film Examples**: 3-5 real films with specific thematic moments
+- **Integration**: How the theme works with genres and styles
+- **Best Practices**: 5+ actionable tips
+
+**Target Depth Coverage**: 85%
+
+### style-template.md
+
+Use this template when creating a new narrative style rule file. Each style should include:
+
+- **Structural Requirements**: 5-8 requirements specific to the style
+- **Pacing Guidelines**: How to pace scenes and acts in this style
+- **Visual Storytelling**: Camera work, visual motifs, action line approach
+- **Dialogue Approach**: How dialogue functions in this style
+- **Technical Formatting**: Special formatting considerations
+- **Film Examples**: 3-5 real films with specific stylistic moments
+- **Integration**: How the style works with genres and themes
+- **Best Practices**: 5+ actionable tips
+
+**Target Depth Coverage**: 85%
+
+## Usage
+
+1. **Copy the appropriate template** to the target directory (genres/rules/, themes/rules/, or styles/rules/)
+2. **Rename the file** to match the feature name (e.g., `action.md`, `redemption.md`, `non-linear.md`)
+3. **Fill in all sections** following the template structure
+4. **Include real film examples** with specific scenes or moments
+5. **Ensure 85% depth coverage** by providing comprehensive, actionable content
+6. **Update the parent module.json** to include the new rule file
+
+## Quality Standards
+
+### Depth Coverage (85% Target)
+
+Each rule file should be comprehensive enough that an AI agent can:
+- Understand the core concept completely
+- Apply the rules consistently
+- Identify violations or weak applications
+- Provide specific, actionable feedback
+- Reference real-world examples
+
+### Film Examples
+
+- **Minimum**: 3 film examples per rule file
+- **Recommended**: 5 film examples per rule file
+- **Requirements**:
+  - Include film title and year
+  - Name the director
+  - Describe specific scenes or moments (not just general references)
+  - Explain WHY the example works
+  - Identify specific techniques used
+
+### Rules and Guidelines
+
+- **Core Rules**: Must be specific, actionable, and enforceable
+- **Guidelines**: Should provide practical advice for implementation
+- **Examples**: Include both good (✅) and bad (❌) examples
+- **Explanations**: Explain WHY each rule matters, not just WHAT it is
+
+### AI Parsing
+
+All rule files must be:
+- **Structured**: Use consistent markdown formatting
+- **Scannable**: Use clear headings and subheadings
+- **Actionable**: Provide specific, implementable guidance
+- **Comprehensive**: Cover all aspects of the feature
+- **Referenced**: Include real-world examples
+
+## Validation Checklist
+
+Before submitting a new rule file, verify:
+
+- [ ] All template sections are filled in
+- [ ] 5-10 core rules provided (genres/styles) or 5-8 (themes)
+- [ ] 10-15 guidelines provided (genres) or integration guidelines (themes/styles)
+- [ ] 3-5 film examples with specific scenes
+- [ ] Common pitfalls identified
+- [ ] Best practices listed
+- [ ] Integration with other features documented
+- [ ] Depth coverage reaches 85%
+- [ ] Markdown formatting is consistent
+- [ ] No placeholder text remains
+- [ ] File is saved in correct directory
+- [ ] Parent module.json updated
+
+## Character Count Guidelines
+
+- **Small rule file**: < 5,000 characters
+- **Medium rule file**: 5,000 - 10,000 characters
+- **Large rule file**: 10,000 - 15,000 characters
+- **Target**: 8,000 - 12,000 characters per rule file
+
+This ensures comprehensive coverage while maintaining readability and AI parsing efficiency.
+

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

@@ -0,0 +1,153 @@
+# [Genre Name] Genre
+
+**Category**: Screenplay Genre  
+**Type**: [Primary/Hybrid]  
+**Complexity**: [Low/Medium/High]
+
+## Overview
+
+[Brief description of the genre - 2-3 sentences explaining what defines this genre]
+
+## Core Concept
+
+[Detailed explanation of the genre's fundamental characteristics and what makes it unique]
+
+## Core Rules
+
+### Rule 1: [Rule Name]
+
+**Description**: [What this rule requires]
+
+**Why It Matters**: [Explanation of why this rule is important to the genre]
+
+**Examples**:
+- ✅ **Good**: [Example demonstrating correct application]
+- ❌ **Bad**: [Example demonstrating violation]
+
+**Film Reference**: [Film title] - [Specific scene or moment that demonstrates this rule]
+
+---
+
+### Rule 2: [Rule Name]
+
+[Repeat structure for 5-10 core rules]
+
+---
+
+## Guidelines
+
+### Structure
+
+- **Act I**: [Specific structural requirements for this genre in Act I]
+- **Act II**: [Specific structural requirements for this genre in Act II]
+- **Act III**: [Specific structural requirements for this genre in Act III]
+
+### Pacing
+
+- [Pacing guideline 1]
+- [Pacing guideline 2]
+- [Pacing guideline 3]
+
+### Character Archetypes
+
+- **Protagonist**: [Typical protagonist characteristics for this genre]
+- **Antagonist**: [Typical antagonist characteristics for this genre]
+- **Supporting**: [Common supporting character types]
+
+### Tone and Atmosphere
+
+- [Tone guideline 1]
+- [Tone guideline 2]
+- [Atmosphere considerations]
+
+### Visual Style
+
+- [Visual storytelling approach for this genre]
+- [Common visual motifs]
+- [Cinematography considerations]
+
+### Dialogue
+
+- [Dialogue style for this genre]
+- [Common dialogue patterns]
+- [What to avoid]
+
+## 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]
+
+---
+
+## Film Examples
+
+### Example 1: [Film Title] ([Year])
+
+**Director**: [Director Name]
+
+**Why It Works**: [Explanation of how this film exemplifies the genre]
+
+**Key Scenes**:
+- **[Scene Description]**: [What makes this scene a perfect genre example]
+- **[Scene Description]**: [What makes this scene a perfect genre example]
+
+**Techniques Used**:
+- [Technique 1]
+- [Technique 2]
+- [Technique 3]
+
+---
+
+### Example 2: [Film Title] ([Year])
+
+[Repeat for 3-5 film examples]
+
+---
+
+## Integration with Other Features
+
+### Compatible Themes
+
+- **[Theme Name]**: [How this theme works with this genre]
+- **[Theme Name]**: [How this theme works with this genre]
+
+### Compatible Styles
+
+- **[Style Name]**: [How this style works with this genre]
+- **[Style Name]**: [How this style works with this genre]
+
+### Hybrid Combinations
+
+- **[Genre] + [This Genre]**: [How these genres combine effectively]
+
+## 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
+