feat: allow per-project plan file directory configuration

Resolved 💬 3 comments Opened Apr 3, 2026 by constancio-ob Closed Apr 7, 2026

Feature Request

Problem

Plan files are currently saved to ~/.claude/plans/, which is a global directory shared across all projects. There's no way to configure this on a per-project basis.

For projects where plans are valuable artifacts (e.g., documenting architectural decisions, onboarding context), it would be useful to store them inside the repo itself (e.g., .claude/plans/), so they can be committed to version control and shared with the team.

Current workaround

Manually copying plan files from ~/.claude/plans/ into the project's .claude/plans/ directory after each planning session.

Proposed solution

Add a plansDir setting (or similar) to the project-scoped .claude/settings.json that allows overriding where plan files are saved. For example:

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

When set, Claude Code would save plan files to the specified path relative to the project root instead of ~/.claude/plans/.

Why this matters

  • Plans become part of the project history and can be reviewed in PRs
  • Team members can reference past architectural decisions
  • No manual copy step needed after each planning session
  • Each project's plans stay isolated from other projects

🤖 Generated with Claude Code

View original on GitHub ↗

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