<aside> 💡 Use case: give the Creative studio the specs, the files and the script shape it needs to make visuals that look like you, without asking.

</aside>

<aside> 👀 Who reads this folder: Creative studio (together with brand-brain/), and the orchestrator. The playbook "Ad creative fatigues" reads the fatigue rule in visual-specs.md.

</aside>

visual-specs.md

<aside> 📐 Controls: colours, fonts, photo style, sizes per format, rules for generated images and voice-overs, and when an ad counts as tired.

How to fill it: copy your colours and fonts from your brand kit. For sizes, check each platform's own help page and write today's size in the table: sizes change, so the file never ships with them filled in.

Save as brand-os/creative/visual-specs.md.

</aside>

# Visual specs

> Read by: creative-studio, which uses Canva, Midjourney, Remotion, Figma and ElevenLabs.
> Everything a designer would ask before making anything. Creative studio follows it exactly.
> Platform sizes change: check each platform's own help page and write today's size in the table.

## 1. Brand basics
- Logo files: [FILL IN: asset IDs from asset-library.md]
- Logo rules: [FILL IN: minimum size, clear space, which version on dark backgrounds]
- Fonts: [FILL IN: heading font, body font, where the files live]

| Colour name | Hex | Use it for |
|---|---|---|
| [FILL IN] | [FILL IN: #RRGGBB] | [FILL IN: backgrounds, text, buttons, accents] |
| [FILL IN] | [FILL IN] | [FILL IN] |
| [FILL IN] | [FILL IN] | [FILL IN] |

## 2. Look and feel
- Photo style: [FILL IN: light, people or no people, settings]
- Illustration style: [FILL IN, or "we do not use illustration"]
- Words that describe our images: [FILL IN]
- Words that do not: [FILL IN]

Example (Northwind Coffee): Photo style: daylight, real kitchens, hands and mugs, no faces unless the person agreed.

## 3. Sizes by format
| Channel | Format | Size in pixels | Text safe area | Notes |
|---|---|---|---|---|
| Instagram | Feed post | [FILL IN] | [FILL IN] | [FILL IN] |
| Instagram | Story or short video | [FILL IN] | [FILL IN] | [FILL IN] |
| LinkedIn | Post image | [FILL IN] | [FILL IN] | [FILL IN] |
| Facebook | Post image | [FILL IN] | [FILL IN] | [FILL IN] |
| TikTok | Video | [FILL IN] | [FILL IN] | [FILL IN] |
| YouTube | Thumbnail | [FILL IN] | [FILL IN] | [FILL IN] |
| Website | Article header | [FILL IN] | [FILL IN] | [FILL IN] |
| Google Business Profile | Post photo | [FILL IN] | [FILL IN] | [FILL IN] |

## 4. Text on images
- Most words on one image: [FILL IN]
- Text colour on photos: [FILL IN]
- Every claim on an image must be in brand-brain/messaging-bank.md.

## 5. Generated images (Midjourney)
- Style words we always add: [FILL IN]
- Words we never use: [FILL IN]
- Never generate: real people, real customers, our staff, competitor products or logos, anything that could pass for a real photo of an event that did not happen.
- Every generated image is labelled "generated" in asset-library.md.

## 6. Video (Remotion) and voice-over (ElevenLabs)
- Captions on every video: [FILL IN: yes or no]
- Length by channel: see video-scripts.md
- Voice: [FILL IN: the voice name you chose in ElevenLabs, and whose voice it is]
- Music: [FILL IN: where licensed music comes from]
- End card: [FILL IN: what the last frame shows]

## 7. When an ad creative counts as tired
The playbook ad-creative-fatigues reads this.
- Counts as tired when [FILL IN: the drop in click rate, or rise in cost per result, that counts as fatigue] over [FILL IN: the period you compare]
- What happens: creative-studio rebuilds it in Canva from a template in asset-library.md. Publishing & social rotates it in. Any change to spend waits in queue/needs-your-ok.md.

asset-library.md

<aside> 🗃️ Controls: every file the Creative studio may use, where it lives and what you have the right to do with it. An asset that is not listed is never used.

How to fill it: point to your Google Drive folder, your Canva brand kit and your Figma file. Add a row per logo, photo and template you want reused. Fill the Rights column honestly: a photo of a person needs that person's permission.

Save as brand-os/creative/asset-library.md.

</aside>

# Asset library

> Read by: creative-studio.
> The list of every file creative-studio may use, where it lives and what you have the right to do with it.
> If an asset is not in this file, creative-studio does not use it.
> Agents may add rows for assets they generate, with the status `proposed`.

## Where assets live
- Main drive: [FILL IN: Google Drive folder link or path]
- Canva brand kit: [FILL IN: link]
- Figma file: [FILL IN: link]

## Assets
| ID | What it is | Type | Where it lives | Rights | Use on | Expires | Status |
|---|---|---|---|---|---|---|---|
| A001 | [FILL IN] | [FILL IN: logo, photo, video, icon, font, music, generated] | [FILL IN: path or link] | [FILL IN: ours, licensed, permission from the person] | [FILL IN: channels] | [FILL IN: date, or "never"] | approved |
| A002 | [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN] | approved |

Example row (Northwind Coffee): | A010 | Bag label close-up, daylight | photo | Drive: /brand/photos/label-01.jpg | ours | all channels | never | approved |

## Templates
| Template | Tool | Channel and format | Link |
|---|---|---|---|
| [FILL IN: e.g. quote card] | [FILL IN: Canva or Figma] | [FILL IN] | [FILL IN] |
| [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN] |

## Ad rotation log
Agents may add rows.
| Ad | Asset ID | Started | Retired | Why it was retired |
|---|---|---|---|---|
| [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN] | [FILL IN: tired, offer ended, replaced] |

## Rules
- Only `approved` assets go out.
- A photo with a person in it needs that person's permission noted in the Rights column.
- An expired asset is never used, even if it is still in the drive.

video-scripts.md

<aside> 🎬 Controls: the formats you make and the script shape every video follows before it is built in Remotion and voiced in ElevenLabs.

How to fill it: list the two or three video formats you actually make. The script template splits each video into beats: what is on screen, what is said, what text appears.

Save as brand-os/creative/video-scripts.md.

</aside>

# Video scripts

> Read by: creative-studio. It writes the script here first, then builds the video in Remotion and the voice-over in ElevenLabs.
> Scripts use only claims from brand-brain/messaging-bank.md and pass brand-brain/tone-rules.md like any draft.

## Formats we make
| Format | What it is for | Length | Channels |
|---|---|---|---|
| [FILL IN: e.g. short tip] | [FILL IN] | [FILL IN] | [FILL IN] |
| [FILL IN: e.g. product close-up] | [FILL IN] | [FILL IN] | [FILL IN] |
| [FILL IN: e.g. behind the scenes] | [FILL IN] | [FILL IN] | [FILL IN] |

## Script template
Copy this block for every video.

- Title:
- Calendar ID:
- Format:
- Channel:
- Length:
- Hook (what is seen and said first): [a pattern from content/hook-bank.md]
- Call to action:
- Voice-over: [yes or no, voice name from visual-specs.md]
- Captions: [yes or no]
- Music:

| Beat | On screen | Voice-over | Text on screen |
|---|---|---|---|
| 1 Hook | | | |
| 2 | | | |
| 3 | | | |
| 4 Call to action | | | |

## Example (Northwind Coffee): short tip
- Title: Read the roast date
- Format: short tip
- Hook: H5

| Beat | On screen | Voice-over | Text on screen |
|---|---|---|---|
| 1 Hook | Close-up of the bag label | "This date tells you more than the price." | Roast date |
| 2 | Finger points to the date | "It is the day the beans were roasted." | |
| 3 | Beans poured into a grinder | "Fresher beans, more flavour in the cup." | |
| 4 Call to action | Logo and sampler bag | "Try the sampler." | Try the sampler |

## Rules
- No real person on screen without permission noted in asset-library.md.
- A voice-over in a real person's voice needs that person's written OK: [FILL IN: where you keep it]

<aside> 👉 Next: /social

</aside>