Skip to content
/

Claude Code System Prompts

claude-code-system-prompts · Piebald-AI/claude-code-system-prompts · ★ 11k · last commit 2026-05-23

Primitive shape
No installable primitives
00

Summary

Claude Code System Prompts — Summary

claude-code-system-prompts by Piebald AI is a reverse-engineering reference repository that extracts and publishes all of Claude Code's internal system prompts, tool descriptions, agent prompts, and system reminders — updated within minutes of each Claude Code release, tracking 187+ versions since v2.0.14. At Claude Code v2.1.150 (May 22, 2026), the repo documents 220+ named prompt strings grouped into: Agent Prompts (general-purpose, plan mode, explore, code review 8-part series), Data files (API references, managed agents docs), Skills (35+ skill definitions), System Prompts (60+ behavioral instructions), System Reminders (40+ context-injection messages), and Tool Descriptions (75+ tool parameter specs). The companion product is tweakcc — a tool that patches users' local Claude Code installations with custom versions of individual system prompt strings. The project is published by Piebald AI, which also ships a commercial IDE product (Piebald).

Differs from seeds: This is a unique archetype not represented in the 11 seeds — a system-prompt observatory rather than a user-facing framework. It ships zero runnable Claude Code primitives (no commands, skills, hooks, MCP servers) and has no user workflow. Its value is entirely informational: showing what Claude Code's internal instructions look like, enabling security research, prompt tuning, and the tweakcc patching tool. Closest architectural analog might be ccmemory (infrastructure-level tool) but the purpose is documentation not augmentation.

01

Overview

Claude Code System Prompts — Overview

Origin

Published by Piebald AI (https://piebald.ai/), a commercial IDE company built on top of Claude Code. 10,516 stars, MIT license. Updated within minutes of each Claude Code release since v2.0.14 (187+ versions tracked).

Mission (verbatim)

"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.1.150 (May 22nd, 2026). It also contains a CHANGELOG.md for the system prompts across 187 versions since v2.0.14."

"Claude Code doesn't just have one single string for its system prompt. Instead, there are: Large portions conditionally added depending on the environment and various configs. Descriptions for builtin tools like Write, Bash, and TodoWrite... Separate system prompts for builtin agents like Explore and Plan. Numerous AI-powered utility functions... The result — 110+ strings that are constantly changing and moving within a very large minified JS file."

Companion product: tweakcc

"Want to modify a particular piece of the system prompt in your own Claude Code installation? Use tweakcc. It lets you customize the individual pieces of the system prompt as markdown files, then patches your npm-based or native (binary) Claude Code installation with them, and also provides diffing and conflict management for when both you and Anthropic have conflicting modifications to the same prompt file."

Extraction method

"This repository contains the system prompts extracted using a script from the latest npm version of Claude Code. As they're extracted directly from Claude Code's compiled source code, they're guaranteed to be exactly what Claude Code uses."

Strategic value

  • Security research into Claude Code's internal behavioral constraints
  • Understanding what Anthropic's instructions look like at production scale
  • Prompt engineering reference: real production instructions from Anthropic
  • Identifying changes between CC versions (CHANGELOG.md tracks all prompt diffs)
02

Architecture

Claude Code System Prompts — Architecture

Distribution

  • GitHub repository — pure reference documentation
  • No npm package, no CLI tool (tweakcc is a separate repository)

Directory structure

.
├── README.md
├── CHANGELOG.md          (187+ version prompt diffs)
├── CLAUDE.md
├── LICENSE               (MIT)
├── system-prompts/       (220+ extracted prompt files)
│   ├── agent-prompt-*.md         (agent system prompts)
│   ├── data-*.md                 (reference data bundled in CC)
│   ├── skill-*.md                (skill definitions)
│   ├── system-prompt-*.md        (core behavioral instructions)
│   ├── system-reminder-*.md      (context-injection messages)
│   ├── tool-description-*.md     (tool parameter descriptions)
│   └── tool-parameter-*.md       (tool parameter schemas)
└── tools/                (extraction utilities — not public)

Naming convention

Each file is named <category>-<kebab-description>.md with embedded HTML comment metadata:

<!--
name: 'Agent Prompt: General purpose'
description: ...
ccVersion: 2.1.86
agentMetadata:
  agentType: 'general-purpose'
  tools: [*]
  whenToUse: >
    General-purpose agent for researching...
-->

Target audience

  • Security researchers
  • Claude Code power users
  • Prompt engineers
  • Piebald IDE users
  • tweakcc users wanting to customize CC behavior

Runtime requirements

None — read-only reference.

03

Components

Claude Code System Prompts — Components

No runnable primitives

0 commands, 0 skills, 0 agents, 0 hooks, 0 MCP servers.

Extracted prompt categories (220+ files)

Agent Prompts (30+)

Name Tokens Purpose
agent-prompt-general-purpose.md unknown General-purpose subagent (search, analyze, edit)
agent-prompt-explore.md 575 Explore subagent
agent-prompt-plan-mode-enhanced.md 715 Plan mode subagent
agent-prompt-code-review-part-1-*.md through part-8-*.md various 8-part code review pipeline
agent-prompt-quick-git-commit.md unknown Git commit automation
agent-prompt-quick-pr-creation.md unknown PR creation
agent-prompt-worker-fork.md unknown Worker subagent
agent-prompt-workflow-subagent-plain-text-output.md unknown Workflow subagent
agent-prompt-security-monitor-*.md (2 parts) unknown Security monitoring
agent-prompt-batch-slash-command.md unknown Batch command execution
agent-prompt-dream-memory-*.md (2) unknown Memory consolidation/pruning

Data Files (20+)

Reference documentation bundled into Claude Code (Claude API references in 8 languages, managed agents docs, tool use concepts, etc.)

Skills (35+)

Notable Skills
skill-agent-design-patterns.md
skill-create-verifier-skills.md
skill-debugging.md
skill-dream-memory-consolidation.md
skill-dynamic-pacing-loop-execution.md
skill-generate-permission-allowlist-from-transcripts.md
skill-loop-slash-command.md
skill-model-migration-guide.md
skill-morning-checkin-daily-brief.md
skill-run-app.md
skill-run-browser-driven-web-app-example.md
skill-verify-skill.md

System Prompts (60+)

Core behavioral instructions: communication style, memory instructions, security, subagent delegation, tool usage policy, auto mode, minimal mode, harness instructions, etc.

System Reminders (40+)

Context-injection messages: session continuation, plan mode active, memory file contents, hook events, compact file reference, etc.

Tool Descriptions (75+)

Parameter schemas and usage instructions for: Bash, Edit, Write, Read, Grep, Task, TodoWrite, WebFetch, WebSearch, MCP tools, etc.

05

Prompts

Claude Code System Prompts — Prompts

These are Anthropic's actual internal prompts, not user-written ones.

Prompt 1: General-purpose subagent (from system-prompts/agent-prompt-general-purpose.md)

Source: system-prompts/agent-prompt-general-purpose.md (extracted from CC v2.1.86)

Technique: Strengths-based capability framing + minimal-footprint principle

<!--
name: 'Agent Prompt: General purpose'
agentType: 'general-purpose'
tools: [*]
whenToUse: >
  General-purpose agent for researching complex questions, searching for code, and executing
  multi-step tasks. When you are searching for a keyword or file and are not confident that you
  will find the right match in the first few tries use this agent to perform the search for you.
-->

${"You are an agent for Claude Code, Anthropic's official CLI for Claude. Given the user's message, you should use the tools available to complete the task. Complete the task fully—don't gold-plate, but don't leave it half-done."}

${`Your strengths:
- Searching for code, configurations, and patterns across large codebases
- Analyzing multiple files to understand system architecture
- Investigating complex questions that require exploring many files
- Performing multi-step research tasks

Guidelines:
- NEVER create files unless they're absolutely necessary for achieving your goal.
- ALWAYS prefer editing an existing file to creating a new one.
- NEVER proactively create documentation files (*.md) or README files.`}

Key: Uses JavaScript template literal interpolation (${}) in the extracted prompt — revealing that CC's prompt system dynamically composes from multiple string fragments.


Prompt 2: Communication style system prompt (from system-prompts/system-prompt-communication-style.md)

Source: system-prompts/system-prompt-communication-style.md (extracted from CC v2.1.104)

Technique: Behavioral anti-pattern elimination + output format constraints

# Text output (does not apply to tool calls)
Assume users can't see most tool calls or thinking — only your text output. Before your first tool call, state in one sentence what you're about to do. While working, give short updates at key moments: when you find something, when you change direction, or when you hit a blocker. Brief is good — silent is not. One sentence per update is almost always enough.

Don't narrate your internal deliberation. User-facing text should be relevant communication to the user, not a running commentary on your thought process.

End-of-turn summary: one or two sentences. What changed and what's next. Nothing else.

In code: default to writing no comments. Never write multi-paragraph docstrings or multi-line comment blocks — one short line max.

Key design: Anthropic directly instructs Claude to be minimally verbose — the opposite of the verbose-CLAUDE.md pattern many community frameworks use.

09

Uniqueness

Claude Code System Prompts — Uniqueness

Differs from seeds

No seed framework matches this archetype. This is the only system-prompt observatory in the corpus — a reverse-engineering reference repository, not a user workflow framework. The closest structural analog is ccmemory (infrastructure-level tool), but ccmemory augments CC behavior while claude-code-system-prompts only documents it. The 8-part code review pipeline extraction reveals that Anthropic has already built a sophisticated multi-stage review system internally — which many community frameworks are unknowingly re-implementing. The CHANGELOG.md tracking 187 versions of prompt evolution is unprecedented in this batch.

Positioning

A forensic tool for advanced Claude Code users, security researchers, and framework builders who want to understand what Anthropic actually ships. The companion tweakcc product enables surgical modification of CC's internal behavior — more powerful than any CLAUDE.md convention.

Strategic insight for the catalog

This repo reveals that Anthropic's own internal CC system uses:

  • Sequential multi-agent code review (8-stage pipeline)
  • Dream memory consolidation/pruning
  • Dynamic pacing for loop execution
  • Structured vs plain-text subagent output variants
  • Security monitoring subagents (2-part)
  • Permission allowlist generation from transcripts

These are capabilities that community frameworks attempt to approximate but Anthropic has already formalized internally.

Observable failure modes

  1. Legal gray area: Extracting and publishing proprietary compiled code's internal strings. Anthropic has not objected publicly but could.
  2. Stale cache risk: 187 tracked versions suggests prompts change every few days; any downstream user of the prompts must re-fetch frequently.
  3. Commercial framing: The prominent Piebald advertisement may signal that the reference repo is primarily a lead-generation tool.
  4. Template literal interpolation: The ${} syntax in extracted prompts shows these are code-interpolated strings, not static text — the published versions may lack runtime-injected context variables.
04

Workflow

Claude Code System Prompts — Workflow

No user workflow enforced

This is a reference repository, not a workflow framework.

Maintenance workflow

  1. New Claude Code npm version releases
  2. Extraction script runs (automated/manual) against compiled CC source
  3. Prompt files updated in system-prompts/
  4. CHANGELOG.md updated with version diff
  5. GitHub Release created (triggers star notifications)

Consumer workflow (using the reference)

  1. Browse system-prompts/ directory to understand CC behavior
  2. Cross-reference CHANGELOG.md to understand what changed between CC versions
  3. Use tweakcc (separate repo) to patch local CC installation with customized prompt strings

No approval gates, no automation.

06

Memory Context

Claude Code System Prompts — Memory & Context

No user-level memory or context management. The repository documents Anthropic's internal memory mechanisms:

Memory mechanisms documented

From system-prompts/system-prompt-memory-instructions.md and related files:

  • skill-dream-memory-consolidation.md — CC's internal memory synthesis process
  • system-prompt-dream-claudemd-memory-reconciliation.md — CLAUDE.md memory reconciliation
  • system-prompt-agent-memory-instructions.md — agent-level memory instructions
  • system-reminder-memory-file-contents.md — how memory files are injected

Cross-session state

CHANGELOG.md and GitHub Releases serve as the version history "memory" of the repository.

07

Orchestration

Claude Code System Prompts — Orchestration

No orchestration. This is a reference repository.

What the prompts reveal about CC orchestration

The extracted prompts document Claude Code's internal orchestration:

  • agent-prompt-workflow-subagent-plain-text-output.md + ...-structured-output.md — CC uses two subagent variants
  • agent-prompt-worker-fork.md — worker subagent spawning
  • system-prompt-subagent-delegation-examples.md — CC's own delegation guidance
  • system-prompt-writing-subagent-prompts.md — how CC writes prompts for subagents
  • system-reminder-task-tools-reminder.md — Task tool usage reminders

The 8-part code review pipeline (agent-prompt-code-review-part-1-*.md through part-8) reveals CC's internal sequential multi-agent code review process.

08

Ui Cli Surface

Claude Code System Prompts — UI & CLI Surface

Dedicated CLI

None (tweakcc is a companion tool in a separate repo).

Local UI

None.

Companion product: Piebald IDE

The README.md prominently advertises Piebald (https://piebald.ai/), described as "the ultimate agentic AI developer experience" — a commercial IDE product from the same team. Screenshot and Discord/X links included. This repo is a marketing surface for Piebald as much as a technical reference.

GitHub Releases

Each Claude Code version is published as a GitHub Release, which notifies all users who starred the repo. This is the primary notification/observability mechanism.

Related frameworks

same archetype · same primary tool · same memory type

Context-Engineering Handbook ★ 9.0k

Provides a first-principles, research-grounded vocabulary and learning path for context engineering — the discipline of designing…

walkinglabs/learn-harness-engineering ★ 6.6k

Teach harness engineering from first principles (12 lectures + 6 projects) and provide a scaffolding skill (harness-creator) that…

Awesome Harness Engineering (walkinglabs) ★ 2.7k

Curate the authoritative reference list of articles, benchmarks, and tools for harness engineering — the practice of shaping the…

cline-memory-bank (nickbaumann98) ★ 581

Custom instructions + 6-file hierarchical Markdown memory bank so Cline maintains full project context across sessions, with a…

FPF (First Principles Framework) ★ 372

Provides a formal pattern language for making reasoning explicit, traceable, and publishable in mixed human/AI engineering work —…

nexu-io/harness-engineering-guide ★ 134

Provide a practical, code-first reference guide to harness engineering — from first principles to production patterns —…