I read an article recently about what research has shown works best for CLAUDE.md, the recommendation was basically just a thin pointer file around 30 lines and an SDD.md file with the important global conventions and decisions in there (but still not heavy). I figured why not give it a shot, I’m always down to try something that could improve the performance and quality. I haven’t had any real issues lately but things can always be better. This is also driven by me recently installing a codebase mapping mcp server which removed the need for a less useful index file of import/export dependencies. I also have had for a while a readme for each subdirectory like one for /src/modules/forecast. I only just did this today so I don’t know how much it’ll change behavior. How is everyone else managing their project docs? How well is it working for you? Any suggestions looking at my docs? My codebase for reference, keep in mind it’s a minified Userscript and source closed due to where I work and to curb users from modifying and redistributing it rather than coming to me with a request. I have the current CLAUDE.md and SDD.md file hosted there along with an architecture overview, the bundled Userscript, and release notes for curious users. https://github.com/jaker788-create/APM-Master Here’s the article I read: https://patterninterruption.substack.com/p/stop-stuffing-your-claudemd-the-research?triedRedirect=true submitted by /u/Jaker788
Originally posted by u/Jaker788 on r/ClaudeCode
You must log in or # to comment.