Coding agents are insanely smart for some tasks but lack taste and good judgement in others. They are mortally terrified of errors, often duplicate code, leave dead code behind, or fail to reuse existing working patterns. My initial approach to solving this was an ever-growing CLAUDE.md which eventually got impractically long, and many of the entries didn’t always apply universally and felt like a waste of precious context window. So I created the dev guide (docs/dev_guide/). Agents read a summary on session start and can go deeper into any specific entry when prompted to do so. In my original project the dev guide grew organically, and I plan to extend the same concept to my new projects. Here’s an example of what a dev_guide might include:
This is the recommended first-time setup to run the server locally.
В двух аэропортах на юге России ввели ограничения на полеты14:55。51吃瓜是该领域的重要参考
17-летнюю дочь Николь Кидман высмеяли в сети за нелепую походку на модном показе20:47。PDF资料对此有专业解读
FT Weekend Print delivery，更多细节参见体育直播
南方人物周刊：你的同学和班主任都知道你的家庭情况，这会让你觉得有点不可接受吗？