L20 · El método · 5 min
Vibe coding frente a ingeniería agéntica
En una frase
El vibe coding consiste en aceptar cualquier código que genere la IA sin un plan —válido para un experimento desechable—, mientras que la ingeniería agéntica consiste en dirigir a tu agente con una especificación clara, pasos pequeños, secretos protegidos y comprobaciones para construir una app real y fiable.
Piénsalo así
Levantar un castillo de arena en la playa sin planos es estupendo para pasar la tarde, hasta que sube la marea. Si vas a construir una casa donde va a vivir gente y guardar sus cosas, necesitas un plano, paredes firmes y una cerradura en la puerta.
Cómo funciona
En febrero de 2025, el investigador de IA Andrej Karpathy acuñó el término vibe coding para describir el hábito de pedir cosas a la IA, aceptar todos los cambios sin revisarlos y cruzar los dedos. Un año después, en febrero de 2026, dio nombre a la disciplina madura que tomó el relevo: la Definicióningeniería agénticaConstruir software dirigiendo agentes de IA y comprobando su trabajo: tú diriges, el agente construye.Abrir en el glosario →, donde los agentes escriben el código mientras tú diriges y verificas.
Un Definiciónexperimento rápidoUna prueba desechable sin especificación. Sirve para probar una idea, nunca para algo que vayas a publicar.Abrir en el glosario → (vibe coding) tiene su lugar: cuando quieres ver cómo queda un diseño o probar una idea rápida en una tarde y tirar después la carpeta. Como nadie inicia sesión, no se guardan datos reales y nunca se publica, saltarse la especificación no supone un riesgo.
El problema empieza cuando un experimento rápido se publica como si fuera una app real. Sin una Definiciónespecificación`SPEC.md`: qué vas a construir, para quién, qué entra y qué no, y cómo sabrás que funciona.Abrir en el glosario → y un 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 →, cada cambio nuevo rompe tres cosas anteriores; sin reglas para cada DefiniciónsecretoTodo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en `.env.local`.Abrir en el glosario →, una clave de API puede filtrarse en GitHub; sin gestión de errores ni 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 →s, quien entra se topa con pantallas rotas sin que nadie se entere.
Por eso el Definicióndesarrollo guiado por especificaciones (SDD)Acordar qué construir (la especificación) y un plan, y después construir un paso pequeño y comprobado cada vez.Abrir en el glosario → es el camino por defecto en la guía de Agentic Makers: acordar SPEC.md, dividir el trabajo en tasks/plan.md, construir una tarea por rama con un DefinicióncommitUn punto de guardado: una foto de lo que cambió, con una nota corta. Puedes volver a cualquier commit.Abrir en el glosario → tras cada paso que funciona, probar en un enlace 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 → y fusionar solo cuando se cumple la definición de terminado. No necesitas escribir código para dirigir un producto fiable.
Cómo se ve en tu proyecto
Por defecto, tu agente sigue el desarrollo guiado por especificaciones en cada proyecto. Si alguna vez quieres hacer solo una prueba desechable para tantear una idea, díselo expresamente («esto es un experimento rápido»); y si decides quedarte con la idea, empieza una carpeta limpia con su SPEC.md.
Copia para tu agente
Comprueba nuestro proyecto frente a la definición de terminado de Agentic Makers: ¿tenemos al día SPEC.md, tasks/todo.md, los secretos protegidos, los límites de error y las comprobaciones en verde antes de fusionar?
Comprobación rápida · 1 pregunta