@jeremyy_prt/cc-config 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +159 -0
  2. package/agents/corriger-orthographe.md +49 -0
  3. package/agents/explorer-code.md +63 -0
  4. package/agents/explorer-docs.md +87 -0
  5. package/agents/recherche-web.md +46 -0
  6. package/cli.js +213 -0
  7. package/commands/commit.md +47 -0
  8. package/commands/corriger-orthographe.md +59 -0
  9. package/commands/creer-agent.md +126 -0
  10. package/commands/creer-commande.md +225 -0
  11. package/commands/liste-commande.md +103 -0
  12. package/commands/memoire-claude.md +190 -0
  13. package/commands/surveiller-ci.md +65 -0
  14. package/package.json +44 -0
  15. package/scripts/statusline/CLAUDE.md +178 -0
  16. package/scripts/statusline/README.md +105 -0
  17. package/scripts/statusline/biome.json +34 -0
  18. package/scripts/statusline/bun.lockb +0 -0
  19. package/scripts/statusline/data/.gitignore +5 -0
  20. package/scripts/statusline/fixtures/test-input.json +25 -0
  21. package/scripts/statusline/package.json +21 -0
  22. package/scripts/statusline/src/commands/CLAUDE.md +3 -0
  23. package/scripts/statusline/src/commands/spend-month.ts +60 -0
  24. package/scripts/statusline/src/commands/spend-today.ts +42 -0
  25. package/scripts/statusline/src/index.ts +199 -0
  26. package/scripts/statusline/src/lib/context.ts +103 -0
  27. package/scripts/statusline/src/lib/formatters.ts +218 -0
  28. package/scripts/statusline/src/lib/git.ts +100 -0
  29. package/scripts/statusline/src/lib/spend.ts +119 -0
  30. package/scripts/statusline/src/lib/types.ts +25 -0
  31. package/scripts/statusline/src/lib/usage-limits.ts +147 -0
  32. package/scripts/statusline/statusline.config.ts +125 -0
  33. package/scripts/statusline/test.ts +20 -0
  34. package/scripts/statusline/tsconfig.json +27 -0
  35. package/scripts/validate-command.js +707 -0
  36. package/scripts/validate-command.readme.md +283 -0
  37. package/settings.json +42 -0
  38. package/song/finish.mp3 +0 -0
  39. package/song/need-human.mp3 +0 -0
@@ -0,0 +1,59 @@
1
+ ---
2
+ description: Corriger les erreurs de grammaire et d'orthographe dans un ou plusieurs fichiers en préservant le formatage
3
+ allowed-tools: Read, Edit, Write, MultiEdit, Task
4
+ argument-hint: <chemin-fichier> [fichiers-additionnels...]
5
+ ---
6
+
7
+ Tu es un coordinateur de correction grammaticale. Corrige les erreurs de grammaire et d'orthographe dans les fichiers en préservant le formatage et le sens.
8
+
9
+ ## Workflow
10
+
11
+ 1. **PARSER LES FICHIERS**: Traiter les arguments de fichiers
12
+
13
+ - Séparer les arguments en chemins de fichiers individuels
14
+ - **CRITIQUE**: Au moins un chemin de fichier doit être fourni
15
+ - **STOP** si aucun fichier spécifié - demander les chemins à l'utilisateur
16
+
17
+ 2. **DÉTERMINER LA STRATÉGIE**: Choisir l'approche de traitement
18
+
19
+ - **Fichier unique**: Traiter directement avec corrections grammaticales
20
+ - **Fichiers multiples**: Lancer des agents @corriger-orthographe en parallèle
21
+
22
+ 3. **MODE FICHIER UNIQUE**: Traitement direct
23
+
24
+ - "Read" le fichier complètement
25
+ - Appliquer les corrections de grammaire et d'orthographe
26
+ - Préserver tout le formatage, les tags et les termes techniques
27
+ - "Edit" ou "Write" pour mettre à jour le fichier avec les corrections
28
+ - **PRÉSERVER**: Structure et sens d'origine
29
+
30
+ 4. **MODE FICHIERS MULTIPLES**: Traitement par agents parallèles
31
+
32
+ - **UTILISER TASK TOOL**: Lancer l'agent @corriger-orthographe pour chaque fichier
33
+ - **EXÉCUTION PARALLÈLE**: Traiter tous les fichiers simultanément
34
+ - **PROMPT AGENT**: Fournir uniquement le chemin du fichier à chaque agent
35
+ - **ATTENDRE**: Que tous les agents se terminent avant de rapporter
36
+
37
+ 5. **RAPPORTER LES RÉSULTATS**: Confirmer la complétion
38
+ - Montrer les fichiers traités
39
+ - Brève confirmation des corrections appliquées
40
+
41
+ ## Règles
42
+
43
+ - **OBLIGATOIRE**: Au moins un chemin de fichier requis
44
+ - **PARALLÈLE**: Traiter plusieurs fichiers simultanément avec des agents
45
+ - **DIRECT**: Traiter un fichier unique sans lancer d'agent
46
+ - **PRÉSERVER**: Tout le formatage, la structure et les termes techniques
47
+ - **L'AGENT GÈRE**: Chaque fichier indépendamment en mode parallèle
48
+
49
+ ## Exemples
50
+
51
+ ### Fichier unique
52
+
53
+ Utilisateur: `/corriger-orthographe src/components/Header.vue`
54
+ → Lire fichier → Appliquer corrections → Éditer fichier → Rapporter
55
+
56
+ ### Fichiers multiples
57
+
58
+ Utilisateur: `/corriger-orthographe src/app.js src/utils.js src/config.js`
59
+ → Lancer 3 agents @corriger-orthographe parallèles → Attendre → Rapporter tous les résultats
@@ -0,0 +1,126 @@
1
+ ---
2
+ allowed-tools: Read, Write, Edit, MultiEdit
3
+ argument-hint: <action> <nom> - ex: "create explore-api", "refactor @agents/recherche-web.md"
4
+ description: Créer et optimiser des prompts d'agent avec des patterns spécifiques aux agents
5
+ ---
6
+
7
+ Tu es un spécialiste de prompts d'agent. Crée des prompts d'agent ciblés et efficaces.
8
+
9
+ ## Workflow
10
+
11
+ 1. **PARSER LES ARGUMENTS**: Déterminer le type d'action
12
+ - `create <nom>`: Nouvel agent à partir d'un template
13
+ - `refactor @chemin`: Améliorer un agent existant
14
+ - `update @chemin`: Modifier des sections spécifiques
15
+
16
+ 2. **APPLIQUER LE TEMPLATE D'AGENT**: Utiliser la structure standard
17
+ - Les agents utilisent des **en-têtes de section** et non des workflows numérotés
18
+ - Focus sur les patterns de recherche/analyse/sortie
19
+ - Garder les agents spécialisés et ciblés
20
+
21
+ 3. **ÉCRIRE/METTRE À JOUR LE FICHIER**: Sauvegarder dans le répertoire agents/
22
+ - Nouveaux agents: `agents/<nom>.md`
23
+ - Mises à jour: Préserver tout le contenu existant
24
+
25
+ ## Template d'Agent
26
+
27
+ ```markdown
28
+ ---
29
+ name: [nom-en-kebab-case]
30
+ description: [Déclaration de capacité en une ligne - quand utiliser cet agent]
31
+ color: [yellow|blue|green|red]
32
+ ---
33
+
34
+ Tu es un [rôle de spécialiste spécifique]. [Objectif principal en une phrase].
35
+
36
+ ## [Phase d'Action Principale]
37
+
38
+ [Instructions directes pour la tâche principale]
39
+ - Utiliser `Outil` pour des objectifs spécifiques
40
+ - Pattern à suivre pour les recherches
41
+ - Quoi rassembler ou analyser
42
+
43
+ ## [Phase Secondaire si nécessaire]
44
+
45
+ [Étapes de traitement additionnelles]
46
+ - Comment traiter les résultats
47
+ - Étapes de validation ou vérification
48
+
49
+ ## Format de Sortie
50
+
51
+ [Exactement comment structurer la réponse]
52
+ ```
53
+ - Utiliser des exemples spécifiques quand utile
54
+ - Garder le format minimal et scannable
55
+ ```
56
+
57
+ ## Règles d'Exécution
58
+
59
+ - [Contraintes critiques]
60
+ - [Directives de performance]
61
+ - [Limitations de scope]
62
+
63
+ ## Priorité
64
+
65
+ [Objectif primaire] > [Secondaire]. [Déclaration de focus en une ligne].
66
+ ```
67
+
68
+ ## Patterns d'Agent par Type
69
+
70
+ ### Agents de Recherche/Exploration
71
+ ```markdown
72
+ ## Stratégie de Recherche
73
+ 1. Commencer large avec des recherches parallèles
74
+ 2. Lire les fichiers pour le contexte complet
75
+ 3. Suivre les connexions
76
+
77
+ ## Format de Sortie
78
+ ### Éléments Trouvés
79
+ - Chemin: /emplacement/fichier
80
+ - Objectif: [pourquoi pertinent]
81
+ - Sections clés: [ce qui compte]
82
+ ```
83
+
84
+ ### Agents de Modification (comme Snipper)
85
+ ```markdown
86
+ ## Workflow
87
+ 1. **Lire**: Charger les fichiers cibles
88
+ 2. **Éditer**: Appliquer les changements
89
+ 3. **Rapporter**: Lister les modifications
90
+
91
+ ## Format de Sortie
92
+ - fichier.ext: [changement effectué]
93
+ ```
94
+
95
+ ### Agents d'Analyse
96
+ ```markdown
97
+ ## Processus d'Analyse
98
+ - Rassembler les données de X
99
+ - Comparer avec Y
100
+ - Identifier les patterns
101
+
102
+ ## Format de Sortie
103
+ ### Découvertes
104
+ [Résultats structurés]
105
+
106
+ ### Recommandations
107
+ [Éléments d'action]
108
+ ```
109
+
110
+ ## Règles d'Exécution
111
+
112
+ - **Les agents sont sans état** - inclure tout le contexte nécessaire
113
+ - **Rester ciblé** - un objectif clair par agent
114
+ - **Minimiser la sortie** - les agents doivent être rapides
115
+ - **Utiliser les outils parallèles** quand possible pour la vitesse
116
+ - **PAS d'explications verbeuses** dans la sortie de l'agent
117
+
118
+ ## Métadonnées Communes
119
+
120
+ - **name**: Toujours en kebab-case (explorer-code, corriger-tests)
121
+ - **description**: Commencer par "Utiliser cet agent quand..." ou déclencheur clair
122
+ - **color**: yellow (recherche), blue (modifier), green (analyser), red (critique)
123
+
124
+ ## Priorité
125
+
126
+ Clarté > Fonctionnalités. Garder les agents simples et rapides.
@@ -0,0 +1,225 @@
1
+ ---
2
+ allowed-tools: Read, Write, Edit, MultiEdit
3
+ argument-hint: <action> <nom> - ex: "create deploy", "refactor @commands/commit.md"
4
+ description: Créer et optimiser des prompts de commande avec des patterns spécifiques
5
+ ---
6
+
7
+ Tu es un spécialiste de prompts de commande. Crée des prompts de commande actionnables qui correspondent aux patterns existants.
8
+
9
+ ## Workflow
10
+
11
+ 1. **PARSER LES ARGUMENTS**: Déterminer le type d'action
12
+ - `create <nom>`: Nouvelle commande à partir d'un template
13
+ - `refactor @chemin`: Améliorer une commande existante
14
+ - `update @chemin`: Modifier des sections spécifiques
15
+
16
+ 2. **CHOISIR LE PATTERN**: Sélectionner le format approprié
17
+ - **Workflow numéroté** pour les commandes lourdes en processus (EPCT, commit, CI)
18
+ - **Référence/docs** pour les commandes wrapper CLI (neon-cli, vercel-cli)
19
+ - **Sections simples** pour les commandes d'analyse (deep-code-analysis)
20
+
21
+ 3. **ÉCRIRE/METTRE À JOUR LE FICHIER**: Sauvegarder dans le répertoire commands/
22
+ - Nouvelles commandes: `commands/<nom>.md`
23
+ - Mises à jour: Préserver tout le contenu et la structure existants
24
+
25
+ ## Patterns de Commande
26
+
27
+ ### Pattern 1: Workflow Numéroté (pour les processus)
28
+ **Utiliser pour**: Processus multi-étapes, opérations git, monitoring CI, méthodologie EPCT
29
+
30
+ ```markdown
31
+ ---
32
+ description: [Objectif en une ligne]
33
+ allowed-tools: [Outils spécifiques]
34
+ ---
35
+
36
+ Tu es un [rôle]. [Déclaration de mission].
37
+
38
+ ## Workflow
39
+
40
+ 1. **NOM D'ACTION**: Brève description
41
+ - Étape spécifique avec `commande exacte`
42
+ - **CRITIQUE**: Contrainte importante
43
+
44
+ 2. **PHASE SUIVANTE**: Ce qui se passe ensuite
45
+ - Continuer avec les actions
46
+ - **RESTER DANS LE SCOPE**: Limites
47
+
48
+ ## Règles d'Exécution
49
+ - **NON-NÉGOCIABLE**: Règles critiques
50
+ - Autres directives
51
+
52
+ ## Priorité
53
+ [Déclaration de focus].
54
+ ```
55
+
56
+ ### Pattern 2: Format Référence/Docs (pour les outils CLI)
57
+ **Utiliser pour**: Wrappers CLI, référence de commandes, commandes de documentation
58
+
59
+ ```markdown
60
+ ---
61
+ allowed-tools: Bash(<cli> *)
62
+ description: Commandes [Outil CLI] pour [objectif]
63
+ ---
64
+
65
+ # Commandes CLI [Nom de l'Outil]
66
+
67
+ ## [Catégorie 1]
68
+ \```bash
69
+ # Commentaire expliquant la commande
70
+ tool command --flag
71
+
72
+ # Autre exemple
73
+ tool other-command <arg>
74
+ \```
75
+
76
+ ## [Catégorie 2]
77
+ \```bash
78
+ # Plus de commandes groupées par fonction
79
+ \```
80
+
81
+ ## Workflows Communs
82
+
83
+ ### [Nom du Workflow]
84
+ \```bash
85
+ # Exemple étape par étape
86
+ # 1. Première commande
87
+ tool setup
88
+
89
+ # 2. Action principale
90
+ tool action --flag
91
+ \```
92
+ ```
93
+
94
+ ### Pattern 3: Analyse Basée sur Sections (pour recherche/analyse)
95
+ **Utiliser pour**: Commandes d'analyse, tâches de recherche, workflows d'investigation
96
+
97
+ ```markdown
98
+ ---
99
+ description: [Objectif d'analyse]
100
+ allowed-tools: [Outils de recherche]
101
+ ---
102
+
103
+ Tu es un [rôle d'analyste]. [Déclaration d'objectif].
104
+
105
+ ## [Nom de Phase]
106
+
107
+ **Objectif**: [Ce que cela accomplit]
108
+
109
+ - Éléments d'action
110
+ - **CRITIQUE**: Contraintes
111
+ - Utiliser `outils spécifiques`
112
+
113
+ ## [Autre Phase]
114
+
115
+ [Structure similaire]
116
+
117
+ ## Règles d'Exécution
118
+ - Directives et contraintes
119
+ ```
120
+
121
+ ## Patterns de Commande par Type
122
+
123
+ ### Opérations Git (commit, PR)
124
+ ```markdown
125
+ ## Workflow
126
+ 1. **STAGE**: Préparer les changements
127
+ - `git add -A` ou staging sélectif
128
+ - `git status` pour vérifier
129
+
130
+ 2. **COMMIT**: Créer le commit
131
+ - Générer le message suivant la convention
132
+ - `git commit -m "type: description"`
133
+
134
+ 3. **PUSH**: Soumettre les changements
135
+ - `git push` vers le remote
136
+ - Vérifier avec `gh pr view`
137
+ ```
138
+
139
+ ### Commandes CI/Build
140
+ ```markdown
141
+ ## Workflow
142
+ 1. **ATTENDRE**: Délai initial si nécessaire
143
+ - `sleep 30` pour que la CI démarre
144
+
145
+ 2. **MONITORER**: Surveiller le statut
146
+ - `gh run list` pour trouver les runs
147
+ - `gh run watch <id>` pour monitorer
148
+
149
+ 3. **EN CAS D'ÉCHEC**: Corriger et réessayer
150
+ - Obtenir les logs avec `gh run view --log-failed`
151
+ - Corriger les problèmes et push
152
+ - Boucler (max tentatives)
153
+ ```
154
+
155
+ ### Exécution de Tâches (pattern EPCT)
156
+ ```markdown
157
+ ## Workflow
158
+ 1. **EXPLORER**: Rassembler les informations
159
+ - Rechercher avec des agents parallèles
160
+ - Trouver les fichiers pertinents
161
+
162
+ 2. **PLANIFIER**: Créer la stratégie
163
+ - Documenter l'approche
164
+ - Poster le plan en commentaire si GitHub issue
165
+
166
+ 3. **CODER**: Implémenter les changements
167
+ - Suivre les patterns existants
168
+ - Rester dans le scope
169
+
170
+ 4. **TESTER**: Vérifier les changements
171
+ - Lancer uniquement les tests pertinents
172
+ - Vérifier lint et types
173
+ ```
174
+
175
+ ### Commandes Wrapper CLI
176
+ ```markdown
177
+ ## Workflow
178
+ 1. **PARSER**: Obtenir les arguments de $ARGUMENTS
179
+ - Valider le format d'entrée
180
+ - Extraire les paramètres
181
+
182
+ 2. **EXÉCUTER**: Lancer la commande CLI
183
+ - `cli-tool command --flags`
184
+ - Gérer la sortie
185
+
186
+ 3. **RAPPORTER**: Montrer les résultats
187
+ - Parser et formater la sortie
188
+ - Mettre en évidence les infos importantes
189
+ ```
190
+
191
+ ## Directives Métadonnées
192
+
193
+ ### allowed-tools
194
+ - **Commandes Git**: `Bash(git :*)`
195
+ - **GitHub CLI**: `Bash(gh :*)`
196
+ - **CLI spécifique**: `Bash(npm :*)`, `Bash(vercel :*)`
197
+ - **Opérations fichiers**: `Read, Edit, MultiEdit, Write`
198
+ - **Autres**: `Task`, `WebFetch`, etc.
199
+
200
+ ### argument-hint
201
+ Inclure uniquement si la commande prend des arguments:
202
+ - `<chemin-fichier>` - entrée d'un seul fichier
203
+ - `<numéro-issue|url-issue>` - types d'entrée multiples
204
+ - `<action> <cible>` - arguments multi-parties
205
+ - Sauter pour les commandes simples comme `commit`
206
+
207
+ ## Patterns d'Emphase
208
+
209
+ - **CRITIQUE/DOIT/JAMAIS**: Règles non-négociables
210
+ - **RESTER DANS LE SCOPE**: Prévenir le feature creep
211
+ - **AVANT [action]**: Prérequis
212
+ - **NON-NÉGOCIABLE**: Exigences absolues
213
+ - **STOP**: Conditions d'arrêt
214
+
215
+ ## Règles d'Exécution
216
+
217
+ - **Les commandes sont avec état** - peuvent référencer les étapes précédentes
218
+ - **Utiliser des workflows numérotés** pour une séquence claire
219
+ - **Inclure les commandes exactes** pas d'abstractions
220
+ - **Ajouter des étapes de vérification** après les actions
221
+ - **Définir le comportement en cas d'échec** (réessayer, arrêter, demander)
222
+
223
+ ## Priorité
224
+
225
+ Actionnabilité > Complétude. Rendre chaque étape exécutable.
@@ -0,0 +1,103 @@
1
+ ---
2
+ description: Afficher la liste de toutes les commandes et agents avec exemples d'utilisation
3
+ allowed-tools: Read, Glob
4
+ argument-hint: [--exemples | -e]
5
+ ---
6
+
7
+ Tu es un assistant qui liste les commandes et agents disponibles avec leurs exemples d'utilisation.
8
+
9
+ ## Workflow
10
+
11
+ 1. **PARSER L'ARGUMENT** :
12
+ - Vérifier si `--exemples` ou `-e` est passé en argument
13
+ - Mode normal: liste simple
14
+ - Mode exemples: liste + exemples d'utilisation
15
+
16
+ 2. **LISTER LES COMMANDES** :
17
+ - Utiliser `Glob` avec le pattern `*.md` dans `/Users/jeremy/.claude/commands/`
18
+ - Pour chaque fichier, utiliser `Read` pour lire le frontmatter YAML et le contenu
19
+ - Extraire la description entre les `---`
20
+ - Si mode exemples: extraire aussi les exemples du contenu
21
+
22
+ 3. **LISTER LES AGENTS** :
23
+ - Utiliser `Glob` avec le pattern `*.md` dans `/Users/jeremy/.claude/agents/`
24
+ - Pour chaque fichier, utiliser `Read` pour lire le frontmatter YAML et le contenu
25
+ - Extraire le `name` et `description` entre les `---`
26
+ - Si mode exemples: créer des exemples basés sur la description
27
+
28
+ 4. **AFFICHER** :
29
+ - Afficher les commandes dans une section
30
+ - Afficher les agents dans une autre section
31
+ - Si mode exemples: ajouter un exemple d'utilisation pour chaque
32
+
33
+ ## Format de Sortie (Mode Normal)
34
+
35
+ ```
36
+ 🔧 COMMANDES DISPONIBLES
37
+
38
+ /nom-commande Description de la commande
39
+ /autre-commande Description de l'autre commande
40
+
41
+ 🤖 AGENTS DISPONIBLES
42
+
43
+ @nom-agent Description de l'agent
44
+ @autre-agent Description de l'autre agent
45
+
46
+ 💡 Pour voir des exemples: /liste-commande --exemples
47
+ ```
48
+
49
+ ## Format de Sortie (Mode Exemples)
50
+
51
+ ```
52
+ 🔧 COMMANDES DISPONIBLES
53
+
54
+ /commit
55
+ └─ Commit et push rapides avec messages minimaux
56
+ Exemple: /commit
57
+
58
+ /corriger-orthographe
59
+ └─ Corriger les erreurs de grammaire et d'orthographe
60
+ Exemple: /corriger-orthographe src/components/Header.vue
61
+ Exemple: /corriger-orthographe src/*.vue
62
+
63
+ /surveiller-ci
64
+ └─ Surveiller et corriger automatiquement les erreurs de CI
65
+ Exemple: /surveiller-ci
66
+
67
+ 🤖 AGENTS DISPONIBLES
68
+
69
+ @explorer-docs
70
+ └─ Explorer la documentation de bibliothèques avec exemples de code
71
+ Exemple: @explorer-docs cherche la doc de Nuxt 4
72
+ Exemple: Comment utiliser les server routes dans Vue 3 ?
73
+
74
+ @recherche-web
75
+ └─ Recherche web rapide avec sources fiables
76
+ Exemple: @recherche-web quoi de neuf dans TypeScript 5.7
77
+ Exemple: Trouve-moi des infos sur l'API Context7
78
+ ```
79
+
80
+ ## Exemples par Défaut
81
+
82
+ Si le fichier ne contient pas d'exemples, génère des exemples intelligents basés sur:
83
+ - Le nom de la commande/agent
84
+ - La description
85
+ - L'argument-hint si présent
86
+
87
+ **Exemples types** :
88
+ - Commandes sans arguments: Juste `/nom-commande`
89
+ - Commandes avec fichiers: `/nom-commande chemin/vers/fichier.ext`
90
+ - Agents: `@nom-agent [question ou contexte]` ou en conversationnel
91
+
92
+ ## Règles
93
+
94
+ - Ne pas inclure le fichier `liste-commande.md` lui-même dans la liste
95
+ - Trier par ordre alphabétique
96
+ - Format compact et lisible
97
+ - En mode normal: juste lister
98
+ - En mode exemples: exemples clairs et concrets
99
+ - Les exemples doivent être copy-paste ready
100
+
101
+ ## Priorité
102
+
103
+ Clarté > Détails. Exemples pratiques et immédiatement utilisables.
@@ -0,0 +1,190 @@
1
+ ---
2
+ description: Créer et mettre à jour les fichiers CLAUDE.md en suivant les meilleures pratiques
3
+ allowed-tools: Read, Write, Edit, MultiEdit, Glob, Grep, Bash(find *)
4
+ argument-hint: <action> <chemin> - ex: "create global", "update apps/web/CLAUDE.md"
5
+ ---
6
+
7
+ Tu es un spécialiste CLAUDE.md. Crée et maintiens des fichiers de mémoire de projet qui guident Claude Code efficacement en utilisant les meilleures pratiques officielles.
8
+
9
+ Tu dois ULTRA PENSER à la spécificité, la clarté et les conseils actionnables.
10
+
11
+ ## Workflow
12
+
13
+ 1. **PARSER LES ARGUMENTS**: Déterminer l'action et la portée
14
+ - `create global`: Nouveau CLAUDE.md global à la racine du dépôt
15
+ - `create <chemin-dossier>`: Nouveau CLAUDE.md spécifique à un dossier
16
+ - `update <chemin>`: Mettre à jour un CLAUDE.md existant avec du nouveau contenu
17
+ - **CRITIQUE**: Valider le chemin et déterminer si global ou spécifique au dossier
18
+
19
+ 2. **ANALYSER LE CONTEXTE**: Rechercher les patterns existants en suivant les meilleures pratiques officielles
20
+ - Utiliser `Glob` pour trouver les fichiers CLAUDE.md existants comme référence
21
+ - `Read` package.json, README.md et fichiers clés pour comprendre la structure du projet
22
+ - `Grep` pour les patterns d'import, frameworks et commandes
23
+ - **CRITIQUE**: Focus sur la spécificité - "Utiliser indentation de 2 espaces" pas "Formater le code correctement"
24
+ - **ULTRA PENSER**: Quel contexte actionnable et spécifique Claude a-t-il besoin le plus?
25
+
26
+ 3. **RASSEMBLER LES EXIGENCES**: Collecter les informations spécifiques au projet
27
+ - **Pour Global**: Architecture, stack technique, déploiement, commandes clés
28
+ - **Pour Dossier**: Patterns spécifiques, conventions, fichiers importants dans ce dossier
29
+ - Utiliser `find` et l'exploration de fichiers pour comprendre la structure
30
+ - **CRITIQUE**: Focus sur les conseils actionnables, pas seulement la documentation
31
+
32
+ 4. **CRÉER/METTRE À JOUR LE CONTENU**: Construire des conseils complets en suivant les meilleures pratiques officielles
33
+ - **Utiliser des points de liste markdown** pour une organisation claire
34
+ - **Grouper les mémoires liées** sous des titres markdown descriptifs
35
+ - **Être extrêmement spécifique**: Inclure les commandes exactes, chemins de fichiers, patterns
36
+ - **Inclure la syntaxe @** pour les imports (ex: @apps/web/src/lib/safe-route.ts)
37
+ - **Maximum 5 sauts d'import** pour les inclusions récursives
38
+ - **ULTRA PENSER**: Quels patterns spécifiques et actionnables Claude va-t-il rencontrer de manière répétée?
39
+
40
+ 5. **VALIDER ET SAUVEGARDER**: Assurer la qualité et sauvegarder
41
+ - Vérifier que toutes les commandes sont exactes avec la structure du projet
42
+ - Vérifier que les chemins de fichiers existent et sont corrects
43
+ - `Write` à l'emplacement cible
44
+ - **CRITIQUE**: Tester les commandes mentionnées si possible
45
+
46
+ ## Template CLAUDE.md Global (Suivant les Meilleures Pratiques Officielles)
47
+
48
+ ```markdown
49
+ # CLAUDE.md
50
+
51
+ Ce fichier fournit des conseils à Claude Code lors du travail avec le code dans ce dépôt.
52
+
53
+ ## Commandes de Développement
54
+
55
+ ### Commandes Principales
56
+ - `pnpm dev` - Démarrer le serveur de développement
57
+ - `pnpm build` - Build tous les packages
58
+ - `pnpm lint` - Lancer ESLint avec config spécifique
59
+ - `pnpm test` - Lancer les tests (spécifier la commande de test exacte)
60
+
61
+ ### [Commandes d'Application Spécifiques]
62
+ - `pnpm dev:web` - Démarrer Next.js avec Turbo
63
+ - **TOUJOURS lancer `pnpm ts` après modification de fichiers TypeScript**
64
+
65
+ ## Vue d'Ensemble de l'Architecture
66
+
67
+ **Stack Technique**: [Versions et configurations spécifiques]
68
+ - Next.js 15 avec App Router
69
+ - TypeScript avec mode strict activé
70
+ - Prisma avec PostgreSQL
71
+
72
+ ### Applications/Packages Clés
73
+ - **apps/web** - Application Next.js (produit principal)
74
+ - **packages/database** - Client Prisma et schémas
75
+
76
+ ### [Patterns Spécifiques au Framework]
77
+ - **Routes API**: Toujours utiliser le pattern @src/lib/safe-route.ts
78
+ - **Server Actions**: Utiliser @src/lib/safe-action.ts avec le nommage ACTION_NAME.action.ts
79
+
80
+ ## Style de Code & Conventions
81
+
82
+ - **Indentation**: Utiliser 2 espaces (pas de tabs)
83
+ - **Imports**: Utiliser @/ pour les imports du dossier src
84
+ - **Composants**: Utiliser uniquement les composants shadcn/ui
85
+ - **Styling**: Utiliser l'utilitaire `cn()` pour les classes conditionnelles
86
+
87
+ ## Workflow
88
+
89
+ - **Après modification de fichiers**: Toujours lancer `pnpm lint` et `pnpm ts` dans apps/web
90
+ - **Avant commits**: Vérifier que TypeScript compile avec succès
91
+ ```
92
+
93
+ ## Template CLAUDE.md de Dossier
94
+
95
+ ```markdown
96
+ ### Structure du Répertoire ([nom-du-dossier])
97
+
98
+ - [Répertoires clés et leur objectif]
99
+
100
+ ## Directives [Framework/Technologie]
101
+
102
+ [Patterns spécifiques pour le stack technique de ce dossier]
103
+
104
+ ## Workflow de Développement
105
+
106
+ [Commandes spécifiques au dossier et étapes de vérification]
107
+
108
+ ## Commandes
109
+
110
+ [Commandes build/test/lint spécifiques au dossier]
111
+
112
+ ## Important
113
+
114
+ [Patterns critiques avec exemples de fichiers spécifiques utilisant la syntaxe @]
115
+ ```
116
+
117
+ ## Patterns d'Emphase et de Priorité (Critique pour l'Efficacité de CLAUDE.md)
118
+
119
+ ### Techniques d'Emphase à Fort Impact
120
+ - **CRITIQUE**: Utiliser pour les exigences non-négociables qui cassent les fonctionnalités si ignorées
121
+ - **TOUJOURS**: Pour les actions obligatoires qui doivent se produire à chaque fois
122
+ - **JAMAIS**: Pour les actions qui causeront des problèmes ou casseront les patterns
123
+ - **AVANT [action]**: Pour les prérequis nécessaires
124
+ - **APRÈS [action]**: Pour les étapes de suivi nécessaires
125
+
126
+ ### Formatage pour un Impact Maximum
127
+ - **Texte en gras**: Pour les commandes, chemins de fichiers et concepts clés
128
+ - `Blocs de code`: Pour les commandes exactes et chemins de fichiers
129
+ - **Mots-clés EN MAJUSCULES**: CRITIQUE, TOUJOURS, JAMAIS, DOIT, REQUIS
130
+ - Points de liste avec emphase: **TOUJOURS lancer `pnpm ts` après changements TypeScript**
131
+
132
+ ### Structure de Priorité (Du Plus au Moins Important)
133
+ 1. **Commandes qui cassent les builds/déploiements** - Marquer comme CRITIQUE
134
+ 2. **Étapes de workflow requises** - Marquer comme TOUJOURS/DOIT
135
+ 3. **Patterns de fichiers et conventions** - Utiliser gras et exemples
136
+ 4. **Directives utiles** - Points de liste standards
137
+
138
+ ### Exemples d'Emphase Efficace
139
+ ```markdown
140
+ - **CRITIQUE**: Toujours utiliser @src/lib/safe-route.ts pour les routes API
141
+ - **JAMAIS** importer directement depuis les dossiers internes de packages
142
+ - **AVANT de commiter**: Lancer `pnpm lint` et `pnpm ts` dans apps/web
143
+ - **REQUIS**: Utiliser uniquement les composants shadcn/ui (pas de frameworks CSS custom)
144
+ ```
145
+
146
+ ## Stratégie de Collecte de Contenu
147
+
148
+ ### Pour CLAUDE.md Global:
149
+ - **Commandes**: Extraire depuis scripts package.json, Makefile, fichiers CI
150
+ - **Architecture**: Analyser structure de dossiers, dépendances principales
151
+ - **Stack Technique**: Lire package.json, patterns d'import, fichiers de config
152
+ - **Déploiement**: Trouver configs de déploiement (Vercel, Docker, etc.)
153
+ - **Environnement**: Scanner fichiers .env, patterns de config
154
+
155
+ ### Pour CLAUDE.md de Dossier:
156
+ - **Patterns**: Analyser les fichiers existants dans le dossier pour les conventions
157
+ - **Imports**: Patterns d'import communs et usage de bibliothèques
158
+ - **Types de Fichiers**: Routes API, composants, patterns utilitaires
159
+ - **Conventions**: Nommage, structure, patterns spécifiques au framework
160
+
161
+ ## Stratégie de Mise à Jour
162
+
163
+ Lors de la mise à jour d'un CLAUDE.md existant:
164
+ 1. **PRÉSERVER**: Garder la structure existante et le contenu fonctionnel
165
+ 2. **AMÉLIORER**: Ajouter les nouveaux patterns trouvés dans la demande de mise à jour
166
+ 3. **ORGANISER**: Placer le nouveau contenu dans les sections appropriées
167
+ 4. **VALIDER**: Assurer que les nouvelles additions n'entrent pas en conflit avec les conseils existants
168
+
169
+ ## Règles d'Exécution
170
+
171
+ - **NE JAMAIS ASSUMER**: Toujours vérifier que les commandes et chemins de fichiers existent
172
+ - **ÊTRE EXTRÊMEMENT SPÉCIFIQUE**: "Utiliser indentation de 2 espaces" pas "Formater le code correctement"
173
+ - **METTRE L'EMPHASE SUR LES ÉLÉMENTS CRITIQUES**: Utiliser CRITIQUE, TOUJOURS, JAMAIS pour les règles importantes
174
+ - **TESTER LES COMMANDES**: Valider toutes les commandes mentionnées dans CLAUDE.md
175
+ - **SUIVRE LA HIÉRARCHIE**: Règles critiques → Workflow requis → Patterns → Directives
176
+ - **ULTRA PENSER**: Qu'est-ce qui va casser si Claude ne suit pas cela exactement?
177
+
178
+ ## Checklist d'Efficacité de CLAUDE.md
179
+
180
+ Avant de sauvegarder n'importe quel CLAUDE.md:
181
+ - ☐ **Les commandes sont testées et fonctionnent**
182
+ - ☐ **Les éléments critiques utilisent l'emphase appropriée** (CRITIQUE, TOUJOURS, JAMAIS)
183
+ - ☐ **Les chemins de fichiers utilisent la syntaxe @** et existent
184
+ - ☐ **Spécifique plutôt que générique** ("Utiliser l'utilitaire `cn()`" pas "Utiliser de bons noms de classes")
185
+ - ☐ **Structure hiérarchique** avec titres markdown clairs
186
+ - ☐ **Conseils actionnables** - chaque ligne dit à Claude quoi faire
187
+
188
+ ## Priorité
189
+
190
+ Spécificité > Complétude. Chaque instruction devrait être immédiatement exécutable avec l'emphase appropriée.