The four frameworks
Problem, Showcase, Educational and Story — the slot structures that are the product’s core IP, and the tests that police their writing.
structures.ts. The product’s core IP. Every framework has 8 slots except Story, which has 9. Slot 1 is always hook; the last is always cta.
Slots carry id, label, note (one line, beside the box), detail (hover), placeholder, examples[] and repeatable?. id is not unique — three point slots per framework — which is exactly why alignToSlots needs two passes.
problem — Problem → Solution
Name a pain, then fix it. The workhorse, and it works on a cold audience.
| # | id | Label | Note |
|---|---|---|---|
| 1 | hook | Hook | Decides whether slide 2 is ever seen |
| 2 | problem | The problem | Make it sting before you fix it |
| 3 | why | Why it happens | Name the cause, not the symptom |
| 4 | solution | Solution outline | The turn. One line, no detail yet |
| 5–7 | point ↻ | Fix | One fix per slide. Verb first · Same shape as the one before · Three is the sweet spot |
| 8 | cta | Call to action | One ask. Two gets you neither |
showcase — Showcase / Portfolio
Show the work and the thinking behind it. This is the one that books clients.
| # | id | Label | Note |
|---|---|---|---|
| 1 | hook | Hook | Lead with the result, not the client |
| 2 | context | Context | One sentence a stranger would get |
| 3 | goal | The goal | Their brief, in their words |
| 4 | process | The process | Show where it started |
| 5–6 | point ↻ | Key decision | Explain the why. That’s the expertise · Pick the surprising choice |
| 7 | result | Final result | A number beats three adjectives |
| 8 | cta | Call to action | A keyword beats a link |
educational — Educational / Value
Teach one thing properly. Builds the authority the others cash in.
| # | id | Label | Note |
|---|---|---|---|
| 1 | hook | Hook | Numbers beat vague. "3 tricks" wins |
| 2 | promise | The promise | What they’ll know by the end |
| 3 | concept | The concept | The principle underneath |
| 4 | breakdown | Breakdown | Start with the verb |
| 5–6 | point ↻ | Example | Show it working on something real · Three total. A fourth repeats |
| 7 | takeaway | Key takeaway | The line that gets quoted |
| 8 | cta | Call to action | "Save" beats "follow" here |
story — Story / Case Study
Take them through what happened. The most shared of the four.
| # | id | Label | Note |
|---|---|---|---|
| 1 | hook | Hook | Open mid-scene. No setup |
| 2 | situation | The situation | Just enough for the turn to land |
| 3 | problem | The problem | Be specific about the symptom |
| 4 | point ↻ | What they’d tried | Failed attempts make the fix credible |
| 5 | turn | The turning point | The sharpest sentence you have |
| 6 | solution | What you changed | One change, precisely stated |
| 7 | result | The result | Let the numbers persuade |
| 8 | lesson | The lesson | This is what makes it a case study |
| 9 | cta | Call to action | "More breakdowns" beats a pitch |
The writing is tested
Tests enforce the writing itself: notes are 11–46 characters, carry no trailing full stop and no em dash; every slot has a placeholder and at least one example; slot 1 is hook and the last is cta; every framework has a repeatable slot.