TL;DR: El "Vibe Coding" (la práctica de guiar a la IA de forma casual para crear software) está de moda. Pero sin estructura, conduce inevitablemente a la "deriva del contexto" y al código espagueti. Para construir software de nivel empresarial con IA, se necesita una Arquitectura de Contexto rígida. En Mercury, llamamos a esto "El Protocolo del Códice", que trata su documentación no como una sugerencia, sino como la Ley inmutable que la IA debe consultar antes de escribir una sola línea de código.
Aquí James, Director General de Mercury Technology Solutions.
Internet bulle con el "Vibe Coding" La promesa es seductora: hablas casualmente ("vibes") a una IA y ella crea una aplicación.
He revisado los flujos de trabajo populares que circulan en los círculos de desarrollo. Son brillantes para prototipos, pero tienen un defecto fatal para la ingeniería seria: Suponen que la IA recuerda el "Big Picture" No es así.
Los LLM sufren de entropía. Cuando una conversación se alarga, la IA olvida el esquema de base de datos que acordasteis hace 40 mensajes. Empieza a inventar nuevos patrones. La "vibración" se convierte en caos.
En Mercury lo hemos perfeccionado hasta convertirlo en un riguroso flujo de trabajo. No lo llamamos Vibe Coding. Lo llamamos Ingeniería de Contexto.
Este es el "Protocolo Mercury" para construir software con IA utilizando una Fuente Única de la Verdad que llamamos El Códice.
La filosofía central: "El Códice
El secreto no es el modelo (Claude frente a GPT-5). El secreto es la memoria externa.
Debes tratar la carpeta de tu proyecto no sólo como un lugar para el código, sino como un "Cerebro" para la IA. Aplicamos una estricta estructura de carpetas llamada /codex.
¿Por qué "Codex"? Porque implica autoridad. No son notas, son leyes. Antes de que la IA escriba una sola línea de código, debe consultar El Códice.
La estructura
Crea una carpeta llamada /codex en tu directorio raíz. Contiene cinco archivos inmutables:
- product-vision.md (The Why): El objetivo de alto nivel. (por ejemplo, "Un juego multijugador 3D de combate aéreo usando ThreeJS").
- tech-stack.md (El cómo): Las herramientas específicas. (Por ejemplo, "WebSockets para redes, Rapier para física. No React, sólo vanilla JS").
- architecture.md (El mapa): La estructura de archivos y el esquema de la base de datos. Este es el archivo más crítico.
- implementation-plan.md (La ruta): Una lista de tareas paso a paso. Cada paso debe tener una prueba de verificación.
- progress.md (El Log): Lo que está hecho, lo que está pendiente.
El flujo de trabajo: Arquitectura --> Ejecución --> Verificación
No te limites a abrir un chat y empezar a codificar. Sigue este bucle.
Fase 1: El arquitecto (Modelo: Claude Opus 4.5)
Usamos el modelo más inteligente y lento para redactar la ley.
Acción: Actúas como Jefe de Producto. Vuelcas tu cerebro en el chat.
Pregunta: "Actúa como un Arquitecto de Sistemas. Crea las entradas para product-vision.md y tech-stack.md basándote en mi idea. A continuación, proponga el architecture.md. No escribas código todavía. Estos archivos irán a El Códice"
Resultado: Fijas el diseño. Se prohíbe explícitamente a la IA tomar decisiones arquitectónicas más adelante.
Fase 2: El escriba (Modelo: Claude Sonnet 4.5 / Códice)
Utilizamos el modelo rápido y "agentico" para ejecutar la ley.
La regla de oro: Cada nueva sesión de chat DEBE comenzar con la IA consultando El Códice.
Pregunta: "Consulta /codex/@architecture.md y /codex/@implementation-plan.md. Actualmente estamos en el paso 3. Implemente el Paso 3 adhiriéndose estrictamente a la arquitectura definida en El Códice. No continúe con el Paso 4"
Forzando a la IA a leer el /codex cada vez, eliminas la "Deriva de Contexto" No importa si estás en el prompt #1 o en el prompt #100; la IA se basa en la misma verdad.
Fase 3: El verificador (Modelo: Humano + BrowserTools)
Este es tu trabajo.
Las guías populares sugieren utilizar la automatización, pero yo insisto en la verificación humana.
Acción: La IA dice "El paso 3 está hecho"
A ti: Ejecuta el código. Comprueba los registros. ¿Vuela realmente el avión 3D?
Paso crucial: Si funciona, ordenas a la IA: "Actualizar /codex/@progress.md para marcar Paso 3 completado. Actualiza /codex/@architecture.md si has añadido nuevos archivos"
Sólo entonces haces el commit en Git. Git es tu punto de guardado. Si la IA alucina en el paso 4, haces git reset --hard y vuelves a intentarlo.
La ventaja de la "antigravedad": Arbitraje de modelos
La guía original sugiere elegir una sola herramienta. Yo no estoy de acuerdo.
Utilice el modelo de arbitraje:
- Planificación (El Arquitecto): Utiliza Opus 4.5. Piensa profundamente en los casos extremos y escribe un Códice robusto.
- Codificación (El escriba): Utiliza Sonnet 4.5. Sigue instrucciones y es más barato.
- Refactorización (The Librarian): Utiliza Gemini 3 Pro. Tiene una enorme ventana contextual para leer todo el código de una vez si las cosas se complican.
Conclusión: De la "vibración" a la "visión
"Vibe Coding" implica que puedes relajarte mientras la IA trabaja. Eso es falso.
Este flujo de trabajo desplaza su esfuerzo de Escribir a Gobernar.
- Ya no eres albañil.
- Eres el Custodio del Códice.
Tu trabajo es asegurar que el Codex se mantenga limpio. Si el architecture.md se desordena, el código se desordena. Si el implementation-plan.md es vago, la IA se atascará.
Domina el Códice y podrás construir software de nivel empresarial tú solo. Ignóralo, y solo tendrás una carpeta llena de scripts rotos.
Soluciones tecnológicas Mercury: Acelerar la digitalidad.
