Entendemos el vibe coding no como «decírselo con palabras y dejar que la IA lo haga todo», sino como una forma de trabajo en la que la persona define los requisitos y los criterios de comprobación y después revisa el resultado generado por la IA. Con una herramienta ficticia para sumar un CSV de gastos domésticos, organizamos en una sola nota la entrada, la salida, lo que no debe hacerse y cómo verificar el resultado.
Para quién esUsuarios generales con poca experiencia en programación que quieren empezar de forma segura con pequeñas automatizaciones mediante herramientas de programación con IA en terminal como Claude Code
En esta serie, vibe coding significa describir en lenguaje natural la tarea deseada, dejar que la IA ayude a leer archivos o a crear y modificar código, y después hacer que una persona compruebe el resultado. La idea central no es prometer que la persona nunca tendrá que escribir una sola línea de código. Al contrario, primero debe decidir qué se va a crear, cuáles son la entrada y la salida, hasta dónde se permite actuar y cómo se comprobará si el resultado es correcto. Como se explica en el artículo básico sobre IA generativa «¿Qué es la IA generativa? Entender cómo responde y por qué puede alucinar», una respuesta de IA puede parecer convincente y aun así apartarse de los hechos o de la intención; por eso, también al programar conviene separar «generación» y «verificación».
| Rol | Trabajo que puede encargarse a la IA | Lo que la persona debe decidir o comprobar |
|---|---|---|
| Comprender el requisito | Organizar el alcance del trabajo a partir de la solicitud | Comprobar si faltan el objetivo, la entrada, la salida o las prohibiciones |
| Escribir código | Crear los archivos necesarios y un borrador del código | Comprobar si se modifican archivos no deseados o se amplía el alcance |
| Preparar la ejecución | Proponer el comando de ejecución o el orden necesario | Comprobar qué efecto tendrá el comando sobre la carpeta y los archivos actuales |
| Comprobar el resultado | Proponer cómo comparar con el resultado esperado | Comprobar directamente si la salida real coincide con los valores de referencia |
Por tanto, la calidad del vibe coding no depende solo de saber escribir prompts elegantes. Es más importante definir una tarea pequeña, hacer visible lo que hizo la IA y dejar criterios para saber desde dónde revisar si algo sale mal.
Si se le pide de inmediato a la IA «hazme un programa de gastos», puede completar por su cuenta el formato del archivo, la forma de la salida, la elección de bibliotecas y el alcance del tratamiento de errores. Incluso para una herramienta pequeña, anotar primero cuatro elementos aclara mucho la conversación posterior: qué archivo sirve de entrada, qué valores debe producir la salida, qué no se debe hacer y con qué lo comparará la persona.
Nombre de la herramienta: total mensual de un CSV de gastos
Entrada
- Archivo CSV UTF-8 expenses.csv
- Columnas: date, category, amount
- Formato de date: YYYY-MM-DD
- amount es un entero
Salida
- Mostrar el total mensual junto al mes
- 2026-09 = 26600
- 2026-10 = 9800
No hacer
- No usar datos personales reales ni datos reales de pagos
- No añadir paquetes externos
- No modificar el CSV de entrada
Cómo comprobarlo
- Ejecutar python summarize.py expenses.csv
- Comparar si los totales de los dos meses coinciden exactamente con los valores esperados anterioresEsta nota no es código. Sin embargo, será el criterio para decidir después si una implementación propuesta por la IA se sale de los requisitos. Por ejemplo, si la IA propone instalar pandas, entra en conflicto con la condición «usar solo la biblioteca estándar de Python», así que no es necesario seguir esa propuesta.
Cuando en el siguiente paso se encargue el trabajo a Claude Code, se puede entregar la nota de requisitos tal cual o resumir sus puntos principales. Una buena solicitud no termina en «créame esto»: incluye un ejemplo de entrada, la salida esperada, las restricciones y lo que debe comprobarse antes de modificar archivos. Así queda una base para que la persona evalúe si el código creado por la IA es correcto.
Planifica la creación de un script de Python que lea expenses.csv y muestre el total mensual de amount.
Todavía no modifiques ningún archivo.
Las columnas de entrada son date, category, amount; date usa el formato YYYY-MM-DD y amount es un entero.
Debes usar solo la biblioteca estándar de Python.
Los valores esperados son 2026-09 = 26600 y 2026-10 = 9800.
Primero explica qué archivos leerías, qué comprobarías y en qué orden lo implementarías.Esta solicitud todavía no autoriza a escribir el código. Incluye «primero entender y planificar» para poder revisar el alcance. La documentación oficial de Claude Code también recomienda dividir las tareas complejas en pasos y comprender primero el código antes de cambiarlo.
Una herramienta de programación con IA puede leer y modificar archivos o proponer la ejecución de comandos, así que para un principiante es más importante saber «cuándo detenerse y revisar» que «cuándo pulsar Yes». Si aparece un comando desconocido, una propuesta para cambiar muchos archivos de una vez, una instalación de paquetes que no se pidió o código que modifica el archivo original de entrada, hay que comprobar el motivo antes de seguir.
Las listas de revisión de código y las pruebas unitarias se tratan por separado en otros artículos de Worknote, así que no las repetimos aquí. El foco de esta serie es el flujo en el que la persona controla el alcance del trabajo y el momento de los cambios al colaborar con una herramienta de programación con IA en terminal.
Al terminar este artículo todavía no es necesario instalar Claude Code ni generar código. En cambio, debe quedar completa una nota de requisitos de una página. En el siguiente artículo usaremos esta nota para instalar Claude Code y empezaremos preguntando por la carpeta de práctica y pidiendo que la explique antes de cambiar código.
| Elemento de comprobación | Criterio de este ejemplo | Criterio de finalización |
|---|---|---|
| Entrada | expenses.csv / date, category, amount | El archivo y los nombres de las columnas están claros |
| Salida | 2026-09 = 26600, 2026-10 = 9800 | Los valores esperados están fijados numéricamente |
| Restricciones | Solo biblioteca estándar; no modificar el CSV original | Resulta más difícil que la IA amplíe el alcance por su cuenta |
| Comprobación | Ejecutar python summarize.py expenses.csv y comparar con los valores esperados | La persona puede decidir directamente si el resultado es correcto |
Con estos criterios, aunque la IA explique el código extensamente, las preguntas principales siguen siendo simples: «¿lee la entrada que definí?, ¿produce la salida que definí?, ¿evita lo que prohibí?, ¿y puedo comprobar el resultado?». Basta con revisarlas en ese orden.
Redactado con base en la documentación oficial de Claude Code (consultada el 2026-09-22) y en el ejemplo ficticio de esta serie · Claude Code no se ejecutó realmente · No hay código Python para ejecutar
En este artículo no se ejecutaron Claude Code ni código Python. Se explica el flujo de trabajo del vibe coding y se fijan los requisitos para las prácticas posteriores; la implementación concreta y la verificación de ejecución se realizarán en artículos siguientes.
Elige una pregunta que te interese y crea un resultado práctico.
Si primero quieres entender los principios: ¿Qué es la IA generativa? Entender cómo responde y por qué puede alucinar
Crea una solicitud que incluya claramente el objetivo y las condiciones.
Practica con pistas y revisión de errores.
Crea un plan semanal que respete tus límites de tiempo.
Aprende a comparar un resumen con el texto original.
Compara tareas repetitivas y elige el primer caso de uso del equipo.