Git dès la première minute : historiser chaque pas

Prérequis : installer ses outils (chapitre 01).

Pourquoi Git avant tout le reste

Avec l’IA, vous allez modifier beaucoup de code très vite. Sans historique, une mauvaise proposition peut effacer une heure de travail. Avec Git, chaque étape validée est sauvegardée : vous expérimentez sans peur.

Étape 1 : créer le dépôt

1. Créez un compte sur gitlab.com et un projet vide nommé montour.
2. Ajoutez votre clé SSH dans les préférences GitLab.
3. Clonez le projet.

ssh-keygen -t ed25519 -C "vous@exemple.fr"
cat ~/.ssh/id_ed25519.pub   # à coller dans GitLab > Préférences > Clés SSH
git clone git@gitlab.com:votre-compte/montour.git
cd montour

Étape 2 : le premier commit

echo "# MonTour" > README.md
cp ../NOTES.md .            # votre fiche projet du chapitre 1
printf ".env*\nnode_modules/\n.next/\n" > .gitignore
git add README.md NOTES.md .gitignore
git commit -m "chore: initialise le projet MonTour"
git push origin main

Étape 3 : la routine à chaque modification de l’IA

git status            # quels fichiers ont changé ?
git diff              # quoi exactement ? Lisez tout.
git add -p            # validez morceau par morceau
git commit -m "feat: ajoute le calcul de position"

Messages courts, au présent, préfixés : feat (fonctionnalité), fix (correction), test, chore (outillage), sec (sécurité).

Étape 4 : une branche par fonctionnalité

git switch -c feat/page-publique
# ... travail, commits ...
git push -u origin feat/page-publique
# puis ouvrez une merge request dans GitLab

Étape 5 : annuler quand l’IA casse tout

git restore .                 # oublie les modifications non commitées
git restore --staged fichier  # retire un fichier de l'index
git revert <sha>              # annule un commit déjà poussé, proprement
git log --oneline -10         # retrouver le bon point

Étape 6 : un tag à la fin de chaque chapitre

Chaque prompt reproductible de la formation part d’un état précis du dépôt. Pour le retrouver, posez un tag à la fin de chaque chapitre : ch02, ch03… Le prompt du chapitre 15 commence ainsi par « Point de départ : tag ch14 ».

git tag ch02
git push origin ch02
# revenir à cet état dans un dossier à part, sans rien casser
git worktree add ../montour-ch02 ch02

Le prompt reproductible

Même point de départ, même contexte, même résultat : partez du tag indiqué et collez ce prompt tel quel.

Point de départ : tag ch01 (dépôt avec README.md, NOTES.md, .gitignore).
Tâche : voici la sortie de git diff --staged : <colle-la>.
Propose UN message de commit au format conventionnel
(feat|fix|test|chore|sec|docs|refactor): description au présent,
72 caractères maximum, en français.
Si le diff mélange plusieurs sujets, dis-le et propose le découpage
avec git add -p au lieu d'un message.

Qualité du code : ce que vous vérifiez

• Petits commits : un sujet par commit, c’est ce qui rend un git revert sans risque.
• Messages conventionnels : l’historique devient lisible par vous, par l’équipe et par un agent (voir le relecteur).
• Défensif : .gitignore avant le premier commit, branche main protégée, jamais de force-push sur une branche partagée.
• Sans IA : git status, git diff, git add -p et git restore doivent devenir des réflexes.

Vérifier

• ☐ Le dépôt existe sur GitLab avec 1 commit sur main.
• ☐ Je sais lire un git diff avant de valider.
• ☐ J’ai annulé une modification de l’IA avec git restore.
• ☐ J’ai poussé une branche et ouvert une merge request.

Pour aller plus loin

• Chapitre suivant : créer l’application Next.js
• Le pipeline qui vérifie chaque push (chapitre 04)
• Les garde-fous des agents : branches et merge requests (chapitre 32)