claude-code-system-prompts/CHANGELOG.md

Claude Code System Prompts Changelog

2.1.32

+2,323 tokens

• NEW: Agent Prompt: Recent Message Summarization - Agent prompt used for summarizing recent messages
• NEW: System Prompt: Action Suggestor for the Task Coordinator - System prompt used for suggesting actions to the task coordinator or team lead
• NEW: System Prompt: Agent Summary Generation - System prompt used for "Agent Summary" generation
• NEW: System Prompt: Skillify Current Session - System prompt for converting the current session into a skill
• System Prompt: Executing actions with care - Added guidance about lock files: investigate what process holds a lock file rather than deleting it
• System Prompt: Teammate Communication - Rebranded from "Teammate Communication" to "Agent Teammate Communication"; updated to reference SendMessage tool instead of Teammate tool; simplified and clarified communication instructions; reduced from 138 to 127 tokens
• System Reminder: Plan mode is active (iterative) - Updated guidance about using the Explore agent type, clarifying it's useful for parallelizing complex searches but direct tools are simpler for straightforward queries
• Tool Description: SendMessageTool - Updated terminology from "teammates in a swarm" to "agent teammates in a team"
• Tool Description: TeammateTool - Major refactoring: removed operations (discoverTeams, requestJoin, approveJoin, rejectJoin) and Environment Variables section; added "When to Use" and "Choosing Agent Types for Teammates" sections; added note about peer DM visibility in idle notifications; streamlined team workflow and coordination instructions; clarified that teammates should not send structured JSON status messages; reduced from 2393 to 1790 tokens

2.1.31

+693 tokens

• NEW: System Prompt: Agent memory instructions - Instructions for including domain-specific memory update guidance in agent system prompts (e.g., for code reviewers, test runners, architects)
• NEW: System Prompt: Censoring assistance with malicious activities - Guidelines for assisting with authorized security testing, defensive security, CTF challenges, and educational contexts while refusing malicious requests (previously removed in v2.1.20, now re-added)
• NEW: System Prompt: Tool permission mode - Guidance on tool permission modes and handling denied tool calls; advises not to re-attempt denied tool calls and to adjust approach instead
• NEW: System Reminder: Hook stopped continuation prefix - Prefix for hook stopped continuation messages
• NEW: Tool Description: ToolSearch extended - Extended usage instructions for ToolSearch moved to separate conditional prompt (query modes, examples, correct/incorrect usage patterns)
• REMOVED: Tool Description: TeammateTool operation parameter - Description of the operation parameter for the TeammateTool (removed)
• Tool Description: Task - Added conditional note about "Agent Teams" feature (TeammateTool, SendMessage, spawnTeam) not being available on certain plans; clarifies this limitation only applies when users explicitly ask for agent teams or peer-to-peer messaging
• Tool Description: ToolSearch - Refactored: moved extended content to separate ToolSearch extended prompt; simplified base description now references <available-deferred-tools> messages and conditionally includes extended content via identifier

2.1.30

+3,152 tokens

• NEW: System Prompt: Executing actions with care - Instructions for executing actions carefully
• NEW: System Prompt: Insights at a glance summary - Generates a concise 4-part summary (what's working, hindrances, quick wins, ambitious workflows) for the insights report
• NEW: System Prompt: Insights friction analysis - Analyzes aggregated usage data to identify friction patterns and categorize recurring issues
• NEW: System Prompt: Insights on the horizon - Identifies ambitious future workflows and opportunities for autonomous AI-assisted development
• NEW: System Prompt: Insights session facets extraction - Extracts structured facets (goal categories, satisfaction, friction) from a single Claude Code session transcript
• NEW: System Prompt: Insights suggestions - Generates actionable suggestions including CLAUDE.md additions, features to try, and usage patterns
• NEW: System Prompt: Parallel tool call note - System prompt for telling Claude to use parallel tool calls
• NEW: Tool Description: Sleep - Tool for waiting/sleeping with early wake capability on user input
• System Prompt: Accessing past sessions - Added tip to truncate search results to 64 characters per match to keep context manageable
• System Prompt: Hooks Configuration - Significantly restructured hook response format with new fields including suppressOutput, decision, reason, and hookSpecificOutput with event-specific parameters
• System Reminder: Plan mode is active (5-phase) - Added guidance to actively search for and reuse existing functions, utilities, and patterns, with emphasis on including references to found utilities in the plan
• System Reminder: Plan mode is active (iterative) - Added similar guidance about reusing existing code and including references to found utilities in the plan
• Tool Description: ReadFile - Added requirement to use pages parameter for large PDFs (more than 10 pages), with maximum 20 pages per request
• Tool Description: SendMessageTool - Restructured message types (removed nested "request" and "response" types), added required summary field for message and broadcast types, flattened protocol to use specific types like shutdown_request, shutdown_response, plan_approval_response
• Tool Description: Task - Restructured preamble section
• Tool Description: TeammateTool - Clarified that teammates go idle after every turn (not just when done), explained that idle teammates can still receive messages and will wake up to process them, and clarified that idle notifications are automatic and normal

2.1.29

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

2.1.28

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

2.1.27

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

2.1.26

+0 tokens

• Agent Prompt: Prompt Suggestion Generator (Stated Intent) - Increased maximum suggestion length from 2-8 words to 2-12 words
• Agent Prompt: Prompt Suggestion Generator v2 - Increased maximum suggestion length from 2-8 words to 2-12 words

2.1.25

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

2.1.23

-383 tokens

• NEW: System Reminder: /btw side question - System reminder for /btw slash command side questions without tools
• REMOVED: Agent Prompt: Exit plan mode with swarm - System reminder for when ExitPlanMode is called with isSwarm set to true
• System Prompt: Main system prompt - Removed trailing period after SECURITY_POLICY variable
• Tool Description: Skill - Simplified and streamlined: removed examples section, condensed important notes, changed from listing available skills inline to referencing system-reminder messages, updated variable references (FORMAT_SKILLS_AS_XML_FN → SKILL_TAG_NAME, removed LIMITED_COMMANDS)
• Tool Description: TeammateTool - Updated UI notification description: now shows "a brief notification with the sender's name" instead of "Queued teammate messages" when messages are waiting

2.1.22

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

2.1.21

+442 tokens

• NEW: System Prompt: Accessing past sessions - Instructions for searching past session data including memory summaries and transcript logs
• Tool Description: TeammateTool - Added guidance to prefer tasks in ID order (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones

2.1.20

-1,928 tokens

• NEW: System Prompt: Doing tasks - Instructions for performing software engineering tasks
• NEW: System Prompt: Task management - Instructions for using task management tools
• NEW: System Prompt: Tone and style - Guidelines for communication tone and response style
• NEW: System Prompt: Tool usage policy - Policies and guidelines for tool usage
• NEW: Tool Description: SendMessageTool - Tool for sending messages to teammates and handling protocol requests/responses in a swarm
• NEW: Tool Description: EnterPlanMode (ambiguous tasks) - Tool for entering plan mode when task has ambiguity
• REMOVED: System Prompt: Censoring assistance with malicious activities - Guidelines for assisting with authorized security testing
• REMOVED: System Reminder: Queued command (prompt) - Queued user message to address (prompt variant)
• REMOVED: System Reminder: Queued command - Queued user message to address
• REMOVED: System Reminder: Session memory - Past session summaries that may be relevant
• System Prompt: Main system prompt - Massively reduced from 2896 to 269 tokens; most content extracted into separate, focused system prompts (Doing tasks, Task management, Tone and style, Tool usage policy)
• Agent Prompt: Session title and branch generation - Changed output format from XML-style tags to JSON object with "title" and "branch" fields
• Agent Prompt: Bash command prefix detection - Changed from smart quotes to standard quotes
• Tool Description: TeammateTool - Removed protocol operations (approvePlan, rejectPlan, requestShutdown, approveShutdown, rejectShutdown, write, broadcast) and simplified to core team management operations
• Tool Description: TeammateTool operation parameter - Renamed from "TeammateTool's operation parameter" and condensed from 173 to 72 tokens
• Tool Description: Edit - Simplified by removing explicit read tool requirement from usage notes
• Tool Description: Write - Simplified by removing explicit read tool requirement from usage notes
• Tool Description: Bash (Git commit and PR creation instructions) - Added guidance to keep PR titles short (under 70 characters) and use description/body for details
• System Prompt: Tool execution denied - Streamlined wording
• Agent Prompt: Conversation summarization with additional instructions - Merged into base "Conversation summarization" prompt; additional instructions now added conditionally via code rather than as separate prompt string
• Agent Prompt: Prompt Hook execution - Shortened from 485 to 263 characters; removed verbose JSON formatting instructions

2.1.19

+182 tokens

• NEW: System Prompt: Tool Use Summary Generation - Prompt for generating summaries of tool usage
• REMOVED: Tool Description: TaskList - Description for the TaskList tool, which lists all tasks in the task list
• Agent Prompt: Status line setup - Added agent information (name and type) to the statusLine structure for agents started with --agent flag
• Tool Description: Skill - Updated wording from "Only use skills listed in 'Available skills' below" to "Skills listed below are available for invocation"
• Tool Description: TaskCreate - Added template variables for conditional notes and restructured task assignment instructions
• Tool Description: ToolSearch - Major expansion: reordered query modes (keyword search now first), clarified that both modes load tools immediately, added required keyword syntax with + prefix, expanded examples to show redundant selection patterns to avoid

2.1.18

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

2.1.17

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

2.1.16

+7,114 tokens

• NEW: Agent Prompt: Exit plan mode with swarm - System reminder for when ExitPlanMode is called with isSwarm set to true
• NEW: System Prompt: Teammate Communication - System prompt for teammate communication in swarm
• NEW: System Prompt: Tool execution denied - System prompt for when tool execution is denied
• NEW: System Reminder: Delegate mode prompt - System reminder for delegate mode
• NEW: System Reminder: Plan mode is active (5-phase) - Enhanced plan mode system reminder with parallel exploration and multi-agent planning
• NEW: System Reminder: Plan mode is active (iterative) - Iterative plan mode system reminder for main agent with user interviewing workflow
• NEW: System Reminder: Team Coordination - System reminder for team coordination
• NEW: System Reminder: Team Shutdown - System reminder for team shutdown
• NEW: Tool Description: TaskCreate - Tool description for TaskCreate tool
• NEW: Tool Description: TaskList - Description for the TaskList tool, which lists all tasks in the task list
• NEW: Tool Description: TeammateTool's operation parameter - Tool description for the TeammateTool's operation parameter
• NEW: Tool Description: TeammateTool - Tool description for the TeammateTool
• NEW: Tool Parameter: Computer action for Computer tool - Action parameter options for the Chrome browser computer tool (includes hover action and other actions)
• Agent Prompt: /security-review slash command - Renamed from "/security-review slash" for consistency
• System Prompt: Learning mode - Description metadata updated (removed "System Prompt:" prefix)
• System Reminder: Plan mode is active (subagent) - Renamed from "Plan mode is active (for subagents)" for consistency
• Tool Description: Bash (Git commit and PR creation instructions) - Added guidance to avoid using --no-edit flag with git rebase commands, as it is not a valid option for git rebase
• Tool Description: Write - Description clarified from "creating/overwriting writing individual files" to "for creating and overwriting individual files"

2.1.15

+183 tokens

• Tool Description: Bash (Git commit and PR creation instructions) - expanded Git Safety Protocol with specific list of destructive commands and added detailed explanation about potential data loss; clarified that --amend should be avoided after pre-commit hook failures; added guidance to prefer staging specific files by name rather than using "git add -A" or "git add ." to avoid accidentally including sensitive files (.env, credentials) or large binaries
• Tool Description: Task - updated background agent output retrieval instructions from using TaskOutput tool to reading output_file path with Read tool or using Bash with tail to see recent output; added conditional note about run_in_background, name, team_name, and mode parameters not being available in certain contexts

2.1.14

-1,153 tokens

• NEW: Agent Prompt: Prompt Suggestion Generator (Stated Intent) - instructions for generating prompt suggestions based on user's explicitly stated next steps
• NEW: Tool Description: ToolSearch - renamed from MCPSearch; tool description for loading and searching deferred tools before use
• REMOVED: Tool Description: ExitPlanMode v2 and ExitPlanMode v2 (security notes) - consolidated functionality into base ExitPlanMode
• REMOVED: Tool Description: MCPSearch and MCPSearch (with available tools) - replaced by ToolSearch
• Tool Description: ExitPlanMode - added "How This Tool Works" section explaining plan file workflow; clarified that tool reads from plan file rather than taking plan as parameter; simplified "Handling Ambiguity in Plans" section to "Before Using This Tool" with clearer guidance on when to use AskUserQuestion; removed variable references in favor of direct tool names
• Tool Description: Bash - clarified session persistence behavior: "Working directory persists between commands; shell state (everything else) does not. The shell environment is initialized from the user's profile (bash or zsh)"
• Tool Description: WebFetch - added guidance to prefer gh CLI via Bash for GitHub URLs (e.g., gh pr view, gh issue view, gh api)
• System Prompt: Chrome browser MCP tools - updated to reference ToolSearch instead of MCPSearch

2.1.12

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

2.1.11

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

2.1.10

-118 tokens

• Agent Prompt: Session title and branch generation - added explicit instruction to use sentence case for titles (capitalize only the first word and proper nouns), not Title Case
• Tool Description: Bash (Git commit and PR creation instructions) - simplified git commit --amend guidance by removing complex conditional rules (5 conditions about when amending is allowed); replaced with simpler CRITICAL directive to always create new commits and never use --amend unless user explicitly requests it; removed reference to "amend rules above" in pre-commit hook failure step

2.1.9

+963 tokens

• NEW: System Prompt: Hooks Configuration - system prompt for hooks configuration, used for Claude Code config skill
• REMOVED: System Prompt: Autonomous agent (standalone) - standalone autonomous agent mode prompt without system context prefix
• REMOVED: System Prompt: Autonomous agent (with context) - autonomous agent mode prompt prefixed with main system prompt
• System Prompt: Main system prompt - renamed "Planning without timelines" section to "No time estimates"; expanded guidance to explicitly prohibit giving time estimates for Claude's own work (e.g., "this will take me a few minutes," "should be done in about 5 minutes," "this is a quick fix") in addition to existing prohibition on suggesting project timelines; added emphasis that users should judge timing themselves

2.1.8

-101 tokens

• System Reminder: Plan mode is active - extracted inline plan file info section into separate, new section; converted hardcoded phase numbers (2-5) to dynamic variables for conditional user interview phase; replaced user interview guidance with a new phase explicitly for user interview
• Tool Description: WebSearch - updated year example to use the current year instead of hardcoded year value

2.1.7

+74 tokens

• NEW: Tool Description: ExitPlanMode v2 (security notes) - security guidelines for scoping permissions when using the ExitPlanMode tool
• System Prompt: Claude in Chrome browser automation - added IMPORTANT emphasis to alerts and dialogs warning about blocking browser events
• System Reminder: Plan mode is active - clarified that plan approval questions (e.g., "Is this plan okay?", "Should I proceed?") must use ExitPlanMode tool, not text questions or AskUserQuestion; expanded guidance distinguishing when to use AskUserQuestion (only for requirements/approach clarification) vs ExitPlanMode (for plan approval)
• Tool Description: ExitPlanMode v2 - extracted detailed security and permission scoping guidelines to new PERMISSION_SCOPING_GUIDELINES variable; replaced inline scoping instructions with variable reference; updated tool name references from ASK_USER_QUESTION_TOOL_NAME to PERMISSION_SCOPING_GUIDELINES in "Before Using This Tool" and "Important" sections

2.1.6

+742 tokens

• NEW: System Prompt: Autonomous agent (standalone) - standalone autonomous agent mode prompt without system context prefix
• NEW: System Prompt: Autonomous agent (with context) - autonomous agent mode prompt prefixed with main system prompt
• REMOVED: Agent Prompt: Bash command explainer - removed in favor of integrated bash command explanation
• Agent Prompt: Status line setup - added pre-calculated used_percentage and remaining_percentage fields to context_window object; updated examples to use simpler syntax for displaying context usage
• Agent Prompt: Claude guide agent - fixed incorrect variable references in documentation source URLs and tool names throughout approach steps
• Agent Prompt: Session Search Assistant - simplified introduction text
• Tool Description: Bash - refactored variable usage, replacing BASH_TOOL_NAME with RUN_IN_BACKGROUND_NOTE
• Tool Description: ExitPlanMode v2 - added comprehensive "Requesting Permissions (allowedPrompts)" section with guidelines for requesting prompt-based permissions for bash commands, including security-conscious scoping practices

2.1.5

-24 tokens

• Tool Description: Bash - replaced GIT_COMMIT_AND_PR_CREATION_INSTRUCTION variable with BASH_TOOL_NAME variable in metadata
• Tool Description: Task - reordered variable declarations, moving IS_TRUTHY_FN and PROCESS_OBJECT earlier in the list

2.1.4

-19 tokens

• Tool Description: Bash - moved run_in_background parameter documentation to new BASH_BACKGROUND_TASK_NOTES_FN function variable; added BASH_TOOL_EXTRA_NOTES() placeholder; fixed misaligned variable references in dedicated tools list (file search, content search, read files, edit files, write files were each referencing the wrong tool name)
• Tool Description: Task - added IS_TRUTHY_FN and PROCESS_OBJECT variables for conditional rendering; background task instructions now conditionally rendered based on CLAUDE_CODE_DISABLE_BACKGROUND_TASKS environment variable

2.1.3

+1,047 tokens

• NEW: Agent Prompt: Bash command description writer - instructions for generating clear, concise command descriptions in active voice for bash commands
• NEW: Agent Prompt: Bash command explainer - instructions for explaining bash commands with reasoning, risk assessment, and risk level classification
• NEW: Agent Prompt: Remember skill - system prompt for the /remember skill that reviews session memories and updates CLAUDE.local.md with recurring patterns and learnings
• REMOVED: Agent Prompt: Bash command risk classifier - replaced with the new bash command explainer agent
• Tool Description: Bash - updated description field instructions to provide more context for complex commands (piped commands, obscure flags, etc.) while keeping simple commands brief
• Tool Description: Bash (Git commit and PR creation instructions) - added warning to never use git status -uall flag as it can cause memory issues on large repos
• Tool Description: Task - updated internal variable references and improved background agent monitoring instructions

2.1.2

-374 tokens

• NEW: Agent Prompt: Bash command risk classifier - classifies shell commands by risk level (LOW/MEDIUM/HIGH) to determine permission requirements
• REMOVED: Agent Prompt: Bash output summarization - system prompt for determining whether bash command output should be summarized
• REMOVED: Agent Prompt: Plan verification agent - agent prompt for verifying that the main agent correctly executed a plan

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