Comment by jswny

They have an entire feature for this: https://www.claude.com/blog/skills

CLAUDE.md should only be for persistent reminders that are useful in 100% of your sessions

Otherwise, you should use skills, especially if CLAUDE.md gets too long.

Also just as a note, Claude already supports lazy loaded separate CLAUDE.md files that you place in subdirectories. It will read those if it dips into those dirs