Longform → Content
One raw recording in → a published content system out: relayouted full edit + burned
captions + cold open, 4–8 vertical shorts, CTR thumbnails, and scheduled posts.
Every gate below is MANDATORY, in order. Skipping a gate or a self-test is a failure,
not a shortcut. Violating the letter of these rules is violating their spirit.
Each rule exists because an agent already broke it in production (see Red Flags).
Gates (run in order)
digraph gates {
"G0 Setup check" -> "G1 Brand check" -> "G2 Edit pipeline" -> "G3 Thumbnails" -> "G4 Publish";
"G0 Setup check" -> "STOP: give user references/SETUP.md installs, wait" [label="tool missing"];
"G1 Brand check" -> "Run brand intake (references/BRAND.md)" [label="no DESIGN.md"];
"G4 Publish" -> "STOP: user has no Zernio → onboarding in references/PUBLISHING.md" [label="no account"];
}
G0 — Setup. Verify EVERY tool in references/SETUP.md with its verify command. Any
missing → do not improvise; hand the user that file's install links + instructions and
wait. Never substitute a "similar" tool.
G1 — Brand. A DESIGN.md with measurable tokens (2 colors as hex, fonts as file
paths, wordmark rule) MUST exist before any pixel is rendered. None? Run the intake in
references/BRAND.md — derive from the user's site/deck, or interview, or apply the
neutral default. Never invent brand values silently.
G2 — Edit. Follow references/PIPELINE.md exactly: transcribe once (word-level,
cached) → measure layout geometry per recording → EDL (silence + tight-pacing +
disfluency/stumble cuts — tight is the retention default, PIPELINE.md §3–4) →
relayout render → cold open + cards → corrected burned captions LAST → SRT + chapters →
frame-by-frame self-review before showing the user. Caption timing/text correctness has
its own bible: references/CAPTIONS.md — read it before writing any cue.
G3 — Thumbnails. references/THUMBNAILS.md. The main thumbnail's claim MUST be the
first spoken line of the cold open, and the user's real face photo MUST be used.
G4 — Publish. Packaging (titles, descriptions, chapters, cadence) per
references/YOUTUBE.md; mechanics per references/PUBLISHING.md via Zernio API.
Publishing is user-gated: get explicit per-destination approval ("올려줘/schedule it")
before any publishNow or scheduledFor call. On any timeout: LIST posts before
retrying — never blind-retry.
Quick reference
| Task |
Where |
| Tool installs + verify commands |
references/SETUP.md |
| Brand intake / DESIGN.md template |
references/BRAND.md |
| Full pipeline: cuts, disfluency, relayout, cold open |
references/PIPELINE.md |
| Caption correctness: timing math, ASR corrections, styles |
references/CAPTIONS.md |
| Shorts: moment selection, canvas zones, hook titles, first-frame rule |
references/SHORTS.md |
| Thumbnail CTR rules + generation |
references/THUMBNAILS.md |
| YouTube packaging: titles, descriptions, chapters, cadence, analytics |
references/YOUTUBE.md |
| Zernio onboarding + API + scheduling |
references/PUBLISHING.md |
| Reference implementations (adapt constants) |
scripts/ + scripts/README.md |
| Agents without a skills harness (paste-in prompt + capability matrix) |
BOOTSTRAP.md |
Secrets rule (absolute): skills, handoffs, and scripts reference secret NAMES
(ZERNIO_API_KEY) and where the user stores them — never values, never the user's
account IDs, never their key-file contents. Scrub before sharing anything portable.
Red Flags — STOP, you are about to repeat a real production failure
| Rationalization |
Reality (it already happened) |
| "I'll put the absolute path in the ffmpeg filter" |
C: colon breaks filter parsing. Relative path + cwd only. |
| "Python print is fine without utf-8" |
cp1252 crashed on Korean. PYTHONUTF8=1 + reconfigure, always. |
| "The POST timed out, I'll just retry" |
The post WAS created. Blind retry = duplicate publish. LIST first. |
| "ASR captions are probably fine" |
Scribe mangled ~95 terms in one hour of Korean. Build corrections, grep-verify zero residuals. |
| "The image model will render the text correctly" |
It dropped "$20" → "0". READ the output, regenerate on any glyph error. Never inpaint. |
| "Thumbnail and intro don't need to match" |
Click → first line must repay the thumbnail claim. Reorder the cold open. |
| "I can skip frame review, the commands succeeded" |
Silent failures are invisible in exit codes. Extract frames and READ them. |
| "One-pass filtergraph is simpler" |
Double-encodes when overlays change. Per-segment extract → -c copy concat. |
| "Captions can go before the overlay" |
Overlays hide captions. Captions are LAST. |
| "User has no brand, I'll just pick something" |
Run the intake. Defaults are chosen BY RULE, not by taste. |
Scope limits
- Talking-head/presentation recordings. Not for music videos or animation-first work.
- Voice processing (denoise/EQ) is opt-in only — default keeps original audio untouched.
- The agent's ceiling is staged/scheduled posts; the user presses the final go.
1---2name: longform-to-content3description: Use when a user provides a long-form recording (webinar, class, lecture, talk, podcast, meeting — 통영상, 웨비나 녹화, 강의 영상, 풀영상) and wants it edited, repurposed, or published — a polished full-length edit, vertical shorts/reels, YouTube thumbnails, or scheduled posting to YouTube/Instagram. Also use for "영상 편집해서 올려줘", "쇼츠 만들어줘", "repurpose this recording", or turning one video into a content series.4---56# Longform → Content78One raw recording in → a published content system out: relayouted full edit + burned9captions + cold open, 4–8 vertical shorts, CTR thumbnails, and scheduled posts.1011**Every gate below is MANDATORY, in order. Skipping a gate or a self-test is a failure,12not a shortcut. Violating the letter of these rules is violating their spirit.**13Each rule exists because an agent already broke it in production (see Red Flags).1415## Gates (run in order)1617```dot18digraph gates {19 "G0 Setup check" -> "G1 Brand check" -> "G2 Edit pipeline" -> "G3 Thumbnails" -> "G4 Publish";20 "G0 Setup check" -> "STOP: give user references/SETUP.md installs, wait" [label="tool missing"];21 "G1 Brand check" -> "Run brand intake (references/BRAND.md)" [label="no DESIGN.md"];22 "G4 Publish" -> "STOP: user has no Zernio → onboarding in references/PUBLISHING.md" [label="no account"];23}24```2526**G0 — Setup.** Verify EVERY tool in references/SETUP.md with its verify command. Any27missing → do not improvise; hand the user that file's install links + instructions and28wait. Never substitute a "similar" tool.2930**G1 — Brand.** A `DESIGN.md` with measurable tokens (2 colors as hex, fonts as file31paths, wordmark rule) MUST exist before any pixel is rendered. None? Run the intake in32references/BRAND.md — derive from the user's site/deck, or interview, or apply the33neutral default. Never invent brand values silently.3435**G2 — Edit.** Follow references/PIPELINE.md exactly: transcribe once (word-level,36cached) → measure layout geometry per recording → EDL (silence + tight-pacing +37disfluency/stumble cuts — tight is the retention default, PIPELINE.md §3–4) →38relayout render → cold open + cards → corrected burned captions LAST → SRT + chapters →39frame-by-frame self-review before showing the user. Caption timing/text correctness has40its own bible: references/CAPTIONS.md — read it before writing any cue.4142**G3 — Thumbnails.** references/THUMBNAILS.md. The main thumbnail's claim MUST be the43first spoken line of the cold open, and the user's real face photo MUST be used.4445**G4 — Publish.** Packaging (titles, descriptions, chapters, cadence) per46references/YOUTUBE.md; mechanics per references/PUBLISHING.md via Zernio API.47Publishing is user-gated: get explicit per-destination approval ("올려줘/schedule it")48before any publishNow or scheduledFor call. On any timeout: LIST posts before49retrying — never blind-retry.5051## Quick reference5253| Task | Where |54|---|---|55| Tool installs + verify commands | references/SETUP.md |56| Brand intake / DESIGN.md template | references/BRAND.md |57| Full pipeline: cuts, disfluency, relayout, cold open | references/PIPELINE.md |58| Caption correctness: timing math, ASR corrections, styles | references/CAPTIONS.md |59| Shorts: moment selection, canvas zones, hook titles, first-frame rule | references/SHORTS.md |60| Thumbnail CTR rules + generation | references/THUMBNAILS.md |61| YouTube packaging: titles, descriptions, chapters, cadence, analytics | references/YOUTUBE.md |62| Zernio onboarding + API + scheduling | references/PUBLISHING.md |63| Reference implementations (adapt constants) | scripts/ + scripts/README.md |64| Agents without a skills harness (paste-in prompt + capability matrix) | BOOTSTRAP.md |6566**Secrets rule (absolute):** skills, handoffs, and scripts reference secret NAMES67(`ZERNIO_API_KEY`) and where the user stores them — never values, never the user's68account IDs, never their key-file contents. Scrub before sharing anything portable.6970## Red Flags — STOP, you are about to repeat a real production failure7172| Rationalization | Reality (it already happened) |73|---|---|74| "I'll put the absolute path in the ffmpeg filter" | `C:` colon breaks filter parsing. Relative path + cwd only. |75| "Python print is fine without utf-8" | cp1252 crashed on Korean. `PYTHONUTF8=1` + reconfigure, always. |76| "The POST timed out, I'll just retry" | The post WAS created. Blind retry = duplicate publish. LIST first. |77| "ASR captions are probably fine" | Scribe mangled ~95 terms in one hour of Korean. Build corrections, grep-verify zero residuals. |78| "The image model will render the text correctly" | It dropped "$20" → "0". READ the output, regenerate on any glyph error. Never inpaint. |79| "Thumbnail and intro don't need to match" | Click → first line must repay the thumbnail claim. Reorder the cold open. |80| "I can skip frame review, the commands succeeded" | Silent failures are invisible in exit codes. Extract frames and READ them. |81| "One-pass filtergraph is simpler" | Double-encodes when overlays change. Per-segment extract → `-c copy` concat. |82| "Captions can go before the overlay" | Overlays hide captions. Captions are LAST. |83| "User has no brand, I'll just pick something" | Run the intake. Defaults are chosen BY RULE, not by taste. |8485## Scope limits8687- Talking-head/presentation recordings. Not for music videos or animation-first work.88- Voice processing (denoise/EQ) is opt-in only — default keeps original audio untouched.89- The agent's ceiling is staged/scheduled posts; the user presses the final go.
crealwork