@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json

@@ -0,0 +1,332 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment.dev/schemas/screenplay/beat-sheet.json",
+  "title": "Beat Sheet",
+  "description": "JSON schema for screenplay beat sheets using Save the Cat structure",
+  "type": "object",
+  "required": ["title", "beats"],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Title of the screenplay"
+    },
+    "logline": {
+      "type": "string",
+      "description": "One-sentence story summary"
+    },
+    "genre": {
+      "type": "string",
+      "description": "Story genre"
+    },
+    "targetLength": {
+      "type": "integer",
+      "description": "Target screenplay length in pages"
+    },
+    "beats": {
+      "type": "object",
+      "required": ["openingImage", "themeStated", "catalyst", "debate", "breakIntoTwo", "bStory", "funAndGames", "midpoint", "badGuysCloseIn", "allIsLost", "darkNightOfTheSoul", "breakIntoThree", "finale", "finalImage"],
+      "properties": {
+        "openingImage": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Page number (typically 1)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Opening image that sets tone and theme"
+            },
+            "visualMetaphor": {
+              "type": "string",
+              "description": "Visual metaphor for the story's theme"
+            }
+          }
+        },
+        "themeStated": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5,
+              "description": "Page number (typically 1-5)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Statement of the story's theme"
+            },
+            "dialogue": {
+              "type": "string",
+              "description": "Actual dialogue that states the theme"
+            }
+          }
+        },
+        "catalyst": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 10,
+              "maximum": 12,
+              "description": "Page number (typically 10-12)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Inciting incident that disrupts the status quo"
+            },
+            "impact": {
+              "type": "string",
+              "description": "How this event affects the protagonist"
+            }
+          }
+        },
+        "debate": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 12,
+              "maximum": 25,
+              "description": "Page number (typically 12-25)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist debates whether to act"
+            },
+            "internalConflict": {
+              "type": "string",
+              "description": "Internal struggle the protagonist faces"
+            }
+          }
+        },
+        "breakIntoTwo": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 25,
+              "maximum": 30,
+              "description": "Page number (typically 25-30)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist commits to the journey (Act 2 begins)"
+            },
+            "decision": {
+              "type": "string",
+              "description": "The specific decision or action taken"
+            }
+          }
+        },
+        "bStory": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 30,
+              "description": "Page number (typically 30)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Introduction of B-story (usually love story or relationship)"
+            },
+            "characters": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Characters involved in B-story"
+            }
+          }
+        },
+        "funAndGames": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 30,
+              "maximum": 55,
+              "description": "Page number (typically 30-55)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Promise of the premise - what the trailer would show"
+            },
+            "setpieces": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Key set pieces and fun moments"
+            }
+          }
+        },
+        "midpoint": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 55,
+              "maximum": 60,
+              "description": "Page number (typically 55-60)"
+            },
+            "description": {
+              "type": "string",
+              "description": "False victory or false defeat - stakes are raised"
+            },
+            "type": {
+              "type": "string",
+              "enum": ["false-victory", "false-defeat"],
+              "description": "Type of midpoint"
+            },
+            "stakeRaise": {
+              "type": "string",
+              "description": "How the stakes are raised"
+            }
+          }
+        },
+        "badGuysCloseIn": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 60,
+              "maximum": 75,
+              "description": "Page number (typically 60-75)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Opposition intensifies, team falls apart"
+            },
+            "escalation": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "How problems escalate"
+            }
+          }
+        },
+        "allIsLost": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 75,
+              "maximum": 85,
+              "description": "Page number (typically 75-85)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Lowest point - opposite of midpoint"
+            },
+            "whiffOfDeath": {
+              "type": "string",
+              "description": "Literal or metaphorical death moment"
+            }
+          }
+        },
+        "darkNightOfTheSoul": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 85,
+              "maximum": 90,
+              "description": "Page number (typically 85-90)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Protagonist's moment of despair and reflection"
+            },
+            "realization": {
+              "type": "string",
+              "description": "What the protagonist realizes or learns"
+            }
+          }
+        },
+        "breakIntoThree": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 90,
+              "maximum": 95,
+              "description": "Page number (typically 90-95)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Solution found - Act 3 begins"
+            },
+            "solution": {
+              "type": "string",
+              "description": "The specific solution or plan"
+            }
+          }
+        },
+        "finale": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 95,
+              "maximum": 110,
+              "description": "Page number (typically 95-110)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Climax and resolution"
+            },
+            "climax": {
+              "type": "string",
+              "description": "The climactic confrontation"
+            },
+            "resolution": {
+              "type": "string",
+              "description": "How conflicts are resolved"
+            }
+          }
+        },
+        "finalImage": {
+          "type": "object",
+          "required": ["page", "description"],
+          "properties": {
+            "page": {
+              "type": "integer",
+              "minimum": 110,
+              "description": "Page number (typically 110)"
+            },
+            "description": {
+              "type": "string",
+              "description": "Final image - opposite of opening image showing change"
+            },
+            "transformation": {
+              "type": "string",
+              "description": "How this image shows the protagonist's transformation"
+            }
+          }
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional notes about the beat sheet"
+    }
+  }
+}
+

package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment.dev/schemas/screenplay/character-profile.json",
+  "title": "Character Profile",
+  "description": "JSON schema for screenplay character profiles with traits, arcs, motivations, relationships, backstory, and physical description",
+  "type": "object",
+  "required": ["name", "role"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Character's full name"
+    },
+    "role": {
+      "type": "string",
+      "enum": ["protagonist", "antagonist", "supporting", "minor"],
+      "description": "Character's role in the story"
+    },
+    "age": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 150,
+      "description": "Character's age in years"
+    },
+    "gender": {
+      "type": "string",
+      "description": "Character's gender identity"
+    },
+    "physicalDescription": {
+      "type": "object",
+      "properties": {
+        "height": {
+          "type": "string",
+          "description": "Character's height (e.g., '5'10\"', '180cm')"
+        },
+        "build": {
+          "type": "string",
+          "description": "Character's body type (e.g., 'athletic', 'slender', 'stocky')"
+        },
+        "hairColor": {
+          "type": "string",
+          "description": "Character's hair color"
+        },
+        "eyeColor": {
+          "type": "string",
+          "description": "Character's eye color"
+        },
+        "distinguishingFeatures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Notable physical features (scars, tattoos, etc.)"
+        },
+        "appearance": {
+          "type": "string",
+          "description": "Overall appearance description"
+        }
+      }
+    },
+    "personality": {
+      "type": "object",
+      "properties": {
+        "traits": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Core personality traits"
+        },
+        "strengths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character strengths"
+        },
+        "weaknesses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character flaws and weaknesses"
+        },
+        "fears": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character's fears"
+        },
+        "desires": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character's desires and wants"
+        }
+      }
+    },
+    "backstory": {
+      "type": "object",
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "Brief backstory summary"
+        },
+        "formativeEvents": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "event": {
+                "type": "string",
+                "description": "Description of the event"
+              },
+              "age": {
+                "type": "integer",
+                "description": "Age when event occurred"
+              },
+              "impact": {
+                "type": "string",
+                "description": "How this event shaped the character"
+              }
+            }
+          },
+          "description": "Key events that shaped the character"
+        },
+        "family": {
+          "type": "string",
+          "description": "Family background"
+        },
+        "education": {
+          "type": "string",
+          "description": "Educational background"
+        },
+        "occupation": {
+          "type": "string",
+          "description": "Current or past occupation"
+        }
+      }
+    },
+    "motivations": {
+      "type": "object",
+      "properties": {
+        "externalGoal": {
+          "type": "string",
+          "description": "What the character wants to achieve (plot-level)"
+        },
+        "internalGoal": {
+          "type": "string",
+          "description": "What the character needs to learn/overcome (theme-level)"
+        },
+        "stakes": {
+          "type": "string",
+          "description": "What the character stands to lose"
+        },
+        "conflictingMotivations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Competing desires that create internal conflict"
+        }
+      }
+    },
+    "characterArc": {
+      "type": "object",
+      "properties": {
+        "arcType": {
+          "type": "string",
+          "enum": ["positive", "negative", "flat"],
+          "description": "Type of character arc"
+        },
+        "startingState": {
+          "type": "string",
+          "description": "Character's state at story beginning"
+        },
+        "endingState": {
+          "type": "string",
+          "description": "Character's state at story end"
+        },
+        "transformation": {
+          "type": "string",
+          "description": "How the character changes"
+        }
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["character", "relationship"],
+        "properties": {
+          "character": {
+            "type": "string",
+            "description": "Name of related character"
+          },
+          "relationship": {
+            "type": "string",
+            "description": "Type of relationship (e.g., 'mentor', 'rival', 'love interest')"
+          },
+          "description": {
+            "type": "string",
+            "description": "Description of the relationship dynamic"
+          },
+          "conflictPoints": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Sources of conflict in this relationship"
+          }
+        }
+      },
+      "description": "Character's relationships with other characters"
+    },
+    "voice": {
+      "type": "object",
+      "properties": {
+        "speechPattern": {
+          "type": "string",
+          "description": "How the character speaks (formal, casual, etc.)"
+        },
+        "vocabulary": {
+          "type": "string",
+          "description": "Type of vocabulary used (technical, simple, etc.)"
+        },
+        "catchphrases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Recurring phrases or expressions"
+        },
+        "accent": {
+          "type": "string",
+          "description": "Character's accent or dialect"
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional notes about the character"
+    }
+  }
+}
+