@openpresentation/opf 0.1.0

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

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "educate",
+  "name": "Educate",
+  "summary": "Engaging-explainer arc inspired by Mary Roach: surprise the audience with a fact, walk them through evidence and anecdote, scrutinize the assumptions, then close on a memorable insight. For technical, scientific, or analytical talks that need to feel more like discovery than instruction.",
+  "audienceFit": [
+    "general-audience",
+    "students",
+    "practitioners"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "keynote",
+    "education",
+    "explainer",
+    "science"
+  ],
+  "beats": [
+    {
+      "id": "introduction",
+      "name": "Introduction",
+      "description": "Introduce the topic in a way that respects the audience's time and curiosity. Frame why this question is worth asking, and signal the shape of the journey ahead without giving away the destination.",
+      "instructions": "Introduce the topic",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "surprising-fact",
+      "name": "Surprising Fact",
+      "description": "Lead with a single curious fact that recasts how the audience thinks about the topic. The fact should be small, specific, and unforgettable — the cognitive door the rest of the talk walks through.",
+      "instructions": "Share a curious fact",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "experiment",
+      "name": "Experiment",
+      "description": "Walk through a method, study, or thought experiment that probes the surprising fact. Show how knowledge here gets made — the audience should feel like they're shoulder-to-shoulder with the investigator.",
+      "instructions": "Explain a tried method",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "amusing-anecdote",
+      "name": "Amusing Anecdote",
+      "description": "Drop in a story or moment from the field that brings the topic to human scale. Personality and humor here keep the audience leaning forward; technical depth without warmth loses the room.",
+      "instructions": "Relay an interesting story",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "intriguing-information",
+      "name": "Intriguing Information",
+      "description": "Layer in the more complex data or detail. By this point the audience is invested enough to do real work alongside you. Visualize generously — make the numbers tangible.",
+      "instructions": "Share complex data",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "skeptical-scrutiny",
+      "name": "Skeptical Scrutiny",
+      "description": "Question the easy interpretations. Challenge the audience's defaults and your own. Showing where the evidence is contested is what separates a teacher from a publicist.",
+      "instructions": "Encourage questioning of accepted truths",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "extraordinary-explanation",
+      "name": "Extraordinary Explanation",
+      "description": "Present the most counterintuitive or beautiful explanation the topic offers. Take your time here — this is the payoff slide the audience came for.",
+      "instructions": "Break down unusual research findings",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "unconventional-use",
+      "name": "Unconventional Use",
+      "description": "Show an unexpected application or implication of the idea. Surprise reinforces the lesson and gives the audience a story to retell tomorrow.",
+      "instructions": "Expand on unique aspects",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "captivating-conclusion",
+      "name": "Captivating Conclusion",
+      "description": "Close with a thoughtful, slightly poetic wrap-up. Echo the surprising fact, name the lesson, and leave the audience with a new question instead of a tidy answer.",
+      "layoutHint": "title-left",
+      "instructions": "Provide a thoughtful wrap-up",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/employee-review.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "employee-review",
+  "name": "Employee Review",
+  "summary": "Constructive performance-review arc that recognizes work, gives candid feedback, and sets growth goals together. For one-on-one performance conversations and formal year-end reviews.",
+  "audienceFit": [
+    "employee",
+    "manager",
+    "hr-partner"
+  ],
+  "durationRange": {
+    "minMinutes": 30,
+    "maxMinutes": 60
+  },
+  "tags": [
+    "workforce",
+    "hr",
+    "review",
+    "manager"
+  ],
+  "beats": [
+    {
+      "id": "introduction",
+      "name": "Introduction",
+      "description": "Open with the period covered and the spirit of the conversation: collaborative, honest, growth-focused. Frame the meeting so both sides know what to expect.",
+      "layoutHint": "title-left",
+      "instructions": "Name & date",
+      "slideType": "text"
+    },
+    {
+      "id": "performance",
+      "name": "Performance",
+      "description": "Review job execution against the role's expectations. Specific examples, dated. Avoid characterizing the person; describe the work and its impact.",
+      "instructions": "Review job execution",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "achievements",
+      "name": "Achievements",
+      "description": "Acknowledge what went well. Name the projects, the moves, the moments where the employee made a difference. Specific recognition lands harder than generic praise.",
+      "instructions": "Acknowledge success",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "feedback",
+      "name": "Feedback",
+      "description": "Provide constructive feedback grounded in observation. Distinguish patterns from one-offs. Tell the employee something they can act on, not something they can only feel.",
+      "instructions": "Provide positive remarks",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "constructive-criticism",
+      "name": "Constructive Criticism",
+      "description": "Suggest improvements in language that respects the employee's intelligence. Pair each piece of criticism with a concrete example and a specific behavior change you'd like to see.",
+      "instructions": "Suggest improvements",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "development-opportunities",
+      "name": "Development Opportunities",
+      "description": "Highlight growth areas and the experiences that could stretch the employee. Frame development as an investment, not a fix.",
+      "instructions": "Highlight growth areas",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "goals",
+      "name": "Goals",
+      "description": "Outline next-period goals together. Specific, measurable, with explicit support. The strongest goals are co-authored, not handed down.",
+      "instructions": "Outline next steps",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "mentoring",
+      "name": "Mentoring",
+      "description": "Encourage continued learning through mentorship, training, peer pairings. Close the review with the message that growth is a shared responsibility, not a one-way evaluation.",
+      "layoutHint": "title-left",
+      "instructions": "Encourage continuous learning",
+      "slideType": "text"
+    }
+  ]
+}

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

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "failure-analysis",
+  "name": "Failure Analysis",
+  "summary": "Walk through what went wrong, why, and what changes — a structured post-mortem for stakeholder reviews. Pairs honest accountability with a credible recovery plan.",
+  "audienceFit": [
+    "leadership",
+    "customers",
+    "stakeholders",
+    "partners"
+  ],
+  "durationRange": {
+    "minMinutes": 15,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "postmortem",
+    "incident",
+    "review",
+    "accountability"
+  ],
+  "beats": [
+    {
+      "id": "opening-remark",
+      "name": "Opening Remark",
+      "description": "Set an empathetic, accountable tone before any analysis. Acknowledge the impact on the people in the room and the customers affected. Authenticity here earns you the credibility you'll need for the rest of the deck.",
+      "instructions": "Set an empathetic tone",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "incident-breakdown",
+      "name": "Incident Breakdown",
+      "description": "Walk through what happened, in time order. Stick to facts: what systems, what users, what timeline. No causal claims yet — just an accurate, neutral reconstruction the audience can trust.",
+      "instructions": "Detail the failure",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "impact-analysis",
+      "name": "Impact Analysis",
+      "description": "Quantify the damage. Customer-hours lost, revenue at risk, SLA breaches, downstream knock-ons. Be specific and direct; vague impact statements undermine the rest of the post-mortem.",
+      "instructions": "Describe failure's effects",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "root-cause",
+      "name": "Root Cause",
+      "description": "Trace the failure to its underlying cause, not the most visible symptom. Use a 'five whys' or fishbone framing if useful. Distinguish between the proximate trigger and the systemic conditions that allowed it.",
+      "instructions": "Analyze underlying reasons",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "proposed-solutions",
+      "name": "Proposed Solutions",
+      "description": "Present the corrective actions you're taking. Lead with the highest-leverage fix; sequence the rest. For each action, name an owner and a date — solutions without owners are aspirations.",
+      "instructions": "Suggest corrective measures",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "action-plan",
+      "name": "Action Plan",
+      "description": "Lay out the rollout: what ships when, how it's verified, who signs off. Show that 'fixed' has a definition and a deadline, not just intent.",
+      "instructions": "Map out steps",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "evaluate-outcome",
+      "name": "Evaluate Outcome",
+      "description": "Define the metrics that will tell you the fix worked. Pre/post comparisons, monitoring SLOs, error budgets — whatever proves the failure mode is closed and not just deferred.",
+      "instructions": "Assess corrective actions",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "lessons-learned",
+      "name": "Lessons Learned",
+      "description": "Distill the broader lessons that outlive this specific incident. What does the team or organization now know that it didn't before? What patterns will you watch for elsewhere?",
+      "instructions": "Reflect on failure lessons",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "preventive-measures",
+      "name": "Preventive Measures",
+      "description": "List the systemic safeguards being added — process changes, automated checks, on-call procedures, review gates. Show how this category of failure becomes harder to recur, not just this specific instance.",
+      "instructions": "List safeguards",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "closing-thoughts",
+      "name": "Closing Thoughts",
+      "description": "Close with humility and forward momentum. Re-affirm accountability, thank the audience for their patience, and signal confidence in the path forward without overclaiming.",
+      "layoutHint": "title-left",
+      "instructions": "Empathize, trust, and encourage",
+      "slideType": "text"
+    }
+  ]
+}

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

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "focus",
+  "name": "Focus",
+  "summary": "Long-term, principle-driven business arc inspired by Jeff Bezos's 1997 letter to shareholders: name the focus, account for performance, articulate the framework, and commit to the discipline that will keep the company on track. For founder letters, all-hands narratives, and any deck where the audience needs to feel the through-line.",
+  "audienceFit": [
+    "shareholders",
+    "leadership",
+    "all-hands",
+    "board"
+  ],
+  "durationRange": {
+    "minMinutes": 20,
+    "maxMinutes": 45
+  },
+  "tags": [
+    "inspirational",
+    "leadership",
+    "principles",
+    "all-hands"
+  ],
+  "beats": [
+    {
+      "id": "welcome",
+      "name": "Welcome",
+      "description": "Open with a brief framing of what this update is for and what you intend to leave the audience with. Set the tone — long-term, candid, principle-driven.",
+      "instructions": "Overview and objectives",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "accomplishments",
+      "name": "Accomplishments",
+      "description": "Showcase the period's most material wins, briefly. The audience came for what's next; wins earn permission for the harder slides ahead, but they aren't the headline.",
+      "instructions": "Showcase recent achievements",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "potential",
+      "name": "Potential",
+      "description": "Detail the market and customer opportunities ahead. Size them honestly and connect them to the work already underway. Potential without specifics reads as wishful.",
+      "instructions": "Detail market opportunities",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "competitive-edge",
+      "name": "Competitive Edge",
+      "description": "Reveal the strategic positioning that gives the business its advantage. Frame it as a structural moat, not a list of features. The audience should be able to repeat the moat in their own words.",
+      "instructions": "Reveal strategic positioning",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "long-term-vision",
+      "name": "Long-Term Vision",
+      "description": "Emphasize the long-term view that anchors decisions. Quarters serve years; years serve decades. Anchor the audience in the time horizon you actually run the business on.",
+      "instructions": "Emphasize focused future orientation",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "performance-metrics",
+      "name": "Performance Metrics",
+      "description": "Illuminate the indicators that show the long-term thesis is working. Choose metrics that compound — retention, NPS, unit economics — over those that flatter.",
+      "instructions": "Illuminate growth indicators",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "growth-achievement",
+      "name": "Growth Achievement",
+      "description": "Certify the tangible progress against the long-term plan. Year-over-year, cohort behavior, expanded reach. Growth, in this beat, is evidence that the strategy is real.",
+      "instructions": "Certify tangible progress",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "strategic-framework",
+      "name": "Strategic Framework",
+      "description": "Explain the principles that guide decisions. Customer obsession, long-term thinking, frugality, ownership — whatever the actual operating discipline is. Principles are the connective tissue between strategy and behavior.",
+      "instructions": "Explain decision principles",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "expansion",
+      "name": "Expansion",
+      "description": "Detail the next areas of growth: products, segments, geographies. Tie each to the principles above so the audience sees expansion as continuity rather than scatter.",
+      "instructions": "Detail growth potential",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "future-objectives",
+      "name": "Future Objectives",
+      "description": "Forecast the targets and commitments for the period ahead. Be specific enough to be held accountable. Vague objectives are how strategies erode.",
+      "instructions": "Forecast upcoming targets",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "acknowledgment",
+      "name": "Acknowledgment",
+      "description": "Recognize the contributions of teams, customers, and partners that made the period possible. Specific names land harder than blanket thanks.",
+      "instructions": "Recognize contributions and successes",
+      "slideType": "text",
+      "layoutHint": "text-1x-left"
+    },
+    {
+      "id": "closing-remarks",
+      "name": "Closing Remarks",
+      "description": "Recap the focus, thank the audience, and inspire the work ahead. End with the line you most want quoted in tomorrow's newsletter.",
+      "layoutHint": "title-left",
+      "instructions": "Recap, thank, inspire",
+      "slideType": "text"
+    }
+  ]
+}

package/dist/spec/catalogs/narratives/golden-circle.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-narrative/v1",
+  "id": "golden-circle",
+  "name": "Golden Circle (Why / How / What)",
+  "summary": "Simon Sinek's keynote arc: lead with belief, follow with method, finish with proof. Best for brand stories, mission-driven keynotes, and any deck where the audience needs to feel why before they can evaluate what.",
+  "audienceFit": [
+    "customers",
+    "employees",
+    "general-audience",
+    "press"
+  ],
+  "durationRange": {
+    "minMinutes": 10,
+    "maxMinutes": 30
+  },
+  "tags": [
+    "keynote",
+    "brand",
+    "mission",
+    "sinek"
+  ],
+  "beats": [
+    {
+      "id": "why",
+      "name": "Why",
+      "description": "Open with the belief or purpose that animates the work. Why does this exist, and why should anyone care beyond commerce? State it plainly and emotionally — the why is meant to be felt before it is understood."
+    },
+    {
+      "id": "how",
+      "name": "How",
+      "description": "Translate the belief into the principles that guide how you operate. The values, decisions, and trade-offs that make your approach distinctive. The 'how' is what people who share your why recognize as familiar."
+    },
+    {
+      "id": "what",
+      "name": "What",
+      "description": "Show the products, services, or outputs that the why and how produce. Concrete examples, not abstractions. The what is the artifact of the belief — proof that the why is more than rhetoric."
+    },
+    {
+      "id": "proof",
+      "name": "Proof",
+      "description": "Demonstrate the impact in lives, customers, or outcomes. Stories beat statistics here; specific people and moments earn the audience's belief better than aggregate numbers. End with proof that what you do works because of why you do it."
+    },
+    {
+      "id": "invitation",
+      "name": "Invitation",
+      "description": "Close by inviting the audience to share the belief — to buy, build, join, or evangelize. The strongest invitations don't argue; they assume alignment and offer a way in.",
+      "layoutHint": "title-left"
+    }
+  ]
+}