Brand Agency

The brand-agency skill (skills/brand-agency/SKILL.md) takes a raw product photo (or website URL) to a full brand launch package. The creative work lives in the skill; the durable contract is the brand-definition artifact.

The brand-definition artifact

projects/<slug>/artifacts/brand-definition.json (schema: schemas/video/artifacts/brand-definition.schema.json)

The locked brand system: brand name, positioning statement, taglines (functional/emotional/community), voice rules, a 6-color hex palette (primary, secondary, tertiary background, dark typography accent, metallic, contrast — hex strictly validated), typography hierarchy, a 12-week theme map, and the vision-verified master asset (image path, go-bananas product ref, Flow character name).

It layers with its neighbors — none replaces another:

Artifact	Role
brand-dna.json (brand-extract)	extraction EVIDENCE from a website
brand-definition.json (this)	the locked brand DECISION
project-blueprint.json (director-blueprint)	per-project visual DIRECTION

CLI

vclaw video brand-definition --project <slug> --from-json <path>          # validate only
vclaw video brand-definition --project <slug> --from-json <path> --write  # validate + persist
vclaw video brand-definition --project <slug> --show                      # print the persisted artifact

Validation is strict on required sections and palette hex (#RRGGBB), lenient on other sub-fields, and reports every problem in one error.

Prompt integration

When brand-definition.json exists, filmmaking-prompts appends a compact prose BRAND — Wordmark: …. Palette: …. Voice: …. line to every scene packet, after the canonical 13-block body and after any DIRECTOR addendum. Palette colors render by their authored names (never hex) so the line passes the prompt-lint prose register. No artifact → byte-identical legacy output.

Skill phases (summary)

0. Intake — photo or URL; vclaw video init; URL runs brand-extract first.
1. Product brief — vision-read the photo; [INFERRED] flags on every guess.
2. Market research — cited sweep for the single unsolved problem.
3. Brand definition lock — author the 9 sections; persist via the CLI above.
4. Master asset — ONE packshot, vision-verified (wordmark/hex/proportions), then registered as a go-bananas product reference AND a Flow Character.
5. 10-image brand kit — generate_with_product against the master (or gen-image --backend flow --character <Name>).
6. Campaign films — character-led films via the native Flow R2V lane (flow-register-characters → flow-r2v per scene → stitch-ad; the character-ad skill, native voice, person+product locked); product-only films stay on Seedance/Dreamina with the master reference.
7. Campaign pack — calendar from the theme map, budget, KPIs, portal delivery.

See skills/brand-agency/SKILL.md for the full operating procedure and docs/design/specs/2026-06-10-brand-agency-design.md for the design.