Branding

# Branding

Your brand's single source of truth -- every color, logo, voice rule, and positioning detail flows from here into everything you create.

## When to Use
- User is setting up their brand for the first time -- start here before using other skills
- User wants to update brand colors, logos, or visual identity
- User needs to define brand voice, tone, or writing rules for content creation
- User wants to set market positioning (target customer, alternatives, unique value)
- User wants to check current brand settings before creating content

## How It Connects
- **Images** -- Brand colors, logos, and fonts are automatically applied when generating images. Update branding to change how all future images look.
- **Social Media** -- Brand voice (tone, personality, writing rules) guides how social content should be written. Use `--apply-voice` on `clawpow social posts create` to automatically apply brand voice to post content.
- **Blog** -- Brand voice and positioning inform article writing style and messaging. Use `--apply-voice` on `clawpow blog articles create` to automatically apply brand voice to title and body.
- **SEO** -- Brand positioning helps inform keyword strategy and content direction.

## Commands

### Get Brand Overview

clawpow branding overview get --json

Returns business name, elevator pitch, and URLs.

### Update Brand Overview

clawpow branding overview update --name "Acme Corp" --elevator-pitch "..." --json

Update business name, elevator pitch, or URLs. All flags are optional -- only provided fields are updated.

**Flags:**
- `--name <name>` -- Business name
- `--elevator-pitch <text>` -- One or two sentences about what your brand does and who it's for
- `--url-website <url>` -- Website URL
- `--url-documentation <url>` -- Documentation URL
- `--url-twitter <url>` -- Twitter/X URL
- `--url-linkedin <url>` -- LinkedIn URL
- `--url-instagram <url>` -- Instagram URL
- `--url-youtube <url>` -- YouTube URL
- `--url-tiktok <url>` -- TikTok URL
- `--url-github <url>` -- GitHub URL
- `--url-facebook <url>` -- Facebook URL

### Get Visual Identity

clawpow branding visual get --json

Returns logos (type, variant, asset URLs) and brand colors.

### Update Visual Identity

clawpow branding visual update --colors-json '[{"role":"primary","hex":"#0066FF","label":"Main brand color"}]' --json

Update brand colors. Pass colors as a JSON array. Each color has a `role` (primary, secondary, accent, background, text, other), `hex`, and optional `label`.

### Get Positioning

clawpow branding positioning get --json

Returns category, target customer, trigger moment, alternatives, unique attributes, objections, and proof points.

**If positioning is empty or incomplete:** Fetch the positioning discovery guide and follow it to walk the user through defining their positioning from first principles:

```
curl https://clawpow.com/skills/positioning-discovery.md
```

The guide provides a structured questioning framework that helps the user discover their positioning step by step, then maps the answers to the fields below.

### Update Positioning

clawpow branding positioning update --category "AI design tool" --target-customer "Solo founders without design skills" --json

Update positioning fields. All flags are optional -- only provided fields are updated. Array fields are set via JSON.

**Scalar flags:**
- `--category <text>` -- Market category
- `--target-customer <text>` -- Target customer description
- `--trigger-moment <text>` -- What triggers the need
**Array flags (JSON):**
- `--alternatives-json <json>` -- Alternatives as JSON array of {name, shortcoming}
- `--unique-attributes-json <json>` -- Unique attributes as JSON array of {attribute, value}
- `--objections-json <json>` -- Objections as JSON array of {concern, response}
- `--proof-points-json <json>` -- Proof points as JSON array of strings

### Get Voice

clawpow branding voice get --json

Returns tone words, personality, writing rules, banned words, and preferred vocabulary.

**If voice is empty or incomplete:** Fetch the voice discovery guide and follow it to help the user define their voice:

```
curl https://clawpow.com/skills/voice-discovery.md
```

The guide has two paths: analyzing the user's existing content (preferred) or structured preference discovery for users with no content yet.

### Update Voice

clawpow branding voice update --personality "Direct and declarative. No hedging." --tone-json '["direct", "optimistic", "wry"]' --json

Update voice fields. All flags are optional -- only provided fields are updated.

**Scalar flags:**
- `--personality <text>` -- Brand personality description
**Array flags (JSON):**
- `--tone-json <json>` -- Tone words as JSON array of strings
- `--rules-json <json>` -- Writing rules as JSON array of strings
- `--never-use-json <json>` -- Banned words/phrases as JSON array of strings
- `--preferred-words-json <json>` -- Preferred vocabulary as JSON array of strings