Marked as helpful by the asker
Reading the whole repo doesn't scale. What works for me:
- A short section in
CLAUDE.md: "Before writing a helper, greplib/for an existing one." Claude Code actually runs the grep. - Keep
lib/index.tsthat re-exports everything. One file to read, and it's the map of what exists. - Once a week ask it: "list duplicate helpers in this repo and merge them". Cheap cleanup.
The root cause is that it starts each session blind. Give it a map, not the territory.