Allow configuring plan file storage location (project-level option)

[tokiyama-corp]

Problem

Plan files created via /plan mode are always saved to ~/.claude/plans/, the user-level directory. For solo developers or single-project workflows, this creates friction:

1. Plans are logically part of the project but stored outside the project directory, making them hard to discover and reference.
2. The user-level path (e.g., C:\Users\<username>\.claude\plans\) is long and unintuitive compared to a project-relative location.
3. When reviewing project context, plans are not visible alongside the code and documentation they relate to.
4. The current design optimizes for multi-user/multi-project separation, but many users work solo on a single project where that separation adds no value.

Proposed Solution

Add a configuration option (e.g., in .claude/settings.local.json or project-level settings) to specify the plan storage directory:

{
  "planDirectory": ".claude/plans"
}

When set, plans would be saved relative to the project root instead of ~/.claude/plans/.

The default behavior (user-level storage) would remain unchanged for backward compatibility.

Use Case

• Solo developers managing a single project who want all Claude Code artifacts (commands, rules, specs, and plans) colocated within the project directory.
• Teams that want to commit finalized plans alongside design documents in the repo.

Environment

• Windows 11, Claude Code CLI
• Single-user, single-project workflow

[github-actions]

Found 3 possible duplicate issues:

1. Feature Request: Configurable Plan File Storage Path & Plan Templates #14866
2. Feature request: Allow configuring where /plan command stores plan files #17871
3. [BUG] Plan mode silently overwrites plan files across projects — no project scoping, no backup #35943

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically closed as a duplicate of #14866.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.