Glossaire

Tous les mots du workflow, sans jargon

Ce vocabulaire n'est pas décoratif : c'est lui qui permet de comprendre un message d'erreur, de poser une question précise et de lire la documentation d'un outil. Chaque terme est défini en une phrase, avec un exemple concret.

Chercher un terme

IA générative IA et agent

Programme qui produit du texte (ou des images) à partir d'une consigne, en prédisant la suite la plus plausible.

Exemple Écrire une description de projet, traduire un paragraphe, proposer du code.

Modèle de langage (LLM) IA et agent

Le moteur de l'IA générative : un très grand réseau entraîné sur des textes. Il ne « sait » pas, il calcule des probabilités.

Exemple DeepSeek V4.1 Flash est le modèle utilisé dans ce projet.

Token IA et agent

Morceau de mot, unité de mesure du modèle : environ trois à quatre caractères en français.

Exemple Un prompt de dix lignes coûte quelques centaines de tokens ; une session entière, des dizaines de milliers.

Fenêtre de contexte IA et agent

Quantité maximale de texte que le modèle peut lire en une fois : votre demande, l'historique et les fichiers joints.

Exemple Une fenêtre d'un million de tokens peut contenir un gros projet — mais coûte cher si on la remplit.

Prompt IA et agent

La consigne donnée à l'agent. Un bon prompt contient un objectif, du contexte, des contraintes et un critère de réussite.

Exemple « Ajoute une section horaires sous la présentation, sans toucher au pied de page. »

Agent IA et agent

Programme qui combine un modèle de langage et des outils : il lit des fichiers, en écrit, lance des commandes.

Exemple OpenCode est l'agent utilisé ici ; le modèle, lui, ne touche pas aux fichiers.

Mode plan / mode build IA et agent

Deux réglages de l'agent : en plan, il explique sans rien modifier ; en build, il exécute les changements.

Exemple On demande toujours un plan pour une fonctionnalité, puis on bascule en build pour l'appliquer.

Compaction IA et agent

Résumé automatique d'une longue conversation pour libérer de la place dans le contexte et faire baisser le coût.

Exemple La commande /compact d'OpenCode résume la session sans perdre le fil.

Réflexion (thinking) IA et agent

Mode où le modèle écrit son raisonnement avant de répondre. Efficace sur les problèmes difficiles, facturé au prix de la sortie.

Exemple Inutile pour renommer un fichier ; précieux pour comprendre une erreur obscure.

Hallucination IA et agent

Réponse fausse mais formulée avec assurance : une fonction inventée, une bibliothèque qui n'existe pas.

Exemple Un « ça fonctionne, j'ai corrigé » sans test derrière : vérifier soi-même reste obligatoire.

Dépôt (repository) Git et dépôt

Dossier surveillé par Git, avec tout son historique. Sur GitHub, c'est la copie en ligne de ce dossier.

Exemple Le projet workflow.nsi.xyz a son dépôt sur GitHub, en public.

Commit Git et dépôt

Photo de l'état du projet à un instant donné, avec un message. C'est le point de retour du travail.

Exemple « Ajoute la section horaires » : un commit par étape qui fonctionne.

Push / pull Git et dépôt

Envoyer ses commits vers GitHub (push), ou récupérer ceux qui y sont (pull).

Exemple On termine la séance par un push, et on commence la suivante par un pull.

Branche Git et dépôt

Ligne de développement indépendante. Un projet d'élève vit très bien sur une seule branche : main.

Exemple GitHub Pages crée une URL de prévisualisation par branche, mais ce n'est pas nécessaire ici.

Dépôt distant (remote) Git et dépôt

L'adresse du dépôt en ligne auquel on envoie le travail. Par convention : origin.

Exemple git remote -v affiche l'adresse vers laquelle pointe origin.

Clone Git et dépôt

Copie complète d'un dépôt distant, historique compris, sur une machine locale.

Exemple git clone permet de relire un projet sur un autre ordinateur.

Fichier .gitignore Git et dépôt

Liste des fichiers que Git doit ignorer : secrets, dépendances, fichiers de build.

Exemple .env, node_modules/ et dist/ n'ont rien à faire dans un dépôt.

Historique Git et dépôt

Ensemble des commits, du plus ancien au plus récent. Il se relit (git log) et ne s'efface pas facilement.

Exemple Retirer un fichier dans un nouveau commit ne l'efface pas de l'historique.

Build Web et publication

Compilation du projet : les sources (Astro, Markdown, styles) sont transformées en fichiers HTML, CSS et images prêts à être servis.

Exemple npm run build produit le dossier dist/.

Déploiement Web et publication

Mise en ligne du résultat du build sur un hébergeur, avec une adresse publique.

Exemple Cloudflare Pages relit le dépôt, compile et publie à chaque push.

Hébergement statique Web et publication

Service qui distribue des fichiers déjà préparés, sans calcul côté serveur. Rapide, peu coûteux, sans base de données.

Exemple Cloudflare Pages est un hébergement statique : une landing page y est chez elle.

URL de prévisualisation Web et publication

Adresse temporaire d'une version non publiée, créée automatiquement pour une branche ou une proposition de modification.

Exemple Elle sert à faire relire une modification, pas à être partagée comme adresse officielle.

Domaine personnalisé (CNAME) Web et publication

Nom de domaine propre (mon-projet.nsi.xyz) rattaché à l'hébergement. Chez Cloudflare Pages, il faut créer soi-même l'enregistrement CNAME.

Exemple Sans ce CNAME, le domaine reste en « pending » et le certificat n'est pas émis.

Pages Functions Web et publication

Petites fonctions exécutées par l'hébergeur, déployées avec le site : elles permettent une API, un formulaire, un accès à un stockage.

Exemple L'API du journal des prompts (dépôt, statistiques, espace prof) est faite de Pages Functions.

Secret Sécurité

Information qui donne un accès : clé d'API, jeton, mot de passe, cookie de session. Elle ne se publie jamais.

Exemple La clé DeepSeek vit dans .env en local et dans les réglages Cloudflare en production.

Clé d'API Sécurité

Longue chaîne fournie par un service pour identifier et facturer vos appels. Elle se comporte comme un mot de passe.

Exemple Une clé DeepSeek commence par sk- et ne s'affiche qu'une seule fois.

Empreinte (hash) Sécurité

Résultat d'un calcul irréversible appliqué à une donnée : impossible de remonter au texte d'origine.

Exemple Le journal des prompts ne stocke que l'empreinte SHA-256 du code élève.

Rotation d'une clé Sécurité

Révoquer un secret exposé puis en créer un nouveau. C'est la première action en cas de fuite, avant tout nettoyage.

Exemple Une clé poussée sur GitHub est publique dès la seconde : on la tourne immédiatement.

Données personnelles (RGPD) Sécurité

Informations qui identifient une personne : nom, téléphone, adresse, photo, date de naissance, notes. À ne jamais publier ni envoyer dans un prompt.

Exemple Ce site ne collecte aucune donnée personnelle : les dépôts sont liés à une empreinte de code.

Injection de prompt Sécurité

Contenu (page, fichier, message) qui contient des instructions cachées destinées à détourner l'agent.

Exemple Avant d'exécuter une consigne trouvée dans un fichier, se demander si elle vient bien de vous.

Environnement de développement Projet

Tout ce qui tourne sur votre machine pour construire le projet : l'éditeur, le terminal, Node, l'agent, un navigateur de test.

Exemple Il ne faut pas confondre ce qui marche « chez vous » et ce qui marche en production.

Terminal Projet

Interface textuelle où l'on tape des commandes. Le dossier courant y est déterminant : c'est là que l'agent travaille.

Exemple Vérifier le dossier avant de lancer opencode évite la moitié des malentendus.

Dépendance Projet

Bibliothèque externe dont le projet a besoin, déclarée dans package.json et installée dans node_modules/.

Exemple Astro est une dépendance ; node_modules/ n'est jamais poussé, seulement reconstruit avec npm install.

README Projet

Fichier qui dit ce que fait le projet et comment le lancer. C'est la première chose que lit un visiteur du dépôt.

Exemple Un README à jour permet de relancer le projet six mois plus tard, sans rien deviner.

AGENTS.md Projet

Document que l'agent écrit à la première session (/init) : il décrit la structure du projet et ses conventions, et sert de contexte permanent.

Exemple Il se relit et se commite comme n'importe quel fichier du projet.

Numéro de version (build) Projet

Compteur incrémenté à chaque mise en production : le « build #12 » permet de savoir quelle version est en ligne.

Exemple Le pied de page de ce site affiche le numéro de build en cours.

Aucun terme ne correspond à cette recherche.

Trois familles à ne pas confondre

Pour aller plus loin