Skip to main content
hook CX Codex

dataproduct-builder-dbt — Claude Code hook: setup and usage

dataproduct-builder-dbt runs data contract linting right after file edits in dbt projects. Helps maintain ODCS, ODPS, and OpenLineage standards across your data product builds.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What dataproduct-builder-dbt does

This hook is part of the dataproduct-builder-dbt plugin by Entropy Data. It listens to PostToolUse events matching Edit, Write, or MultiEdit. Whenever the agent modifies source files, it triggers the ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh shell script.

The tooling supports data-product workflows on dbt. It handles project scaffolding, auditing, and connections to ODCS, ODPS, OpenLineage, plus GitHub Actions CI workflows. Because it runs after every file edit, contract errors surface immediately during code generation.

The execution depends entirely on ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh being executable in the plugin path. Without configured dbt contracts or ODCS/ODPS definitions, the linting script will fail.

What it helps with

  • lint data contracts automatically after modifying dbt models
  • catch schema contract breaks on Edit, Write, or MultiEdit events
  • connect dbt workflows with ODCS, ODPS, and OpenLineage checks
  • prepare verified data product builds for GitHub Actions pipelines

Example prompts for the agent

  • Update the staging dbt model for payments and run data contract linting.
  • Add ODCS specifications to customer_churn.sql using MultiEdit.
  • Audit dbt project contracts against OpenLineage guidelines.

How to install dataproduct-builder-dbt

Manually: put the files in place

.claude/settings.json

The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command

Questions about dataproduct-builder-dbt

How to install dataproduct-builder-dbt in Claude Code?

Add the hook definition to your .claude/settings.json file under the hooks object, linking PostToolUse with Edit|Write|MultiEdit to ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh.

What does dataproduct-builder-dbt do?

It oversees data product workflows in dbt, running contract linting and integrating with ODCS, ODPS, OpenLineage, and GitHub Actions.

When does datacontract_lint.sh trigger?

The script executes automatically on PostToolUse whenever Claude Code runs Edit, Write, or MultiEdit tool calls.

Source text

hooks.json · MIT
Hooks bundle shipped with the dataproduct-builder-dbt plugin for Claude Code.

Full data-product lifecycle on dbt for Entropy Data: scaffold, audit, and integrate projects with ODCS, ODPS, OpenLineage, and GitHub Actions.

Triggers on: PostToolUse.

```json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh"
          }
        ]
      }
    ]
  }
}

```

© Entropy Data · MIT · hashgraph-online/awesome-codex-plugins

Similar hooks

Everything for Data and databases →
dbt-transformation-patterns Seth Hobson dbt-transformation-patterns — a skill for Claude, Claude and Cursor that tells the agent how to layer dbt models, write data tests and set up incremental marts. CX Codex +1 11,000installs troubleshooting-dbt-job-errors dbt-labs troubleshooting-dbt-job-errors is a Claude Code skill that diagnoses dbt Cloud job failures using logs, Admin API, git history and data queries. It runs when an error message does not explain the cause. CX Codex +1 1,100installs running-dbt-commands dbt-labs running-dbt-commands — a skill for Claude Code, Codex, Cursor and other platforms that formats and executes dbt CLI commands. Picks the right dbt executable and structures parameters for build, run, test, show. CX Codex +1 1,100installs cosmos-dbt-core astronomer cosmos-dbt-core — a skill for Claude Code, Cursor and other platforms turns a dbt Core project into an Airflow DAG or TaskGroup via Astronomer Cosmos. The agent picks a parsing strategy, sets up warehouse connection and execution config. CX Codex +1 1,000installs dbt-data-transformation manutej dbt-data-transformation — a dbt skill for analytics engineering: models, tests, docs, incremental builds, macros and packages. Useful when your warehouse SQL needs structure. CX Codex +1 443installs dbt-projects-on-snowflake sfc-gh-dflippo dbt-projects-on-snowflake — a skill that walks your agent through running dbt projects inside Snowflake: Snowsight workspaces, DBT PROJECT objects, scheduled runs and event-table telemetry. CX Codex +1 1installs

From the same set391

The whole set →

More in the catalog

Project sponsors

Companies that keep this analytics open