Brandmint

Brandmint

Orchestrated brand identity system that transforms a brand definition into comprehensive marketing outputs — from strategic text documents through AI-generated visual assets to video deliverables and published documentation sites.

Architecture Overview

brand-config.yaml
       ↓
┌─────────────┐     ┌───────────────────┐
│ Wave Planner│←────│Scenario Recommender│
└──────┬──────┘     └───────────────────┘
       ↓
   Waves 1→6
       ↓
   Skills Registry (44 skills, 9 categories)
       ↓
   Hydrator (feeds outputs → config)
       ↓
   Visual Pipeline (FAL.AI assets)
       ↓
   Publishing Pipeline (Wave 7: theme, NotebookLM, decks, reports, diagrams, video)
       ↓
   Wiki → Astro Site

Prerequisites

• Python 3.10+ with uv package manager
• FAL_KEY in ~/.claude/.env
• Dependencies: python-dotenv, fal-client, requests, pyyaml
• Bun (for Astro wiki publishing)
• Node.js >= 18 (for Remotion video rendering)

uv venv .venv && source .venv/bin/activate
uv pip install python-dotenv fal-client requests pyyaml

CLI Commands

# Main entry points (both work)
brandmint [command]
bm [command]

# Global flags (available on all commands)
bm --verbose launch ...   # Enable verbose logging
bm --debug launch ...     # Maximum verbosity
bm --quiet launch ...     # Suppress most output

# Full pipeline wizard
bm launch --config brand-config.yaml --scenario crowdfunding-lean --waves 1-3
bm launch --config brand-config.yaml --max-cost 5.00     # Abort if cost exceeds budget
bm launch --config brand-config.yaml --resume-from 3      # Resume from specific wave

# Visual asset generation (3-phase)
bm visual generate --config brand-config.yaml           # Phase 1: Generate scripts
bm visual execute --config brand-config.yaml --batch anchor     # Phase 2a: Anchor FIRST
bm visual execute --config brand-config.yaml --batch identity   # Phase 2b: Parallel batches
bm visual execute --config brand-config.yaml --batch all        # Or run all remaining
bm visual execute --config brand-config.yaml --force            # Bypass cache, regenerate
bm visual verify --config brand-config.yaml             # Phase 3: Validate

# Execution reports
bm report --config brand-config.yaml                    # Console summary
bm report --config brand-config.yaml --format json      # JSON output
bm report --config brand-config.yaml --format html -o report.html

# Cache management
bm cache stats                                          # Show cache statistics
bm cache clear                                          # Clear all cached prompts
bm cache clear --expired                                # Clear only expired entries

# Scenario planning
bm plan context --config brand-config.yaml
bm plan recommend --config brand-config.yaml

# Skill management
bm install skills    # Creates symlinks in ~/.claude/skills/
bm install check     # Verify installation
bm registry list     # List all 44 skills

Image Providers

Set via env var or config (generation.provider in brand-config.yaml):

Note: Only FAL.AI's Nano Banana Pro supports image references (style anchor cascade).

Skill Categories (44 skills)

Workflow Routing

• "Create a brand for [X]" → Full orchestration: Waves 1-6 → visual pipeline → publishing
• "Generate assets for [X]" → Execute visual pipeline only (needs existing config)
• "Build wiki from outputs" → Publishing pipeline: wiki-doc-generator → markdown-to-astro-wiki
• "Run [skill-name] for [X]" → Individual skill execution

Wave Execution

Skills execute in dependency-ordered waves. Use depth to control how many waves run:

Scenarios

Pre-built execution profiles that filter skills and set execution context:

Domain Tags

Assets are filtered by brand.domain_tags in config. Only matching assets generate:

Hydrator

The hydrator feeds text skill outputs back into brand-config.yaml for downstream consumption:

Backup behavior: save_hydrated_config() creates .yaml.bak before overwriting.

Visual Generation Pipeline

# Phase 1: Generate prompt cookbook + Python scripts
python3 scripts/generate_pipeline.py ./brand-config.yaml

# Phase 2: Execute (anchor first, then parallel batches)
python3 scripts/run_pipeline.py execute --batch anchor
python3 scripts/run_pipeline.py execute --batch identity  # parallel
python3 scripts/run_pipeline.py execute --batch products   # parallel
python3 scripts/run_pipeline.py execute --batch photography # parallel

# Phase 3: Verify
python3 scripts/run_pipeline.py verify --config ./brand-config.yaml

Publishing Pipeline (Wave 7)

# Standalone publishing commands
bm publish notebooklm --config brand-config.yaml    # 7B: NotebookLM notebook + audio
bm publish decks --config brand-config.yaml          # 7C: Slide decks (Marp → PDF)
bm publish reports --config brand-config.yaml        # 7D: Reports (Typst → PDF)
bm publish diagrams --config brand-config.yaml       # 7E: Mind maps & diagrams
bm publish video --config brand-config.yaml          # 7F: Videos (Remotion → MP4)

# Wiki documentation site
./skills/publishing/markdown-to-astro-wiki/scripts/init-astro-wiki.sh my-wiki
./skills/publishing/markdown-to-astro-wiki/scripts/process-markdown.sh ./docs ./my-wiki/src/content/docs
cd my-wiki && bun run build

Key Files

Brand Config Schema

Every brand is defined by brand-config.yaml:

• Schema: assets/brand-config-schema.yaml
• Example: assets/example-tryambakam-noesis.yaml
• Key sections: brand, theme, palette, typography, aesthetic, logo_files, products, prompts

Cost Estimation

Use bm visual preview --config brand-config.yaml --json for detailed cost breakdown.

Critical Learnings

1. Anchor cascade — Style anchor bento MUST generate before all other visual assets
2. Recraft V3 returns SVG/WebP — Must detect and convert to PNG
3. Recraft 1000-char limit — Prompts silently truncate
4. Product identity in prompts — Use {product_hero_physical} not generic descriptors
5. Nano Banana aspect ratios — Use 16:9 format not Flux landscape_16_9
6. API keys — Always load_dotenv(os.path.expanduser("~/.claude/.env"))

Trigger Phrases

Claude should invoke this skill when user says:

• "create a brand", "brand identity", "brand launch"
• "generate brand assets", "visual assets for brand"
• "run brandmint", "execute brand workflow"
• "crowdfunding campaign", "launch campaign"
• "brand positioning", "buyer persona"
• "generate visual pipeline", "brand visuals"