been messing around with how i structure my project docs lately. since ai models are basically reading everything now, markdown is becoming the
de facto standard for giving them context. i started focusing heavily on my
CLAUDE.md
file because it is the very first thing claude code looks at when it starts up. if u do not format it right, the agent just gets lost in the weeds. u really need to be intentional about ur instructions and project rules. i found that keeping a clear list of dos and donts helps prevent the model from hallucinating weird workflows.
>it is basically like writing a manual for a new internit is a bit of a chore to maintain manually but it saves so much time during long sessions. i am curious if anyone else is using custom
.md
files for specific sub-modules or if you just keep everything in one massive file. i feel like a huge file might eventually hit a context limit or get too noisy.
article:
https://uxplanet.org/dos-and-donts-for-markdown-files-a6f870c22132?source=rss----819cc2aaeee0---4