La plus grande bibliothèque de prompts système : aperçu du dépôt et guide d'utilisation

L'étude des instructions internes des agents autonomes modernes est l'un des moyens les plus efficaces de comprendre comment les équipes d'ingénierie des principales laboratoires d'IA conçoivent des systèmes fiables.

Le dépôt public claude-code-system-prompts de l'équipe Piebald constitue la collection publique la plus complète des prompts système actuels de Claude Code. Il documente des centaines d'instructions avec un comptage précis des tokens et une historique détaillé des modifications entre les releases.

1. Qu'est-ce que le dépôt claude-code-system-prompts

Le dépôt contient un registre exhaustif de toutes les directives internes de l'agent CLI officiel Claude Code d'Anthropic.

1.1. Origine et objectif du dépôt Piebald

Le projet a été créé pour une analyse transparente de l'évolution de l'architecture de Claude Code. À la version Claude Code v2.1.234, la base comprend plus de 500 prompts distincts.

Outre le texte source des instructions, le dépôt inclut un fichier CHANGELOG.md qui consigne scrupuleusement les modifications des prompts sur plus de 250 releases consécutifs, à partir de la version v2.0.14.

1.2. Historique des mises à jour et couverture des versions

Les scripts de synchronisation s'exécutent automatiquement quelques minutes après chaque publication d'un nouveau package npm de Claude Code. Grâce à cela, les développeurs accèdent aux instructions actualisées en temps réel, sans se fier à une documentation obsolète ou à des suppositions tierces.

La dernière extension majeure a augmenté le catalogue de prompts de 350 à 515 entrées, assurant une couverture à 100 % de la base de code de l'agent.

2. Pourquoi Claude Code ne possède pas un seul prompt système, mais des centaines

Une erreur courante chez les débutants consiste à imaginer l'interaction avec un modèle de langage comme un unique bloc statique d'instructions système.

2.1. Architecture modulaire plutôt qu'un prompt système monolithique

Dans un système de production réel au niveau de Claude Code, le comportement de l'agent résulte d'une composition dynamique de nombreux modules :

• Blocs conditionnels d'environnement : instructions activées uniquement en présence de certaines configurations ou systèmes d'exploitation.
• Descriptions d'outils (Tool Descriptions) : spécifications approfondies des fonctions (Write, Bash, TodoWrite), dont certaines occupent plusieurs milliers de tokens.
• Sous-agents spécialisés : directives système autonomes pour des processus auxiliaires tels que Explore ou Plan.

2.2. Activation conditionnelle et interpolation dynamique

Le système intègre également des dizaines de fonctions IA de service : mécanismes de compression du contexte (Context Compaction), génération de fichiers CLAUDE.md, formulation des titres de sessions et contrôle des limites de sécurité. Au total, il s'agit de centaines de lignes de code réparties dans un bundle optimisé.

3. Structure et catégories des prompts

Tous les matériaux extraits sont systématiquement classés selon six axes principaux en fonction de leur rôle fonctionnel.

3.1. Répartition par 6 catégories principales

Voici la répartition quantitative des prompts par catégorie dans le dépôt :

Répartition quantitative des catégories de prompts dans le dépôt — illustration 1 ЗбільшитиRépartition quantitative des catégories de prompts dans le dépôt — illustration 1

4. Aperçu des catégories clés : des agents aux rappels système

Chaque catégorie remplit une tâche strictement définie dans l'écosystème global de l'agent.

4.1. Agent Prompts — sous-agents, commandes slash et monitoring

La catégorie couvre quatre groupes : sous-agents autonomes, assistants de gestion du système de fichiers, commandes slash interactives et utilitaires de service.

• Agent Prompt: Explore (871 tks) : prompt système spécialisé pour la navigation et l'exploration rapide de structures de bases de code inconnues.
• Agent Prompt: /security-review (2 521 tks) : instruction complète pour l'audit des modifications de code, axée sur les vulnérabilités exploitables.
• Agent Prompt: Security monitor (25 798 tks) : le prompt le plus volumineux de la section, définissant les règles de vérification et de blocage des opérations potentiellement dangereuses.

4.2. Data — documentation de référence, catalogues de modèles et templates

Contient des informations statiques intégrées dans l'outil pour fonctionner de manière autonome sans requêtes constantes vers des API externes :

• Claude model catalog (4 965 tks) : liste actuelle des modèles Anthropic avec leurs ID, limites de contexte et tarification.
• Managed Agents core concepts (10 959 tks) : guide sur l'architecture des environnements agentiques, des sessions et des conteneurs isolés.
• Workshop artifact HTML template (49 202 tks) : template HTML autonome complet pour le rendu d'artefacts interactifs.

4.3. System Prompt — instructions fondamentales et orchestration de coordination

Fragments constituant le contexte initial de communication du modèle :

• Emoji avoidance (31 tks) : instruction concise interdisant l'utilisation d'emojis sans demande directe de l'utilisateur.
• Harness instructions (329 tks) : définition de l'identité fondamentale de l'agent, des règles de sortie terminal et des droits d'accès.
• Coordinator mode orchestration (5 757 tks) : règles de distribution des tâches entre plusieurs worker-agents parallèles.

4.4. System Reminders — rappels contextuels et limites de sécurité

Insertions dynamiques ajoutées au contexte lors de l'exécution d'actions spécifiques :

• Plan mode is active (147 tks) : rappel de l'interdiction de modifier des fichiers pendant le mode planification actif.
• External source trust boundary (108 tks) : avertissement indiquant que les données provenant de plugins tiers ont un niveau de confiance nul et nécessitent une sanitisation.

4.5. Built-in Tool Descriptions — spécifications des outils intégrés

Descriptions d'appel des utilitaires que le modèle perçoit comme des signatures d'outils standard :

• Tool Description: TodoWrite (2 037 tks) : instruction pour la gestion de listes de tâches structurées.
• Tool Description: Workflow (7 034 tks) : protocole pour des scénarios d'orchestration déterministes.
• Tool Description: Bash (Git & PR guidelines) (2 450 tks) : standards pour la création de commits git atomiques et la description des pull requests.

5. Skills intégrés et workflows spécialisés

Les Skills représentent des scénarios experts aboutis, optimisés pour des tâches spécifiques de développement.

5.1. Catalogue des Skills intégrés

Parmi les exemples les plus intéressants :

• Skill: Design (20 955 tks) : règles de conception pour des artboards adaptatifs Claude Design avec des grilles d'interface éditables.
• Skill: Verify skill (4 354 tks) : checklist formalisée pour le test obligatoire du code avant de déclarer une tâche accomplie.

5.2. Les plus gros prompts en volume de tokens

Le record absolu du dépôt est détenu par Skill: Model migration guide (64 306 tks). Ce gigantesque guide étape par étape contient des templates complets de refactoring pour migrer les appels API obsolètes vers les nouveaux standards des familles Claude 3.5 et Claude 3.7.

6. Garantie de précision : extraction depuis le code source

La fiabilité de la base de prompts est assurée par une automatisation complète des processus d'analyse.

6.1. Extraction automatisée depuis le package npm

Toutes les instructions sont extraites par un script de décompilation directement depuis la distribution npm (@anthropic-ai/claude-code). Cela élimine toute intervention humaine ou interprétation subjective — le dépôt contient exactement les lignes de code exécutées par le moteur durant votre session.

6.2. Marge d'erreur de tokenisation et variables dynamiques

Il faut noter que certains prompts contiennent des variables de template interpolées (noms d'extensions installées, variables d'environnement, chemins accessibles). De ce fait, le nombre réel de tokens dans votre session locale peut varier de ±20 tokens par rapport à la valeur nominale.

7. Personnalisation pratique des prompts avec tweakcc

Pour les développeurs souhaitant modifier le comportement standard de l'agent, l'utilitaire tweakcc a été créé.

7.1. Fonctionnalités et principes de fonctionnement de tweakcc

L'utilitaire offre trois avantages clés :

1. Permet de définir ses propres modifications des prompts système sous forme de fichiers Markdown lisibles.
2. Patche automatiquement les installations binaires ou npm de Claude Code sur votre système.
3. Intègre des outils de résolution de conflits lorsque les mises à jour d'Anthropic touchent un fragment que vous avez édité.

7.2. Gestion sécurisée du patching et synchronisation avec les releases d'Anthropic

Puisque tweakcc utilise la même carte des instructions que le dépôt claude-code-system-prompts, le processus de modification reste entièrement déterministe et récupérable après chaque mise à jour du CLI.

8. Questions fréquentes (FAQ)

8.1. Réponses aux questions typiques sur les prompts système