L07 · Construcción y vista previa · 5 min
Ramas, pull requests y fusiones
En una frase
Una rama es una copia borrador segura de tu proyecto donde tu agente construye una tarea nueva sin tocar la versión publicada en main, y un pull request te permite revisar los cambios y probar una vista previa antes de fusionarlos.
Piénsalo así
Piensa en cambiar la carta de un restaurante en pleno servicio. No tachas platos en las cartas que están en las mesas (`main`); haces un borrador aparte (`branch`), pruebas el plato nuevo (`pull request` + `Preview`) y solo cambias las cartas del comedor (`merge`) cuando das el visto bueno.
Cómo funciona
En tu Definiciónrepositorio (repo)La carpeta de tu proyecto más todo su historial. Git registra cada punto de guardado para que puedas volver a cualquier versión.Abrir en el glosario →, la rama DefiniciónmainLa rama principal. Lo que hay en `main` es lo que muestra tu web publicada.Abrir en el glosario → es la línea principal del historial: todo lo que está en main es lo que DefiniciónVercelEl servicio que convierte tu código de GitHub en una web publicada, con una vista previa para cada cambio.Abrir en el glosario → muestra en la versión en Definiciónproducción (Production)La versión publicada de tu app, la que ve todo el mundo. Sale de `main`.Abrir en el glosario → de tu web. Como las personas que visitan tu web ven main, tu agente nunca construye trabajo a medias directamente ahí.
En su lugar, al empezar cada tarea de tu DefiniciónplanLa especificación dividida en tareas pequeñas, cada una terminada y comprobable por sí sola, en `tasks/plan.md`.Abrir en el glosario →, tu agente crea una DefiniciónramaUna copia segura de tu proyecto donde se preparan los cambios. `main` es la publicada.Abrir en el glosario → llamada feature/<nombre-corto> (por ejemplo, feature/formulario-contacto). En esa rama puede guardar commits, probar cambios y corregir fallos sin afectar a la web publicada.
Cuando la tarea funciona en tu equipo, el agente sube la rama a GitHub con un Definiciónpush (subir)Enviar tus commits desde tu equipo a GitHub.Abrir en el glosario → y abre un Definiciónpull requestUna propuesta de cambios para fusionar una rama, que GitHub muestra con sus cambios y comprobaciones para que la revises antes.Abrir en el glosario → (gh pr create). Un pull request es una página de propuesta en GitHub que muestra qué cambió, ejecuta comprobaciones automáticas (lint, tipos y DefinicióntestUn pequeño programa que comprueba que tu app hace lo que debe, para que un arreglo no se rompa sin avisar más adelante.Abrir en el glosario →) y pide a Vercel un enlace privado de Definiciónvista previa (Preview)Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.Abrir en el glosario →.
Tú abres el enlace de vista previa, pruebas la función y decides. Solo cuando dices «adelante» o «publica», tu agente ejecuta gh pr merge --squash --delete-branch para Definiciónfusionar (merge)Llevar los cambios de una rama a otra, normalmente a `main` una vez aprobados.Abrir en el glosario → el trabajo terminado en main, borrar la rama temporal y actualizar la web en producción.
Cómo se ve en tu proyecto
Nunca tendrás que crear ramas ni pull requests a mano. Tu agente crea la rama feature/... al empezar una tarea de tasks/todo.md, abre el pull request cuando está lista y te comparte el enlace de vista previa de Vercel en el chat para que lo pruebes con un clic.
Copia para tu agente
Enséñame en qué rama estamos ahora mismo, si hay algún pull request abierto y explícame qué comprobaciones deben pasar antes de fusionar en main.
Comprobación rápida · 1 pregunta