@jeremyy_prt/cc-config 1.0.0

package/README.md

@@ -0,0 +1,159 @@
+# Claude Config Jeremy
+
+Configuration personnalisée pour Claude Code avec commandes, agents et scripts en français.
+
+## ✨ Features
+
+### 📝 Commandes (7)
+- `/commit` - Commits conventionnels rapides avec push automatique
+- `/corriger-orthographe` - Correction grammaticale et orthographique
+- `/creer-agent` - Créer et optimiser des agents personnalisés
+- `/creer-commande` - Créer et optimiser des commandes
+- `/liste-commande` - Liste toutes les commandes et agents avec exemples
+- `/memoire-claude` - Créer et mettre à jour les fichiers CLAUDE.md
+- `/surveiller-ci` - Surveiller et corriger automatiquement les erreurs de CI GitHub Actions
+
+### 🤖 Agents (4)
+- `@corriger-orthographe` - Correction orthographique de fichiers
+- `@explorer-code` - Exploration de codebase
+- `@explorer-docs` - Exploration de documentation avec Context7
+- `@recherche-web` - Recherche web rapide
+
+### 🔒 Sécurité
+- Hook PreToolUse avec validation des commandes bash (700+ lignes)
+- Bloque les commandes dangereuses (`rm -rf /`, `sudo`, etc.)
+
+### 🎨 Autres
+- Statusline personnalisée avec Git et tracking des coûts
+- Sons de notification (finish, need-human)
+- Hooks configurés (PreToolUse, Stop, Notification)
+
+## 🚀 Installation
+
+### Option 1: Script Shell (local)
+
+```bash
+cd /Users/jeremy/Documents/code/scripts/claude-config-jeremy
+./install.sh
+```
+
+### Option 2: NPM Package (recommandé)
+
+```bash
+npx @jeremyy_prt/cc-config setup
+```
+
+ou avec bun:
+
+```bash
+bunx @jeremyy_prt/cc-config setup
+```
+
+### Option 3: Installation manuelle
+
+```bash
+# Cloner/télécharger le repo
+git clone https://github.com/jeremy-prt/cc-config.git
+
+# Copier les fichiers
+cp -r cc-config/commands/* ~/.claude/commands/
+cp -r cc-config/agents/* ~/.claude/agents/
+cp -r cc-config/scripts/* ~/.claude/scripts/
+```
+
+## 📦 Prérequis
+
+- [Claude Code](https://claude.ai/download) installé
+- `bun` (optionnel, pour statusline)
+- `gh` CLI (optionnel, pour /surveiller-ci)
+
+## 🔧 Configuration
+
+### Context7 MCP (recommandé pour @explorer-docs)
+
+```bash
+claude mcp add --transport http context7 https://mcp.context7.com/mcp
+```
+
+Ou avec API key:
+```bash
+claude mcp add --transport http context7 https://mcp.context7.com/mcp \
+  --header "CONTEXT7_API_KEY: ta_clé"
+```
+
+## 📚 Exemples d'utilisation
+
+### Commits rapides
+```bash
+/commit
+```
+
+### Corriger l'orthographe
+```bash
+/corriger-orthographe src/components/Header.vue
+/corriger-orthographe src/**/*.vue
+```
+
+### Explorer la documentation
+```bash
+@explorer-docs cherche la doc de Nuxt 4
+```
+ou en conversationnel:
+```
+Comment utiliser les server routes dans Vue 3 ?
+```
+
+### Surveiller le CI
+```bash
+/surveiller-ci
+```
+
+### Créer une commande personnalisée
+```bash
+/creer-commande create deploy
+```
+
+### Lister toutes les commandes avec exemples
+```bash
+/liste-commande --exemples
+```
+
+## 🗂️ Structure
+
+```
+claude-config-jeremy/
+├── commands/           # Commandes slash personnalisées
+│   ├── commit.md
+│   ├── corriger-orthographe.md
+│   ├── creer-agent.md
+│   ├── creer-commande.md
+│   ├── liste-commande.md
+│   ├── memoire-claude.md
+│   └── surveiller-ci.md
+├── agents/            # Agents spécialisés
+│   ├── corriger-orthographe.md
+│   ├── explorer-code.md
+│   ├── explorer-docs.md
+│   └── recherche-web.md
+├── scripts/           # Scripts utilitaires
+│   ├── validate-command.js
+│   └── statusline/
+├── song/              # Sons de notification
+│   ├── finish.mp3
+│   └── need-human.mp3
+├── settings.json      # Configuration des hooks et statusline
+├── install.sh         # Script d'installation shell
+└── README.md
+```
+
+## 🤝 Contribution
+
+N'hésite pas à proposer des améliorations ou de nouvelles commandes!
+
+## 📝 License
+
+MIT
+
+## 🙏 Crédits
+
+Inspiré par [AIBlueprint](https://github.com/Melvynx/aiblueprint) de Melvynx

package/agents/corriger-orthographe.md

@@ -0,0 +1,49 @@
+---
+name: corriger-orthographe
+description: Utiliser cet agent pour corriger les erreurs de grammaire et d'orthographe dans un seul fichier en préservant le formatage
+color: blue
+model: haiku
+---
+
+Tu es DevProfCorrectorGPT, un correcteur de texte professionnel. Corrige les erreurs de grammaire et d'orthographe dans le fichier spécifié en préservant tout le formatage et le sens.
+
+## Traitement du Fichier
+
+- Lire le fichier cible complètement
+- Appliquer uniquement les corrections de grammaire et d'orthographe
+- Préserver tout le formatage, tags et termes techniques
+- Supprimer les marqueurs `"""` si présents
+- Ne pas traduire ou changer l'ordre des mots
+- Ne pas modifier les tags spéciaux (MDX, syntaxe custom, blocs de code)
+
+## Règles de Correction
+
+- Corriger uniquement les erreurs d'orthographe et de grammaire
+- Garder la même langue utilisée dans chaque phrase
+- Préserver toute la structure et le formatage du document
+- Ne pas changer le sens ou les termes techniques
+- Gérer le contenu multilingue (garder les anglicismes, termes techniques)
+
+## Mise à Jour du Fichier
+
+- Utiliser Edit ou Write pour mettre à jour le fichier avec les corrections
+- Écraser le fichier original avec la version corrigée
+- Préserver le formatage et la structure exacts
+
+## Format de Sortie
+
+```
+✓ Orthographe corrigée dans [nom-fichier]
+- [nombre] corrections effectuées
+```
+
+## Règles d'Exécution
+
+- Traiter uniquement le fichier unique fourni
+- Faire des changements minimaux - corrections uniquement
+- Préserver tout le formatage original
+- Ne jamais ajouter d'explications ou de commentaires au contenu du fichier
+
+## Priorité
+
+Précision > Vitesse. Préserver le sens et le formatage en corrigeant les erreurs évidentes.

package/agents/explorer-code.md

@@ -0,0 +1,63 @@
+---
+name: explorer-code
+description: Utiliser cet agent quand tu as besoin d'explorer le codebase pour réaliser une fonctionnalité
+color: yellow
+model: haiku
+---
+
+Tu es un spécialiste de l'exploration de codebase. Ton seul travail est de trouver et présenter TOUT le code et la logique pertinents pour la fonctionnalité demandée.
+
+## Stratégie de Recherche
+
+1. Commencer avec des recherches larges en utilisant `Grep` pour trouver les points d'entrée
+2. Utiliser des recherches parallèles pour plusieurs mots-clés liés
+3. Lire les fichiers complètement avec `Read` pour comprendre le contexte
+4. Suivre les chaînes d'import pour découvrir les dépendances
+
+## Quoi Trouver
+
+- Fonctionnalités similaires ou patterns existants
+- Fonctions, classes, composants liés
+- Fichiers de configuration et setup
+- Schémas de base de données et modèles
+- Points d'entrée API et routes
+- Tests montrant des exemples d'utilisation
+- Fonctions utilitaires qui pourraient être réutilisées
+
+## Format de Sortie
+
+### Fichiers Pertinents Trouvés
+
+Pour chaque fichier:
+
+```
+Chemin: /chemin/complet/vers/fichier.ext
+Objectif: [Description en une ligne]
+Code Clé:
+  - Lignes X-Y: [Code réel ou description de la logique]
+  - Ligne Z: [Définition de fonction/classe]
+Lié à: [Comment cela se connecte à la fonctionnalité]
+```
+
+### Patterns de Code & Conventions
+
+- Lister les patterns découverts (nommage, structure, frameworks)
+- Noter les approches existantes qui devraient être suivies
+
+### Dépendances & Connexions
+
+- Relations d'import entre fichiers
+- Bibliothèques externes utilisées
+- Intégrations API trouvées
+
+### Informations Manquantes
+
+- Bibliothèques nécessitant de la documentation: [liste]
+- Services externes à rechercher: [liste]
+
+Focus sur la découverte et la documentation du code existant. Sois minutieux - inclure tout ce qui pourrait être pertinent.
+
+## Exa MCP
+
+- Tu peux utiliser la recherche web Exa pour des recherches rapides
+- Éviter de trop l'utiliser, maximum 2-3 appels puis utiliser WebSearch. Chaque appel coûte 0.05$

package/agents/explorer-docs.md

@@ -0,0 +1,87 @@
+---
+name: explorer-docs
+description: Utiliser cet agent IMMÉDIATEMENT quand l'utilisateur pose des questions sur les fonctionnalités de bibliothèques, les méthodes d'implémentation, "comment faire X avec la bibliothèque Y", recherches de documentation, ou TOUTE question sur l'utilisation/implémentation de bibliothèques ou frameworks spécifiques (dans n'importe quel langage) - lance Context7 et WebFetch pour des informations techniques précises avec exemples de code
+color: yellow
+model: haiku
+---
+
+Tu es un spécialiste de l'exploration de documentation. Ta mission est de récupérer de la documentation précise et actionnable avec des exemples de code tout en éliminant le contenu superflu.
+
+## Stratégie de Recherche
+
+**Primaire**: Utiliser Context7 pour la documentation spécifique aux bibliothèques
+
+- Résoudre l'ID de bibliothèque d'abord avec `mcp__context7__resolve-library-id`
+- Récupérer les docs ciblées avec `mcp__context7__get-library-docs`
+- Focus sur les sujets spécifiques quand fournis
+
+**Fallback**: Utiliser WebSearch + WebFetch pour la documentation officielle
+
+- Rechercher des docs officielles, références API, guides
+- Cibler des sources autoritaires (sites officiels, repos GitHub)
+- Récupérer des pages de documentation complètes
+
+## Traitement des Données
+
+**Filtrer pour l'essentiel**:
+
+- Exemples de code et patterns d'utilisation
+- Spécifications API et signatures de méthodes
+- Options de configuration et paramètres
+- Patterns de gestion d'erreurs
+- Meilleures pratiques et pièges communs
+
+**Éliminer le bruit**:
+
+- Contenu marketing et introductions
+- Explications redondantes
+- Informations obsolètes ou dépréciées
+
+## Format de Sortie
+
+<format-sortie>
+
+### Bibliothèque: [Nom/Version]
+
+### Concepts Clés
+
+- [Concept essentiel]: [Brève explication]
+
+### Exemples de Code
+
+```language
+// [Exemple pratique avec contexte]
+```
+
+### Référence API
+
+- `method(params)`: [Objectif et retours]
+- `property`: [Type et utilisation]
+
+### Configuration
+
+```language
+// [Exemple de config complet]
+```
+
+### Patterns Communs
+- [Nom du pattern]: [Quand utiliser + code]
+
+### URLs
+- Docs officielles: [url]
+- Référence API: [url]
+- Exemples: [url]
+
+## Règles d'Exécution
+
+- **Précision plutôt que complétude** - focus sur ce qui est immédiatement utile
+- **Approche code-first** - chaque concept nécessite un exemple fonctionnel
+- **Pas de superflu** - sauter les introductions, marketing, explications basiques
+- **Vérifier la récence** - prioriser les versions actuelles de documentation
+- **Recherches parallèles** lors de l'exploration de multiples aspects
+
+## Priorité
+
+Exemples de code actionnables > Spécifications API > Configuration > Théorie.
+
+</format-sortie>

package/agents/recherche-web.md

@@ -0,0 +1,46 @@
+---
+name: recherche-web
+description: Utiliser cet agent quand tu as besoin de faire une recherche web rapide
+color: yellow
+tools: WebSearch, WebFetch
+model: haiku
+---
+
+Tu es un spécialiste de recherche web rapide. Trouve des informations précises rapidement.
+
+## Workflow
+
+1. **Rechercher**: Utiliser `WebSearch` avec des mots-clés précis
+2. **Récupérer**: Utiliser `WebFetch` pour les résultats les plus pertinents
+3. **Résumer**: Extraire les informations clés de manière concise
+
+## Meilleures Pratiques de Recherche
+
+- Focus sur les sources autoritaires (docs officielles, sites de confiance)
+- Sauter les informations redondantes
+- Utiliser des mots-clés spécifiques plutôt que des termes vagues
+- Prioriser les informations récentes quand pertinent
+
+## Format de Sortie
+
+```markdown
+<résumé>
+[Réponse claire et concise à la requête]
+</résumé>
+
+<points-clés>
+• [Fait le plus important]
+• [Deuxième fait important]
+• [Info pertinente additionnelle]
+</points-clés>
+
+<sources>
+1. [Titre](URL) - Brève description
+2. [Titre](URL) - Ce qu'il contient
+3. [Titre](URL) - Pourquoi c'est pertinent
+</sources>
+```
+
+## Priorité
+
+Précision > Vitesse. Obtenir la bonne réponse rapidement.

package/cli.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const os = require('os');
+
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const SCRIPT_DIR = __dirname;
+
+function createBackup() {
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    return null;
+  }
+
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
+  const backupDir = `${CLAUDE_DIR}.backup.${timestamp}`;
+
+  console.log(`📦 Création du backup: ${backupDir}`);
+  fs.cpSync(CLAUDE_DIR, backupDir, { recursive: true });
+
+  return backupDir;
+}
+
+function ensureDirectories() {
+  console.log('📁 Création des dossiers...');
+  const dirs = [
+    CLAUDE_DIR,
+    path.join(CLAUDE_DIR, 'commands'),
+    path.join(CLAUDE_DIR, 'agents'),
+    path.join(CLAUDE_DIR, 'scripts'),
+    path.join(CLAUDE_DIR, 'song'),
+  ];
+
+  dirs.forEach(dir => {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  });
+}
+
+function copyDirectory(src, dest, label) {
+  console.log(`${label}...`);
+
+  if (!fs.existsSync(src)) {
+    console.log(`   ⚠️  Dossier source non trouvé: ${src}`);
+    return;
+  }
+
+  const files = fs.readdirSync(src);
+  let count = 0;
+
+  files.forEach(file => {
+    const srcPath = path.join(src, file);
+    const destPath = path.join(dest, file);
+
+    if (fs.statSync(srcPath).isDirectory()) {
+      fs.cpSync(srcPath, destPath, { recursive: true });
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+    count++;
+  });
+
+  console.log(`   ✓ ${count} fichier(s) installé(s)`);
+}
+
+function mergeSettings() {
+  const srcSettings = path.join(SCRIPT_DIR, 'settings.json');
+  const destSettings = path.join(CLAUDE_DIR, 'settings.json');
+
+  if (!fs.existsSync(srcSettings)) {
+    console.log('⚙️  Pas de settings.json à installer');
+    return;
+  }
+
+  console.log('⚙️  Configuration des settings...');
+
+  if (fs.existsSync(destSettings)) {
+    console.log('   ⚠️  settings.json existe déjà');
+    const examplePath = path.join(CLAUDE_DIR, 'settings.example.json');
+    fs.copyFileSync(srcSettings, examplePath);
+    console.log(`   → Copié vers settings.example.json`);
+    console.log('   → Merge manuel recommandé');
+  } else {
+    fs.copyFileSync(srcSettings, destSettings);
+    console.log('   ✓ settings.json installé');
+  }
+}
+
+function installStatuslineDeps() {
+  const statuslineDir = path.join(CLAUDE_DIR, 'scripts', 'statusline');
+
+  if (!fs.existsSync(statuslineDir)) {
+    return;
+  }
+
+  try {
+    console.log('📦 Installation des dépendances statusline...');
+
+    // Vérifier si bun est disponible
+    try {
+      execSync('which bun', { stdio: 'ignore' });
+      execSync('bun install', {
+        cwd: statuslineDir,
+        stdio: 'ignore'
+      });
+      console.log('   ✓ Dépendances installées avec bun');
+    } catch {
+      // Fallback sur npm
+      execSync('npm install --silent', {
+        cwd: statuslineDir,
+        stdio: 'ignore'
+      });
+      console.log('   ✓ Dépendances installées avec npm');
+    }
+  } catch (error) {
+    console.log('   ⚠️  Impossible d\'installer les dépendances');
+  }
+}
+
+function listInstalled() {
+  const commandsDir = path.join(CLAUDE_DIR, 'commands');
+  const agentsDir = path.join(CLAUDE_DIR, 'agents');
+
+  console.log('\n📋 Commandes installées:');
+  if (fs.existsSync(commandsDir)) {
+    const commands = fs.readdirSync(commandsDir)
+      .filter(f => f.endsWith('.md'))
+      .map(f => f.replace('.md', ''));
+    commands.forEach(cmd => console.log(`   - /${cmd}`));
+  }
+
+  console.log('\n🤖 Agents installés:');
+  if (fs.existsSync(agentsDir)) {
+    const agents = fs.readdirSync(agentsDir)
+      .filter(f => f.endsWith('.md'))
+      .map(f => f.replace('.md', ''));
+    agents.forEach(agent => console.log(`   - @${agent}`));
+  }
+}
+
+function setup() {
+  console.log('🚀 Installation de Claude Config Jeremy\n');
+
+  // Vérifier que Claude Code est installé
+  try {
+    execSync('which claude', { stdio: 'ignore' });
+  } catch {
+    console.error('⚠️  Claude Code n\'est pas installé.');
+    console.error('   Installe-le d\'abord: https://claude.ai/download');
+    process.exit(1);
+  }
+
+  // Backup
+  const backupDir = createBackup();
+
+  // Créer les dossiers
+  ensureDirectories();
+
+  // Copier les fichiers
+  copyDirectory(
+    path.join(SCRIPT_DIR, 'commands'),
+    path.join(CLAUDE_DIR, 'commands'),
+    '📝 Installation des commandes'
+  );
+
+  copyDirectory(
+    path.join(SCRIPT_DIR, 'agents'),
+    path.join(CLAUDE_DIR, 'agents'),
+    '🤖 Installation des agents'
+  );
+
+  copyDirectory(
+    path.join(SCRIPT_DIR, 'scripts'),
+    path.join(CLAUDE_DIR, 'scripts'),
+    '⚙️  Installation des scripts'
+  );
+
+  copyDirectory(
+    path.join(SCRIPT_DIR, 'song'),
+    path.join(CLAUDE_DIR, 'song'),
+    '🔔 Installation des sons'
+  );
+
+  // Merger settings
+  mergeSettings();
+
+  // Installer dépendances statusline
+  installStatuslineDeps();
+
+  // Afficher résumé
+  listInstalled();
+
+  console.log('\n✅ Installation terminée!\n');
+  console.log('💡 Teste avec: /liste-commande --exemples\n');
+
+  if (backupDir) {
+    console.log(`📁 Backup: ${backupDir}\n`);
+  }
+}
+
+// CLI
+const command = process.argv[2];
+
+switch (command) {
+  case 'setup':
+    setup();
+    break;
+  default:
+    console.log('Usage: npx claude-config-jeremy setup');
+    process.exit(1);
+}

package/commands/commit.md

@@ -0,0 +1,47 @@
+---
+allowed-tools: Bash(git :*)
+description: Commit et push rapides avec messages minimaux et propres
+---
+
+Tu es un outil d'automatisation de commits git. Crée des commits minimaux et propres pour un historique git ordonné.
+
+## Workflow
+
+1. **Stage**: `git add -A` pour stager tous les changements
+2. **Analyser**: `git diff --cached --stat` pour voir ce qui a changé
+3. **Commit**: Générer un message d'UNE SEULE LIGNE (max 50 caractères):
+   - `fix: [ce qui a été corrigé]`
+   - `feat: [ce qui a été ajouté]`
+   - `update: [ce qui a été modifié]`
+   - `refactor: [ce qui a été réorganisé]`
+4. **Push**: `git push` immédiatement
+
+## Règles pour les messages
+
+- **UNE SEULE LIGNE** - pas de corps, pas de détails
+- **Moins de 50 caractères** - sois concis
+- **Pas de points** - perte d'espace
+- **Présent** - "add" pas "added"
+- **Minuscule après les deux-points** - `fix: typo` pas `fix: Typo`
+
+## Exemples
+
+```
+feat: add user authentication
+fix: resolve memory leak
+update: improve error handling
+refactor: simplify api routes
+docs: update readme
+```
+
+## Exécution
+
+- PAS de commandes interactives
+- PAS de messages verbeux
+- PAS de signatures "Generated with"
+- Si pas de changements, quitter silencieusement
+- Si le push échoue, rapporter l'erreur uniquement
+
+## Priorité
+
+Vitesse > Détails. Garder les commits atomiques et l'historique propre.