File Organization

Consolidate files of one kind that are scattered across a tree into a single destination directory, with deduplication and a provenance manifest. Works for resumes, receipts, contracts, or any repeated document type.

When to Use

• User asks to gather/organize scattered files of one type into one folder.
• Cleaning up duplicates across drafts, exports, or old project folders.
• Preparing a single canonical location before sharing or archiving.

Don't use for: project lifecycle work under ponti-studios/ (use project-operations), disk-space recovery, or app uninstall residue.

Procedure

1. Define scope and destination. Confirm source root and target directory. Check whether the target already exists and what it contains; never overwrite existing files without a plan.

2. Find candidates by name. Use search_files (target files) for filename patterns (*resume*, *cv*, etc.). Record full paths.

3. Find candidates by content when names are unreliable. For document types like PDFs, extract text with pdftotext and match strong keywords (e.g. professional summary, work experience, core skills). Require at least one strong keyword plus several supporting hits to avoid false positives such as vaccine cards, flight itineraries, or essays that merely mention "education".