Files
novafarma/ASSET_CLEANUP_PLAN.md
David Kotnik bb805c24b6 📚 Session Documentation & Asset Analysis
Created comprehensive session documentation:
- Complete today's review
- Asset cleanup proposal with dry-run analysis
- Testing guides
- What's missing breakdown

Discoveries:
- Full Kai walk cycle already exists in animations/
- 18 wheat file duplicates found
- 733 files with timestamp patterns
- Ready for cleanup + organization

Status: User break, resume after asset cleanup
Next: Code path fixes + quota reset (21:43)
2026-01-03 20:00:07 +01:00

262 lines
5.3 KiB
Markdown

# 🗂️ 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:**
```bash
# 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! ✅