v2.0.50 (+465 tokens)

CHANGELOG.md

@@ -4,6 +4,15 @@ Note: Only use **NEW:** for entirely new prompt files, NOT for new additions/sec
 
 ### Claude Code System Prompts Changelog
 
+# [2.0.49](https://github.com/Piebald-AI/claude-code-system-prompts/commit/ec960fe987da2dfdb026f733fcd30120ac1a116e)
+
+- **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](https://github.com/Piebald-AI/claude-code-system-prompts/commit/62075a9489f7edb416970b9e67605c288ce562ac)
 
 - **NEW:** Agent prompt: Multi-Agent Planning Note - instructions for multi-agent planning when `CLAUDE_CODE_PLAN_V2_AGENT_COUNT` > 1
@@ -50,6 +59,12 @@ Note: Only use **NEW:** for entirely new prompt files, NOT for new additions/sec
 - 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](https://github.com/Piebald-AI/claude-code-system-prompts/commit/a6eb810)
 
 - **NEW:** Agent prompt: Prompt Hook execution
@@ -123,6 +138,8 @@ Note: Only use **NEW:** for entirely new prompt files, NOT for new additions/sec
 
 - **NEW:** Tool description: Bash (sandbox note)
 
+#### **2.0.23** – _This version does not exist._
+
 #### [2.0.22](https://github.com/Piebald-AI/claude-code-system-prompts/commit/f6910aa)
 
 <sub>_No changes to the system prompts in v2.0.22._</sub>
@@ -150,6 +167,8 @@ Note: Only use **NEW:** for entirely new prompt files, NOT for new additions/sec
 - 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** &ndash; _This version does not exist._
+
 # [2.0.15](https://github.com/Piebald-AI/claude-code-system-prompts/commit/ed40efa)
 
 - Updated `ExitPlanMode` tool description formatting (added "Examples" header)

README.md

@@ -1,6 +1,6 @@
 # Claude Code System Prompts
 
-This repository contains an up-to-date list of all Claude Code's various system prompts and their associated token counts as of **[Claude Code v2.0.49](https://www.npmjs.com/package/@anthropic-ai/claude-code/v/2.0.49) (November 20th, 2025).**  It also contains a [**CHANGELOG.md**](./CHANGELOG.md) for the system prompts across 30 versions since v2.0.14.
+This repository contains an up-to-date list of all Claude Code's various system prompts and their associated token counts as of **[Claude Code v2.0.50](https://www.npmjs.com/package/@anthropic-ai/claude-code/v/2.0.50) (November 21st, 2025).**  It also contains a [**CHANGELOG.md**](./CHANGELOG.md) for the system prompts across 31 versions since v2.0.14.
 
 Why multiple "system prompts?"
 
@@ -56,8 +56,8 @@ Sub-agents and utilities.
 - [Agent Prompt: Conversation summarization](./system-prompts/agent-prompt-conversation-summarization.md) (**1121** tks) - System prompt for creating detailed conversation summaries.
 - [Agent Prompt: Multi-Agent Planning Note](./system-prompts/agent-prompt-multi-agent-planning-note.md) (**324** tks) - Part of the Plan mode system reminder instructing the model how to use multiple agents to plan solutions.  Included only if the CLAUDE_CODE_PLAN_V2_AGENT_COUNT environment variable is set to a number greater than 1..
 - [Agent Prompt: Prompt Hook execution](./system-prompts/agent-prompt-prompt-hook-execution.md) (**134** tks) - Prompt given to Claude when acting evaluating whether to pass or fail a prompt hook..
-- [Agent Prompt: Session notes template](./system-prompts/agent-prompt-session-notes-template.md) (**226** tks) - Template structure for session notes tracking coding work and decisions.
-- [Agent Prompt: Session notes update instructions](./system-prompts/agent-prompt-session-notes-update-instructions.md) (**730** tks) - Instructions for updating session notes files during conversations.
+- [Agent Prompt: Session notes template](./system-prompts/agent-prompt-session-notes-template.md) (**260** tks) - Template structure for session notes tracking coding work and decisions.
+- [Agent Prompt: Session notes update instructions](./system-prompts/agent-prompt-session-notes-update-instructions.md) (**759** tks) - Instructions for updating session notes files during conversations.
 - [Agent Prompt: Session title and branch generation](./system-prompts/agent-prompt-session-title-and-branch-generation.md) (**333** tks) - System prompt for generating succinct titles and git branch names for coding sessions.
 - [Agent Prompt: Update Magic Docs](./system-prompts/agent-prompt-update-magic-docs.md) (**718** tks) - Prompt for the magic-docs agent..
 - [Agent Prompt: User sentiment analysis](./system-prompts/agent-prompt-user-sentiment-analysis.md) (**205** tks) - System prompt for analyzing user frustration and PR creation requests.
@@ -68,7 +68,7 @@ Sub-agents and utilities.
 
 Misc large strings.
 
-- [Data: GitHub Actions workflow for @claude mentions](./system-prompts/data-github-actions-workflow-for-@claude-mentions.md) (**531** tks) - GitHub Actions workflow template for triggering Claude Code via @claude mentions.
+- [Data: GitHub Actions workflow for @claude mentions](./system-prompts/data-github-actions-workflow-for-claude-mentions.md) (**531** tks) - GitHub Actions workflow template for triggering Claude Code via @claude mentions.
 - [Data: GitHub Actions workflow for automated code review (beta)](./system-prompts/data-github-actions-workflow-for-automated-code-review-beta.md) (**573** tks) - GitHub Actions workflow template for automated Claude Code reviews using direct_prompt.
 - [Data: GitHub App installation PR description](./system-prompts/data-github-app-installation-pr-description.md) (**424** tks) - Template for PR description when installing Claude Code GitHub App integration.
 -->
@@ -94,6 +94,7 @@ Text for large system reminders.
 - [System Reminder: Plan mode is active (for subagents)](./system-prompts/system-reminder-plan-mode-is-active-for-subagents.md) (**310** tks) - Simplified plan mode system reminder for sub agents.
 - [System Reminder: Plan mode is active](./system-prompts/system-reminder-plan-mode-is-active.md) (**242** tks) - System reminder sent to Claude when the user enters plan mode.
 - [System Reminder: Plan mode re-entry](./system-prompts/system-reminder-plan-mode-re-entry.md) (**194** tks) - System reminder sent when the user enters Plan mode after having previously exited it either via shift+tab or by approving Claude's plan..
+- [System Reminder: `mcp-cli` Large Output](./system-prompts/system-reminder-mcp-cli-large-output.md) (**265** tks) - System reminder sent when the output of an `mcp-cli read` or `mcp-cli call` command is greater than the MAX_MCP_OUTPUT_TOKENS environment variable (defaults to 25000).
 
 ### Builtin Tool Descriptions
 
@@ -111,7 +112,7 @@ Text for large system reminders.
 - [Tool Description: Task](./system-prompts/tool-description-task.md) (**1055** tks) - Tool description for launching specialized sub-agents to handle complex tasks.
 - [Tool Description: TodoWrite](./system-prompts/tool-description-todowrite.md) (**2167** tks) - Tool description for creating and managing task lists.
 - [Tool Description: WebFetch](./system-prompts/tool-description-webfetch.md) (**278** tks) - Tool description for web fetch functionality.
-- [Tool Description: WebSearch](./system-prompts/tool-description-websearch.md) (**166** tks) - Tool description for web search functionality.
+- [Tool Description: WebSearch](./system-prompts/tool-description-websearch.md) (**303** tks) - Tool description for web search functionality.
 - [Tool Description: Write](./system-prompts/tool-description-write.md) (**159** tks) - Tool description creating/overwriting writing individual files.
 
 **Additional notes for some Tool Desscriptions**

system-prompts/agent-prompt-session-notes-template.md

@@ -1,7 +1,7 @@
 <!--
 name: 'Agent Prompt: Session notes template'
 description: Template structure for session notes tracking coding work and decisions
-ccVersion: 2.0.25
+ccVersion: 2.0.50
 -->
 
 # Session Title
@@ -25,5 +25,8 @@ _What are the important system components? How do they work/fit together?_
 # Learnings
 _What has worked well? What has not? What to avoid? Do not duplicate items from other sections_
 
+# Key results
+_If the user asked a specific output such as an answer to a question, a table, or other document, repeat the exact result here_
+
 # Worklog
 _Step by step, what was attempted, done? Very terse summary for each step_

system-prompts/agent-prompt-session-notes-update-instructions.md

@@ -1,7 +1,7 @@
 <!--
 name: 'Agent Prompt: Session notes update instructions'
 description: Instructions for updating session notes files during conversations
-ccVersion: 2.0.25
+ccVersion: 2.0.50
 variables:
   - MAX_SECTION_TOKENS
 -->
@@ -26,6 +26,7 @@ CRITICAL RULES FOR EDITING:
 - Do NOT reference this note-taking process or instructions anywhere in the notes
 - It's OK to skip updating a section if there are no substantial new insights to add. Do not add filler content like "No info yet", just leave sections blank/unedited if appropriate.
 - Write DETAILED, INFO-DENSE content for each section - include specifics like file paths, function names, error messages, exact commands, technical details, etc.
+- For "Key results", include the complete, exact output the user requested (e.g., full table, full answer, etc.)
 - Do not include information that's already in the CLAUDE.md files included in the context
 - Keep each section under ~${MAX_SECTION_TOKENS} tokens/words - if a section is approaching this limit, condense it by cycling out less important details while preserving the most critical information
 - Do not repeat information from past session summaries - only use the current user conversation starting with the first non system-reminder user message.

system-prompts/system-reminder-mcp-cli-large-output.md

@@ -0,0 +1,18 @@
+<!--
+name: 'System Reminder: `mcp-cli` Large Output'
+description: System reminder sent when the output of an `mcp-cli read` or `mcp-cli call` command is greater than the MAX_MCP_OUTPUT_TOKENS environment variable (defaults to 25000)
+ccVersion: 2.0.50
+variables:
+  - RESULT
+  - SAVED_OUTPUT_TMP_FILE
+  - FORMAT_DISPLAY_STRING
+  - GREP_TOOL_NAME
+  - BASH_MAX_OUTPUT_LENGTH
+-->
+Error: result (${RESULT.length.toLocaleString()} characters) exceeds maximum allowed tokens. Output has been saved to ${SAVED_OUTPUT_TMP_FILE}.
+Format: ${FORMAT_DISPLAY_STRING}
+Use offset and limit parameters to read specific portions of the file, the ${GREP_TOOL_NAME} tool to search for specific content, and jq to make structured queries.
+REQUIREMENTS FOR SUMMARIZATION/ANALYSIS/REVIEW:
+- You MUST read the content from the file at ${SAVED_OUTPUT_TMP_FILE} in sequential chunks until 100% of the content has been read.
+- If you receive truncation warnings when reading the file ("[N lines truncated]"), reduce the chunk size until you have read 100% of the content without truncation ***DO NOT PROCEED UNTIL YOU HAVE DONE THIS***. Bash output is limited to ${BASH_MAX_OUTPUT_LENGTH().toLocaleString()} chars.
+- Before producing ANY summary or analysis, you MUST explicitly describe what portion of the content you have read. ***If you did not read the entire content, you MUST explicitly state this.***

system-prompts/tool-description-websearch.md

@@ -1,15 +1,27 @@
 <!--
 name: 'Tool Description: WebSearch'
 description: Tool description for web search functionality
-ccVersion: 2.0.14
+ccVersion: 2.0.50
 -->
 
 - Allows Claude to search the web and use the results to inform responses
 - Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks
+- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
 - Use this tool for accessing information beyond Claude's knowledge cutoff
 - Searches are performed automatically within a single API call
 
+CRITICAL REQUIREMENT - You MUST follow this:
+  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
+  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
+  - This is MANDATORY - never skip including sources in your response
+  - Example format:
+
+    [Your answer here]
+
+    Sources:
+    - [Source Title 1](https://example.com/1)
+    - [Source Title 2](https://example.com/2)
+
 Usage notes:
   - Domain filtering is supported to include or block specific websites
   - Web search is only available in the US

tools/updatePrompts.js

@@ -151,10 +151,8 @@ function nameToFilename(name) {
   // Convert to lowercase and replace special chars
   const filename = namePart
     .toLowerCase()
-    .replace(/\./g, '') // Remove dots
     .replace(/\s+/g, '-') // Spaces to hyphens
-    .replace(/[()]/g, '') // Remove parentheses
-    .replace(/\//g, '-') // Slashes to hyphens
+    .replace(/[^a-z0-9_-]/g, '') // Remove any char not a-z, 0-9, _, or -
     .replace(/-+/g, '-') // Collapse multiple hyphens
     .replace(/^-|-$/g, ''); // Trim hyphens from start/end