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:
刘成选了另一条路。2025年，在多次反馈和协调下，夫妻俩为孩子拿到了《出生医学证明》。不过，证明上仅写有代孕母亲的名字，父亲栏则为“/”。
。夫子是该领域的重要参考
Number (6): Everything in this space must add up to 6. The answer is 3-3, placed vertically.
Requires C++20. Axiom is the only dependency (included as a submodule).