Manual avanzado: haz que la IA entienda mejor tu proyecto
💡 Objetivo: en unos 32 minutos (tres lecciones de 10–12 minutos cada una) lograrás tres cosas: escribir para tu proyecto un manual que la IA pueda leer, permitir que el agente de codificación de IA gestione directamente tus despliegues en Vercel, y cambiar github.io por tu propio dominio.
Al llegar a este punto, ya puedes entregar requisitos a la IA de forma estable siguiendo las «cinco disciplinas» (requisito previo: Flujo de trabajo eficiente: las cinco disciplinas del vibe coding). A continuación viene el problema central que resuelve el nivel avanzado de vibe coding: cada vez que abres una conversación nueva, la IA tiene que conocer tu proyecto desde cero: el stack tecnológico, la estructura de directorios y los comandos habituales, no recuerda nada de eso.
Cada sesión de Claude Code comienza con una ventana de contexto totalmente nueva. La documentación oficial ofrece dos mecanismos para transferir conocimiento entre sesiones: CLAUDE.md (las instrucciones de proyecto que tú escribes; Claude también puede leer el AGENTS.md del repositorio en su lugar) y la memoria automática (la IA anota como apuntes propios las preferencias que tú has corregido). Codex y OpenCode también leen este mismo tipo de archivos de manual, así que basta con escribir uno para usarlo en las tres herramientas.
El manual resuelve el problema de «que la IA entienda tu proyecto». Las otras dos lecciones de esta etapa amplían sobre esa base: la primera usa el Plugin, Skills y MCP de Vercel para que el agente de codificación de IA pueda buscar documentación, gestionar proyectos y desplegar directamente; la segunda vincula tu propio dominio a un sitio de github.io.
🎯 Objetivos de la etapa
- Saber redactar un manual de proyecto: stack tecnológico, estructura de directorios y comandos habituales dentro de AGENTS.md / CLAUDE.md; al abrir una sesión nueva ya no hay que explicarlo todo desde cero
- Saber instalar el trío de Vercel: qué gestiona cada uno de los tres comandos de Plugin, Skills y MCP, para conectar el agente de codificación de IA con tus despliegues
- Saber vincular tu propio dominio: configurar la resolución DNS del sitio de GitHub Pages y abrirlo con tu propio dominio
⏳ Tiempo estimado
- Las tres lecciones suman unos 32 minutos (de 10–12 minutos por lección); con margen de holgura, unos 30–42 minutos
- Cada lección es independiente: si tu proyecto se atasca en algo concreto, salta directamente a esa lección y síguela paso a paso
🚀 Antes de empezar
- Haber completado la parada anteriorFlujo de trabajo eficiente: las cinco disciplinas del vibe coding y haber colaborado con la IA al menos una ronda completa en un proyecto real
- Tener a mano un proyecto pequeño propio como material de práctica: el manual solo sirve si se escribe para un proyecto real
- Si quieres seguir las lecciones segunda y tercera, ten preparada de antemano una cuenta de Vercel o de GitHub (las operaciones de ambas lecciones se realizan en esas dos plataformas)
- Un vaso de agua ☕: en esta parada hay pocos comandos; lo principal es sacar el «conocimiento del proyecto» fuera de la conversación
📚 Cursos de esta etapa
| Curso | Contenido | Duración |
|---|---|---|
| 5.1 AGENTS.md y CLAUDE.md: deja a la IA un manual de tu proyecto | Qué escribir en el manual y dónde ponerlo: stack tecnológico, estructura de directorios y comandos habituales explicados de una vez; compatible con Claude Code, Codex y OpenCode | 12 minutos |
| 5.2 Vercel × agentes de codificación de IA: el trío de Plugin, Skills y MCP | Tres comandos oficiales que dotan a la IA de capacidades de despliegue: el Plugin aporta habilidades de despliegue y comandos de barra, Skills añade guías de despliegue, y MCP permite al agente buscar documentación y gestionar proyectos y despliegues | 10 minutos |
| 5.3 Dominio personalizado: de github.io a tu propio dominio | Resolución y vinculación de DNS: CNAME de subdominio, cómo manejar el dominio apex, y verificar primero para evitar el takeover | 10 minutos |
💡 Cómo estudiar de la forma más eficaz
- El manual es contexto, no un interruptor: la IA trata AGENTS.md / CLAUDE.md como contexto y no como configuración obligatoria; cuanto más concretas y concisas sean las instrucciones, más coherentemente las seguirá; para bloquear una operación de forma estricta, usa un gancho (hook) para interceptarla
- Valida mientras aprendes: cada vez que modifiques el manual, abre una sesión nueva y comprueba si la IA actúa según las nuevas reglas; el efecto solo puede confirmarse con pruebas reales
- ¿No recuerdas todos los comandos? Consulta sobre la marcha Tabla de referencia rápida de las cuatro herramientas: comandos de instalación y operaciones clave
🎒 Lo que vas a conseguir
Al terminar esta parada, tu equipamiento avanzado de vibe coding habrá ganado cuatro cosas:
- Un manual de proyecto compatible con las tres herramientas (AGENTS.md / CLAUDE.md), y de paso conocerás la memoria automática de Claude Code
- Saber explicar qué es agents.md y qué es mcp: dos términos frecuentes del nivel avanzado que dejarán de serte ajenos
- Una forma de trabajar en la que el agente de codificación de IA busca documentación y gestiona proyectos y despliegues directamente
- Un sitio publicado al que se accede con tu propio dominio
¿Todo listo? Empieza la primera lección →