Next.js 16.3 : le framework s'outille pour les agents de code

AGENTS.md, maintenu automatiquement par next dev

Depuis la 16.2, create-next-app embarque la documentation Next.js directement dans le projet, et AGENTS.md pointe vers ces docs versionnées plutôt que de laisser un agent s'appuyer sur ses données d'entraînement — potentiellement obsolètes de plusieurs versions. En 16.3, next dev écrit et met à jour ce pointeur tout seul, à chaque démarrage, tant qu'un agent de code est détecté dans l'environnement :

<!-- BEGIN:nextjs-agent-rules -->
 
# This is NOT the Next.js you know
 
This version has breaking changes — APIs, conventions, and file
structure may all differ from your training data. Read the relevant
guide in `node_modules/next/dist/docs/` before writing any code.
 
<!-- END:nextjs-agent-rules -->

Le bloc est délimité par des marqueurs : tout ce qui se trouve en dehors est préservé, et l'option agentRules: false dans next.config.ts permet de désactiver complètement l'insertion. Sur un projet antérieur à la 16.2, un codemod fait le travail une fois : npx @next/codemod@canary agents-md.

Trois Skills first-party pour les workflows multi-étapes

Les anciennes Skills de connaissance (conventions App Router, API de cache) sont retirées : AGENTS.md couvre désormais ce rôle. À la place, Next.js 16.3 ajoute trois Skills pensées pour des workflows que la documentation seule ne peut pas piloter de bout en bout :

• next-dev-loop donne accès à toute la boucle de développement — piloter le navigateur, lire la console, suivre le réseau, inspecter l'arbre React — en combinant /_next/mcp (vue du framework sur les routes et la compilation) et agent-browser (vue du navigateur sur le DOM et React).
• next-cache-components-adoption active Cache Components projet par projet, feature par feature, en s'arrêtant à chaque frontière pour laisser la main : un mode incrémental qui pose une PR mécanique désactivant la validation partout, ou un mode direct qui adopte tout sur une seule branche.
• next-cache-components-optimizer fait grossir la coquille statique d'une route via une boucle observe-fix-iterate, avec une capture d'écran avant/après à chaque itération — si les deux captures sont identiques, le changement est annulé.

npx skills add vercel/next.js --skill next-dev-loop

Agent Browser : une introspection React en ligne de commande

Le CLI expérimental next-browser de la 16.2 a fusionné dans agent-browser, un outil désormais généraliste qui fonctionne au-delà de Next.js. La version 0.27 ajoute l'introspection React DevTools par-dessus l'accès existant au DOM, à la console, au réseau et aux Web Vitals : lister l'arbre de composants (react tree), inspecter un fiber précis (react inspect <fiberId>), profiler les re-renders (react renders start / stop), ou repérer ce qui bloque un rendu (react suspense --only-dynamic --json). L'installation se fait via npm install -g agent-browser@^0.27, et les commandes React exigent le flag --enable react-devtools au lancement.

Des erreurs pensées pour être copiées-collées à un agent

Avec Cache Components activé, un await côté serveur devient un choix explicite entre trois correctifs : envelopper dans un <Suspense> (stream), mettre en cache avec "use cache", ou accepter une route bloquante avec export const instant = false. L'overlay de dev et le terminal présentent désormais ces choix sous forme de menu étiqueté, avec un bouton Copy prompt qui empaquette le correctif choisi dans un prompt prêt à coller — code incriminé, lien vers la page de doc correspondante, et étapes de vérification à l'exécution incluses. Le même menu apparaît dans les logs de next build et de CI, là où l'overlay n'existe pas.

Le serveur MCP suit le même mouvement de recentrage : les outils de base de connaissance sont retirés au profit des docs bundlées, remplacés par deux outils de diagnostic de build, get_compilation_issues et compile_route, qui interrogent le serveur de dev déjà lancé plutôt que de déclencher un next build complet. Et pour les agents qui ne passent par aucun de ces outils, chaque URL de documentation accepte désormais un suffixe .md renvoyant la page en Markdown brut, suivant la convention llms.txt.

Ces changements sont documentés dans le billet publié le 26 juin 2026 à l'approche de la version stable 16.3 — un signal assez net que l'agent de code devient, aux yeux de l'équipe Next.js, un second lecteur du framework à part entière.