Notion · Pratique et outillage

Git et GitHub

Git enregistre l’historique d’un projet : qui a changé quoi, quand, et on peut revenir en arrière. GitHub est le site où l’on héberge ce projet et où l’on collabore. Avec un agent de code, c’est le filet de sécurité.

Comment ça marche

Git garde l’historique d’un dossier : à chaque fois qu’on enregistre, un commit, il photographie l’état des fichiers, avec un message qui dit ce qui a changé et pourquoi. On peut ensuite relire l’historique, voir exactement ce qui a été modifié entre deux états, et revenir à n’importe quel point. Les branches permettent d’essayer quelque chose à côté sans toucher à la version principale.

Avec un agent qui écrit dans vos fichiers, Git change de statut : il devient le filet de sécurité. Chaque intervention de l’agent se relit ligne par ligne avant d’être acceptée. Une modification malheureuse s’annule en une commande. GitHub ajoute le partage avec l’équipe, les demandes de modification à relire (pull requests), et des automatisations qui lancent les tests à chaque changement. Sans Git, travailler avec un agent, c’est travailler sans annuler.

Un exemple concret

ExempleL’après-midi où Git a sauvé la documentation d’un cabinet
  1. La tâche : un agent doit harmoniser le vocabulaire dans 80 fiches de procédures en Markdown, rangées dans un dossier sous Git.
  2. Le résultat : l’agent annonce 80 fichiers modifiés. Le responsable regarde les différences : dans 12 fiches, l’agent a aussi « simplifié » des paragraphes, supprimant des précisions réglementaires.
  3. Le geste : il annule les modifications de ces 12 fiches en une commande, garde les 68 autres, et relance l’agent sur les 12 avec une consigne plus stricte : « change uniquement les termes de la liste, rien d’autre ».
  4. Sans Git : il aurait fallu relire 80 fiches en entier pour trouver les 12, puis retrouver les précisions supprimées de mémoire.

Le commit avant la tâche a pris dix secondes. C’est le geste le plus rentable de la journée.

Ce que ça change pour une équipe

  • On peut déléguer sans peur. Tout ce que l’agent fait se voit et s’annule. La délégation devient réversible.
  • Chaque changement est relu. La différence avant/après, ligne par ligne, est le support naturel de la revue.
  • L’historique explique. Pourquoi ce fichier est-il ainsi ? Le journal des commits, avec ses messages, répond.
  • La collaboration a un cadre. Plusieurs personnes et plusieurs agents sur le même projet, sans écraser le travail des autres.

Les limites et les erreurs fréquentes

  • Lancer l’agent sans commit préalable. Il n’y a plus d’état « avant » auquel revenir. Commit d’abord, toujours.
  • Accepter en bloc. Quarante fichiers modifiés, validés d’un clic. La relecture des différences est l’étape qui compte.
  • Mettre des secrets dans Git. Un mot de passe commité reste dans l’historique même après suppression. Les secrets vont ailleurs, et les fichiers qui les contiennent sont exclus.
  • Garder tout sur un seul ordinateur. Git sans dépôt distant (GitHub ou autre) n’est pas une sauvegarde. Le dépôt distant l’est.

Pour aller plus loin

Git gère des versions locales et des branches ; GitHub ajoute l’hébergement, les pull requests, la revue et l’automatisation. Un agent qui travaille dans un dépôt Git permet de relire chaque changement et d’annuler ce qui ne va pas.

Où ça se situe chez Opora

Programme 04 · Construire des agentsIngénierie agentique pour les équipes techniques

Mettre un projet sous Git avant d’y lancer un agent, et relire chaque changement avant de l’accepter, c’est une règle que nous appliquons dès la première session du programme Construire des agents.

Voir le programme

Questions fréquentes

Git et GitHub, c’est la même chose ?

Non. Git est l’outil, installé sur votre ordinateur, qui enregistre les versions d’un projet. GitHub est un site qui héberge des projets Git et ajoute la collaboration : partage, relecture des changements, automatisations. On peut utiliser Git sans GitHub ; l’inverse n’a pas de sens. Des alternatives à GitHub existent, comme GitLab.

Git, c’est seulement pour le code ?

C’est conçu pour les fichiers texte : code, mais aussi documents Markdown, configurations, données en CSV. Pour ces fichiers, Git montre ligne par ligne ce qui a changé. Pour les documents Word ou les images, il garde les versions mais ne montre pas les différences.

Faut-il apprendre Git pour travailler avec un agent ?

Trois gestes suffisent : enregistrer l’état actuel (commit), voir ce qui a changé (diff), revenir en arrière. L’agent fait le reste sur demande, et explique. Comprendre le principe compte plus que connaître les commandes.

Relions ce sujetà votre situation.

Venez avec une situation de travail. Regardons ensemble ce qui peut évoluer : une pratique, une équipe, un outil.