Skip to content

docs: the Claude Code plugin's dbt helpers - #1728

Open
hkaltai wants to merge 16 commits into
mainfrom
feat/implement-items-7-8-9-12-15-with-e2e-demo
Open

hkaltai wants to merge 16 commits into
mainfrom
feat/implement-items-7-8-9-12-15-with-e2e-demo

Conversation

@hkaltai

@hkaltai hkaltai commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

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

hkaltai and others added 5 commits November 13, 2026 14:47
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 42 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 4 included reviews currently available.

Learn how review limits work.

Review configuration:

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 3e0cb636-d3dd-46a9-969e-5a4ee41ae364
Commits

Reviewing files that changed from the base of the PR and between bc8025b and 858ec34.

Files selected for processing: 1

  • docs/docs/data-engineering/guides/using-with-claude-code.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

hkaltai and others added 10 commits November 13, 2026 16:39
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hkaltai
hkaltai marked this pull request as ready for review November 14, 2026 03:42
@kilo-code-bot

kilo-code-bot Bot commented Nov 14, 2026 •

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Incremental review of c7cba469..858ec34b (2 lines changed in one docs file). Both previous findings are fixed:

  • Line 105 now says the helpers make "no model-provider call on its own" and names the two buttons that do, removing the dbt-model ambiguity.
  • Line 110 now states the clearing rule once (selection, flags, folder, command environment variables) and lists the ignored display/concurrency flags as an exception instead of repeating the requirement.

No new issues on the changed lines; the remaining helper-table claims describe an external plugin and are internally consistent with the rest of the page.

Files Reviewed (1 file)
  • docs/docs/data-engineering/guides/using-with-claude-code.md
Previous Review Summary (commit c7cba46)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit c7cba46)

Status: 2 Issues Found | Recommendation: Address before merge

Docs-only change adding a "dbt helpers beside the chat" section. No code paths change; all findings are documentation clarity issues. Claims about the external Claude Code plugin's behavior could not be verified from this repository, so they were reviewed for internal consistency only.

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 2
Issue Details (click to expand)

SUGGESTION

File Line Issue
docs/docs/data-engineering/guides/using-with-claude-code.md 105 "calls no model" is ambiguous: on a dbt page it reads as "no dbt model runs", which contradicts the Compile and validate row saying the model is compiled and run with dbt show. Make the model-provider/LLM intent explicit.
docs/docs/data-engineering/guides/using-with-claude-code.md 110 The Explain and Fix cell requires "the same flags" twice while also saying display-only flags don't matter, so the clearing rule reads contradictory; state the rule once with its exceptions.
Files Reviewed (1 file)
  • docs/docs/data-engineering/guides/using-with-claude-code.md - 2 issues (lines 105, 110)

Fix these issues in Kilo Cloud


Reviewed by deepseek-v4.1-flash-1017 · Input: 34.7K · Output: 4.6K · Cached: 222.5K

Review guidance: REVIEW.md from base branch main (truncated)

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 1 file

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

… once

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant