Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Conversion Architecture

3 Claude skills that design menus, pricing pages, and conversion flows using behavioral psychology.

Built by Branded Mayhem Collective. Works in Claude.ai (web), Claude Code, Claude desktop, Cursor, and Codex CLI — anywhere SKILL.md is read.


The Problem

Most conversion optimization is guesswork dressed up as strategy. Move the button. Change the color. A/B test the headline. None of it is grounded in how people actually make decisions.

Behavioral economics has decades of research on choice architecture, anchoring, loss aversion, and decision fatigue. But translating academic papers into UI decisions is a full-time job nobody has.

What This Package Does

Three executable playbooks that apply behavioral psychology to real business problems:

  1. Choice Architecture — Design product menus, ordering flows, and upsell intercepts using proven behavioral nudges
  2. Pricing Strategy — Build loss-leader pricing with choreographed upgrade paths and viral UGC offsets
  3. Creative Direction — Psychology-driven visual identity systems that encode memory and drive response

These aren't theory documents. They're step-by-step playbooks that Claude executes — producing JSON blueprints, implementation roadmaps, scoring functions, and measurement dashboards.


Skills Included

Skill What It Does Use When
ux-ui-psych Choice architecture playbook (PLAY-002): preselect defaults, anchor pricing, upsell/cross-sell intercepts, contextual bandits for ranking Designing product menus, ordering flows, kiosk UX, any conversion flow
fairness-anchor-ladder Pricing strategy (PLAY-001): lock one "fairness anchor" price + stack 3-7 profitable upgrades + engineer UGC around the anchor Loss-leader pricing, menu architecture, viral pricing plays
neuro-design Neuro-Design Playbook (v1.0): 6 psychological design plays for creative direction and visual identity Brand identity, campaign creative, assets that need to encode memory

Quick Start

1. Install

This repo works on two surfaces. Pure playbooks, no API keys, no filesystem dependencies — install path is the only difference.

Claude Code (plugin install — primary path):

/plugin marketplace add Branded-Mayhem-Collective-LLC/conversion-architecture
/plugin install conversion-architecture@bmc-conversion-architecture

Installing the whole stack? Add Branded-Mayhem-Collective-LLC/contraband-marketplace and install with @contraband instead. Verify with /plugin list — skills land under /conversion-architecture:<skill>.

Claude.ai web / Claude Desktop:

Paste the repo URL into Claude.ai web and ask:

"Install the skills from https://github.com/Branded-Mayhem-Collective-LLC/conversion-architecture"

Or download as .zip, unzip, upload skill folders via Settings → Customize → Skills.

2. Use the Skills

Design a conversion flow:

/conversion-architecture:ux-ui-psych Design the ordering flow for a fast-casual restaurant kiosk

Build a pricing strategy:

/fairness-anchor-ladder Design pricing for a SaaS product with a $29/mo anchor

Create a visual identity system:

/neuro-design Design a brand identity for a luxury fitness brand targeting 30-45 professionals

Skill Deep Dives

ux-ui-psych — Choice Architecture (PLAY-002)

Designs conversion flows using behavioral economics:

Core Mechanics:

  • Preselect defaults — the option most people should pick is already selected
  • Anchor premium price — show the expensive option first so the mid-tier feels reasonable
  • One post-add-to-cart upsell — single intercept, not a gauntlet
  • One in-cart cross-sell — contextual, not random
  • Contextual bandits — ML-driven ranking that learns from behavior

Scoring Function:

score = margin × attach_rate × popularity × affinity × inventory_pressure − penalties

Output: JSON blueprint (UI frame, defaults, scoring weights, patterns, metrics, guardrails), 30/60/90 implementation roadmap, ethics telemetry dashboard.

Implementation Phases:

  1. Instrument events — track what users do today
  2. Baseline patterns — set eligibility rules from observed behavior
  3. Scoring weights — tune the ranking function
  4. A/B test — copy, placement, timing
  5. Contextual bandits — let the system learn
  6. Kill switch — automatic rollback if metrics degrade

fairness-anchor-ladder — Pricing Strategy (PLAY-001)

The playbook: Lock one "fairness anchor" price public + stack 3-7 profitable upgrades adjacent + engineer UGC around the anchor.

The Math:

U × (L_a + S_u + Σ(AR_i × M_i)) ≥ 0

Where: U = units, L_a = anchor loss, S_u = social offset (earned media value from UGC), AR_i = attachment rate for upgrade i, M_i = margin for upgrade i.

Key Insight: The anchor item loses money on product margin but generates social media content (shares, photos, reviews) that offsets customer acquisition cost. The upgrades stack margin on top.

Output: JSON blueprint (anchor specs, upgrade ladder, bundles, media cadence, KPIs, guardrails), weekly UGC content calendar, case study framework.

Metrics Dashboard:

  • Shares per unit (target: 0.3+)
  • Attachment rates by upgrade slot
  • Blended contribution margin
  • CAC delta (before/after anchor launch)

neuro-design — Psychology-Driven Creative Direction (v1.0)

Six psychological design plays, each producing specific design artifacts:

Play Psychology Produces
P1: Geometric Reduction Universal shape recognition SVG shape library, motion rules, minimum viable mark
P2: Sensory Branding Ritual + anticipation Audio stings, interaction sounds, haptic patterns
P3: Salient Accent Red Dot hierarchy (pop-out effect) Color specs, LUT, accessibility deltas
P4: Nostalgia Fusion Cultural memory refresh Reference boards, era-specific palettes, type guides
P5: Emotional Direction One feeling per asset Emotion-tagged style guides, shot lists
P6: Emotional Polarity Tribal positioning Attraction/repulsion mapping, brand territory

Decision Helper: Not sure which play to use? The skill includes a decision tree:

  • Need instant recognition → P1
  • Need ritual/anticipation → P2
  • Need visual hierarchy → P3
  • Need cultural resonance → P4
  • Need emotional response → P5
  • Need tribal identity → P6

QA Tests: Each play includes validation:

  • Memory test (can someone draw your logo from memory?)
  • Cue recognition (does the audio sting trigger brand recall?)
  • One-second silent test (does the visual communicate without sound?)

Recommended Workflow

The three skills address different layers of the conversion stack:

neuro-design            →  Visual identity + creative direction
    ↓                       (how does it LOOK and FEEL?)
fairness-anchor-ladder  →  Pricing strategy + offer architecture
    ↓                       (what do they BUY and at what PRICE?)
ux-ui-psych             →  Conversion flow + choice architecture
                            (HOW do they buy it?)
  1. Design the identity with neuro-design — establish the visual and emotional foundation
  2. Structure the pricing with fairness-anchor-ladder — build the offer architecture with anchor + upgrades
  3. Design the flow with ux-ui-psych — optimize how users navigate from interest to purchase

Each skill produces a JSON blueprint and implementation roadmap. Together they form a complete conversion system from first impression to checkout.


FAQ

Are these just theory documents? No. Each skill produces executable artifacts — JSON blueprints, scoring functions, implementation roadmaps with 30/60/90 day phases, and measurement dashboards. Claude doesn't just explain the psychology — it designs the system.

Do I need a development team to implement these? The playbooks produce specifications that any developer can implement. The JSON blueprints define exactly what to build. The roadmaps define when to build it. You'll need frontend development for the UI and potentially backend for the contextual bandits in ux-ui-psych.

Can I use these for e-commerce? Yes. fairness-anchor-ladder was designed for product-based businesses (restaurants, retail, DTC). ux-ui-psych works for any ordering or checkout flow. neuro-design works for any brand.

Can I use these with the other Branded Mayhem packages? Yes. The Brandprint Engine's brand strategy feeds into neuro-design for visual identity. The SEO Toolkit's data-density-commerce skill pairs with fairness-anchor-ladder for pricing that works in AI-powered shopping.

What behavioral economics research are these based on? Kahneman & Tversky (anchoring, loss aversion), Thaler & Sunstein (nudge theory, choice architecture), Ariely (predictable irrationality, decoy effect), and applied research from restaurant/retail conversion optimization.


What's Included

conversion-architecture/
├── README.md
└── skills/
    ├── ux-ui-psych/SKILL.md            # Choice architecture playbook
    ├── fairness-anchor-ladder/SKILL.md  # Pricing strategy playbook
    └── neuro-design/SKILL.md           # Psychology-driven creative direction

License

MIT. Free and open — use it, fork it, ship client work with it. Outputs you produce with these skills are yours. See LICENSE.

Support

Questions? Email support@brandedmayhem.com

About

3 Claude Code skills for choice architecture, pricing strategy, and neuro-design

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors