logo-studio
Logo Design Studio
A professional logo design studio combining three industry-standard methodologies — Rand's Reductive Rationalism, Pentagram's Strategy-to-Craft, and Neumeier's Brand Gap — to produce distinctive, memorable brand marks as clean, hand-coded SVG.
Capabilities
- Extracts brand essence through structured discovery interviews
- Maps brands to Jungian archetypes for psychology-informed visual direction
- Generates 9+ distinct SVG logo concepts across 3 strategic directions
- Produces clean, compatible SVG markup with real typography (Google Fonts) or geometric construction
- Presents all concepts in a self-contained HTML gallery with light/dark backgrounds, zoom, and variant strips
- Supports iterative refinement cycles based on user selection and feedback
- Produces a complete app asset package (iOS, Android, macOS, Windows, favicons, PWA, social) from the final logo
- Produces a multi-page brand guidelines document (logo rules, color palette, type scale, layout, UI components, motion, voice, asset management) at the end of the session, offered in Essentials / Standard / Full depth modes
Workflow
| Phase | Name | Reference |
|---|---|---|
| 1 | Brand Discovery | methodologies.md |
| 2 | Strategic Positioning | brand-psychology.md |
| 3 | Concept Generation | methodologies.md |
| 4 | SVG Construction | svg-techniques.md + typography.md |
| 5 | Studio Presentation | gallery-template.html |
| 6 | Iteration & Evaluation | evaluation-criteria.md |
| 7 | App Asset Production | app-assets.md + build-assets.mjs |
| 8 | Brand Guidelines Document | brand-guidelines.md + brand-guidelines-template.html |
Phase 1: Brand Discovery
The discovery phase extracts the information needed for strategic logo design.
Discovery Interview
| Item | Purpose |
|---|---|
| Brand/company name | The wordmark foundation |
| Industry/category | Category conventions and differentiation opportunities |
| Target audience | Demographics, psychographics, aspirations |
| Brand values (top 3) | Core personality traits to express visually |
| Competitors (3-5) | Visual landscape for competitive differentiation |
| The "Only Statement" | "Our brand is the ONLY [category] that [differentiator]" |
| Tone/personality | Where the brand falls on personality spectrums |
| Existing assets | Colors, fonts, or visual elements already in use |
| Use contexts | Where the logo appears (app icon, signage, print, web) |
Personality Spectrums
Position the brand on these axes (1-10):
Traditional ←————→ Modern
Playful ←————→ Serious
Luxurious ←————→ Accessible
Bold ←————→ Subtle
Organic ←————→ Geometric
See methodologies.md for how each methodology approaches the discovery process.
Phase 2: Strategic Positioning
Archetype Mapping
Each brand maps to one of 12 Jungian archetypes. The archetype determines the visual vocabulary — shapes, colors, typography, and composition style.
See brand-psychology.md for the complete archetype-to-visual mapping, color psychology, shape psychology, and typography psychology.
Competitive Landscape
Competitor logos are mapped on two axes to identify visual white space:
Axis 1: Traditional ←→ Modern
Axis 2: Playful ←→ Serious
Logo concepts target the empty quadrants — visual territory not yet claimed.
Three Strategic Directions
| Direction | Characteristics |
|---|---|
| Direction A | Aligns with the primary archetype. Market-conventional, safe. |
| Direction B | Blends primary + adjacent archetype. Distinctive while familiar. |
| Direction C | Contrasts category conventions. Highest differentiation, highest risk. |
Phase 3: Concept Generation
Concept Matrix
Each direction produces 3 logo types, yielding a minimum of 9 concepts:
| Direction A | Direction B | Direction C | |
|---|---|---|---|
| Combination mark | A1 | B1 | C1 |
| Wordmark | A2 | B2 | C2 |
| Symbol / Icon | A3 | B3 | C3 |
Expandable with additional types: lettermark, abstract mark, emblem.
Concept Development
Each concept follows the Reductive Rationalism process:
- Start with the core idea from the Only Statement
- Generate visual metaphors — forced connections between brand noun + unexpected associations
- Thumbnail: quantity over quality
- Reduce: strip to essential elements
- Test mentally: is it drawable from memory?
See methodologies.md for the full process from each methodology.
Phase 4: SVG Construction
Technical Standards
| Standard | Value |
|---|---|
| Scaling | viewBox-based (no fixed width/height) |
| Namespace | xmlns="http://www.w3.org/2000/svg" on every <svg> |
| Shapes | Geometric primitives: circle, rect, polygon, path |
| Typography | <text> with real fonts by default; paths for custom lettering |
| Reusables | Gradients, clipPaths, masks inside <defs> |
| Negative space | fill-rule="evenodd" for counter shapes |
| File size | Under 5KB per logo |
| ViewBox | 200×200 for symbols, 400×120 for combination/wordmarks |
Typography Strategy
Logo wordmarks use real typography by default. The HTML gallery loads Google Fonts so <text> elements render with the intended typeface during preview and iteration.
| Approach | When |
|---|---|
<text> + font-family |
Set-type wordmarks (most modern tech brands). Default for iteration. |
Embedded @font-face |
Portable SVG delivery (email, PDFs, third-party viewers). Font subset to used glyphs. |
Outlined <path> |
Custom lettering (Coca-Cola, Disney style), modified glyphs, or final print/merch delivery. |
Every font-family cascades to a system fallback — e.g. 'Inter', -apple-system, sans-serif — so the logo never renders in Times New Roman.
See typography.md for the curated font catalog (Inter, Work Sans, Fraunces, Playfair Display, Space Grotesk, Manrope, Archivo, and more), classic pairings, licensing, and the text-vs-path decision tree.
SVG Skeletons
Symbol / Icon:
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
<defs>
<!-- Gradients, clipPaths, reusable elements -->
</defs>
<!-- Logo construction from geometric primitives -->
</svg>
Wordmark with real typography:
<svg viewBox="0 0 400 100" xmlns="http://www.w3.org/2000/svg">
<text x="200" y="65" text-anchor="middle"
font-family="Inter, -apple-system, system-ui, sans-serif"
font-size="48" font-weight="800" letter-spacing="-1"
fill="#0A0A0A">Acme</text>
</svg>
Combination mark (symbol + typographic wordmark):
<svg viewBox="0 0 400 120" xmlns="http://www.w3.org/2000/svg">
<g transform="translate(20, 30)">
<!-- Symbol from primitives -->
<circle cx="30" cy="30" r="28" fill="#0071e3"/>
</g>
<text x="90" y="72"
font-family="Inter, system-ui, sans-serif"
font-size="42" font-weight="700"
fill="#0A0A0A">Acme</text>
</svg>
Color Variants
Each logo is produced in three variants:
| Variant | Description |
|---|---|
| Full color | Brand colors informed by archetype and psychology |
| Monochrome | Single dark color (#1d1d1f) on light background |
| Reversed | White (#ffffff) on dark background |
See svg-techniques.md for geometric construction methods, bezier curves, symmetry, golden ratio, and compatibility rules.
Phase 5: Studio Presentation
Gallery Output
All concepts are presented in a self-contained HTML file based on the gallery template.
Output path: ./logo-studio-{brandname}.html in the working directory.
After writing the file, it is opened with open (macOS), xdg-open (Linux), or start (Windows).
Gallery Card Structure
┌─────────────────────────────┐
│ [Light BG] │ [Dark BG] │ ← Side-by-side display
├─────────┬─────────┬─────────┤
│ Color │ Mono │ Reversed│ ← Variant strip
├─────────┴─────────┴─────────┤
│ [ID] Concept Name │
│ Description + rationale │
│ #tag #tag #tag │
└─────────────────────────────┘
Gallery Sections
Cards are grouped by strategic direction:
- Section: Direction A — "Conservative / Archetype-aligned"
- Section: Direction B — "Distinctive / Hybrid"
- Section: Direction C — "Disruptive / Category-breaking"
Phase 6: Iteration
Feedback Protocol
Users reference concepts by ID (e.g., "A1", "C2").
| Iteration Type | Trigger | Action |
|---|---|---|
| Refine | "I like A1 but..." | 3-5 variations of the selected concept |
| Combine | "Mix A1 icon with B2 type" | Synthesize elements from multiple concepts |
| Redirect | "None of these feel right" | Return to Phase 1 for deeper discovery |
| Expand | "More like C-row" | Additional concepts in that direction |
Quality Gates
Each finalist is evaluated against six tests:
| Test | Criterion |
|---|---|
| Napkin test | Drawable from memory after 5-second viewing |
| Thumbnail test | Recognizable at 16×16 pixels (favicon size) |
| Silhouette test | Identifiable as outline only |
| B&W test | Functional without color |
| Swap test | Looks wrong on a competitor's product |
| Context test | Holds presence next to competitor logos at real scale |
See evaluation-criteria.md for detailed evaluation frameworks.
Iteration Gallery
Each iteration produces an updated HTML file: logo-studio-{brandname}-r{N}.html
The updated gallery contains the refined/new concepts with a header noting the round number.
Final Logo Deliverables
The final selected logo is exported as:
| File | Contents |
|---|---|
logo-{name}.svg |
Full-color SVG (working file with <text> elements) |
logo-{name}-mono.svg |
Monochrome SVG |
logo-{name}-reversed.svg |
Reversed/knockout SVG |
logo-{name}-icon.svg |
Symbol-only variant (if combination mark) |
logo-{name}-outlined.svg |
Delivery version with text converted to paths (font-independent) |
The working file (logo-{name}.svg) remains editable. The outlined version is the delivery asset for print, merch, and environments where the font may not load.
Phase 7: App Asset Production
After the final logo is selected, Phase 7 generates a complete app asset package for every major platform from a canonical icon master.
Icon Master
The icon master is a square-format SVG derived from (but distinct from) the final logo:
| Property | Value |
|---|---|
| Canvas | 1024×1024, square |
| Background | Deliberate brand color (not transparent, not white) |
| Content | Usually the symbol only; monograms for wordmark-only brands |
| Typography | Text outlined to paths (font rendering is unreliable in headless rasterizers) |
| Corner radius | None — platforms apply their own masks |
| Safe zone | Central ~61% (matches Android's most restrictive 66/108) |
The icon master is the input to the build pipeline. It is a separate artifact from the logo because icons and logos have different jobs — see app-assets.md for the full design rationale.
Platform Outputs
| Platform | Assets |
|---|---|
| iOS | AppIcon.appiconset/ with light/dark/tinted 1024 PNGs + Contents.json (iOS 18 format) |
| Android | Adaptive icon (ic_launcher.xml + foreground/background/monochrome layers) + legacy densities (mdpi-xxxhdpi) + Play Store 512 |
| macOS | AppIcon.icns built via iconutil from a 10-size .iconset (16 through 1024@2x) |
| Windows | Multi-resolution .ico (16/32/48/256) + UWP tile PNGs (44, 71, 150, 310, wide) |
| Web / Favicon | favicon.ico, favicon.svg, apple-touch-icon.png (180), PWA manifest icons (192, 512, maskable), safari-pinned-tab.svg (monochrome) |
| PWA | site.webmanifest, splash screens, maskable icons with safe-zone padding |
| Social | Open Graph (1200×630), Twitter card (1200×628), LinkedIn, profile pictures (400, 512) |
Tool Stack
| Purpose | Tool | Install |
|---|---|---|
| Programmatic rasterization | sharp (Node, libvips) | npm i sharp |
| Favicon + iOS + Android + Windows package | favicons (npm) | npm i favicons |
| PWA splash + maskable icons | pwa-asset-generator (npm) | npm i pwa-asset-generator |
| CLI rasterization fallback | resvg or rsvg-convert | brew install resvg librsvg |
| macOS .icns builder | iconutil | Built into macOS |
| SVG optimization | svgo | npm i svgo |
| PNG optimization | pngquant + oxipng | brew install pngquant oxipng |
See app-assets.md for the full tool comparison, platform specifications, and gotchas (especially font handling in headless SVG rasterization).
Build Pipeline
The complete pipeline is scripted in build-assets.mjs:
# Install prerequisites (one time)
npm i -D sharp favicons pwa-asset-generator svgo png-to-ico
# Run the build
node build-assets.mjs
Pipeline stages:
- Optimize source SVGs with svgo
- Generate favicon/iOS/Android/Windows package with
favicons - Build macOS
.iconsetwith sharp, theniconutil→.icns - Build iOS AppIcon.appiconset (light + dark + tinted 1024 PNGs)
- Generate social/Open Graph images
- Optimize all PNGs with pngquant + oxipng
Output Structure
dist/assets/
├── logo.svg # Optimized source logo
├── icon-master.svg # 1024×1024 square icon master
├── AppIcon.appiconset/ # iOS asset catalog
├── AppIcon.icns # macOS compiled icon
├── android/ # Adaptive + legacy densities
├── windows/ # .ico + UWP tiles
├── web/ # favicons, PWA manifest, safari-pinned-tab
└── social/ # OG, Twitter, profile images
Critical Typography Note
SVG rasterizers (sharp, librsvg, resvg) render <text> elements using system-installed fonts. In CI or on machines missing the brand font, the output silently substitutes a fallback font. The icon master sidesteps this by using outlined paths — the working SVG keeps live text, the icon master ships outlined.
See typography.md for the dual-output workflow.
Phase 8: Brand Guidelines Document
After the final logo is selected, Phase 8 offers to produce a multi-page brand guidelines document — the single source of truth for how the identity is applied across every touchpoint. The offer is explicit; the document is not generated automatically.
Offer Point
The offer is presented after Phase 6 (logo finalization) and is independent of Phase 7 (app assets). Either phase may precede it. A user who declines app assets can still request guidelines; a user who takes app assets is offered guidelines next.
Depth Modes
| Mode | Pages | Scope |
|---|---|---|
| Essentials | 4–6 | Cover, Intro, Logo, Color, Typography, Asset Management |
| Standard | 8–10 | Essentials + Layout & Grid, UI Components, Voice & Tone |
| Full | 12–14 | Standard + Motion & Animation, Approvals |
Standard is the default when the brand brief mentions digital product, app, web, or deck contexts. Essentials is the default for identity-only engagements. Full is opt-in.
Input Sources
Most of the document is filled in from Phases 1–6 context without re-prompting — brand name, audience, tone, primary colors, signature element, logo variants, and typography are all already established. A short extension interview captures the remaining inputs (version, clear-space rule, minimum size, naming convention, voice attributes, and — in Full mode — motion timings) with a default proposed for every item.
See brand-guidelines.md for the complete section order, per-section input spec, extension-interview checklist, and default content library.
Guidelines Template
The document is assembled from brand-guidelines-template.html — a self-contained HTML scaffold with CSS custom properties for brand colors, @page rules for PDF conversion, and {{TOKEN}} placeholders for every field (logo SVGs, color swatches, type scale, component entries, voice/motion rows, footer line). Sections omitted by the chosen depth mode have their entire <section> block removed at render time.
The document is styled with the brand being documented — its heading font, its primary accent color, its signature element color — so the artifact demonstrates the guidelines it contains.
Output
| File | Contents |
|---|---|
brand-guidelines-{brandname}.html |
Self-contained HTML, ready to print |
brand-guidelines-{brandname}.pdf |
Optional — produced via headless Chrome or Cmd+P Save as PDF |
After writing the HTML, it is opened with open / xdg-open / start. PDF conversion is a separate explicit step; command examples are in brand-guidelines.md.
More from thatjuan/agent-skills
team-executor
Multi-agent orchestration that transforms braindumps into executed results. Assembles expert planning teams (3-7 agents), produces comprehensive execution plans, then deploys fresh execution teams for autonomous delivery. Use when the user describes goals, features, projects, or pastes scattered ideas needing organization and execution. Triggers on "build this", "execute this", "make this happen", "plan and build", or any substantial task description.
11creative-director
World-class creative director for branding, web design, and UI concepts. Use when the user asks for a new design concept, brand identity, website creative direction, UI experience concept, visual identity, or creative strategy for a business, product, or project. Produces detailed, richly described creative concepts — not code or implementations.
11temporal
Expert Temporal.io workflow orchestration for Python and TypeScript. Use when code imports temporalio/sdk-python or @temporalio/* packages, user asks about durable execution, workflow orchestration, Temporal activities/workers/signals/queries, AI agent orchestration with Temporal, or building reliable distributed systems with Temporal.
6heroui
HeroUI v3 component library expertise for React (web) and React Native (mobile). Use when code imports @heroui/react, @heroui/styles, or heroui-native, user asks to build UI with HeroUI, or references HeroUI components, theming, or migration from NextUI/HeroUI v2.
4drizzle-orm
Type-safe SQL ORM for TypeScript with zero runtime overhead. Use when code imports drizzle-orm, drizzle-kit, or drizzle-orm/pg-core, user asks about Drizzle schema design, queries, relations, migrations, or database management with Drizzle ORM. Covers PostgreSQL focus with pgTable, pgEnum, pgSchema, pgView, and drizzle-kit CLI.
4create-readme
Create a README.md file for the project
3