[DOCS] `/doctor` docs omit checked-in `CLAUDE.md` trimming of codebase-derivable content

Open 💬 0 comments Opened Jul 10, 2026 by coygeek

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

The /doctor row in the "All commands" table.

Current Documentation

The /doctor description currently says it:

"deduplicates local CLAUDE.md files against checked-in ones, migrates always-loaded guidance into skills and nested CLAUDE.md files that load on demand"

This describes overlap between local and checked-in memory files, but not the separate v2.1.206 check for content that Claude can derive from the repository itself.

What's Wrong or Missing?

Claude Code v2.1.206 adds a /doctor check that proposes trimming checked-in CLAUDE.md files by removing guidance Claude can derive from the codebase. The command reference does not identify this check or distinguish it from deduplicating a local CLAUDE.md against a checked-in one.

Those are different cleanup decisions: one removes duplicate instructions across files, while the new check reduces checked-in context by recognizing repository facts that do not need to be repeated as instructions. Without that distinction, users cannot tell from the reference that /doctor reviews checked-in project memory for codebase-derivable content.

Suggested Improvement

Extend the /doctor row with a separate clause, for example:

Reviews checked-in CLAUDE.md files for content Claude can derive directly from the codebase and, with confirmation, proposes trimming that content to reduce always-loaded context.

Keep this separate from the existing local-versus-checked-in deduplication clause, and retain the existing statement that /doctor reports findings and asks before changing files.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 74 | /doctor capabilities and confirmation behavior |

Total scope: 1 page affected.

Version: Added in Claude Code v2.1.206.

View original on GitHub ↗