[Preset]: Add Screenwriting

[adaumann]

Preset ID

screenwriting

Preset Name

Screenwriting

Version

1.0.0

Description

Spec-Driven Development for screenwriting/scriptwriting/tutorials: feature films, television (pilot, episode, limited series), and stage plays. Adapts the Speckit workflow to screenplay craft — slug lines, action lines, act breaks, beat sheets, and industry-standard pitch documents replace prose fiction conventions. Supports three-act, Save the Cat, TV pilot, network episode, cable/streaming episode, and stage-play structural frameworks.

Author

Andreas Daumann

Repository URL

https://github.com/adaumann/speckit-preset-screenwriting

Download URL

https://github.com/adaumann/speckit-preset-screenwriting/releases/tag/V1.0.0

License

MIT

Required Spec Kit Version

= 0.5.0

Templates Provided

Template	Description
agent-file-template.md	Persistent working context for speckit agents across all commands.
beat-sheet-template.md	Structural outline including act structure, page count targets, and format details.
characters-index-template.md	Master roster of all characters for state tracking and continuity verification.
characters-template.md	Detailed character profile including role, age, story function, and background.
checklist-template.md	Scene quality checklist for "unit tests for screenwriting craft."
constitution-template.md	Story bible / constitution file containing story metadata and author information.
craft-rules-template.md	Script-specific craft rules, overrides, and anti-patterns derived from the constitution.
episode-outline-template.md	Detailed outline for a TV episode, including A/B/C story descriptions.
feedback-template.md	Log for script notes and coverage from various sources.
glossary-template.md	Consistency reference for all invented terms, proper nouns, and world-specific rules.
locations-template.md	Canonical location reference with visual identity and atmospheric details.
pitch-deck-template.md	Template for generating professional pitch documents.
plan-template.md	Screenplay structure plan mapping acts and scenes.
relationships-template.md	Character relationship arc tracker for power balance and communication patterns.
research-template.md	Research tracker for historical accuracy and technical authenticity.
scene-card-template.md	Metadata for individual scenes: ID, slug line, act, and story thread.
scene-outline-template.md	Detailed scene outline covering dramatic purpose, beats, and dialogue.
series-bible-template.md	Master document for TV series-wide canon and settings.
spec-template.md	Screenplay brief containing the foundational story concept and requirements.
subplots-template.md	Subplot tracker for all B-story and C-story arcs.
synopsis-template.md	Format for one-page and full act-by-act synopses.
tasks-template.md	Template for organizing scene-by-scene writing tasks.
themes-template.md	Thematic contract tracking motifs, symbols, and act-by-act thematic work.
timeline-template.md	Chronological tracking for story time and narrative order.
tutorial-script-template.md	Template for drafting tutorial or educational video scripts.
world-building-template.md	World-building reference for setting rules, geography, history, and culture.

Commands Provided (optional)

Command	Description
speckit.analyze	Pre-draft structural alignment check — spec↔plan coverage, act proportions, task completeness, beat sheet integrity.
speckit.bio	Generate a professional writer bio from author information in the story bible.
speckit.brainstorm	Interactive brainstorming session for any screenplay topic.
speckit.checklist	Run scene quality checks — format, scene function, action lines, dialogue, visual storytelling, structure, pacing.
speckit.clarify	Detect and resolve narrative ambiguity in the active screenplay brief.
speckit.constitution	Create or update the screenplay story bible — format, medium, act structure, and craft rules.
speckit.continuity	Post-draft continuity audit — story bible compliance, character tracking, timeline coherence, and location consistency.
speckit.coverage	Generate self-coverage in industry format with logline, premise, structure, character, and dialogue analysis.
speckit.export	Export the screenplay to Fountain, Final Draft XML (.fdx), or PDF.
speckit.feedback	Ingest script notes from any source, categorize by issue type, and generate prioritized revision tasks.
speckit.format	Screenplay format compliance audit — slug lines, action line length, transitions, and Fountain syntax.
speckit.glossary	Glossary management — add terms, resolve inconsistencies, and audit scenes for terminology violations.
speckit.help	Workflow advisor — scans project files to detect state and provide prioritized recommendations.
speckit.implement	Draft scenes in screenplay format (Fountain) by executing writing tasks from tasks.md.
speckit.interview	Interactive one-on-one conversation with an existing character to surface psychology and subtext.
speckit.outline	Generate or update editable scene outlines — dramatic purpose, beat sequence, and dialogue requirements.
speckit.pacing	Screenplay pacing analysis — emotional tension arc scoring, page count by act, and scene length distribution.
speckit.pitch	Generate a pitch document from the screenplay brief and synopsis.
speckit.plan	Build the screenplay structure plan — act breakdown, scene map, beat sheet, and supporting documents.
speckit.polish	Final line-pass on drafted scenes — action line compression, removal of unfilmables, and voice consistency.
speckit.research	Research tracking — add items, resolve findings, and audit drafted scenes for authenticity flags.
speckit.revise	Revise drafted scenes based on notes, checklists, continuity violations, or coverage feedback.
speckit.roleplay	Character voice testing and multi-role scene play-through for dialogue and beat-by-beat scene reading.
speckit.sensitivity	Sensitivity and representation review — flags cultural misrepresentation, harmful tropes, and identity portrayal issues.
speckit.series	Series bible management — initialize, audit cross-episode continuity, and sync series-wide canon.
speckit.specify	Create a screenplay brief from a natural language story idea — logline, premise, character arcs, and plot requirements.
speckit.statistics	Script statistics — page count breakdown, dialogue line counts, estimated screen time, and action line voice signals.
speckit.status	Project dashboard — scan scenes, tasks, and checklists to produce status breakdown and phase completion summary.
speckit.subplot	B-story and C-story management — audit subplot arcs for beat gaps, absence streaks, and unresolved questions.
speckit.synopsis	Generate a submission-ready synopsis from the screenplay — one-page and full act-by-act.
speckit.tasks	Generate scene-by-scene writing tasks ordered by act and story thread.
speckit.versions	Version management for screenplay drafts — list versions, compare differences, restore, and tag milestones.

Tags

writing, screenplay, scriptwriting, storytelling

Key Features

Key Features of the Screenwriting Preset

The Screenwriting Preset is a comprehensive workflow for Spec-Driven Development of feature films, television (pilots, episodes, limited series), and stage plays. It adapts the Speckit methodology to the specific terminologies and structural requirements of professional scriptwriting.

1. Industry-Standard Scripting Support

• Fountain Native: Fully supports the Fountain plain-text screenplay format for all drafting tasks.
• Multi-Format Export: Built-in commands to export to .fountain, .fdx (Final Draft XML), or .pdf.
• Structure Frameworks: Pre-configured support for Three-Act structure, Save the Cat, TV Pilot frameworks, Network Episode (5-act/6-act), Cable/Streaming, and Stage Play layouts.

2. Comprehensive Development Workflow (Phase-Based)

The preset organizes the writing process into six distinct, logical phases:

1. Development: Setting the "Constitution" (story bible), specifying the brief, and clarifying initial ideas.
2. Structure: Building detailed structural plans, beat sheets, and performing pre-draft analysis.
3. Drafting: Orderly generation of scenes based on a task list and detailed scene outlines.
4. Revision: rigorous quality gates including automated checklists, continuity audits, and targeted polishing.
5. Pitch: Generating professional submission materials like synopses, pitch documents, and coverage.
6. Production: Final export for production or submission.

3. Intelligent Story Bible (The Constitution)

• Defines the "DNA" of the script: format, medium, act structure, and craft rules.
• Enforces consistency across all generated documents, from dialogue register to action line density.
• Propagates style parameters and world rules to every scene drafted.

4. Advanced Structural Analysis

• speckit.analyze: Checks for structural alignment between the spec and plan, ensuring act proportions and beat integrity are correct before writing begins.
• speckit.pacing: Evaluates emotional tension arcs and scene length distributions using visual charts (Mermaid).
• speckit.subplot: Specifically tracks and manages B-stories and C-stories, ensuring they have proper inciting incidents and resolutions.

5. Automated Quality Control & Auditing

• Scene Checklists: Runs "unit tests" for screenwriting craft on every scene (formatting, dialogue quality, visual storytelling).
• Continuity Engine: Audits character states, location consistency, timeline coherence, and world rule violations across all drafted files.
• Format Audit: Ensures total compliance with slug line syntax, action line length, and industry-standard formatting rules.

6. Writer & Character Tools

• Interactive Brainstorming: Topic-specific AI sessions that load existing context to help break story blocks.
• Character Interviews: VO-ready AI interaction with characters to surface subtext and deepen profiles.
• Roleplay Mode: Test character voices in improv sessions or multi-role scene readings.

7. Submission-Ready Deliverables

• Pitch Documents: Automatically generates loglines, premises, tone/comps, and writer statements.
• Automated Coverage: Performs self-coverage to provide a "Recommend/Consider/Pass" verdict with professional rationale.
• Synopses: Generates versioned synopses (one-page or full act-by-act).

8. Workflow Guidance

• speckit.help: Acts as a "Senior Script Editor" by scanning project files and recommending the next highest-value action for the writer.

Testing Checklist

• Preset installs successfully via specify preset add
• Template resolution works correctly after installation
• Documentation is complete and accurate
• Tested on at least one real project

Submission Requirements

• Valid preset.yml manifest included
• README.md with description and usage instructions
• LICENSE file included
• GitHub release created with version tag
• Preset ID follows naming conventions (lowercase-with-hyphens)