← Tous les articles

INTELLIGENCE ARTIFICIELLE

Faire écrire du Laravel par une IA sans casser la prod

Un agent de code produit du Laravel correct la plupart du temps. Le reste du temps, il refait les mêmes erreurs. Voici ce que j'écris dans le dépôt pour qu'elles ne reviennent pas.

Publié le · mis à jour le

L'horloge des tests Feature est gelée. tests/Pest.php appelle freezeTime() dans un beforeEach. Un test qui a besoin que du temps passe le dit, avec travel() ou travelTo().

Cette règle a deux origines. L'horloge a d'abord été gelée parce que des assertions sur des dates devenaient instables d'une seconde. Le second cas est arrivé plus tard : une fabrique tirait sa date avec dateTimeBetween('-1 year', '-1 day'), donc sur l'horloge réelle, pendant que le test, lui, voyageait dans le passé. Le test recevait un article programmé dans le futur, et donc une 404.

À partir d'octobre 2027, ce test aurait échoué à chaque exécution. Vérifié en avançant l'horloge système avec libfaketime, deux échecs avant la date, dix-sept succès après correction.

Un index qui route les règles par chemin de fichier

Douze fichiers de règles, personne ne les lit en entier, et surtout pas un agent qui a mieux à faire de son contexte. Chaque fichier déclare donc les chemins qu'il couvre, en en-tête, ici abrégé aux deux premiers :

---
paths:
  - 'app/Blog/**'
  - 'app/Http/Controllers/BlogController.php'
---

Et un index les rassemble, avec une consigne d'une ligne : avant de planifier ou de modifier, trouve la ligne dont les globs correspondent au chemin du fichier, et lis ce fichier de règles.

L'agent qui ouvre un test lit les règles de tests. Celui qui touche au SEO lit les règles SEO et rien d'autre. Ça évite de noyer la consigne utile dans un pavé qu'il survolera, et ça rend le dossier maintenable pour moi : quand une règle de blog change, je sais où elle est.

Trois pièges qu'une règle écrite a rattrapés

Les règles qui me servent le plus concernent les tests, parce que c'est là qu'un agent produit du code qui a l'air juste et qui ne prouve rien.

Un test qui passe sans rien vérifier. Deux tests comptaient les requêtes SQL en filtrant sur from "companies". Sous SQLite, le nom de table est entouré de guillemets ; sous MariaDB, d'accents graves. Sur MariaDB, le filtre ne retenait donc rien, et un test qui vérifie « zéro requête » passait sans rien démontrer. La règle demande désormais de citer le nom de table par la grammaire du moteur, avec DB::getQueryGrammar()->wrapTable().

Un test vert en local et rouge en CI. Une assertion vérifiait qu'une page charge un fichier JavaScript en cherchant son chemin source. Ce chemin n'apparaît dans le HTML que si le serveur de développement tourne ; en build, Vite émet un nom de fichier haché. La règle impose de passer par Vite::asset(), et de lancer la suite sans le serveur de développement avant de pousser.

Un test qui échoue une fois sur 28 600. Les tests de l'administration se connectaient avec un utilisateur dont le nom venait de Faker. Le gabarit affiche ce nom dans la barre latérale, et un test excluait une chaîne par assertDontSee. Quand Faker tirait « Alex Martin », environ une fois sur 28 600, l'exclusion tombait sur le nom affiché. L'échec est apparu une fois en CI, sur le job MariaDB, sans que la base y soit pour rien. La règle fixe maintenant le nom de l'utilisateur connecté dans ce type de test.

Ces trois bugs sont propres à ce projet. Aucun agent ne peut les deviner tant qu'ils ne sont écrits nulle part, et c'est ce qui m'a poussé à les consigner.

Le brief, la branche, la CI

Les règles fixent la manière d'écrire dans ce projet ; le brief décrit le lot à réaliser.

Je travaille par lots. Chaque lot a son brief en français dans docs/briefs/, qui dit ce que le lot change, ce qu'il ne change pas, et à quoi on reconnaîtra que c'est fini. Le dossier en compte trente-trois à ce jour. L'agent travaille sur une branche, j'obtiens une pull request, et je la relis avant de fusionner.

Entre les deux, une commande unique refuse ce qui ne passe pas :

composer test

Elle enchaîne Pint pour le formatage, PHPStan au niveau 7, puis la suite de tests, plus de sept cents répartis sur soixante-dix-sept fichiers. La même commande tourne dans l'intégration continue, et la suite y est rejouée une seconde fois sur MariaDB, le moteur de la production, parce que les tests locaux tournent sur SQLite. Ce second passage a fait apparaître deux des trois pièges ci-dessus, dont un qui n'avait rien à voir avec la base.

Quand un agent affirme que son code fonctionne, je lance cette commande plutôt que de le croire.

Ce que ça ne remplace pas

Tout ça ne remplace pas la relecture. Je lis la pull request ligne à ligne, et j'y trouve encore des choses que ni les tests ni PHPStan ne voient : une requête qui va se traîner quand la table grossira, un nom de méthode qui ment sur ce qu'elle fait, une règle métier appliquée au mauvais endroit.

Les règles ne remplacent pas non plus la décision d'architecture. Quand une question se pose sur la structure, je la tranche moi-même et je l'écris dans le brief avant de lancer quoi que ce soit. Un agent à qui je laisse ce choix produit quelque chose qui marche, et que je n'aurais pas construit ainsi.

Si vous faites développer par un prestataire qui utilise l'IA

Demandez-lui ce qu'il a mis en place autour. Trois points :

  1. Qu'est-ce qui refuse le code avant la fusion ? Une suite de tests et une analyse statique qui tournent automatiquement, ou la bonne volonté de celui qui relit.
  2. Les décisions sont-elles écrites quelque part ? Un dépôt sans trace des choix se reprend aussi mal qu'un dépôt sans documentation, et je l'ai décrit dans mon article sur la reprise d'un projet Laravel existant.
  3. Qui relit, et à quel niveau ? La réponse « l'IA génère, les tests valident » laisse de côté tout ce qu'un test ne voit pas.

Questions fréquentes

Est-ce que ça marche sur un projet existant ? Oui, et c'est même plus facile : les bugs passés vous ont déjà donné la matière. Commencez par un fichier de règles pour la zone que vous touchez le plus souvent.

Combien de règles faut-il écrire avant de commencer ? Aucune. Écrivez-en une le jour où vous corrigez un bug qu'un agent pourrait réintroduire. Mon dossier a mis environ deux mois à atteindre douze fichiers.

Et si les règles deviennent fausses ? Elles le deviennent. C'est la raison pour laquelle je les range par domaine, et pour laquelle la plupart disent à quelle occasion elles ont été écrites. Une règle datée se vérifie contre le code et se corrige quand elle a vieilli.

Faut-il un agent payant plutôt qu'un gratuit ? Sur un projet un peu gros, le dépôt compte plus que l'agent. Entre un bon agent sans règles et un agent moyen dans un dépôt bien balisé, je prends le second.

Un projet Laravel à faire développer

Si vous avez une application métier à construire ou à reprendre, c'est avec cette méthode que je travaille : des règles dans le dépôt, des tests qui tournent à chaque fusion, et une relecture humaine avant la mise en production. Vous pouvez voir le type de projets sur mes réalisations, et le détail sur ma page application métier sur mesure.