claude-code-system-prompts/CHANGELOG.md

Claude Code System Prompts Changelog

2.0.56

• Reinforced note about using the current year in the WebSearch tool description
• Added a note to the main system prompt instructing Claude to never include time estimates when presenting options or plans.
• Strengthened and elaborated "plan mode is active" system reminder
• Encouraged the Explore subagent to be more tool-call-efficient and token-efficient
• Added an instruction to "Read any files provided to you in the initial prompt" to the Plan subagent
• Changed the theme of the prompt suggestion generator's prompt from "predict what the user will type next" to "suggest what Claude could help with"
• Stopped directing the user to open a GH an on the Claude Code repo via /feedback when the claude-code-guide subagent is at a loss
• Removed the old plan mode's system reminder

2.0.55

+121 tokens

• NEW: Added Agent Prompt: Suggested Prompt Generator for suggesting a followup propmt after Claude response. Requires tweakcc to enable the functionality in Claude Code: run npx tweakcc@latest --apply and then claude and then send a message.
• Modified interpolated formatting code in mcp-cli prompt

2.0.54

+128 tokens

• Multi-Agent Planning Note: Added a note discouraging overuse of multiple plan agents: If the task is simple, you should try to use the minimum number of agents necessary (usually just 1)
• Added a similar longer note to the "Plan mode is active" system reminder

2.0.53

_{No changes to the system prompts in v2.0.53.}

2.0.52

+42 tokens

• Add a 4th note to the procedure steps in the Plan Mode Re-entry System Prompt: "Continue on with the plan process and most importantly you should always edit the plan file one way or the other before calling ExitPlanMode."

2.0.51

+906 tokens

• NEW: Prompt for the new EnterPlanMode tool.
• NEW: Prompt for agent hooks.

2.0.50

+465 tokens

• NEW: System reminder sent when an mcp-cli read or mcp-cli call output is longer than the MAX_MCP_OUTPUT_TOKENS environment variable (defaults to 25000)
• WebSearch tool description: Added a "CRITICAL REQUIREMENT" to include a "Sources:" section whenever performing a web search.
• Session notes template: Added a "Key results" section including "specific outputs" such as "an answer to question, a table, or other document."

2.0.49

• Explore & Plan agents:
  • Enhanced READ-ONLY restrictions with explicit bulleted list of prohibited operations
  • Added note that file editing tools are not available
  • Reformatted Bash tool restrictions for clarity

2.0.48 – This version does not exist.

2.0.47

• NEW: Agent prompt: Multi-Agent Planning Note - instructions for multi-agent planning when CLAUDE_CODE_PLAN_V2_AGENT_COUNT > 1
• NEW: System reminder: Plan mode re-entry - sent when user re-enters Plan mode after exiting
• Main system prompt: Added "NEVER propose changes to code you haven't read" instruction
• Main system prompt: Added comprehensive "Avoid over-engineering" section with guidelines on simplicity
• Enhanced plan mode reminder: Refactored variable names and simplified structure
• Enhanced plan mode reminder: Fixed typo "Syntehsize" → "Synthesize", "alwasy" → "always"

2.0.46

_{No changes to the system prompts in v2.0.46.}

2.0.45

• NEW: Agent prompt: Claude Code guide agent for helping users with Claude Code and Agent SDK
• NEW: Agent prompt: Session title and branch generation (replaces session title generation)
• NEW: System prompt: whenToUse note for claude-code-guide subagent
• Main system prompt: Updated to use Task tool with claude-code-guide subagent instead of WebFetch for documentation lookup
• Enhanced plan mode reminder: Added parallel exploration support with PLAN_V2_EXPLORE_AGENT_COUNT
• REMOVED: Agent prompt: Session title generation (replaced by session title and branch generation)

2.0.44

_{No changes to the system prompts in v2.0.44.}

2.0.43

• NEW: Tool description: ExitPlanMode v2
• NEW: System reminder: Plan mode is active (for subagents)
• Main system prompt: Added "Planning without timelines" section
• Main system prompt: Added instruction to avoid backwards-compatibility hacks
• Enhanced plan mode reminder: Major restructuring with plan file support and variable updates

2.0.42

_{No changes to the system prompts in v2.0.42.}

2.0.41

• NEW: Agent prompt: Plan mode (enhanced)
• NEW: System reminder: Plan mode is active (enhanced)
• Explore agent: Strengthened READ-ONLY restrictions with explicit forbidden commands
• Prompt Hook execution: Fixed JSON format (added quotes around keys)
• Main system prompt: Added FEEDBACK_CHANNEL variable

2.0.40 – This version does not exist.

2.0.39 – This version does not exist.

2.0.38 – This version does not exist.

2.0.37

• NEW: Agent prompt: Prompt Hook execution
• Main system prompt: Changed isCodingRelated to keepCodingInstructions

2.0.36

• MCP CLI: Added mcp-cli read command for reading resources
• Main system prompt: Removed empty bullet point in "Doing tasks" section
• Skill tool: Updated examples to use skill: instead of command:
• SlashCommand tool: Removed "Intent Matching" section, simplified formatting

2.0.35

_{No changes to the system prompts in v2.0.35.}

2.0.34

• NEW: System prompt: MCP CLI instructions
• Main system prompt: Added "Asking questions as you work" section with ASKUSERQUESTION_TOOL_NAME
• Task tool: Added note about agents with "access to current context"
• Bash sandbox note: Added CONDITIONAL_NEWLINE_IF_SANDBOX_ENABLED variable

2.0.33

• Main system prompt: Removed extra blank lines

2.0.32

_{No changes to the system prompts in v2.0.32.}

2.0.31

_{No changes to the system prompts in v2.0.31.}

2.0.30

• NEW: Agent prompt: Update Magic Docs
• NEW: Tool description: LSP
• Main system prompt: Added security warning for OWASP top 10 vulnerabilities
• Plan mode reminder: Clarified AskUserQuestion tool usage
• ExitPlanMode tool: Added "Handling Ambiguity in Plans" section with example
• Bash sandbox note: Removed RESTRICTIONS_LIST and temp file instructions
• REMOVED: Agent prompt: Output style creation

2.0.29

• Task tool: Re-added runsInBackground property and AgentOutputTool usage note

2.0.28

• Main system prompt: Added "Avoid using over-the-top validation or excessive praise" guidance
• Plan mode reminder: Added NOTE_ABOUT_USING_PLAN_SUBAGENT variable
• Task tool: Removed runsInBackground property and background agent instructions

2.0.27

_{No changes to the system prompts in v2.0.27.}

2.0.26

• Bash sandbox note: Renamed dangerouslyOverrideSandbox to dangerouslyDisableSandbox

2.0.25

• Session notes template: Added "Session Title" section
• Session notes update instructions: Enhanced with multi-edit support and clearer structure preservation rules
• Bash tool: Removed note about not using run_in_background with 'sleep'

2.0.24

• NEW: Tool description: Bash (sandbox note)

2.0.23 – This version does not exist.

2.0.22

_{No changes to the system prompts in v2.0.22.}

2.0.21

• Plan mode reminder: Added NOTE_ABOUT_AskUserQuestion variable
• ExitPlanMode tool: Added NOTE_ABOUT_AskUserQuestion variables

2.0.20

• NEW: Tool description: Skill

2.0.19

_{No changes to the system prompts in v2.0.19.}

2.0.18

• Explore agent: Changed "Be thorough" guideline to "Adapt your search approach based on the thoroughness level specified by the caller"

2.0.17

• Main system prompt: Added critical instruction to use Task tool with Explore subagent for codebase exploration
• Main system prompt: Added examples for when to use Explore agent vs direct search
• Main system prompt: Added new variables (EXPLORE_AGENT, GLOB_TOOL_NAME, GREP_TOOL_NAME)

2.0.16 – This version does not exist.

2.0.15

• Updated ExitPlanMode tool description formatting (added "Examples" header)
• Minor punctuation fix in plan mode reminder

2.0.14

Initial comprehensive system prompts collection.

Agent Prompts:

• Agent creation architect
• Bash command file path extraction
• Bash command prefix detection
• Bash output summarization
• Claude.md creation
• Conversation summarization (with additional instructions variant)
• Explore agent
• Output style creation
• PR comments slash command
• Review PR slash command
• Security review slash command
• Session notes template and update instructions
• Session title generation
• Status line setup
• Task tool agent
• User sentiment analysis
• WebFetch summarizer

GitHub Integration:

• GitHub Actions workflow for @claude mentions
• GitHub Actions workflow for automated code review (beta)
• GitHub App installation PR description

System Prompts:

• Main system prompt
• Learning mode and learning mode insights
• Plan mode is active reminder

Tool Descriptions:

• Bash (with git commit and PR creation instructions)
• Edit
• ExitPlanMode
• Glob
• Grep
• NotebookEdit
• Read file
• SlashCommand
• Task (with async return note)
• TodoWrite
• WebFetch
• WebSearch
• Write