One command cleans CLAUDE.md, I keep 3 types
Learn which 3 types of content to keep when Claude Code's /doctor command suggests deletions. Keep pitfalls, decision rationales, and non-default conventions.
“AI Disruption” Publication 10,300 Subscriptions 20% Discount Offer Link.
How to slim down an increasingly bloated CLAUDE.md
Unexpectedly, just recently (2026.7.10), the official team took action: Claude Code v2.1.206 built this into the /doctor command. It checks the CLAUDE.md already committed to the repository and suggests removing content that Claude can already see from the code itself.
One thing to note: /doctor can list candidates for deletion, but whether to actually delete them still requires human confirmation. Real project documentation often mixes deletable facts with non-discardable decision rationales in the same paragraph.
So what I care about here is no longer “how short can the file still get,” but which content must be manually preserved from the deletion suggestions.
The official command documentation lists exactly three categories of items to keep: pitfalls, decision rationales, and conventions that deviate from the tool’s default behavior. Below I will take a mixed project description, perform a manual review, and then provide a fully filled-out streamlined example along with a review checklist.
