Plan-mode: writes to plan file leave no user-facing pointer — file may not be open in view
Summary
In plan mode, Claude writes/updates the plan file via tool calls that are not rendered inline in the assistant's user-facing text. If the plan file isn't already open in the IDE tab, the user has no explicit cue that the plan was updated or where to look. Updates are effectively invisible.
Repro
- Start a session in plan mode (VSCode extension).
- Ask Claude to do a research task that causes it to Write or Edit the plan file.
- Close or never-open the plan file tab.
- Observe: Claude's reply summarizes the work but does not surface an explicit path/clickable link to the plan file, nor a "open this to review" instruction.
Expected
Every turn that writes or edits the plan file should close with an explicit clickable link (markdown link to the plan file path) and a short instruction like "Open the plan file to review the changes." This should happen on incremental edits too, not just the first write.
Why it matters
- Plan mode's value depends on the user actually reading the plan before approving. Silent updates defeat the purpose.
- The current behavior relies on the user predicting which file was touched and opening it manually.
- The IDE extension already supports clickable markdown file links, so the fix is a prompt/guidance change, not an extension change.
Suggested fix
Update the plan-mode system prompt so that after any Write/Edit on the plan file, the user-facing message must include an explicit markdown link to the plan file plus an open-to-review instruction.
Environment
- Claude Code VSCode extension
- Plan mode active
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗