[DOCS] Plan mode docs missing prompt-based plan filename behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

plansDirectory and plan-file storage/editing behavior

Current Documentation

The docs currently say:

| plansDirectory | Customize where plan files are stored. Path is relative to project root. Default: ~/.claude/plans |

And the plan workflow docs say:

Press Ctrl+G to open the plan in your default text editor, where you can edit it directly before Claude proceeds.

These pages establish that plan files are stored on disk and can be opened in an editor, but they do not explain how Claude names those files.

What's Wrong or Missing?

Changelog v2.1.111 says: Plan files are now named after your prompt (e.g. fix-auth-race-snug-otter.md) instead of purely random words.

The current docs explain where plan files live and that you can open/edit a plan, but they do not document that plan filenames now include prompt-derived words rather than being composed only of random words. That leaves users without guidance on how to find the right plan file in plansDirectory, recognize why filenames changed, or script around the new naming behavior.

Suggested Improvement

Add a short note anywhere plan files are described (at minimum near plansDirectory, and ideally also in the plan workflow docs) that explains the filename convention.

Suggested content outline:

Plan filenames now include words derived from the prompt instead of using only random-word names. For example, a plan for "fix auth race" may produce a filename like fix-auth-race-snug-otter.md.

It would also help to clarify that plansDirectory changes where plan files are stored, while the filename itself is generated by Claude Code.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | plansDirectory explains where plan files are stored |
| https://code.claude.com/docs/en/common-workflows | Plan mode workflow tells users they can open and edit the plan in an external editor |
| https://code.claude.com/docs/en/best-practices | Repeats the external-editor workflow for plans |
| https://code.claude.com/docs/en/claude-directory | Lists ~/.claude/plans/ as a local data directory |

Total scope: 4 pages affected

Source: Changelog v2.1.111

Exact changelog entry: Plan files are now named after your prompt (e.g. fix-auth-race-snug-otter.md) instead of purely random words