commands/sysadmin/organize-files.md

Organize and restructure files in the current directory or repository.

Your task:

1. Analyze current structure:

   • Identify file types and purposes
   • Note organization issues
   • Find misplaced files
   • Detect duplicates or unused files

2. Create logical folder structure:

   • Group related files together
   • Separate by function (src, docs, tests, config, etc.)
   • Create clear hierarchy
   • Follow project conventions

3. Example structures:

   For code projects:

   project/
   ├── src/          # Source code
   ├── tests/        # Test files
   ├── docs/         # Documentation
   ├── config/       # Configuration files
   ├── scripts/      # Utility scripts
   └── assets/       # Static assets
   

   For documents:

   project/
   ├── drafts/
   ├── final/
   ├── archive/
   ├── templates/
   └── resources/
   

4. Move files to appropriate locations:

   • Preserve git history if in repository
   • Update import/require paths in code
   • Fix broken references
   • Update documentation

5. Clean up:

   • Remove redundant files
   • Archive old versions
   • Delete temporary files
   • Update .gitignore if needed

Implement clear separation of concerns and logical file organization.