Commencez le cours avec une seule invite

Une seule invite configure tout

Le reste de ce cours est dispensé par votre agent. Cette leçon vous amène à ce point : vous installez un agent de codage, collez une invite et l'agent installe ce dont il a besoin, construit le projet, génère les données et vous confie les contrôles. Vous le faites une fois.

Cette première invite est également votre première leçon sur la méthode. Vous déléguez la configuration, puis vous la vérifiez - vous vérifiez vous-même le nombre de lignes plutôt que de croire la parole de l'agent. Déléguez, puis vérifiez. C'est tout le cours en miniature.

Installer un agent de codage

L'invite installe la plupart de la chaîne d'outils pour vous, Git et la CLI Bruin inclus. Trois choses que vous configurez d'abord manuellement, car elles doivent exister avant que vous puissiez coller l'invite :

Un terminal. Sur macOS, appuyez sur Cmd+Espace, tapez Terminal, appuyez sur Entrée. Sous Windows, installez Git for Windows et utilisez Git Bash (l'invite de commande standard et PowerShell n'exécuteront pas le script d'installation utilisé par l'agent ; WSL fonctionne également). Sous Linux, n'importe quel shell que vous possédez déjà.
Un agent de codage. L'un de Claude Code (s'exécute dans le terminal ; démarrez-le en tapant claude), Cursor (un éditeur avec l'agent intégré) ou Codex (s'exécute dans le terminal ; démarrez-le avec codex). N'importe lequel des trois fonctionne partout dans ce cours.
Un éditeur de code. Vous passerez ce cours à lire des fichiers - des requêtes SQL, la documentation du projet, vos propres notes - et un éditeur rend cela bien plus facile que de faire défiler le terminal. Si vous avez choisi Cursor, vous en avez déjà un. Si vous avez choisi Claude Code ou Codex, installez VS Code et ouvrez le dossier du projet avec Fichier, Ouvrir le dossier.

Créez un dossier pour le cours, ouvrez-le dans votre terminal et démarrez-y votre agent. Tout ce qu'un agent fait est relatif au dossier dans lequel il s'ouvre, il est donc important de le démarrer au bon endroit.

Collez l'invite

Votre agent étant exécuté dans un dossier de cours vide, donnez-lui cette invite. Il indique à l'agent d'installer ce qui manque, d'échafauder le projet, de charger les données, puis de s'arrêter et de vous rendre le cours.

:: bloc d'invite Vous allez mettre en place puis m'enseigner un cours SQL interactif. Faites cela dans l'ordre et montrez-moi chaque commande avant de l'exécuter :

Vérifiez que Git et Bruin sont installés (git --version, bruin version). Si Bruin est manquant, installez-le avec curl -LsSf https://getbruin.com/install/cli | sh, puis vérifiez à nouveau la version.
Exécutez bruin init academy-sql-beginner dans ce dossier.
Générez les exemples de données avec bruin run academy-sql-beginner/pipeline, puis confirmez que orders contient 1 200 lignes et que order_items en contient 2 880.
Lisez academy-sql-beginner/AGENTS.md et academy-sql-beginner/course/README.md pour savoir comment exécuter le cours.
Saluez-moi, montrez-moi le programme de 15 leçons et dites-moi de dire next lesson pour commencer et review my work chaque fois que je termine une tâche.

N'enseignez pas encore la première leçon - installez-vous simplement et donnez-moi les commandes. Si une commande échoue, arrêtez-vous et montrez-moi l'erreur au lieu d'essayer autre chose. ::

Lisez ce que fait l'agent, ne vous contentez pas de parcourir son résumé. Il doit vous montrer chaque commande avant de l'exécuter - c'est l'accord défini par l'invite, et maintenir l'agent sur cet accord est la compétence que tout ce cours enseigne.

Ce que l'agent construit

bruin init academy-sql-beginner crée un dossier de projet academy-sql-beginner/ et écrit une configuration .bruin.yml à la racine de votre référentiel. Vous n'avez besoin d'aucune information d'identification : le projet utilise un fichier de base de données DuckDB local et le moteur DuckDB est livré dans Bruin, il n'y a donc rien d'autre à installer ou à vous inscrire.

Les commandes de ces pages complémentaires supposent que vous vous trouvez dans ce dossier academy-sql-beginner/, donc cd si vous souhaitez les exécuter vous-même. Lorsque l'agent les exécute pour vous, il s'en charge.

bruin run academy-sql-beginner/pipeline génère les données. Il est construit par SQL plutôt que téléchargé, il se termine donc en moins d'une seconde et fonctionne hors ligne. Six actifs construisent les tables et onze contrôles de qualité réussissent. Une fois cela fait, orders contient 1 200 lignes et order_items en contient 2 880.

Les deux commandes que vous utiliserez

À partir de là, vous suivez le parcours avec deux phrases :

next lesson - l'agent enseigne la leçon suivante, vous pose quelques questions pour vérifier que vous avez suivi, puis définit une tâche pratique, généralement une requête à écrire vous-même.
review my work - une fois que vous avez effectué la tâche à la main, l'agent lit ce que vous avez écrit, l'exécute et vous dit ce qui est bien, ce qui ne va pas et pourquoi. Cela marque la leçon accomplie seulement lorsque votre travail tient la route.

Si jamais vous perdez votre place, renseignez-vous auprès de l'agent where am I. Pour réentendre un concept d'une manière différente, dites repeat. Pour vous débloquer sur une tâche sans réponse, demandez un hint.

Point de contrôle

Confirmez les trois avant de dire next lesson. L'agent a fait le travail ; maintenant vous le vérifiez, ce qui est l'habitude sur laquelle porte le cours :

bruin version imprime un numéro de version.
orders contient 1 200 lignes. Vérifiez-le vous-même : bruin query --connection duckdb-default --description "checkpoint" --query "SELECT COUNT(*) FROM orders;" - la leçon suivante explique cette commande dans son intégralité.
Votre agent vous a montré un programme de 15 leçons et attend que vous disiez next lesson.

Facultatif : utilisez plutôt un entrepôt cloud

Le modèle fournit un environnement MotherDuck en option pour tous ceux qui souhaitent un véritable entrepôt cloud. MotherDuck est compatible avec DuckDB, donc le seul changement est un indicateur : bruin run academy-sql-beginner/pipeline --environment cloud, après avoir défini un MOTHERDUCK_TOKEN. Tout dans ce cours fonctionne de la même manière, et rien ne l'exige par la suite.