diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..b99ff86 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,122 @@ +# Instructions pour Claude - Workflow de développement + +## 📋 Processus de finalisation des modifications + +Lorsqu'une fonctionnalité ou correction est terminée, suivre systématiquement ce workflow : + +### 1. 📝 Mettre à jour le changelog + +**Fichier** : `docs/changelog.md` + +- Ajouter une nouvelle section avec le numéro de version suivant +- Format de date : `AAAA-MM-JJ` +- Structurer les changements par catégories : + - **Ajouté** : Nouvelles fonctionnalités + - **Modifié** : Changements aux fonctionnalités existantes + - **Corrigé** : Corrections de bugs + - **Supprimé** : Fonctionnalités retirées + - **Technique** : Détails d'implémentation + - **Documentation** : Mises à jour de docs + +Exemple : +```markdown +## [1.2.16] - 2025-09-05 + +### Ajouté +- **Titre de la fonctionnalité** : Description courte + - Détail spécifique avec bullet points + - Autre détail important +``` + +### 2. 🔢 Bump de version + +**Fichier** : `package.json` + +Mettre à jour le champ `"version"` selon la convention SemVer : + +- **PATCH** (x.x.+1) : Corrections de bugs, petits ajustements +- **MINOR** (x.+1.0) : Nouvelles fonctionnalités compatibles +- **MAJOR** (+1.0.0) : Changements majeurs non rétrocompatibles + +**Méthodes** : + +Option 1 - Manuellement : +```json +"version": "1.2.16", +``` + +Option 2 - Avec npm (si le repo est clean) : +```bash +npm version patch # ou minor/major +npm version 1.2.16 # version spécifique +``` + +### 3. 📦 Commit Git + +Faire un commit structuré avec tous les changements : + +```bash +git add -A +git commit -m "type: Description courte + +- Détail important 1 +- Détail important 2 +- Bump version X.X.X" +``` + +**Types de commit** : +- `feat:` Nouvelle fonctionnalité +- `fix:` Correction de bug +- `refactor:` Refactoring de code +- `docs:` Documentation +- `style:` Formatage, style +- `chore:` Maintenance + +### 4. 🏗️ Build (optionnel) + +Si nécessaire, créer les builds de distribution : + +```bash +# Linux +npx electron-builder --linux --x64 + +# Windows +npx electron-builder --win + +# macOS +npx electron-builder --mac +``` + +## 📌 Exemple complet + +```bash +# 1. Éditer docs/changelog.md avec la nouvelle version +# 2. Éditer package.json pour bumper la version +# 3. Commit +git add -A +git commit -m "feat: Ajout système de logging SignalR et corrections UI + +- Système de logging complet dans ~/.simpleconnect-ng/signalr.log +- Remplacement des emojis par icônes SVG +- Suppression du menu Electron +- Bump version 1.2.16" + +# 4. Build si nécessaire +npx electron-builder --linux --x64 +``` + +## ⚠️ Points d'attention + +1. **Toujours** mettre à jour le changelog AVANT de bumper la version +2. **Vérifier** que la version dans le changelog correspond à celle du package.json +3. **Inclure** "Bump version X.X.X" dans le message de commit +4. **Ne pas** référencer Claude ou Anthropic dans les commits +5. **Utiliser** la date du jour (vérifier avec `date` si nécessaire) + +## 🎯 Objectif + +Ce workflow garantit : +- Une traçabilité complète des changements +- Des versions cohérentes entre documentation et code +- Un historique Git propre et informatif +- Une facilité de génération des releases \ No newline at end of file