Why Claude.md Keeps Growing: The Cost of Deleting vs. Adding Instructions
量子位 · wechat · 2026-08-15
Core Finding
Research reveals that instruction files like Claude.md often balloon to over 3x their initial size—a phenomenon termed "catastrophic remembering." A survey of 2,000 GitHub repos shows an average instruction growth of 226%.
Root Cause
- Low Add Cost: Fixing issues by adding new rules is immediate and easy to verify.
- High Delete Cost: The context (why a rule was added, what bug it fixed) fades over time. Without this "latent reasoning," maintainers fear deletion.
- Reset Fails: While maintainers often wipe files clean, the bloat inevitably returns.
Solution
Adding effective annotations (recording the trigger, logic, and validation result) is key. Experiments show that well-annotated prompts reduced excess instruction size from 211.3% to 1.4%, cutting 99.3% of redundancy without sacrificing accuracy.
- Effective annotations boosted Agent compliance by up to 23.1%.
- Placebo or unverified notes are useless or misleading.
Industry Insight
The article calls for AI tool providers to upgrade infrastructure, establishing an "instruction + evidence" update mechanism so tools can actively verify and "forget," rather than just storing final rules.
More from coding & agent
- Building Agents Without Boundaries Leads to Uncontrolled Execution — goyalshaliniuk · 2026-08-15
- Optimize the entire pipeline, not just the model — goyalshaliniuk · 2026-08-15
- Manual AI Evaluation is Flawed: Build Automated Datasets Instead — goyalshaliniuk · 2026-08-15
- Giving Agents Too Many Tools Degrades Performance: Less is More — goyalshaliniuk · 2026-08-15
- 7 AI Mistakes Even Experienced Developers Make When Building Apps — goyalshaliniuk · 2026-08-15
- Meta releases Muse Glimmer Cookbook: run a full agent offline on a single GPU — pmttyji · 2026-08-15