[FEATURE] Configurable plan file location
Resolved 💬 8 comments Opened Dec 8, 2025 by nkoji21 Closed Jan 15, 2026
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
In Plan mode, .md files are created in the .claude directory by default.
This makes plans less visible in day‑to‑day development and separated from broader project documentation.
Proposed Solution
Allow configuring where plan files are created, preferably the project root, or a custom path.
This could be controlled via .claude/settings.json.
{
"planFileLocation": "root"
}
When using a custom path:
{
"planFileLocation": "custom",
"planFileCustomPath": "docs/plans"
}
Alternative Solutions
- Manually moving plan files after creation (easy to forget).
- Symlinks from root to
.claude(platform‑dependent). - Editor tasks/scripts to copy files (maintenance overhead).
Priority
Low - Nice to have
Feature Category
CLI commands and flags
Use Case Example
- Keep plans visible at the project root alongside README and other docs.
- Store planning artifacts with the rest of technical documentation to improve discoverability.
- Standardize plan locations across repos via a shared settings file.
Additional Context
- Validate
planFileCustomPath(repo‑relative vs absolute). - Document precedence when both fields exist; require custom path only when location is
"custom". - Ensure backward compatibility: if absent, default to
.claude.
This issue has 8 comments on GitHub. Read the full discussion on GitHub ↗