@openpresentation/opf 0.1.0

package/dist/spec/catalogs/narratives/product-launch.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "product-launch",
+  "name": "Product Launch",
+  "summary": "Persuasive launch arc: open with brand, hook with a promise, set the conflict, raise the stakes, reveal the product, raise stakes again, sell, and call to action. Tuned for keynote-style launches and major announcement decks.",
+  "audienceFit": [
+    "customers",
+    "press",
+    "general-audience",
+    "partners"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "startup",
+    "launch",
+    "marketing",
+    "keynote"
+  ],
+  "beats": [
+    {
+      "id": "opening",
+      "name": "Opening",
+      "description": "Open with the company brand and a confident visual. Set the tone — this is a moment, not a meeting. One slide that signals the audience is somewhere worth being.",
+      "layoutHint": "title-left",
+      "instructions": "Show company branding",
+      "slideType": "text"
+    },
+    {
+      "id": "promise",
+      "name": "Promise",
+      "description": "Hook the audience with the promise of the talk. Tell them, in one sentence, what they're about to see and why it matters to them. Specific promises buy patient audiences.",
+      "instructions": "Hook the audience",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "context",
+      "name": "Context",
+      "description": "Set the stage with the world the product enters. The customer reality, the market state, the unmet expectation. Context turns the launch from a product release into a moment in a larger story.",
+      "instructions": "Set the stage",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "conflict",
+      "name": "Conflict",
+      "description": "Introduce the villain — the problem, friction, or status quo the product opposes. Make the conflict concrete enough that the audience can name a moment they've felt it themselves.",
+      "instructions": "Introduce villain/problem",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "stakes",
+      "name": "Stakes",
+      "description": "Emphasize what's at risk if the conflict isn't resolved. Quantify, personalize, dramatize. Stakes are what convert a curious audience into an invested one.",
+      "instructions": "Emphasize importance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "reveal",
+      "name": "Reveal",
+      "description": "Showcase the product. One striking visual, one defining capability, one sentence that captures what's new. Earn the applause line; don't bury it under a bullet list.",
+      "instructions": "Showcase the solution",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "raise-stakes",
+      "name": "Raise the Stakes",
+      "description": "Highlight where the alternatives fall short and what they cost the customer. Re-energize the room midway by sharpening the contrast with the reveal.",
+      "instructions": "Highlight shortcomings of alternatives",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "raise-stakes-again",
+      "name": "Reinforce the Need",
+      "description": "Reinforce why change is non-negotiable now. A second beat of stakes, framed differently — perhaps a customer voice or a future cost. Cement the reason to act.",
+      "instructions": "Reinforce the need for change",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "sell",
+      "name": "Sell",
+      "description": "Make the audience want the product. Lead with the outcome it produces in their lives. Pricing, packaging, availability go here, but only after the desire is built.",
+      "instructions": "Make them want your solution",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "cta",
+      "name": "Call to Action",
+      "description": "Close with the single action you want from the audience. Pre-order, sign up, attend, share. Make it simple, specific, and immediate.",
+      "layoutHint": "title-left",
+      "instructions": "Inspire action",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/project-proposal.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "project-proposal",
+  "name": "Project Proposal",
+  "summary": "Internal proposal arc for greenlighting a project: hook, problem, idea, benefits, justification, plan, timeline, risks, outlook, ask. Designed to take a sponsor from 'never heard of this' to 'approved' inside a single meeting.",
+  "audienceFit": [
+    "executives",
+    "sponsors",
+    "managers",
+    "internal-teams"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "management",
+    "proposal",
+    "internal",
+    "planning"
+  ],
+  "beats": [
+    {
+      "id": "elevator-pitch",
+      "name": "Elevator Pitch",
+      "description": "Open with the proposal in one slide: the project name, the audience, the goal, and the headline benefit. If a sponsor reads only this slide, they should still know what they're being asked to approve.",
+      "instructions": "Audience hook & objectives",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "problem-statement",
+      "name": "Problem Statement",
+      "description": "Articulate the problem this project solves and why it deserves resources now. Tie it to a known business goal or pain. Vague problems produce vague approvals.",
+      "instructions": "Highlight struggles & project necessity",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "core-concept",
+      "name": "Core Concept",
+      "description": "Describe the central idea of the project in plain language. The 'what' before the 'how.' A reader should be able to repeat the concept in one sentence after this slide.",
+      "instructions": "Share actionable idea",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "benefits",
+      "name": "Benefits",
+      "description": "Quantify the impact: revenue, cost, risk, customer, capability. Use numbers where possible and clear comparisons where not. Each benefit should map to a metric the sponsor cares about.",
+      "instructions": "Spotlight key metrics",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "justification",
+      "name": "Justification",
+      "description": "Connect the project to broader strategy, OKRs, or constraints the audience already cares about. Show why this project is more important than the alternatives competing for the same resources.",
+      "instructions": "Strategic alignment & significance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "approach",
+      "name": "Approach",
+      "description": "Lay out how the project will be executed: the solution, the team shape, the budget envelope. Enough detail to feel credible, not so much that it pre-commits to choices that will mature in flight.",
+      "instructions": "Solution, resources, & budget",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "timeline",
+      "name": "Timeline",
+      "description": "Show the project phases on a timeline, with major milestones and decision points marked. Sponsors are buying a sequence of bets, not a single launch — make those bets visible.",
+      "instructions": "Outline project phases",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "risks",
+      "name": "Risks",
+      "description": "Name the top risks honestly and pair each with a mitigation or open question. Listing risks without mitigations signals you haven't thought it through; hiding risks signals worse.",
+      "instructions": "Consider potential challenges",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "outlook",
+      "name": "Outlook",
+      "description": "Paint the picture of what the organization looks like a quarter or year after the project ships. Stretch beyond the immediate deliverable to the second-order benefits.",
+      "instructions": "Envision project impact",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "wrap-up",
+      "name": "Wrap Up",
+      "description": "Recap the proposal and state the specific decision you're asking for: approval, budget, headcount, sponsorship. Make it easy to say yes today.",
+      "layoutHint": "title-left",
+      "instructions": "Summarize & persuade",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/qbr.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "qbr",
+  "name": "Quarterly Business Review",
+  "summary": "Standard QBR / business-review arc for internal leadership reviews. Recap commitments, show what the numbers say, separate wins from challenges, lay out the plan, surface risks, and request the asks the team needs to execute.",
+  "audienceFit": [
+    "leadership",
+    "executives",
+    "cross-functional-partners"
+  ],
+  "durationRange": {
+    "minMinutes": 30,
+    "maxMinutes": 90
+  },
+  "tags": [
+    "internal",
+    "review",
+    "operations",
+    "reporting"
+  ],
+  "beats": [
+    {
+      "id": "objectives",
+      "name": "Objectives",
+      "description": "Open with what this review is for and what decisions you want out of it. Frame the scope and the hour ahead, so the audience knows what they're being asked to weigh in on.",
+      "layoutHint": "title-center",
+      "instructions": "Set the expectations",
+      "slideType": "text"
+    },
+    {
+      "id": "recap",
+      "name": "Recap",
+      "description": "Briefly remind the audience what the team committed to last quarter and the high-level results against those commitments. Keep it terse — this grounds the review in prior context, but the meat is ahead."
+    },
+    {
+      "id": "performance-headline",
+      "name": "Performance Headline",
+      "description": "Show the top three to five KPIs with target vs actual and direction-of-travel. One slide that lets a busy executive grasp the quarter's outcome at a glance. Lead with the number, not the methodology."
+    },
+    {
+      "id": "performance-detail",
+      "name": "Performance Detail",
+      "description": "Drill into the supporting metrics by area or function. One chart per metric; clear y-axis, clear unit, clear comparison period. Call out anomalies before someone else does."
+    },
+    {
+      "id": "wins",
+      "name": "Wins",
+      "description": "Highlight the quarter's biggest wins and who drove them. Be specific — name the deal, the launch, the customer, the team. Recognition belongs in the deck, not just in the meeting."
+    },
+    {
+      "id": "challenges",
+      "name": "Challenges",
+      "description": "Name the misses and headwinds honestly. What didn't work, what's still hard, what got harder. Pretending things are fine costs more credibility than acknowledging they aren't.",
+      "instructions": "Address difficulties",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "insights",
+      "name": "Insights",
+      "description": "Translate the numbers into 'so what.' What did the data tell you about customers, the market, your operations, your bets? Insights should be opinions backed by evidence, not restatements of the metrics."
+    },
+    {
+      "id": "priorities",
+      "name": "Next-Quarter Priorities",
+      "description": "Lay out the next quarter's top priorities. Each should trace clearly back to an insight or commitment. Three to five priorities, max — laundry lists are a tell that the team hasn't decided what matters most."
+    },
+    {
+      "id": "sequencing",
+      "name": "Sequencing",
+      "description": "Show the order in which priorities ship and how they fit together. Dependencies, milestones, target dates. The audience should leave able to predict what comes when, not just what."
+    },
+    {
+      "id": "risks",
+      "name": "Risks",
+      "description": "Name the risks to the plan honestly. Dependencies, assumptions, capacity gaps, market factors. For each risk, state the mitigation or the open question the audience can help resolve."
+    },
+    {
+      "id": "asks",
+      "name": "Asks",
+      "description": "Specific, named requests of the audience. Decisions needed, resources required, escalations to unblock. End with clarity on what happens next and who owns it.",
+      "layoutHint": "title-left"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/rags-to-riches.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "rags-to-riches",
+  "name": "Rags to Riches",
+  "summary": "Underdog journey from initial failure to eventual success. Pulls on resilience, grit, and perseverance — useful for founder stories, brand stories, and any deck where the audience needs to feel the cost behind the win.",
+  "audienceFit": [
+    "general-audience",
+    "customers",
+    "press",
+    "candidates"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 20
+  },
+  "tags": [
+    "storytelling",
+    "founder",
+    "brand",
+    "inspirational"
+  ],
+  "beats": [
+    {
+      "id": "origin",
+      "name": "Origin",
+      "description": "Start at the bottom. Describe the humble beginning, the constraint, the moment before anything had been built. Concrete details — a place, a year, a feeling — earn the audience's investment in what follows.",
+      "instructions": "Humble beginning",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "inspiration",
+      "name": "Inspiration",
+      "description": "Show the moment the protagonist found their calling. A conversation, a customer, a problem they couldn't unsee. The inspiration is the engine that pushes the rest of the story uphill.",
+      "instructions": "Discover true calling",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "opportunity",
+      "name": "Opportunity",
+      "description": "Reveal the chance the protagonist took. Why this and not something safer? Make the choice visible — opportunities only count when there was something else they passed up to grab them.",
+      "instructions": "Spot golden chance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "adversity",
+      "name": "Adversity",
+      "description": "Walk through the hardest stretch. Concrete failures, near-misses, moments of doubt. Resist the temptation to skip past the pain — the audience trusts the win more when the loss was real.",
+      "instructions": "Face hardest struggles",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "overcoming",
+      "name": "Overcoming",
+      "description": "Show how the obstacles got beaten. What changed, what was learned, what hard call was made. The transition from 'rags' to 'riches' should feel earned, not granted.",
+      "instructions": "Surmount tough obstacles",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "impactful-change",
+      "name": "Impactful Change",
+      "description": "Describe the moment the world tipped. The customer who said yes, the product that broke through, the metric that turned. One concrete transformation lands harder than a montage.",
+      "instructions": "Alter the status quo",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "lasting-legacy",
+      "name": "Lasting Legacy",
+      "description": "Close on what the journey means for those who come next. The lesson, the people changed, the work that endures. Leave the audience with a takeaway that outlives the story.",
+      "layoutHint": "title-left",
+      "instructions": "Create enduring effect",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/reveal.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "reveal",
+  "name": "Reveal",
+  "summary": "Insight-driven keynote arc inspired by Amy Cuddy's 2012 talk on body language: connect through personal story, ground in research, illustrate with anecdote, summarize, break stereotypes, advise, demonstrate authenticity, close with impact. For talks that aim to change how the audience sees something they thought they understood.",
+  "audienceFit": [
+    "general-audience",
+    "academics",
+    "professionals"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 25
+  },
+  "tags": [
+    "keynote",
+    "research",
+    "talk",
+    "inspirational"
+  ],
+  "beats": [
+    {
+      "id": "personal-story",
+      "name": "Personal Story",
+      "description": "Open with a personal experience that establishes why the topic matters to you. Specificity earns intimacy; intimacy earns the audience's permission to be moved.",
+      "instructions": "Share personal experiences to connect with the audience",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "research-exposition",
+      "name": "Research Exposition",
+      "description": "Lay out the scientific or empirical data that backs the premise. Be rigorous but not academic — the audience needs to understand the evidence well enough to defend it later.",
+      "instructions": "Unravel scientific data backing the premise",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "real-life-anecdote",
+      "name": "Real-Life Anecdote",
+      "description": "Illustrate the research with a story from the field. Make the abstract finding feel like something that happens to people the audience could imagine being.",
+      "instructions": "Illustrate with stories to make the point relatable",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "critical-insights",
+      "name": "Critical Insights",
+      "description": "Summarize the two or three findings the audience must walk away with. Distill them into language a non-specialist could repeat without distortion.",
+      "instructions": "Summarize key points",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "break-stereotypes",
+      "name": "Break Stereotypes",
+      "description": "Question redundant norms or beliefs the research undermines. Be specific about what's being challenged so the audience knows what to update.",
+      "instructions": "Question redundant norms and belief systems",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "empowering-advice",
+      "name": "Empowering Advice",
+      "description": "Translate the insights into a small, actionable practice. The advice should be doable today, not only next quarter — the goal is movement, not aspiration.",
+      "instructions": "Motivational message to act upon",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "authenticity",
+      "name": "Authenticity",
+      "description": "Speak honestly about your own struggle with the topic. Vulnerability, used with restraint, is what turns research into a felt truth.",
+      "instructions": "Honest and real communication to demonstrate authenticity",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "close-with-impact",
+      "name": "Close With Impact",
+      "description": "End on a motivational high — the line, image, or invitation you want to follow the audience out of the room. Close the talk where it began, transformed.",
+      "layoutHint": "title-left",
+      "instructions": "End on a motivational high",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/scqa.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "scqa",
+  "name": "SCQA (Situation–Complication–Question–Answer)",
+  "summary": "Barbara Minto's pyramid-principle arc: surface the recommendation up front, then layer key arguments and supporting evidence beneath it. The default for executive memos, strategic recommendations, and consulting decks where the audience needs the answer fast.",
+  "audienceFit": [
+    "executives",
+    "boards",
+    "leadership-teams"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 20
+  },
+  "tags": [
+    "executive",
+    "strategy",
+    "consulting",
+    "minto",
+    "pyramid"
+  ],
+  "beats": [
+    {
+      "id": "situation",
+      "name": "Situation",
+      "description": "Establish the shared context: what is true today that the audience already agrees on. State only facts the audience accepts without argument. The goal is alignment, not persuasion — you are setting the stage."
+    },
+    {
+      "id": "complication",
+      "name": "Complication",
+      "description": "Introduce the disturbance to the situation: what changed, what is at risk, what is no longer working. This is the tension that makes the audience lean in. Be specific and quantify the change where possible."
+    },
+    {
+      "id": "question",
+      "name": "Key Question",
+      "description": "Surface the question the complication forces the audience to answer. Frame it explicitly — 'Should we…?', 'How do we…?', 'What changes if…?'. The question should feel inevitable given the complication."
+    },
+    {
+      "id": "answer",
+      "name": "Answer",
+      "description": "Deliver the recommendation in a single sentence, up front. No arguments yet, no caveats — just the conclusion the rest of the deck will defend. This is the apex of the Minto pyramid; everything that follows supports it.",
+      "layoutHint": "title-left"
+    },
+    {
+      "id": "key-arguments",
+      "name": "Key Arguments",
+      "description": "Lay out the two or three top-level reasons the answer is correct. One slide per argument, or one summary slide naming all of them. Each argument should stand alone as a compelling reason; together they should be exhaustive of the case."
+    },
+    {
+      "id": "supporting-evidence",
+      "name": "Supporting Evidence",
+      "description": "Present the data, examples, and case studies that ground each argument. Pyramid-principle style: every claim above is backed by something verifiable here. Cite sources; show the numbers; let the evidence carry the weight."
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/status-update.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "status-update",
+  "name": "Status Update",
+  "summary": "Concise progress-report arc for keeping a stakeholder informed: headline, brief, progress, results, plan, feedback. Optimized for short, repeated updates rather than one-time deep dives.",
+  "audienceFit": [
+    "stakeholders",
+    "managers",
+    "customers",
+    "executives"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 15
+  },
+  "tags": [
+    "reporting",
+    "operations",
+    "customer-relationship",
+    "weekly"
+  ],
+  "beats": [
+    {
+      "id": "headline",
+      "name": "Headline",
+      "description": "Open with the single most important sentence the audience needs to know — on track, off track, or shifted. The headline replaces 'how's it going' with a clear answer.",
+      "layoutHint": "title-left",
+      "instructions": "Title & date",
+      "slideType": "text"
+    },
+    {
+      "id": "brief",
+      "name": "Brief",
+      "description": "State the objective for the period and what was promised. One slide, three lines. Frames the rest of the update so progress is read against a clear bar.",
+      "instructions": "Summary/objectives",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "progress",
+      "name": "Progress",
+      "description": "Walk through the actions taken since the last update. Specific, attributable, dated. Avoid effort theater — list outcomes and material moves, not activity for its own sake.",
+      "instructions": "Explain actions taken",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "results",
+      "name": "Results",
+      "description": "Show the outcomes those actions produced. Metrics, customer signals, decisions made. Keep the comparison crisp — versus plan, versus last period, versus benchmark.",
+      "instructions": "Show outcomes",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "action-plan",
+      "name": "Action Plan",
+      "description": "Outline the next steps and who owns them. Be specific about the next decision point and what would have to happen to slip the schedule.",
+      "instructions": "Outline next steps",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "feedback",
+      "name": "Feedback",
+      "description": "Invite the audience to weigh in: where you'd like input, where you need a decision, where help would unblock you. End the update with an open hand, not a closed file.",
+      "layoutHint": "title-left",
+      "instructions": "Ask for response",
+      "slideType": "text"
+    }
+  ]
+}