[BUG/FEATURE] Plan files grow indefinitely, burying current work under historical context
Resolved 💬 3 comments Opened Jan 28, 2026 by HirokiKobayashi-R Closed Feb 28, 2026
Problem
When working on a long-running project, plan files accumulate all historical context indefinitely. After a few weeks of active development, my plan file is now 2400+ lines, containing:
- Completed phases from weeks ago
- Old design decisions that are no longer relevant
- Investigation notes from resolved issues
- Current work (buried somewhere in the middle)
This makes the plan file essentially unusable for its intended purpose - understanding "what am I currently trying to do?"
Steps to Reproduce
- Start a new project, enter plan mode
- Work on Feature A, document the plan
- Complete Feature A
- Enter plan mode for Feature B - same file, content appended
- Repeat for Features C, D, E...
- After ~10 planning sessions, the file becomes unwieldy
Current Behavior
- All planning sessions append to the same file per project
- Completed work remains in the file forever
- Claude adds new sections but never archives/removes old ones
- When re-entering plan mode, Claude reads the entire bloated file
Expected Behavior
One of:
- Session-based plan files - New plan file for each planning session, with option to reference previous
- Automatic archival - Move completed sections to an archive file
- Plan file rotation - When file exceeds N lines, archive and start fresh
- Explicit lifecycle - Let users mark sections as "done" to be archived
Environment
- Claude Code version: 2.1.20
- OS: macOS
Additional Context
Related issues that touch on plan file UX but don't address this specific problem:
- #21342 (file naming)
- #20899 (response buried)
- #18434 (lifecycle documentation)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗