Utiliser vagejs avec votre agent de code IA
Votre assistant connaît les règles.

Vous ne savez pas quoi demander ? Le générateur de prompts pour sites web écrit votre premier prompt à partir de quelques réponses. Vous hésitez encore entre plusieurs outils ? Notre guide des générateurs de sites statiques pour assistants de code IA explique ce qu'il faut regarder et compare les options les plus populaires.

Que reçoit votre assistant ?

• AGENTS.md dans le dossier du projet : les commandes, des recettes pour les tâches courantes (ajouter une page, en renommer une, ajouter un article de blog, ajouter une langue, rendre un composant interactif) et les règles, comme « ne jamais inventer de dates ni d'auteurs ». La plupart des agents de code lisent ce fichier d'eux-mêmes.
• CLAUDE.md, qui contient une seule ligne, @AGENTS.md, pour que Claude Code charge les mêmes instructions.

Vous n'utilisez pas vagejs ? Le générateur d'AGENTS.md gratuit en crée un pour n'importe quel projet de site web.

• npx vage info --json : chaque commande, option et réglage, avec des JSON Schemas pour la configuration et le frontmatter. Les assistants ont pour consigne de l'utiliser au lieu de deviner.
• Une sortie --json pour build, check, audit et les commandes de déploiement, où chaque problème nomme le fichier à corriger.
• Un serveur MCP (facultatif). npx -p vagejs vage mcp permet aux assistants qui parlent MCP d'appeler vagejs directement : le décrire, vérifier le site, lister les pages et les liens sortants. Tout est en lecture seule : l'approbation des liens et la publication restent entre vos mains.
• Une publication qui vous attend. Les déploiements, les push et les envois à IndexNow affichent leur plan et s'arrêtent pour attendre un oui : un assistant ne peut donc pas publier votre site de lui-même.

Un assistant peut même créer le site pour vous. Quand npm create vagejs@latest s'exécute dans un agent ou un script, il ne pose aucune question et affiche les prochaines étapes au lieu de démarrer un serveur.

Quel fichier d'instructions chaque outil lit-il ?

Chaque guide couvre la configuration, la façon dont l'outil trouve les instructions, les commandes à le laisser lancer librement et une astuce propre à cet outil.

Quelle boucle chaque assistant suit-il ?

npx vage info --json     # learn the commands and settings
# edit pages in src/pages/
npx vage check --json    # fix every error it reports
npx vage build --json    # build the finished site

Les instructions demandent à l'assistant de lancer check après chaque modification et de ne terminer que lorsqu'il signale zéro erreur. Les avertissements qu'il ne peut pas corriger vous sont signalés, pas cachés.

Quelles règles valent la peine d'être gardées ?

• Laissez-le lancer librement les commandes sûres. npm run check, npm run build et npx vage info ne font que lire votre projet ou écrire dans dist/.
• Gardez la publication manuelle. Ne mettez pas vage deploy, deploy:github ou indexnow sur une liste d'approbation automatique, et n'utilisez pas les modes « tout approuver » sur un projet qui compte pour vous.
• Les faits viennent de vous. Les instructions demandent aux assistants de vous demander les titres, les dates, les auteurs et les affirmations au lieu de les inventer. Si le vôtre invente quelque chose, renvoyez-le vers AGENTS.md.
• Préférez les pages simples. AGENTS.md demande aux assistants d'utiliser des pages Markdown et du HTML simple, sauf si vous demandez du MDX ou des composants interactifs, car chaque composant interactif ajoute du JavaScript.
• Gardez les secrets hors du chat. Les clés d'API vont dans des variables d'environnement ou dans vage connect, jamais dans un prompt ni dans une page.

Prêt à coller quelque chose ? La bibliothèque de prompts contient des prompts pour les tâches courantes, qui fonctionnent avec n'importe lequel de ces outils.