Communitygithub.com

next-dev-loop

Vérifie le comportement runtime de Next.js après une modification du code applicatif. Utilisez cette compétence pour confirmer qu'un changement fonctionne réellement dans une application en cours d'exécution — pas seulement qu'il compile ou passe la vérification de types. Combine /_next/mcp (la vue de Next.js) avec agent-browser (la vue du navigateur). Nécessite un `next dev` en cours d'exécution.

Qu'est-ce que next-dev-loop ?

Cette compétence, appelée « next-dev-loop », est conçue pour les développeurs utilisant Next.js avec Turbopack (version 16.3 ou supérieure) et l'outil agent-browser (version 0.31.1 ou supérieure). Elle établit une boucle de vérification fiable lors d'une session `next dev` : après chaque modification du code, elle valide que le changement fonctionne à l'exécution, en combinant deux perspectives complémentaires. D'une part, l'endpoint HTTP `/_next/mcp` exposé par Next.js fournit des informations framework-spécifiques comme les routes, segments, actions serveur, logs, et erreurs. D'autre part, agent-browser contrôle un navigateur Chrome réel et inspecte le DOM, la console, le réseau, l'arbre React et les métriques de performance. La compétence exécute un pré-vol pour s'assurer que les deux vues sont actives, puis, en boucle, avant chaque modification elle utilise `/_next/mcp` pour réduire le périmètre de recherche aux fichiers ayant servi la route courante, et après la modification elle vérifie quatre aspects : la compilation sans erreur via `get_compilation_issues`, l'absence d'erreurs runtime, le comportement attendu via agent-browser, et le comportement React via l'inspection des composants. Elle inclut également des mises en garde détaillées sur la gestion de session, les divergences entre vues, et les pièges courants comme les sessions obsolètes ou les réponses SSE mal lues. En fin de session, elle ferme proprement la session agent-browser en sauvegardant l'état de connexion pour la prochaine utilisation.

Compatible avec~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/next.js/next-dev-loop

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait next-dev-loop ?

Le rythme édition/vérification pendant next dev — faites une modification, puis confirmez qu'elle fonctionne réellement à l'exécution, et pas seulement que les types ou la compilation sont corrects.

Vous vérifiez à travers deux vues de la même application en cours d'exécution :

  • /_next/mcp — un point de terminaison HTTP que Next.js expose à propos de lui-même. Connaît des éléments spécifiques au framework : routes, segments, RSC, actions serveur, logs serveur et erreurs telles que Next.js les a vues. Appelez tools/list pour la surface actuelle.
  • agent-browser — un CLI qui pilote un vrai Chrome. Connaît des éléments navigateur indépendants du framework : DOM, console, réseau, fibre React, métriques vitales. Avant de l'utiliser, exécutez agent-browser skills get core une fois pour obtenir le guide d'utilisation correspondant à votre version — ne devinez pas les sous-commandes de mémoire.

Les deux vues se recoupent mutuellement.

prérequis

  • Next.js 16.3+ avec Turbopack — /_next/mcp plus la vérification proactive de compilation via get_compilation_issues.
  • agent-browser >= 0.31.1 — introspection React, session id limité à l'arbre de travail, --restore idempotent et réconciliation des indicateurs de lancement.

Ce sont des seuils minimums stricts, pas des préférences souples. Si quelque chose manque, dites à l'utilisateur comment mettre à niveau et arrêtez-vous. Ne revenez pas à la recherche dans le code source ou à une sonde plus faible — cette compétence suppose que les deux vues sont actives aux versions ci-dessus.

pré-vol

Une fois par session, confirmez que les deux vues sont actives.

  1. Ouvrez agent-browser à l'URL cible, en restaurant l'état de connexion sauvegardé lorsqu'il est présent. Commencez par dériver un identifiant de session stable pour cette copie de travail et utilisez-le pour chaque commande agent-browser :

    SESSION="$(agent-browser session id --scope worktree --prefix next-dev-loop)"
    export AGENT_BROWSER_SESSION="$SESSION"
    export AGENT_BROWSER_RESTORE="$SESSION"
    

    Ouvrez ensuite l'URL cible :

    agent-browser --session "$SESSION" --restore --headed --enable react-devtools open <url>
    

    --scope worktree empêche les arbres de travail parallèles et les copies de checkout de se chevaucher. --restore seul utilise l'identifiant de session comme clé de persistance, charge les cookies/localStorage sauvegardés avant la navigation lorsqu'ils sont présents, et sauvegarde automatiquement l'état à la fermeture. Passez toujours les indicateurs de lancement souhaités sur open ; agent-browser réutilisera, relancera ou redémarrera son état d'arrière-plan limité selon les besoins.

    Le navigateur est celui de l'utilisateur. Si l'état n'a pas été restauré (première exécution, session expirée) et que la page est protégée, l'utilisateur effectue la connexion — faites une pause jusqu'à ce qu'il confirme. Après la connexion, continuez à utiliser la même session et le contexte de restauration ; agent-browser close sauvegarde l'état des cookies afin que la prochaine open le restaure.

  2. Sondez /_next/mcp (tools/list) — confirmez qu'il est joignable et qu'il liste get_compilation_issues :

    • Injoignable → soit next dev n'est pas en cours d'exécution, soit Next.js est antérieur à la version 16.3. Vérifiez package.json pour lever l'ambiguïté, puis refusez.
    • get_compilation_issues n'est pas dans la liste → Next.js antérieur à 16.3. Refusez et dites à l'utilisateur de mettre à niveau.
  3. get_compilation_issues sert également de sonde Turbopack. Une réponse d'erreur "Turbopack project is not available..." signifie que l'utilisateur est sur webpack. Refusez — Turbopack est requis.

  4. get_routes → votre carte des routes pour le reste de la session.

boucle

avant la modification — réduisez le périmètre

Interrogez l'application en cours d'exécution, pas la base de code. /_next/mcp sait quels fichiers ont rendu la route actuelle ; utilisez-les comme périmètre de recherche. L'introspection runtime reste économique à mesure que la base de code grandit ; la recherche agentique ne l'est pas.

après la modification — vérifiez

Quatre modes d'échec. Vérifiez chacun :

  • Compilation — get_compilation_issues.
  • Exécution sans erreurs — /_next/mcp (les erreurs serveur et les erreurs navigateur remontées apparaissent ici).
  • Comportement conforme — agent-browser pilote la page ; affirmez ce que l'utilisateur voit réellement.
  • Comportement au niveau React — agent-browser avec react-devtools activé expose l'arbre des composants, les props, l'état et les compteurs de rendu. Ancrez ici les vérifications au niveau du framework (rendus supplémentaires, déplacements de frontière serveur/client, fallbacks suspense) — les assertions DOM seules les manquent.

Choisissez l'outil spécifique dans tools/list ou le manuel agent-browser plutôt que de mémoire.

pièges

  • Chaque commande agent-browser doit connaître votre session et votre clé de restauration, sinon elle pourrait utiliser un navigateur par défaut vide ou échouer à sauvegarder l'état de connexion. Le plus simple : exportez à la fois AGENT_BROWSER_SESSION="$SESSION" et AGENT_BROWSER_RESTORE="$SESSION" en haut de chaque terminal où vous exécutez agent-browser. Si vous ne les exportez pas, passez --session "$SESSION" --restore sur chaque commande.
  • Quand les deux vues divergent, suspectez d'abord l'outillage. Si agent-browser indique qu'une route est cassée mais que /_next/mcp et le serveur disent qu'elle a été rendue proprement, une session navigateur obsolète ou mal dirigée est plus probable qu'un vrai bogue — réconciliez les vues avant de déboguer l'application.
  • Confirmer un clic ou une navigation : la page se stabilise un instant plus tard, donc attendez avec wait --load networkidle (pas de chemin à se tromper), puis prenez un instantané/lisez pour confirmer la page. Évitez wait --url sauf si vous passez le href exact du lien — un chemin deviné ou un espace réservé ne correspondra pas à l'URL réelle et expirera après 25s.
  • Une lecture vide, un instantané vide, about:blank ou une erreur "no browser session" — juste après open ou après un clic (même si open a signalé la page) — signifie que le navigateur a abandonné la page (une session obsolète), pas une route cassée. Rouvrez votre session à l'URL avec --session "$SESSION" --restore et reprenez un instantané ; si toujours vide, exécutez agent-browser --session "$SESSION" --restore close, puis ouvrez à nouveau. Ne revenez pas à curl ; il contourne le navigateur que vous testez.
  • Le résultat de l'introspection React est obsolète après une navigation. Réexécutez.
  • Les réponses de /_next/mcp sont SSE — lisez le JSON de la ligne data: avec sed -n 's/^data: //p' (un simple sed 's/^data: //' laisse la ligne event: et l'analyse échoue).
  • Serveur de développement non sur le port 3000 : lisez la bannière next dev ; définissez NEXT_MCP_URL=http://localhost:<port>/_next/mcp.
  • get_errors et get_page_metadata nécessitent au moins une navigation pour se remplir.

référence

Tous les outils ci-dessous sont présents une fois le pré-vol réussi. Si tools/list manque de l'un d'eux, le pré-vol aurait dû refuser — revérifiez.

# /_next/mcp                 notes
get_project_metadata         projectPath, devServerUrl, bundler
get_routes                   analyse du système de fichiers ; aucune session navigateur nécessaire
get_errors                   runtime + compilation ; nécessite une session navigateur ;
                             inclut les erreurs côté navigateur interceptées par le
                             serveur de développement
get_page_metadata            trie de segments + routerType ; nécessite une session
                             navigateur ; utilisez-le comme raccourci de découverte pour
                             savoir quels fichiers alimentent une route
get_logs                     renvoie logFilePath
get_server_action_by_id      id haché → fichier + nomFonction
get_compilation_issues       Turbopack uniquement ; erreurs sur webpack
                             ("Turbopack project is not available")

démontage

Fermez la session avec le même contexte de session et de restauration : agent-browser --session "$SESSION" --restore close. close sauvegarde les cookies et le stockage de cette session afin que la prochaine open avec --restore garde l'utilisateur connecté. Laissez next dev en cours pour la prochaine boucle.


Les jumeaux next-dev-loop-<sujet> (par exemple next-dev-loop-rsc, next-dev-loop-debug) supposent que ce pré-vol a déjà été exécuté ; ils reprennent à la boucle.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

0n6k4v-Coder/skills

Translates Figma motion and animations into production-ready application code. Use when implementing animation/motion from a Figma design — user mentions "implement this motion", "add animation from Figma", "animate this component", provides a Figma URL whose node is animated, or when `get_design_context` returns motion data or instructs you to call `get_motion_context`.

0n6k4v-Coder/skills

Motion / animation context for the `use_figma` MCP tool — animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.

0n6k4v-Coder/skills

Generate motion specification annotations from After Effects timeline data. Use when the user mentions "motion", "motion spec", "animation spec", "timeline", or wants to document a component's animation properties.

0n6k4v-Coder/skills

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender / instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.

0n6k4v-Coder/skills

Optimize a Next.js app that has `cacheComponents: true` — either the static shell on first paint, or the in-app navigation between routes. Picks the matching diagnostic loop and runs it.

Skills associés