Chapitre 15 : Jay et le code
Jay est né éditeur de code, et ça se voit : rattachez un dépôt Git à une session, la barre passe en Code d'elle-même, et Jay lit le code, modifie les fichiers, lance les commandes, fait tourner les tests et prépare les commits. Les développeurs y trouvent un binôme ; ceux qui ne codent pas y trouvent l'outil le plus rapide dès qu'une tâche touche des centaines de fichiers.
Une session de code
| Brique | Ce que c'est |
|---|---|
| JAY.md | Le fichier à la racine, lu à chaque session : conventions, commandes, architecture, pièges (chapitre 4). Demandez à Jay de l'écrire depuis le projet |
| La position Code | Dans la barre : la branche, la copie isolée, le diff « +12 −3 » du travail en cours, le bouton Terminal. Dans le tiroir, la face Code : les fichiers modifiés, le diff de chaque changement |
| /commit, /diff, /status, /pr | Les gestes Git. Jay ne commite et ne pousse jamais de lui-même : /commit est votre geste, et il rédige le message selon vos règles (Réglages, Git) ; /pr rédige la description de la pull request, que Jay ouvre ensuite sur votre forge après confirmation |
| Les Forges | GitHub, Forgejo, GitLab, Bitbucket, dans Réglages : Jay ouvre, liste et relit des pull requests |
| Le Terminal | Partagé par projet, où Jay lance et lit ses commandes, avec vos commandes autorisées et refusées |
| Les hooks Commande | Un script avant ou après chaque action de Jay : formater un fichier modifié, lancer le linter (chapitre 11) |
| Le Design System | L'onglet du tiroir qui extrait le système réel du code, ses dérives et ses corrections avec preuve (chapitre 6) |
| Le simulateur | Jay installe, lance et pilote votre app dans le simulateur iOS ou un émulateur Android : il tape, fait défiler, prend des captures |
| DOPE | Des agents de code dans un conteneur, avec votre compte Jay, dans toutes les offres Jay |
La copie isolée
À côté du nom de la branche, une case : la copie isolée. Jay travaille alors dans une copie du dépôt, sur une vraie branche, sans toucher à votre arbre de travail. Vous continuez à coder dans le vôtre pendant qu'il avance dans le sien, et vous fusionnez quand c'est bon. La mémoire et la base de connaissance restent celles du projet.
Les sessions qui se parlent
Jay cherche dans vos autres sessions et vos réunions quand vous y faites référence : « reprends ce qu'on avait décidé hier sur l'API ». Deux gestes de plus, ouverts à tous : lier un autre de vos projets Jay en lecture (le front qui lit le back), et écrire à une autre session, qui répond d'elle-même quand elle est au repos. Chaque envoi vous est confirmé, même en accès Complet, et une réponse n'en appelle pas une autre : pas de boucle entre deux agents.
Votre première session de code
- Rattachez le dossier du projet. S'il est un dépôt Git, la session s'ouvre en Code ; sinon, passez le switch sur Code.
- Faites-le explorer d'abord. « Explique-moi ce projet : sa structure, son rôle, comment le lancer. »
- Demandez le JAY.md. « Écris le JAY.md : commandes, architecture, conventions, pièges que tu vois. »
- Donnez une petite tâche réelle, en mode Plan. Validez le plan, passez en Build, laissez-le faire.
- Relisez le diff dans la face Code, puis /commit.
Les bonnes pratiques
- Explorer, planifier, coder, vérifier. Demandez toujours un plan avant les grosses modifications.
- Des tâches petites et précises. « Ajoute la validation de l'email dans le formulaire d'inscription » plutôt que « améliore le site ».
- Des tests comme juge de paix. Demandez d'écrire le test d'abord, puis de le faire passer.
- Git comme filet de sécurité. Un commit avant chaque gros changement, ou la copie isolée.
- Un JAY.md court et vivant. Ajoutez une règle chaque fois que vous corrigez deux fois la même erreur.
- Le bon mode. Polyvalent pour les petites retouches, Réflexion pour une fonctionnalité, Expert pour une refonte ou un bug qui résiste.
Jay pour ceux qui ne codent pas
Pas besoin d'être développeur pour en profiter. Dès qu'une tâche touche beaucoup de fichiers ou de données, une session de code est l'outil le plus rapide, parce que Jay écrit un petit programme pour la faire d'un coup, et vous montre son plan avant.
| Domaine | Ce que vous demandez |
|---|---|
| Fichiers | « Renomme les 400 photos de ce dossier avec la date et le lieu, et classe-les par mois. » |
| Données | « Fusionne les 12 fichiers Excel mensuels en un seul, nettoie les doublons et fais un tableau récapitulatif. » |
| Web | « Crée un site vitrine de 4 pages pour mon activité de conseil, avec ma charte, et explique-moi comment le mettre en ligne. » |
| Documents | « Convertis tous ces documents Word en PDF avec la même mise en page et une table des matières. » |
| Mini-outils | « Construis un petit outil, une page web locale, où je colle une offre d'emploi et mon CV, et qui me donne un score et les compétences manquantes. » |