SimpleClient-releases/CLAUDE.md

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 :

## [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 :

"version": "1.2.16",

Option 2 - Avec npm (si le repo est clean) :

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 :

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 :

# Linux
npx electron-builder --linux --x64

# Windows
npx electron-builder --win

# macOS
npx electron-builder --mac

📌 Exemple complet

# 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