TU PRIMER PROYECTO CON IA

Una idea.
Un programa real.

Aprende vibe coding creando una lista de tareas en Python. La IA puede proponer código y también equivocarse: tú defines el objetivo, pruebas el resultado y decides qué aceptar.

01 — 07Una guía para aprender haciendo, sin necesitar experiencia previa.

AL FINAL VAS A PODER

Convertir una idea sencilla en una herramienta que puedes probar y mejorar.

Vibe coding es desarrollar conversando con un agente de IA: describes lo que buscas, recibes una propuesta de código y luego la ejecutas, revisas y mejoras. En este taller practicarás el proceso con una lista de tareas.

UN ACUERDO HONESTO · PERSONAS + IA

Colaborar no significa creer a ciegas.

Desde mi posición

Soy un sistema de IA: genero respuestas según el contexto y patrones aprendidos. Puedo equivocarme, omitir información o reproducir sesgos; no puedo garantizar que cada respuesta sea correcta ni tengo experiencias humanas.

Desde la tuya

Tú eliges el objetivo, compruebas el código ejecutándolo y decides qué aceptar. Proteger tus datos y revisar las consecuencias sigue siendo responsabilidad de las personas.

El trato justo en esta colaboración significa claridad, límites, privacidad, verificación y corregir errores. Una convivencia responsable entre personas e IA no requiere fingir que la IA es humana. La cortesía puede hacer más amable la conversación, pero no garantiza precisión.

01

ANTES DE EMPEZAR

Prepara tu espacio

Necesitas Python 3 y una terminal. La terminal es una ventana donde escribes instrucciones para ejecutar programas. Comprueba si Python ya está instalado:

Terminal · macOS / Linux
python3 --version

En Windows, prueba este comando:

PowerShell · Windows
py --version

Si ves un número de versión, ya puedes continuar. Si no, instala Python 3 y vuelve a comprobarlo. Guarda el archivo de ejemplo en una carpeta y abre una terminal desde esa misma carpeta.

¿No tienes el archivo a mano? Descarga el ejemplo completo y guárdalo como vibe_tareas.py.

Descargar el ejemplo
02

PRIMERA VICTORIA

Ejecuta el programa

La lista permite añadir, mostrar, completar y borrar tareas. Empieza agregando una tarea desde la terminal:

Terminal · macOS / Linux
python3 vibe_tareas.py agregar "Practicar vibe coding"
PowerShell · Windows
py vibe_tareas.py agregar "Practicar vibe coding"

Ahora mira la lista, completa la primera tarea y, si quieres, bórrala. El número puede cambiar si agregaste más tareas.

VER LAS TAREASpython3 vibe_tareas.py listar
COMPLETAR LA PRIMERApython3 vibe_tareas.py completar 1
BORRAR LA PRIMERApython3 vibe_tareas.py borrar 1

Verás una casilla vacía y luego una marca al completar. Los datos se guardan en tareas.json, junto al programa. Cierra la terminal, vuelve a abrirla y lista las tareas: si siguen ahí, la persistencia funciona.

Python · fragmento del programa
tareas.append({"texto": texto, "hecha": False})
guardar_tareas(tareas)
print(f"Añadida: {texto}")

El programa añade la tarea, guarda la lista y confirma el resultado. Puedes abrir el código completo más abajo.

Explorar el código completo de la aplicación
vibe_tareas.py · código fuente
Cargando código…
03

HABLA CON INTENCIÓN

Da instrucciones claras

Un prompt es el pedido que le haces al agente. No necesitas saber nombres técnicos; sí ayuda describir qué quieres obtener y cómo debería comportarse.

DEMASIADO VAGO

“Hazme una aplicación.”

¿Para quién? ¿Qué debe hacer? ¿Cómo sabremos si funciona?
MÁS ACCIONABLE

“Quiero una lista de tareas para la terminal. Debe agregar, listar, completar y borrar tareas, guardar los datos al cerrar y explicarme cómo probarla.”

Define el resultado, las funciones y cómo comprobarlo.
PRIMER PROMPT · COPIA Y ADÁPTALO

Quiero una lista de tareas pequeña para usar desde la terminal. Debe permitir agregar, listar, completar y borrar tareas. Guarda los datos en un archivo local para que no se pierdan al cerrar el programa. Usa Python, evita dependencias externas y explícame cómo ejecutarlo.

Piensa en cuatro piezas: objetivo, funciones, restricciones y cómo probarlo. Empieza con tus propias palabras y aclara lo que falte en la siguiente vuelta.

04

VERSIÓN PEQUEÑA, MEJORA PEQUEÑA

Itera y depura

No intentes construir diez funciones de golpe. Primero consigue una versión mínima que resuelva el problema principal; luego añade una mejora cada vez.

IDEA PARA LA SIGUIENTE VERSIÓN

Añade un comando para borrar de una vez todas las tareas completadas. No cambies los demás comandos. Si no hay tareas completadas, muestra un mensaje claro. Al terminar, dime qué cambiaste y cómo puedo probarlo.

Después, prueba con una lista que tenga tareas pendientes y completadas. Comprueba los dos casos: cuando hay tareas para borrar y cuando no las hay.

SI ALGO FALLA, CUENTA LO QUE PASÓ

Comparte el comando, el resultado esperado y el error completo. Por ejemplo:

“Intenté completar la tarea número ocho, pero solo tengo dos. Esperaba un aviso claro diciendo que ese número no existe; en cambio, recibí este error: [pega aquí el mensaje]. Corrige ese caso y dime cómo comprobarlo.”

Evita pegar contraseñas, claves privadas o datos personales. Después de cada cambio, vuelve a probar lo que ya funcionaba: una mejora puede romper una función anterior.

05

ACUERDA QUÉ SIGNIFICA «LISTO»

Define tus criterios

Una función está lista cuando cumple condiciones observables. Para borrar tareas completadas, podrías usar estos criterios:

  • 01Elimina solamente las tareas completadas.
  • 02Conserva las tareas pendientes en el mismo orden.
  • 03Guarda el resultado en el archivo local.
  • 04Informa si no había tareas completadas.

Inclúyelos en el prompt y úsalo como una lista de comprobación. Así sabrás qué revisar sin depender de una impresión general.

06

TÚ SIGUES AL MANDO

Entiende el código

Si una parte te resulta difícil, pide una explicación antes de seguir. También puedes pedir cambios limitados: modificar solo el archivo necesario, evitar dependencias nuevas o avisarte si cambia el formato de los datos.

PROMPT PARA APRENDER DEL CÓDIGO

Explícame los cambios en español para alguien que está empezando. Describe qué hace cada función nueva y dame los comandos exactos para probarla.

Cuida tus datos. Lee los cambios antes de conservarlos. Para información importante, prueba primero con una copia. Nunca incluyas contraseñas ni claves privadas en tus instrucciones.

07

TU PRIMER CICLO COMPLETO

De la idea a la mejora

Tu primera sesión puede ser muy sencilla. Marca cada paso al completarlo; tu avance queda guardado en este navegador.

Eso es vibe coding. Tú aportas la intención; el agente ayuda con el código; las pruebas te dicen si el resultado cumple lo que querías. Empieza pequeño y mejora paso a paso.