[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.

View original on GitHub ↗

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