Your Folder Structure Is an Interface
12 Aug 2026
31 min read
On this page
- Bad structure never throws an error
- The destination, and the part nobody tells you
- Folders by kind lose to folders by purpose
- Own by imports, not by layout
- Names that lie cost more than names that are vague
- Make the URL tree answer the same question as the folder tree
- How to actually move
- Conventions that aren't machine-checked rot
- The honest numbers
- Two things the plan didn't predict
- Why this pays double when agents are writing the code
- The question worth asking