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

93 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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