Skip to content

armgit / hypit

Public Imported from GitHub
0

Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.

docs(hypit): say where a Caption Cue ends

rpone96a0308349d4
diff --git a/.agents/skills/hypit/references/playbooks/craft/captions.md b/.agents/skills/hypit/references/playbooks/craft/captions.md
index c375b500..f240e100 100644
--- a/.agents/skills/hypit/references/playbooks/craft/captions.md
+++ b/.agents/skills/hypit/references/playbooks/craft/captions.md
@@ -81,6 +81,28 @@ an omission.
`docs/quickstart/composition.md` still show them; a Recipe carrying either is refused as an unknown
property, since the Style admits exactly the required keys plus the documented optional ones.
+## Cue boundaries are marked in the Script, with `||`
+
+A Recipe holds no rule for where one Cue ends and the next begins. **The Script does**, as a `||`
+between two complete Alignment Units — `docs/quickstart/script.md` is authoritative for it, and
+`packages/script/src/parser.ts` reads it into the breaks the Caption Document carries.
+
+```
+<PRESENTER> It's generally good || at a lot of || different things, ||
+ but it's not || as specialized || as some of these || other models.
+```
+
+A Segment with no `||` in it is **one Cue**, however long it is: the whole passage renders as a
+single line and runs off both edges of the frame. That is the shape to recognise — a caption that
+overflows is a Segment nobody broke, not a Style whose width or size is wrong, and widening the box
+or shrinking the type will not close it.
+
+Mark the breaks where the reference breaks. The observation for a shot says what is on screen at
+once, and that is the Cue.
+
+`||` cannot sit inside a Dual Text unit or split one, since a break falls between units and never
+through one. Timing is not authored with it: each Cue is still timed from the alignment.
+
## Keep the Script authoritative
- Preserve the exact Script display text. Do not copy burned-in reference subtitles or rewrite the
diff --git a/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md b/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md
index ced741cd..1c5ef81a 100644
--- a/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md
+++ b/.agents/skills/hypit/references/playbooks/craft/generated-dependencies.md
@@ -142,7 +142,9 @@ Decide, for each thing you place, which of three kinds it is:
A plain `@a … @/a @b … @/b` closes on one word's end and opens on another word's start, and the
pause between those two words is in neither Selection. Written `@/a~` or `~@b` the two windows meet,
- and what is under them stays under them. `docs/quickstart/script.md` is authoritative for the
+ and what is under them stays under them. The same file carries `||`, which marks where one Caption
+ Cue ends and the next begins — `captions.md` says what happens to a Segment nobody broke.
+ `docs/quickstart/script.md` is authoritative for the
markers.
- **Genuinely coming and going** — an insert that appears for one phrase and leaves. A plain Selection
is exactly right, and the gap is the point.