@tank/brand-craft
1.0.0Create complete brand identities — logo, colors, typography, guidelines — in minutes. Archetype selection, color psychology, font pairing, AI logo generation (QuiverAI Arrow, Recraft V4), brand guideline output (JSON, CSS tokens, HTML). Triggers: brand identity, create a brand, logo design, color palette, brand guidelines, brand style guide, font pairing, brand archetype, visual identity, brand kit, rebrand, color scheme, logo concept.
name: brand-craft description: | Create complete brand identities — logo, colors, typography, and guidelines — in minutes. Covers discovery interviews, archetype selection, color psychology, font pairing, AI logo generation (QuiverAI Arrow, Recraft V4), and brand guideline output (JSON, CSS tokens, Markdown, HTML). Synthesizes Wheeler (Designing Brand Identity), Airey (Logo Design Love), Mark & Pearson (The Hero and the Outlaw), Adams (Color Design Workbook), Lupton (Thinking with Type), Johnson (Branding: In Five and a Half Steps).
Trigger phrases: "brand identity", "create a brand", "brand design", "logo design", "logo creation", "color palette", "brand colors", "brand guidelines", "brand style guide", "typography for brand", "font pairing", "brand archetype", "brand personality", "visual identity", "brand kit", "design system colors", "startup brand", "rebrand", "brand refresh", "color scheme", "brand book", "logo concept"
Brand Craft
Core Philosophy
- Archetype first, aesthetics second. Every visual decision flows from the brand's archetype and personality. Colors, fonts, and logos that don't reinforce the archetype create cognitive dissonance.
- Constraint breeds quality. A brand needs 1 primary color, 2 fonts, and 1 logo type — not endless options. Decisive constraints produce cohesive identities; optionality produces mush.
- Machine-readable over PDF-pretty. Output brand identity as structured JSON with CSS tokens. PDFs look nice but can't feed design tools, theme generators, or other AI agents.
- Generate, don't describe. Use AI vector generation (QuiverAI Arrow, Recraft V4) to produce actual logo SVGs — not descriptions of what a logo could look like. Ship assets, not briefs.
- 60-30-10 always. Primary color 60%, secondary 30%, accent 10%. This ratio prevents visual chaos in any brand system.
Quick-Start: The Brand Sprint
"I need a brand from scratch"
- Discover — Ask 5 key questions to understand the brand:
- What does the brand do and for whom?
- What 3 words describe the desired personality?
- Who are the top 3 competitors?
- What brands (any industry) feel like what you want?
- What must the brand absolutely NOT feel like?
- Define — Map answers to archetype + personality profile
-> See
references/brand-sprint.mdfor the full discovery framework -> Seereferences/archetype-visual-map.mdto select archetype - Direct — Derive visual direction from archetype:
- Select primary color from archetype palette
- Build full color system (9-shade scale + neutrals + accent)
-> See
references/color-strategy.md - Select heading + body fonts matching archetype personality
-> See
references/typography-system.md
- Design — Generate logo concepts:
- Choose logo type (wordmark, combination mark, abstract, etc.)
- Generate SVG logos via QuiverAI Arrow or Recraft V4
- Create variants (full, icon, mono, reversed)
-> See
references/logo-creation.md
- Deliver — Output complete brand identity:
- Brand identity JSON (machine-readable)
- CSS design tokens
- Brand guidelines document (Markdown or HTML)
-> See
references/brand-output.md
"I need a color palette for my brand"
- Identify archetype or personality direction
- Select primary color using color psychology table
- Derive full palette: primary scale (9 shades) + secondary + accent + neutrals
- Validate WCAG contrast (4.5:1 minimum for text)
-> See
references/color-strategy.md-> Seereferences/archetype-visual-map.mdfor archetype-specific palettes
"I need a logo"
- Determine logo type from brand characteristics
- Craft prompt using logo prompt template
- Generate via QuiverAI Arrow (best quality) or Recraft V4 (cost-effective)
- Optimize SVG with SVGO, generate variants
-> See
references/logo-creation.md
"I need brand guidelines"
- Collect brand decisions (archetype, colors, fonts, logo)
- Generate brand identity JSON
- Output as Markdown brand guide, HTML page, or CSS design tokens
-> See
references/brand-output.md
Decision Trees
Archetype Quick-Select
| Brand Personality | Primary Archetype | Secondary Option |
|---|---|---|
| Trustworthy, expert, knowledgeable | Sage | Ruler |
| Bold, achievement-oriented, strong | Hero | Explorer |
| Disruptive, rebellious, authentic | Outlaw | Creator |
| Innovative, transformative, visionary | Magician | Creator |
| Warm, nurturing, supportive | Caregiver | Innocent |
| Fun, playful, irreverent | Jester | Explorer |
| Elegant, sensual, premium | Lover | Ruler |
| Down-to-earth, relatable, honest | Everyman | Caregiver |
| Free-spirited, adventurous, independent | Explorer | Outlaw |
| Pure, simple, optimistic | Innocent | Caregiver |
| Authoritative, prestigious, exclusive | Ruler | Sage |
| Creative, imaginative, original | Creator | Magician |
Logo Type Selection
| Signal | Recommended Logo Type |
|---|---|
| Short, unique name (1-2 words) | Wordmark |
| Long name or acronym | Lettermark |
| Global brand, language-neutral needed | Abstract mark or Brandmark |
| New brand building recognition | Combination mark |
| Heritage, institutional feel | Emblem |
| Family/consumer audience | Mascot |
| Maximum flexibility needed | Combination mark |
Color Strategy Selection
| Brand Direction | Color Harmony | Why |
|---|---|---|
| Professional, corporate | Monochromatic (blue) | Trust, cohesion |
| Bold, energetic | Complementary | Maximum contrast |
| Natural, approachable | Analogous | Harmonious, calm |
| Playful, diverse | Triadic | Vibrant, balanced |
| Balanced with pop | Split-complementary | Contrast without tension |
| Luxury, minimal | Monochromatic (dark) | Sophistication |
Reference Files
| File | Contents |
|---|---|
references/brand-sprint.md | Rapid brand creation process, discovery questions framework, personality profiling (Aaker dimensions), positioning statement formula, archetype quick-select, creative brief output |
references/archetype-visual-map.md | All 12 brand archetypes with complete visual DNA: colors (hex values), shapes, typography direction, imagery style, brand examples, SVG prompt hints, blending rules |
references/color-strategy.md | Color psychology, industry conventions, cultural considerations, 6 harmony rules, 60-30-10, palette construction from single hex, neutral scales, WCAG accessibility, programmatic generation |
references/typography-system.md | Type personality associations, font selection by brand personality, Google Fonts recommendations (6 categories), pairing rules, hierarchy system, type scale ratios |
references/logo-creation.md | Logo taxonomy (7 types), selection criteria, design principles, AI generation with QuiverAI Arrow and Recraft V4 (code + prompts), variant generation, SVG optimization, iteration strategy |
references/brand-output.md | Brand identity JSON schema, CSS design tokens, Tailwind theme generation, Markdown brand guide template, HTML brand page template, dark mode specs, color scale generation code |