[DOCS] Memory and settings docs are outdated/incomplete for worktree sharing behavior

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Auto memory storage behavior across git worktrees, and project configuration behavior across worktrees.

Current Documentation

The memory page currently says:

"Each project gets its own memory directory at ~/.claude/projects/<project>/memory/... Git worktrees get separate memory directories."

Settings docs describe project/local settings files but do not clarify current cross-worktree behavior:

.claude/settings.json (shared project settings) .claude/settings.local.json (local settings)

What's Wrong or Missing?

Release v2.1.63 states:

"Project configs & auto memory now shared across git worktrees of the same repository"

The docs are now inconsistent with shipped behavior:

• Auto memory text explicitly states the old behavior (separate worktree memory directories)
• Worktree docs/settings docs do not explain the new shared project-config behavior

Suggested Improvement

Update docs to match current behavior:

1. In memory, replace the outdated statement about separate worktree memory directories with the new repository-shared behavior.
2. In settings (and/or common-workflows), add a short note explaining how project configs behave across git worktrees in the same repo.
3. Add a migration note for users upgrading from pre-2.1.63 assumptions.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/memory | Contains explicit outdated statement: "Git worktrees get separate memory directories" |
| https://code.claude.com/docs/en/settings | Needs clarification for project config behavior across worktrees |
| https://code.claude.com/docs/en/common-workflows | Worktree guide should mention shared config/memory behavior for same repository |

Total scope: 3 pages affected

Source: Claude Code release v2.1.63
Changelog entry: "Project configs & auto memory now shared across git worktrees of the same repository"