PLAN MODE WRITABLE DIRECTORY FEATURE REQUEST

Resolved 💬 6 comments Opened Aug 19, 2025 by wdelhagen Closed Jan 8, 2026

Context: Enhancement request for Claude Code's plan mode functionality
Type: Feature Request

REQUEST SUMMARY
---------------
Add configuration option to allow file writes to specified directories during plan mode, enabling artifact-based planning workflows while maintaining code protection.

CURRENT BEHAVIOR
----------------
When plan mode is active:

  • All file write operations are blocked
  • User must approve actions before any files can be created
  • Planning workflows that rely on document creation are disrupted

PROPOSED ENHANCEMENT
--------------------
Add configuration option such as:

plan_mode:
  allowed_write_directory: "plan/"

This would allow:

  • File creation in specified directory during plan mode
  • Planning documents to be created without approval gates
  • Artifact-based consensus building to continue working
  • Code directories to remain protected

USE CASE DESCRIPTION
--------------------
Many users have established workflow systems that depend on creating planning artifacts:

  • Requirements documents (requirements.txt, requirements.md)
  • Design specifications (design.txt, design.md)
  • Implementation plans (plan.txt, plan.md)
  • Research reports (plan/research/*.txt)

These workflows rely on document creation for:

  • Shared understanding between user and AI
  • Iterative refinement of plans
  • Version control of planning decisions
  • Reference material for implementation

PROBLEM WITH CURRENT APPROACH
------------------------------
Plan mode currently forces "phantom planning" where:

  • Plans exist only in conversation until approved
  • No tangible artifacts to review and refine
  • Breaks established document-based workflows
  • Prevents collaborative iteration on planning documents

BENEFIT OF PROPOSED SOLUTION
-----------------------------

  1. Maintains Security: Code directories remain protected
  2. Enables Workflows: Planning documents can be created immediately
  3. Improves Review Process: Concrete artifacts to review instead of conversation abstracts
  4. Preserves User Investment: Existing workflow systems continue to function
  5. Flexible Configuration: Users can specify which directories are safe for planning

IMPLEMENTATION APPROACH
-----------------------

  • Configuration option in user settings
  • Directory path validation to ensure safety
  • Clear documentation of which directories are write-enabled
  • Maintains approval gates for all other file operations

ALTERNATIVE CONFIGURATIONS
---------------------------
Different users might prefer different approaches:

# Planning directory only
plan_mode.allowed_write_directory: "plan/"

# Multiple safe directories
plan_mode.allowed_write_directories: ["plan/", "docs/", ".claude/"]

# Pattern-based matching
plan_mode.allowed_write_patterns: ["plan/**", "*.md"]

COMPATIBILITY
-------------
This enhancement would:

  • Not affect existing plan mode behavior for users who don't configure it
  • Allow gradual adoption of artifact-based planning
  • Maintain all current security protections for code directories
  • Work with existing planning workflow systems

PRIORITY
--------
This feature would significantly improve plan mode usability for users with established workflow systems while maintaining the security benefits plan mode is designed to provide.

View original on GitHub ↗

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