Ce hub couvre l’automatisation de la documentation dbt : des outils de scaffolding à la génération par IA, l’enrichissement du contexte métier et l’application des règles en intégration continue. Au début de 2026, la chaîne d’outils traite ces aspects séparément plutôt que via un outil unique. Les outils IA lisent également les descriptions de schéma pour générer du code — une documentation insuffisante dégrade la qualité des sorties IA en aval.
Prérequis
- Un projet dbt (Core ou Cloud) avec des modèles en production
- Familiarité avec la structure des fichiers schema.yml et les bases de la documentation dbt
- Pour les notes sur Claude Code : Claude Code installé et un CLAUDE.md correctement configuré
Ordre de lecture
Les notes suivent la progression naturelle de la construction d’un pipeline de documentation :
-
Outils de scaffolding pour la documentation dbt — Commencez ici. dbt-codegen génère des squelettes YAML, dbt-osmosis propage les descriptions existantes à travers votre DAG. Ensemble, ils peuvent doubler la couverture sans écrire une seule nouvelle description.
-
Outils IA pour la documentation dbt — Comparez dbt Copilot, Claude Code avec MCP et Altimate AI pour l’étape de rédaction des descriptions. Inclut ce que tous les outils IA ratent et comment construire une boucle de rétroaction.
-
RAG pour la documentation dbt — L’insight clé : tous les outils IA décrivent ce que le SQL fait, pas ce que les données signifient pour l’entreprise. Le RAG ciblé sur les bases de connaissances internes comble cet écart. Inclut l’alternative plus simple avec CLAUDE.md pour les petites équipes.
-
Application de la documentation dbt en CI — Évitez les régressions avec dbt-coverage, dbt-checkpoint, dbt-score et dbt-bouncer. Combinez des hooks pre-commit et des vérifications CI pour maintenir la couverture de documentation.
Notes connexes
Pour le workflow Claude Code spécifique (codegen + IA, blocs de documentation, diagrammes de lignage Mermaid), voir Documentation dbt avec Claude Code. Cette note couvre le schéma pratique « comment documenter un modèle maintenant » ; ce hub couvre la question plus large « comment construire un système de documentation ».
Points d’entrée par niveau de couverture
- Moins de 50% de couverture : commencez par les outils de scaffolding — scaffolding et propagation peuvent atteindre 60% en une journée.
- 60%+ de couverture : commencez par les outils IA pour la documentation dbt pour combler les lacunes.
- Descriptions IA trop génériques : allez directement au RAG pour la documentation dbt.