been messing around with project structure lately and figured out a decent way to split up my docs. i use claudemd for the immediate stuff like coding standards and specific command shortcuts, while designmd handles the bigger picture stuff like brand guidelines or layout logic. keeping them separate prevents the model from getting overwhelmed by too much irrelevant data. it helps when you are working on tricky breakpoints like
@media (max-width: 768px){...}because you can keep those rules in your design file. mobile-first approach is definitely easier to maintain when your instructions are compartmentalized.
>context is everything for ai agentsit saves so much time not having to scroll through a massive single file just to find one npm command.
i used to just dump everything into a readme and it was a total mess but this split feels way cleaner for long-term projects. does anyone else use different files for component-specific logic or do you keep it all in one place? i am still trying to find the perfect balance between
granularity and simplicity
article:
https://uxplanet.org/claude-md-vs-design-md-what-to-put-in-each-for-claude-code-53647d015bfd?source=rss----819cc2aaeee0---4