Brief to Treatment
Brief in. Options first. Treatment only for what gets picked.
Stage 0: Intake (one short message, only what's missing)
- Brand and product, exactly as the client says them. Website URL.
- The goal: what the viewer should do or feel.
- Audience.
- Deliverables and runtimes. Never invent counts.
- Mode if known: animation, live action, documentary, or open.
- Budget tier (lean, standard, premium) and timeline, if known.
- Must-haves and no-gos: mandatory messages, banned words, things the client hated before.
Work from a partial brief. Flag gaps. Never fill them with invention.
Stage 1: Research (before any idea)
If web search is available, run it. If not, say so and work from the brief alone.
- The brand. Read the website. Voice, products, claims, differentiators, visual identity.
- The market. 2 to 4 searches: category trends, audience behavior, competitors and how they position.
- What's out there. Search for existing videos and campaigns in the category: competitor ads, creator content, formats that perform (UGC, demos, founder stories, explainers). Note what's overdone and where the gap is.
Present it in chat as short paragraphs, not fragments:
- Market: 3 to 5 points, each a full sentence.
- What's out there: 3 to 5 points naming the common formats and clichés.
- The gap: one or two sentences. The space this brand can own.
- Sources: every claim linked. Prefer recent sources. Never state a stat without a source.
Stage 2: Concept options (in chat, no files)
Pitch 3 to 5 concepts, each genuinely different (different structure, tone or format, not three versions of one idea). At least one safe, at least one bold. For each:
- Title in quotes.
- Logline: one sentence.
- What happens: a short paragraph of 3 to 5 full sentences, concrete and visual, in production language. Who is on screen, what they do, how the camera sees it, how the product enters, how it ends.
- Why it works: one or two sentences tied to the research gap or goal.
- Mode and scale: animation, live action or documentary; rough shoot days or complexity.
- Watch out: one sentence on risk (cost, legal, feasibility), if any.
End with: "Pick one or more and I'll build the treatment." Don't build until they choose. They can also mix ("concept 2 with the ending from 4"). Confirm the mix in one line.
Stage 3: Treatment deck (only for chosen concepts)
Ask the look. The default is the client's own brand. If nothing is available yet, offer sky
(a placeholder), ink or sage.
Brand first. Sky blue is only the stand-in. Before building, look for the client's colors: a brand
book, logo or screenshots the user shares, or the brand's website. Pull two divider colors, the text
color and the font, show them as hex codes and confirm. Use sky blue only when there is no brand to
pull from yet, and say in the hand-off that it is a placeholder to swap for brand colors. Write sky
blue in the spec as "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"}. Never use the yellow gold palette.
Voice. Write the way a director writes a treatment: short, considered paragraphs of two to four full sentences that describe what we see, hear and feel, and why each choice serves the idea. Use the language of production (lensing, light, blocking, texture, pacing, sound design), or of animation for animated work (style, motion, easing, transitions). Sentences connect and build. Never stack fragments or write lines that read like taglines or catchphrases. No filler, no em dashes, no "elevate," "seamless," "immersive."
Deck order:
- Cover: brand, "Treatment."
- The Brief (80 to 110 words, one or two paragraphs): the ask, the goal, then
Deliverables:lines. - Audience & Goals: one paragraph on who they are, then
Goalswith 3 lines (each a full sentence),Action Phrase: one sentence. - What's Out There (optional, from Stage 1): 3 short lines on the landscape,
The Gapline,Sourceswith short names. Full links stay in chat. - Per concept:
- Divider with the concept title.
- The Idea (150 to 200 words, two or three paragraphs): what it is, how it plays on screen, what the viewer feels, the final frame.
- The Arc: 4 to 6 beats,
Open: ...,Turn: ...,Payoff: ...,Close: .... One or two full sentences each, describing the image and the shift. - Look & Sound:
Look: ...(light, palette, camera, texture),Palette: ...,Sound: ...(music, VO tone, sound design). Each label carries two or three sentences, not a list of adjectives. Tie each choice to the brand. - Mood: image slots for references.
- Approach:
Production: ...(mode, days, locations, talent, key crew needs),Post: ...,Timeline: ...if known. - Next Steps: approve a concept, then script, then pre-pro.
Run a legal first pass on claims, comparisons, testimonials and regulated categories. List flags in the hand-off, not the deck. It's a first pass, not legal advice.
Build
python scripts/build_treatment.py spec.json outputs/<Brand>_Treatment_v1.pptx
Spec shape (full example in references/example_spec.json):
{
"brand": "Brand", "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"},
"brief": ["line", "", "Deliverables:", "30s Video (x1)"],
"audience": ["paragraph", "", "Goals", "Action: sentence."],
"landscape": ["line", "", "The Gap", "line", "", "Sources", "Name, Name"],
"concepts": [{"title": "\"Title\"", "idea": ["paragraph"], "arc": ["Open: line"],
"look": ["Look: line", "Palette: line", "Sound: line"], "moodboard": true}],
"approach": ["Production: line", "Post: line"],
"next_steps": ["line"]
}
In landscape lines, avoid a colon mid-sentence: text before a colon renders bold.
Images (last, only after approval)
Same as the pre-pro deck builder: upload images named by slot (c1-mood-1, c1-idea-1,
c1-look-2, landscape-1) and rebuild with --images <folder>. Or offer an AI prompt pack: one
style line and one prompt per slot for any image tool. No real people, logos or trademarked characters.
Review pass (always, before presenting)
Every answer runs twice. The user never sees the first draft.
- Draft the full answer.
- Review it the way a demanding creative director and producer would, against the checklist below and every rule in this skill. Read the copy as if hearing it in a client meeting. Mark every miss.
- Fix every miss, then present only the revised version.
- End with one line:
Review pass: <what changed>, orReview pass: no changes needed.
This applies to every step that produces something: research, options, copy, specs and files. For a file, build it, open or render it, check it, then fix and rebuild before handing it over.
Checklist
- The deck uses the client's brand colors, or sky blue named as a placeholder in the hand-off. Never yellow.
- Every fact and number traces to a linked source. Nothing invented, nothing overstated.
- Concepts differ in structure, tone or format. None is a variation of another.
- Copy reads as connected, descriptive paragraphs in production language. No catchphrase fragments.
- Word counts, deck order and section shapes match this skill. No em dashes, no banned words.
- The deck renders with nothing running off a slide. Legal flags are complete.
Hand-off
Three lines: slide count and concepts, top legal flags, the next step (script). Never add names of crew, talent or contacts without asking.