@mytechtoday/augment-extensions 0.4.0 → 0.7.0

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

@@ -4,9 +4,9 @@
 
 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**: ~TBD
+**Version**: 1.0.0
+**Type**: writing-standards
+**Character Count**: ~163,500
 
 ## Key Benefits
 
@@ -155,9 +155,138 @@ FADE OUT.
 
 ## Export Formats
 
-- **Final Draft (.fdx)**: Industry-standard format
-- **PDF**: Print-ready screenplay
-- **HTML**: Web-friendly format
+### 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
 

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
+

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

@@ -0,0 +1,243 @@
+# [Style Name] Narrative Style
+
+**Category**: Screenplay Narrative Style  
+**Type**: [Structural/Tonal/Technical]  
+**Complexity**: [Low/Medium/High]
+
+## Overview
+
+[Brief description of the narrative style - 2-3 sentences explaining what defines this approach]
+
+## Core Concept
+
+[Detailed explanation of the style's fundamental characteristics and what makes it unique]
+
+## Definition
+
+[Clear, precise definition of this narrative style and when it should be used]
+
+## Structural Requirements
+
+### Requirement 1: [Requirement Name]
+
+**Description**: [What this structural requirement entails]
+
+**Why It Matters**: [Explanation of why this is essential to the style]
+
+**Implementation**:
+- [How to implement this requirement]
+- [Technical considerations]
+- [Formatting implications]
+
+**Examples**:
+- ✅ **Good**: [Example demonstrating correct application]
+- ❌ **Bad**: [Example demonstrating violation]
+
+**Film Reference**: [Film title] - [Specific scene or structural element]
+
+---
+
+### Requirement 2: [Requirement Name]
+
+[Repeat structure for 5-8 structural requirements]
+
+---
+
+## Pacing Guidelines
+
+### Overall Rhythm
+
+- [Description of the pacing rhythm for this style]
+- [How scenes should flow]
+- [Tempo considerations]
+
+### Scene Length
+
+- [Typical scene length for this style]
+- [When to use longer vs. shorter scenes]
+- [Pacing variations]
+
+### Act Structure
+
+- **Act I**: [Pacing approach for Act I]
+- **Act II**: [Pacing approach for Act II]
+- **Act III**: [Pacing approach for Act III]
+
+### Transitions
+
+- [How to transition between scenes in this style]
+- [Transition techniques specific to this style]
+- [What to avoid]
+
+## Visual Storytelling
+
+### Camera Work
+
+- [Camera movement approach for this style]
+- [Shot composition considerations]
+- [Visual rhythm]
+
+### Visual Motifs
+
+- [Common visual motifs for this style]
+- [Symbolic imagery]
+- [Color and lighting considerations]
+
+### Action Lines
+
+- [How to write action lines for this style]
+- [Level of detail required]
+- [Formatting approach]
+
+**Example**:
+```
+[Example action line demonstrating the style]
+```
+
+## Dialogue Approach
+
+### Dialogue Style
+
+- [How dialogue functions in this style]
+- [Dialogue density (sparse vs. heavy)]
+- [Naturalism vs. stylization]
+
+### Subtext
+
+- [How subtext works in this style]
+- [Balance between what's said and unsaid]
+
+### Formatting
+
+- [Any special dialogue formatting for this style]
+- [Parentheticals usage]
+- [Dialogue rhythm]
+
+**Example**:
+```
+CHARACTER
+[Example dialogue demonstrating the style]
+```
+
+## Technical Formatting
+
+### Page Layout
+
+- [Any special page layout considerations]
+- [White space usage]
+- [Visual density]
+
+### Scene Headings
+
+- [How to format scene headings for this style]
+- [Frequency of scene breaks]
+- [Special considerations]
+
+### Special Elements
+
+- [Any unique formatting elements for this style]
+- [Montages, flashbacks, etc.]
+- [How to indicate style-specific techniques]
+
+## Strengths and Limitations
+
+### Strengths
+
+- [Strength 1: What this style does exceptionally well]
+- [Strength 2]
+- [Strength 3]
+
+### Limitations
+
+- [Limitation 1: What this style struggles with]
+- [Limitation 2]
+- [Limitation 3]
+
+### Best Use Cases
+
+- [When to use this style]
+- [What types of stories benefit from this style]
+- [Genre compatibility]
+
+## Film Examples
+
+### Example 1: [Film Title] ([Year])
+
+**Director**: [Director Name]
+
+**Why This Style Works**: [Explanation of how this film exemplifies the style]
+
+**Key Stylistic Moments**:
+- **[Scene Description]**: [How this scene demonstrates the style]
+- **[Scene Description]**: [How this scene demonstrates the style]
+
+**Techniques Used**:
+- [Technique 1]
+- [Technique 2]
+- [Technique 3]
+
+**Structural Analysis**: [How the overall structure reflects the style]
+
+---
+
+### Example 2: [Film Title] ([Year])
+
+[Repeat for 3-5 film examples]
+
+---
+
+## Integration with Other Features
+
+### Compatible Genres
+
+- **[Genre Name]**: [How this style works with this genre]
+- **[Genre Name]**: [How this style works with this genre]
+
+### Compatible Themes
+
+- **[Theme Name]**: [How this style enhances this theme]
+- **[Theme Name]**: [How this style enhances this theme]
+
+### Style Variations
+
+- [Variation 1: How to adapt this style]
+- [Variation 2: How to adapt this style]
+
+## 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]
+
+---
+
+## 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
+