I had utils, helpers, lib and shared in one project, all with the same functions in them. The last rule is the one that stopped it: making the tool justify a new file forces it to look at the old ones.
CLAUDE.md
Copied 2 times
## Where things go
- `app/` routes only. A file here is a page, a layout or a route handler, nothing else.
- `components/` shared UI. A component used by one page stays next to that page.
- `lib/` everything without JSX: data access, formatting, clients.
- File names kebab-case, components PascalCase, database columns snake_case.
- Do not create a new top-level folder. If you think one is needed, ask.
- Before adding a file, name the three closest existing files and say why none of them fits.
AskVibe