The Vault Excavation

The spec said move about 170 files. The actual count was 4,619.

The spec said move about 170 files.

The actual count was 4,619.

Six hours. 12.1 GB of files routed out of the knowledge vault into an organized filing cabinet. Vault size dropped from 16 GB to 3 GB. Along the way: 463 broken internal links repaired, three separate node_modules directories found and deleted, 27 sync conflict files cleared, and one Astro project with its full build cache discovered sitting inside the vault, syncing across two machines for nobody knows how long.

Nobody put 4,619 files in the wrong place intentionally. They landed there because the vault was the path of least resistance. Passport scan? Vault. Tax filing? Vault. DayOne photo export from 2019? Vault. Scrivener projects from a novel not actively being written? Vault.

The vault inbox was a roach motel: easy in, nobody thought about out.

What slowed it down

Moving files sounds mechanical. It’s not. Every file is a judgment call.

Is a screenshot of a signed lease document a Home record or a Legal one? Is an old business card scan Identity or Archive? Is a half-finished draft Career or Workbench?

“Organize my files” is actually a series of policy decisions about how to classify information. You can’t automate the decisions. You can only automate the movement after the decision is made.

The files that took longest weren’t the big ones. The big ones were obvious. The hard ones were the small ambiguous files: one screenshot, unknown date, unclear purpose. Thirty seconds to decide, then route it and move on. Most weren’t worth more than that.

Why the estimate was so wrong

The spec estimated 170 files because I was thinking about the files I knew about. The extra 4,449 were the ones I’d forgotten existed.

That’s the real finding: the gap between your mental model of your own system and its actual state. I thought the vault was mostly text. It was 16 GB. Text files are tiny. What was all that space?

Turns out: years of “I’ll sort this later.” The spec covered the files I remembered. The excavation uncovered the files I’d stopped seeing.