commit

Workflow Git Commit

Créer un commit bien formaté avec les arguments : $ARGUMENTS

IMPORTANT : Task Management System obligatoire

RÈGLE CRITIQUE : Chaque étape DOIT être trackée via TaskCreate/TaskUpdate.

• Créer TOUTES les tâches AVANT de commencer
• Marquer in_progress au début de chaque étape
• Marquer completed UNIQUEMENT quand l'étape est 100% terminée
• NE JAMAIS sauter une étape

Instructions à Exécuter

Étape 1 : Créer TOUTES les tâches du workflow

OBLIGATOIRE : Utilise TaskCreate pour créer ces 5 tâches dans cet ordre exact :

TaskCreate #1: "Vérifier les changements disponibles"
  - activeForm: "Checking available changes"
  - description: "git status + git diff pour voir les fichiers modifiés"

TaskCreate #2: "Analyser le diff des changements"
  - activeForm: "Analyzing diff content"
  - description: "git diff --cached pour comprendre les changements"

TaskCreate #3: "Déterminer la stratégie de commit"
  - activeForm: "Determining commit strategy"
  - description: "Décider si un ou plusieurs commits sont nécessaires"

TaskCreate #4: "Créer le(s) commit(s)"
  - activeForm: "Creating commit(s)"
  - description: "git commit avec message formaté emoji + conventional"

TaskCreate #5: "Push vers remote"
  - activeForm: "Pushing to remote"
  - description: "git push (sauf si --no-push)"

Après création : Affiche TaskList pour confirmer que les 5 tâches existent.

---

Étape 2 : Vérifier les changements disponibles

TaskUpdate : Tâche #1 -> in_progress

Exécute en parallèle :

git status
git diff --cached --stat

Traitement :

1. SI aucun changement (ni stagé, ni non-stagé) :

   • Affiche "Aucun changement à committer"
   • TaskUpdate : Tâche #1 -> completed
   • STOP - Ne pas continuer

2. SI des fichiers modifiés mais rien de stagé :

   • Exécute git add . pour tout stager
   • Exécute git status pour confirmer

3. SI des fichiers déjà stagés :

   • Continue avec ces fichiers uniquement

TaskUpdate : Tâche #1 -> completed

---

Étape 3 : Analyser le diff des changements

TaskUpdate : Tâche #2 -> in_progress

Exécute en parallèle :

git diff --cached
git log -5 --oneline

Traitement :

1. Lis TOUT le diff des changements stagés
2. Note le style des commits récents du repo
3. Identifie les types de changements présents :
   • feat (nouvelles fonctionnalités)
   • fix (corrections de bugs)
   • docs (documentation)
   • refactor (refactorisation)
   • test (tests)
   • chore (configuration, maintenance)
   • style (formatage)
   • perf (performance)

TaskUpdate : Tâche #2 -> completed

---

Étape 4 : Déterminer la stratégie de commit

TaskUpdate : Tâche #3 -> in_progress

Critères pour DIVISER en plusieurs commits :

1. Préoccupations distinctes (feat + docs + tests mélangés)
2. Types de changements différents (fix + refactor)
3. Fichiers non-liés modifiés ensemble
4. Diff > 200 lignes sur sujets différents

SI plusieurs types détectés :

• Liste les commits à créer
• Pour chaque commit, utilise :

  git reset HEAD <fichiers-à-exclure>
  git commit -m "..."
  git add <fichiers-suivants>
  

SINON :

• Continue avec un seul commit

TaskUpdate : Tâche #3 -> completed

---

Étape 5 : Créer le(s) commit(s)

TaskUpdate : Tâche #4 -> in_progress

Pour CHAQUE commit à créer :

5.1 Déterminer le message

1. Type : feat, fix, docs, refactor, test, chore, style, perf, ci, revert
2. Emoji : Voir table ci-dessous
3. Scope : Optionnel, entre parenthèses (auth, api, ui...)
4. Description : < 72 caractères, mode impératif, présent

5.2 Exécuter le commit

OBLIGATOIRE : Utilise TOUJOURS un HEREDOC pour le message :

git commit -m "$(cat <<'EOF'
<emoji> <type>(<scope>): <description courte>

<détails optionnels - explique le "pourquoi">
EOF
)"

TaskUpdate : Tâche #4 -> completed

---

Étape 6 : Push vers remote

TaskUpdate : Tâche #5 -> in_progress

6.1 Vérifier l'option --no-push

SI --no-push présent dans $ARGUMENTS :

• Affiche "Commit local uniquement (--no-push)"
• TaskUpdate : Tâche #5 -> completed
• STOP - Workflow terminé

6.2 Push automatique

Le hook PostToolUse gère automatiquement :

• Premier push : git push -u origin <branch>
• Push suivants : git push

TaskUpdate : Tâche #5 -> completed

---

Table des Emojis par Type

Type	Emoji	Usage
feat	✨	Nouvelle fonctionnalité
fix	?	Correction de bug
docs	?	Documentation
style	?	Formatage/style (pas de changement de logique)
refactor	♻️	Refactorisation de code
perf	⚡️	Amélioration de performance
test	✅	Ajout/modification de tests
chore	?	Outils, configuration, maintenance
ci	?	CI/CD
revert	⏪️	Annulation de changements

Emojis Spécialisés

Contexte	Emoji	Description
Breaking change	?	Changement cassant
Security	?️	Sécurité
Hotfix	?️	Correction critique urgente
Architecture	?️	Changements architecturaux
Dead code	⚰️	Suppression code mort
Remove files	?	Suppression fichiers
Move/rename	?	Déplacement/renommage

Format du Message de Commit

<emoji> <type>(<scope>): <description impérative courte>

[corps optionnel - explique le "pourquoi" pas le "quoi"]

[footer optionnel - références issues, breaking changes]

Règles du Message

1. Première ligne : < 72 caractères
2. Mode impératif : "ajouter" pas "ajouté"
3. Présent : "corrige" pas "a corrigé"
4. Pas de point final sur la première ligne
5. Ligne vide entre titre et corps
6. Corps : explique le contexte et la raison

Options de Commande

Option	Description
--verify	Exécute make qa avant le commit
--no-push	Ne push pas automatiquement après le commit

Combinaison possible : /devops:commit --verify --no-push

Directives de Division

Divise les commits si tu détectes :

1. feat + docs -> 2 commits séparés
2. fix + refactor -> 2 commits séparés
3. test + implementation -> peut être ensemble si cohérent
4. chore (deps) + feat -> toujours séparés
5. Plusieurs features distinctes -> 1 commit par feature