File System Organizer

Instructions

Objective

Reorganize the user's file system from a messy or unspecified state into a clean, logical directory structure as specified by the user.

Core Workflow

1. Analyze the Current State

• Action: Use filesystem-list_directory to explore the target workspace.
• Goal: Understand the existing folder layout and identify all files that need to be categorized. Start from the root path the user indicates (e.g., /​workspace). Recursively list subdirectories to build a complete mental map.

2. Parse the Target Structure

• Action: Interpret the user's request, which may include a text-based tree diagram or a verbal description.
• Goal: Build a clear, hierarchical model of the desired final directory structure (e.g., School/​Courses_Materials, Work/​Projects).

3. Create the Directory Hierarchy

• Action: Use filesystem-create_directory to build the new structure.
• Critical Logic: Create directories sequentially from the root down. Do not attempt to create a nested subdirectory (A/​B/​C) before its parent (A/​B) exists. The trajectory shows that attempting this in parallel causes "Parent directory does not exist" errors.
• Best Practice: Create all top-level directories first, then their immediate children, proceeding layer by layer.

4. Categorize and Move Files

• Action: Use filesystem-move_file to relocate files from their original locations to their new, categorized homes.
• Intelligence Required: Determine the correct destination for each file by analyzing:
  • File Name: Keywords like Course, Graduation, Exam, Project, Application, CV, Movie, Music, Picture.
  • File Extension: .mp3, .mp4, .mkv → Entertainment; .pdf, .doc, .ppt, .xlsx → likely School or Work.
  • Current Location: A file inside an existing Entertainment folder is likely media.
  • Content Inference: cat.png is a picture, likely of a pet.
• Procedure: Move files in batches. Verify each move operation is successful before proceeding.

5. Cleanup and Verification

• Action:
  1. Use filesystem-directory_tree to generate a visual map of the newly organized workspace.
  2. Present this tree to the user for confirmation.
  3. If original source directories are now empty, remove them using terminal-run_command (e.g., rm -rf /​path/​to/​empty_folder).
• Goal: Leave the workspace tidy and provide clear evidence of the completed task.

Key Principles

• Defensive Creation: Always check for or assume parent directories need to be created first.
• Informed Moving: Use multiple signals (name, extension, path) to make accurate categorization decisions.
• Verification: Always show the end result. Do not assume success without checking.