Empieza el curso con una sola instrucción

Una sola instrucción lo configura todo

El resto de este curso lo imparte tu agente. Esta lección te lleva hasta ahí: instalas un agente de programación, pegas una instrucción y el agente instala lo que necesita, crea el proyecto, genera los datos y te entrega los controles. Solo tienes que hacerlo una vez.

Esa primera instrucción también es tu primera lección sobre el método. Delegas la configuración y después la verificas: compruebas tú mismo el número de filas en lugar de aceptar la palabra del agente. Delega y luego verifica. Ese es todo el curso en miniatura.

Instala un agente de programación

La instrucción instala por ti la mayor parte de la cadena de herramientas, incluidos Git y la CLI de Bruin. Primero debes configurar a mano tres cosas, porque tienen que existir antes de pegar la instrucción:

Un terminal. En macOS, pulsa Cmd+Espacio, escribe Terminal y pulsa Intro. En Windows, instala Git para Windows y usa Git Bash (el Símbolo del sistema y PowerShell no ejecutarán el script de instalación que usa el agente; WSL también funciona). En Linux, cualquier shell que ya tengas.
Un agente de programación. Elige uno de Claude Code (se ejecuta en el terminal; inícialo escribiendo claude), Cursor (un editor con el agente integrado) o Codex (se ejecuta en el terminal; inícialo con codex). Cualquiera de los tres funciona en todo el curso.
Un editor de código. Durante el curso leerás archivos - consultas SQL, la documentación del proyecto y tus propias notas - y un editor lo hace mucho más fácil que desplazarse por el terminal. Si elegiste Cursor, ya tienes uno. Si elegiste Claude Code o Codex, instala VS Code y abre la carpeta del proyecto con Archivo, Abrir carpeta.

Crea una carpeta para el curso, ábrela en tu terminal e inicia allí tu agente. Todo lo que hace un agente es relativo a la carpeta en la que se abre, así que es importante iniciarlo en el lugar correcto.

Pega la instrucción

Con el agente ejecutándose en una carpeta de curso vacía, dale esta única instrucción. Le indica que instale lo que falte, prepare el esqueleto del proyecto, cargue los datos y después se detenga para devolverte el control del curso.

AI Prompt

Vas a configurar y después enseñarme un curso interactivo de SQL. Hazlo en este orden y muéstrame cada comando antes de ejecutarlo:

Comprueba que Git y Bruin estén instalados (git --version, bruin version). Si falta Bruin, instálalo con curl -LsSf https://getbruin.com/install/cli | sh y vuelve a comprobar la versión.
Ejecuta bruin init academy-sql-beginner en esta carpeta.
Genera los datos de ejemplo con bruin run academy-sql-beginner/pipeline y confirma que orders tiene 1.200 filas y que order_items tiene 2.880.
Lee academy-sql-beginner/AGENTS.md y academy-sql-beginner/course/README.md para saber cómo ejecutar el curso.
Salúdame, muéstrame el temario de 15 lecciones y dime que diga next lesson para empezar y review my work cada vez que termine una tarea.

No enseñes todavía la primera lección - limita tu trabajo a configurar el entorno y darme los controles. Si falla algún comando, detente y muéstrame el error en lugar de probar otra cosa.

Lee lo que hace el agente, no te limites a hojear su resumen. Debe mostrarte cada comando antes de ejecutarlo: ese es el acuerdo que establece la instrucción, y exigir que lo cumpla es la habilidad que enseña todo este curso.

Qué construye el agente

bruin init academy-sql-beginner crea una carpeta de proyecto academy-sql-beginner/ y escribe una configuración .bruin.yml en la raíz de tu repositorio. No necesitas credenciales: el proyecto usa un archivo de base de datos DuckDB local y el motor DuckDB viene dentro de Bruin, así que no tienes que instalar ni registrar nada más.

Los comandos de estas páginas complementarias suponen que estás dentro de la carpeta academy-sql-beginner/; usa cd para entrar si quieres ejecutarlos tú mismo. Cuando el agente los ejecuta por ti, se encarga de ello.

bruin run academy-sql-beginner/pipeline genera los datos. Se construyen con SQL en lugar de descargarse, así que termina en mucho menos de un segundo y funciona sin conexión. Seis activos construyen las tablas y pasan once comprobaciones de calidad. Al terminar, orders contiene 1.200 filas y order_items contiene 2.880.

Los dos comandos que usarás

Desde aquí dirigirás el curso con dos frases:

next lesson: el agente imparte la siguiente lección, te hace algunas preguntas para comprobar que la has seguido y después asigna una tarea práctica, normalmente escribir una consulta tú mismo.
review my work: cuando hayas hecho la tarea a mano, el agente lee lo que escribiste, lo ejecuta y te dice qué está bien, qué está mal y por qué. Solo marca la lección como terminada cuando tu trabajo resiste la comprobación.

Si alguna vez pierdes el hilo, pregunta al agente where am I. Para volver a oír un concepto de otra manera, di repeat. Para desbloquearte en una tarea sin recibir la respuesta, pide una hint.

Punto de control

Confirma las tres cosas antes de decir next lesson. El agente ha hecho el trabajo; ahora tú lo verificas, que es el hábito que enseña el curso:

bruin version imprime un número de versión.
orders contiene 1.200 filas. Compruébalo tú mismo: bruin query --connection duckdb-default --description "checkpoint" --query "SELECT COUNT(*) FROM orders;"; la siguiente lección explica este comando en detalle.
Tu agente te ha mostrado un programa de 15 lecciones y espera que digas next lesson.

Opcional: usa un almacén de datos en la nube

La plantilla incluye un entorno MotherDuck opcional para quien quiera un almacén de datos real en la nube. MotherDuck es compatible con DuckDB, así que el único cambio es una opción: bruin run academy-sql-beginner/pipeline --environment cloud, después de configurar MOTHERDUCK_TOKEN. Todo el curso funciona igual de las dos maneras y nada posterior lo necesita.