8.6 KiB
8.6 KiB
Example: Media Library Organization Automation
This example shows what the meta-automation-architect generates for a personal media and document library.
Project Context
- Type: File Organization (primary)
- Content: 5,000+ files (photos, videos, documents, music)
- Size: 250GB across multiple folders
- Pain Points: Inconsistent naming, duplicates, missing metadata, hard to find files
- Priority: Auto-tagging and duplicate detection
Project Structure (Before)
media-library/
├── Photos/
│ ├── IMG_0001.jpg
│ ├── IMG_0002.jpg
│ ├── vacation.jpg
│ ├── DSC001.jpg (duplicate of IMG_0001.jpg with different name)
│ └── ... (2,000+ images)
├── Videos/
│ ├── VID_001.mp4
│ ├── movie_001.mp4
│ └── ... (500+ videos)
├── Documents/
│ ├── document.pdf
│ ├── report_final_final.docx (duplicate)
│ └── ... (1,500+ docs)
├── Music/
│ └── ... (1,000+ songs)
└── Misc/
└── ... (random files)
User Conversation
User: "Help me organize my media library"
Meta-Skill: Analyzing project...
- Detected: File Organization (95% confidence)
- Found 5,247 files across 89 directories
- Mixed naming conventions detected
- Estimated 380 duplicate files (7% of total)
- Only 15% of files have metadata tags
- Date-based folder structure partially used
Meta-Skill: What are your main pain points?
Options:
- Finding duplicate files (RECOMMENDED: ~1.2GB wasted, 7% duplication rate)
- Inconsistent file naming
- Missing metadata/tags (RECOMMENDED: 85% files lack tags)
- Hard to find specific files
User: [Selects: Duplicate files, Missing metadata]
Meta-Skill: Automation opportunities identified:
- Auto-tag files based on content: Saves 2 min/file × 4,460 files = 148 hours
- Find and merge duplicates: Saves 10 min/duplicate × 380 = 63 hours
- Total potential savings: 211 hours + 1.2GB storage
Meta-Skill: Generating automation system...
Session ID: media-org-def456
Generated Automation System
1. Custom Subagents (5)
- structure-analyzer - Reviews folder organization and hierarchy
- metadata-analyzer - Checks tagging coverage and consistency
- duplication-analyzer - Finds duplicate and similar files
- asset-analyzer - Inventories all media types
- command-generator - Creates organization commands
2. Custom Skills (3)
auto-tagger - Automatically tags files based on content
- Images: Extracts EXIF data (date, location, camera)
- Videos: Analyzes metadata, duration, resolution
- Documents: Extracts title, author, creation date
- Music: Reads ID3 tags, adds genre/artist
Example:
Before: IMG_0523.jpg (no metadata)
After: IMG_0523.jpg
Tags: [vacation, beach, 2024-07-15, hawaii, sunset]
Location: Waikiki Beach, HI
Camera: iPhone 14 Pro
duplicate-merger - Identifies and consolidates duplicates
- Exact duplicates (same hash)
- Similar images (perceptual hash)
- Same content, different formats
- Version variations
Example:
Found 3 duplicates of vacation_beach.jpg:
- Photos/IMG_0523.jpg (original, highest quality)
- Photos/vacation.jpg (duplicate)
- Backup/beach.jpg (duplicate)
Action: Keep IMG_0523.jpg, create symbolic links for others
Savings: 8.2 MB
index-generator - Creates searchable catalog
- Generates
library-index.mdwith all files - Categorizes by type, date, tags
- Creates search-friendly format
- Updates automatically
3. Custom Commands (3)
/organize
/organize # Organize entire library
/organize Photos/ # Organize specific folder
/organize --dry-run # Preview changes
Actions:
- Renames files with consistent convention
- Moves to appropriate category folders
- Adds metadata tags
- Detects and merges duplicates
- Generates index
/find-duplicates
/find-duplicates # Find all duplicates
/find-duplicates Photos/ # In specific folder
/find-duplicates --auto-merge # Auto-merge safe duplicates
/generate-index
/generate-index # Full library index
/generate-index --by-date # Chronological index
/generate-index --by-tag # By tag category
4. Hooks (2)
auto_tag_new_files.py (PostToolUse)
- Triggers when files are added
- Automatically extracts and adds metadata
- Tags based on content analysis
duplicate_alert.py (PostToolUse)
- Triggers when files are added
- Checks for duplicates
- Alerts if duplicate detected
5. Impact
Time Savings:
- Manual tagging: 2 min/file × 4,460 files = 148 hours → Automated
- Finding duplicates: Manual search would take 20+ hours → 5 minutes automated
- Creating index: 5 hours manual → 2 minutes automated
- Total: 173+ hours saved
Storage Savings:
- Duplicates removed: 1.2GB recovered
- Optimized organization: Better disk cache performance
Quality Improvements:
- Metadata coverage: 15% → 100% (+85%)
- Findability: Manual search → Instant via indexed catalog
- Consistency: Mixed naming → 100% standardized
Example Results
Before /organize
Photos/
├── IMG_0001.jpg (no tags)
├── vacation.jpg (no tags, actually duplicate of IMG_0001)
├── DSC001.JPG (no tags)
└── ... (mixed names, no metadata)
After /organize
library/
├── photos/
│ ├── 2024/
│ │ ├── 07-july/
│ │ │ ├── 2024-07-15_hawaii-beach_sunset.jpg
│ │ │ │ Tags: [vacation, beach, hawaii, sunset]
│ │ │ │ Location: Waikiki, HI
│ │ │ └── ...
│ │ └── 08-august/
│ └── 2023/
├── videos/
│ ├── 2024/
│ │ └── 2024-07-15_beach-waves_1080p.mp4
│ │ Tags: [vacation, ocean, hawaii]
├── documents/
│ ├── personal/
│ └── work/
├── music/
│ ├── by-artist/
│ └── by-genre/
├── library-index.md (searchable catalog)
└── .metadata/ (tag database)
Generated Index (excerpt)
# Media Library Index
Last Updated: 2025-01-23
Total Files: 5,247
Total Size: 248.8 GB
## Recent Additions (Last 7 Days)
- 2024-07-20_family-dinner.jpg [Tags: family, home, dinner]
- 2024-07-19_work-presentation.pptx [Tags: work, slides]
## By Category
### Photos (2,000 files, 45.2 GB)
#### 2024 (523 files)
- **July** (156 files)
- Hawaii Vacation (45 files) - Tags: vacation, beach, hawaii
- Home Events (28 files) - Tags: family, home
- **August** (89 files)
### Videos (500 files, 180.5 GB)
...
### Documents (1,500 files, 18.1 GB)
...
## By Tag
- **vacation** (245 files)
- **family** (432 files)
- **work** (567 files)
...
## Search Tips
- By date: Find "2024-07"
- By location: Find "hawaii" or "beach"
- By type: Find ".jpg" or ".mp4"
Agent Communication
reports/duplication-analyzer.json (excerpt):
{
"agent_name": "duplication-analyzer",
"summary": "Found 380 duplicate files (7.2% duplication rate) wasting 1.18GB storage",
"findings": [
{
"type": "duplicate_group",
"severity": "medium",
"title": "Vacation Photos Duplicated",
"description": "45 vacation photos have 2-3 copies each with different names",
"storage_wasted": "285 MB",
"recommendation": "Keep highest quality version, create symlinks for others"
}
],
"metrics": {
"total_files_scanned": 5247,
"duplicate_groups": 127,
"total_duplicates": 380,
"storage_wasted_mb": 1210,
"deduplication_potential": "23% size reduction after compression"
},
"automation_impact": {
"time_saved": "63 hours (manual duplicate finding)",
"storage_recovered": "1.2 GB"
}
}
Result
User now has:
- ✅ Fully organized library with consistent structure
- ✅ 100% metadata coverage (up from 15%)
- ✅ Zero duplicates (removed 380, recovered 1.2GB)
- ✅ Searchable index for instant finding
- ✅ Auto-tagging for all new files
- ✅ 173+ hours saved in organization work
Before vs After:
| Metric | Before | After | Improvement |
|---|---|---|---|
| Files with metadata | 15% (788) | 100% (5,247) | +85% |
| Duplicate files | 380 (7.2%) | 0 (0%) | -100% |
| Wasted storage | 1.2 GB | 0 GB | 1.2GB recovered |
| Time to find file | 5-10 min | <10 sec | 30-60x faster |
| Manual org time | 173+ hours | 2 hours setup | 98% reduction |
Ongoing Benefits:
- New files auto-tagged immediately
- Duplicates detected before saving
- Index updates automatically
- Consistent organization maintained