Développer avec des agents

01 / 41Reconnect · Romain, Ashad et Nils · 15 septembre 2026

Développer avec des agents

Une méthode en 5 étapes. Un support à garder.

  1. 9h00 · Prendre en main

    Exercices courts sur les outils et le ticket.

  2. 9h40 · Préparer le lancement

    Contrat commun, puis agents par lot.

  3. 12h15 · Montrer le MVP

    Un besoin, une réponse, une structure, un contact.

Commencer

Commencez par votre besoin du jour.

Théorie

Cette journée prolonge les landing pages et le projet React, Vite et TypeScript commencés ensemble. Les horaires sont des objectifs pédagogiques proposés pour le 15 septembre, pas des délais garantis d’exécution des agents. La matinée alterne exercices courts, production déléguée, cours et recette. Le support reste consultable ensuite, même sans réseau.

02 / 41Ouverture

Projeter maintenant. Retrouver ensuite.

Lisez l’essentiel à l’écran ; ouvrez « Théorie » pour approfondir.

  1. Parcourir

    Flèches, défilement ou sommaire.

  2. Copier

    Un prompt ou une commande par méthode.

  3. Approfondir

    Explications, limites et sources dans « Théorie ».

  4. Emporter

    Le deck, le PowerPoint et le kit local.

Ouvrez une fiche « Théorie », puis refermez-la.

Théorie

Le titre donne l’idée principale de chaque écran. Les zones courtes permettent de suivre la projection sans lire un document entier. Le panneau Théorie apporte le raisonnement et les limites utiles en situation de travail. Les skills du kit sont fournis comme fichiers : ils deviennent disponibles après copie dans le projet et ouverture de Claude Code.

03 / 41La méthode

Un agent avance dans une boucle

Lire → planifier → agir → vérifier → recommencer.

  1. Lire

    Trouver les fichiers et comprendre le besoin.

  2. Planifier

    Choisir une prochaine action limitée.

  3. Agir

    Appeler un outil, modifier, exécuter.

  4. Vérifier

    Comparer le résultat au critère Done.

Prompt à copier
Lis le ticket et les fichiers attribués.
Propose un plan en trois actions avec une preuve par action.
Attends mon retour avant de modifier les fichiers.

Exercice · 2 min : repérez la prochaine preuve de votre ticket.

Théorie

Le modèle propose des actions ; le logiciel agent lui donne accès à des outils et lui renvoie leurs résultats. Cette boucle permet de travailler sur un dépôt réel, au-delà d’une réponse textuelle. Elle ne garantit ni une bonne compréhension initiale ni la justesse du résultat final. Votre rôle consiste à fournir l’objectif, les limites et une preuve observable de réussite.

SourcesClaude Code · consulté le 14/09/2026

04 / 41La méthode

Nommer ce qui décide et ce qui agit

Quatre mots pour comprendre une session d’agent.

  1. Modèle

    Produit du texte et propose les actions.

  2. Agent

    Organise la boucle autour du modèle.

  3. Outil

    Exécute une action : lire, tester, chercher.

  4. MCP

    Relie l’agent à des outils externes.

Exercice · 2 min : classez modèle, agent, Firecrawl et MCP.

Théorie

Un modèle n’accède pas spontanément au contenu de votre dépôt. L’agent lui présente les fichiers ou résultats obtenus par ses outils. MCP est un protocole permettant de connecter de nouveaux outils ; ce n’est ni un modèle ni une base de connaissances en soi. Dans Reconnect, Firecrawl peut être un outil de collecte accessible par MCP, tandis que le modèle résume le texte obtenu.

SourcesClaude Code · consulté le 14/09/2026MCP Claude Code · consulté le 14/09/2026

05 / 41La méthode

Nommer ce qui organise le travail

Quatre mots pour passer d’une demande à une livraison.

  1. Skill

    Une compétence réutilisable dans SKILL.md.

  2. Sous-agent

    Un exécutant avec son propre contexte.

  3. Workflow

    Un enchaînement de tâches et de contrôles.

  4. Ticket

    Un résultat attendu, un périmètre, un Done.

Exercice · 2 min : décrivez votre ticket en une phrase.

Théorie

Un skill décrit comment mener une catégorie de tâches et se charge lorsque cette compétence est utile. Un sous-agent reçoit une mission et travaille dans un contexte distinct, puis rend un résultat. Un workflow coordonne ces compétences, les exécutants et les moments de contrôle. Le ticket reste le contrat de travail commun à l’humain et à l’agent.

SourcesSkills Claude Code · consulté le 14/09/2026Sous-agents Claude Code · consulté le 14/09/2026

06 / 41La méthode

Le contexte se choisit

Donnez ce qui change la décision de l’agent.

  1. Garder

    Besoin, ticket, conventions, fichiers et preuves.

  2. Écarter

    Journaux bruts, doublons et historique inutile.

  3. Inspecter

    /context montre l’occupation du contexte.

  4. Reprendre

    /compact résume ; /resume retrouve une session.

Prompt à copier
Résume la session pour une reprise :
objectif, décisions, fichiers, preuves et blocages.
Sépare ce qui est confirmé de ce qui reste à vérifier.

Exercice · 3 min : gardez cinq faits utiles pour votre ticket.

Théorie

Le contexte contient les instructions, échanges et résultats d’outils disponibles pour la prochaine réponse. Ajouter davantage de texte peut augmenter le coût et diluer l’information utile. Une synthèse durable conserve les décisions, les chemins et les validations à refaire ; elle ne remplace pas les sources. /clear démarre une conversation vierge et /usage aide à inspecter la consommation (/cost en est un alias) : les détails affichés dépendent du mode d’accès.

SourcesCommandes Claude Code · consulté le 14/09/2026

07 / 41La méthode

Cinq étapes. Trois points de contrôle.

Relisez le plan, contrôlez chaque lot, vérifiez avant de fusionner.

  1. 1 Cadrer

    Un résultat mesurable et un ticket Ready.

  2. 2 Donner le contexte

    Les bons fichiers et les frontières.

  3. 3 Améliorer le prompt

    Cinq blocs, une demande exécutable.

  4. 4 Lancer

    Un lot attribué, un agent responsable.

  5. 5 Vérifier et garder

    Une preuve, puis une connaissance réutilisable.

Choisissez l’étape qui manque aujourd’hui à votre pratique.

Théorie

Les étapes constituent une routine commune, indépendante du modèle choisi. Un ticket mal cadré augmente les reprises même avec un outil performant. La reformulation permet de détecter un malentendu avant l’implémentation. Les contrôles portent sur des décisions et des résultats : le plan, le lot terminé et le comportement après intégration.

08 / 41La méthode

Étape 1. Cadrer

Un ticket devient Ready quand l’agent peut commencer sans deviner.

  1. Objectif SMART

    Spécifique, mesurable, atteignable, utile, daté.

  2. Ready

    Données, contrat et périmètre disponibles.

  3. Done

    Résultats visibles et validation reproductible.

Prompt à copier
/ticket-ready Afficher les organismes du jeu validé
avec nom, source et moyens de contact disponibles.
Lot : src/features/annuaire/. Échéance : 10h45.

Exercice · 5 min : rendez votre ticket Ready.

Théorie

SMART oblige à nommer le changement attendu et une échéance de travail. Ready décrit les conditions nécessaires avant le départ ; Done décrit ce qu’un relecteur pourra constater à l’arrivée. Une commande réussie est une preuve technique, mais ne remplace pas le parcours utilisateur. Les quantités et horaires du kit sont des cibles proposées, à confirmer avec le PO avant de démarrer.

SourcesSkills Claude Code · consulté le 14/09/2026

09 / 41La méthode

Étape 2. Donner le contexte

Un dossier attribué et un contrat commun évitent les collisions.

  1. Lire

    CLAUDE.md, README et les conventions.

  2. Attribuer

    Un lot possède son dossier src/features/.

  3. Partager

    Types et signatures dans src/types/.

  4. Préserver

    Les secrets et les fichiers des autres lots.

Prompt à copier
Lis CLAUDE.md, README.md et docs/CONVENTIONS.md.
Lis src/types/orientation.ts s’il existe.
Mon lot : src/features/annuaire/.
Signale tout fichier manquant. Propose un plan, sans coder.

Exercice · 3 min : montrez les fichiers autorisés de votre lot.

Théorie

Le contexte utile se trouve surtout dans le dépôt : commandes réelles, conventions, types et exemples. Un CLAUDE.md court fournit les règles durables ; le ticket ajoute la mission du moment. Les lots s’appuient sur le même contrat pour développer en parallèle. Une modification du contrat doit être annoncée à l’intégration avant d’être appliquée, car elle peut casser plusieurs lots.

SourcesClaude Code · consulté le 14/09/2026

10 / 41La méthode

Étape 3. Améliorer le prompt

Remplacez « fais le chatbot » par cinq blocs précis.

  1. Rôle + contexte

    Qui agit, sur quels fichiers et données.

  2. Tâche

    Une action et un résultat attendu.

  3. Contraintes + exemples

    Les limites et un cas observable.

Prompt à copier
[RÔLE] Développeur front de ce dépôt.
[CONTEXTE] Lot src/features/annuaire/, données validées.
[TÂCHE] Affiche le nom, la source et les contacts disponibles.
[CONTRAINTES] Respecte src/types/orientation.ts.
Modifie seulement mon lot. N’invente aucun contact.
[EXEMPLES] Téléphone absent : aucun bouton Appeler.
Retourne les fichiers, les validations et les blocages.

Exercice · 5 min : utilisez /prompt-5 sur votre ticket.

Théorie

Le skill local claude-5-prompt organise une demande en [RÔLE], [CONTEXTE], [TÂCHE], [CONTRAINTES] et [EXEMPLES]. Le kit en reprend cette structure sans ses anciennes références de modèles ni son code API. Le but est de retirer l’ambiguïté, pas d’allonger le prompt. Comparez « fais un bel annuaire » au prompt ci-dessous : la source des données, les fichiers et le cas de contact absent deviennent explicites.

SourcesSkills Claude Code · consulté le 14/09/2026

11 / 41La méthode

Étape 4. Lancer

Un lot indépendant reçoit une mission et rend des preuves.

  1. Planifier

    Valider le plan avant les modifications.

  2. Séparer

    Un dossier par lot ; contrat en lecture seule.

  3. Rapporter

    Fichiers, commande, résultat, blocages.

Prompt à copier
Lance un sous-agent pour le ticket ANNU-01 validé.
Il travaille uniquement dans src/features/annuaire/.
Il lit le contrat commun sans le modifier.
Exige : fichiers modifiés, validations, résultat, blocages.

Exercice · 3 min : lancez un seul lot prêt.

Théorie

Un sous-agent peut explorer ou implémenter une mission bornée dans son propre contexte. Le parallélisme aide lorsque les fichiers et les dépendances sont séparés ; il crée des conflits si plusieurs agents réécrivent le même point d’intégration. Dans Claude Code, le mode Plan permet de préparer l’approche avant l’exécution, et les sous-agents personnalisés peuvent être configurés dans .claude/agents/. La durée réelle dépend du modèle, du réseau et de la difficulté : prévoyez un point de situation.

SourcesSous-agents Claude Code · consulté le 14/09/2026

12 / 41La méthode

Étape 5. Vérifier et garder

« L’agent a fini » devient Done avec une preuve.

  1. Relire

    Comprendre le diff et les sources.

  2. Valider

    Lint, build et parcours utilisateur.

  3. Éprouver

    Cas vide, contact absent et langue de repli.

  4. Garder

    Décision, source et preuve dans le wiki.

Commandes du projet
npm run lint
npm run build

Exercice · 5 min : produisez une preuve de votre Done.

Théorie

Un build valide les types et la production du bundle, selon les scripts du dépôt. Le lint détecte certaines erreurs de code ; aucun des deux ne garantit que le parcours convient à l’utilisateur. Une recette vérifie le comportement observable et ses cas limites, puis le relecteur conserve les commandes et résultats. Le wiki garde ce qui sera utile au prochain ticket : une décision ou une recette, avec son contexte et sa source.

SourcesConventions du dépôt · consulté le 14/09/2026

13 / 41La méthode

La recette, l’exécutant et le parcours

Skill, sous-agent et workflow répondent à trois besoins distincts.

  1. Skill · comment faire

    /prompt-5 reformule une demande.

  2. Sous-agent · qui exécute

    Un agent construit le lot annuaire.

  3. Workflow · dans quel ordre

    Cadrer, contextualiser, reformuler, lancer, vérifier.

Prompt à copier
Décris le workflow du ticket ANNU-01.
Pour chaque étape : compétence, exécutant, entrée, preuve.
Reste dans les cinq étapes du support.

Exercice · 2 min : nommez le skill et l’agent de votre lot.

Théorie

La distinction donnée en formation reste pratique : une compétence, un exécutant, un enchaînement de bout en bout. Un workflow peut appeler plusieurs skills et déléguer une partie du travail. Un skill peut également contenir une procédure courte sans orchestrer toute une équipe. Dans le kit, /lancer-workflow porte le parcours de cinq étapes et réutilise la structure de /prompt-5.

SourcesSkills Claude Code · consulté le 14/09/2026Sous-agents Claude Code · consulté le 14/09/2026

14 / 41La méthode

Lancer le workflow en cinq gestes

Le prompt reformulé est votre point de contrôle.

  1. 1 Cadrer

    Ouvrez le projet et choisissez un ticket.

  2. 2 Donner le contexte

    Indiquez contrat et dossier attribué.

  3. 3 Améliorer le prompt

    Relisez les cinq blocs, puis dites « ok ».

  4. 4 Lancer

    L’agent exécute le lot et rend son rapport.

  5. 5 Vérifier et garder

    Contrôlez le Done et proposez une note wiki.

Prompt à copier
/lancer-workflow ANNU-01
Le ticket se trouve dans TICKETS-DEMAIN.md.
Périmètre : src/features/annuaire/.
Affiche d’abord le prompt reformulé.

Exercice · 5 min : testez jusqu’à l’affichage du plan.

Théorie

Le skill /lancer-workflow est fourni dans le kit, pas installé automatiquement sur les postes. Il lit le ticket, cherche les fichiers utiles et affiche une reformulation avant les modifications. Cette pause pédagogique vérifie que le périmètre est partagé. Après votre accord explicite, il délègue les lots indépendants, lance les validations disponibles et distingue une réussite prouvée d’une vérification bloquée.

SourcesSkills Claude Code · consulté le 14/09/2026

15 / 41Les outils

CLI et Desktop : ouvrir le même projet

Dans Desktop, choisissez l’onglet Code et une session locale.

  1. Ouvrir

    Sélectionnez le dépôt, puis le dossier du projet.

  2. Partager

    CLAUDE.md, skills et configuration MCP.

  3. Vérifier

    Demandez le dossier courant et les skills disponibles.

Prompt à copier
Indique le dossier courant, sans afficher de secret.
Liste les skills disponibles, noms seulement.
Trouves-tu prompt-5 et lancer-workflow ?

Exercice · 3 min : retrouvez /prompt-5 dans le bon projet.

Théorie

La documentation distingue les sessions locales du Desktop des autres modes d’exécution. Les sessions locales CLI et Desktop lisent la configuration Claude Code, dont les skills projet et personnels ; l’onglet Chat et ses connecteurs relèvent d’une configuration distincte. La disponibilité dépend de l’installation, du compte et du mode de connexion du poste. L’usage Desktop n’a pas été essayé lors de la recherche : la procédure est documentaire, à contrôler au premier exercice.

SourcesDesktop Claude Code · consulté le 14/09/2026Skills Claude Code · consulté le 14/09/2026

16 / 41Les outils

Créer un skill en un fichier

Placez la procédure dans .claude/skills/nom/SKILL.md.

  1. Nommer

    Un nom court et une description du besoin.

  2. Décrire

    Les entrées, les gestes et le résultat attendu.

  3. Essayer

    Appelez /nom avec un cas concret.

Structure d’un SKILL.md
---
name: ticket-ready
description: Reformule un besoin en ticket SMART, Ready et Done.
argument-hint: "<besoin>"
---
Lis $ARGUMENTS. Retourne objectif, Ready, Done et fichiers.
Signale les informations manquantes. Ne code rien.

Exercice · 5 min : copiez le skill prompt-5 du kit.

Théorie

Un skill regroupe une compétence réutilisable sous un nom découvrable. Le fichier SKILL.md commence par un frontmatter qui indique notamment name et description ; son corps porte les instructions. .claude/skills/ concerne le projet, tandis que ~/.claude/skills/ concerne l’utilisateur. L’exemple ci-dessous décrit une compétence locale de reformulation : le modèle reste nécessaire pour l’exécuter, même si le fichier lui-même est stocké sur le disque.

SourcesSkills Claude Code · consulté le 14/09/2026

17 / 41Les outils

Brancher un MCP, puis vérifier

Un serveur MCP expose des outils ; il faut encore les tester.

  1. Choisir

    Le serveur officiel et sa portée.

  2. Connecter

    Ajouter sa configuration à Claude Code.

  3. Contrôler

    Lister le serveur, puis essayer une requête.

Dans le terminal
claude mcp list

Exercice · 3 min : trouvez le serveur et son état.

Théorie

La portée local, project ou user détermine où la connexion est configurée et partagée. Une configuration projet peut être versionnée dans .mcp.json, en conservant les secrets hors du dépôt. Un serveur affiché ne prouve pas qu’une requête aboutira : authentification, réseau ou quota peuvent encore bloquer. Utilisez /mcp dans Claude Code pour inspecter les connexions ; le kit fournit les commandes documentées pour les services de cette formation.

SourcesMCP Claude Code · consulté le 14/09/2026

18 / 41Les outils

Context7 : demander la bonne documentation

Donnez la bibliothèque et sa version avant de coder.

  1. Configurer

    Dans le terminal : npx ctx7 setup --claude.

  2. Demander

    Nommez la bibliothèque, sa version et la question.

  3. Comparer

    Vérifiez les signatures et les sources reçues.

Prompt à copier
use context7 pour React, version installée dans package.json.
Comment gérer un formulaire contrôlé et son état de chargement ?
Cite la documentation et montre un exemple minimal.

Exercice · 3 min : vérifiez une API React utilisée dans le lot.

Théorie

Context7 fournit de la documentation de bibliothèques via MCP ou la CLI ctx7. Les outils MCP résolvent d’abord l’identifiant avec resolve-library-id, puis interrogent les extraits avec query-docs. L’assistant de configuration est documenté ; les accès et fichiers effectivement créés restent à contrôler sur chaque poste. Le service a besoin du réseau, y compris lorsqu’un connecteur local relaie les appels ; gardez une copie datée de la documentation utile pour la séance.

SourcesContext7 · consulté le 14/09/2026Dépôt Context7 · consulté le 14/09/2026

19 / 41Les outils

Firecrawl : garder le texte et sa source

Une extraction devient utile après comparaison avec la page.

  1. Connecter

    Choisissez le mode sans clé ou votre compte.

  2. Extraire

    Demandez une seule URL validée.

  3. Contrôler

    Gardez texte, URL, date et limites.

Prompt à copier
Avec Firecrawl, lis l’URL de structure sociale donnée par le PO.
Extrais titre, texte utile, URL et date dans mon lot.
N’invente aucun contact ; note les champs absents.
Montre l’extrait source avant de rédiger la fiche.

Exercice · 5 min : extrayez et relisez une page de la liste.

Théorie

Firecrawl propose la recherche, l’extraction de pages et des sorties structurées. Le serveur MCP hébergé dispose d’un mode sans clé avec des limites ; un compte ou une clé peut être utilisé selon le besoin. Une réponse de recherche n’est pas le contenu complet d’une page et ne valide pas ses coordonnées. Pour le lot de Romain, chaque fiche conserve la page source et la date de consultation ; sans réseau, utilisez seulement les copies déjà disponibles et n’annoncez pas une vérification récente.

SourcesFirecrawl MCP · consulté le 14/09/2026Mode sans clé · consulté le 14/09/2026

20 / 41Les outils

Archify : montrer les frontières du projet

Un schéma rend le contrat et les responsabilités visibles.

  1. Installer

    Suivez le README officiel du dépôt Archify.

  2. Décrire

    Entrées, trois lots et point d’intégration.

  3. Relire

    Ouvrez le HTML et vérifiez chaque flèche.

Prompt à copier
/archify Schématise Reconnect Assist :
Romain = connaissances, Ashad = assistant, Nils = annuaire.
Contrat partagé : src/types/orientation.ts.
Intégration : src/app/ et src/services/.
Marque les composants prévus mais encore absents.

Exercice · 5 min : expliquez le schéma sans lire le code.

Théorie

Archify est un skill accompagné de scripts qui produit des diagrammes en HTML autonome. Le résultat local peut être consulté sans connexion une fois généré ; la génération par un agent distant reste dépendante de son accès. Le skill v2.16 a été identifié sur le poste formateur, ce qui ne prouve pas son installation chez les apprenants. Commencez par /archify si le skill est disponible et demandez un schéma fidèle au dépôt, en signalant les fichiers seulement prévus.

SourcesArchify · consulté le 14/09/2026

21 / 41Les outils

OpenCode : conserver la même méthode

L’agent change ; le ticket, les limites et le Done restent.

  1. Ouvrir

    Installez OpenCode depuis sa documentation.

  2. Connecter

    /connect choisit un fournisseur ; /models un modèle.

  3. Cadrer

    /init prépare les règles dans AGENTS.md.

Prompt à copier
Lis AGENTS.md et le ticket ANNU-01.
Propose le plan du lot src/features/annuaire/.
Indique les données et accès manquants, sans les deviner.

Découverte · 3 min : comparez le rôle de AGENTS.md.

Théorie

OpenCode est un agent de code ouvert, utilisable avec plusieurs fournisseurs de modèles. Le fournisseur, le coût, les données transmises et la disponibilité se vérifient avant un exercice. Ne supposez pas qu’un abonnement d’une autre application donne automatiquement accès à ses modèles dans OpenCode. La méthode de travail reste transposable : contrat clair, petit lot, lecture du diff et recette ; les apprenants peuvent garder Claude Code pour le MVP.

SourcesOpenCode · consulté le 14/09/2026

22 / 41Les outils

Buzz : explorer un espace humains et agents

Une découverte de collaboration, à tester hors du chemin critique.

  1. Découvrir

    Lisez le projet public et ses versions.

  2. Préparer

    Un canal, un besoin et des documents non sensibles.

  3. Évaluer

    Qui répond, avec quel accès et quelle source ?

Prompt à copier
Scénario à essayer après configuration de Buzz :
Résume les décisions du lot connaissances disponibles ici.
Cite les messages ou fichiers utilisés.
Si une décision manque, indique-le explicitement.

Découverte · 2 min : formulez une question utile au canal.

Théorie

Les recherches récupérées identifient Buzz et le dépôt public block/buzz comme un espace de collaboration où humains et agents peuvent participer. Aucune installation ni utilisation réelle n’a été effectuée dans la préparation du support. L’accès, les libellés de l’interface, la connexion des modèles et le coût restent à vérifier dans l’application et sa documentation actuelle. Présentez le scénario de canal comme une expérience à mener, sans en faire un prérequis pour terminer le MVP.

SourcesBuzz · recherche récupérée, accès non testé · consulté le 14/09/2026Code public Buzz · consulté le 14/09/2026

23 / 41Les outils

Karpathy : faire vivre un wiki Markdown

Les sources restent brutes ; le wiki relie ce que vous apprenez.

  1. Ingest · intégrer

    Lire une source, créer une page reliée.

  2. Query · interroger

    Répondre depuis le wiki en citant.

  3. Lint · entretenir

    Détecter liens cassés, doublons et contradictions.

Prompt à copier
Lis une source dans wiki/raw/ sans la modifier.
Propose une page dans wiki/pages/ avec son lien source.
Signale les incertitudes et les contradictions.
Propose ensuite une entrée dans index.md et log.md.

Exercice · 5 min : proposez une page à partir d’une source locale.

Théorie

LLM Wiki est un patron de travail présenté dans un gist de Karpathy, pas un logiciel à installer. L’agent transforme des sources brutes en pages Markdown persistantes que l’humain peut également lire et modifier. Un index aide à retrouver les pages, un journal garde les changements et des règles définissent la structure attendue. Le kit adapte cette idée avec wiki/raw/ pour les originaux et wiki/pages/ pour la synthèse ; cette organisation conserve le savoir, sans garantir l’exactitude des sources ni rendre un modèle distant disponible hors ligne.

SourcesKarpathy · LLM Wiki · consulté le 14/09/2026

24 / 41Le MVP

Le MVP tient dans un parcours

Choisir un besoin → comprendre → trouver une structure → contacter.

  1. Public

    Des personnes confrontées aux barrières de langue et d’accès.

  2. Périmètre proposé

    Une ville, des sources choisies, un mode de réponse confirmé.

  3. Stack réelle

    Projet App Web : React, Vite et TypeScript.

  4. Reporté

    Chat libre, carte intégrée et couverture nationale.

À 9h00 : validez le parcours et ce que vous reportez.

Théorie

Reconnect Assist est le fil rouge issu des échanges : aider à s’orienter vers des structures sociales, avec une interface accessible à des personnes peu technophiles. La formation reste dans le projet web commencé, même si les apprenants développent habituellement en PHP. Ville, langues et catégories sont des décisions à confirmer, pas des faits déjà validés. Une démonstration avec textes préparés est acceptable si le mode sans IA est annoncé ; elle ne prouve pas une intégration LLM. Le PO choisit un mode connecté seulement si un endpoint serveur est déjà prêt et validé ; les secrets restent côté serveur et les réponses indiquent leurs sources.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

25 / 41Le MVP

Trois lots. Un point d’intégration.

Répartition proposée : chaque personne confirme son périmètre.

  1. Romain · connaissances

    src/features/base-connaissances/

  2. Ashad · assistant

    src/features/assistant/

  3. Nils · annuaire

    src/features/annuaire/

  4. Cédric · intégration

    Contrat, services et application commune.

Avant de lancer : pointez le dossier de votre lot.

Théorie

Cette organisation reste à confirmer avec l’équipe : Cédric est proposé pour l’intégration en plus de son rôle de PO. Les responsabilités prolongent la répartition demandée : collecte et base de connaissances, dialogue multilingue, puis contacts et carte. Les trois lots ne modifient pas directement les fichiers d’assemblage ni les types partagés. Les noms de dossiers sont proposés par le cadrage ; l’intégration les crée ou les confirme avant le départ. Chacun reste responsable de la relecture du code qu’il présente, même lorsque l’agent l’a généré.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

26 / 41Le MVP

Le contrat permet de travailler en parallèle

Les types partagés deviennent la frontière entre les lots.

  1. Entrée

    OrientationQuery : langue, besoin, ville, mots-clés.

  2. Connaissances

    KnowledgeItem : texte, catégorie et source.

  3. Structures

    Organisation : identité et contacts disponibles.

  4. Sortie

    OrientationResult : fiches, organismes, explication.

Signatures proposées
searchKnowledge(query): Promise<KnowledgeItem[]>
findOrganisations(query): Promise<Organisation[]>
explain(query, items): Promise<Explanation>

À 9h55 : relisez les signatures avant de lancer les lots.

Théorie

Le contrat complet est fourni dans kit/CONTRAT-DONNEES.md comme proposition à valider avec l’équipe. Les fonctions searchKnowledge, findOrganisations et explain renvoient des promesses, même si la démo utilise des données locales ; une future source distante pourra conserver l’interface. Les fixtures TypeScript sont un choix proposé pour faire contrôler leur forme par les types du projet. Une feature utilise le contrat et les exports publics, sans aller chercher les fichiers internes d’une autre feature.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

27 / 41Le MVP

KB-01 · Romain

Base de connaissances sourcée

  1. SMART

    8 fiches sourcées et consultables à 10h45.

  2. Ready

    Contrat, catégories et sources disponibles.

  3. Done

    Recherche, source et cas vide vérifiés.

  4. Fichiers

    src/features/base-connaissances/**

Prompt à copier
/prompt-5 KB-01 dans TICKETS-DEMAIN.md
Vérifie Ready avant de proposer le plan.
Indique les preuves nécessaires pour passer Done.

Ouvrez TICKETS-DEMAIN.md et confirmez Ready.

Théorie

Objectif proposé : À 10h45, proposer huit fiches issues des sources validées, searchKnowledge(query) et KnowledgeList, avec source et repli de langue ; lint et build réussissent. Ready : Contrat src/types/orientation.ts partagé et lu. Catégories, langues et huit sources ou fiches cibles validées par le PO. Copies de pages disponibles ou collecte testée ; branche à jour et lot attribué. Done : Huit KnowledgeItem typés : titre, résumé, catégorie, mots-clés, source et date réelle de consultation ; traductions validées ou explicitement signalées. Recherche par catégorie testée et résultat vide traité ; langue absente : repli en français. KnowledgeList montre le lien source ; aucune information absente n’est inventée ; lint et build réussissent, diff relu. Dépendances : INT-01 phase 1 : contrat et façade stub prêts avant lancement. Le ticket complet du kit porte les mêmes critères. Les quantités sont des objectifs pédagogiques à valider ; réduire le périmètre si les sources ne sont pas disponibles, sans inventer les données.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

28 / 41Le MVP

ASSIST-01 · Ashad

Assistant multilingue simple

  1. SMART

    Un parcours multilingue et un mode choisi à 10h45.

  2. Ready

    Contrat, langues ; endpoint validé ou repli choisi.

  3. Done

    Sources, erreurs et mode réel vérifiés.

  4. Fichiers

    src/features/assistant/**

Prompt à copier
/prompt-5 ASSIST-01 dans TICKETS-DEMAIN.md
Vérifie Ready avant de proposer le plan.
Indique les preuves nécessaires pour passer Done.

Ouvrez TICKETS-DEMAIN.md et confirmez Ready.

Théorie

Objectif proposé : À 10h45, fournir un parcours langue → besoin → ville qui émet OrientationQuery et affiche une réponse sourcée dans la langue choisie : mode LLM si l’endpoint serveur est prêt et validé, sinon repli annoncé sans IA ; lint et build réussissent. Ready : Contrat et façade stub disponibles pour travailler sans les autres lots. Langues de démonstration et libellés français validés par le PO. PO : choisir avant lancement le mode connecté si un endpoint serveur est prêt et validé (clé côté serveur, sources renvoyées), sinon le repli avec textes préparés. La construction d’un backend supplémentaire exige un périmètre séparé. Done : Même jeu de libellés pour les langues retenues, avec repli français si une traduction manque. Choisir un besoin produit une OrientationQuery valide ; les états chargement, aucun résultat et erreur sont affichés. La recette indique le mode réellement testé : réponse LLM sourcée via endpoint validé, ou réponse préparée marquée sans IA. Parcours utilisable au clavier et sur écran étroit, boutons d’au moins 44 px ; lint et build réussissent, diff et capture relus. Dépendances : INT-01 phase 1 : contrat et façade stub. Le mode montré doit être annoncé ; une réponse préparée ne prouve pas une intégration LLM.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

29 / 41Le MVP

ANNU-01 · Nils

Annuaire et contacts vérifiables

  1. SMART

    6 structures et leurs contacts vérifiables à 10h45.

  2. Ready

    Contrat, ville et sources des coordonnées.

  3. Done

    Filtres, champs absents et liens contrôlés.

  4. Fichiers

    src/features/annuaire/**

Prompt à copier
/prompt-5 ANNU-01 dans TICKETS-DEMAIN.md
Vérifie Ready avant de proposer le plan.
Indique les preuves nécessaires pour passer Done.

Ouvrez TICKETS-DEMAIN.md et confirmez Ready.

Théorie

Objectif proposé : À 10h45, proposer six structures de la ville choisie, findOrganisations(query) et OrganisationList avec des coordonnées sourcées et un lien carte si l’adresse est disponible ; lint et build réussissent. Ready : Contrat partagé et ville de démonstration fixés. Six structures cibles et sources disponibles validées avec le PO. Lien carte externe retenu pour la matinée ; branche à jour et lot attribué. Done : Six Organisation typées, avec source et ville ; téléphone, e-mail, horaires ou adresse inconnus restent absents. Filtre par ville et catégorie vérifié ; ville inconnue : résultat vide ; aucun bouton de contact sans valeur sourcée. Carte liée seulement si l’adresse est disponible ; le fonctionnement du site externe est distingué de l’URL construite ; lint et build réussissent, diff relu. Dépendances : INT-01 phase 1 : contrat partagé. Le ticket complet du kit porte les mêmes critères. Les quantités sont des objectifs pédagogiques à valider ; réduire le périmètre si les sources ne sont pas disponibles, sans inventer les données.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

30 / 41Le MVP

INT-01 · Cédric

Contrat commun et intégration

  1. SMART

    Contrat à 9h55 ; intégration prête à 12h00.

  2. Ready

    Décisions PO et périmètres partagés.

  3. Done

    Parcours complet et cas limites vérifiés.

  4. Fichiers

    src/app/, src/types/, src/services/ et assemblage.

Prompt à copier
/prompt-5 INT-01 dans TICKETS-DEMAIN.md
Vérifie Ready avant de proposer le plan.
Indique les preuves nécessaires pour passer Done.

Ouvrez TICKETS-DEMAIN.md et confirmez Ready.

Théorie

Objectif proposé : À 9h55, partager un contrat et une façade stub ; à 12h00, intégrer les trois lots avec lint et build réussis, puis présenter à 12h15 un parcours complet et ses limites. Ready : PO : ville, catégories, langues, données et mode sans IA confirmés. Périmètres attribués et conventions relues ; l’état réel des tickets GitHub est contrôlé. Squelette ouvrable et ordre d’intégration annoncé à l’équipe. Done : src/types/orientation.ts et src/services/orientation.ts donnent les mêmes signatures aux trois lots ; les modifications du contrat sont annoncées. Assemblage dans src/app/ ; les lots exposent leurs fonctions et composants via index.ts sans import interne entre features. Lint et build réussissent après intégration ; recette besoin → réponse → organisme → contact disponible, plus cas vide et mode sans IA ; limites consignées. Dépendances : Phase 1 avant les lots ; phase 2 après leur relecture. Ordre proposé : KB-01 → ANNU-01 → ASSIST-01. Le ticket complet du kit porte les mêmes critères. Les quantités sont des objectifs pédagogiques à valider ; réduire le périmètre si les sources ne sont pas disponibles, sans inventer les données.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

31 / 41Le MVP

La matinée alterne travail et apprentissage

Les heures sont des cibles de séance, à ajuster aux blocages.

  1. 9h00–9h40

    Décisions PO, exercices outils et tickets.

  2. 9h40–10h05

    Contrat commun, reformulation et lancement.

  3. 10h05–10h45

    Théorie pendant l’exécution ; point blocages.

  4. 10h45–11h45

    Relecture, intégration et corrections.

  5. 11h45–12h30

    Recette, démonstration à 12h15, bilan.

À chaque point : signalez terminé, bloqué ou à réduire.

Théorie

Le cadrage réserve d’abord un temps de décision et de prise en main. Le contrat commun est une dépendance réelle : le lancer avant sa validation peut créer du travail incompatible entre les trois lots. Pendant la théorie, un point de situation court distingue attente réseau, information manquante et difficulté d’implémentation. À partir de la recette, corrigez les défauts qui empêchent le parcours ; consignez les améliorations pour après la démo.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

32 / 41Le MVP

Sans réseau : montrer ce qui existe vraiment

Fichiers locaux disponibles ≠ agent cloud disponible.

  1. Garder

    Sources, traductions et fixtures déjà enregistrées.

  2. Afficher

    Une réponse préparée, identifiée « mode sans IA ».

  3. Poursuivre

    Relire, assembler et corriger localement si possible.

  4. Reporter

    Collecte, nouveaux paquets et validation distante.

Exercice · 3 min : annoncez la limite de votre plan B.

Théorie

Un fichier HTML autonome se consulte sans réseau ; un projet Vite nécessite aussi ses dépendances déjà installées. Une copie de source garde sa date d’origine : elle ne devient pas une vérification du jour. Si les données manquent, réduisez la démonstration ou utilisez un cas d’école signalé comme fictif, sans inventer de contacts réels. Un modèle local n’est une solution que s’il est déjà installé, configuré et testé ; ce support n’en suppose aucun.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

33 / 41Le MVP

Le PO vérifie un résultat humain

La démo répond à un besoin et montre ses limites.

  1. Comprendre

    Le besoin et la langue se choisissent facilement.

  2. Expliquer

    La réponse indique sa source et le mode réellement testé.

  3. Orienter

    La structure correspond au besoin et à la ville.

  4. Contacter

    Chaque contact affiché vient d’une source.

  5. Échouer proprement

    Aucun résultat ou champ absent reste compréhensible.

Prompt à copier
Recette : besoin → réponse → organisme → contact disponible.
Teste aussi ville inconnue et téléphone absent.
Note attendu, observé et preuve.
Classe les écarts : bloquant pour la démo ou à reporter.

À 11h45 : jouez le scénario depuis un écran neuf.

Théorie

La recette suit le parcours attendu plutôt qu’une visite de tous les fichiers. Testez un cas nominal et plusieurs limites : une ville inconnue, une traduction absente et un téléphone manquant. Vérifiez que le contenu ne transforme pas une information générale en une promesse personnalisée et que les sources restent accessibles. Une validation sur navigateur local, sur écran étroit et sur téléphone sont des preuves différentes : consignez seulement celles réellement effectuées.

SourcesDépôt et cadrage de formation · lus le 14/09/2026

34 / 41Vos questions

Vos questions du 15 septembre

Quatre sujets sont sortis du tour de table. Chacun devient un geste à pratiquer ce matin.

  • La boucle

    Voir fonctionner une boucle et des sous-agents sur un cas réel.

  • La stack

    Sur quoi on développe, et qui décide.

  • Les clés

    Où vit un secret, et ce qui ne doit jamais entrer dans le fil.

  • Le TP

    Ce que vous produisez d’ici midi et quart.

Repère · 1 min : ces quatre écrans répondent aux questions posées en réunion.

35 / 41Vos questions

Une boucle qui cherche, formate et recommence

L’exemple demandé en réunion : des contacts à démarcher sur Paris.

  1. Le but

    Une liste exploitable, pas une recherche ouverte.

  2. La source

    La base du projet. Rien d’inventé, tout sourcé.

  3. Le format

    Une ligne par contact, les mêmes colonnes pour tous.

  4. Le critère d’arrêt

    C’est lui qui arrête la boucle, pas le modèle.

  5. La preuve

    Un rapport : trouvé, manquant, arrêté où.

Prompt à copier
Objectif : une liste de contacts à démarcher sur Paris.
Source : la base de contacts du projet. N’invente aucun contact.
Format : nom | organisation | ville | moyen de contact | source.
Boucle : cherche, formate, vérifie les champs vides, recommence.
Arrêt : 20 contacts complets, ou plus aucune source à explorer.
Rends un rapport : trouvés, incomplets, et où tu t’es arrêté.

Exercice · 10 min : lancez la boucle sur votre lot, puis lisez le rapport.

Théorie

Ce qui sépare une boucle d’un simple prompt tient en deux lignes : un critère d’arrêt vérifiable et un rapport final. Sans critère, la boucle s’arrête quand le modèle estime avoir fini, ce qui n’est pas la même chose que le travail fini. Les sous-agents deviennent utiles quand les recherches sont indépendantes : chacun travaille dans son propre contexte, rend un résultat court, et l’agent principal ne garde que la synthèse au lieu de tout accumuler. Le coût se paie en contexte, pas en temps.

SourcesSous-agents Claude Code · consulté le 15/09/2026

36 / 41Vos questions

La stack : du front, un peu de back, rien à installer

Tranché en réunion : ce qui compte aujourd’hui, c’est la livraison.

  1. Ce qu’on prend

    React, Vite et TypeScript : déjà posés dans le dépôt.

  2. Ce qu’on écarte

    PHP et tout ce qui demande d’installer un serveur.

  3. Ce qui reste ouvert

    L’agent propose, vous tranchez. Jamais l’inverse.

  4. Le critère

    Ça doit tourner et se montrer ce matin.

  5. La trace

    Le choix va dans docs/DECISIONS.md, en une ligne.

Prompt à copier
Contrainte : livrable ce matin, aucun serveur à installer.
Le dépôt utilise déjà React + Vite + TypeScript.
Pour ce ticket, propose deux options : rester sur l’existant, ou autre.
Pour chacune : le temps que ça coûte et ce que ça casse.
Ne code rien avant mon choix.

À faire · 2 min : posez la question avant la première ligne de code.

Théorie

La stack n’est pas une préférence, c’est une contrainte de livraison. « Projet App Web » est déjà en React 19, Vite et TypeScript : le build se vérifie en une commande et se publie sans serveur. Demander deux options chiffrées évite les deux échecs classiques : l’agent qui impose sa stack préférée, et l’équipe qui débat sans livrer. Laisser l’IA choisir reste légitime, à condition de lui donner la contrainte de temps : sans elle, elle optimise la propreté, pas votre matinée.

SourcesProjet App Web · dépôt de la formation

37 / 41Vos questions

Une clé ne se colle jamais dans la conversation

Le réflexe de l’urgence est celui qui coûte le plus cher.

  1. Le piège

    L’API ne répond plus, on recrée une clé, on la colle.

  2. La règle

    La clé vit dans un fichier, jamais dans le fil.

  3. Le fichier

    .env, ignoré par git, jamais commité.

  4. L’interdiction

    Une règle deny empêche l’agent de le lire.

  5. Si c’est arrivé

    Révoquez la clé. Elle est compromise, pas récupérable.

À poser dans le projet
# .env — jamais commité, déjà couvert par le .gitignore du dépôt
API_KEY=votre_cle_ici

# .claude/settings.json — l’agent ne lira pas ce fichier
{ "permissions": { "deny": ["Read(./.env)"] } }

# vérifier avant de commiter
git check-ignore -v .env

À faire · 3 min : vérifiez que .env est ignoré avant votre première clé.

Théorie

Un point à corriger de la réunion : le mode commande, ouvert par un point d’exclamation en début de ligne, exécute une commande sans la faire reformuler par le modèle, mais la commande et sa sortie restent dans la session. Ce n’est pas un coffre-fort. La seule méthode fiable reste le fichier hors dépôt, plus une règle deny qui interdit sa lecture ; /permissions affiche les règles en place. Une clé passée une fois dans une conversation doit être considérée comme compromise et révoquée : elle est sortie de votre poste. Même règle pour les données des utilisateurs : ce qui entre dans un prompt quitte votre périmètre, donc on anonymise ou on n’envoie pas.

SourcesPermissions Claude Code · consulté le 15/09/2026

38 / 41Vos questions

Le TP de la matinée

Jusqu’à midi et quart. On regarde ensemble ensuite.

  1. Prenez un ticket

    Dans TICKETS-DEMAIN.md, celui de votre lot.

  2. Ne codez pas à la main

    Demandez, relisez, corrigez la demande.

  3. Servez-vous du kit

    CLAUDE.md, les skills, le contrat de données.

  4. 12h15

    On regarde ce qui tourne, pas ce qui est prévu.

  5. Débrief

    Questions ouvertes dans l’après-midi.

Prompt à copier
/lancer-workflow ID-DU-TICKET
Le ticket se trouve dans TICKETS-DEMAIN.md.
Périmètre : mon dossier de lot uniquement.
Affiche le prompt reformulé et attends mon accord.

Exercice · jusqu’à 12h15 : une feature livrée vaut mieux que trois commencées.

Théorie

Le dépôt contient la documentation nécessaire : tickets, contrat de données, conventions, notices d’outils et plan B sans réseau. Travaillez sur votre branche, pas sur main, et gardez le périmètre du ticket : c’est ce qui permet à quatre lots d’avancer en parallèle sans se marcher dessus. Ce qui est appris se note dans le wiki au fil de l’eau, pas à la fin.

SourcesTickets de la matinée · dépôt de la formation

39 / 41Garder

La fiche à garder

Reprenez cette routine au prochain ticket.

  1. 1 Cadrer

    « Transforme ce besoin en ticket Ready et Done. »

  2. 2 Donner le contexte

    « Lis les règles, le contrat et mon dossier. »

  3. 3 Améliorer le prompt

    « Reformule la demande en cinq blocs. »

  4. 4 Lancer

    « Exécute ce lot et rapporte les preuves. »

  5. 5 Vérifier et garder

    « Contrôle le Done et propose une note wiki. »

Conservez FICHE-5-ETAPES.md près de vos tickets.

Théorie

La routine évite de reconstruire votre manière de travailler à chaque session. Les cinq prompts restent adaptables au besoin : ils n’obligent pas à déployer plusieurs agents pour une petite modification. Ce qui reste constant est le lien entre objectif, périmètre, résultat et preuve. La fiche Markdown du kit peut être imprimée ou placée dans les favoris du projet.

40 / 41Garder

Le kit se copie dans le projet

Trois skills et des fichiers de référence prêts à adapter.

  1. Reformuler

    /prompt-5 et /ticket-ready.

  2. Exécuter

    /lancer-workflow en cinq étapes.

  3. Préparer

    Tickets, contrat et exemple de CLAUDE.md.

  4. Garder

    Wiki, sources et plan sans réseau.

Prompt à copier
/prompt-5 Afficher les organismes du jeu validé.
Retourne les cinq blocs, Ready et Done ; ne code rien.

Copiez les trois dossiers de skills, puis ouvrez /prompt-5.

Théorie

Le README du kit indique quels fichiers copier à la racine de Projet App Web. Si .claude/ ou CLAUDE.md existe déjà, ajoutez les nouveaux skills et fusionnez les règles utiles au lieu de remplacer la configuration. Les documents de tickets et de contrat sont des propositions à confirmer avant le MVP. Les notices distinguent commandes vues dans les sources, essais réalisés et accès restant à tester sur les postes.

41 / 41Reconnect · Romain, Ashad et Nils · 15 septembre 2026

Prenez un ticket. Rendez-le Ready.

La prochaine action tient en cinq minutes.

  1. Votre point de départ

    Le besoin, les fichiers et la preuve attendue.

  2. Votre soutien

    Cédric Atticot dit Ravino · formateur et PO.

  3. Votre repère

    1 Cadrer → 2 Donner le contexte → 3 Améliorer le prompt

Prompt à copier
/ticket-ready Mon prochain besoin est :
Décris ici le changement attendu pour l’utilisateur.

Lancez /ticket-ready sur votre prochain besoin.

Théorie

Commencez par un seul ticket et vérifiez qu’un autre participant comprend ce qui doit changer. Les fichiers manquants et les décisions ouvertes apparaissent avant le lancement, pas à la fin de l’implémentation. Le prochain geste consiste à reformuler le besoin et obtenir un plan dont vous pouvez expliquer les choix. Retrouvez ensuite 4 Lancer et 5 Vérifier et garder pour aller jusqu’à une livraison contrôlée.

Support de référence

Sommaire

41 écrans

Échap pour fermer Les liens vers les sources s’ouvrent séparément.