claude-code-system-prompts/CHANGELOG.md

Claude Code System Prompts Changelog

2.1.1

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

2.1.0

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

2.0.77

-128 tokens

• NEW: Agent Prompt: Task tool (extra notes) - additional notes for Task tool usage (absolute paths, no emojis, no colons before tool calls)
• NEW: Agent Prompt: Command execution specialist - agent prompt for command execution focusing on bash commands
• NEW: Agent Prompt: Plan verification agent - agent prompt for verifying that the main agent correctly executed a plan
• NEW: System Prompt: Chrome browser MCP tools - instructions for loading Chrome browser MCP tools via MCPSearch before use
• REMOVED: Data: GitHub Actions workflow for automated code review (beta) - GitHub Actions workflow template for automated Claude Code reviews
• REMOVED: Tool Description: Task (async return note) - message returned to the model when a subagent launched successfully
• Agent Prompt: Agent creation architect - updated examples from code-reviewer to test-runner agent
• Agent Prompt: Status line setup - added vim mode information (INSERT/NORMAL) to available session data
• System Prompt: Main system prompt - removed "Looking up your own documentation" section with claude-guide agent instructions; added instruction about not using colons before tool calls; numerous variable reference corrections throughout
• System Reminder: Plan mode is active - added verification section requirement in plan files; clarified that AskUserQuestion is for clarifying requirements, not for plan approval
• Tool Description: AskUserQuestion - added plan mode note clarifying this tool is for clarifying requirements before finalizing plans, not for requesting plan approval
• Tool Description: Bash - updated run_in_background parameter description to clarify notification behavior
• Tool Description: Bash (Git commit and PR creation instructions) - simplified parallel command instructions; removed "You can call multiple tools in a single response" preambles; added GIT_COMMAND_PARALLEL_NOTE variable
• Tool Description: ExitPlanMode v2 - reorganized "Handling Ambiguity in Plans" section into "Before Using This Tool"; added clarification that this tool inherently requests user approval
• Tool Description: Skill - reformatted instructions removing XML wrapper tags; added check for already-loaded skills
• Tool Description: Task - updated background agent output retrieval instructions (now uses output_file with Read/Write tools instead of AgentOutputTool); removed pro-only parallel launch note; updated example agent from code-reviewer to test-runner

2.0.76

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

2.0.75

-183 tokens

• REMOVED: Agent Prompt: Task tool (extra notes) - additional notes for Task tool usage (absolute paths, no emojis, no colons before tool calls)
• Main system prompt - removed instruction about not using colons before tool calls

2.0.74

-1693 tokens

• NEW: Agent Prompt: Session Search Assistant - agent prompt for finding relevant sessions based on user queries, with priority matching on tags, titles, branches, summaries, and transcripts
• REMOVED: Agent Prompt: Exit plan mode with swarm - instructions for launching swarm teammates when ExitPlanMode is called with isSwarm set to true
• REMOVED: System Reminder: Delegate mode prompt - system reminder for delegate mode with restricted tool access
• REMOVED: System Reminder: Team Coordination - system reminder for team coordination with teammate identity and resources
• REMOVED: Tool Description: TaskList - tool for listing all tasks in the task list
• REMOVED: Tool Description: TaskUpdate - tool for updating task status and adding comments
• REMOVED: Tool Description: TeammateTool's operation parameter - description of TeammateTool operations
• Tool Description: Bash (Git commit and PR creation instructions) - simplified pre-commit hook failure handling; removed detailed amend rules for auto-modified files, now just advises to fix and create a new commit

2.0.73

+91 tokens

• NEW: Agent Prompt: Prompt Suggestion Generator v2 - V2 instructions for generating prompt suggestions, focusing on predicting what the user would naturally type next
• REMOVED: Tool Description: SlashCommand - functionality merged into Skill tool
• Tool Description: Skill - added guidance for invoking skills via slash command syntax (e.g., "/commit"), added args parameter for passing arguments to skills
• Tool Description: LSP - added call hierarchy operations (prepareCallHierarchy, incomingCalls, outgoingCalls)
• Tool Description: TeammateTool's operation parameter - added team discovery and join operations (discoverTeams, requestJoin, approveJoin, rejectJoin)
• Main system prompt - terminology update: "slash commands" → "skills"; removed duplicate "complete tasks fully" instruction
• Agent Prompt: Claude guide agent - terminology update: "slash commands" → "skills"

2.0.72

+47 tokens

• Tool Description: Task - Added usage note requiring a short description (3-5 words) summarizing what the agent will do
• Tool Description: TaskUpdate - Added "Staleness" section with instruction to read task's latest state using TaskGet before updating

2.0.71

+948 tokens

• NEW: System Prompt: Claude in Chrome browser automation - instructions for using Claude in Chrome browser automation tools effectively
• NEW: Tool Description: Computer - main description for the Chrome browser computer automation tool
• NEW: Tool Description: Computer action parameter - description for the computer action parameter used with the Computer tool
• Tool Description: Bash (Git commit and PR creation instructions) - expanded amend safety rules with explicit conditions: (1) user requested OR hook auto-modified files, (2) HEAD was created by you, (3) not yet pushed; added critical warnings for rejected hooks and already-pushed commits; clarified hook failure vs auto-modification handling
• REMOVED: Agent Prompt: Prompt suggestion generator
• REMOVED: System Reminder: MCP CLI large output

2.0.70

+2283 tokens

• NEW: Agent Prompt: /review-pr slash command - system prompt for reviewing GitHub PRs with code analysis
• NEW: Agent Prompt: Task tool (extra notes) - additional notes for Task tool usage (absolute paths, no emojis, no colons before tool calls)
• NEW: System Reminder: Delegate mode prompt - system reminder for delegate mode with restricted tool access
• NEW: Tool Description: MCPSearch - tool for searching/selecting MCP tools before use (mandatory prerequisite)
• NEW: Tool Description: MCPSearch (with available tools) - MCPSearch variant that lists available MCP tools
• NEW: Tool Description: TaskList - tool for listing all tasks in the task list
• NEW: Tool Description: TeammateTool's operation parameter - description of TeammateTool operations (spawn, assignTask, claimTask, shutdown, etc.)
• Agent Prompt: Status line setup - Added current_usage object to context_window schema with input_tokens, output_tokens, cache_creation_input_tokens, and cache_read_input_tokens fields; added example for calculating context window percentage
• Tool Description: TaskUpdate - Added instruction to call TaskList after resolving a task; added note about teammates adding comments while working

2.0.69

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

2.0.68

-191 tokens

• Main system prompt: Added instruction to not use colons before tool calls ("Let me read the file." instead of "Let me read the file:")
• REMOVED: Agent Prompt: /review-pr slash command

2.0.67

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

2.0.66

+172 tokens

• NEW: System Prompt: Scratchpad directory - instructions for using a dedicated session-specific scratchpad directory for temporary files instead of /tmp

2.0.65

+97 tokens

• Agent Prompt: Status line setup - Added context_window object to status line data schema with total_input_tokens, total_output_tokens, and context_window_size fields
• LSP tool: Added goToImplementation operation; changed line/character documentation from 0-indexed to 1-based

2.0.64

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

2.0.63

+10 tokens

• Main system prompt: Added BUILD_TIME to config variables interpolation

2.0.62

+381 tokens

• NEW: AskUserQuestion tool description - includes guidance on recommending options by adding "(Recommended)" to labels
• Main system prompt: Added instruction to complete tasks fully without stopping mid-task or claiming context limits prevent completion
• EnterPlanMode tool: Major rewrite encouraging proactive use for non-trivial tasks; expanded "when to use" examples including new features and code modifications; shifted guidance from "err on implementation" to "err on planning"
• Skill tool: Added blocking requirement to invoke skill tool immediately as first action when relevant, before generating any other response
• Task tool: Added resume parameter documentation for continuing agents with preserved context; clarified agent ID return for follow-up work
• WebFetch tool: Simplified MCP tool preference note (removed "All MCP-provided tools start with mcp__")

2.0.61

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

2.0.60

+1339 tokens

• NEW: System Reminder: Team Coordination - instructions for team-based multi-agent workflows with team config, task list paths, and teammate messaging
• NEW: Agent Prompt: Exit plan mode with swarm - instructions for launching worker swarms when ExitPlanMode is called with isSwarm enabled
• Agent Prompt: Claude Code guide agent → renamed to Claude guide agent with expanded scope covering Claude Code, Claude Agent SDK, and Claude API (formerly Anthropic API)
• Task tool: Added run_in_background parameter documentation and TaskOutput tool usage for retrieving background agent results
• TaskUpdate tool: Major expansion with task ownership requirements, team coordination, claiming tasks, and detailed field documentation
• WebFetch tool: Added conditional instructions based on trusted domain status (simpler instructions for trusted domains)
• REMOVED: System Prompt: whenToUse note for claude-code-guide subagent (functionality merged into updated guide agent)

2.0.59

+140 tokens

• NEW: Added new TaskUpdate tool which allows Claude to update the task list.

2.0.58

+21 tokens

• Session notes template: Added new "Current State" section for tracking active work and pending tasks
• Session notes template: Renamed "User Corrections / Mistakes" to "Errors & Corrections" with expanded description
• Session notes instructions: Added emphasis on updating "Current State" for continuity after compaction
• Session notes instructions: Removed instruction about not repeating past session summaries
• Session notes instructions: Fixed markdown header reference ('##' → '#')
• Documentation URL: Changed from docs.claude.com/s/claude-code to code.claude.com/docs/en/overview
• GitHub Action templates: Updated CLI reference URL to code.claude.com/docs/en/cli-reference

2.0.57

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

2.0.56

-134 tokens

• 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