PLAN MODE WRITABLE DIRECTORY FEATURE REQUEST
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
-----------------------------
- Maintains Security: Code directories remain protected
- Enables Workflows: Planning documents can be created immediately
- Improves Review Process: Concrete artifacts to review instead of conversation abstracts
- Preserves User Investment: Existing workflow systems continue to function
- 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.
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗