Usa vagejs con tu agente de programación con IA
Tu asistente conoce las reglas.

¿No sabes qué pedir? El generador de prompts para sitios web escribe tu primer prompt a partir de unas pocas respuestas. ¿Aún estás eligiendo herramienta? Nuestra guía de generadores de sitios estáticos para asistentes de programación con IA explica en qué fijarse y compara las opciones más populares.

¿Qué recibe tu asistente?

• AGENTS.md en la carpeta del proyecto: los comandos, recetas para tareas habituales (añadir una página, cambiarle el nombre, añadir una entrada de blog, añadir un idioma, hacer interactivo un componente) y las reglas, como "nunca inventes fechas ni autores". La mayoría de los agentes de programación leen este archivo por su cuenta.
• CLAUDE.md, que contiene una sola línea, @AGENTS.md, para que Claude Code cargue las mismas instrucciones.

¿No usas vagejs? El generador de AGENTS.md gratuito crea uno para cualquier proyecto web.

• npx vage info --json: todos los comandos, opciones y ajustes, con JSON Schemas para la configuración y el frontmatter. A los asistentes se les indica que lo usen en lugar de adivinar.
• Salida --json de build, check, audit y los comandos de publicación, en la que cada problema indica el archivo que hay que corregir.
• Un servidor MCP (opcional). npx -p vagejs vage mcp permite que los asistentes que hablan MCP llamen directamente a vagejs: describirlo, revisar el sitio, listar las páginas y los enlaces salientes. Todo en modo de solo lectura: aprobar enlaces y publicar sigue en tus manos.
• Publicaciones que te esperan. Las publicaciones, los push y los envíos a IndexNow muestran su plan y se detienen hasta que digas que sí, así que un asistente no puede publicar tu sitio por su cuenta.

Un asistente puede incluso crear el sitio por ti. Cuando npm create vagejs@latest se ejecuta dentro de un agente o de un script, no pregunta nada y muestra los siguientes pasos en lugar de iniciar un servidor.

¿Qué archivo de instrucciones lee cada herramienta?

Cada guía explica la configuración, cómo encuentra esa herramienta las instrucciones, qué comandos dejarle ejecutar libremente y un consejo que solo sirve para esa herramienta.

¿Qué ciclo sigue cada asistente?

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

Las instrucciones le dicen al asistente que ejecute check después de cada cambio y que solo termine cuando informe de cero errores. Los avisos que no pueda corregir te los comunica, no los oculta.

¿Qué reglas merece la pena mantener?

• Deja que ejecute libremente los comandos seguros. npm run check, npm run build y npx vage info solo leen tu proyecto o escriben en dist/.
• Mantén la publicación en modo manual. No pongas vage deploy, deploy:github ni indexnow en una lista de aprobación automática, y no uses modos de "aprobar todo" en un proyecto que te importe.
• Los datos los pones tú. Las instrucciones les dicen a los asistentes que te pidan los títulos, las fechas, los autores y las afirmaciones en lugar de inventarlos. Si el tuyo se inventa algo, remítelo de nuevo a AGENTS.md.
• Prefiere páginas sencillas. AGENTS.md les dice a los asistentes que usen páginas Markdown y HTML plano salvo que pidas MDX o componentes interactivos, porque cada componente interactivo añade JavaScript.
• Mantén los secretos fuera del chat. Las claves de API van en variables de entorno o en vage connect, nunca en un prompt ni en una página.

¿Listo para algo que pegar? La biblioteca de prompts tiene prompts para tareas cotidianas que funcionan con cualquiera de estas herramientas.