docs: the Claude Code plugin's dbt helpers
Issue for this PR
No issue: companion to the altimate-claude-plugin PR that adds the dbt helpers (1.6.0).
Type of change
- Bug fix
- New feature
- Refactor / code improvement
- Documentation
What does this PR do?
Adds a "dbt helpers beside the chat" section to docs/docs/data-engineering/guides/using-with-claude-code.md. It describes what the Claude Code plugin's five dbt helpers do, when each runs, what the person sees and what Claude is told: compile and validate after each model edit, Explain and Fix on a failed dbt run, the Query results pane for dbt show (with Min / Default / Max sizes), model context on read, and the environment doctor. It also covers the warehouse cost of the on-edit check and the dbt_mods option that turns them off. No code changes in this repository.
How did you verify your code works?
mkdocs build -f docs/mkdocs.yml as in the docs workflow: builds with no errors or warnings for the page. The behaviour it describes was checked against the plugin's tests (356 pass) and a recorded end-to-end session, and the page was kept in step with the plugin through its review.
Cost side effects
None in this repository (docs only). The documented on-edit check runs one dbt show --limit 1 per model edit in the user's project, as the page states.
Screenshots / recordings
Not a UI change here.
Checklist
- I have tested my changes locally
- I have not included unrelated changes in this PR
- I checked for cost side effects (model calls, queries or cloud resources that grow with user data) and described them, or wrote "none"
🤖 Generated with Claude Code