Skip to main content

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, or montage.

  • 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[] and donts[].

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"

Was this page helpful?