@soulcraft/kits 1.0.0

package/src/kits/screenplay-writing.ts

@@ -0,0 +1,412 @@
+/**
+ * @module @soulcraft/kits/kits/screenplay-writing
+ * @description Professional screenplay workspace with scene breakdown, character arcs, and industry-standard formatting
+ *
+ * Generated from: kits/screenplay-writing/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Screenplay Writing kit configuration.
+ *
+ * @description Professional screenplay workspace with scene breakdown, character arcs, and industry-standard formatting
+ * @see {@link SoulcraftKitConfig}
+ */
+const screenplayWriting: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "screenplay-writing",
+	"name": "Screenplay Writing",
+	"description": "Professional screenplay workspace with scene breakdown, character arcs, and industry-standard formatting",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🎬",
+	"longDescription": "Complete screenplay development system with scene cards, character sheets, beat sheets, and act structure. Includes concepts for characters, scenes, and acts that connect in the knowledge graph for easy navigation. Aligned to industry-standard Save the Cat! beat structure.",
+	"tags": [
+		"screenplay",
+		"film",
+		"script",
+		"creative-writing",
+		"storytelling"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "projectName",
+			"label": "Screenplay Title",
+			"description": "The title of your screenplay",
+			"type": "string",
+			"required": true,
+			"example": "The Last Sunset"
+		},
+		{
+			"key": "author",
+			"label": "Writer",
+			"description": "Your name as the screenwriter",
+			"type": "string",
+			"required": false,
+			"example": "Your Name",
+			"default": ""
+		},
+		{
+			"key": "genre",
+			"label": "Genre",
+			"description": "Primary genre (Drama, Comedy, Thriller, Sci-Fi, etc.)",
+			"type": "string",
+			"required": false,
+			"example": "Drama"
+		},
+		{
+			"key": "logline",
+			"label": "Logline",
+			"description": "One-sentence pitch for your story",
+			"type": "string",
+			"required": false,
+			"example": "A brief, compelling summary of your screenplay"
+		}
+	],
+	"shared": {
+		"industry": "filmmaking",
+		"category": "writing",
+		"aiExpertise": [
+			"Screenplay structure and beat sheets",
+			"Character arc development",
+			"Scene writing and pacing",
+			"Dialogue and subtext",
+			"Genre conventions"
+		],
+		"dataModelHints": [
+			"person",
+			"document",
+			"event",
+			"location",
+			"concept"
+		],
+		"suggestions": [
+			{
+				"label": "Write a scene",
+				"prompt": "Help me write the next scene in my screenplay"
+			},
+			{
+				"label": "Develop a character",
+				"prompt": "Help me develop a character profile for my screenplay"
+			},
+			{
+				"label": "Outline an act",
+				"prompt": "Help me outline the structure of an act"
+			},
+			{
+				"label": "Write dialogue",
+				"prompt": "Help me write natural, compelling dialogue for a scene"
+			},
+			{
+				"label": "Check pacing",
+				"prompt": "Analyze my screenplay's pacing and suggest improvements"
+			},
+			{
+				"label": "View story structure",
+				"prompt": "Show me my screenplay structure in the timeline view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "character",
+					"type": "Person",
+					"description": "A character with speaking role, arc, and motivation",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🎭"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "scene",
+					"type": "Document",
+					"description": "A screenplay scene with action and dialogue",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "🎬"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "location",
+					"type": "Location",
+					"description": "A physical setting where scenes take place",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📍"
+						}
+					}
+				},
+				{
+					"domain": "beat",
+					"type": "Concept",
+					"description": "A structural beat in the Save the Cat beat sheet",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "🥁"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "act",
+					"type": "Concept",
+					"description": "An act of the three-act structure",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "📋"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "Conflicts",
+					"description": "Character is in opposition with another"
+				},
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "RelatedTo",
+					"description": "Character relationship or bond"
+				},
+				{
+					"from": "scene",
+					"to": "character",
+					"verb": "Contains",
+					"description": "Scene features this character"
+				},
+				{
+					"from": "scene",
+					"to": "location",
+					"verb": "LocatedAt",
+					"description": "Scene takes place in this setting"
+				},
+				{
+					"from": "scene",
+					"to": "beat",
+					"verb": "InstanceOf",
+					"description": "Scene fulfils this structural beat"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "writer",
+			"defaultTab": "edit",
+			"defaultView": "timeline",
+			"defaultFile": "script/act-1/scene-01.md",
+			"fallbackFiles": [
+				"planning/treatment.md",
+				"README.md"
+			]
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user creates a character",
+					"When user describes a scene",
+					"When user mentions a location",
+					"When user outlines a beat or sequence"
+				],
+				"typeMapping": {
+					"character": "person",
+					"scene": "document",
+					"location": "location",
+					"beat": "concept",
+					"act": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "conflicts",
+					"description": "Character opposition"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "relatedTo",
+					"description": "Character relationship"
+				},
+				{
+					"from": "document",
+					"to": "person",
+					"verb": "contains",
+					"description": "Scene features character"
+				},
+				{
+					"from": "document",
+					"to": "location",
+					"verb": "locatedAt",
+					"description": "Scene setting"
+				},
+				{
+					"from": "document",
+					"to": "concept",
+					"verb": "instanceOf",
+					"description": "Scene belongs to beat"
+				}
+			],
+			"rules": [
+				"Create person entities for characters with speaking roles",
+				"Link scenes to their locations and characters",
+				"Track scene order and act placement",
+				"Note character relationships and conflicts"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "planning/beat-sheet.md",
+					"required": [
+						"Opening Image",
+						"Catalyst",
+						"Midpoint",
+						"All Is Lost",
+						"Finale"
+					],
+					"optional": [
+						"Theme Stated",
+						"B Story"
+					]
+				},
+				{
+					"path": "characters/protagonist.md",
+					"required": [
+						"Name",
+						"Want",
+						"Need"
+					],
+					"optional": [
+						"Backstory",
+						"Voice Notes"
+					]
+				}
+			],
+			"projectChecks": [
+				"Beat sheet has all major beats filled in",
+				"Protagonist has clear want and need defined",
+				"At least one scene exists for each act",
+				"Antagonist has believable motivation"
+			],
+			"exportReady": [
+				"All beat sheet beats are complete",
+				"Character arcs are defined",
+				"Script pages exist for key scenes"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a professional screenwriter and story consultant helping writers develop compelling screenplays using industry-standard structure, character development, and scene craft.",
+			"expertise": [
+				"Screenplay structure (Save the Cat!, McKee)",
+				"Character arc development",
+				"Scene writing and pacing",
+				"Dialogue and subtext",
+				"Genre conventions and expectations"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "intermediate",
+		"templateTier": 4,
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"description": "Sample screenplay structure for a thriller film",
+			"entities": [
+				{
+					"type": "person",
+					"name": "Sarah Chen",
+					"properties": {
+						"role": "protagonist",
+						"age": 35,
+						"occupation": "FBI Cyber Crimes Agent",
+						"want": "Catch the hacker who destroyed her career",
+						"need": "Learn to trust her instincts again",
+						"description": "Brilliant but disgraced agent seeking redemption.",
+						"status": "main"
+					}
+				},
+				{
+					"type": "person",
+					"name": "Marcus Webb",
+					"properties": {
+						"role": "antagonist",
+						"age": 40,
+						"occupation": "Tech CEO",
+						"motivation": "Expose government surveillance overreach",
+						"description": "Idealistic hacker turned corporate titan with a secret.",
+						"status": "main"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Sarah Chen",
+					"verb": "conflicts",
+					"to": "Marcus Webb"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "screenwriting",
+		"level": "intermediate",
+		"learningObjectives": [
+			"Complete a Save the Cat beat sheet with all 15 beats and justified page ranges",
+			"Write a scene in industry-standard format that advances plot and reveals character simultaneously",
+			"Craft dialogue with distinct character voice and subtext that avoids on-the-nose exposition",
+			"Develop a protagonist whose external want and internal need are in direct conflict",
+			"Rewrite a scene to cut page count by 30% without losing story information"
+		],
+		"assessmentTypes": [
+			"portfolio",
+			"peer-review"
+		],
+		"certificationSlug": "screenwriter"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default screenplayWriting;