diff --git a/README.md b/README.md index ccf7c8c..d88d702 100644 --- a/README.md +++ b/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 31 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. @@ -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** diff --git a/system-prompts/agent-prompt-session-notes-template.md b/system-prompts/agent-prompt-session-notes-template.md index 0c62400..a2fed82 100644 --- a/system-prompts/agent-prompt-session-notes-template.md +++ b/system-prompts/agent-prompt-session-notes-template.md @@ -1,7 +1,7 @@ # 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_ diff --git a/system-prompts/agent-prompt-session-notes-update-instructions.md b/system-prompts/agent-prompt-session-notes-update-instructions.md index ce5aa3c..e0a38ed 100644 --- a/system-prompts/agent-prompt-session-notes-update-instructions.md +++ b/system-prompts/agent-prompt-session-notes-update-instructions.md @@ -1,7 +1,7 @@ @@ -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. diff --git a/system-prompts/system-reminder-mcp-cli-large-output.md b/system-prompts/system-reminder-mcp-cli-large-output.md new file mode 100644 index 0000000..de99152 --- /dev/null +++ b/system-prompts/system-reminder-mcp-cli-large-output.md @@ -0,0 +1,18 @@ + +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.*** diff --git a/system-prompts/tool-description-websearch.md b/system-prompts/tool-description-websearch.md index 739bab6..2228cc4 100644 --- a/system-prompts/tool-description-websearch.md +++ b/system-prompts/tool-description-websearch.md @@ -1,15 +1,27 @@ - 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