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:
Мерц резко сменил риторику во время встречи в Китае09:25
，详情可参考WPS官方版本下载
A shortage in medical cement is likely to lead to delays in some patients getting joint surgery, NHS bosses say.。下载安装汽水音乐对此有专业解读
高德占是中共第十二届、十三届中央委员会候补委员，中共第十四届中央委员会委员，中共十三大、十四大、十五大、十九大代表，第八届、九届全国人大代表，第九届全国人大常务委员会委员。
References & Citations