Brand & Art Direction
Seven tools for defining brand packages, checking brand compliance, working with art direction presets, and applying finish effects like grain, vignette, and color grading.
create_brand_package
Create a new brand package with per-client visual identity: colors, typography, motion rules, logo behavior, and compliance guidelines. Writes to catalog/brands/{brand_id}.json and returns the created brand object.
- Name
brand_id- Type
- string
- Description
Required. URL-safe identifier in kebab-case (e.g.,
acme-corp).
- Name
name- Type
- string
- Description
Required. Display name for the brand.
- Name
description- Type
- string
- Description
Short description of brand positioning.
- Name
personality- Type
- string
- Description
Default animation personality —
cinematic-dark,editorial,neutral-light, ormontage.
- Name
style- Type
- string
- Description
Default style pack name (e.g.,
prestige,dramatic,energy).
- Name
colors- Type
- object
- Description
Brand color tokens:
bg_primary,text_primary,accent, etc.
- Name
typography- Type
- object
- Description
Typography tokens:
font_family,hero,tagline,heading,body,label.
- Name
logo- Type
- object
- Description
Logo configuration:
primary,monochrome,icon_only,safe_zone_pct,min_size_px.
- Name
intro_outro- Type
- object
- Description
Logo intro/outro animation:
intro_style,intro_duration_ms,outro_style,outro_duration_ms,outro_hold_ms.
- Name
motion- Type
- object
- Description
Motion rules:
preferred_personality,preferred_style_pack,preferred_easing,forbidden_moves[],max_intensity(0-1).
- Name
guidelines- Type
- object
- Description
Brand guidelines:
dos[]anddonts[].
Returns: The created brand package object, written to catalog/brands/{brand_id}.json.
Try asking your AI:
"Create a brand package with brand_id fintech-demo for our fintech product"
get_brand_package
Load a brand package by brand_id.
- Name
brand_id- Type
- string
- Description
Required. Brand identifier (e.g.,
fintech-demo,mercury,_default).
Returns: Full brand specification including colors, typography, motion rules, logo config, intro/outro, and guidelines.
Try asking your AI:
"Load the fintech-demo brand package"
list_brand_packages
List all available brand packages.
- No parameters.
Returns: Array of brand package names with summary descriptions.
Try asking your AI:
"What brand packages are available?"
validate_brand_compliance
Check a manifest and its scenes against a brand's guidelines. Returns violations for forbidden camera moves, intensity limits, unapproved colors, and personality mismatches. An empty violations array means fully compliant.
- Name
brand_id- Type
- string
- Description
Required. Brand identifier to validate against.
- Name
manifest- Type
- object
- Description
Sequence manifest to check.
- Name
scenes- Type
- object[]
- Description
Scene objects to check for camera/color compliance.
Returns: Pass/fail result plus a violations array — each entry naming the rule, severity, and correction suggestion.
Try asking your AI:
"Validate this manifest against the fintech-demo brand"
get_art_direction
Get an art direction definition by slug. Art direction is separate from personality — personality tells you how things move, art direction tells you why they feel premium.
- Name
slug- Type
- string
- Description
Required. Art direction slug.
Returns: Typography, palette, textures, lighting, logo behavior, background treatment, and compatibility metadata (compatible personalities + style packs).
Try asking your AI:
"Show me the documentary art direction preset"
list_art_directions
List all available art direction presets with descriptions.
- Name
personality- Type
- string
- Description
Filter by compatible personality
- Name
style_pack- Type
- string
- Description
Filter by compatible style pack name
Returns: Array of art direction names with summaries and recommended use cases.
Try asking your AI:
"What art direction presets are available?"
apply_finish_preset
Apply a named finishing preset (cinematic-film, clean-digital, editorial-subtle, social-punchy, premium-brand) to a manifest. Adds compositing passes with tuned parameters.
- Name
preset_slug- Type
- string
- Description
Required. Finish preset slug (e.g.,
cinematic-film,clean-digital,editorial-subtle,social-punchy,premium-brand).
- Name
manifest- Type
- object
- Description
Manifest to apply the finish to.
- Name
overrides- Type
- object
- Description
Optional per-pass parameter overrides.
Returns: Modified manifest with compositing passes applied, plus the resolved pass stack.
Try asking your AI:
"Apply the cinematic-film finish to my manifest"