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:
Chancellor Rachel Reeves said on Monday that the UK had used the G7 meeting to urge "immediate de-escalation" in the Middle East and guaranteed security for vessels in the region.，推荐阅读新收录的资料获取更多信息
。新收录的资料是该领域的重要参考
• 她质感品牌：它们是中女时代叙事的缔造者，试图以高单价的质感叙事，完成从“大牌附庸”到“自我定义”的平权革命。，更多细节参见新收录的资料
* @param arr 待排序数组