Files
novafarma/.agent/workflows/reference_first_rule.md

104 lines
3.1 KiB
Markdown

---
description: MANDATORY - Always check references before generating any assets
---
# 🎨 REFERENCE-FIRST GENERATION RULE
## **ZAKON: Če obstaja referenca, jo MORAŠ pogledati PRED generacijo!**
### **Workflow za VSAKO generacijo asseta:**
```
1. ✅ Preveri: Ali obstaja master_reference.* v /references/?
2. ✅ ČE DA → OBVEZNO view_file() na referenco PRED generate_image()
3. ✅ Uporabi vse vizualne detajle iz reference slike:
- Barve (točne RGB vrednosti)
- Oblačila (textures, accessories)
- Frizura (style, barve, dodatki)
- Piercings, tattoos, scars
- Proporce (chibi 1:1 ali realistične)
- Outline thickness
4. ✅ Generate prompt MORA ustrezati referenci 100%
5. ❌ ČE NE → Šele potem generiraj prosto (brez reference)
```
---
## **Reference Folder Structure:**
```
/references/
├── main_characters/
│ ├── kai/master_reference.png ← OBVEZNO GLEJ
│ ├── ana/master_reference.png ← OBVEZNO GLEJ
│ └── gronk/master_reference.png ← OBVEZNO GLEJ
├── npcs/
│ ├── ivan_kovac/master_reference.jpg ← OBVEZNO GLEJ
│ ├── tehnik/master_reference.png ← OBVEZNO GLEJ
│ ├── sivilja/master_reference.png ← OBVEZNO GLEJ
│ ├── pek/master_reference.png ← OBVEZNO GLEJ
│ ├── kustos/master_reference.png ← OBVEZNO GLEJ
│ ├── mayor/master_reference.png ← OBVEZNO GLEJ
│ ├── arborist/master_reference.png ← OBVEZNO GLEJ
│ ├── miro_pravnik/master_reference.png ← OBVEZNO GLEJ
│ └── teacher/master_reference.png ← OBVEZNO Glej
├── companions/
│ ├── susi/master_reference.png ← OBVEZNO GLEJ
│ └── zombie_scout/master_reference.png ← OBVEZNO GLEJ
├── enemies/
│ ├── zombies/ ← OBVEZNO GLEJ (3 variante)
│ └── nomad_raiders/ ← OBVEZNO GLEJ (4 types)
└── species/
├── trolls/master_reference.png ← OBVEZNO GLEJ
├── fairies/master_reference.png ← OBVEZNO GLEJ
└── elves/master_reference.png ← OBVEZNO GLEJ
```
---
## **TOTAL: 24 Master References**
**Vsaka od teh 24 slik MORA biti pogledana z `view_file()` PREDEN generiram katerokoli variacijo (8-direction sprites, portraits, animations)!**
---
## **Primer Correct Workflow:**
```
USER: Generiraj Kai 8-direction sprites
AGENT:
1. ✅ view_file(/references/main_characters/kai/master_reference.png)
2. ✅ Študiram: pink+green dreads, nose ring, gauges, leather jacket
3. ✅ generate_image() z TOČNIMI detalji iz reference
```
---
## **Primer WRONG Workflow:**
```
USER: Generiraj Kai 8-direction sprites
AGENT:
❌ generate_image() takoj brez pregleda reference
❌ NAPAKA: Izgubljeni detalji, nekonzistenten stil!
```
---
## **Zakaj je to KRITIČNO:**
- **Vizualna konsistenca** = 100% ujemanje med vsemi asseti
- **Style 32 Dark-Chibi Noir** = moraš videti reference za outline thickness, proporce
- **Unique details** = piercings, tattoos, color combos so SPECIFIČNI za vsakega lika
- **Asset pipeline** = references so "source of truth" za VSE bodoče assete
---
**PRAVILO: NO REFERENCE = NO GENERATION (razen če reference dejansko NE obstaja)**