novafarma/.agent/workflows/reference_first_rule.md

description

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)