claude-code-system-prompts  by Piebald-AI

AI agentic development system prompt library

Created 1 month ago
2,852 stars

Top 16.6% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Summary This repository archives and details the system prompts, tool descriptions, and sub-agent configurations for Claude Code, an AI agentic developer experience. It provides transparency into the complex prompt engineering behind Claude Code's functionality, enabling users to understand, customize, and potentially modify its behavior. The project benefits users seeking deeper control over their AI development environment.

How It Works Claude Code employs a modular prompt architecture, utilizing numerous distinct system prompts and tool descriptions that are conditionally assembled based on the execution environment and configuration. This includes prompts for core functions, specialized sub-agents (e.g., Plan, Explore), utility functions (e.g., CLAUDE.md generation, conversation compaction), and detailed descriptions for built-in tools. This approach allows for fine-grained control and adaptability in the AI's operational logic.

Quick Start & Requirements Customization of Claude Code's system prompts is facilitated by the tweakcc utility, which allows users to modify individual prompt components and patch their npm-based or native (binary) Claude Code installations. Further details on the "ultimate agentic AI developer experience" are available at https://piebald.ai/. Specific installation commands or prerequisites beyond having a Claude Code setup are not detailed within this repository's README.

Highlighted Details

  • Comprehensive catalog of system prompts, tool descriptions, and sub-agent prompts for Claude Code, updated for specific versions (e.g., v2.0.71).
  • Detailed token counts provided for each prompt component, offering insight into prompt complexity.
  • tweakcc utility for granular customization and patching of Claude Code installations.
  • Historical tracking of prompt changes across 52 versions since v2.0.14.

Maintenance & Community This project originates from the team behind Piebald (https://piebald.ai/). No specific community channels (e.g., Discord, Slack) or details on notable contributors or sponsorships are provided in the README.

Licensing & Compatibility The provided README text does not specify the software license or any compatibility notes for commercial use or closed-source linking.

Limitations & Caveats System prompts contain interpolated variables, leading to minor variations (±20 tokens) in actual token counts during runtime. The prompts are version-specific to Claude Code releases, potentially requiring updates for newer versions. The tweakcc utility implies a dependency on the user's existing Claude Code installation method.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
2
Star History
2,785 stars in the last 30 days

Explore Similar Projects

Starred by Matt Schrage Matt Schrage(Cofounder of Fig), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
2 more.

amazon-q-developer-cli by aws

0.5%
2k
CLI tool for agentic terminal interactions using natural language
Created 1 year ago
Updated 2 days ago
Starred by Gregor Zunic Gregor Zunic(Cofounder of Browser Use), Yineng Zhang Yineng Zhang(Inference Lead at SGLang; Research Scientist at Together AI), and
2 more.

agents.md by agentsmd

5.0%
15k
A format for guiding coding agents
Created 4 months ago
Updated 3 weeks ago
Feedback? Help us improve.