v2.0.59 (+140 tokens)

CHANGELOG.md

@@ -4,6 +4,31 @@ Note: Only use **NEW:** for entirely new prompt files, NOT for new additions/sec
 
 ### Claude Code System Prompts Changelog
 
+# [2.0.58](https://github.com/Piebald-AI/claude-code-system-prompts/commit/d1437449dddae84e888f4751e18add2e6153e135)
+
+- 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](https://github.com/Piebald-AI/claude-code-system-prompts/commit/8b2ecb38493daf677fcba54746d2c3e40de6f657)
+
+<sub>_No changes to the system prompts in v2.0.57._</sub>
+
+# [2.0.56](https://github.com/Piebald-AI/claude-code-system-prompts/commit/47571b6ad6110bebc89553bba49ebcf94f4605fc)
+
+- 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](https://github.com/Piebald-AI/claude-code-system-prompts/commit/5c2f24217280a6c0a0b0ae5f80ba7f195e874ed0)
 
 _+121 tokens_

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.56](https://www.npmjs.com/package/@anthropic-ai/claude-code/v/2.0.56) (December 1st, 2025).**  It also contains a [**CHANGELOG.md**](./CHANGELOG.md) for the system prompts across 37 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.59](https://www.npmjs.com/package/@anthropic-ai/claude-code/v/2.0.59) (December 4th, 2025).**  It also contains a [**CHANGELOG.md**](./CHANGELOG.md) for the system prompts across 40 versions since v2.0.14.
 
 Why multiple "system prompts?"
 
@@ -57,8 +57,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: 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: Prompt Suggestion Generator](./system-prompts/agent-prompt-prompt-suggestion-generator.md) (**143** tks) - Prompt for generating suggestions for the user input after Claude responds..
-- [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 template](./system-prompts/agent-prompt-session-notes-template.md) (**292** 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 notes update instructions](./system-prompts/agent-prompt-session-notes-update-instructions.md) (**756** 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.
@@ -69,8 +69,8 @@ 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) (**527** 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 Actions workflow for automated code review (beta)](./system-prompts/data-github-actions-workflow-for-automated-code-review-beta.md) (**569** 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.
 -->
 
@@ -110,6 +110,7 @@ Text for large system reminders.
 - [Tool Description: ReadFile](./system-prompts/tool-description-readfile.md) (**439** tks) - Tool description for reading files.
 - [Tool Description: Skill](./system-prompts/tool-description-skill.md) (**279** tks) - Tool description for executing skills in the main conversation.
 - [Tool Description: SlashCommand](./system-prompts/tool-description-slashcommand.md) (**355** tks) - Tool description for executing slash commands.
+- [Tool Description: TaskUpdate](./system-prompts/tool-description-taskupdate.md) (**140** tks) - Description for the TaskUpdate tool, which updates Claude's task list.
 - [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.

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

@@ -1,12 +1,15 @@
 <!--
 name: 'Agent Prompt: Session notes template'
 description: Template structure for session notes tracking coding work and decisions
-ccVersion: 2.0.50
+ccVersion: 2.0.58
 -->
 
 # Session Title
 _A short and distinctive 5-10 word descriptive title for the session. Super info dense, no filler_
 
+# Current State
+_What is actively being worked on right now? Pending tasks not yet completed. Immediate next steps._
+
 # Task specification
 _What did the user ask to build? Any design decisions or other explanatory context_
 
@@ -16,8 +19,8 @@ _What are the important files? In short, what do they contain and why are they r
 # Workflow
 _What bash commands are usually run and in what order? How to interpret their output if not obvious?_
 
-# User Corrections / Mistakes
+# Errors & Corrections
-_What did the user correct Assistant about? What did not work and should not be tried again?_
+_Errors encountered and how they were fixed. What did the user correct? What approaches failed and should not be tried again?_
 
 # Codebase and System Documentation
 _What are the important system components? How do they work/fit together?_

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.50
+ccVersion: 2.0.58
 variables:
   - MAX_SECTION_TOKENS
 -->
@@ -18,7 +18,7 @@ Your ONLY task is to use the Edit tool to update the notes file, then stop. You
 
 CRITICAL RULES FOR EDITING:
 - The file must maintain its exact structure with all sections, headers, and italic descriptions intact
--- NEVER modify, delete, or add section headers (the lines starting with '##' like ## Task specification)
+-- NEVER modify, delete, or add section headers (the lines starting with '#' like # Task specification)
 -- NEVER modify or delete the italic _section description_ lines (these are the lines in italics immediately following each header - they start and end with underscores)
 -- The italic _section descriptions_ are TEMPLATE INSTRUCTIONS that must be preserved exactly as-is - they guide what content belongs in each section
 -- ONLY update the actual content that appears BELOW the italic _section descriptions_ within each existing section
@@ -29,8 +29,8 @@ CRITICAL RULES FOR EDITING:
 - 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.
 - Focus on actionable, specific information that would help someone understand or recreate the work discussed in the conversation
+- IMPORTANT: Always update "Current State" to reflect the most recent work - this is critical for continuity after compaction
 
 Use the Edit tool with file_path: {{notesPath}}
 

system-prompts/data-github-actions-workflow-for-automated-code-review-beta.md

@@ -1,7 +1,7 @@
 <!--
 name: 'Data: GitHub Actions workflow for automated code review (beta)'
 description: GitHub Actions workflow template for automated Claude Code reviews using direct_prompt
-ccVersion: 2.0.14
+ccVersion: 2.0.58
 -->
 name: Claude Code Review
 
@@ -57,6 +57,6 @@ jobs:
             Use \`gh pr comment\` with your Bash tool to leave your review as a comment on the PR.
 
           # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # or https://code.claude.com/docs/en/cli-reference for available options
           claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
 

system-prompts/data-github-actions-workflow-for-claude-mentions.md

@@ -1,7 +1,7 @@
 <!--
 name: 'Data: GitHub Actions workflow for @claude mentions'
 description: GitHub Actions workflow template for triggering Claude Code via @claude mentions
-ccVersion: 2.0.14
+ccVersion: 2.0.58
 -->
 name: Claude Code
 
@@ -50,6 +50,6 @@ jobs:
 
           # Optional: Add claude_args to customize behavior and configuration
           # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # or https://code.claude.com/docs/en/cli-reference for available options
           # claude_args: '--allowed-tools Bash(gh pr:*)'
 

system-prompts/system-prompt-main-system-prompt.md

@@ -1,7 +1,7 @@
 <!--
 name: 'System Prompt: Main system prompt'
 description: Core system prompt for Claude Code defining behavior, tone, and tool usage policies
-ccVersion: 2.0.56
+ccVersion: 2.0.58
 variables:
   - OUTPUT_STYLE_CONFIG
   - SECURITY_POLICY
@@ -30,7 +30,7 @@ IMPORTANT: You must NEVER generate or guess URLs for the user unless you are con
 
 If the user asks for help or wants to give feedback inform them of the following:
 - /help: Get help with using Claude Code
-- To give feedback, users should ${{ISSUES_EXPLAINER:"report the issue at https://github.com/anthropics/claude-code/issues",PACKAGE_URL:"@anthropic-ai/claude-code",README_URL:"https://docs.claude.com/s/claude-code",VERSION:"<<CCVERSION>>",FEEDBACK_CHANNEL:"https://github.com/anthropics/claude-code/issues"}.ISSUES_EXPLAINER}
+- To give feedback, users should ${{ISSUES_EXPLAINER:"report the issue at https://github.com/anthropics/claude-code/issues",PACKAGE_URL:"@anthropic-ai/claude-code",README_URL:"https://code.claude.com/docs/en/overview",VERSION:"<<CCVERSION>>",FEEDBACK_CHANNEL:"https://github.com/anthropics/claude-code/issues"}.ISSUES_EXPLAINER}
 
 # Looking up your own documentation:
 

system-prompts/tool-description-taskupdate.md

@@ -0,0 +1,18 @@
+<!--
+name: 'Tool Description: TaskUpdate'
+description: Description for the TaskUpdate tool, which updates Claude's task list
+ccVersion: 2.0.59
+-->
+Use this tool to update a task in the task list.
+
+You can update any combination of:
+- subject: Change the task title
+- description: Change the task description
+- status: Change to 'open' or 'resolved'
+- owner: Assign or change the task owner
+- addComment: Add a comment with author and content
+- addReferences: Link to other tasks (bidirectional)
+- addBlocks: Mark that this task blocks other tasks
+- addBlockedBy: Mark that this task is blocked by other tasks
+
+All fields are optional - only provide the fields you want to update.