[DOCS] Logic contradiction in `plansDirectory` default configuration description

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The Available settings table, specifically the entry for the plansDirectory key.

Current Documentation

The description field for plansDirectory currently states:

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

What's Wrong or Missing?

There is a logical contradiction between the instruction and the default value provided:

1. The documentation states the path is "relative to project root."
2. The default value is listed as ~/.claude/plans.

In shell and configuration conventions, a path starting with ~ is an absolute path pointing to the user's home directory, not a relative path from the project root. This creates confusion as to whether the setting only supports relative paths (meaning the default is typed incorrectly) or if it supports both (meaning the description is incomplete).

Suggested Improvement

The description should be updated to clarify that it supports both path types, or the "relative" constraint should be removed if absolute paths are the intended default behavior.

Suggested Text:

"Customize where plan files are stored. Supports paths relative to project root or absolute paths (e.g., using ~). Default: ~/.claude/plans"

Impact

High - Prevents users from using a feature

Additional Context

Related documentation on configuration locations can be found at https://code.claude.com/docs/en/settings#settings-file-locations. Providing this clarity helps users who want to store plans in a centralized location (absolute) versus those who want to keep plans alongside their source code (relative).