agentleFS
LordVayronLordVayron/video-factory/.claude/skills/studio/SKILL.md

studio

Skill67 starsChanged 17 days agoMITView on GitHub

Entry point of the AI Video Factory — a Higgsfield-style video studio on APIMart and Kie.ai run from Claude Code. Runs flow v5 for any video request in any format (90s sitcom, micro-drama, AI influencer / clone me, UGC ad, podcast clip, anime, cinematic, fantasy, long-form meditation) in English or Spanish — the 7-question intake → series bible if new → concept → script (gate) → cast (gate) → radio cut → storyboard or frames → Production Book (gate, locks the budget) → film with per-take evals → edit → final QC → delivery receipt → retro. Every step is enforced by the engine (engine/studio.mjs, lib/flow.mjs) and a Claude Code hook. Use for "make a video", "hazme un video", "new episode", "nuevo episodio", "UGC ad for X", "clone me", "AI influencer", "anime short", "podcast clip", "meditación", "/studio".

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use design.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Microsoft AzureSkill

    design

    Design rules and conventions for the API Center Portal. Use when editing detail pages, card components, badges, layout, navigation, sidebars, or headers. Covers badge styling, metadata placement, page navigation patterns, and layout alignment.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 14 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    After that, run node engine/studio.mjs status <slug> and do exactly the step it names under "Siguiente".

    line 13
  2. Distinctive:

    If the engine stops you (ALTO / BUDGET STOP / PROMPT STOP / the guard hook), tell the creator what stopped and why, with options.

    line 15
  3. Very specific:

    Read the vertical's file in references/verticals/ before writing a single line:

    line 30
  4. Very specific:

    Every recipe ends the same way: studio.mjs qc (identity across every cut, transcript against the script, 720p H.264 yuv420p, -14 LUFS, …

    line 52
  5. Distinctive:

    Never reproduce real people other than the user (with their own photos and voice), brand logos without permission, or copyrighted …

    line 89

“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Studio: flow v5

You are the director. Priorities: 1. the writing (for sitcoms: funny dialogue above everything), 2. pacing, 3. continuity, 4. cost, 5. speed. If studio.json exists at the repo root, read it first (language, platforms, default budget, brand and characters); if it doesn't and the user is new, run the onboarding skill. The engine enforces every step below; you cannot skip one, and you must not try to.

The one loop

  1. A new video always starts with the intake (below). No intake, no project.
  2. After that, run node engine/studio.mjs status <slug> and do exactly the step it names under "Siguiente". Repeat.
  3. The creator's steps (concept, script, cast, book, retro, and the series bible) are approved only with their own words: node engine/studio.mjs approve <slug> <step> --said "<their exact words>". Never approve for them, never paraphrase, never approve from a message that is not theirs.
  4. If the engine stops you (ALTO / BUDGET STOP / PROMPT STOP / the guard hook), tell the creator what stopped and why, with options. Do not work around it.

Step 0: the intake (seven questions, one screen each, with AskUserQuestion buttons)

#QuestionOptionsWhat it decides
P1¿Video individual o serie?individual · episodio de una serie existente · serie nueva--series single | episode:<id> | new:<id>; a new series adds the series-bible step
P2¿Qué tipo de video?sitcom · micro-drama · anime · AI influencer · UGC/anuncio · podcast clip · cinemático · fantasía · meditación/long-form · otro--format, the DNA file and the recipe (studio.mjs formats). "Otro" means research and write its DNA file first.
P3¿Tienes una idea o empezamos desde cero?tengo guion · tengo idea · desde cero--start. Script: keep their words, offer a punched version beside it. Scratch: 10 premises to pick from.
P4¿Dónde se publica y en qué medida?TikTok/Reels 9:16 · YouTube 16:9 · duration · language--platform --ar --seconds --lang
P5¿Quién sale en pantalla?personajes existentes · nuevos · tú mismo · mezcla · nadie--cast (+ --chars a,b); new ones go through casting (P5 = new means the cast gate creates them)
P6¿Cuál es el techo de gasto?lo más barato que mantenga calidad · monto fijo · calidad máxima--budget cheapest | fixed:<usd> | max; the book never proposes past it without saying so
P7¿Referencias o tono?links · "que se sienta como…" · sin referencias--refs
Then: node engine/studio.mjs new <slug> --title "..." --series ... --format ... --start ... --platform ... --ar ... --seconds ... --lang ... --cast ... [--chars ...] --budget ... --refs "...".

Step 0.5: load the vertical DNA (always)

Read the vertical's file in references/verticals/ before writing a single line:

VerticalFile
90s sitcom or comedy seriessitcom-90s.md + sitcom-writing-bible.md (mandatory for every sitcom script), then the format-series skill
UGC product adugc-ad.md
AI influencer / clone meinfluencer-talking-head.md
Podcast clippodcast-clip.md
Anime shortanime-short.md
Cinematic / hyperrealcinematic-hyperreal.md
Micro-drama / vertical novela series (TikTok, Reels)micro-drama.md
Fantasy short (epic or cozy)fantasy-short.md
Product launch film (30–35 s, 16:9; storybook, anime, photoreal or a style from your references) from a landing page or launch contextlaunch-film.md (its own editor: engine/launch.mjs)
Long-form meditation, sleep, ambient or focus (10 min to 3 h)meditation-longform.md, then follow the format-longform skill (its own pipeline: engine/longform.mjs)

A new vertical gets a new DNA file (research → what makes it great → structure → writing rules → picture → sound → pacing numbers → QC → failure modes) before its first video. Every retro adds its lessons to that file.

The recipes (engine: lib/flow.mjs)

Format kindFormatsSteps after the script and castEdit with
scenessitcom, micro-drama, animeradio cut (radio.mjs, pacing must pass) → storyboard grids (gen.mjs storyboard) + animatic.mjs → live prices → book → gen.mjs scenes → continuity.mjs + qc.mjs per takeedit.mjs
clipsAI influencer, UGC, podcast, cinematic, fantasy, otherfirst/last frames per shot (gen.mjs frame, or "frame": "@A:last" to open on the previous shot's last frame) → live prices → book → gen.mjs clip <slug> --shot <id> (identity, jumps and dialogue evals run on every take)cut.mjs
longformmeditation, sleep, ambient, focusplan → live prices → longform.mjs estimate → book → gen.mjs narration, bed, loopslongform.mjs build
Every recipe ends the same way: studio.mjs qc (identity across every cut, transcript against the script, 720p H.264 yuv420p, -14 LUFS, contact sheet) → look at the sheet yourself → studio.mjs deliver (receipt + final book) → republish the book → send the mp4 → npm run check and push the backup → retro.

Gates and what each one checks

StepWhoDone when
Intakeengineall seven answers stored (intake.json)
Series bible (new series only)the creatorseries/<id>/series.json filled (premise, cast with wants, room map, voices, intro, ending, rules) and approved
Conceptthe creatorconcept.md approved
Scriptthe creatorthe shotlist's dialogue approved; editing it later reopens the gate
Castthe creatorevery character exists in the bible with a written look that names its marks (freckles, moles, glasses, earrings...), a sheet or reference, a voice if it speaks, and an approved sheet (cast.mjs approve or studio.mjs approve-character <id> --said "..."); for photographic styles, the camera kit chosen in the creator's words (studio.mjs camera <slug> --list shows the format's recommendation and every kit; offer the recommendation first and two alternatives with buttons, then studio.mjs camera <slug> --kit <id> [--lens/--focal/--aperture/--body] --said "...")
Radio cutenginepacing passes (scenes formats)
Storyboard / framesenginegrids + animatic + continuity plan (scenes) or first/last frames (clips); no prompt leaves out a character's marks
Live pricesenginestudio.mjs prices ran in the last 7 days and its pick is the project's video model (the book estimates and the film uses that same model)
Production Bookthe creatorbook.mjs built and published; their yes locks the budget (spent + estimate)
Filmengineevery take used passed its evals, or the creator accepted that exact take in his words (studio.mjs accept-take)
Editenginethe final was cut by the engine from those takes (fingerprinted)
Final QCenginestudio.mjs qc passed on this exact file
Deliveryenginestudio.mjs deliver wrote a receipt whose hash matches the file
Retrothe creatorlessons written to the DNA file and the series bible

Creative calls are the creator's

Anything that changes how the video looks or sounds after the book was approved needs the creator's yes first, even when free: captions, zoom or reframing, crops, cuts, music, voices, a different look. Lay out the options with their trade-offs and wait. Rerolls and extra spend need their explicit yes (phase.mjs budget <slug> --add N --said "..."). Overrides exist only with their words and are printed in the book: studio.mjs override <slug> <step> --said "..." --reason "...".

Sending files to the creator

The guard hook only lets a video or audio file reach the creator when it has a delivery receipt matching its hash. A file to ask them something (a preview, a draft) must carry PREVIEW or DRAFT in its name and be presented as such, never as the delivery.

Models: decided per project by the live price analysis

  • Video: no model is excluded by rule. Every project runs node engine/studio.mjs prices <slug> right before its Production Book (the flow enforces it): it reads the live prices of both providers (APIMart, the main one, and Kie), prices every video model the engine can run for this format at this project's length and resolution, ranks them by quality (lib/pricing.mjs, scored from real A/B tests), and recommends the best quality that fits the intake's budget mode ("cheapest" = the cheapest model that keeps the format's quality floor and the style's approved quality). It also lists models Kie sells that the engine doesn't run yet; when one could beat the pick, propose testing it. Show the creator the table (it is in the book too); --pick <model>@<res> records their choice instead. One model per video, never mixed. Each model runs on the provider that sells it cheaper (the table names it; APIMart wins ties) and moves to Kie when APIMart refuses a job; node engine/gen.mjs credits shows both balances.
    • Typical results: sitcom → Seedance 2 Mini 480p (multi-shot scenes; the broadcast finish downsamples); photoreal humans → Veo 3.1 Quality 720p ($1.25 per 8 s, the winner of an A/B test against Veo Lite, Veo Fast and Kling 3.0). Veo can burn its own captions and jump inside a shot: the evals catch both; never hide them with captions or a zoom without asking.
  • Images: GPT Image 2.5 Sunburst (gpt2.5), always. 1K $0.03, 2K $0.05, 4K $0.08.
  • Voices, SFX, speech-to-speech, voice clones: ElevenLabs (premade voices work on every plan; voice clones need a paid plan).
  • Never pay for a draft that the final can't reuse. The free draft is the radio cut plus the animatic.

Rules

  • Fix at the cheapest stage: script (free) → radio cut (free) → board ($0.08) → video.
  • Delivery: 720p, H.264 yuv420p (long-form: its own output size). Keep the book's video copy under 16 MB (book.mjs re-encodes).
  • 15 minutes max from approval to delivery; at most one reroll per scene inside the budget.
  • Never reproduce real people other than the user (with their own photos and voice), brand logos without permission, or copyrighted characters. Never name real shows or actors in prompts.

Production safeguards. Non-negotiable.

#Failure that happenedSafeguardWhere
1Spent ~2× the approved budget on unapproved rerollsBudget lock. Approving the Production Book (studio.mjs approve <slug> book) locks its estimate; gen.mjs refuses any job past it, and any video job before it (BUDGET STOP). Extra spend only after the creator says yes: phase.mjs budget <slug> --add N --said "...".gen.mjs job(), phase.mjs
2Over an hour of rerolls and engine changes mid-production15-minute rule. At most one reroll per scene, and only if it fits the approved budget. Never change the engine during a production; deliver, report, fix after.this skill + memory
3The set plate was the daytime dining angle, so wides drifted to the wrong angle and to daylightPlate check before filming. set.json → platesMeta (angle, time); the plan check blocks a night scene with a day plate.lib/state.mjs
4Takes filmed against different plates were cut together (angles and couch changed between scenes)Plate stamp. Every take records its plate; edit.mjs refuses mixed plates.gen.mjs, edit.mjs
5The model said "foot… foot"; QC only checked that words were presentTake dialogue eval. Every take is transcribed: missing lines, extra words and repeated words fail it. Final QC re-checks repeats.continuity.mjs, edit.mjs
6A character stood inside the couchPhysics eval. Frames every 0.5 s across each take; a mandatory per-frame "body intersects furniture" fact, so a collision is a hard fail.continuity.mjs
7The exit walk was trimmed into a glitchSilent action shots are never trimmed (exits, walks, reactions keep their planned length).edit.mjs
8The evil laugh and howl were cut as "silence"Vocalizations (laughs, howls, barks) are protected and keep their audience laugh.edit.mjs
9Each take re-invented the voicesVoice unify. Every spoken line in the cut is re-voiced with ElevenLabs speech-to-speech in the character's official voice; timing is kept, so lip sync holds.edit.mjs, lib/eleven.mjs
10I never watched the final at real speedHuman check before sending. A contact sheet at 4 fps of the whole final, plus the full transcript against the script. Any doubt gets reported to the creator with the video, never hidden.this skill
11A character lost her freckles in one shot. The prompt left them out, the shot started on a profile frame, the project ran outside the pipeline, and the old check judged 360 px frames inside one scene and only knew wardrobeIdentity eval. High-res face crops every 0.5 s, each compared side by side with the character's locked face anchor (bible/characters/<id>/face-anchor.jpg, set with --lock-anchor on the approved take) and the reference. A distinctive mark (freckles, mole, glasses, earrings...) that fades or vanishes for 1 s or more fails. Runs automatically on every take (gen.mjs clip, continuity.mjs) and on every final (studio.mjs qc); standalone: continuity.mjs <slug> --identity <video>. A 4 fps thumbnail sheet is not an identity check.lib/identity.mjs, continuity.mjs
12Same failure: the shot's prompt was written by hand and dropped "freckles"Prompt check. A video prompt that leaves out a distinctive mark of a character in it is refused (PROMPT STOP).gen.mjs job()
13Same failure: the shot ran through a one-off script, so the budget lock, prompt check and continuity never ranNo one-off runners. Every paid job goes through gen.mjs (first/last-frame shots: gen.mjs clip <slug> --shot <id>, which runs every take eval); the guard hook denies any script or inline code outside engine/ that calls Kie or ElevenLabs. Every format, not only the sitcom.gen.mjs clip
14A Veo 3.1 Quality first+last-frame shot jumped at 4.4 s inside the shot. No check looked for cuts inside a shot that should be one continuous move; the creator had to spot itJump check (free). ffmpeg scdet (threshold 8) on every generated shot: a jump in the last 0.7 s is an end snap (the model snapping onto its last frame) and gets a suggested trim one frame before it; any other jump is an internal jump (major: reads as a jump cut, the creator decides, a reroll needs his sí). Runs on every take in gen.mjs clip (stored on the take; an end snap trims it in cut.mjs) and standalone: continuity.mjs <slug> --jumps <shot.mp4>. For single shots only, not a final cut.lib/jumps.mjs, gen.mjs clip, continuity.mjs
15That project had no phases, so every gate was skipped ("legacy projects skip gates"); 10 of 13 projects had no budget; --force and --draft skipped QC and continuityFlow v5. studio.mjs + lib/flow.mjs: every project starts with the intake, every command asks requireStep(), the creator's gates need his words and reopen when what he approved changes, no legacy bypass, no --force, a draft is never deliverable. Projects from before v5 are archived read-only.lib/flow.mjs, every engine command
16A video could reach the creator with nothing proving it passedDelivery receipt. studio.mjs qc fingerprints the file that passed; studio.mjs deliver writes the receipt; the guard hook denies sending any video or audio without a matching receipt (PREVIEW/DRAFT files excepted, presented as such).studio.mjs, scripts/hooks/guard.mjs
17Captions and a zoom were added to a finished video without askingCreative calls are the creator's. Captions, zoom, crops, cuts, music, voices, look: options first, his choice, then act. Editors add nothing creative on their own (cut.mjs is a plain cut).this skill, memory
18A clip prompt carried only the picture, so the model never got the script, improvised a paid take and spoke at almost 380 words per minuteScript word for word. Every clip prompt is the shot's prompt plus every line verbatim at a natural pace; job() refuses a speaking video job whose prompt leaves out a line (DIALOGUE STOP). The book shows that exact prompt: read its dialogue before asking for the yes.lib/project.mjs, gen.mjs job()
19The vision judge was down after a take was paid, and the take was lostPaid takes are kept. The take is recorded before its evals; gen.mjs clip <slug> --shot <id> --eval <n> re-runs them for free.gen.mjs clip
20A whole episode was filmed at once on a model never used in production; its timing and sound were only seen after every credit was spentPilot gate. After the book only the first scene or shot can be filmed; the creator approves it in their words (studio.mjs approve-pilot) before the rest.lib/flow.mjs, gen.mjs
21A drama was filmed although the editor had no score, stings or swell, and the cut sounded like a rehearsalFormat readiness. A format whose editor can't finish it stops at the price step. Never promise a sound or look the engine can't make.lib/flow.mjs
22A character's gown changed color in a scene that opened on someone else (scenes only sent face crops)Wardrobe references. Face and full-body views for every character; check the images each scene receives before the book's yes.P.sceneRefs
23A reopened book re-estimated filmed scenes and inflated the budget lockEstimate only what is left to film.book.mjs
24A drama pilot was rejected as "AI slop": candlelit night, 3 people per shot, hand props, a per-shot model invented a gesture and a cut, a line that contradicted the twistDrama rules + look test. dramaRules block the book on dim light, >2 people per shot, >3 shots per generation, hand-object work, fast motion, words per second, long shots or reactions, a late hook, vague words, extreme angles, length, dialogue filmed shot by shot. The cast gate needs a look-test still approved in the creator's words. Read the script backwards from the twist. Recipe: verticals/micro-drama.md.lib/flow.mjs
25Same pilot: re-voiced lines landed 1 s after the lipsNative voice + lip-sync check. Outside the sitcom the take's own voice is kept; a re-voice is dropped if any word drifts more than 0.2 s. Captions and stings are timed on the final dialogue track.edit.mjs
26A micro-drama: each scene opened on its own storyboard and the model invented the reverse angle, so a person's close-up background changed in every scene; each scene passed continuity aloneCoverage angles + background check across scenes. Anyone with close-ups in more than one scene gets one locked angle frame (gen.mjs angles) before the storyboards; the board step refuses missing angles or grids drawn before them; every grid and scene gets the angle as a reference; studio.mjs qc fails a different background behind the same person anywhere in the film. A background drift only in a silent tail is trimmed and re-judged automatically.gen.mjs, lib/flow.mjs, lib/backgrounds.mjs, continuity.mjs
27Same drama: the voice samples spoke script lines and the model said them instead of the scripted lineVOICE REF STOP. Every voice sample is transcribed and refused if it contains a line of the script.gen.mjs
28Same drama: the model's native voices ran ~204 wpm and it was only measured after every scene was filmed; the radio cut was slowed with atempo 0.7 and sounded like slow motionSpeaking rate. Every cut records the model's measured wpm; studio.mjs prices won't recommend a model measured over 175 wpm for a speaking format; approve-pilot stops on a fast pilot unless the creator accepts the rate (--ok-fast). The radio cut refuses tempo under 0.85 and slows its own voices at the source, step by step.lib/pricing.mjs, edit.mjs, studio.mjs, radio.mjs
29The meditation engine was written around sleep only, and a meditation could ship with a generic picture, a fast voice or music with drumsUniversal meditation rules. Eight intentions (sleep, anxiety, higher self, manifestation, morning, self-love, breathwork, focus) set the voice pace, pauses, voice share, music tempo, picture, ending and safety line. The script gate refuses a meditation without an intention and a premise, a scene that doesn't show the premise, faces or text in the picture, fast motion, off-tempo music or music with drums or vocals, and pauses that are too short. A creator's written meditation is kept word for word; their image is animated, not redrawn.lib/meditation.mjs, lib/flow.mjs, longform.mjs script / image
30A demo's narration ran 167 wpm on a sleep piece: ElevenLabs ignored the script's "..."Breath breaks + voice pace. "..." becomes a real break (1.3 s for sleep); the build measures the recorded voice against the intention and fails it outside the range. A demo (15–30 s) speaks by 1.5 s with 2–5 s between lines.gen.mjs narration, longform.mjs
31A loop asked for the same first and last frame came back frozen (motion 0.09) and the demo looked like a photoLOOP STATIC. Loops start from the still only (the build hides the seam with a cross-fade); every loop's motion is measured and a frozen one stops the build. Loop units are cached per source clip.gen.mjs loops, longform.mjs
32A launch film is a story about one product for one audience; generative clips stitched together with invented claims and model-drawn text fail it (PRD, 2026-10-21)Creative director first. The concept gate needs a brief whose facts carry sources and whose assumptions the creator approved, one ICP, a proof tied to a proven capability, and three concepts that aren't paraphrases. The script gate needs a timed plan that sums to the length (±0.25 s), with the proof, a product demo and the brand in the last 4 s, every measurable claim tied to a capability, and no text or logo asked of a model. The cast gate needs the style bible and the visual identity locked in the creator's words. Options outside Release 1 are refused.lib/launch.mjs, lib/flow.mjs, studio.mjs new
33Generated video can't be trusted with exact text, and a cut that drifts by frames breaks music and voice syncDeterministic editor. launch.mjs build cuts every shot on frame boundaries from the plan (exactly 720 frames for 30 s at 24 fps) and composites titles, labels, UI cards, the CTA and the logo itself. The final QC reads every on-screen text back from the frames, checks the voice-over word for word and the frame count, and needs Claude's heuristic quality report on that exact file.launch.mjs, studio.mjs qc
34A first launch film (2026-10-21): one sheet for a group of four creators, and frames that never received it, drew strangers in 6 of 9 framesStandard character sheet (the studio's standard). Every character of every new project, any vertical, has ONE sheet of its own in the project's style (cast.mjs model-sheet, lib/modelsheet.mjs): name and project, turnaround front/3/4/side/back, 4–6 expressions, 3 poses, 3 details with callouts, 5-color palette with hex, notes (role, wants, secret/flaw/bit), from character.json sheetSpec. Never a group: a look that describes several characters is refused. The whole sheet is the reference every frame receives. The cast gate refuses a new project without it. Model: a long-running series' sheets.lib/modelsheet.mjs, cast.mjs, lib/flow.mjs, gen.mjs frame
35A first launch film (2026-10-21) felt disconnected next to the reference: chopped narration, five unrelated places, no thread, slides, light that changed, photoreal clips in a drawn world, a jumpy mix; and the reference had been read as "no voice" from a silence detectorTown calibration. launch.mjs reference profiles a reference by transcript. A narrated launch film has one continuous narration recorded in one take with the picture cut to it, every cut declares how it follows, one thread runs through it, one light, only cuts or short fades, every shot leveled to one look, real footage graded into the world, and the mix stays within 6 dB.lib/reference.mjs, lib/launch.mjs, launch.mjs voice --take, launch.mjs build
36A first launch film v2-v3 (2026-10-21): the video model choreographed the shots (papers falling for no reason, people popping into a laptop screen, tapes sinking into the ground, sliding down stairs, a blob flying into the cart), and a 2 fps thumbnail check let them throughChoreography + frame-by-frame review. Every animated shot names its drawn last frame (end, sent to Kling as the last frame) and a still list; vague verbs are refused; anything that falls needs a cause and a landing place; world rules (style.continuity) are restated in every shot that shows them. Never ask the model for a fall, drop or loose object near a pile (cards, tapes in a cart): it animates piles on its own. Prefer camera moves (a pan with first and last frames cut from one image) to object physics. Before the final, launch.mjs review makes a 4 fps sheet of every take; each gets --ok/--reject in words, tied to the take and its prompt. A rejected take is saved without a reroll when it can be: retime {upTo} (the clean part, slowed ≤1.54x with motion interpolation) or splice {keep, fade} (clean pieces joined by short dissolves), both with the creator's words.lib/launch.mjs planRules, launch.mjs review, launch.mjs build
37A first launch film v5 (2026-10-21): two shots of one desk joined by a slide-up nobody asked for, an idle hand at the end and loud effects; the creator accepted the film only as one continuous storyOne continuous story. Shots of one place are drawn in one set, and a shot ends on the next shot's exact first frame (or the change is composited onto that exact image) so the cut disappears. No transition or effect the creator did not ask for; each cut is a story beat shown in the storyboard first. A screen becomes the world with zoomInto (the camera flies into it, completing at the cut) and a ripple (one ring of water from the touch point). Effects sit about 21 dB under the narration. Nothing idles in frame and nothing exists before its cause.launch.mjs build, lib/launch.mjs planRules
38A reference launch film was first read as "no voice" from silence detection and from 2 fps thumbnails, and the first plan copied nothing useful from itReference engine. Any video the creator likes (file or link) is measured locally (whisper transcript, clustered cut detection, per-shot timing and motion, hook, pauses, bed, mix, music tempo, sound hits, on-screen text, look), cut into per-shot and per-join sheets, broken down by the agent under breakdownRules, and enters the bank only in the creator's words. Productions of that format choose their references (or none) before the concept, are calibrated to them, and never repeat their lines (copyOverlap <= 20 %). The creator never types a command.lib/refs.mjs, refs.mjs, lib/flow.mjs refsGate/copyGate, studio.mjs refs
39A second launch film (2026-10-23): painted characters looked like images moving their mouths, and a model picked by general score and price could not make them actActing and the model for the job. A shot with people takes acting (intention, reactions, body language); it lifts the small-actions rule for that shot while the set, objects and identities stay locked. studio.mjs prices names what the video needs and picks the best model for that job, then the cheapest of the best, from reviewed side-by-side tests recorded per need (studio.mjs fit); it offers only models good for the job, then untested ones. With no evidence yet, the book waits for two models tested on one shot.lib/launch.mjs clipPromptOf, lib/pricing.mjs needsOf/forTheJob/recommend, studio.mjs prices/fit, lib/flow.mjs bookCheck
40A second launch film: seven narration takes were rejected (rushed, slow, flat, chopped, no pauses) because each was sent without being checkedOne expressive take, measured first. The voice gets voDirection (delivery tags, checked word for word against vo) and take.paragraphs (one line per paragraph, so the voice breathes inside one generation); never chop a take into lines. Every take is measured against the reference before it is sent: pace, pauses at line ends, longest silence, word for word. A brand name heard as two words still matches.launch.mjs voice --take
41A second launch film: two music rounds missed the film because they were picked by mood, not derived from itMusic derived from the film. A film with music needs a musicBrief: premise, emotion to evoke, context, narrator, the approach (instruments, tempo, energy) with why it fits, how it leaves room for the voice, and turns on the script's lines. No genre or tempo is prescribed. Measure the result before showing it.lib/launch.mjs planRules
42A second launch film: leveling every shot to one average darkened the bright backlit peak and lifted the dark opening; the logo was small and entered aloneLook and brand. style.grade: false keeps each take's light. brand.logoWidth, brand.logoY and brand.logoIn set the logo's size, height and fade-and-grow entrance; the CTA enters with it. Motion tests run before the book with their own capped allowance. Re-approving the book keeps the approved budget, and take names are claimed atomically.launch.mjs build, gen.mjs job/nextName, lib/flow.mjs approve
43A second launch film opened on a timeline gliding past for 4-5 s: nothing happened on screen to make people lookVisual hook by 3 s. The first shot names its visualHook (what happens on screen, at ≤ 3 s); a camera move alone is refused.lib/launch.mjs planRules
44A launch film: the engine was changed again and again during one production; each fix brought new bugs and full redraws, and two days passed with nothing deliveredENGINE FREEZE. A production finishes on the engine it started with: every paid job refuses to run once the engine code changed, until the creator agrees (studio.mjs engine-update <slug> --said). Deliver first, improve the engine after.lib/freeze.mjs, gen.mjs job()
45Same: several times more paid frames than neededATTEMPT STOP and REWORK STOP. A third payment for the same asset, or more than two paid jobs per asset (from 10 on), stops until the creator's yes. Find why it fails before paying again.gen.mjs job()
46Same: two set fixes each silently discarded every frameREDRAW STOP. A change that discards paid frames or takes says how many and the redraw cost, and waits for the creator's words.launch.mjs apply
47Same: frames chained with shell loops; a timeout left a stale frame that the next shot copiedBatch commands only. The guard refuses shell loops around paid engine commands. gen.mjs frame-chain <slug> draws a film's frames in order, previews count, cost and measured time, retries only provider timeouts and stops at the first failure. A chained frame is never copied from an unjudged frame.guard, gen.mjs frame-chain
48Same: paid jobs ran while the creator was asking why; an angry message was used as an approvalThe creator's words. The guard refuses paid commands while the creator's last message is a question. Every --said must be literal text from a message the creator wrote, and retries or extra spend need a yes.guard, scripts/hooks/creator.mjs
49Same: times promised and missed; the Production Book not shown in two daysMeasured time and the clock. Every paid job records its seconds; estimates use the measured median. studio.mjs status shows the clock (15 min from book to delivery) and paid jobs per asset. Quote only those numbers.gen.mjs, studio.mjs status
50Same: the script promised a feature the product doesn't haveProduct facts. Every format that sells something records what the product does NOT do and what every video must say (launch/brief.json, or studio.mjs product); the script gate refuses violations.lib/flow.mjs productFacts
51Same: screens drawn black, green or anything; end frames copied the opening pose; the judge used the wrong stateScreen timeline. Every screen in a set map has a state, never conditional; changes are a timeline; an insert shot turns the screen green. The judge and the prompts use each frame's state; end frames lead with the change.lib/launch.mjs, gen.mjs frame
52Same: untested code committed (broken regex escapes)Checked commits. A commit in the factory repo needs npm run check to have passed on exactly that code.guard, scripts/hooks/stamp.mjs
53Short shots glued together: every cut depended on a model landing on a drawn pose, and the cuts jumpedSequences. A scene is one continuous camera take with one opening keyframe; shots are split from it. Hard cuts only between scenes; every cut in the final must be planned.lib/direction.mjs, gen.mjs sequence, studio.mjs qc
54A take painted unreadable words on screens; an app window floated out of a screen; faces multiplied on a buildingScreen-text and still critics. Local OCR fails a take with painted words; the vision judge checks every take against the shot's stay-as-it-is rules (nothing appears, multiplies, floats out of a screen or turns into a screen).lib/critics.mjs screenText, stillCheck
55A continued take drifted and the next scene opened on the wrong faceIdentity gate. Before a scene continues a take, the faces at its end are checked against the anchors; a drift redraws the keyframe (REKEY). At most two scenes in a row continue a take.lib/direction.mjs, gen.mjs frame-chain
56A pull-back that opened on an extreme wide: the model pushed in first, then pulled backCamera-move rule. The plan refuses a pull-back that opens on an extreme wide; open closer.lib/launch.mjs planRules
57The final QC reported planned cuts as unplanned (takes run longer than their place in the cut)Cuts at the plan's timing. The QC places each planned cut from the launch plan; one continuous sequence has no cuts inside it.studio.mjs qc
58Delivery after a QC override rewrote the book estimate and reopened the bookOverride counts as passed. A QC the creator overrode counts as passed for the final book.book.mjs

Phase tracking: node engine/studio.mjs status <slug>. Every engine command also prints the exact next step when it stops.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.