/brand-manager

name: brand-manager
description: "Set up or update a brand profile: colors, fonts, logo, voice, platforms, compliance rules. \"update our brand colors\""
argument-hint: "[brand-name] [--update] [--switch]"
effort: medium
user-invocable: true

/socialforge:brand-setup — Brand Manager

Set up a new brand profile or update an existing one. Brand profiles control visual identity, platform config, compliance rules, approval chains, and asset sources for all SocialForge workflows.

Context efficiency

Asset-heavy skill. **Grep before Read** the asset catalog (`${CLAUDE_PLUGIN_DATA}/socialforge/brands/<brand>/asset-index.json`) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session.

Pre-Requisite: Image Generation API

SocialForge generates AI images for social media posts. Before setting up a brand, check that Google Cloud Vertex AI credentials are configured.

**Step 0: Check image API (MANDATORY — do this before anything else)**

Run `/socialforge:setup` to configure Google Cloud Vertex AI credentials. Your admin provides a service account JSON file, which `/socialforge:setup` stores securely in the plugin data directory.

**Alternative providers:** Connect fal.ai or Replicate via the Connectors panel.

**Without credentials**, SocialForge can parse calendars, match assets, adapt copy, and render carousels — but it CANNOT generate new images. STYLE_REFERENCED and PURE_CREATIVE modes will fail. ANCHOR_COMPOSE works for basic Pillow compositing only (no AI scene generation).

**If credentials are not configured, warn the user clearly:**

WARNING: No image generation API configured.
Vertex AI credentials are not set. AI image generation will FAIL.

To fix: Run /socialforge:setup to configure Google Cloud Vertex AI credentials.
Or connect fal.ai/Replicate via the Connectors panel.

Do you want to:
  1. Run /socialforge:setup now (recommended)
  2. Continue without image generation (limited functionality)

Wait for user response. If they choose to continue without, log a persistent warning in brand-config.json: `"image_api_configured": false`.

Quick Start (5-10 minutes)

After confirming the image API, users need these 5 things:

1. **Brand name** — Your company or client name 2. **Industry** — pharma, bfsi, real-estate, saas, retail, healthcare, edtech, legal, manufacturing, hospitality, automotive, media, other 3. **Brand colors** — Primary (hex), secondary (hex), accent (hex) 4. **Active platforms** — Which social media platforms (LinkedIn, Instagram, X, Facebook, YouTube, etc.) 5. **Asset source** — Where are brand photos? (Google Drive folder URL, local path, or "I'll add later")

That's it. Run `/socialforge:brand-setup [brand-name]` and answer these questions. SocialForge creates a working brand profile.

**Add more later:** Logo files, fonts, visual style, compliance rules, approval chain, posting times, hashtags via `/socialforge:brand-setup [brand] --update`

**AI-assistance disclosure (`ai_disclosure` in brand-config.json):** defaults to `{"mode": "claude-surfaces", "text": null}`. This governs the AI-assistance note in the monthly delivery manifest (see `/socialforge:assemble-document`) — NOT the post captions themselves: caption-level AI labels belong to each platform's native disclosure toggle (Instagram/TikTok/YouTube ship their own "AI-generated" switches; flag them at publish handoff instead of burning caption characters). Modes: `claude-surfaces` (default — the note attaches when production ran on a Claude surface or the surface is uncertain; skipped only when a non-Claude harness is affirmatively detected), `always`, `off` (the brand owns that choice). Custom `text` replaces the default verbatim; the default is vendor-neutral. Generated IMAGES/VIDEO carry C2PA `ai-disclosure` metadata independently of this setting (see `/socialforge:c2pa-sign`).

Full Setup

Step 1: Core Identity

Brand name: [required]
Brand slug: [auto-generated from name, e.g., "acme-corp"]
Tagline: [optional]
Industry: [required — select from list]
Website: [optional]

Step 2: Visual Identity

Colors:
  Primary: [hex, e.g., #1B4F72] (required)
  Secondary: [hex] (required)
  Accent: [hex] (optional, defaults to primary)
  Background light: [defaults to #FFFFFF]
  Background dark: [defaults to #1A1A1A]
  Text primary: [defaults to #333333]
  Gradient: enabled? start/end/direction (optional)

Logo files:
  Primary logo: [file path or "skip for now"]
  White/reversed logo: [optional]
  Icon version: [optional]
  Logo overlay position: bottom-right (default) | bottom-left | top-right | top-left
  Logo overlay opacity: 0.7 (default)

Fonts:
  Heading font: [filename or Google Font name, defaults to Montserrat-Bold]
  Body font: [defaults to OpenSans-Regular]

Step 3: Visual Style (For AI Generation)

Style keywords: [e.g., "modern", "clean", "professional", "enterprise"]
Mood keywords: [e.g., "confident", "innovative", "authoritative"]
Photography style: warm natural light | studio professional | candid editorial | corporate clean
Illustration style: flat vector | isometric | hand-drawn | 3D render | minimal line art | none
Color temperature: warm | neutral | cool
Contrast level: high | medium | soft

Image rules (array of custom constraints):
  e.g., "Navy should appear in at least 30% of visual area"
  e.g., "Avoid generic stock photo aesthetics"
  e.g., "Always include subtle brand color accents"
  e.g., "No text overlays on product photography"

Step 4: Platform Configuration

For each active platform, configure:
  Platform: linkedin | instagram | x | facebook | youtube | tiktok | pinterest
  Profile type: company | personal | creator
  Posting frequency: daily | 3-4/week | 2/week | weekly
  Optimal posting times: [day + time + timezone]
  Supported formats: static | carousel | video | story | reel | short | text_only
  Content mix: video % | carouse