storyforge 0.4.2 → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +95 -36
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -96,9 +96,31 @@ TOPIC: "${args.topic}"
|
|
|
96
96
|
STYLE: ${args.style} \u2014 ${args.styleGuide}
|
|
97
97
|
TARGET LENGTH: ${minMin}-${maxMin} minutes (write to the topic's natural length \u2014 pad nothing, rush nothing).
|
|
98
98
|
|
|
99
|
-
\
|
|
99
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
100
|
+
HARD WORD-COUNT CONTRACT (this is RULE ZERO \u2014 non-negotiable)
|
|
101
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
102
|
+
|
|
103
|
+
Each chunk's narrationText MUST contain at least (durationEstimate \xD7 2.5)
|
|
104
|
+
words. That's the speech rate of a polished narrator at 150 wpm.
|
|
105
|
+
|
|
106
|
+
- 120s chunk \u2192 \u2265300 words of narration
|
|
107
|
+
- 90s chunk \u2192 \u2265225 words
|
|
108
|
+
- 60s chunk \u2192 \u2265150 words
|
|
109
|
+
- 180s chunk \u2192 \u2265450 words
|
|
110
|
+
- 30s chunk \u2192 \u226575 words
|
|
111
|
+
|
|
112
|
+
Previous generations have FAILED this contract \u2014 writing 65 words for
|
|
113
|
+
a 120s chunk (claiming 120s of speech but actually delivering ~26s).
|
|
114
|
+
Do NOT repeat that mistake. If you cannot fill the duration with
|
|
115
|
+
substantive content, REDUCE the durationEstimate. Do not pad with
|
|
116
|
+
filler \u2014 but do not lie about duration either.
|
|
117
|
+
|
|
118
|
+
Count your words before submitting each chunk. Total script word
|
|
119
|
+
count should be approximately (total duration in seconds \xD7 2.5).
|
|
120
|
+
|
|
121
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
100
122
|
RETENTION PRINCIPLES (these govern every decision you make)
|
|
101
|
-
\
|
|
123
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
102
124
|
|
|
103
125
|
1. OPEN LOOP: In the first 30 seconds, plant a question or claim that
|
|
104
126
|
feels counter-intuitive, stakes-laden, or genuinely confusing. DON'T
|
|
@@ -110,16 +132,33 @@ RETENTION PRINCIPLES (these govern every decision you make)
|
|
|
110
132
|
asking is..." \u2014 a sentence that pulls the viewer back into the core
|
|
111
133
|
question. You should have 3-5 of these naturally distributed.
|
|
112
134
|
|
|
113
|
-
3. ONE DOMINANT METAPHOR
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
135
|
+
3. ONE DOMINANT METAPHOR \u2014 TEACHING, NOT DECORATION:
|
|
136
|
+
Pick ONE concrete analogy before you start writing. Thread it
|
|
137
|
+
through every section. Every time the mechanism gets technical,
|
|
138
|
+
bend back to the metaphor to scaffold understanding.
|
|
139
|
+
|
|
140
|
+
The metaphor MUST DO WORK \u2014 it must PREDICT the mechanism, not
|
|
141
|
+
merely label it.
|
|
142
|
+
|
|
143
|
+
BAD (decoration): "Like our metaphorical chef in the kitchen,
|
|
144
|
+
KV Cache speeds things up."
|
|
145
|
+
GOOD (teaching): "If our chef can grab pre-prepped ingredients
|
|
146
|
+
without looking, what happens when fifty orders
|
|
147
|
+
come in at once? Each new order needs the same
|
|
148
|
+
lookups \u2014 but the prep is already done. That is
|
|
149
|
+
exactly what KV Cache does: it computes each
|
|
150
|
+
key-value pair once, then reuses them across
|
|
151
|
+
every subsequent token."
|
|
152
|
+
|
|
153
|
+
Banned: the word "metaphorical". The word "akin to" used more
|
|
154
|
+
than once. Phrases like "back to our chef" used as filler instead
|
|
155
|
+
of as a vehicle for predicting the next mechanism.
|
|
118
156
|
|
|
119
157
|
Pick your metaphor in a pre-planning step before you write chunk 1.
|
|
120
158
|
Good metaphor tests: (a) can a non-expert picture it in 2 seconds?
|
|
121
159
|
(b) does it survive at least 3 levels of zoom-in? (c) does it map to
|
|
122
|
-
\u22655 of the mechanism's key components?
|
|
160
|
+
\u22655 of the mechanism's key components? (d) does each section USE
|
|
161
|
+
the metaphor to advance understanding, not just nod at it?
|
|
123
162
|
|
|
124
163
|
4. SPECIFICITY BEATS SCALE: One vivid example explained deeply is
|
|
125
164
|
worth five examples listed shallowly. If you're tempted to write
|
|
@@ -131,24 +170,42 @@ RETENTION PRINCIPLES (these govern every decision you make)
|
|
|
131
170
|
- A specific number with units (dollars, ms, parameters, tokens, GB)
|
|
132
171
|
- A specific year or product version
|
|
133
172
|
- A specific event (launch, paper publication, failure)
|
|
134
|
-
|
|
173
|
+
|
|
174
|
+
AND each chunk's narrationText overall must contain AT LEAST 3
|
|
175
|
+
specific entities (3 named things, numbers, or years collectively).
|
|
176
|
+
Vague references like "Google Research, in 2021" without naming the
|
|
177
|
+
paper or product are NOT specific enough \u2014 name the paper, name
|
|
178
|
+
the product, name the team.
|
|
179
|
+
|
|
180
|
+
If a paragraph can't satisfy one rule, REMOVE IT. If a chunk has
|
|
181
|
+
fewer than 3 specific entities total, REWRITE IT before submitting.
|
|
135
182
|
|
|
136
183
|
6. VARIABLE PACING: Sections must have DIFFERENT lengths. Rhythm wins
|
|
137
184
|
retention. A 300s deep-dive should be followed by a 45s breath
|
|
138
185
|
(short callback chunk) before another long section. Do NOT write
|
|
139
186
|
uniform 120s body chunks.
|
|
140
187
|
|
|
141
|
-
\
|
|
142
|
-
FORBIDDEN PHRASES (zero of these)
|
|
143
|
-
\
|
|
188
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
189
|
+
FORBIDDEN PHRASES (zero of these \u2014 patterns AND exact strings)
|
|
190
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
144
191
|
${banList}
|
|
145
192
|
|
|
146
|
-
|
|
147
|
-
|
|
193
|
+
ALSO BANNED (regardless of channel DNA):
|
|
194
|
+
- "Imagine teaching a..." / "Imagine taking..." / "Imagine a..."
|
|
195
|
+
- "Step into the kitchen of..." / "Step into the world of..."
|
|
196
|
+
- "back to our metaphorical..." / "our metaphorical X"
|
|
197
|
+
- "akin to" used more than once total
|
|
198
|
+
- "Are we prepared for..." / "What if..." as section openers
|
|
199
|
+
- Section titles that are just questions without setup
|
|
200
|
+
- "the magic of...", "the power of...", "the secret to..."
|
|
201
|
+
- "memory's power is underestimated" type abstract claims
|
|
202
|
+
|
|
203
|
+
Plus: no rhetorical questions opening sections, no "let's explore",
|
|
204
|
+
no "in this video we'll look at", no generic "welcome back" openers.
|
|
148
205
|
|
|
149
|
-
\
|
|
206
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
150
207
|
STRUCTURE (choose the format that serves THIS topic \u2014 do NOT default)
|
|
151
|
-
\
|
|
208
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
152
209
|
|
|
153
210
|
You have multiple formats available. Pick the one this topic is best
|
|
154
211
|
suited to. Do NOT default to Tesla-style "history \u2192 bet \u2192 stakes".
|
|
@@ -177,17 +234,15 @@ suited to. Do NOT default to Tesla-style "history \u2192 bet \u2192 stakes".
|
|
|
177
234
|
|
|
178
235
|
Pick ONE format. Name it in the first chunk's meta.format field.
|
|
179
236
|
|
|
180
|
-
\
|
|
237
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
181
238
|
CHUNK STRUCTURE
|
|
182
|
-
\
|
|
239
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
183
240
|
|
|
184
241
|
14-22 chunks. Vary durations by purpose:
|
|
185
242
|
|
|
186
243
|
- HOOK (1 chunk, 45-90s): plant the open loop. End with a forward-pull
|
|
187
244
|
sentence. Do NOT introduce yourself here; that's the cold-open.
|
|
188
245
|
- COLD OPEN (1 chunk, 2-5s): 1-2 sentences of channel intro.
|
|
189
|
-
Usually: "Welcome to <channel>, where we <what>. Let's go."
|
|
190
|
-
OR embedded in the hook \u2014 if so, skip this chunk entirely.
|
|
191
246
|
- BODY SECTIONS (4-8 chunks, varied 45-300s each):
|
|
192
247
|
* Long sections (180-300s) build the mechanism
|
|
193
248
|
* Short sections (45-90s) are breaths, callbacks, or reveals
|
|
@@ -202,15 +257,15 @@ CHUNK STRUCTURE
|
|
|
202
257
|
a single provocative claim (re-opens a new loop for next video).
|
|
203
258
|
- END-SCREEN (1 chunk, 8-15s).
|
|
204
259
|
|
|
205
|
-
\
|
|
260
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
206
261
|
PER-CHUNK FIELDS (output JSON \u2014 no extra commentary, no markdown)
|
|
207
|
-
\
|
|
262
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
208
263
|
|
|
209
264
|
[
|
|
210
265
|
{
|
|
211
266
|
"id": "c01-hook" | "c05-mechanism-one" | "c12-payoff" (kebab-case, semantic),
|
|
212
267
|
"title": short Title-Case phrase,
|
|
213
|
-
"narrationText": narration body, multiple paragraphs split by blank lines,
|
|
268
|
+
"narrationText": narration body, multiple paragraphs split by blank lines, MUST be \u2265(durationEstimate \xD7 2.5) words,
|
|
214
269
|
"durationEstimate": integer seconds per the chunk structure above,
|
|
215
270
|
"purpose": one of: "hook" | "cold-open" | "mechanism" | "metaphor-extension" | "mid-roll-rehook" | "example" | "payoff" | "reframe" | "cta" | "teaser" | "end",
|
|
216
271
|
"metaphor": the single video-wide metaphor you chose (string, same value on every chunk),
|
|
@@ -227,34 +282,38 @@ On chunk 1 ONLY, add a meta field:
|
|
|
227
282
|
"plannedOpenLoop": the question/claim you planted in the hook
|
|
228
283
|
"plannedPayoffChunkId": id of the chunk where the loop closes
|
|
229
284
|
|
|
230
|
-
\
|
|
285
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
231
286
|
VOICE
|
|
232
|
-
\
|
|
287
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
233
288
|
|
|
234
|
-
Conversational but authoritative.
|
|
235
|
-
|
|
236
|
-
4-word sentence after a long one.
|
|
237
|
-
"Because" can start sentences.
|
|
289
|
+
Conversational but authoritative. Speak in declarative sentences.
|
|
290
|
+
Use the second person ("you") for stakes and rhetorical pivots.
|
|
291
|
+
Mix sentence lengths \u2014 drop a 4-word sentence after a long one.
|
|
292
|
+
No exclamation marks. "And" / "But" / "Because" can start sentences.
|
|
293
|
+
Every section ends with forward pull.
|
|
238
294
|
|
|
239
|
-
STYLE
|
|
295
|
+
STYLE: ${args.style.toUpperCase()}
|
|
240
296
|
${args.styleGuide}
|
|
241
297
|
${referenceBlock}
|
|
242
298
|
|
|
243
|
-
\
|
|
244
|
-
CRITICAL CHECKLIST (review before you return)
|
|
245
|
-
\
|
|
299
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
300
|
+
CRITICAL CHECKLIST (review before you return \u2014 be honest)
|
|
301
|
+
\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
|
|
302
|
+
\u25A1 Each chunk's narrationText word count \u2265 (durationEstimate \xD7 2.5).
|
|
303
|
+
Total script word count \u2248 (total seconds \xD7 2.5).
|
|
246
304
|
\u25A1 ONE format chosen (not a mash-up). Named in chunk 1's meta.
|
|
247
305
|
\u25A1 ONE metaphor committed to and threaded through every section.
|
|
306
|
+
The metaphor PREDICTS the mechanism \u2014 does NOT just label it.
|
|
248
307
|
\u25A1 Open loop planted in the hook, paid off at 70-85% mark, reframed at end.
|
|
249
308
|
\u25A1 3-5 mid-roll re-hooks spaced through body sections.
|
|
250
309
|
\u25A1 Section durations VARY (not uniform). At least one 45-90s breath chunk.
|
|
251
310
|
\u25A1 Every chunk has \u22653 teaching-oriented imagePromptHints.
|
|
252
311
|
\u25A1 Every paragraph has specific evidence (name / number / year / event).
|
|
312
|
+
\u25A1 Every chunk has \u22653 specific entities total in its narration.
|
|
253
313
|
\u25A1 ZERO forbidden phrases anywhere.
|
|
254
|
-
\u25A1
|
|
255
|
-
\u25A1 Total duration: ${minMin * 60}-${maxMin * 60} seconds.
|
|
314
|
+
\u25A1 The conclusion REFRAMES \u2014 does not summarize, does not "in conclusion".
|
|
256
315
|
|
|
257
|
-
|
|
316
|
+
Now write the script.`;
|
|
258
317
|
}
|
|
259
318
|
|
|
260
319
|
// src/commands/dev.ts
|