math-tasks/assets/themes/sonic/CLAUDE.md

Sonic Universe Theme

Sonic the Hedgehog universe theme. Cinematic, photorealistic visual style — movie-poster quality renders with dramatic lighting, detailed textures, and dynamic compositions.

Visual Style

• Cinematic photorealistic — like Sonic movie posters / Unreal Engine 5 renders
• Dramatic lighting, volumetric effects, detailed fur/quill textures
• Characters should feel alive and dimensional, not flat or cartoon-like
• White or transparent backgrounds for standalone assets
• Concept sketches stored in sketches/ subfolders during exploration phase

Character Roster

Heroes

Character	File	Description	Status
Sonic	sonic.png	Blue hedgehog, super speed, iconic quills	Sketch
Shadow	shadow.png	Black/red hedgehog, chaos energy, rival	Sketch
Tails	tails.png	Two-tailed fox, flight, tech genius	Sketch
Knuckles	knuckles.png	Red echidna, super strength, guardian	Sketch
Amy Rose	amy.png	Pink hedgehog, Piko Piko Hammer	Sketch
Silver	silver.png	Silver-white hedgehog, psychokinesis, futuristic	Sketch
Cream	cream.png	Cream rabbit with Chao companion Cheese	Sketch

Villains / Anti-heroes

Character	File	Description	Status
Dr. Eggman	eggman.png	Main villain, genius inventor, red military jacket	Sketch
Metal Sonic	metal-sonic.png	Robot hedgehog, blue chrome, red eyes	Sketch
Rouge	rouge.png	White bat spy, jewel hunter, bat wings	Sketch
Chaos	chaos.png	Translucent water creature, green glowing brain	Sketch
Zavok	zavok.png	Red demon, leader of Deadly Six, muscular	Sketch
Infinite	infinite.png	Black jackal, silver mask, phantom ruby	Sketch
Egg Robo	egg-robo.png	Egg-shaped robot soldier, red/silver metal	Sketch

Items

Item	Description	Status
Chaos Emeralds	7 colored crystals of immense power	Planned
Gold Rings	Collectible rings, life energy	Planned
More TBD	—	—

Asset Inventory

Category	Path	Count	Description
Protagonist sketches	sketches/protagonists/{name}/	7×5	Base sketch, character sheet, lvl1-3 per hero
Antagonist sketches	sketches/antagonists/{name}/	7×5	Base sketch, character sheet, lvl1-3 per villain

Per-character file structure

Each character folder contains:

• {name}.png — base presentation sketch (standing pose, white bg)
• {name}-sheet.png — character sheet (views + expressions, 16:9)
• {name}-lvl1.png — Level 1: child (age 5-6), cute accessories, shy smile
• {name}-lvl2.png — Level 2: teen (age 12-14), gadgets, stylish, show-off
• {name}-lvl3.png — Level 3: young adult (18-20), cyberpunk gear, serious hero/villain

Exceptions:

• Eggman: lvl1 = early Robotnik (government suit), lvl2 = unhinged mad scientist, lvl3 = Gerald Robotnik (elderly grandfather)
• Metal Sonic: lvl1 = crude prototype, lvl2 = upgraded combat model, lvl3 = ultimate war machine
• Egg Robo: lvl1 = basic tin robot, lvl2 = combat model, lvl3 = elite destroyer mech

Total: 70 files (14 characters × 5 files each)

Usage in Templates

All paths relative to project root:

• HTML templates: /assets/themes/sonic/{category}/{file}
• Generator scripts (from docs/): ../../assets/themes/sonic/{category}/{file}
• Generator scripts (from project root): assets/themes/sonic/{category}/{file}

Color Palette

TBD — will be defined after initial sketches are reviewed and art direction is confirmed.

Reference Policy

• heroes/ — use existing hero images as --ref for consistency within character
• items/ — use existing items as --ref within same item type
• Cross-character refs: use any hero sketch to maintain style consistency

Adding New Assets

1. Generate via /gen-image with cinematic photorealistic style keywords
2. Save sketches/concepts to {category}/sketches/
3. Final production assets go directly to {category}/
4. Use --ref from same category for visual consistency