Construire un workflow Next.js avec des agents sans perdre le fil

Objectif

Un agent est plus utile lorsqu'il reçoit un périmètre vérifiable plutôt qu'une demande de modification globale. Le but de ce workflow est de garder une trace des décisions, des fichiers concernés et des preuves de validation, même lorsque plusieurs sessions interviennent sur le même dépôt.

Prérequis

• un dépôt dont les commandes de test, lint et build sont connues ;
• un document qui décrit le résultat attendu et les limites ;
• un registre d'affectation si plusieurs agents peuvent écrire ;
• une personne responsable des arbitrages et de la validation finale.

Méthode en quatre temps

1. Décrire le résultat attendu et les limites du changement.
2. Lire les règles du projet, le code concerné et au moins un test voisin.
3. Réserver une tâche et une liste de fichiers à un seul propriétaire.
4. Implémenter une tranche verticale courte.
5. Exécuter le test ciblé, puis les gates du dépôt avant d'élargir la portée.

Cette séquence rend les erreurs localisables et évite de confondre une compilation réussie avec un comportement réellement vérifié.

Un contrat de tâche minimal

Une bonne affectation tient en quelques lignes :

Objectif : ajouter la durée de lecture aux articles.
Fichiers : lib/content.ts, lib/content.test.ts.
Acceptation : durée calculée depuis le corps MDX, minimum une minute.
Vérification : test ciblé, TypeScript, lint.
Interdit : modifier les pages ou lancer un build concurrent.

La liste de fichiers est importante. Deux tâches différentes peuvent tout de même entrer en collision si elles touchent la même configuration ou le même composant partagé.

Travailler par preuve

Pour une logique nouvelle, commencer par un test qui échoue. Pour une page, vérifier ensuite le rendu réel : structure des titres, navigation au clavier, console et comportement aux largeurs de référence. Le build reste une gate essentielle, mais il ne prouve ni la lisibilité ni le bon fonctionnement du parcours.

Next.js recommande les Server Components par défaut et conseille de limiter les frontières client aux zones réellement interactives. Cela réduit le JavaScript envoyé au navigateur et conserve un HTML utile sans exécution côté client. La checklist de production Next.js fournit une base officielle pour la dernière revue.

Terminer proprement

À la remise, le propriétaire indique les fichiers touchés, les commandes exécutées et les risques restants. L'orchestrateur relit le diff, lance les gates globales une seule fois et libère le périmètre. Cette discipline est moins spectaculaire qu'une modification massive, mais elle évite les corrections croisées et garde chaque régression attribuable.