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 :
  bash

  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
)"

Exemple simple :

git commit -m "$(cat <<'EOF'
✨ feat(auth): ajouter connexion OAuth Google
EOF
)"

Exemple avec corps :

git commit -m "$(cat <<'EOF'
🐛 fix(api): corriger fuite mémoire dans le cache

Le cache ne libérait pas les entrées expirées, causant une
augmentation progressive de la mémoire utilisée.

Fixes #123
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

Checklist de validation finale

Avant de terminer, vérifie que TOUTES ces conditions sont remplies :

• • Tâche #1 completed : Changements vérifiés et stagés
• • Tâche #2 completed : Diff analysé
• • Tâche #3 completed : Stratégie déterminée
• • Tâche #4 completed : Commit(s) créé(s) avec HEREDOC
• • Tâche #5 completed : Push effectué (ou skip si --no-push)

Si une tâche n'est pas completed, NE PAS terminer.

Table des Emojis par Type

Emojis Spécialisés

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

Combinaison possible : /git: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