# 🎯 DEFINITIVNI STANDARD ZA SLIKE - Style 32

**Datum:** 2026-01-05
**Status:** APPROVED by user - ta kvaliteta je točno prava!

---

## ✅ USPEŠNI PRIMERI (Uporabi kot referenco)

### **GOLD STANDARD NPCs (Generated 2026-01-05):**
- `/references/npcs/arborist/master_reference.png` ✅
- `/references/npcs/kustos/master_reference.png` ✅
- `/references/npcs/mayor/master_reference.png` ✅
- `/references/npcs/miro_pravnik/master_reference.png` ✅
- `/references/npcs/pek/master_reference.png` ✅
- `/references/npcs/sivilja/master_reference.png` ✅
- `/references/npcs/teacher/master_reference.png` ✅
- `/references/npcs/tehnik/master_reference.png` ✅

### **Original Ana Reference:**
- `/references/main_characters/ana/master_reference_nobg.png` ✅

### **Test Quality Reference:**
- `/references/BIOME_CROP_TEST_SHEET.png` ✅

---

## 📐 EXACT SPECIFICATIONS (Ta kvaliteta!)

### **1. OUTLINES (Črne obrobe):**
```
Debelina: 5px (thick, consistent)
Barva: #000000 (pure black)
Stil: Smooth anti-aliased (NO stair-stepping)
Koti: Rounded (not blocky)
```

### **2. SHADING (Senčenje):**
```
Tip: Flat cel shading (cartoon style)
Prehodi: Sharp boundaries (ne mehko)
Barve: Solid fills (no gradients except shadows)
Tekstura: Clean (no grain, no dithering)
```

### **3. PROPORTIONS (Razmerja):**
```
Stil: Chibi 1:1 (glava = telo)
Velikost: 256x256px (high resolution)
Oči: Large, expressive
Telo: Compact, cute
```

### **4. COLORS (Barve):**
```
Lasje: Vibrant (neon pink, green, blue, purple, orange)
Koža: Wheat #F5DEB3, Tan #D2B48C
Oblačila: Punk colors (dark + bright accents)
Fon: Transparent (100% prosojno)
```

### **5. STYLE QUALITY:**
```
Linij: SMOOTH vector-style (NOT pixel art)
Robovi: Anti-aliased curves (gladki)
Ločljivost: High-res (256px minimum)
Finish: Film-quality polish (profesionalno)
Aesthetic: Cult of the Lamb inspired
```

---

## 🎨 PROMPT TEMPLATE (Vsak nov NPC)

**Uporabi TOČNO TO strukturo:**

```
[Character Name] [profession] portrait. 

EXACT smooth quality matching approved NPCs (Kustos, Mayor, Pek style):
- THICK black outlines (5px) #000000
- Clean cel shading (flat, sharp boundaries)
- Chibi 1:1 proportions (head = body)
- Smooth anti-aliased curves (NO pixel art, NO stair-stepping)

Character details:
- [Hair color] colored hair [or dreadlocks]
- [Specific outfit/tools for profession]
- [Distinguishing features]
- 2-3 piercings (nose, ear, face)
- [Expression type] expression
- Post-apocalyptic punk aesthetic

Technical specs:
- 256x256px high-resolution rendering
- Transparent background
- Vibrant colors (not muted)
- Professional film-quality polish
- Cult of the Lamb aesthetic
```

---

## 📋 QUALITY CHECKLIST (Pred odobritvijo)

**VSE mora biti ✅:**

### **Visual Quality:**
- [ ] Smooth lines (NO jagged edges)
- [ ] Thick 5px black outlines (consistent)
- [ ] Clean cel shading (NO soft gradients)
- [ ] Vibrant colors (NOT muted/realistic)
- [ ] High resolution (256px+)
- [ ] Transparent background (NO green screen)

### **Style Match:**
- [ ] Matches approved NPCs (Kustos, Mayor, etc.)
- [ ] Chibi proportions (cute, 1:1)
- [ ] Punk aesthetic (piercings, colored hair)
- [ ] Professional polish (film-quality)
- [ ] Cult of the Lamb vibe

### **Character Details:**
- [ ] Colored hair OR dreadlocks (NO natural brown/black)
- [ ] 2-3 piercings visible
- [ ] Profession-appropriate outfit/tools
- [ ] Post-apocalyptic wear (torn, patched)
- [ ] Expressive face

### **Technical:**
- [ ] File size reasonable (< 2MB)
- [ ] PNG format with alpha channel
- [ ] 256x256px dimensions
- [ ] No compression artifacts
- [ ] Clean transparent edges

---

## 🚫 FORBIDDEN (NIKOLI ne uporabljaj)

**Style Errors:**
- ❌ Pixel art (chunky blocks, stair-stepping)
- ❌ Low resolution (< 128px)
- ❌ Soft gradients (only flat cel shading)
- ❌ Thin outlines (< 3px)
- ❌ Realistic shading (photographic)
- ❌ Green/colored backgrounds (must be transparent)

**Character Errors:**
- ❌ Natural hair colors (brown, black without dreads)
- ❌ Clean corporate look (must be punk)
- ❌ No piercings
- ❌ Muted colors
- ❌ Realistic proportions (not chibi)

**Technical Errors:**
- ❌ Compression artifacts (save as PNG)
- ❌ Non-transparent background
- ❌ Inconsistent outline thickness
- ❌ Blurry edges

---

## ✅ GENERATION WORKFLOW

### **Step 1: Check References**
```bash
# View approved examples first
open references/npcs/kustos/master_reference.png
open references/npcs/mayor/master_reference.png
open references/npcs/pek/master_reference.png
```

### **Step 2: Use Exact Prompt Template**
- Copy template from above
- Fill in character-specific details
- Include ALL technical specifications
- Emphasize "matching approved NPCs"

### **Step 3: Generate**
- Use 256x256px minimum
- Request transparent background explicitly
- Specify smooth anti-aliased lines
- Reference approved examples in prompt

### **Step 4: Verify Quality**
```
Compare side-by-side with approved NPCs:
- Line smoothness matches? ✅
- Outline thickness matches? ✅
- Color vibrancy matches? ✅
- Chibi proportions match? ✅
- Overall polish matches? ✅
```

### **Step 5: Save & Commit**
```bash
cp [generated_file].png references/npcs/[npc_name]/master_reference.png
python3 scripts/generate_asset_manifest.py
git add -A
git commit -m "Added [NPC name] portrait - SMOOTH Style 32 matching approved quality"
```

---

## 🎯 SUCCESS CRITERIA

**Slika je uspešna, če:**

1. **Uporabnik pove:** "To so pa že top slike!" ✅
2. **Matches test image** (uploaded chibi reference)
3. **Matches Ana's smoothness** (gold standard)
4. **Matches approved 8 NPCs** (Kustos, Mayor, etc.)
5. **NO pixelation** when zoomed 200-400%
6. **Professional quality** (like commercial indie game)

**Če katerikoli od teh ni izpolnjen → reroll malo!**

---

## 📊 BATCH GENERATION

**Za množično generiranje (npr. 20 NPCjev):**

1. **Prepare list** with character names + professions
2. **Use SAME prompt template** for all
3. **Generate in batches** of 4-5
4. **Verify each batch** before continuing
5. **Replace files** systematically
6. **Update manifest** after all done
7. **Single commit** with all changes

**Example batch commit:**
```
"Regenerated 20 NPCs in SMOOTH Style 32: 
[list names]. Matching approved quality standard.
Thick outlines, cel shading, chibi proportions."
```

---

## 🔄 IF QUALITY DROPS

**Simptomi:**
- Pixelation appears
- Outlines become thin
- Colors become muted
- Proportions change

**Fix:**
1. **Stop immediately**
2. **Re-read this document**
3. **View approved references again**
4. **Adjust prompt** to be more explicit
5. **Add "matching [approved NPC name]"** to prompt
6. **Regenerate** with corrected prompt
7. **Verify** before replacing files

---

## 📚 REFERENCE HIERARCHY

**Vedno preveri v tem vrstnem redu:**

1. **Approved 8 NPCs** (2026-01-05) - DEFINITIVE STANDARD
2. **Ana reference** (original gold standard)
3. **Test sheet** (quality benchmark)
4. **COLOR_MASTER.md** (exact hex codes)
5. **This document** (specifications)

**Nikoli ne improvizirati - vedno se sklicuj na reference!**

---

## 🎯 FINAL REMINDER

**Ta kvaliteta (Kustos, Mayor, Pek, etc.) je TOČNO PRAVA.**

**Ne spreminjaj:**
- Outline thickness
- Shading style
- Color vibrancy
- Smoothness level
- Chibi proportions

**Samo repliciraj to kvaliteto za vse nove NPCje!**

---

**APPROVED STANDARD - Use this for ALL future NPC generation!**

**Datum odobritve:** 2026-01-05 18:28  
**Status:** LOCKED ✅