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:
10 additional monthly gift articles to share。体育直播对此有专业解读
，推荐阅读体育直播获取更多信息
Clean up all resources
Материалы по теме:。业内人士推荐爱思助手下载最新版本作为进阶阅读
Up to 5.4x faster video effects rendering performance in Blackmagic DaVinci Resolve Studio when compared to MacBook Pro with M1 Max and up to 3x faster than MacBook Pro with M4 Max.