En el primer artículo de esta serie explicamos cómo preparar un ordenador para hacer vibe coding. Instalamos Linux, configuramos Codex y Antigravity, conectamos GitHub y publicamos nuestra primera aplicación utilizando Railway.
Conseguimos desarrollar una pequeña aplicación con inteligencia artificial sin escribir nosotros el código.
Pero aquello era una prueba. Le pedimos a Codex que programara, comprobamos que funcionaba y después utilizamos Antigravity para revisar el resultado. Para empezar está bien, pero si queremos trabajar con proyectos reales necesitamos algo más organizado.
¿Qué ocurre cuando tenemos varias funcionalidades pendientes? ¿Cómo evitamos que la IA modifique archivos que no debería? ¿Quién comprueba que una solución está bien planteada antes de programarla? ¿Y cómo sabemos que lo publicado es exactamente lo que hemos revisado?
Para responder a estas preguntas he ido construyendo mi propio método de trabajo. No he inventado nada revolucionario: he adaptado prácticas habituales del desarrollo profesional a un entorno donde gran parte del trabajo lo realizan agentes de inteligencia artificial.
Te explico cómo organizarlo y utilizarlo paso a paso. Por si te ayuda a replicarlo.
Cómo organizo el trabajo con agentes de IA
La idea es sencilla: una inteligencia artificial desarrolla y otra audita su trabajo, mientras nosotros conservamos el control de las decisiones importantes.
En mi caso utilizo cinco herramientas base:
| Herramienta | Función |
| Codex | Analiza, planifica, programa, prueba y documenta. |
| Antigravity | Audita independientemente el plan y el código. |
| GitHub | Guarda el código, las versiones y las Pull Requests. |
| Linear | Organiza tareas, pruebas, auditorías y estados. |
| Notion | Conserva requisitos, decisiones e histórico del proyecto. |
A éstas añado un par: Local WP si son desarrollos de WordPress y Convex o Supabase si es una aplicación web que requiere de base de datos.
Notion es opcional, aunque lo recomiendo para proyectos medianos. Después veremos por qué.
Tampoco estamos obligados a utilizar estas mismas aplicaciones. Podemos sustituir Codex por Claude Code, por ejemplo, o emplear otro agente como auditor. Lo fundamental es mantener responsabilidades separadas.
El procedimiento completo es:
- Requisitos.
- Plan técnico.
- Primera auditoría.
- Desarrollo y pruebas.
- Segunda auditoría.
- GitHub.
- Despliegue.
- Verificación.
Los pasos 2 (Codex) y 3 (Antigravity) se pueden repetir varias veces: si Antigravity encuentra un problema, Codex lo corrige y repetimos la revisión. La idea es avanzar mediante ciclos de trabajo y comprobación, sin pasar a la siguiente fase mientras existan problemas relevantes sin resolver.
En mi forma de trabajar hay dos auditorías obligatorias, aunque su profundidad depende de la complejidad del desarrollo. La primera revisa lo que vamos a hacer y la segunda comprueba lo que realmente hemos hecho.
Y algo importante: un GO del auditor no equivale a una autorización para publicar. Esa decisión sigue siendo nuestra.
Paso 1. Preparar nuestro entorno de trabajo con Codex
Partimos del ordenador configurado en el primer tutorial. Ya tenemos Codex, Antigravity y GitHub funcionando, así que no vamos a repetir instalaciones.
Abrimos una terminal en la carpeta de nuestro proyecto e iniciamos Codex:
cd ~/Proyectos/mi-proyecto
codex
Ahora viene una de las partes que más me gustan de trabajar con agentes: no necesitamos configurar manualmente toda la estructura del proyecto. Podemos pedirle a Codex que la prepare.
Prompt 1. Configurar el entorno de trabajo
Quiero preparar este proyecto para trabajar mediante un procedimiento de desarrollo supervisado con IA.
Tú actuarás como analista y desarrollador. Antigravity será el auditor independiente. Utilizaremos GitHub para el código, Linear para las tareas y, opcionalmente, Notion para la documentación.
Inspecciona el proyecto y comprueba las conexiones disponibles. Propón las instrucciones permanentes, la documentación mínima, las reglas de permisos y un procedimiento con dos auditorías obligatorias: del plan técnico y del código.
Las implementaciones, operaciones Git importantes y despliegues requieren autorización humana. Las tareas solo se cierran después de verificar producción.
Presenta primero un plan de configuración. No crees archivos ni modifiques servicios hasta recibir autorización.
Codex debería analizar qué tenemos disponible y decirnos qué falta.
Normalmente habrá algunas operaciones que sí tendremos que realizar personalmente:
- Iniciar sesión en Linear o Notion.
- Autorizar una integración.
- Aceptar permisos o crear una conexión que requiera autenticación desde el navegador.
MUY IMPORTANTE: no debemos entregarle contraseñas ni tokens pegándolos directamente en el chat.
Utilizaremos los mecanismos de autenticación de cada servicio (Github y Claudflare los tienen) y concederemos únicamente los permisos necesarios.
Una vez aprobada la configuración, Codex podrá preparar los archivos y organizar las herramientas.
Eso sí, revisaremos que realmente lo haya hecho, así que le pediremos que lo compruebe. Un agente no puede crear una conexión con Linear si su entorno no dispone de una integración compatible.
Paso 2. Organizar la documentación sin llenar el repositorio de archivos
Para trabajar con agentes necesitamos algo que las conversaciones por sí solas no ofrecen: memoria operativa del proyecto.
Imagina que llevamos varias semanas desarrollando y comenzamos una sesión nueva de Codex. No queremos explicarle otra vez toda la arquitectura, qué herramientas utilizamos, qué archivos puede tocar y cómo funciona el despliegue.
Para evitarlo, utilizaremos dos documentos básicos dentro del repositorio:
- AGENTS.md: instrucciones permanentes para Codex, límites de actuación y reglas del desarrollo.
- PROJECT.md: descripción del proyecto, arquitectura básica, entornos y enlaces a la documentación.
Codex puede crearlos a partir de nuestros requisitos.
¿Y para qué necesitamos Notion?
En proyectos pequeños, los archivos Markdown pueden ser suficientes para documentar cambios y decisiones. Pero cuando empezamos a acumular funcionalidades, decisiones, requisitos y cambios de arquitectura, terminamos con demasiados documentos dentro del repositorio.
Por eso recomiendo Notion para proyectos medianos.
Ahí guardaremos principalmente los PRD (Product Requirements Document), las decisiones técnicas y el histórico del proyecto. Linear recogerá las tareas, sus estados, las auditorías y las pruebas. GitHub conservará el código.
Lo interesante es que Notion y Linear los utilizarán principalmente los propios agentes. Codex redactará y actualizará documentación, consultará los requisitos antes de programar y registrará los resultados. Antigravity necesitará leer esa información para auditar.
Nosotros no tendremos que escribir manualmente páginas y páginas de documentación. Nuestra responsabilidad será comprobar que los requisitos y las decisiones importantes reflejan lo que queremos.
Paso 3. Definir qué queremos desarrollar
Vamos a utilizar como ejemplo un desarrollo real que he realizado para esta web.
En mi revista, las páginas de etiquetas mostraban las publicaciones siguiendo un orden cronológico. Quería mejorarlas para que destacaran los contenidos más interesantes sin perder el listado habitual.
Esta es la clase de necesidad que podemos explicar a Codex utilizando lenguaje natural, sabiendo que una petición así deja algunas preguntas abiertas.
- ¿Cuántos artículos destacamos?
- ¿Cómo decidimos cuáles son relevantes?
- ¿Qué ocurre con los demás?
- ¿Debe funcionar en todas las páginas?
- ¿Qué elementos no queremos modificar?
Antes de analizar nada, conviene resolverlas.
Prompt 2. Preparar requisitos y plan técnico
Quiero desarrollar esta funcionalidad: [DESCRIPCIÓN].
Lee las instrucciones y documentación del proyecto. Convierte la necesidad en requisitos verificables y criterios de aceptación. Prepara o actualiza el PRD y organiza las tareas necesarias en Linear.
Examina el código existente y propón la solución más sencilla que cumpla los requisitos, identificando archivos afectados, riesgos, alternativas y pruebas.
No programes todavía. Pregúntame las decisiones funcionales que no puedas resolver con la información disponible y prepara el plan para auditoría independiente.
Este es uno de los cambios más importantes respecto a pedirle simplemente a una IA que programe algo.
Codex puede ayudarnos a convertir una idea en una especificación. Nosotros decidimos si esa especificación representa nuestra necesidad.
En el caso de las etiquetas, por ejemplo, el criterio de aceptación no podía limitarse a que aparecieran artículos destacados. También necesitábamos conservar la navegación, evitar duplicidades no deseadas y mantener un funcionamiento correcto en las distintas páginas.
Una vez aprobado el planteamiento, Codex lo registra y prepara el plan técnico.
Todavía no hemos escrito una línea de código.
Diseño del front
En este caso, yo tenía muy claro el diseño que quería, así que no le pedí propuestas visuales. Sin embargo, en este punto en otras ocasiones se las pediría, para que las tuviera en cuenta antes de proponerme la solución técnica.
Obviamente, si lo sabes, se lo explicas y listo. O, si lo que necesitas es una funcionalidad que toca el back y no el front, tampoco te harán falta mockups.
Paso 4. Primera auditoría: comprobar el plan con Antigravity
Ahora entra en juego nuestro segundo agente.
Abrimos otra terminal en la misma carpeta del proyecto y ejecutamos:
agy
En mi procedimiento actual, Antigravity funciona manualmente. No dejamos que Codex lo invoque automáticamente y continúe sin que hayamos revisado el resultado.
Queremos que actúe como un auditor independiente, no como otro programador que empieza a modificar archivos.
Prompt 3. Auditar el plan técnico
Actúa exclusivamente como auditor técnico independiente.
Revisa las instrucciones del proyecto, los requisitos y el plan propuesto por Codex. Evalúa si la solución es viable, suficientemente sencilla, segura y compatible con el funcionamiento existente.
Comprueba los riesgos, las posibles regresiones y si las pruebas previstas son adecuadas.
Emite un dictamen justificado: GO, GO condicionado o NO-GO. Si no tienes evidencias suficientes, indícalo expresamente.
Identifica los problemas concretos y las correcciones necesarias. No modifiques ningún archivo.
¿Por qué auditar antes de desarrollar?
Porque una solución puede estar perfectamente programada y, aun así, ser una mala solución.
Quizá introduce dependencias innecesarias, repite información que ya existe, realiza demasiadas consultas o complica el mantenimiento futuro.
Con las etiquetas, por ejemplo, no bastaba con conseguir un sistema de destacados. También había que valorar cómo calcular su orden sin ejecutar operaciones lentas cada vez que alguien visitase una página.
Si el auditor identifica problemas, pegamos su informe en Codex. Este revisa el plan y volvemos a auditarlo cuando sea necesario.
No se empieza a programar hasta tener un plan aceptado y autorización humana para implementarlo.
Paso 5. Codex desarrolla y realiza las pruebas
Con el plan aprobado comienza la implementación.
Codex trabajará en una rama del repositorio. Si ya leíste la primera entrega, conoces Git y GitHub, así que no necesitamos repetir cómo utilizarlos.
Lo nuevo es que no programamos directamente sobre la versión estable del proyecto. Preparamos los cambios por separado para poder revisarlos antes de integrarlos.
Prompt 4. Implementar la funcionalidad
Autorizo desarrollar el plan aprobado y auditado correspondiente a [TAREA DE LINEAR].
Trabaja en una rama específica y limita los cambios al alcance autorizado.
Implementa la solución, ejecuta las pruebas pertinentes y comprueba posibles regresiones. Documenta los resultados en Linear.
Prepara el diff completo, identifica los archivos modificados y entrega las evidencias necesarias para la segunda auditoría.
No realices merge ni despliegues. Detente cuando el desarrollo esté listo para revisión.
Codex puede modificar archivos, ejecutar pruebas y corregir errores dentro del alcance que hemos aprobado.
Pero hay algo que debemos vigilar: que la IA afirme que una funcionalidad funciona no significa que realmente funcione.
Necesitamos evidencias. Según el proyecto, pueden ser pruebas automatizadas, resultados de ejecución, comprobaciones funcionales o una combinación de ellas.
También hay que distinguir entre lo que Codex ha probado y lo que todavía no puede verificar.
Volviendo a nuestro ejemplo: no basta con comprobar que aparecen tres artículos destacados. Debemos revisar qué ocurre cuando hay menos artículos disponibles, cuando se cambia de página o cuando algún contenido carece de los datos esperados, como un artículo no traducido a algún idioma.
El agente debe dejar constancia de esas comprobaciones y de cualquier limitación.
Paso 6. Segunda auditoría: revisar el código real
Ya tenemos la funcionalidad desarrollada, pero todavía no vamos a publicarla.
Volvemos a Antigravity y le pedimos que revise el código modificado, no simplemente el informe que ha preparado Codex.
Prompt 5. Auditar la implementación
Actúa como auditor técnico independiente de [TAREA DE LINEAR].
Revisa el diff completo, el plan aprobado, los requisitos y las evidencias de pruebas.
Busca defectos funcionales, problemas de seguridad, regresiones, complejidad innecesaria y modificaciones fuera del alcance autorizado.
Emite un dictamen justificado e identifica los hallazgos por archivo y ubicación cuando sea posible.
Registra la huella SHA-256 del diff auditado para identificar exactamente la versión revisada.
No modifiques archivos ni autorices commits, merges o despliegues.
Hay dos detalles importantes.
El primero es que Antigravity debe poder consultar las mismas reglas y requisitos que utilizó Codex. De lo contrario, corre el riesgo de revisar una solución técnicamente correcta, pero que no cumple lo que habíamos pedido.
El segundo es conservar documentación del conjunto de cambios auditado. Así podemos identificar la versión exacta que recibió el GO y detectar si el código se ha modificado después. Esa huella debe ser reproducible sobre el mismo contenido.
En mi caso guardamos todo completo en Linear, vinculado a la tarea correspondiente. No escribes tú y Linear y Notion tienen plan gratis: no escatimes en documentación.
De nuevo, si Antigravity encuentra errores, volvemos a Codex, pedimos las correcciones y repetimos la auditoría.
Y así hasta que esté todo ok.
Eso sí, dos agentes pueden equivocarse, incluso coincidiendo en su valoración, sobre todo si, como en este caso no usas la mejor combinación posible (los modelos más punteros de Claude y Codex para desarrollar y auditar respectivamente).
Por eso las auditorías son controles adicionales, no garantías absolutas. Y por eso, opcionalmente, podremos añadir una tercera IA.
Paso 7. Integrar los cambios en GitHub
Cuando tenemos una auditoría GO, podemos preparar la integración. El procedimiento habitual es:
Rama > Commit > Push > Pull Request > Merge.
No necesitamos ejecutar manualmente esos comandos. Codex puede encargarse, pero debemos entender qué estamos autorizando.
La Pull Request nos permite revisar qué cambios queremos incorporar a la rama principal, con qué pruebas y con qué consejos del auditor.
También conviene comprobar que la versión que vamos a integrar sigue siendo la auditada. Si modificamos el código después de recibir un GO, esa valoración puede dejar de ser válida.
Prefiero mantener autorizaciones explícitas para las operaciones importantes. Podemos agrupar algunas cuando el alcance sea muy claro, pero no conceder libertad ilimitada para integrar y publicar.
Una cosa es que el auditor considere correcto un desarrollo y otra que nosotros decidamos incorporarlo.
Aquí es cuando podría entrar la tercera IA: podemos incorporar un segundo auditor especializado, como CodeRabbit.
A diferencia de Antigravity, que utilizamos para revisar localmente el plan y el código, CodeRabbit puede analizar automáticamente las Pull Requests de GitHub antes de fusionarlas.
Es una revisión adicional interesante para proyectos importantes, aunque no resulta imprescindible y tiene coste, aunque es económico para todo lo que aporta. En mi caso, de momento prefiero mantener las dos auditorías manuales y valorar esta tercera revisión cuando esto sea más grande.
Paso 8. Desplegar y comprobar el funcionamiento en producción
Este paso depende bastante de dónde tengamos alojado nuestro proyecto.
En la primera entrega utilizamos Railway. También podríamos publicar mediante GitHub Actions, herramientas de nuestro hosting o cualquier otro sistema de despliegue.
Las particularidades de WordPress, LocalWP y Webempresa las veremos en otro artículo.
Aquí nos interesa una regla general: un despliegue completado correctamente no significa que la funcionalidad esté funcionando bien. Por eso, una vez publicado el cambio, debemos comprobar la aplicación real.
Eso significa en nuestro ejemplo visitar las páginas públicas, comprobar los artículos destacados, navegar por el listado y asegurarnos de que no hemos alterado otras funcionalidades.
También debemos confirmar que se está mostrando la versión nueva. A veces el código se publica correctamente, pero una caché continúa sirviendo contenido anterior, como me ocurría a mi con WP Rocket.
En desarrollos importantes debemos tener previsto cómo recuperar la versión estable si algo falla.
Solo después de realizar estas comprobaciones podemos afirmar que la funcionalidad está terminada.
Paso 9. Cerrar la tarea y preparar el siguiente desarrollo
Una vez verificado el resultado, pedimos a Codex que actualice Linear y la documentación del proyecto.
Debe registrar qué se ha desarrollado, qué versión está publicada, qué pruebas hemos realizado y si queda alguna incidencia pendiente.
La tarea pasa a completada después de la verificación en producción, no cuando Codex termina de programar ni cuando Antigravity emite su GO.
Esta documentación tiene otra ventaja: podemos cerrar la sesión y empezar una nueva sin perder el contexto.
De hecho, recomiendo hacerlo cuando comenzamos una funcionalidad diferente. Los agentes pueden recuperar las reglas, requisitos y decisiones desde los documentos del proyecto, en lugar de depender de conversaciones interminables.
Con el tiempo podremos automatizar parte de la coordinación entre Codex y Antigravity, aunque de momento prefiero mantenerla manual, comprobar que el procedimiento funciona y ganar confianza antes de eliminar pasos de supervisión.
¿Merece la pena trabajar así en cualquier desarrollo?
No.
Para crear una prueba o experimentar durante veinte minutos, preparar documentación, dos auditorías y un proceso de publicación es excesivo.
Pero cuando desarrollamos una web real, una aplicación para un cliente o un proyecto que vamos a mantener durante meses, ese trabajo adicional tiene todo el sentido.
La ventaja de este procedimiento no es que elimine los errores -nadie puede garantizar eso-, sino que permite trabajar de una manera más ordenada, documentar las decisiones y detectar problemas antes de que lleguen a los usuarios. Minimizamos los errores propios del Vibe Coding inicial.
Y, como la mayor parte de las tareas operativas las realizan los agentes, nuestra intervención se concentra en lo importante: decidir qué queremos, aprobar cómo vamos a hacerlo y comprobar que el resultado funciona.
Conclusión
En el primer artículo preparamos el ordenador. En este hemos preparado nuestra manera de trabajar. Ahora sabemos cómo:
- Convertir una necesidad en requisitos.
- Pedir a Codex un plan.
- Auditarlo con Antigravity.
- Desarrollar una funcionalidad.
- Revisar el código.
- Publicarlo con control de las versiones.
- Documentarlo todo.
No se trata simplemente de programar más rápido con inteligencia artificial sino de poder mantener lo que desarrollamos, entender qué se ha cambiado y tener un procedimiento para corregir los problemas cuando aparezcan.
En la próxima entrega aplicaremos esta forma de trabajar a WordPress: desarrollo local, pruebas, archivos versionados y despliegues en un hosting real.
Preguntas frecuentes
¿Necesito saber programar para utilizar este procedimiento?
No es imprescindible escribir código, pero sí comprender los conceptos básicos del desarrollo y aprender a interpretar las pruebas y los riesgos. La IA no elimina nuestra responsabilidad sobre el resultado.
¿Es obligatorio utilizar Codex y Antigravity?
No. Puedes sustituirlos por otros agentes de programación y revisión. Lo importante es separar las funciones y evitar que el desarrollador sea el único que evalúa su propio trabajo.
¿Necesito Notion y Linear?
Linear es la herramienta de tareas que utilizamos en este tutorial. Notion es opcional para proyectos sencillos, aunque lo recomiendo cuando acumulamos requisitos, decisiones y documentación. Una alternativa es mantener esa información en Markdown.
¿Qué hago cuando Antigravity emite un NO-GO?
Traslada el informe a Codex, pídele que corrija los problemas y repite la auditoría. No avances automáticamente a la siguiente fase.
¿Por qué auditar dos veces?
Porque la primera auditoría busca problemas en el planteamiento y la segunda comprueba su implementación. Revisar únicamente el código puede dejar pasar errores de diseño que habría sido más sencillo corregir antes.
¿Puedo utilizar esta forma de trabajar con WordPress u otras tecnologías?
Sí. El procedimiento es independiente del lenguaje o la plataforma. Lo que cambia son las pruebas, los entornos y los mecanismos de publicación.
¿Cuándo termina realmente una tarea?
Cuando la versión autorizada está publicada, se ha comprobado que funciona en producción y las evidencias y decisiones han quedado registradas.

Deja una respuesta