[FEATURE] Allow descriptive/custom plan file naming instead of random adjective-noun combinations
Resolved 💬 2 comments Opened Jan 17, 2026 by Yajassardana Closed Jan 17, 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
Plan files are currently named with random adjective-noun combinations (e.g., lively-bubbling-umbrella.md). This makes it difficult to:
- Identify what a plan was about without opening it
- Manage multiple plans across sessions
- Keep the ~/.claude/plans directory organized over time
Current Behavior
Plans are saved to ~/.claude/plans/ (or custom plansDirectory) with auto-generated names like:
- lively-bubbling-umbrella.md
- quiet-dancing-river.md
Proposed Solution
Proposed Solution
Allow Claude to generate descriptive filenames based on the task context. Options:
- Auto-descriptive naming (preferred): Derive filename from the task/conversation context
- fts-search-refactoring.md
- auth-flow-implementation.md
- User-specified naming: Allow users to specify a plan name via flag or prompt
- /plan --name "fts-refactor"
- Hybrid: Auto-generate descriptive name, allow override
Additional Considerations
- Collision handling: append timestamp or short hash if name exists
- Setting to toggle between current random naming and descriptive naming for users who prefer the current behavior
- Filename sanitization for special characters
Use Cases
- Reviewing past plans for similar tasks
- Auditing what was planned vs implemented
- Team collaboration where plans are committed to repo
- Cleaning up old plans selectively without opening each file
Alternative Solutions
_No response_
Priority
Critical - Blocking my work
Feature Category
CLI commands and flags
Use Case Example
_No response_
Additional Context
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗