Vibe Coding es una trampa. Necesitas "El Codex."

Resumen:"Vibe Coding"—la práctica de guiar casualmente a la IA para construir software—está de moda. Pero sin estructura, inevitablemente conduce a "deriva de contexto" y código espagueti. Para construir software de calidad empresarial con IA, necesitas una Arquitectura de Contexto.En Mercury, llamamos a esto "El Protocolo Codex."Esto trata tu 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.

James aquí, CEO de Mercury Technology Solutions.

Internet está lleno de "Vibe Coding." La promesa es seductora: hablas casualmente ("vibras") a una IA, y ella construye 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: Asumen que la IA recuerda el "Gran Cuadro." No lo hace.

Los LLMs sufren de entropía. A medida que la conversación se alarga, la IA olvida el esquema de la base de datos que acordaste hace 40 mensajes. Comienza a inventar nuevos patrones. La "Vibra" se convierte en caos.

En Mercury, hemos refinado esto en un flujo de trabajo riguroso. No lo llamamos Vibe Coding. Lo llamamos Ingeniería de Contexto.

Aquí está el "Protocolo Mercury" para construir software con IA utilizando una Única Fuente de Verdad que llamamos El Codex.La Filosofía Central: "El Codex"

El secreto no es el modelo (Claude vs. GPT-5). El secreto es

Memoria Externalizada.Debes tratar tu carpeta de proyecto no solo como un lugar para el código, sino como un "Cerebro" para la IA. Hacemos cumplir una estructura de carpetas estricta 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 Codex.La EstructuraCrea una carpeta llamada /codex en tu directorio raíz. Contiene cinco archivos inmutables:

product-vision.md (El Porqué):

El objetivo de alto nivel. (por ejemplo, "Un juego de combate multijugador en 3D usando ThreeJS").

1. tech-stack.md (El Cómo): Las herramientas específicas. (por ejemplo, "WebSockets para redes, Rapier para física. Sin React, solo JS puro").
2. architecture.md (El Mapa): La estructura de archivos y el esquema de la base de datos.
3. Este es el archivo más crítico.implementation-plan.md (El Camino): Una lista paso a paso de tareas. Cada paso
4. debe tener una prueba de verificación.progress.md (El Registro): Lo que está hecho, lo que está pendiente.
5. El Flujo de Trabajo: Arquitectura --> Ejecución --> VerificaciónNo solo abras un chat y comiences a codificar. Sigue este ciclo.

Fase 1: El Arquitecto (Modelo: Claude Opus 4.5)

Usamos el modelo más inteligente y lento para escribir la ley.

Acción: Actúas como el Gerente de Producto. Vacias tu cerebro en el chat.

We use the smartest, slowest model to write the law.

Action: You act as the Product Manager. You dump your brain into the chat.

Prompt: "Actúa como un Arquitecto de Sistemas. Crea las entradas para product-vision.md y tech-stack.md basadas en mi idea. Luego, propone architecture.md. No escribas código aún. Estos archivos irán a The Codex."

Resultado: Fijas el diseño. Prohíbes explícitamente a la IA tomar decisiones arquitectónicas más adelante.

Fase 2: El Escriba (Modelo: Claude Sonnet 4.5 / Codex)

Usamos el modelo rápido y 'agente' para ejecutar la ley.

La Regla de Oro: Cada nueva sesión de chat DEBE comenzar con la IA consultando The Codex.

Prompt: "Consulta /codex/@architecture.md y /codex/@implementation-plan.md. Actualmente estamos en el Paso 3. Implementa el Paso 3 adhiriéndote estrictamente a la arquitectura definida en The Codex. No procedas al Paso 4."

Al forzar a la IA a leer el /codex cada vez, eliminas "Desviación de Contexto." No importa si estás en el prompt #1 o en el prompt #100; la IA está anclada en la misma verdad.

Fase 3: El Verificador (Modelo: Humano + Herramientas de Navegador)

Este es tu trabajo.

Las guías populares sugieren usar automatización, pero insisto en la Verificación Humana.

Acción: La IA dice "El Paso 3 está hecho."

Tú: Ejecuta el código. Revisa los registros. ¿El plano 3D realmente vuela?

Paso Crucial: Si funciona, le ordenas a la IA: "Actualiza /codex/@progress.md para marcar el Paso 3 como completo. Actualiza /codex/@architecture.md si agregaste nuevos archivos."

Solo entonces te comprometes a Git.Git es tu punto de guardado.Si la IA tiene alucinaciones en el Paso 4, haces git reset --hard y lo intentas de nuevo.

La Ventaja "Antigravedad": Arbitraje de Modelos

La guía original sugiere elegir una herramienta. Yo no estoy de acuerdo.

Usa Arbitraje de Modelos:

1. Planificación (El Arquitecto):UsaOpus 4.5.Piensa profundamente sobre los casos límite y escribe un Codex robusto.
2. Codificación (El Escriba):UsaSonnet 4.5.Sigue instrucciones y es más barato.
3. Refactorización (El Bibliotecario):UsaGemini 3 Pro.Tiene una ventana de contexto masiva para leer toda la base de código a la vez si las cosas se complican.

Conclusión: De "Vibe" a "Visión"

"Vibe Coding" implica que puedes relajarte mientras la IA trabaja. Eso es falso.

Este flujo de trabajo desplaza tu esfuerzo de Escribir a Gobernar.

• Ya no eres un albañil.
• Eres elGuardián del Codex.Tu trabajo es asegurar que el

Codexse mantenga limpio. Si architecture.md se desordena, el código se desordena. Si implementation-plan.md es vago, la IA se quedará atascada.Domina el Codex, y podrás construir software de nivel empresarial solo. Ignóralo, y solo tendrás una carpeta llena de scripts rotos.

Mercury Technology Solutions: Acelera la Digitalidad.

Mercury Technology Solutions: Accelerate Digitality.