novafarma/ASSET_CLEANUP_PROPOSAL.md

# 🗂️ ASSET CLEANUP - DETAILED PROPOSAL

**Date:** 3. Januar 2026 @ 19:54  
**Type:** DRY-RUN ANALYSIS - NO FILES MODIFIED YET!  
**Status:** WAITING FOR YOUR APPROVAL ✋

---

## ⚠️ IMPORTANT: SAFE REVIEW PROCESS

**This document shows EXACTLY what would change.**  
**NOTHING happens until you say "GO"!** ✅

Steps:
1. ✅ I analyze current state (DONE)
2. ✅ I show you detailed plan (THIS DOC)
3. ⏳ YOU review and approve/reject
4. ⏳ If approved, I create backup first
5. ⏳ Then execute changes
6. ⏳ Git commit for safety

---

## 📊 CURRENT STATE ANALYSIS:

### Total Assets:
```
slike 🟢/          623 PNG
animations 🟢/     134 PNG
demo 🔴/            83 PNG
kreature 🟢/        71 PNG
MASTER_REFS 🟣/      6 PNG
vfx 🟣/              3 PNG
maps 🟣/             1 PNG
─────────────────────────
TOTAL:             921 PNG
```

---

## 🎯 PROPOSED CHANGES:

### **CHANGE 1: WHEAT CONSOLIDATION**

**Problem:** Wheat files in 3 different locations!

**Current locations:**
```
📂 slike 🟢/rastline/wheat/
   ├── wheat_stage1_seed_1767410641194.png       [OLD - Style 32]
   ├── wheat_stage2_young_1767410656809.png      [OLD - Style 32]
   ├── wheat_stage3_mature_1767410670651.png     [OLD - Style 32]
   ├── wheat_stage3_mature_fixed_1767411100845.png [OLD]
   └── wheat_crop_s30_1767353136292.png          [OLD attempt]

📂 slike 🟢/rastline/zita/
   ├── wheat_s30_stage1_seed_1767464954800.png   [NEW - Style 30 ✅]
   ├── wheat_s30_stage2_sprout_1767464969122.png [NEW - Style 30 ✅]
   ├── wheat_s30_stage3_growing_1767464984588.png [NEW - Style 30 ✅]
   └── wheat_s30_stage4_harvest_1767465000017.png [NEW - Style 30 ✅]

📂 demo 🔴/items 🔴/
   ├── wheat_s30_stage1_seed_1767464954800.png   [DUPLICATE]
   ├── wheat_s30_stage2_sprout_1767464969122.png [DUPLICATE]
   ├── wheat_s30_stage3_growing_1767464984588.png [DUPLICATE]
   └── wheat_s30_stage4_harvest_1767465000017.png [DUPLICATE]
```

**PROPOSED ACTION:**

**KEEP (rename to clean names):**
```
slike 🟢/rastline/zita/
├── wheat_stage1_seed.png      (from wheat_s30_stage1_seed_1767464954800.png)
├── wheat_stage2_sprout.png    (from wheat_s30_stage2_sprout_1767464969122.png)
├── wheat_stage3_growing.png   (from wheat_s30_stage3_growing_1767464984588.png)
└── wheat_stage4_harvest.png   (from wheat_s30_stage4_harvest_1767465000017.png)
```

**DELETE:**
```
❌ slike 🟢/rastline/wheat/ (entire folder - old Style 32 versions)
   - 5 files to delete

❌ demo 🔴/items 🔴/wheat_* (duplicates of zita/ folder)
   - 4 files to delete
```

**Result:** 9 files deleted, 4 kept with clean names ✅

---

### **CHANGE 2: KAI SPRITES ORGANIZATION**

**Current location:**
```
📂 ~/.gemini/antigravity/brain/.../
├── kai_idle_down_1767465832047.png
├── kai_walk_down_1_1767465848957.png
└── kai_walk_down_2_1767465864000.png
```

**PROPOSED ACTION:**

**MOVE & RENAME TO:**
```
📂 assets/slike 🟢/characters/kai/
├── idle_down.png       (clean name!)
├── walk_down_1.png     (clean name!)
└── walk_down_2.png     (clean name!)
```

**Result:** 3 files moved, clean structure ✅

---

### **CHANGE 3: DEMO ITEMS CLEANUP**

**Current demo items folder:**
```
📂 demo 🔴/items 🔴/
├── item_locket_silver_1767464385940.png
├── tool_hoe_rusty_1767464400663.png
├── tool_bucket_old_1767464414881.png
├── tool_watering_can_1767464429022.png
├── tool_watering_can_1767362826205.png  [DUPLICATE!]
├── wheat_s30_* (4 files)  [covered in Change 1]
└── crops/ (old folder with 5 files)
```

**PROPOSED ACTION:**

**RENAME (remove timestamps):**
```
item_locket_silver_1767464385940.png → locket_silver.png
tool_hoe_rusty_1767464400663.png → hoe_rusty.png
tool_bucket_old_1767464414881.png → bucket_old.png
tool_watering_can_1767464429022.png → watering_can.png
```

**DELETE DUPLICATES:**
```
❌ tool_watering_can_1767362826205.png (older version)
❌ crops/ folder (old wheat versions)
```

**Result:** Clean demo/items/ with no timestamps! ✅

---

### **CHANGE 4: KREATURE FOLDER ANALYSIS**

**Current structure:**
```
📂 kreature 🟢/
├── zombies/     (71 PNG - Batch 2 enemies!)
├── mutants/
├── bosses/
└── hybrids/
```

**STATUS:** 🤔 **NEED YOUR DECISION!**

**Option A:** KEEP separate `kreature/` for enemies
- Clear separation from other assets
- Already organized well

**Option B:** MERGE into `slike 🟢/enemies/`
- Everything in one place  
- More consistent structure

**YOUR CHOICE?** Tell me which you prefer! 

---

### **CHANGE 5: REMOVE TIMESTAMP PATTERN**

**Files affected:** ~733 files with timestamps

**Pattern examples:**
```
BEFORE: kai_idle_down_1767465832047.png
AFTER:  kai_idle_down.png

BEFORE: wheat_s30_stage1_seed_1767464954800.png
AFTER:  wheat_stage1_seed.png

BEFORE: item_locket_silver_1767464385940.png
AFTER:  locket_silver.png
```

**Note:** Some timestamps help identify versions!

**PROPOSED:** Only rename files we're actively using (demo, characters)  
**LEAVE:** Production batch files (can clean later if needed)

**YOUR PREFERENCE?** 
- Remove ALL timestamps? 
- Only active files?
- Leave as is?

---

## 📋 SUMMARY OF PROPOSED CHANGES:

### Files to DELETE (with your approval):
```
Total: ~30-40 files

Breakdown:
- Old wheat (Style 32):        5 files
- Duplicate wheat in demo:     4 files
- Duplicate watering can:      1 file
- Old crop folder:             5 files
- Other identified duplicates: ~15-25 files
```

### Files to RENAME:
```
Total: ~10-15 files

Examples:
- Demo items: 4 files
- Kai sprites: 3 files
- Wheat (keep): 4 files
```

### Files to MOVE:
```
- Kai sprites: 3 files (brain → assets/slike/characters/kai/)
```

### NEW FOLDERS to create:
```
📂 assets/slike 🟢/characters/kai/
```

---

## 🛡️ SAFETY MEASURES:

**BEFORE any changes:**
1. ✅ Git commit current state
2. ✅ Create backup in /tmp/
3. ✅ Generate full file list

**DURING changes:**
4. ✅ Move (don't delete immediately)
5. ✅ Verify moves worked
6. ✅ Test that paths still work

**AFTER changes:**
7. ✅ Git commit with detailed message
8. ✅ Keep backup for 24h
9. ✅ Update file paths in code if needed

---

## ⏱️ TIME ESTIMATE:

**My work:**
- Create backup: 2 min
- Execute approved changes: 10 min
- Verify & commit: 3 min
**Total: ~15 min**

**Your work:**
- Review this proposal: 10 min
- Decide on each change: 5 min
- Approve/adjust: 2 min
**Total: ~17 min**

---

## 🎯 YOUR DECISION NEEDED:

**For each change, tell me:**

**Change 1 (Wheat consolidation):**
- [ ] YES - Delete old wheat, keep Style 30 in zita/
- [ ] NO - Keep everything
- [ ] MODIFY - (tell me what to change)

**Change 2 (Kai sprites):**
- [ ] YES - Move to assets/slike/characters/kai/
- [ ] NO - Leave in brain folder
- [ ] MODIFY - Different location?

**Change 3 (Demo items cleanup):**
- [ ] YES - Remove timestamps, delete duplicates
- [ ] NO - Keep as is
- [ ] MODIFY - (specify)

**Change 4 (Kreature folder):**
- [ ] KEEP separate kreature/ folder
- [ ] MERGE into slike/enemies/
- [ ] OTHER - (tell me)

**Change 5 (Timestamps):**
- [ ] Remove from active files only
- [ ] Remove from ALL files
- [ ] Leave all timestamps
- [ ] OTHER - (specify)

---

## 📸 WANT SCREENSHOTS?

I can also:
- Generate tree view of current structure
- Show before/after folder comparisons
- List every single file that would change

**Want me to create those too?** 🤔

---

**ČAKAM NA TVOJ GO-AHEAD! ✋**

**Povej mi kateri changes hočeš, pa začnem! 😊**