diff --git a/.agent/workflows/reference_first_rule.md b/.agent/workflows/reference_first_rule.md new file mode 100644 index 000000000..3461f157a --- /dev/null +++ b/.agent/workflows/reference_first_rule.md @@ -0,0 +1,103 @@ +--- +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)**