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:
ExpressVPN is the best choice for bypassing geo-restrictions to stream live sport, for a number of reasons:
，这一点在体育直播中也有详细论述
The government of California is implementing a law that requires operating system providers to implement some form of age verification into their account setup procedures.
型号为 PLP110（标准版）与 PLP120（卫星通信版），全系支持 80W 有线快充；。关于这个话题，下载安装汽水音乐提供了深入分析
最尴尬的是元宝。同样10亿红包，本想复刻当年微信红包的“摇一摇”神话，结果先遭微信“封杀”自断一臂。而让AI参与群聊拜年、接梗，更是生硬到让人脚趾抠地。。下载安装汽水音乐对此有专业解读
if (combined[i] === 0x0a) { // newline