novafarma/docs/ASSET_CLEANUP_PLAN.md

🗂️ ASSET CLEANUP & REORGANIZATION PLAN

Date: 3. Januar 2026 @ 19:51
Purpose: Organize assets, remove duplicates, clean structure

---

📊 CURRENT SITUATION:

Total PNG: 921 files
Problem: Scattered across multiple folders with duplicates!

Breakdown:

slike 🟢/          623 PNG  (main production folder)
animations 🟢/     134 PNG  
demo 🔴/            83 PNG  (some duplicates!)
kreature 🟢/        71 PNG  (enemies - some in slike too?)
MASTER_REFS 🟣/      6 PNG  
vfx 🟣/              3 PNG  
maps 🟣/             1 PNG  

🚨 PROBLEMS FOUND:

1. Wheat duplicates - 3 different locations!

   • slike/rastline/wheat/ (old Style 32)
   • slike/rastline/zita/ (new Style 30)
   • demo/items/ (same as zita)

2. 733 files with long numbers like _1767464954800.png

   • Makes files hard to identify
   • Should have clean names

3. Kreature vs Slike confusion

   • Enemies scattered in both folders
   • Need single source of truth

4. Demo duplicates

   • Some files in both demo/ and slike/

---

🎯 CLEANUP PLAN:

PHASE 1: CONSOLIDATE DEMO ASSETS

Goal: All demo assets in ONE place, clean names

Actions:

1. Keep ONLY demo 🔴/ folder
2. Remove duplicates from slike 🟢/
3. Rename files to clean names (no timestamps)

Example:

❌ wheat_s30_stage1_seed_1767464954800.png
✅ wheat_stage1_seed.png

---

PHASE 2: ORGANIZE MAIN PRODUCTION

New structure for slike 🟢/:

slike 🟢/
├── characters/     (Kai, Ana, NPCs - Style 32)
├── enemies/        (ALL zombies, mutants - Style 32)
├── items/          (tools, weapons - Style 32)
├── rastline/       (ALL plants - Style 30)
├── buildings/      (structures - Style 32)
├── ui/             (UI elements)
└── vfx/            (effects)

---

PHASE 3: REMOVE DUPLICATES

Strategy:

1. Find duplicates (same content, different timestamp)
2. Keep BEST version (latest/correct style)
3. Delete older versions

Wheat cleanup example:

KEEP:  slike/rastline/zita/wheat_stage1.png  (Style 30 ✅)
DELETE: slike/rastline/wheat/wheat_stage1*.png  (Style 32 ❌)
DELETE: demo/items/wheat_s30_stage1*.png  (duplicate)

---

PHASE 4: CLEAN ENEMY ORGANIZATION

Move all to slike 🟢/enemies/:

enemies/
├── zombies/
│   ├── basic/
│   ├── variants/
│   └── special/
├── mutants/
│   ├── animals/
│   └── creatures/
├── bosses/
└── hybrids/

Then DELETE kreature 🟢/ (outdated folder)

---

PHASE 5: RENAME TIMESTAMPED FILES

Pattern:

OLD: item_locket_silver_1767464385940.png
NEW: item_locket_silver.png

OLD: kai_idle_down_1767465832047.png
NEW: kai_idle_down.png

Script to generate clean names:

# For each file
# Remove timestamp numbers
# Keep descriptive name

---

🤖 AUTOMATED CLEANUP SCRIPT:

I can create script that:

1. ✅ Identifies duplicates
2. ✅ Suggests which to keep/delete
3. ✅ Renames timestamped files
4. ✅ Moves files to correct folders
5. ✅ Creates clean manifest

You review and approve before deletion!

---

📋 MANUAL CLEANUP TASKS (For you):

What YOU should do:

1. Review generated images - Delete bad quality ones
2. Choose best versions - If multiple versions exist
3. Approve deletions - Before I remove anything

What I do:

1. Scan & identify issues
2. Suggest reorganization
3. Create rename/move scripts
4. Generate clean manifest
5. Execute approved changes

---

📊 EXPECTED RESULTS:

Before:

921 PNG scattered
733 with timestamps
Duplicates unknown
Hard to find things

After:

~700-800 PNG organized
Clean descriptive names
No duplicates
Clear folder structure
Easy to find anything!

---

⏰ TIME ESTIMATE:

Automated scan: 5 min
Generate cleanup script: 10 min
Your review: 15-30 min
Execute cleanup: 5 min
Verify & commit: 5 min

TOTAL: ~40-60 minutes

---

🚀 RECOMMENDED ORDER:

NOW (while waiting for quota):

1. I create cleanup script (10 min)
2. Script shows what to delete (you review)
3. You approve (or adjust)
4. Execute cleanup (5 min)
5. Clean commit ✅

Benefits:

• Organized assets ✅
• Easy to find files ✅
• No duplicates ✅
• Professional structure ✅
• Ready for production ✅

---

💡 SHOULD WE DO THIS?

PROS:

• ✅ Clean organization
• ✅ Easy to maintain
• ✅ No wasted space
• ✅ Professional project
• ✅ Perfect task while waiting for API quota!

CONS:

• ⚠️ Takes 1 hour
• ⚠️ Need to review carefully
• ⚠️ One-time effort

MY RECOMMENDATION: YES! ✅ Perfect timing!

• Quota resets in 2h anyway
• Cleanup makes future work easier
• Good use of waiting time
• Professional organization matters!

---

🎯 NEXT STEP:

Want me to:

Option A: Create automated cleanup script NOW

• Scans all assets
• Identifies duplicates
• Suggests renames
• YOU review before any deletion

Option B: Manual approach

• I give you list of what to check
• You organize manually
• Less automated, more control

Option C: Skip for now

• Keep current messy structure
• Deal with it later

KAJ HOČEŠ? 🤔

Priporočam Option A - automated script with YOUR approval! ✅