Ce hub cartographie les workflows essentiels de Claude Code pour le développement dbt. Les tâches à plus fort levier sont celles à haute densité de patterns : générer des modèles de base, écrire des tests, documenter des colonnes, tracer des chemins de débogage et refactoriser des noms de colonnes sur plusieurs fichiers. Chaque note est autonome, mais les principes de prompting et la configuration CLAUDE.md s’appliquent à tous les workflows.
Commencer ici
Avant tout, comprenez ce que l’outil fait bien et où il pèche :
- Forces et limites de Claude Code pour la donnée — La carte des capacités. Ce que Claude Code gère nativement (boilerplate, modifications multi-fichiers, réplication de patterns) et où il peine (logique métier inédite, ambiguïté, travail sensible à la sécurité).
- ROI de Claude Code pour les analytics engineers — Le coût d’installation honnête : plusieurs semaines d’investissement avant une valeur cohérente, à quoi ressemblent réellement les économies, et quelles tâches se font enfin parce qu’elles ont cessé d’être douloureuses.
Configuration
- CLAUDE.md comme mémoire de projet — La configuration à plus fort levier. Encoder les conventions de nommage, les exigences de tests, le style SQL et les interdictions explicites dans CLAUDE.md signifie que Claude les applique à chaque invite sans qu’on le lui demande.
- Commandes slash Claude Code pour dbt — Invites réutilisables et partageables en équipe pour les workflows répétables.
/generate-tests,/document-model,/test-prompt. Comment les construire, ce qu’il faut inclure, comment les distribuer à l’équipe.
Workflows essentiels
Génération de modèles
- Génération de modèles de base avec Claude Code — Le workflow de réplication de patterns pour les modèles de base dbt. Comment écrire des invites qui produisent une sortie cohérente avec les conventions, les paramètres par défaut CLAUDE.md à encoder et comment gérer l’intégration complète de sources (15+ tables depuis un nouveau connecteur).
Tests
- TDD avec Claude Code pour dbt — Le développement piloté par les tests avec un agent IA. Écrire les tests en premier, laisser Claude implémenter pour les faire passer, itérer sur les échecs, refactoriser en confiance. Le workflow en cinq étapes et pourquoi “ne pas modifier les tests” est l’instruction critique.
Documentation
- Documentation dbt avec Claude Code — Le pattern codegen-plus-Claude pour schema.yml. Générer le squelette de colonnes avec dbt codegen, remplir les descriptions et tests avec Claude Code. Plus : les blocs de docs pour la cohérence, les diagrammes de lignage et la commande slash
/document-model.
Débogage
- Débogage dbt avec Claude Code — Laisser Claude faire face aux erreurs directement. Erreurs de build, problèmes de qualité des données, sous-agents pour les investigations complexes. Le principe “décrire le problème, pas les étapes de débogage” et quand les sous-agents aident ou sont excessifs.
Refactorisation
- Refactorisation de base de code avec Claude Code — Renommage de colonnes à l’échelle du projet, migrations de conventions de nommage, mises à jour de ref() sur des dizaines de fichiers. Comment inclure les fichiers YAML et les tests singuliers dans les invites de refactorisation, et pourquoi une refactorisation à faible coût change le travail qui est réellement effectué.
Prompting
- Prompting Claude Code pour dbt — Ce qui distingue les invites qui fonctionnent de celles qui produisent une sortie générique. Les quatre propriétés : spécificité, contraintes explicites, références à la base de code et définition de “terminé”. Le problème de mémoire de session et comment CLAUDE.md le résout partiellement.
Parcours de lecture
Si vous démarrez avec Claude Code pour le travail dbt, une séquence utile :
- ROI de Claude Code pour les analytics engineers — Calibrer les attentes avant d’investir dans la configuration.
- CLAUDE.md comme mémoire de projet — Mettre en place la base de configuration.
- Prompting Claude Code pour dbt — Apprendre ce qui rend les invites efficaces.
- Génération de modèles de base avec Claude Code — Premier workflow à pratiquer.
- TDD avec Claude Code pour dbt — Ajouter une couverture de tests systématiquement.
- Documentation dbt avec Claude Code — Le plus grand gouffre de temps, désormais gérable.
- Débogage dbt avec Claude Code — À utiliser selon les besoins.
- Refactorisation de base de code avec Claude Code — S’attaquer au backlog de dette technique.
- Commandes slash Claude Code pour dbt — Systématiser les workflows qui fonctionnent pour vous.
La séquence n’est pas stricte. La configuration avant les workflows, et les principes de prompting avant toute tâche spécifique, réduit les erreurs dues à des attentes mal alignées.