[DOCS] Missing contextual documentation for plansDirectory setting in Plan Mode workflows

Resolved 💬 3 comments Opened Jan 19, 2026 by coygeek Closed Feb 27, 2026

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:

  1. Plans are saved to disk (default ~/.claude/plans).
  2. This storage location can be customized using the plansDirectory setting.

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 the plansDirectory option in your settings. See [Settings](/en/settings) for more details.

Impact

High - Prevents users from using a feature

Additional Context

  • Changelog Reference: The plansDirectory setting 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).

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗