[DOCS] Missing contextual documentation for plansDirectory setting in Plan Mode workflows
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/common-workflows
Section/Topic
The section "Use Plan Mode for safe code analysis" in docs/en/common-workflows.md
Current Documentation
Currently, the plansDirectory setting is correctly listed in the table within docs/en/settings.md following its release in v2.1.9.
However, the functional guide for Plan Mode in docs/en/common-workflows.md describes how to enter Plan Mode and how it works ("Claude analyzes the current implementation and create a comprehensive plan"), but it does not mention where these plan files are stored or that the location is configurable.
What's Wrong or Missing?
While the setting is technically documented in the settings reference, it is missing from the contextual "how-to" documentation where a user is most likely to look for it.
Users following the Common Workflows guide to learn about Plan Mode are not informed that:
- Plans are saved to disk (default
~/.claude/plans). - This storage location can be customized using the
plansDirectorysetting.
Suggested Improvement
I suggest adding a "Configuration" or "Storage" subsection (or a <Tip>) to the "Use Plan Mode for safe code analysis" section in docs/en/common-workflows.md.
Suggested Text:
Plan Storage By default, plans are stored in~/.claude/plans. You can customize this location by configuring theplansDirectoryoption in your settings. See [Settings](/en/settings) for more details.
Impact
High - Prevents users from using a feature
Additional Context
- Changelog Reference: The
plansDirectorysetting was added in version 2.1.9. - Related Files:
- Present in:
docs/en/settings.md - Missing from:
docs/en/common-workflows.md - Potentially relevant for:
docs/en/memory.md(as plans are a form of session memory).
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗