Ya has instalado las herramientas y sabes cuándo usar cada una. Lo que marca la diferencia a continuación es «cómo pedirle a la IA». Con el mismo Claude Code, la calidad del resultado varía muchas veces según cómo des la instrucción. En este capítulo dominarás la técnica de «pedir bien» sobre dos grandes estilos de trabajo con la IA: el vibe coding, que crea conversando con soltura, y el desarrollo dirigido por especificación, que decide antes la spec para hacer que la IA cree con precisión. Aquí está el mayor quid del coding con IA.
El lema: «pequeño y exploratorio, vibe; grande y preciso, spec»
La calidad de la instrucción decide el resultado
Con lo que primero se tropieza en el coding con IA no suele ser «el manejo de la herramienta», sino «la forma de pedir». La IA no puede leerte la mente. Si le entregas una frase ambigua, la IA rellena por su cuenta lo que falta a base de suposiciones y te devuelve código que parece funcionar pero se desvía de tu intención. Al revés, si sabes transmitir con precisión qué, por qué y cómo quieres que lo cree, lo termina con una exactitud sorprendente. «La calidad de la instrucción» se convierte tal cual en «la calidad del resultado»: ese es el mensaje que atraviesa todo el capítulo. Y esa forma de pedir tiene, a grandes rasgos, dos estilos.
Vibe coding: crear conversando
El vibe coding es un estilo en el que no fijas de antemano el diseño en detalle, sino que creas por ensayo y error conversando con la IA. Le transmites a grandes rasgos «quiero algo así», ves lo que sale y, encadenando diálogo —«un poco más así», «corrige esto»—, le das forma dejándote llevar por la sensación (el vibe). Su mayor encanto es que es cómodo, exploratorio y permite plasmar una idea de golpe.
🎨 La imagen: la sensación de buscar la forma amasando arcilla, sin trazar un plano. Como «piensas mientras creas», puedes mover las manos y comprobar aunque la idea aún no esté cerrada en tu cabeza.
Pongamos en paralelo los escenarios ideales y las trampas a las que hay que estar atento.
- Cosas pequeñas: un script puntual, una herramienta sencilla, una app de una sola pantalla.
- Prototipos y ensayos: cuando quieres ver la forma para decidir. Experimentos que darás por desechables.
- Aprender y practicar: cuando tocas una tecnología nueva para hacerte con su tacto.
- El diseño global se tambalea: la estrategia baila con cada conversación y se pierde la coherencia con facilidad.
- Colapsa al crecer: cuantos más archivos, más difícil es que la IA y la persona abarquen el conjunto.
- El interior se vuelve una caja negra: se acumula código que funciona pero que no sabes explicar por qué.
💡 En una frase: el vibe coding es imbatible para «probar rápido», pero no sirve para «hacer crecer a lo grande ni mantener a largo plazo». Si tomas como guía estas tres palabras —pequeño, desechable, exploratorio—, será más difícil que te equivoques.
Desarrollo dirigido por especificación: decidir antes y crear con precisión
El desarrollo dirigido por especificación (spec-driven development) es un estilo opuesto al vibe coding. Antes de empezar a escribir código, recoges en un documento «qué y cómo vas a crear» a modo de especificación y le entregas esa spec a la IA para que la implemente con precisión. En lugar de conversar sobre la marcha, es una forma de hacer correr a la IA siguiendo un plano acordado.
La forma de hacerlo es sencilla. Primero creas el documento de especificación consultándolo con la IA, lo colocas en el proyecto (en muchos casos como archivo) y avanzas la implementación haciendo que consulte esa spec.
Pon por escrito el propósito, las funciones, las entradas/salidas y las restricciones. Va rápido si haces que la IA redacte un borrador y luego lo corriges.
Antes de implementar, lee tú mismo la spec y elimina huecos y contradicciones. Aquí se decide la calidad.
Instruye «implementa siguiendo esta especificación». Si se desvía, vuelve a la spec para corregir.
- Cosas algo grandes: desarrollo que abarca varias funciones y varios archivos.
- Prioridad a la calidad: lo que dará problemas si se rompe después, lo que mantendrás mucho tiempo.
- Que lo lea un equipo u otras personas: la spec se vuelve un punto de referencia compartido.
- No busques la perfección desde el principio; empieza también con una spec pequeña y hazla crecer.
- La spec la lees tú sí o sí. Una spec delegada por completo en la IA tiende a quedar llena de agujeros.
- Si la implementación se desvía, no la parchees sobre la marcha en el chat: corrige la spec y vuelve a empezar.
📐 Por qué funciona: la IA solo ve «esta conversación de ahora». Al colocar de antemano un documento de especificación como referencia a la que siempre puedes volver, aunque la conversación se alargue la estrategia no se tambalea, y se reducen los huecos en la implementación y el trabajo rehecho. En el fondo es solo «entregar el plano a la IA antes de que cree», pero el efecto es enorme.
Cuándo usar cada uno: explorar en pequeño o acertar en grande
No se trata de que uno sea superior. Lo correcto es elegir según el «tamaño» y el «propósito» de lo que vas a crear. Contrastemos los dos estilos por ejes.
| Tamaño | Pequeño |
| Propósito | Prototipo, exploración, aprendizaje |
| Cómo avanza | Ensayo y error conversando |
| Velocidad | Muy rápida |
| Punto débil | Colapsa al crecer |
| Tamaño | Medio a grande |
| Propósito | Calidad, mantenimiento, producción |
| Cómo avanza | Spec → implementación |
| Velocidad | Arranque lento |
| Punto débil | Excesivo para cosas pequeñas |
✅ En la práctica, se «va y se vuelve». No hace falta fijarse en una disyuntiva. Primero prototipas rápido con vibe coding y, cuando notas que la cosa tira, lo pasas a spec y saltas a la implementación de verdad: este flujo es el más potente en el trabajo real. La exploración en pequeño, vibe; la etapa de hacerlo crecer, spec. Cambia de estilo dentro de un mismo proyecto.
Los 5 trucos de una buena instrucción
Con cualquiera de los dos estilos, si la instrucción (el prompt) que le entregas a la IA es buena, el resultado mejora. Quédate con 5 trucos básicos que puedes usar desde hoy, en tarjetas. Para profundizar, a la Guía práctica de ingeniería de prompts.
En vez de «hazlo bonito», di qué quieres y cómo, en concreto. Cuanto más explicitas valores, condiciones y objetos, mayor precisión.
Transmite el lenguaje, el framework, los archivos relacionados y las restricciones. Cuanto más conoce el trasfondo, más acierta la IA.
No pidas esto y aquello a la vez. Si pides de una en una, en trozos pequeños, revisar y corregir se vuelve más llevadero.
Enseña de antemano la forma que quieres (nombre de función, valor de retorno, ejemplo de salida, formato). Si compartes la meta, es más difícil que se desvíe.
No busques la perfección de un tiro. Es más rápido ver la salida y encadenar correcciones concretas «esto así».
Como solo con palabras cuesta captarlo, pongamos en paralelo la misma petición como «mala instrucción» y «buena instrucción».
«Crea una función de inicio de sesión.»
Ni el lenguaje, ni dónde guardar, ni el comportamiento en caso de éxito o fallo quedan claros. La IA lo rellena todo a suposiciones y devuelve código que choca con lo que dabas por hecho. Causa de trabajo rehecho.
«Añade al proyecto de Laravel una función de inicio de sesión con email y contraseña. Usa la tabla users existente. Si la autenticación tiene éxito, a /dashboard; si falla, muestra un mensaje de error. Ajusta la contraseña al método de hash ya existente. Propón primero solo las routes y el Controller, y la implementación tras mi revisión.»
Explicita el propósito, el contexto, las condiciones de éxito, el alcance de la salida y hasta cómo avanzar. Contiene los 5 trucos.
🧩 Un paso más allá: al enfoque de diseñar no solo «qué transmitir» a la IA, sino qué información y cómo hacerla llegar en todo el proyecto, se le llama ingeniería de contexto; y al de preparar el entorno entero en el que trabaja la IA (herramientas, permisos, archivos de instrucciones), ingeniería del harness. Cuando quieras mejorar, échales un vistazo.
Cuando la IA ignora las reglas
Claude Code cuenta con un mecanismo para reunir las indicaciones de cada proyecto en un archivo como CLAUDE.md y hacer que la IA las respete siempre. Sin embargo, al usarlo de verdad te topas con situaciones en las que «la IA ignora las reglas que se supone que escribiste». Las causas son varias.
Si las reglas son enormes, las importantes quedan sepultadas. Reduce el número y deja claras las prioridades.
Si hay margen de interpretación, no se respetan. Escríbelas de forma concreta y verificable.
Si el intercambio se prolonga, las primeras instrucciones se diluyen. Es eficaz recordárselas en los momentos clave.
💡 La clave de la solución: escribe las reglas «cortas, concretas y con prioridad». Y las reglas importantes, recuérdaselas de nuevo dentro de la conversación cuando haga falta. El diagnóstico detallado de las causas y las soluciones concretas se explican en Por qué la IA ignora las reglas de CLAUDE.md y cómo solucionarlo.
- La calidad de la instrucción es la calidad del resultado. La IA rellena lo que falta a suposiciones, así que cuanto mejor pidas, más preciso será lo que devuelve.
- Vibe coding = ensayo y error conversando. Fuerte en lo pequeño, desechable y exploratorio. Colapsa al crecer.
- Desarrollo dirigido por especificación = decidir antes la spec e implementar con precisión. Fuerte en lo medio a grande y con prioridad a la calidad.
- El criterio para elegir: «pequeño y exploratorio, vibe; grande y preciso, spec». En la práctica se va y se vuelve.
- Los trucos de una buena instrucción son 5: concreción, contexto, una tarea cada vez, ejemplo de salida e iteración.
- La IA ignora las reglas porque las instrucciones son largas, ambiguas o la conversación es larga. Cortas y concretas, con recordatorio.
Cuando dominas la forma de pedir, el coding con IA se estabiliza de golpe. Aun así, en cuanto pongas manos a la obra, te toparás sin falta con errores y bloqueos. En el siguiente capítulo 5, «Salir de los atascos», dominemos de forma sistemática las causas de los errores frecuentes y cómo salir de ellos.