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

> Crea un sitio web con un agente de programación de IA. vagejs funciona con Claude Code, Codex, Cursor, GitHub Copilot y Gemini CLI, y aquí ves qué lee cada uno.

vagejs es un generador de sitios estáticos hecho para agentes de programación con IA. Cada sitio nuevo incluye un archivo de instrucciones `AGENTS.md`, un comando que describe toda la herramienta como datos y revisiones que indican el archivo exacto que hay que corregir, para que Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI y otros agentes puedan crear tu sitio sin adivinar.

Actualizado el 28 de octubre de 2026

¿No sabes qué pedir? El [generador de prompts para sitios web](https://vagejs.com/prompts/builder/) 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](https://vagejs.com/guides/static-site-generator-for-ai-coding-assistants/) 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](https://vagejs.com/tools/agents-md-generator/) 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?

| Herramienta | Lee por su cuenta | Configuración necesaria |
| --- | --- | --- |
| [Claude Code](https://vagejs.com/agents/claude-code/) | `CLAUDE.md`, y `AGENTS.md` en las versiones recientes | Ninguna: el `CLAUDE.md` del sitio inicial importa `AGENTS.md` |
| [OpenAI Codex](https://vagejs.com/agents/codex/) | `AGENTS.md` | Ninguna |
| [Cursor](https://vagejs.com/agents/cursor/) | `AGENTS.md` y `.cursor/rules/*.mdc` | Ninguna |
| [GitHub Copilot](https://vagejs.com/agents/github-copilot/) | `AGENTS.md` y `.github/copilot-instructions.md` | Ninguna en VS Code; el agente en la nube necesita un flujo de trabajo de configuración |
| [Gemini CLI](https://vagejs.com/agents/gemini-cli/) | `GEMINI.md` | Un ajuste para añadir `AGENTS.md` |
| [Otros agentes](https://vagejs.com/agents/other/) | Depende | Devin Desktop, Cline, Aider, Zed y más |

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?

terminal

```
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](https://vagejs.com/es/features/react-vue-mdx/), 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](https://vagejs.com/es/prompts/) tiene prompts para tareas cotidianas que funcionan con cualquiera de estas herramientas.