@openpresentation/opf 0.1.0

package/dist/spec/catalogs/narratives/strategic-advisory.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "strategic-advisory",
+  "name": "Strategic Advisory",
+  "summary": "Consulting-style advisory deck applying Minto's pyramid: title, situation/complication/question, the answer in one sentence, and three argued points with a process. Use when the audience expects a recommendation and the case for it, in that order.",
+  "audienceFit": [
+    "executives",
+    "boards",
+    "leadership-teams",
+    "clients"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "consulting",
+    "advisory",
+    "strategy",
+    "minto"
+  ],
+  "beats": [
+    {
+      "id": "title",
+      "name": "Title",
+      "description": "Open with a one-line summary statement that captures the recommendation, not the topic. The title slide is the headline of the entire engagement — make it specific enough that someone reading only this slide already understands the position.",
+      "layoutHint": "title-left",
+      "instructions": "Brief summary sentence",
+      "slideType": "text"
+    },
+    {
+      "id": "scq",
+      "name": "Situation, Complication, Question",
+      "description": "Frame the engagement on a single slide: the relevant status quo, what needs to change, and the question that needs to be resolved. This is the SCQ shorthand — context, tension, prompt. Don't yet answer."
+    },
+    {
+      "id": "answer",
+      "name": "Answer",
+      "description": "Deliver the recommendation in a single sentence. No arguments yet, no caveats. The answer is the apex of the pyramid; the rest of the deck supports it.",
+      "instructions": "A solution in one sentence, no arguments yet",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "arguments",
+      "name": "Arguments",
+      "description": "Preview the three top-level arguments that defend the answer. One slide naming all three so the audience knows where the deck is going. Each argument should be a complete claim, not a topic.",
+      "instructions": "Support the solution",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "argument-1",
+      "name": "Argument 1",
+      "description": "Develop the first argument with supporting data, examples, and reasoning. Lead with the claim, then the evidence — Minto-style. The slide should stand alone if pulled out.",
+      "instructions": "First key point",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "argument-2",
+      "name": "Argument 2",
+      "description": "Develop the second argument the same way. Vary the type of evidence — quantitative, qualitative, comparative — so the audience hears the case from multiple angles.",
+      "instructions": "Second key point",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "argument-3",
+      "name": "Argument 3",
+      "description": "Develop the third argument and walk through the supporting process or methodology. This is often where the 'how' lives — the implementation insight that makes the recommendation feel actionable.",
+      "instructions": "Third key point with a process",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "summary",
+      "name": "Summary",
+      "description": "Recap the answer and arguments in a single slide and point to additional resources. Close with the explicit next step you want the audience to take.",
+      "layoutHint": "title-left",
+      "instructions": "Recap the answer, provide additional resources",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/strategic-narrative.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "strategic-narrative",
+  "name": "Strategic Narrative",
+  "summary": "The change-driven founder/sales arc: a tectonic shift creates winners and losers, the audience must respond, and your product is the only credible way to land in the winners' camp. Used for top-of-funnel sales pitches, board re-positioning, and high-stakes founder talks.",
+  "audienceFit": [
+    "customers",
+    "prospects",
+    "board",
+    "investors",
+    "executives"
+  ],
+  "durationRange": {
+    "minMinutes": 10,
+    "maxMinutes": 30
+  },
+  "tags": [
+    "strategic",
+    "sales",
+    "positioning",
+    "category"
+  ],
+  "beats": [
+    {
+      "id": "shift",
+      "name": "The Shift",
+      "description": "Open by naming a large, undeniable change in the world that the audience already half-believes. Technology, regulation, customer behavior, economics — pick the shift that recasts the audience's reality. The shift, not your product, is the protagonist of the first half of the deck."
+    },
+    {
+      "id": "stakes",
+      "name": "Winners and Losers",
+      "description": "Make the consequences of the shift concrete. Who wins, who loses, by how much, on what timeframe. Use specific examples — companies, products, segments — that have already moved or are about to. The audience should feel that standing still is the riskiest choice."
+    },
+    {
+      "id": "promised-land",
+      "name": "Promised Land",
+      "description": "Paint a vivid picture of the future state your audience could occupy if they navigate the shift well. Describe outcomes, not features. The promised land must feel desirable, achievable, and meaningfully different from where they are today."
+    },
+    {
+      "id": "obstacles",
+      "name": "Old Game",
+      "description": "Show why the existing playbook can't get the audience to the promised land. Name the legacy approach honestly and credit what it once did, then explain why the shift has rendered it insufficient. Avoid strawmen — the more fairly you state the old game, the more credible your new game becomes."
+    },
+    {
+      "id": "mechanism",
+      "name": "New Game",
+      "description": "Introduce your category-defining approach as the way to play the new game. Show the principles or capabilities that make it possible only now. Emphasize what's structurally different from the old game, not what's marginally better."
+    },
+    {
+      "id": "evidence",
+      "name": "Evidence",
+      "description": "Prove the new game works. Customer outcomes, named logos, before/after data, third-party validation. Choose evidence that maps directly to the shift you opened with — proof that other audiences in the same boat made it to the promised land."
+    },
+    {
+      "id": "ask",
+      "name": "Call to Action",
+      "description": "Close with the single decision you want the audience to make. Frame it as the obvious next move given the shift, the stakes, and the new game. Make it small enough to say yes to today and large enough to start a real engagement.",
+      "layoutHint": "title-left"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/survey-analysis.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "survey-analysis",
+  "name": "Survey Analysis",
+  "summary": "Structured walk-through of survey results: topic, executive summary, methodology, findings, analysis, implications, recommendations. Built so a reader who only sees the second slide already knows the headline insight.",
+  "audienceFit": [
+    "executives",
+    "researchers",
+    "stakeholders",
+    "marketing-teams"
+  ],
+  "durationRange": {
+    "minMinutes": 20,
+    "maxMinutes": 60
+  },
+  "tags": [
+    "data-driven",
+    "research",
+    "insights",
+    "voice-of-customer"
+  ],
+  "beats": [
+    {
+      "id": "introduction",
+      "name": "Introduction",
+      "description": "Open by naming the question the survey was meant to answer. Why this, why now, who commissioned it. Anchor the audience in the decision the survey is designed to inform.",
+      "instructions": "Present survey topic",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "executive-summary",
+      "name": "Executive Summary",
+      "description": "State the top three findings in plain language on a single slide. A reader who only sees this slide should still be able to make the right call. Avoid hedging — synthesis is the point.",
+      "instructions": "Summarize key findings",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "context",
+      "name": "Context",
+      "description": "Detail the situation behind the survey: prior knowledge, related research, the gap this work fills. Just enough to position the findings as new information rather than restated common sense.",
+      "instructions": "Detail survey background",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "data-methodology",
+      "name": "Data & Methodology",
+      "description": "Describe how the data was collected and from whom. Sample size, recruitment, instrument, timing. Be honest about limitations; methodological transparency is what gives the findings their weight.",
+      "instructions": "Discuss sourcing and collection",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "data-summary",
+      "name": "Data Summary",
+      "description": "Give the audience an overview of the dataset before drilling in. Demographics, response rates, distribution of key variables. Help them calibrate what 'most' and 'few' mean in this study.",
+      "instructions": "Provide data overview",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "findings",
+      "name": "Findings",
+      "description": "Present the key insights one at a time. Lead each finding with the claim, then the chart. Avoid burying the point under the visualization — captions should restate the insight in words.",
+      "instructions": "Highlight key insights",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "data-analysis",
+      "name": "Data Analysis",
+      "description": "Break down the data behind each finding: cross-tabs, segment splits, statistical confidence. This is the slide skeptics will scrutinize — make it scrutinizable.",
+      "instructions": "Break down data",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "implications",
+      "name": "Implications",
+      "description": "Translate findings into 'so what.' What changes for product, marketing, ops, the customer? Implications without consequences are interesting trivia, not research.",
+      "instructions": "Discuss survey implications",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "recommendations",
+      "name": "Recommendations",
+      "description": "Provide the actions that follow from the implications. Prioritize, attach owners, mark which require decisions. This is where research becomes useful.",
+      "instructions": "Provide action plans",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "conclusion",
+      "name": "Conclusion",
+      "description": "Recap the headline finding and the most important recommendation. End with the next step — a follow-on study, a workshop, a decision — so the work doesn't sit on a shelf.",
+      "layoutHint": "title-left",
+      "instructions": "Recap and finalize",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/survival-story.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "survival-story",
+  "name": "Survival Story",
+  "summary": "Narrative arc of overcoming adversity through determination: catastrophe, backstory, plan, danger, effort, struggle, pivot, breakthrough, legacy, takeaway. For brand stories, founder histories, and leadership talks where the lesson lives in the comeback.",
+  "audienceFit": [
+    "general-audience",
+    "internal-teams",
+    "press"
+  ],
+  "durationRange": {
+    "minMinutes": 10,
+    "maxMinutes": 30
+  },
+  "tags": [
+    "storytelling",
+    "inspirational",
+    "founder",
+    "comeback"
+  ],
+  "beats": [
+    {
+      "id": "catastrophe",
+      "name": "Catastrophe",
+      "description": "Open in the middle of the disaster. Specific moment, specific stakes, specific damage. Drop the audience into the worst point of the story before walking them back.",
+      "instructions": "Present initial disaster",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "backstory",
+      "name": "Backstory",
+      "description": "Detail the events that led up to the catastrophe. Just enough for the audience to understand how the disaster could have happened. Avoid moralizing — the story does the work.",
+      "instructions": "Detail past events",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "blueprint",
+      "name": "Blueprint",
+      "description": "Illustrate the recovery plan. Specific moves, specific bets, specific people. The audience should see the strategy as more than 'try hard.'",
+      "instructions": "Illustrate recovery plans",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "danger",
+      "name": "Danger",
+      "description": "Highlight the emerging threats to the recovery plan. New risks, returning ones. Tension here makes the eventual triumph credible.",
+      "instructions": "Highlight emerging threats",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "endeavor",
+      "name": "Endeavor",
+      "description": "Show the determined effort underway. The hours, the trade-offs, the discipline. The audience must feel the work, not just hear about it.",
+      "instructions": "Show determination effort",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "struggles",
+      "name": "Struggles",
+      "description": "Showcase challenging moments along the way: the setbacks, the false starts, the hard calls. Honest setbacks make eventual success feel earned.",
+      "instructions": "Showcase challenging encounters",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "pivot",
+      "name": "Pivot",
+      "description": "Highlight the strategic shift that changed the trajectory. What got reconsidered, what got dropped, what got doubled down on. The pivot is the moment the protagonist became something new.",
+      "instructions": "Highlight strategy shift",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "breakthrough",
+      "name": "Breakthrough",
+      "description": "Emphasize the moment adversity finally broke. Concrete result, concrete date. Let the slide land — the audience came for this turn.",
+      "instructions": "Emphasize overcoming adversity",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "legacy",
+      "name": "Legacy",
+      "description": "Discuss the enduring impact. What survival made possible afterward, who benefited, what was built on top. Survival stories are most powerful when they create more than they restore.",
+      "instructions": "Discuss enduring impact",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "takeaway",
+      "name": "Takeaway",
+      "description": "Share the lesson the audience can carry away. One transferable insight, framed for their own challenges — not a general moral.",
+      "layoutHint": "title-left",
+      "instructions": "Share important lessons",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/transformation-arc.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "transformation-arc",
+  "name": "Transformation Arc (Before / After / Bridge)",
+  "summary": "Marketing-copy arc adapted for slides: paint the painful 'before,' contrast it with a vivid 'after,' then deliver the bridge that gets the audience from one to the other. Tight, persuasive, and ideal for short pitches, landing-page-style decks, and product-marketing teasers.",
+  "audienceFit": [
+    "customers",
+    "prospects",
+    "marketing-teams",
+    "general-audience"
+  ],
+  "durationRange": {
+    "minMinutes": 3,
+    "maxMinutes": 15
+  },
+  "tags": [
+    "marketing",
+    "copywriting",
+    "pitch",
+    "persuasive"
+  ],
+  "beats": [
+    {
+      "id": "before",
+      "name": "Before",
+      "description": "Describe the audience's current world in the first person they recognize. Specific frustrations, specific costs, specific moments of friction. The clearer the 'before' lands, the more the rest of the deck has to push against."
+    },
+    {
+      "id": "after",
+      "name": "After",
+      "description": "Paint the world the audience could be in instead. Concrete outcomes, not feature lists — what a day looks like, what a quarter feels like, what becomes effortless that used to hurt. Make it desirable and credible at the same time."
+    },
+    {
+      "id": "bridge",
+      "name": "Bridge",
+      "description": "Show the path from before to after: the product, service, or change that closes the gap. Lead with the simplest user-visible thing they do; the architecture can wait. The bridge must feel proportionate to the transformation it promises."
+    },
+    {
+      "id": "evidence",
+      "name": "Evidence",
+      "description": "Prove the bridge has carried others across. One or two strong customer stories, before/after metrics, or named logos with concrete outcomes. Choose proof that maps directly to the 'after' you painted, not generic credibility markers."
+    },
+    {
+      "id": "ask",
+      "name": "Ask",
+      "description": "Close with the single low-friction action that starts the audience across the bridge. Make it small enough to act on now and meaningful enough to count as commitment.",
+      "layoutHint": "title-left"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/trend-analysis.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "trend-analysis",
+  "name": "Trend Analysis",
+  "summary": "Identify and discuss data-driven patterns to understand performance and forecast what's next. Useful for market reviews, strategic outlooks, and any deck where the audience must act on a direction-of-travel call.",
+  "audienceFit": [
+    "executives",
+    "analysts",
+    "leadership"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "data-driven",
+    "forecasting",
+    "strategy",
+    "analysis"
+  ],
+  "beats": [
+    {
+      "id": "introduction",
+      "name": "Introduction",
+      "description": "Open by establishing why this trend matters now. Tie it to a decision on the table or a forecast that's about to be made. Trends without consequences are filler.",
+      "instructions": "Ignite interest, establish significance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "historical-comparison",
+      "name": "Historical Comparison",
+      "description": "Contrast current data with the relevant past. Pick the comparison window that makes the trend visible without cherry-picking. Be honest about base effects.",
+      "instructions": "Contrast current and past data",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "pattern-identification",
+      "name": "Pattern Identification",
+      "description": "Name the recurring outcome you've spotted. Use one or two strong charts that show the pattern unambiguously. Avoid overclaiming significance from a small N.",
+      "instructions": "Point out recurring outcomes",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "future-prediction",
+      "name": "Future Prediction",
+      "description": "Project where the trend leads if it continues. Show the forecast and the confidence interval. State the assumptions that would have to break for the prediction to fail.",
+      "instructions": "Predict using established patterns",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "action-plan",
+      "name": "Action Plan",
+      "description": "Translate the prediction into the strategy it implies. Specific actions, sequenced. Each action should map to a particular reading of the trend, not a generic best practice.",
+      "instructions": "Strategies based on prediction",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "implementation",
+      "name": "Implementation",
+      "description": "Walk through how the actions get executed: owners, milestones, monitoring. The audience should leave understanding what to do tomorrow, not just what to think about.",
+      "instructions": "Discuss strategy execution",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "conclusion",
+      "name": "Conclusion",
+      "description": "Recap the trend, the forecast, and the recommended action. End with the leading indicator you'll watch to know if the call is right.",
+      "layoutHint": "title-left",
+      "instructions": "Summarize key points",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/underdog-victory.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "underdog-victory",
+  "name": "Underdog Victory",
+  "summary": "Story arc of someone or something overlooked who triumphs in the end. Useful for founder narratives, brand stories, and team-building decks where the lesson is about resilience and unexpected wins.",
+  "audienceFit": [
+    "general-audience",
+    "internal-teams",
+    "candidates"
+  ],
+  "durationRange": {
+    "minMinutes": 5,
+    "maxMinutes": 20
+  },
+  "tags": [
+    "storytelling",
+    "inspirational",
+    "founder",
+    "team"
+  ],
+  "beats": [
+    {
+      "id": "origin",
+      "name": "Origin",
+      "description": "Establish the opening scene: who the underdog is and the world that overlooked them. Specific details make the rest of the journey feel real.",
+      "instructions": "Establish opening scene",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "struggles",
+      "name": "Struggles",
+      "description": "Highlight the early setbacks. What didn't work, who said no, where the path closed up. The audience needs to feel the doubt before they can feel the win.",
+      "instructions": "Highlight initial setbacks",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "determination",
+      "name": "Determination",
+      "description": "Showcase the enduring passion that kept the underdog going. What they refused to give up on, and why. Determination, in this beat, is the only resource the underdog has.",
+      "instructions": "Showcase enduring passion",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "crisis",
+      "name": "Crisis",
+      "description": "Identify the lowest point of the journey. The moment the dream nearly ended. Don't soften — the contrast with the triumph ahead depends on the depth of this slide.",
+      "instructions": "Identify lowest point",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "resolve",
+      "name": "Resolve",
+      "description": "Articulate the choice the underdog made to keep going. The strong will, the small bet, the borrowed faith. Resolve is where the protagonist becomes someone the audience roots for.",
+      "instructions": "Articulate strong will",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "breakthrough",
+      "name": "Breakthrough",
+      "description": "Show the reward of perseverance: the customer who said yes, the door that opened, the fortune that turned. The breakthrough should feel earned, not granted.",
+      "instructions": "Reward of perseverance",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "triumph",
+      "name": "Triumph",
+      "description": "Reveal the ultimate success. Concrete outcomes, named milestones. The triumph is the audience's emotional payoff — let it land.",
+      "instructions": "Reveal ultimate success",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "legacy",
+      "name": "Legacy",
+      "description": "Share the lasting impact. What the underdog's victory makes possible for those who come after. The legacy beat is what turns a story into a lesson.",
+      "layoutHint": "title-left",
+      "instructions": "Share long-lasting impact",
+      "slideType": "text"
+    }
+  ]
+}