I made Claude Code build a map of my files, and it cut search times by 96%

I have always struggled with organizing my digital life and wardrobe. Despite occasional bursts of motivation, I rarely manage to complete the task of sorting through files and folders, resulting in a chaotic computer system. My computer is a prime example, containing university assignments, work documents, screenshots, and random files accumulated over the years. Searching for specific files can feel like finding a needle in a haystack, even with Finder's search function.

To address this issue, I decided to enlist the help of Claude Code, an AI assistant. Instead of waiting for another late-night burst of motivation or searching for alternative solutions, I asked Claude to create a README file for each important folder on my computer. I had no high expectations, but I was astonished when the process cut my file search time by 96%.

The concept was simple: Claude would explore my existing files and folders, understand their contents, and create a reference system using README files. These files would serve as a table of contents, pointing to smaller READMEs inside important folders, which would explain their contents and relationships. Instead of merely listing filenames, I wanted Claude to describe what files were about, include relevant keywords, and explain how files were connected.

I opened Claude Code in my home directory and gave it a detailed prompt, instructing it to recursively examine the directory structure, identify important folders, and inspect file contents where useful. Claude focused on understanding the purpose of projects, topics, dates, document types, and relationships between files, while skipping irrelevant directories, caches, dependencies, and sensitive files.

In the optimization phase, Claude structured the README files to enable an AI agent to efficiently navigate the hierarchy. A master README served as a table of contents, while smaller READMEs explained the contents of important folders. Each README included natural-language descriptions, keywords, and relative links based on likely search queries.

Claude ensured the hierarchy was concise and accurate, preserving existing instructions and not modifying any existing files, except for creating or updating the README hierarchy and CLAUDE.md file.