Skip to content

Glossary

Every term, code, and acronym used in the pipeline.

Workflow naming

Every workflow gets a short code so it can be referenced unambiguously across scripts, prompts, file paths, and the version registry.

Pattern: {BrandPrefix}{S|G}{N}

  • BrandPrefix — 3-letter brand code (assigned per client).
  • S / G — S for Sales (product-focused, CTA-driven, conversion goal) or G for Growth (educational, value-first, soft sell — recipes, anatomy explainers, relatable moments).
  • N — sequential integer per brand × type.

Examples (generic):

  • XYZS1 — Brand XYZ, first sales workflow
  • XYZG1 — Brand XYZ, first growth workflow
  • XYZG2 — Brand XYZ, second growth workflow

Version strings

The full versioning system is documented in Variants & Versioning. Quick reference:

Version Meaning
V0-1, V0-2, ..., V0-N Testing phase of a new workflow. Each meaningful change bumps the suffix. No upper bound. Lives in testing/.
V1 First approved version. Reached when the workflow is explicitly approved AND has shipped across all target accounts. Lives in approved/.
V1-1, V1-2 Lvl 1 / Lvl 2 variants of V1. Auto-approved, decimal-bumped. Lives in approved/.
V2-0-1, V2-0-2, ... Testing phase of a Lvl 3 / Lvl 4 variant building toward V2. Lives in testing/.
V2 Approved Lvl 3 / Lvl 4 variant (graduated from V2-0-N after explicit approval).

Variant levels

Level Scope Approval
Lvl 1 ~20% script / dialogue rewrite Auto-approved → approved/
Lvl 2 Script rewrite + wardrobe / styling changes Auto-approved → approved/
Lvl 3 Lvl 2 + prompt improvements (new environment, camera angle, setting) Testing phase → explicit approval → approved/
Lvl 4 Lvl 3 + structural changes (add / remove / split scenes, new prehook) Testing phase → explicit approval → approved/

Pipeline terms

Avatar reference sheet
A 3-panel uploaded photo (front / three-quarter / side profile) used to lock the avatar's face across generations. Body, age, gender, and build are not locked by the sheet — only the face. ("Character reference sheet" is a legacy synonym.)
B-roll
A dedicated cutaway clip that interrupts the speaking footage to show something else (ingredient close-up, demo, lifestyle shot) while the speaker's audio continues. Defining trait: a hard cut to a frame where the speaker is not in shot.
B-roll density

How much B-roll a workflow gets. Options:

  • High — B-roll for every speaking scene
  • Medium (default) — B-roll at scenes that can be visually reinforced
  • Low — 2-3 critical moments only
  • None — no B-roll, continuous speaking
Schwartz framework
The 5 levels of audience awareness (Most Aware → Unaware). Used by the Script Writer to choose hook strategy based on how much the viewer already knows about the problem and the solution.
Prehook
A short visual hook at the start of the video. Edited together with voiceover or text overlay in post-production.
PiP
Picture-in-picture. Mixed-media format where the avatar is composited as a smaller overlay on top of a rendered background scene.
Speaking scene
A scene where the avatar is on-camera, in frame, delivering dialogue. The visual workhorse of most workflows.
Video copy workflow
A workflow built by replicating an existing viral video frame-by-frame, rather than designing from scratch. See the Video Copy guide for the contact-sheet method.

Tool names

NanoBanana 2 (nano_banana_2)
The image generation model. Always the default — never let a workflow fall back to the older NanoBanana 1.
Veo 3.1 (veo-3.1-fast-generate-preview)
The video generation model used for speaking scenes and most B-roll. Accepts a start frame + (optional) end frame and interpolates between them.
Seedance 2.0
Alternative video model accessed via the Jimeng web UI. Uses positive constraints only — no negative prompts.
G-Labs
The local backend that proxies generation API calls. Runs on http://localhost:8765. Exposed via cloudflared tunnel for remote access.
PatchWork
The web app that visualizes and executes .nbflow workflow files. Production URL: https://patchwork-33m.pages.dev/.
cloudflared tunnel
The Cloudflare command that exposes a local service to a public HTTPS URL: cloudflared tunnel --url http://localhost:8765.
R2
Cloudflare R2 — object storage. Reference images and generation outputs are uploaded here for permanent URLs.

File formats

.nbflow
PatchWork workflow file. JSON describing a graph of nodes (prompts, generations, approvals) and the links between them. Multi-tab: one tab per account.
-generated.nbflow
Output of the Generation Runner. Same shape as a .nbflow but with all R2 URLs baked in for the generated outputs. Open in PatchWork to review.

Sales channels

Channel CTA mechanic Notes
TikTok Shop Shop button on the video AI Label Trick recommended (0.01s flash at end). Default channel for many workflows.
Amazon (via keyword) Comment keyword → ManyChat DM → Amazon link No AI label needed.
Meta Shop (FB/IG) Shop button on Reel → Amazon link No AI label needed.
AI Label Trick
For TikTok content: a 0.01-second flash of a dark screen or AI-generated face at the very end of the video. Triggers the platform's "AI generated" label, which helps avoid content-violation flags. Not needed for Amazon or Meta channels.