Claude Code · Source-level changelog

Version 2.0.21

This release improves the plan mode workflow by adding guidance for handling ambiguous requirements, helping Claude better understand when to ask clarifying questions before implementing features.

Package @anthropic-ai/claude-code Diff v2.0.20 → v2.0.21
3
Features & Changes
0
Bug Fixes
0
In Development
0
Env Vars / Flags

Changes

3 items

Enhanced Plan Mode Guidance #

What: The ExitPlanMode tool now includes comprehensive guidance on handling ambiguous requirements and unclear implementation approaches.

Details:

  • Added "Handling Ambiguity in Plans" section to help Claude identify when clarification is needed at OU8() at line 428198
  • Claude will now proactively ask about:
  • Multiple valid implementation approaches (e.g., architectural patterns)
  • Library or framework choices
  • Assumptions that could affect implementation
  • Includes a new example demonstrating proper clarification workflow for authentication features
  • Claude must now resolve ambiguities before proceeding with implementation

Impact: Users will experience fewer instances where Claude makes incorrect assumptions about implementation details. When requirements are unclear, Claude will ask targeted questions to understand the desired approach before writing code.

Evidence:

  • v2.0.20: Basic ExitPlanMode documentation at OU8() at line 428188 with 2 examples
  • v2.0.21: Enhanced ExitPlanMode documentation at OU8() at line 428198 with ambiguity handling section and 3 examples

Improved Signal Handling #

What: Enhanced initialization sequence to include proper SIGINT/SIGTERM signal handlers for graceful shutdown.

Details:

  • Added signal handler initialization (N7()) to the uz1 startup function at line 455136
  • Ensures proper cleanup when Claude Code is interrupted or terminated
  • No user-visible behavior change, but improves reliability

Evidence:

  • v2.0.20: uz1 initialization at line 455101 without signal handlers
  • v2.0.21: uz1 initialization at line 455136 now includes N7() signal handler

Code Reorganization #

  • Internal variable and function renames throughout the codebase (6690 renames total)
  • Import statement reorganization for better code structure
  • No functional changes to existing features